Cobranzas

Proponer la aplicación de saldos a cuenta

Propone cómo aplicar lo que los recibos de un cliente dejaron a cuenta a sus cuotas abiertas: primero las de importe exacto, después del recibo más viejo y por vencimiento. No graba nada.

GET/api/v1/collections/propose-credit-application

Permiso: collections.apply-credit
Empresa: Opera sobre la empresa activa
Tipo: Lectura: no cambia nada
Respuesta: JSON

Encabezados

Cookietextorequerido
La cookie de sesión del usuario de la integración (__Secure-erp.session_token). Cuando esté la clave API, va en Authorization: Bearer. Ver Autenticación.
X-Expected-Companyuuidrequerido
La empresa sobre la que operás. Si no coincide con la de la credencial, responde 409. Ver Empresa activa.

Parámetros de la consulta

customerIduuidrequerido
documentIduuidadmite null

Respuesta

200 con este JSON.

customerobjetorequerido
Campos (2)
- iduuidrequerido
- legalNametextorequerido
creditslista de objetorequerido
Campos de cada elemento (6)
- creditItemIduuidrequerido
- documentobjetorequerido
  Campos (3)
  - iduuidrequerido
  - kindopciónrequerido
    Valores: receipt credit-note
  - labeltextorequerido
- receiptIduuidrequeridoadmite null
- documentDatefecharequerido
- circuitopciónrequerido
  Valores: fiscal x
- balancetextorequerido
itemslista de objetorequerido
Campos de cada elemento (9)
- iduuidrequerido
- documentobjetorequerido
  Campos (2)
  - iduuidrequerido
  - labeltextorequerido
- installmentcualquierarequerido
- documentDatefecharequerido
- dueDatefecharequerido
- amounttextorequerido
- balancetextorequerido
- daysOverdueenterorequeridoadmite null
- circuitopciónrequerido
  Valores: fiscal x
applicationslista de objetorequerido
Campos de cada elemento (3)
- creditItemIduuidrequerido
- itemIduuidrequerido
- amounttextorequerido
todayfecharequerido

Errores

Un rechazo responde application/problem+json con un code estable. Los más comunes en esta operación:

`401`	Falta la credencial o venció.
`403`	La credencial no tiene el permiso `collections.apply-credit`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`422`	Datos inválidos o una regla de negocio rota, con el detalle por campo.
`503`	Sistema ocupado: reintentá después de `Retry-After` segundos.

La lista completa está en Errores.

curl
TypeScript

curl "$ERP_URL/api/v1/collections/propose-credit-application?customerId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/collections/propose-credit-application?customerId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90`, {
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "customer": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "legalName": "texto"
  },
  "credits": [
    {
      "creditItemId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "document": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "kind": "receipt",
        "label": "texto"
      },
      "receiptId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "documentDate": "2026-10-23",
      "circuit": "fiscal",
      "balance": "texto"
    }
  ],
  "items": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "document": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "label": "texto"
      },
      "installment": null,
      "documentDate": "2026-10-23",
      "dueDate": "2026-10-23",
      "amount": "texto",
      "balance": "texto",
      "daysOverdue": 1,
      "circuit": "fiscal"
    }
  ],
  "applications": [
    {
      "creditItemId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "itemId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "amount": "texto"
    }
  ],
  "today": "2026-10-23"
}