Registrar anticipo
Registra un anticipo que aumenta el saldo a favor de un cliente.
Descripción general
Este endpoint registra un anticipo del cliente: crea un movimiento manualAdvance con monto positivo que aumenta su saldo a favor en la moneda indicada. Solo registra el movimiento de saldo: no crea pagos, órdenes de cobro ni CFDI.
El monto se guarda con 2 decimales. Una solicitud exitosa devuelve 201 con el movimiento creado. Para deshacer un anticipo, usa Revertir movimiento de saldo.
Requiere el permiso Crear en Pagos.
Endpoint
https://app.credonix.mx/api/v1/customers/{customerId}/credit/advancesPath param: customerId — ID del cliente.
Registra un anticipo
Suma 500.00 al saldo a favor en MXN del cliente. created_by identifica la API key que registró el movimiento.
{
"currency": "MXN",
"amount": "500",
"notes": "Anticipo por contrato de mantenimiento"
}Reglas de los campos
| Campo | Tipo | Requerido | Notas |
|---|---|---|---|
currency | string | Sí | MXN o USD. Moneda del saldo a favor que aumenta. |
amount | string | Sí | Mayor a cero, máximo 2 decimales, por ejemplo "1234.50". |
notes | string | null | No | Notas del anticipo. |
Campos de la respuesta
Devuelve el movimiento creado con type: "manualAdvance" y amount positivo. Los campos se describen en Listar movimientos de saldo.
Errores
400 — validación fallida
{
"code": "VALIDATION_ERROR",
"message": "La petición contiene datos inválidos. Revisa errors para ver el detalle de cada campo.",
"errors": [
{
"field": "amount",
"code": "custom",
"message": "El monto debe ser un número mayor a cero"
}
],
"request_id": "96a35090-79cb-44cf-8a38-6233bf46ab97"
}| Status | Código | Causa |
|---|---|---|
400 | VALIDATION_ERROR | Cuerpo inválido: campo obligatorio faltante, amount en cero o con más de 2 decimales, o campo desconocido. |
401 | — | API key ausente, inválida o revocada. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Crear en Pagos. |
404 | CUSTOMER_NOT_FOUND | El cliente no existe o no pertenece a la organización. |