Sincroniza tus comprobantes electrónicos con tu ERP sin perder ninguno

Si llevas tus ventas en un ERP propio y facturas con AZUR, necesitas que ambos sistemas coincidan. Una sincronización mal hecha pierde comprobantes o los duplica. Así se hace bien.

Dos mecanismos que se complementan

• Webhooks: te avisan al instante cuando un comprobante se autoriza, se rechaza o se anula.
• Sincronización por consulta: tu sistema pregunta periódicamente qué cambió.

Lo recomendable es usar los dos: el webhook para enterarte rápido y la sincronización periódica como red de seguridad.

Sincronizar con fecha y cursor

La API v2 permite listar los comprobantes modificados desde una fecha:

GET /plataforma/api/v2/comprobantes?modificado_desde=2026-10-01T00:00:00
X-Api-Key: azur_live_...

Si hay muchos resultados, la respuesta incluye un cursor para pedir la página siguiente. Recorres páginas hasta que no haya más y guardas el punto donde terminaste para la próxima ejecución.

Por qué cursor y no solo páginas

Con páginas numeradas, si entra un comprobante nuevo mientras recorres la lista, los resultados se «corren» y puedes saltarte o repetir documentos. El cursor mantiene la posición aunque la lista cambie.

Con los SDK es más simple

Los SDK oficiales recorren el cursor por ti: en PHP con un generador y en JavaScript con for await. Solo procesas cada comprobante.

Buenas prácticas

• Guarda en tu ERP la clave de acceso de cada comprobante: es su identificador único.
• Haz la sincronización idempotente: si un comprobante ya existe, actualízalo en lugar de crearlo.
• Deja un pequeño margen de solapamiento en la fecha de la siguiente ejecución.
• Respeta los límites por minuto y espera lo que indique Retry-After.

También para lo que te emiten

La API permite consultar los comprobantes recibidos (los que te emiten tus proveedores) para alimentar tu módulo de compras.

Consulta los parámetros exactos en la referencia de la API y la sección de consulta en la guía.

Conecta tu ERP: crea tu cuenta gratis.