Webhook: documents.emissionFinished

Este evento se dispara cuando finaliza el procesamiento de emisión de un documento electrónico configurado para una compañía.

Para recibirlo, configura el webhook emissionDocumentFinished en la compañía:

{
  "webhooks": {
    "emissionDocumentFinished": {
      "status": "active",
      "url": "https://api.tu-compania.com/webhooks/emission-finished",
      "headers": {
        "Authorization": "Bearer token-de-tu-sistema"
      }
    }
  }
}

Body enviado al webhook

Alanube envía una solicitud POST a la URL configurada con un cuerpo similar al siguiente:

{
  "type": "fiscalInvoice",
  "id": "01HY9X7P4AG7K7N9Q4X9A7Y9M2",
  "date": "2026-06-01T15:40:02.000Z",
  "status": "FINISHED",
  "legalStatus": "SUNAT_AUTHORIZED",
  "companyIdentification": "20428729201",
  "trackId": "3b18edad-8fb3-46f6-98cc-d5bbff7e895b",
  "documentNumber": "F001-123",
  "governmentResponse": [
    {
      "valor": "La factura ha sido aceptada",
      "codigo": 0
    }
  ],
  "xml": "https://...",
  "cdr": "https://...",
  "pdf": "https://..."
}

Campos del payload

Campo	Tipo	Descripción
`type`	`string`	Tipo de documento emitido. Ver tabla de tipos más abajo.
`id`	`string`	Identificador interno del documento en Alanube.
`date`	`string`	Fecha de procesamiento del documento en formato ISO 8601.
`status`	`string`	Estado del evento. Para este webhook se envía `FINISHED`.
`legalStatus`	`string`	Estado legal final del documento ante SUNAT. Puede ser `SUNAT_AUTHORIZED` o `SUNAT_REJECTED`.
`companyIdentification`	`string`	RUC de la compañía emisora.
`trackId`	`string`	Ticket o identificador de seguimiento devuelto por SUNAT, cuando aplica.
`documentNumber`	`string`	Serie y correlativo del documento.
`governmentResponse`	`array`	Lista de mensajes normalizados desde la respuesta de SUNAT. Cada item incluye `valor` y `codigo`.
`xml`	`string`	URL temporal para descargar el XML enviado/generado, cuando está disponible.
`cdr`	`string`	URL temporal para descargar el CDR/respuesta de SUNAT, cuando está disponible.
`pdf`	`string`	URL temporal para descargar el PDF, cuando está disponible.

Tipos de documento (`type`)

`type`	Documento
`fiscalInvoice`	Factura electrónica
`fiscalTicket`	Boleta de venta electrónica
`creditNote`	Nota de crédito electrónica
`debitNote`	Nota de débito electrónica
`cashRegisterTicket`	Ticket de caja registradora
`remissionGuide`	Guía de remisión remitente electrónica
`remissionGuideCarrier`	Guía de remisión transportista electrónica
`withholding`	Retención electrónica
`perception`	Percepción electrónica

Estados

Campo	Valor	Descripción
`status`	`FINISHED`	Indica que el flujo de emisión ya terminó para efectos del webhook.
`legalStatus`	`SUNAT_AUTHORIZED`	SUNAT autorizó/aceptó el documento.
`legalStatus`	`SUNAT_REJECTED`	SUNAT rechazó el documento.

Consideraciones

El webhook solo se envía si emissionDocumentFinished.status está en active.
Alanube marca el documento como notificado cuando el POST al webhook se ejecuta correctamente.
Los links xml, cdr y pdf pueden no estar presentes si el archivo aún no existe o no aplica para el documento.

Updated about 2 months ago