Listar documentos

Retorna los documentos de la empresa paginados. Soporta filtros por establecimiento, fecha, tipo y estado.

GEThttps://api.facturalo.pe/api/v3/empresas/documentos

Query params

Param	Tipo	Descripción
`establecimiento`opcional	uuid	Filtra por establecimiento.
`fecha_inicio`opcional	date	fecha_emision >= valor. Formato YYYY-MM-DD.
`fecha_fin`opcional	date	fecha_emision <= valor. Formato YYYY-MM-DD.
`limite`opcional	int	Cantidad de resultados. Default 20, máx 100.
`tipo`opcional	string	01 = Factura · 03 = Boleta · 07 = NC · 08 = ND.
`estado`opcional	string	ACEPTADA · RECHAZADA · ANULADA · PENDIENTE_RESUMEN · etc.

Paginación

Campo	Descripción
total	Total de documentos que coinciden con los filtros.
limite	Cantidad de resultados por página.
pagina	Página actual.
paginas	Total de páginas disponibles.

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.listar({ tipo: "01,03", estado: "ACEPTADA", pagina: 1 });
console.log(result.paginacion, result.documentos);

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

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Documentos obtenidos correctamente.",
  "data": {
    "entorno": "demo",
    "paginacion": {
      "total": 46,
      "limite": 20,
      "pagina": 1,
      "paginas": 3
    },
    "documentos": [
      {
        "id": "9c948140-674e-11f1-85b5-d764057e10c4",
        "serie": "B001",
        "correlativo": "00000153",
        "tipo": "DOCUMENTO",
        "tipoCodigo": "03",
        "fechaEmision": "2026-06-13",
        "moneda": "PEN",
        "cliente": {
          "numeroDocumento": "20000000001",
          "denominacion": "EMPRESA CLIENTE SAC"
        },
        "totales": {
          "gravada": 500,
          "igv": 90,
          "total": 590
        },
        "sunat": {
          "estado": "ACEPTADA",
          "codigo": "0"
        },
        "anulado": false,
        "enlaces": {
          "pdf": "https://api.facturalo.pe/api/v3/documentos/9c948140-674e-11f1-85b5-d764057e10c4.pdf",
          "pdfTicket": "https://api.facturalo.pe/api/v3/documentos/9c948140-674e-11f1-85b5-d764057e10c4.ticket.pdf",
          "xml": "https://api.facturalo.pe/api/v3/documentos/9c948140-674e-11f1-85b5-d764057e10c4.xml",
          "cdr": "https://api.facturalo.pe/api/v3/documentos/9c948140-674e-11f1-85b5-d764057e10c4.cdr"
        }
      },
      {
        "id": "b8731080-6723-11f1-89fc-7d6d1075fa47",
        "serie": "B001",
        "correlativo": "00000012",
        "tipo": "DOCUMENTO",
        "tipoCodigo": "03",
        "fechaEmision": "2026-06-13",
        "moneda": "PEN",
        "cliente": {
          "numeroDocumento": "20609753413",
          "denominacion": "TEC WORL S.A.C."
        },
        "totales": {
          "gravada": 300,
          "igv": 54,
          "total": 354
        },
        "guias": [
          {
            "tipoDocumento": "09",
            "numeroDocumento": "T001-00000001"
          }
        ],
        "sunat": {
          "estado": "ACEPTADA",
          "codigo": "0"
        },
        "anulado": false,
        "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"
        }
      },
      {
        "...": "// 18 documentos más en esta página"
      }
    ]
  }
}