Consultar documento

Retorna el estado actual de un documento. El {id} es el ID retornado al emitir o anular el documento.

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

Estados posibles

EN_PROCESOEl documento fue recibido y está siendo procesado por SUNAT.
ACEPTADASUNAT aceptó el comprobante correctamente.
RECHAZADASUNAT rechazó el comprobante. Revisa sunat.codigo y sunat.mensaje.
ANULADAEl comprobante fue anulado exitosamente ante SUNAT.
PENDIENTE_RESUMENBoleta en espera de ser incluida en el Resumen Diario (RC). Consulta nuevamente para ver el resultado.
BAJA_RECHAZADASUNAT rechazó la Comunicación de Baja (RA). La factura no fue anulada.

Campos del response

data
objectrequerido
Datos del documento.
estado
stringrequerido
Estado global del documento. Ver tabla de estados.
entorno
stringrequerido
"demo" o "produccion".
documento
objectrequerido
Datos del comprobante.
id
stringrequerido
ID del documento.
estado
stringrequerido
Estado del comprobante.
serie
stringrequerido
Serie del comprobante.
correlativo
stringrequerido
Número correlativo (8 dígitos con ceros a la izquierda).
tipo
stringrequerido
Nombre del tipo: "FACTURA", "BOLETA", etc.
tipoCodigo
stringrequerido
Código SUNAT: "01" = Factura · "03" = Boleta · "07" = NC · "08" = ND.
fechaEmision
stringrequerido
Fecha de emisión en formato YYYY-MM-DD.
fechaVencimiento
stringrequerido
Fecha de vencimiento en formato YYYY-MM-DD.
moneda
stringrequerido
"PEN" o "USD".
formaPago
stringrequerido
"CONTADO" o "CREDITO".
cliente
objectrequerido
Datos del receptor del comprobante.
tipoDocumento
stringrequerido
Tipo de documento del cliente.
numeroDocumento
stringrequerido
RUC o DNI del cliente.
denominacion
stringrequerido
Nombre o razón social.
totales
objectrequerido
Totales del comprobante.
gravada
numberrequerido
Base imponible gravada.
exonerada
numberrequerido
Monto exonerado de IGV.
inafecta
numberrequerido
Monto inafecto.
exportacion
numberrequerido
Monto de exportación.
gratuita
numberrequerido
Monto de operaciones gratuitas.
descuento
numberrequerido
Descuento total aplicado.
anticipo
numberrequerido
Monto de anticipos aplicados.
isc
numberrequerido
Impuesto Selectivo al Consumo.
igv
numberrequerido
Total de IGV.
impuestoBolsa
numberrequerido
Total de ICBPER (impuesto a bolsas plásticas).
otrosCargos
numberrequerido
Otros cargos adicionales.
total
numberrequerido
Importe total del comprobante.
items
arrayrequerido
Líneas del comprobante.
codigo
stringopcional
Código interno del producto.
descripcion
stringrequerido
Descripción del producto o servicio.
unidad
stringrequerido
Código de unidad de medida SUNAT.
cantidad
numberrequerido
Cantidad.
valorUnitario
numberrequerido
Valor unitario sin IGV.
precioUnitario
numberrequerido
Precio unitario con IGV.
descuento
numberrequerido
Descuento aplicado al ítem.
subtotal
numberrequerido
Subtotal sin IGV.
tipoIgv
stringrequerido
Código de tipo de IGV: "10" = Gravado, "20" = Exonerado, etc.
tipoIgvDescripcion
stringrequerido
Descripción del tipo de IGV.
igv
numberrequerido
IGV del ítem.
total
numberrequerido
Total del ítem con IGV.
guias
arrayrequerido
Guías de remisión asociadas. Vacío ([]) si no aplica.
cuotas
arrayrequerido
Cuotas de pago si formaPago es CREDITO. Vacío ([]) en CONTADO.
sunat
objectrequerido
Respuesta de SUNAT.
estado
stringrequerido
Estado devuelto por SUNAT.
codigo
stringrequerido
"0" = éxito. Otro valor = error.
mensaje
stringrequerido
Mensaje descriptivo de SUNAT.
notas
arrayrequerido
Advertencias de SUNAT (puede ser vacío).
enlaces
objectrequerido
URLs de descarga del comprobante.
pdf
stringrequerido
URL del PDF del comprobante.
xml
stringrequerido
URL del XML firmado.
cdr
stringrequerido
URL del CDR (Constancia de Recepción SUNAT).
Requestjson
// Sin body — GET request
// GET /documentos/b8731080-6723-11f1-89fc-7d6d1075fa47
200 — Documento encontradojson
{
  "success": true,
  "message": "Documento encontrado.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "documento": {
      "id": "b8731080-6723-11f1-89fc-7d6d1075fa47",
      "estado": "ACEPTADA",
      "serie": "B001",
      "correlativo": "1",
      "tipo": "BOLETA",
      "tipoCodigo": "03",
      "fechaEmision": "2026-06-13",
      "fechaVencimiento": "2026-06-13",
      "moneda": "PEN",
      "formaPago": "CONTADO",
      "cliente": {
        "tipoDocumento": "1",
        "numeroDocumento": "12345678",
        "denominacion": "NOMBRES Y APELLIDOS"
      },
      "totales": {
        "gravada": 300,
        "exonerada": 0,
        "inafecta": 0,
        "exportacion": 0,
        "gratuita": 0,
        "descuento": 0,
        "anticipo": 0,
        "isc": 0,
        "igv": 54,
        "impuestoBolsa": 0,
        "otrosCargos": 0,
        "total": 354
      },
      "items": [
        {
          "codigo": "",
          "descripcion": "Producto con guía de remisión",
          "unidad": "NIU",
          "cantidad": 3,
          "valorUnitario": 100,
          "precioUnitario": 118,
          "descuento": 0,
          "subtotal": 300,
          "tipoIgv": "10",
          "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA",
          "igv": 54,
          "total": 354
        }
      ],
      "guias": [
        {
          "tipoDocumento": "09",
          "numeroDocumento": "T001-00000001"
        }
      ],
      "cuotas": []
    },
    "sunat": {
      "estado": "ACEPTADA",
      "codigo": "0",
      "mensaje": "La Boleta numero B001-1, ha sido aceptada",
      "notas": []
    },
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/documentos/b8731080-6723-11f1-89fc-7d6d1075fa47.pdf",
      "xml": "https://api.facturalo.pe/api/v3/documentos/b8731080-6723-11f1-89fc-7d6d1075fa47.xml",
      "cdr": "https://api.facturalo.pe/api/v3/documentos/b8731080-6723-11f1-89fc-7d6d1075fa47.cdr"
    }
  }
}
404 — No encontradojson
{
  "success": false,
  "message": "No se encontró el documento en el entorno DEMO.",
  "data": []
}