ES | EN

Webhooks

📨 Actualización de estado de documento

Descripción del evento DOCUMENT.STATUSUPDATE

Esta notificación de webhook se activa para suscripciones bajo el evento DOCUMENT.STATUSUPDATE. Se utiliza para recibir notificaciones sobre documentos que han sido enviados al organismo tributario y sus actualizaciones de estado.

Este webhook está relacionado con el endpoint /documents.

Disparadores del evento

Países síncronos (emisión y envío ocurren al mismo tiempo):

  • Un documento cambió de borrador a emitido (incluye información del envío al organismo tributario)

Países asíncronos (emisión y envío ocurren por separado):

  • Un documento cambió de borrador a emitido (sin información de envío al organismo tributario todavía)
  • Un documento ya emitido fue enviado al organismo tributario
  • Un documento ya enviado fue aceptado/rechazado

Formato de la notificación webhook

Te notificaremos a la URL suscrita cada vez que haya un disparador. Incluiremos el nuevo estado y la fecha del cambio. Consulta los estados del documento en cada país para saber cómo proceder.

event_id: DOCUMENT.STATUSUPDATE

{
    "document_id": 123,
    "account_id": 123,
    "document_status": 1,
    "taxbureau_send_status": 1,
    "taxbureau_send_id": "XXXXXX",
    "taxbureau_send_date": "AAAA-MM-DD",
    "taxbureau_validation_status": 5,
    "taxbureau_validation_comments": "XXXXX"
}

Ciclo de vida del documento por país