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_PROCESO — El documento fue recibido y está siendo procesado por SUNAT.

ACEPTADA SUNAT aceptó el comprobante correctamente.

RECHAZADA — SUNAT rechazó el comprobante. Revisa sunat.codigo y sunat.mensaje.

ANULADA El comprobante fue anulado exitosamente ante SUNAT.

PENDIENTE_RESUMEN — Boleta en espera de ser incluida en el Resumen Diario (RC). Consulta nuevamente para ver el resultado.

BAJA_RECHAZADA SUNAT rechazó la Comunicación de Baja (RA). La factura no fue anulada.

Campos del response

Campo	Tipo	Requerido	Descripción
`data`	object	Sí	Datos del documento.

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.consultar("83ad82a0-680e-11f1-8e35-2d93ac0f2c84");
console.log(result.estado, result.documento.totales.total);

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

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Documento encontrado.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "documento": {
      "id": "b8731080-6723-11f1-89fc-7d6d1075fa47",
      "estado": "ACEPTADA",
      "serie": "B001",
      "correlativo": "00000001",
      "tipo": "BOLETA",
      "tipoCodigo": "03",
      "fechaEmision": "2026-06-13",
      "fechaVencimiento": "2026-06-13",
      "moneda": "PEN",
      "formaPago": "CONTADO",
      "cliente": {
        "direccion": null,
        "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": [],
      "anticipos": [],
      "otrosCampos": [
        {
          "label": "Cajero",
          "value": "Guillermo"
        },
        {
          "label": "Método de pago",
          "value": "Yape"
        },
        {
          "label": "Mesa",
          "value": "12"
        }
      ]
    },
    "sunat": {
      "estado": "ACEPTADA",
      "codigo": "0",
      "mensaje": "La Boleta numero B001-00000001, ha sido aceptada",
      "notas": []
    },
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/documentos/b8731080-6723-11f1-89fc-7d6d1075fa47.pdf",
      "pdfTicket": "https://api.facturalo.pe/api/v3/documentos/b8731080-6723-11f1-89fc-7d6d1075fa47.ticket.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"
    },
    "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=",
    "cadenaQr": "20601476551 | 03 | B001 | 00000001 | 54.00 | 354.00 | 13/06/2026 | 1 | 12345678 | xvQpVbLssRc8FlD8/0LuSYeIPo8= |"
  }
}