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

tipoDescripción
documento.recibidoEl documento fue recibido y registrado en el sistema.
documento.xml_generadoEl XML fue generado y firmado digitalmente.
documento.sunat.enviandoEl documento está siendo enviado a SUNAT.
documento.sunat.respuestaSUNAT procesó el documento y devolvió una respuesta.
WEBHOOK_ENVIADOEl webhook fue enviado exitosamente a tu servidor.
WEBHOOK_FALLIDOEl intento de webhook falló (error HTTP o timeout).
WEBHOOK_REINTENTOReintento automático de un webhook fallido.
documento.errorError fatal en el proceso tras todos los reintentos.

Estados de evento

estadoDescripción
OKEl evento se completó correctamente.
ACEPTADASUNAT aceptó el documento. Aparece en documento.sunat.respuesta.
RECHAZADASUNAT rechazó el documento. Ver campo sunat.codigo y sunat.mensaje.
FALLIDOEl envío de webhook falló. El sistema reintentará automáticamente.

Parámetros del response

data.total
numberopcional
Total de eventos registrados.
data.eventos[]
arrayopcional
Lista de eventos en orden cronológico.
id
numberopcional
ID numérico del evento.
tipo
stringopcional
Tipo de evento. Ver tabla de tipos.
estado
stringopcional
"OK" · "ACEPTADA" · "RECHAZADA" · "FALLIDO".
duracion_ms
numberopcional
Duración en milisegundos.
fecha
stringopcional
Fecha y hora del evento en ISO 8601.
sunat
object | nullopcional
Presente en documento.sunat.respuesta.
codigo
stringopcional
Código SUNAT. "0" = sin error.
mensaje
stringopcional
Mensaje de SUNAT.
notas
arrayopcional
Observaciones de SUNAT (puede ser vacío).
http_status
number | nullopcional
Código HTTP retornado por tu servidor. Presente en WEBHOOK_ENVIADO y WEBHOOK_FALLIDO.
200 — Respuesta exitosajson
{
  "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"
      }
    ]
  }
}