Eventos del documento

Retorna el historial de eventos de procesamiento de un documento: generación de XML, envío a SUNAT, respuesta de SUNAT y notificaciones por webhook. El `id` es el retornado al emitir el documento.

GEThttps://api.facturalo.pe/api/v3/documentos/{id}/eventos

Tipos de evento

tipo	Descripción
documento.recibido	El documento fue recibido y registrado en el sistema.
documento.xml_generado	El XML fue generado y firmado digitalmente.
documento.sunat.enviando	El documento está siendo enviado a SUNAT.
documento.sunat.respuesta	SUNAT procesó el documento y devolvió una respuesta.
documento.sunat.consulta	Facturalo consultó en SUNAT el estado del comprobante (CDR). No es un envío: por ejemplo, ocurre cuando SUNAT responde 1033 para saber si el número es tuyo o de otro sistema.
WEBHOOK_ENVIADO	El webhook fue enviado exitosamente a tu servidor.
WEBHOOK_FALLIDO	El intento de webhook falló (error HTTP o timeout).
WEBHOOK_REINTENTO	Reintento automático de un webhook fallido.
documento.error	Error fatal en el proceso tras todos los reintentos.

Estados de evento

estado	Descripción
OK	El evento se completó correctamente.
ACEPTADA	SUNAT aceptó el documento. Aparece en `documento.sunat.respuesta`.
RECHAZADA	SUNAT rechazó el documento. Ver campo `sunat.codigo` y `sunat.mensaje`.
FALLIDO	El envío de webhook falló. El sistema reintentará automáticamente.

Parámetros del response

Campo	Tipo	Requerido	Descripción
`data.total`	number	No	Total de eventos registrados.
`data.eventos[]`	array	No	Lista de eventos en orden cronológico.

Language

Credentials

Header

Authorization

Ejemplos con el SDK oficial en Node, PHP y Python

API Request

$ npm install @facturalo-pe/node

import { FacturaloClient } from "@facturalo-pe/node";

const facturalo = new FacturaloClient({ token: process.env.FACTURALO_TOKEN! });

const result = await facturalo.documentos.eventos("83ad82a0-680e-11f1-8e35-2d93ac0f2c84");
console.log(result.eventos);

SDK oficial @facturalo-pe/node · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Eventos del documento obtenidos correctamente.",
  "data": {
    "total": 5,
    "eventos": [
      {
        "id": 1,
        "tipo": "documento.recibido",
        "estado": "OK",
        "duracion_ms": 2,
        "fecha": "2026-06-14T09:52:53-05:00"
      },
      {
        "id": 2,
        "tipo": "documento.xml_generado",
        "estado": "OK",
        "duracion_ms": 340,
        "fecha": "2026-06-14T09:52:53-05:00"
      },
      {
        "id": 3,
        "tipo": "documento.sunat.enviando",
        "estado": "OK",
        "duracion_ms": 0,
        "fecha": "2026-06-14T09:52:54-05:00"
      },
      {
        "id": 4,
        "tipo": "documento.sunat.respuesta",
        "estado": "ACEPTADA",
        "duracion_ms": 1200,
        "sunat": {
          "codigo": "0",
          "mensaje": "La Factura numero F001-00000001 ha sido aceptada",
          "notas": []
        },
        "fecha": "2026-06-14T09:52:56-05:00"
      },
      {
        "id": 5,
        "tipo": "WEBHOOK_ENVIADO",
        "estado": "OK",
        "http_status": 200,
        "duracion_ms": 85,
        "fecha": "2026-06-14T09:52:56-05:00"
      }
    ]
  }
}