POST
/api/mod/contabilidad/{espacio}/push/paymentEncola un pago
Deja un pago recibido en la cola para registrarlo en tu software contable.
- PERMISOescribe
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Contabilidad. |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| referencia_interna | string | SÍ | Tu id del pago o de la venta. Impide registrarlo dos veces. |
| factura_external_id | string | no | El id de la factura en tu software (su external_id, en el resultado de la factura). Si va, el pago se asocia a ella. |
| monto | cifra | SÍ | Lo que se pagó. |
| metodo | string | SÍ | Cómo se pagó, con el nombre que use tu software (transfer, cash…). |
| fecha | string | SÍ | Cuándo, en ISO 8601. |
RESPUESTA 202
La entrada en la cola. Guarda su outbox_id.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| outbox_id | string | El id de la entrada. |
| estado | string | pending si es nueva; si ya existía, el suyo de ahora. |
| idempotent_replay | boolean | true si esa referencia_interna ya estaba encolada: no se creó otra. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Contabilidad | módulo no habilitado para este espacio. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 502 | El módulo no está disponible en este momento: reintenta en unos minutos | — |
| 422 | Falta un campo obligatorio o uno no tiene su tipo (detail es una lista) | — |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Encolar no manda nada todavía: el envío ocurre al procesar la cola. Síguelo con GET push/{entrada}.
- La clave va por tipo: un pago puede llevar la misma
referencia_internaque su factura sin chocar con ella. - Las cifras se guardan exactas: mándalas como texto (
"38000.50"). También aceptan números, pero un número con decimales puede perder precisión antes de llegar.