Para qué sirve#
Las acciones son tareas que Connecto hace solo cuando algo ocurre con una oportunidad en una etapa: crear una tarea de seguimiento, avisar a alguien, asignar un propietario, enviar un correo o un WhatsApp, mover la oportunidad, etc. Ahorran trabajo manual y evitan que se olviden pasos del proceso.
Quién puede usarlo y cómo llegar#
Solo administradores: Configuración → Oportunidades → Etapas → Configurar (en la etapa que quieras) → pestaña Acciones. Las acciones de cada etapa se ven y editan dentro de esa etapa.
La pestaña Acciones#
Muestra las acciones de la etapa agrupadas por momento. Cada fila indica el tipo de acción, un resumen de lo que hace y marcas como «a los N días», «N h después» o «apagada». A la derecha, el lápiz (editar) y la papelera (eliminar, con la confirmación «¿Eliminar esta acción? Dejará de ejecutarse en esta etapa.»). Si la etapa no tiene acciones: «Esta etapa todavía no tiene acciones.»
En la cabecera de la pestaña puedes usar variables en los textos: {{nombre}}, {{apellidos}}, {{correo}}, {{telefono}}. {{nombre}} es solo el primer nombre del contacto.
{{nombre_completo}}, {{tipo_contacto}}, {{fecha}} (la de hoy, en formato día/mes/año) y {{campo:clave}} (un campo personalizado del contacto). Las variables se reemplazan en los títulos de tarea, textos de aviso, título nuevo, asunto del correo, valores de la plantilla de WhatsApp y la nota de pérdida.Agregar o editar una acción#
Pulsa Agregar acción (o el lápiz de una existente). El formulario tiene:
| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Cuándo | El momento en que se dispara. | Al entrar a la etapa · Al salir de la etapa · Al ganar · Al perder · Si se estanca en la etapa | Al entrar a la etapa |
| A los (días) | Solo con «Si se estanca en la etapa»: a los cuántos días en la etapa se dispara. | 1 a 365. «Indica a los cuántos días se considera estancada.» si falta. | Vacío |
| Esperar antes de ejecutar | Retraso desde el momento. No aplica a «Si se estanca». | Número y unidad (horas o días); de 0 a 2.160 horas (90 días). | 0 horas (en el momento) |
| Qué hace | El tipo de acción (ver abajo). | 10 tipos. | Crear una tarea |
| Acción activa | Apagada, la acción no se ejecuta pero se conserva. | Interruptor. | Activa |
Botones: Guardar la acción («Acción guardada.») y Cancelar. Si falta algo, el formulario muestra el error en rojo.
Cuándo se dispara cada momento#
| Momento | Se dispara cuando… |
|---|---|
| Al entrar a la etapa | La oportunidad llega a la etapa (creada ahí o movida a ella). |
| Al salir de la etapa | La oportunidad deja la etapa. |
| Al ganar | La oportunidad se gana al llegar a esta etapa de cierre. |
| Al perder | La oportunidad se pierde al llegar a esta etapa de cierre. |
| Si se estanca en la etapa | La oportunidad abierta lleva N días seguidos en la etapa desde su última entrada. Se ejecuta una sola vez por visita a la etapa. |
«Al ganar» y «Al perder» se ejecutan en la etapa de cierre que se alcanza; por eso se configuran en las etapas de tipo ganada y perdida.
Tipos de acción#
| Tipo | Qué hace | Campos |
|---|---|---|
| Crear una tarea | Agrega una tarea a la oportunidad (marcada «automática») y avisa a la persona asignada. | Título de la tarea (obligatorio, hasta 200; ej. «Llamar a {{nombre}}»); Tipo (Tarea, Llamada, Correo, Reunión); Vence en (días) 0–365 y y (horas) 0–23 (por defecto 0 y 0: vence al momento); Asignar a «El propietario de la oportunidad» (por defecto) o «Un usuario específico» (se elige en Usuario). Si no hay propietario, la tarea queda sin asignar. |
| Avisar a alguien | Envía una notificación dentro de Connecto, con enlace a la oportunidad. | Avisar a: «El propietario», «Usuarios específicos» o «Todos los de un rol» (Administradores, Supervisores, Asesores); Título del aviso (hasta 200; por defecto «Aviso de oportunidad»); Mensaje (hasta 500; si lo dejas vacío se usa «contacto · etapa»). Si no hay a quién avisar, la acción queda «omitida». |
| Asignar propietario | Cambia el propietario de la oportunidad. | Cómo se asigna: «A un usuario»; «Rotando entre varios (el que tenga menos abiertas)» (elige al menos dos usuarios; se asigna al que tenga menos oportunidades abiertas); o «Que siga al propietario del contacto» (quita el propietario propio). |
| Cambiar un dato | Modifica un dato de la oportunidad. | Dato: «Fecha de cierre esperada» (Hoy más (días), 0–3.650), «Valor» (número mayor o igual a 0) o «Título» (texto; admite variables). También puede cambiar un dato del pedido de la oportunidad (el pedido vinculado a ella): «Comprobante de pago (URL de la imagen)», «Guía de envío», «Método de envío», «Dirección de envío» o «Notas». En esos datos el valor lo envía la API: el sistema que mueve la oportunidad (PATCH /v1/oportunidades/{id}) manda un campo con el nombre del dato (por ejemplo comprobante_url) y, al entrar a la etapa, la acción lo guarda en el pedido. Si la API no lo envía, se usa el valor opcional que escribas en la acción; si tampoco hay, la acción se omite y queda anotado en el registro de acciones. |
| Metadato del contacto | Asigna o quita un metadato al contacto. | Metadato y Acción («Asignar al contacto» / «Quitar del contacto»). Al asignarlo queda registrado con origen del sistema, con la descripción «Asignado al pasar a «etapa» en el embudo «embudo».» |
| Lista de distribución | Agrega o quita al contacto de una lista de distribución. | Lista de distribución (solo listas de distribución electrónico activas) y Acción («Agregar al contacto» / «Quitar al contacto»). |
| Llamar a una API | Llama a una dirección web con un método y unas variables, decide si la respuesta fue positiva o negativa y ejecuta sub-acciones en cada caso. | Ver la sección «Llamar a una API» más abajo. |
| Generar factura | Crea en el programa de facturación conectado (Siigo o Alegra) la factura del pedido de la oportunidad: productos, descuentos, IVA y envío. | Esperar a que el pedido esté pagado (interruptor) y sub-acciones si se crea o no la factura. Ver la sección «Generar factura». |
| Guardar factura (número y PDF) | Va después de «Generar factura»: toma la factura creada para el pedido de la oportunidad, guarda en el pedido el número de factura del proveedor (Siigo o Alegra) y descarga la factura en PDF a un almacenamiento local de Connecto. Desde el pedido se abre con «Ver PDF». | Solo el nombre. Si el pedido todavía no tiene factura, queda como error y se puede reintentar. |
| Cambiar el estado del pedido | Pasa el pedido de la oportunidad al estado que elijas en la lista: Borrador, Pendiente de pago, Pagado, En proceso, Completado o Cancelado. Pagado registra un pago por el saldo pendiente con el método de pago tomado automáticamente del pedido (no se elige): el del último pago que ya tenga registrado, por ejemplo un abono por pasarela; si no tiene pagos, el medio de pago que dicen las notas del pedido («Medio de pago: Wompi (en línea)» → Pasarela de pago, «Transferencia bancaria», «Bre-B», «Efectivo»; así lo anota la tienda web); si las notas no lo dicen, Bre-B cuando su comprobante lo nombra, y si no, Transferencia bancaria. Con eso el pedido queda pagado por completo; úsala antes de una acción que lo pase a Completado, que exige estar pagado («Reembolsado» no se puede elegir: se da al registrar el reembolso). Opcionalmente un motivo, que queda en el historial del pedido. | Estado y motivo. Si el pedido aún no existe, espera hasta 15 minutos a que se cree. Un cambio que el pedido no permite (por ejemplo, Completado sin estar pagado, o Cancelado con pagos sin reembolsar) queda como error en el registro de la oportunidad, con la razón; si el pedido ya estaba en ese estado, la acción lo anota y no hace nada. |
| Crear una actividad en el contacto | Deja una actividad en la línea de tiempo (Resumen) de la ficha del contacto. | Mensaje de la actividad, con variables del contacto, de la oportunidad y del pedido. |
| Enviar un correo (template) | Envía un correo con un template. | Template de correo (los de Templates de correo no archivados); Asunto opcional (hasta 250; si lo dejas vacío usa el del template). |
| Enviar un WhatsApp (plantilla) | Envía una plantilla de WhatsApp. | Línea de WhatsApp; Plantilla aprobada (se cargan las plantillas aprobadas de la línea elegida, con su idioma); Valores de las variables de la plantilla (uno por línea: {{1}}, {{2}}…, hasta 10; los vacíos se envían como «-»). |
| Mover a otra etapa | Mueve la oportunidad a otra etapa del mismo embudo. | Mover a la etapa. Sin efecto si la oportunidad ya está cerrada. |
| Cerrar como perdida | Pierde la oportunidad. | Motivo de pérdida (los activos) y Nota (hasta 500; por defecto «Cerrada automáticamente.»). Sin efecto si ya está cerrada. |
Validaciones al guardar: «Elige a quién se asigna la tarea.», «Elige a quién avisar.», «Elige los roles a avisar.», «Elige el usuario.», «Elige al menos dos usuarios para rotar.», «Elige el campo.», «Escribe el valor.», «Escribe el título.», «Elige el metadato.», «Elige la lista de distribución.», «Elige el template de correo.», «Elige la línea de WhatsApp.», «Elige la plantilla de WhatsApp.», «Elige otra etapa del mismo embudo.»
Reglas del correo y el WhatsApp#
Antes de enviar, Connecto comprueba (en este orden) y, si algo falla, deja la acción como omitida con el motivo:
- El contacto no está bloqueado («El contacto está bloqueado.»).
- Si en la configuración de Difusión se exige consentimiento, el contacto lo ha dado para ese canal («El contacto no ha autorizado mensajes por correo/WhatsApp.»). Ver Consentimiento y bajas.
- El modo de prueba está apagado («Modo de prueba: no se envió.»). Ver Modo de prueba de las acciones.
- El contacto tiene correo o teléfono («El contacto no tiene correo.» / «El contacto no tiene teléfono.»).
El correo lleva automáticamente el pie con el enlace Darme de baja y el encabezado de baja con un clic. Si el template o la línea de WhatsApp ya no existen, la acción queda con estado error.
Cuándo y cómo se ejecutan#
- En el momento: las acciones sin espera se ejecutan al instante cuando alguien mueve o crea la oportunidad desde Connecto.
- Con retraso, por estancamiento o por movimientos automáticos del sistema (oportunidad creada sola, paso a la segunda etapa porque un asesor respondió): las procesa el sistema de fondo, cada pocos segundos (alrededor de 15). Es normal que tarden unos segundos.
- Una acción «Al entrar» con espera solo se ejecuta si la oportunidad sigue en esa visita a la etapa; si ya salió, queda «omitida» con «La oportunidad ya salió de la etapa.»
- Una acción que mueve la oportunidad no pasa por las reglas del embudo, pero las acciones encadenadas se limitan a 3 saltos para evitar ciclos.
- Cada ejecución queda registrada y se ve en la ficha de la oportunidad, en Acciones automáticas (últimas 8), con su estado:
pendiente,ok,erroruomitida.
Paso a paso: crear una tarea automática al entrar a «Propuesta»#
- Configuración → Oportunidades → Etapas → Configurar en «Propuesta» → pestaña Acciones.
- Agregar acción. En «Cuándo», deja «Al entrar a la etapa».
- En «Qué hace», deja «Crear una tarea». Título:
Enviar propuesta a {{nombre}}. Tipo: Llamada. Vence en 2 días. - Guardar la acción. Aparece «Acción guardada.»
- Mueve una oportunidad de prueba a «Propuesta»: la tarea aparece en la ficha y en Solicitudes → Tareas asignadas del propietario.
Avisos y casos especiales#
<!-- Fuente: tenant-app/views/partials/cfg_oportunidades.php, tenant-app/public/api/oportunidades_cfg.php, shared/src/Core/Pipeline.php, shared/src/Core/DifusionCorreo.php, shared/src/Core/Oportunidades.php, tenant-app/public/oportunidades/index.php -->
Llamar a una API#
Sirve para avisar a otro sistema (por ejemplo, la web de matrículas) cuando una oportunidad entra o sale de una etapa, y reaccionar según lo que responda.
1. Qué llamar
| Campo | Qué es |
|---|---|
| URL de la API | Dirección completa (http o https). Debe ser pública: no se permiten localhost, redes internas ni direcciones privadas. |
| Método | GET, POST, PUT, PATCH o DELETE. |
| Formato de las variables | JSON o formulario (en el cuerpo). Con GET y DELETE las variables van en la URL. |
| Encabezados | Uno por línea, Nombre: valor, por ejemplo Authorization: Bearer TU_LLAVE. Se guardan tal cual en la configuración de la etapa (solo la ve el administrador). |
| Variables a enviar | Una por línea, nombre=valor. El valor puede llevar variables: {{nombre}}, {{apellidos}}, {{correo}}, {{telefono}}, {{id_contacto}}, {{id_oportunidad}}, {{oportunidad:titulo}}, {{oportunidad:valor}}, {{pedido:id}}, {{pedido:numero}}, {{pedido:total}}, {{pedido:referencia}}, {{campo:clave}}… Un nombre como datos.id arma un objeto anidado en el JSON. |
Si alguna variable es del pedido ({{pedido:…}}), la llamada espera hasta 15 minutos a que exista el pedido de la oportunidad (el sistema externo crea primero la oportunidad y después el pedido); pasado ese tiempo se omite.
Variables y valores aleatorios. Junto a «Variables a enviar» hay un selector «Insertar una variable» (agrupado en Contacto, Oportunidad, Pedido y Especiales) que pone la variable donde tengas el cursor, ya sea en «Variables a enviar» o en «Encabezados». Puedes usarlas en el valor de cualquier variable y de cualquier encabezado:
| Grupo | Variables |
|---|---|
| Contacto | {{nombre}}, {{apellidos}}, {{nombre_completo}}, {{correo}}, {{telefono}}, {{documento}} (número de documento), {{tipo_documento}}, {{tipo_contacto}}, {{id_contacto}}, {{campo:clave}} (campo personalizado) |
| Oportunidad | {{id_oportunidad}}, {{oportunidad:titulo}}, etapa, embudo, estado, valor, producto, cierre |
| Pedido (el de la oportunidad) | {{pedido:id}}, numero, referencia, estado, estado_pago, estado_entrega, productos, total, pagado, saldo, fecha, fuente, guia, comprobante_url, pago_monto, pago_metodo, pago_referencia |
| Especiales | {{fecha}} (hoy) y {{aleatorio}} |
Encabezados y tipos de valor. Connecto agrega solos Accept, User-Agent y Content-Type (application/json, o formulario según el formato). Si escribes uno de ellos en «Encabezados» (por ejemplo Content-Type: application/json), el tuyo reemplaza al automático: no se duplica. En el cuerpo JSON, un valor que no lleva variables se envía así: "student" entre comillas → texto student; true, false y null → booleano y nulo; 25 → número (los que empiezan por 0, como 007, siguen siendo texto). Un valor con variables siempre se envía como texto.
Valor aleatorio: {{aleatorio}} genera un texto alfanumérico al azar con mayúsculas, minúsculas y números (si tiene 3 o más caracteres, siempre lleva al menos una de cada clase). Por defecto son 16 caracteres; con {{aleatorio:24}} eliges el largo (de 1 a 64). Se genera un valor distinto cada vez que aparece y en cada llamada. Sirve, por ejemplo, para enviar una clave o un código único (clave={{aleatorio:12}}) o una contraseña temporal. Como lo enviado queda disponible para las sub-acciones como {{api:enviado_nombre}} (con el nombre de la variable; por ejemplo {{api:enviado_clave}}), puedes guardar ese valor en el pedido o avisarlo en un correo.
2. Cómo es la respuesta positiva
- Código HTTP: por defecto
200-299. Puedes indicar rangos y códigos sueltos:200-204, 409. - Campo de la respuesta (opcional): una ruta dentro del JSON de la respuesta (
status,data.estado,items.0.id) con un operador (es igual a, no es igual a, contiene, no está vacío, está vacío) y un valor. Si lo indicas, también debe cumplirse.
3. Cómo es la respuesta negativa
Es opcional: si la respuesta no es positiva, siempre es negativa. Aquí puedes definir una condición negativa explícita (por ejemplo 400-599, o status es igual a error); si se cumple, gana sobre la positiva. Si la API no responde (se acaba el tiempo o no se puede conectar), también es negativa.
4. Qué hacer en cada caso (sub-acciones)
Debajo de cada respuesta aparece Agregar sub-acción (hasta 5 por caso). Una sub-acción es cualquier otra acción de etapa (crear una tarea, avisar, cambiar un dato, enviar un correo, mover de etapa, cerrar como perdida…), excepto otra llamada a una API. Se ejecutan en orden, con los mismos datos de la oportunidad. En sus textos puedes usar la respuesta de la API: {{api:campo}} (los niveles se unen con «_»: {{api:data_enlace}} para data.enlace) y {{api:codigo}} para el código HTTP.
Qué queda registrado
En el detalle de la oportunidad, la acción aparece como correcta (respuesta positiva) o con error (respuesta negativa o sin respuesta), con el código HTTP y el resultado de cada sub-acción. No se guardan los valores enviados.
Seguridad: solo se llama a direcciones públicas, sin seguir redirecciones, con 8 segundos de espera y hasta 1 MB de respuesta. No pongas llaves en las variables de otros sistemas ni compartas la configuración de la etapa.
Qué queda registrado en el Resumen del contacto#
Lo que hacen las acciones de etapa se ve en la ficha del contacto, en Resumen (línea de tiempo) y en Actividad:
- Cada actividad creada con «Crear una actividad en el contacto» aparece con el ícono de rayo, el mensaje y la etapa en la que ocurrió.
- Cada correo enviado por una acción (también por una sub-acción) aparece como «Se le envió un correo» con su asunto. Al abrirlo se ve el correo tal como se envió (HTML visual, con las variables ya reemplazadas), a quién se envió y la fecha. Solo se registran los correos que realmente salieron; los omitidos o con error quedan únicamente en el registro de la oportunidad.
Los correos que las acciones ya habían enviado antes de esta función se registraron con su asunto, sin el cuerpo exacto (no se conservó).
Nombre de cada acción#
Cada acción y cada sub-acción lleva un nombre que tú eliges (por ejemplo «Correo de bienvenida al pagar» o «Crear usuario en la plataforma»). Se escribe en el primer campo, Nombre de la acción, al crear o editar la acción en Configurar etapa, y es obligatorio para guardarla. En la tarjeta aparece el nombre en negrita con el tipo de acción como etiqueta, y es el que se ve en la sección Acciones automáticas del detalle de la oportunidad y en su ventana de detalle. Las acciones creadas antes de esta función muestran el tipo hasta que les pongas nombre (se te pide al editarlas).
Orden de ejecución y cómo reordenar las acciones#
Las acciones de un mismo momento (por ejemplo, «Al entrar a la etapa») se ejecutan una después de otra, en el orden en que aparecen: la siguiente espera a que la anterior termine. Si una acción tiene retraso («24 h después») o está esperando algo (por ejemplo, a que se cree el pedido), las que siguen esperan su turno y continúan solas apenas termina (el sistema revisa cada 15 segundos). Una acción que termina omitida o con error también cuenta como terminada.
Para cambiar el orden, arrastra la tarjeta de la acción (el icono de puntos a la izquierda) y suéltala antes o después de otra del mismo momento; se guarda solo. Haz clic en la tarjeta para abrir su edición.
Ver el detalle de una acción ejecutada#
En el detalle de la oportunidad, sección Acciones automáticas, haz clic en una acción para abrir una ventana con:
- si se ejecutó correctamente, no se ejecutó (omitida o con error) o sigue pendiente;
- cuando no se ejecutó, el motivo o el error exacto (por ejemplo, «El contacto no ha autorizado mensajes por correo» o la respuesta negativa de una API);
- cómo es la acción: cuándo ocurre, en qué etapa, a quién avisa, qué template o plantilla usa, qué llamada hace, cuándo se ejecutó o para cuándo está programada;
- el botón Reintentar (o Ejecutar) cuando se puede volver a correr.
De una llamada a API se muestra solo la dirección sin parámetros y los nombres de lo que envía; los encabezados y valores no se muestran para no exponer claves.
En el modal de una llamada a una API aparecen además dos bloques:
- Datos enviados: el método y la dirección, y cada variable con su valor real ya reemplazado (por ejemplo
email = [email protected],curso_id = 31; si una variable salió vacía se marca «(vacío)»). - Respuesta recibida: el código HTTP y el contenido que devolvió el servicio (hasta 2.000 caracteres).
Los valores de variables o campos que parecen claves (contraseña, token, secreto, authorization) se muestran ocultos (••••••) y no se guardan. Las llamadas hechas antes de esta función no tienen estos datos.
Ejecutar las tareas que faltan de la etapa#
Si en la etapa actual de la oportunidad hay acciones sin ejecutar, omitidas, con error o pendientes (o sub-acciones omitidas o con error), en el detalle de la oportunidad, en el título de Acciones automáticas, aparece el botón Ejecutar tareas (N), con el número de tareas que faltan.
Al pulsarlo se recorren, una tras otra y en orden, las acciones «al entrar» de la etapa en la que está la oportunidad:
- las que ya salieron bien se saltan;
- las omitidas, con error o pendientes (por ejemplo, con retraso) se ejecutan ahora;
- las que nunca se registraron (por ejemplo, una acción que se agregó a la etapa después de que la oportunidad entró) también se ejecutan;
- si una falla, se sigue con la siguiente hasta terminar todas; al final un aviso indica cuántas salieron bien, cuántas tuvieron problema y cuántas ya estaban bien;
- las sub-acciones omitidas o con error de las acciones que ya estaban bien también se repiten.
El botón desaparece cuando no queda nada por ejecutar. No se muestra en oportunidades ganadas o perdidas. Aplica a las acciones de «Al entrar a la etapa»; las de «Al salir», «Al ganar», «Al perder» y por estancamiento no se tocan.
Reintentar una acción que quedó omitida o con error#
En el detalle de la oportunidad, sección Acciones automáticas, cada acción que quedó omitida o con error (por ejemplo «El contacto no ha autorizado mensajes por correo») muestra un botón Reintentar. Úsalo después de corregir la causa (autorizar el correo del contacto, completar un dato, arreglar la configuración): la acción se vuelve a correr desde donde quedó, sin repetir las que ya salieron bien.
- Funciona con las acciones de la etapa y con las sub-acciones de «Llamar a una API» y «Generar factura». Una sub-acción se repite con la misma configuración y las mismas variables (
{{api:…}},{{factura:…}}) que tenía; la llamada a la API o la factura no se vuelven a hacer. - No aparece en las acciones que salieron bien ni en las sub-acciones registradas antes de existir este botón.
- Si al reintentar vuelve a fallar, queda el nuevo motivo en el registro.
Generar factura#
Factura el pedido de la oportunidad (el creado con su oportunidad_id) en el programa de facturación conectado en Configuración → Conectores (Siigo o Alegra, el que esté en uso).
- Número de factura como campo: al crearse la factura, su número del proveedor queda como campo del pedido («Número de factura») y se ve también en el detalle de la oportunidad (con «Ver PDF» si el PDF está guardado). Si el proveedor no lo devuelve al crearla, se consulta enseguida. Además, el nombre del cliente nuevo se envía a Siigo sin emojis ni símbolos («Ale💜» → «Ale»), que Siigo rechaza.
- Detalle de cada línea: en la factura, el detalle de cada producto empieza por «Curso: » («Curso: DIAN 2676 - Técnico»). No se antepone a los adicionales ni al envío. El nombre del producto creado en Siigo no cambia.
- Qué lleva la factura: una línea por producto del pedido (con su descuento efectivo, es decir, el de la línea más la parte del descuento general que le tocó) y, si hay, el envío como una línea más. El valor de la factura es el total del pedido. En Siigo, la forma de pago es la relacionada con el método con el que se pagó (Transferencia bancaria, Bre-B, Efectivo o Pasarela de pago); si no hay relación o no hay pagos, la forma de pago por defecto. El cliente se busca o se crea con su número de documento (hay que tenerlo en la ficha del contacto).
- Nunca duplica: si el pedido ya tiene factura, la acción lo anota («ya tenía la factura…») y no crea otra.
- Espera: si el pedido todavía no existe (el sistema externo crea primero la oportunidad y después el pedido), espera hasta 15 minutos. Con el interruptor Esperar a que el pedido esté pagado, espera hasta 15 minutos a que el pedido esté pagado por completo; para pagos que tardan más, pon la acción en la etapa que se alcanza después de confirmar el pago.
- Resultados en el registro de la oportunidad: «Factura creada para el pedido PED-… : FV-…» (correcta), un error con el motivo que dio Siigo o Alegra (por ejemplo, falta configurar algo), o «omitida» si la facturación no está activa. La factura también queda anotada en el historial del pedido.
- Configuración de Siigo: tipo de factura, vendedor, impuesto, grupo contable de los productos, ciudad por defecto y si se envía a la DIAN o por correo se definen en Conectores (ver «Facturación con Siigo y Alegra»).
Guardar la factura (número y PDF)#
Después de «Generar factura», agrega la acción Guardar la factura (número y PDF):
- Número: guarda en el pedido el número de factura que asignó el proveedor (por ejemplo
FV-1-523); aparece en el pedido, en la API de pedidos (factura_numero,factura_proveedor,factura_pdf) y en el historial del pedido. Si Siigo todavía no lo había asignado al crearla, lo consulta. - PDF: lo descarga del proveedor y lo guarda en el servidor de Connecto (carpeta
storage/<empresa>/facturas). En el pedido aparece Ver PDF; solo lo ve quien puede ver ese pedido. Si el PDF ya estaba guardado no lo descarga otra vez. - Proveedores: con Siigo se descarga directamente. Con Alegra se usa la dirección del PDF que entrega su API (sin verificar contra una cuenta real de Alegra).
- Errores: si el pedido no tiene factura, o el proveedor no entrega un PDF válido, queda como error en el registro de la oportunidad con el motivo, y se puede reintentar.
- Productos que no existen en Siigo: si en Conectores se configuró el grupo contable (y no un código de producto fijo), Connecto crea el producto en Siigo la primera vez que lo factura, con un nombre aceptado por Siigo: la raya larga «—» pasa a «-», se quitan símbolos raros (como «:») y el nombre no pasa de 100 caracteres. Si Siigo aun así rechaza el nombre, reintenta una vez con uno de solo letras, números y espacios.
- Un teléfono del cliente se envía a Siigo con solo los últimos 10 dígitos (Siigo no admite más; «+57 300 111 2233» → «3001112233»).
Sub-acciones: según se haya creado o no la factura#
La acción registra si la factura se creó (también cuenta como creada si el pedido ya la tenía) o no se creó (Siigo o Alegra la rechazaron, falta el documento del cliente, la facturación está apagada…). En cada caso puedes agregar hasta 5 sub-acciones: «Si la factura SE CREA» y «Si la factura NO se crea». Sirven las mismas acciones de siempre (correo, WhatsApp, tarea, notificar, actividad, cambiar un dato, llamar a una API, mover…), salvo otra «Generar factura».
En los textos de las sub-acciones, además de las variables del contacto, la oportunidad y el pedido, puedes usar las de la factura (selector «Insertar una variable» → grupo Factura):
| Variable | Qué trae |
|---|---|
{{factura:numero}} | Número de la factura (ej. FV-1-123) |
{{factura:id}} | Identificador en el programa de facturación |
{{factura:proveedor}} | Siigo o Alegra |
{{factura:fecha}} / {{factura:total}} | Fecha y total de la factura |
{{factura:cufe}} | Código CUFE (si el programa lo devuelve) |
{{factura:estado_dian}} / {{factura:estado_correo}} | Estado del envío a la DIAN y del correo |
{{factura:ya}} | «Sí» si el pedido ya tenía la factura |
{{factura:error}} | Motivo por el que no se creó (solo en la rama de error) |
Ejemplo: si se crea, un correo «Tu factura {{factura:numero}} por {{factura:total}}»; si no, una tarea para contabilidad: «Facturar a mano el pedido {{pedido:numero}}: {{factura:error}}».
Crear una actividad en el contacto#
Registra una actividad en el Resumen de la ficha del contacto (con el ícono de rayo), con la hora en que ocurrió y la etapa («Al entrar a la etapa «Pago confirmado»»). Sirve para dejar constancia de lo que pasó en el proceso, por ejemplo «Matrícula confirmada: {{pedido:productos}} por {{pedido:total}} (pedido {{pedido:numero}})».
- Mensaje: escríbelo en el cuadro; el selector Insertar una variable pone la variable donde tengas el cursor. Puedes usar variables del contacto (nombre, correo, teléfono, documento…), de la oportunidad (título, etapa, valor, producto…) y del pedido de la oportunidad (número, total, estados, productos, comprobante…).
- Pedido: si el mensaje lleva variables del pedido, la acción espera hasta 15 minutos a que el pedido de la oportunidad exista.
- En la ficha: la actividad aparece en el Resumen; si el mensaje es largo, el título muestra el comienzo y al abrirla se ve completo.
- Registro: queda anotado en el detalle de la oportunidad como «Actividad creada en el contacto».