Registrar cobro o pago

Registra el dinero recibido de un cliente (`cobrar`) o entregado a un proveedor (`pagar`) y lo aplica a sus cuotas. Lo que sobra queda como saldo a favor.

POSThttps://api.facturalo.pe/api/v3/cobranza/{lado}/pagos

Parámetros del body

Campo

Descripción

lado

stringrequerido

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

contraparte.numeroDocumento

stringrequerido

RUC o DNI del cliente o proveedor.Ej: 20100070970

contraparte.nombre

stringopcional

Nombre o razón social (si no tiene cuotas aún, para registrar un adelanto).

monto

numberrequerido

Monto recibido o entregado.Ej: 5

fecha

stringopcional

YYYY-MM-DD (default hoy).

moneda

stringopcional

PEN (default) o USD. Solo se aplica a cuotas de esa moneda.

medio

stringopcional

Id del medio de pago.

caja

stringopcional

Id de la caja por donde entra o sale el dinero (necesita turno abierto, salvo cajas sin turnos). Sin caja, no mueve ninguna caja (banco, transferencia).

referencia

stringopcional

N.º de operación o voucher (máx. 60).

glosa

stringopcional

Nota libre (máx. 250).

aplicaciones

arrayopcional

Opcional: a qué cuotas va y cuánto (partidaId, monto). Sin esto, se aplica a la más antigua primero. Ninguna puede superar el saldo de la cuota ni la suma el monto.

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/pagos", {
  method: "POST",
  headers: {
    "Authorization": "sk_test_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "contraparte": {
      "numeroDocumento": "20100070970"
    },
    "monto": 5,
    "medio": "a330be71-bbf2-4bd9-ae9f-aa5a889df2f2",
    "referencia": "OP-778812"
  })
});

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

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

201Created

{
  "success": true,
  "message": "Cobro registrado.",
  "data": {
    "id": "a330d533-fe72-4f90-a338-5898bc92fda2",
    "lado": "cobrar",
    "contraparte": {
      "tipoDocumento": "6",
      "numeroDocumento": "20100070970",
      "nombre": "SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA 'O ' S.P.S.A."
    },
    "fecha": "2026-11-10",
    "moneda": "PEN",
    "monto": 5,
    "medio": {
      "id": "a330be71-bbf2-4bd9-ae9f-aa5a889df2f2",
      "nombre": "Efectivo"
    },
    "cajaId": null,
    "referencia": null,
    "glosa": null,
    "estado": "registrado",
    "aplicaciones": [
      {
        "partidaId": "64b41250-ddfb-4949-9ecd-a37aa4139014",
        "documento": "NV01-00000002",
        "cuota": 1,
        "monto": 2,
        "aplicacion": "automatica"
      },
      {
        "partidaId": "89472416-c066-4579-85f3-fc1ddbe44896",
        "documento": "NV01-00000003",
        "cuota": 1,
        "monto": 3,
        "aplicacion": "automatica"
      }
    ],
    "saldoAFavor": 0,
    "creado": "2026-11-10T04:01:47-05:00"
  }
}