Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/contabilidad/{espacio}/push/payment

Encola un pago

Deja un pago recibido en la cola para registrarlo en tu software contable.

  • PERMISOescribe
  • CRÉDITOSno gasta
  • AUTENTICACIÓNBearer bth_…

PARÁMETROS

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Contabilidad.

CUERPO · JSON

CAMPOTIPOREQUERIDOQUÉ ES
referencia_internastringSÍTu id del pago o de la venta. Impide registrarlo dos veces.
factura_external_idstringnoEl id de la factura en tu software (su external_id, en el resultado de la factura). Si va, el pago se asocia a ella.
montocifraSÍLo que se pagó.
metodostringSÍCómo se pagó, con el nombre que use tu software (transfer, cash…).
fechastringSÍCuándo, en ISO 8601.

RESPUESTA 202

La entrada en la cola. Guarda su outbox_id.

CAMPOTIPOQUÉ ES
outbox_idstringEl id de la entrada.
estadostringpending si es nueva; si ya existía, el suyo de ahora.
idempotent_replaybooleantrue si esa referencia_interna ya estaba encolada: no se creó otra.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Contabilidadmódulo no habilitado para este espacio.
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.
502El módulo no está disponible en este momento: reintenta en unos minutos—
422Falta 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_interna que 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.