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

ParamTipoDescripción
establecimientoopcionaluuidFiltra por establecimiento.
fecha_inicioopcionaldatefecha_emision >= valor. Formato YYYY-MM-DD.
fecha_finopcionaldatefecha_emision <= valor. Formato YYYY-MM-DD.
limiteopcionalintCantidad de resultados. Default 20, máx 100.
tipoopcionalstring01 = Factura · 03 = Boleta · 07 = NC · 08 = ND.
estadoopcionalstringACEPTADA · RECHAZADA · ANULADA · PENDIENTE_RESUMEN · etc.

Paginación

CampoDescripción
totalTotal de documentos que coinciden con los filtros.
limiteCantidad de resultados por página.
paginaPágina actual.
paginasTotal de páginas disponibles.
Requestjson
// Sin body — GET request
GET /empresas/documentos?tipo=03&fecha_inicio=2026-06-01&fecha_fin=2026-06-30&limite=20
200 — Respuesta exitosajson
{
  "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",
          "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",
          "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"
      }
    ]
  }
}