La creación de facturas por lotes mediante la API de Siigo permite enviar múltiples comprobantes de venta de forma simultánea a través de un único proceso automatizado. Esta funcionalidad es clave, ya que agiliza tu flujo contable, reduce la carga operativa y optimiza la integración con otros sistemas.
A continuación te explicamos paso a paso cómo hacerlo:
1. Asegúrate de tener una cuenta activa en Siigo Nube y genera tus credenciales API para autenticarte.
Ten en cuenta el tamaño del cuerpo del request (solicitud) no debe exceder 1MB.
2. Configura la URL de notificación (notification_url), este campo es obligatorio y debe contener una URL válida, la cual servirá para recibir actualizaciones automáticas sobre el estado de cada factura del lote.
Para más detalles sobre este parámetro, puedes consultar nuestra documentación.
3. Prepara el arreglo de las facturas: el parámetro (invoices) es un array que contiene las facturas que deseas crear. Cada objeto dentro de este arreglo debe seguir la estructura definida en el endpoint de creación de facturas; para validar esta estructura revisa nuestra documentación.
Cada factura debe incluir el campo “idempotency_key”, puedes verificar su uso consultando el ejemplo de factura.
4. Recibe notificaciones del procesamiento del lote: una vez que el lote de facturas sea procesado, recibirás una notificación automática en la URL proporcionada. Esta notificación contendrá el estado de cada factura dentro del lote, puedes revisar el ejemplo de respuesta (Webhook).
Importante: esta información está dirigida únicamente al ingeniero o desarrollador encargado de integrar nuestra API; como cliente, no es necesario que realices ningún ajuste en tu programa, ya que todo el proceso lo gestiona el desarrollador si decide implementar la funcionalidad. Por ello, lo más recomendable es que compartas esta información con él.
Para conocer más detalles sobre el funcionamiento de la API, puedes consultar nuestra documentación. Si tienes alguna duda, contáctanos a través del correo soporteapi.aliados@siigo.com.
Con esta guía aprenderás a generar un lote de facturas de venta utilizando la API de Siigo.
