Estado de cuenta

Movimientos de una contraparte con saldo acumulado (cargos y abonos) y sus cuotas abiertas. Con `formato=pdf` devuelve el PDF A4 para enviárselo.

GEThttps://api.facturalo.pe/api/v3/cobranza/{lado}/estado-cuenta

Query

Campo

Descripción

lado

stringrequerido

cobrar (clientes: lo que te deben) o pagar (proveedores: lo que debes). Va en la ruta.Ej: cobrar

documento

stringrequerido

RUC o DNI de la contraparte.Ej: 20100070970

formato

stringopcional

pdf para el documento A4; sin él, JSON.

Language

Credentials

Header

Authorization

Token de la empresa · HTTP directo

Fetch Request

$ # Node 18+ fetch

const response = await fetch("https://api.facturalo.pe/api/v3/cobranza/cobrar/estado-cuenta", {
  method: "GET",
  headers: {
    "Authorization": "sk_test_…"
  }
});

const data = await response.json();
console.log(data);

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": {
    "contraparte": {
      "numeroDocumento": "20100070970",
      "nombre": "SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA 'O ' S.P.S.A."
    },
    "saldo": {
      "PEN": 9
    },
    "movimientos": [
      {
        "fecha": "2026-11-10",
        "tipo": "cuota",
        "documento": "NV01-00000002",
        "cuota": "1/1",
        "vence": "2026-12-10",
        "moneda": "PEN",
        "cargo": 12,
        "abono": null,
        "saldo": 12,
        "aplicacion": null,
        "glosa": null
      },
      {
        "fecha": "2026-11-10",
        "tipo": "aplicacion",
        "documento": "NV01-00000002",
        "cuota": "1/1",
        "vence": null,
        "moneda": "PEN",
        "cargo": null,
        "abono": 5,
        "saldo": 7,
        "aplicacion": "automatica",
        "glosa": null
      },
      {
        "fecha": "2026-11-10",
        "tipo": "cuota",
        "documento": "F001-00000010",
        "cuota": "1/2",
        "vence": "2026-12-10",
        "moneda": "PEN",
        "cargo": 3,
        "abono": null,
        "saldo": 10,
        "aplicacion": null,
        "glosa": null
      },
      {
        "fecha": "2026-11-10",
        "tipo": "cuota",
        "documento": "F001-00000010",
        "cuota": "2/2",
        "vence": "2027-01-09",
        "moneda": "PEN",
        "cargo": 3,
        "abono": null,
        "saldo": 13,
        "aplicacion": null,
        "glosa": null
      },
      {
        "fecha": "2026-11-10",
        "tipo": "cuota",
        "documento": "NV01-00000003",
        "cuota": "1/1",
        "vence": "2026-12-10",
        "moneda": "PEN",
        "cargo": 6,
        "abono": null,
        "saldo": 19,
        "aplicacion": null,
        "glosa": null
      },
      {
        "fecha": "2026-11-10",
        "tipo": "aplicacion",
        "documento": "NV01-00000002",
        "cuota": "1/1",
        "vence": null,
        "moneda": "PEN",
        "cargo": null,
        "abono": 5,
        "saldo": 14,
        "aplicacion": "automatica",
        "glosa": null
      },
      {
        "fecha": "2026-11-10",
        "tipo": "aplicacion",
        "documento": "NV01-00000002",
        "cuota": "1/1",
        "vence": null,
        "moneda": "PEN",
        "cargo": null,
        "abono": 2,
        "saldo": 12,
        "aplicacion": "automatica",
        "glosa": null
      },
      {
        "fecha": "2026-11-10",
        "tipo": "aplicacion",
        "documento": "NV01-00000003",
        "cuota": "1/1",
        "vence": null,
        "moneda": "PEN",
        "cargo": null,
        "abono": 3,
        "saldo": 9,
        "aplicacion": "automatica",
        "glosa": null
      }
    ],
    "abiertas": [
      {
        "id": "89472416-c066-4579-85f3-fc1ddbe44896",
        "tipo": "cuota",
        "contraparte": {
          "tipoDocumento": "6",
          "numeroDocumento": "20100070970",
          "nombre": "SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA 'O ' S.P.S.A."
        },
        "documento": "NV01-00000003",
        "documentoTipo": "NV",
        "cuota": 1,
        "cuotas": 1,
        "fecha": "2026-11-10",
        "vence": "2026-12-10",
        "moneda": "PEN",
        "importe": 6,
        "saldo": 3,
        "diasVencido": 0,
        "estado": "parcial",
        "comprobanteId": null,
        "notaVentaId": "a330d4ad-afdd-41b6-a39d-f367ef0d81b1",
        "compraId": null
      }
    ]
  }
}