curl --request POST \
--url https://api.filexpress.app/api/external/receivables/payments \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"payment_method_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"bank_id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"reference_number": "TRF-88231",
"payment_date": "2026-10-06",
"notes": "Cobro parcial",
"allocations": [
{
"sale_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"amount": 300
}
]
}
'{
"status": true,
"data": {
"payments": [
{
"payment_id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"sale_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"generation_code": "6F1E2D3C-8A4B-4C5D-9E6F-0A1B2C3D4E5F",
"amount": 300,
"pending_amount": 330,
"payment_status": "partial"
}
],
"total_applied": 300
}
}Registrar cobro
Aplica un cobro por factura (allocations) o repartido de la factura más antigua a la más reciente; todo o nada.
Permiso requerido: receivables.payments
curl --request POST \
--url https://api.filexpress.app/api/external/receivables/payments \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"payment_method_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"bank_id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"reference_number": "TRF-88231",
"payment_date": "2026-10-06",
"notes": "Cobro parcial",
"allocations": [
{
"sale_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"amount": 300
}
]
}
'{
"status": true,
"data": {
"payments": [
{
"payment_id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"sale_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"generation_code": "6F1E2D3C-8A4B-4C5D-9E6F-0A1B2C3D4E5F",
"amount": 300,
"pending_amount": 330,
"payment_status": "partial"
}
],
"total_applied": 300
}
}Authorizations
API Key de la integración (Integraciones → Nueva Integración).
Headers
Opcional. Llave única por operación (máx. 100 caracteres, vale 24 h por integración). Un reintento con la misma llave y el mismo cuerpo devuelve la respuesta original (header Idempotent-Replayed: true) sin repetir la operación; con otro cuerpo, o mientras la primera sigue en proceso, responde 409.
100Body
Forma de pago (GET /payment-methods).
Fecha del pago.
Banco (GET /treasury/banks).
Referencia (máx. 255).
Notas (máx. 500).
Requerido junto con el tercero (modo automático).
Monto a repartir (modo automático).
x > 0Cliente (modo automático, en lugar de allocations).
Monto por factura (o usa customer_id).
1 - 200 elementsShow child attributes
Show child attributes