Listar cuotas

Cuotas (y saldos a favor) con su saldo y estado derivado, ordenadas por vencimiento.

GEThttps://api.facturalo.pe/api/v3/cobranza/{lado}/partidas

Query

Campo

Descripción

lado

stringrequerido

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

estado

stringopcional

abiertas (default), vencidas, por_vencer, pagadas, a_favor o todas.

contraparte

stringopcional

RUC o DNI del cliente o proveedor.

q

stringopcional

Busca por nombre, documento de la contraparte o número del comprobante.

page

integeropcional

Página (default 1).

limite

integeropcional

Por página, 1 a 100 (default 25).

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/partidas", {
  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": {
    "filas": [
      {
        "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
      },
      {
        "id": "e3621926-c8a7-47ab-8766-32de85ba2cc3",
        "tipo": "cuota",
        "contraparte": {
          "tipoDocumento": "6",
          "numeroDocumento": "20100070970",
          "nombre": "SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA 'O ' S.P.S.A."
        },
        "documento": "F001-00000010",
        "documentoTipo": "01",
        "cuota": 1,
        "cuotas": 2,
        "fecha": "2026-11-10",
        "vence": "2026-12-10",
        "moneda": "PEN",
        "importe": 3,
        "saldo": 3,
        "diasVencido": 0,
        "estado": "pendiente",
        "comprobanteId": "1afb2800-dce5-11f1-957e-85ec05b206e4",
        "notaVentaId": null,
        "compraId": null
      }
    ],
    "total": 3,
    "pagina": 1,
    "paginas": 2
  }
}