Automatización · Cobros y cartera
Crear una factura electrónica en Siigo con aprobación antes de enviarla a la DIAN
Verifica cliente, productos y catálogos de Siigo, muestra el resumen y crea la factura solo después de una aprobación nueva. Lee el estado real de la DIAN.
¿Cómo creo una factura electrónica en Siigo sin enviarla a la DIAN antes de revisarla?
Desde el escritorio de Meteor, el Met verifica un cliente activo que ya existe, cada producto por código y los catálogos reales de documento, vendedor, impuestos y pagos. Solo usa un documento electrónico con numeración automática que no exija vendedor por ítem ni centro de costo. Luego muestra todos los datos, termina el turno y espera una aprobación explícita en un mensaje nuevo. Ese sí habilita confirmar en true; la petición inicial, el silencio y el texto "true" no. CO es una precondición administrativa porque estas tools no exponen el país ni detectan una configuración equivocada. enviar_dian es otra decisión: true solicita el envío, y el Met reporta el estado Draft, Accepted o Rejected que Siigo devuelve. La tarea es manual y no funciona desde un Met de canal.
Dónde aplica: Colombia. La receta usa el contrato colombiano de factura electrónica y los estados que Siigo documenta para la DIAN. No presenta esos datos como equivalentes al CFDI mexicano.
Qué la pone en marcha
Cuando alguien lo pide
Una persona inicia la tarea desde el escritorio y entrega la venta que quiere facturar. El Met prepara y muestra el resumen, pero la creación queda detenida hasta recibir una aprobación explícita en un mensaje posterior. Si cambia cliente, vendedor, documento, línea, pago o decisión de envío, vuelve a mostrar todo y pide otra aprobación.
Una tarea de ejecución manual: alguien del equipo la corre con un botón, o se la pide al Met por chat.
Quién la ejecuta
Met de facturación en Siigo Colombia
Área de Administración
Opera como apoyo interno desde la plataforma web. Separa la preparación de la escritura fiscal, deja a una persona revisar el documento concreto y conserva el estado que Siigo devuelve como fuente de verdad, sin convertir una solicitud de envío en una aceptación inventada.
Qué hay que tener conectado
- Siigo Cobrar y administrar
6 pasos · 6 herramientas
El procedimiento, paso a paso
Cada paso muestra la herramienta que se ejecuta. Son las del conector real: si una dejara de existir, esta página no compilaría.
- 1
Verificar el cliente y revisar que la factura no exista
El Met busca la identificación exacta y solo acepta una ficha activa de cliente, con la sucursal que se usará. Esta receta no da de alta terceros: si no existe, alguien lo crea y valida en Siigo antes de retomarla. También lista las facturas del cliente en la fecha aplicable, recorriendo las páginas necesarias, para detectar una emisión previa con los mismos datos. Una coincidencia se consulta y se entrega al operador; no se crea otra por reflejo.
- 2
Leer cada producto con su tratamiento fiscal real
Cada línea parte de un código existente, nunca de un nombre aproximado. La consulta devuelve precios, impuestos, clasificación fiscal y si el precio configurado incluye impuesto. Esta receta usa el precio unitario sin impuestos que acepta el handler; si la operación solo dispone de un precio con impuesto incluido, se detiene para que una persona determine el valor correcto. Si una búsqueda por nombre queda incompleta, pide el código en vez de afirmar que no existe.
- 3
Resolver documento, vendedor, impuestos y pagos desde los catálogos
Para el documento consulta el tipo FV y exige que esté activo, sea electrónico, use numeración automática, tenga vendedor_por_item en false y centro_costo_obligatorio en false. El vendedor también debe estar activo. Los impuestos salen por id y las formas de pago se consultan con catalogo formas_pago y el input publicado tipo_documento="FV". Si el pago exige vencimiento, se conserva su fecha YYYY-MM-DD. Conserva el id exacto elegido como documento_id: debe ser un entero positivo y no existe un fallback al primer FV. Ningún id ni consecutivo se deduce del nombre visible.
- 4
Mostrar el documento completo y terminar el turno
Antes de escribir, el Met muestra cliente y sucursal, tipo de documento y su documento_id, vendedor, fecha, cada código con cantidad, precio e impuestos, cada pago con valor y vencimiento, el total esperado por la operación y las decisiones separadas de enviar a la DIAN y enviar por correo. Luego se detiene. La solicitud original no cuenta como aprobación de este resumen; hace falta un mensaje nuevo y explícito. Una pregunta, el silencio o una respuesta ambigua mantienen la factura sin crear. Si algo cambia, este resumen se reemplaza y la aprobación anterior caduca.
- 5
Crear una sola vez y leer el estado que Siigo devuelve
Solo tras el sí nuevo llama siigo_crear_factura con confirmar como booleano literal true, el vendedor obligatorio y el documento_id aprobado como entero positivo. Esos datos se validan antes de cualquier petición y no hay selección automática del documento. confirmar nunca se reenvía a Siigo. enviar_dian y enviar_email, cuando se incluyen, deben ser booleanos literales; strings, 1 u objetos se rechazan antes de la red. enviar_dian solo va en true si esa decisión también se aprobó. Después consulta el id creado y reporta número, total y estado: Draft es guardada sin enviar y sin CUFE; Accepted es aceptada por la DIAN; Rejected es enviada pero rechazada y requiere corrección y reenvío desde Siigo Nube.
- 6
Reconciliar una respuesta incierta sin repetir la factura
Si la creación responde posiblemente_creada, el Met no vuelve a llamar la escritura. Lista las facturas por cliente y fecha, recorre todas las páginas aplicables y consulta los candidatos para comparar cliente, fecha, vendedor, líneas, pagos y total. Aunque no encuentre coincidencia, no reintenta automáticamente: entrega la evidencia al operador para revisar el consecutivo y el estado en Siigo Nube. Una segunda factura solo puede surgir de una decisión humana posterior, no de un retry técnico.
Antes de empezar
Qué necesitas tener listo
Ninguno de estos puntos lo resuelve el Met. Si falta uno, la automatización se detiene ahí.
-
Una cuenta de Siigo Nube Colombia con API habilitada
El administrador genera usuario, clave de acceso y Partner-Id en Configuración, Alianzas e integraciones, Credenciales de integración a plataformas digitales, Añadir aplicación. La integración debe estar configurada como CO; esta receta no mezcla el contrato de México. Es una comprobación administrativa: las tools de la receta no devuelven si el conector usa CO o MX.
-
Cliente, productos, vendedor y configuración fiscal ya creados
Mantén activos en Siigo el cliente y su sucursal, los productos con código y tratamiento fiscal, el vendedor, los impuestos y las formas de pago para FV. La receta los consulta, pero no crea clientes, productos ni configuración contable.
-
Un documento electrónico compatible con esta receta
En Siigo configura un tipo FV activo, electrónico y con numeración automática. Debe usar un vendedor único para la factura y no exigir centro de costo. El Met conserva el id seleccionado como documento_id entero positivo y lo incluye en la aprobación; las configuraciones especiales se atienden directamente en Siigo.
Los límites
Qué NO resuelve esta automatización
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No detecta si el conector quedó configurado por error como MX. El país vive en la credencial y estas seis tools no lo exponen; un administrador debe confirmar CO antes de ejecutar la receta.
-
No funciona desde WhatsApp, chat web, Instagram ni Messenger. El conector bloquea la herramienta fiscal cuando la petición trae contexto de canal; esta receta se opera desde la plataforma web.
-
No crea ni actualiza clientes. Trabaja con una identificación y una sucursal activas ya verificadas; el alta y la corrección de datos fiscales se hacen fuera de este flujo.
-
No cubre numeración manual, vendedor distinto por ítem ni documentos que exijan centro de costo. Tampoco adivina consecutivos: la numeración automática configurada en Siigo gobierna la emisión.
-
No convierte un precio con impuesto incluido a precio sin impuesto ni inventa impuestos. Si la ficha del producto no entrega un valor compatible con el input actual, el operador lo resuelve.
-
No afirma que enviar_dian en true signifique Accepted. Reporta Draft, Accepted o Rejected según la respuesta de Siigo y deja la corrección de un rechazo en Siigo Nube.
-
No descarga ni devuelve un link al PDF. Siigo ofrece el PDF en un endpoint separado que este conector no implementa; el operador abre el documento en Siigo Nube.
-
No reintenta automáticamente una creación ambigua, aunque las consultas no muestren una coincidencia. Una respuesta incierta puede ocultar una factura ya creada y duplicarla consume otro consecutivo.
Preguntas frecuentes
Preguntas sobre esta automatización
Porque el primer pedido todavía no contiene la evidencia que se debe aprobar. El segundo mensaje responde al cliente, vendedor, documento, fecha, líneas, pagos, total esperado y decisión sobre la DIAN que el Met acaba de mostrar. El handler exige el booleano literal true; ausencia, false y el texto "true" se rechazan antes de salir a la red.
No. Significa que se pidió el envío. Draft indica que quedó guardada sin enviar y sin CUFE, Accepted que la DIAN la aceptó y Rejected que fue enviada pero rechazada. El Met lee el estado devuelto; no deduce Accepted a partir del parámetro.
La receta informa ese estado y se detiene. La documentación de Siigo indica corregir y reenviar desde Siigo Nube. No cambia datos ni vuelve a emitir automáticamente, porque eso puede producir otro documento fiscal.
No. El cliente debe existir, estar activo y tener la sucursal correcta antes de preparar la factura. El alta se hace en Siigo o en un flujo separado y después se vuelve a verificar aquí.
En Siigo Nube. La API tiene una operación separada para obtener el PDF en base64, pero el conector actual no la expone. La consulta de esta receta devuelve los datos y el estado fiscal, no un archivo ni una URL.
Trata el resultado como posiblemente creado, lista las facturas del cliente y la fecha por todas las páginas aplicables y consulta cada candidato. Nunca reintenta automáticamente, ni siquiera cuando no encuentra una coincidencia; el operador revisa el consecutivo en Siigo.
Sigue por aquí
Otras automatizaciones con las mismas herramientas
Ventas y cotización
De la pregunta a la cotización firmada, sin salir de WhatsApp
¿Cómo le mando una cotización formal de Siigo a un cliente por WhatsApp sin abrir el sistema?
Administración
- Arranca:
- cuando el cliente escribe
- Pasos:
- 6, con 11 herramientas reales
- Necesita:
- Siigo · CRM de Meteor
Cobros y cartera
Cobrar dentro de la conversación con un enlace de Mercado Pago
¿Cómo cobro por WhatsApp sin pasar al cliente a otra aplicación ni pedirle datos de tarjeta?
Ventas
- Arranca:
- cuando el cliente escribe
- Pasos:
- 6, con 11 herramientas reales
- Necesita:
- Mercado Pago · CRM de Meteor
Cobros y cartera
Cobrar la cartera vencida por WhatsApp, sin perseguir a nadie a mano
¿Cómo cobro las facturas vencidas por WhatsApp sin revisar la cartera a mano?
Administración
- Arranca:
- a una hora fija
- Pasos:
- 5, con 8 herramientas reales
- Necesita:
- Alegra · CRM de Meteor
Cobros y cartera
Cobrar por PSE y Nequi dentro de la conversación, con Wompi
¿Cómo cobro por PSE o Nequi desde WhatsApp sin sacar al cliente de la conversación?
Ventas
- Arranca:
- cuando el cliente escribe
- Pasos:
- 5, con 10 herramientas reales
- Necesita:
- Wompi · CRM de Meteor
¿Quieres esta automatización corriendo con tus datos?
Te la mostramos con tus cuentas conectadas, no con una demostración enlatada.