Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/contabilidad/{espacio}/outbox/{entrada}/retry

Reintenta un envío

Vuelve a poner en pending una entrada que falló o quedó en dead, para que salga en el siguiente procesado. Una entrada en done no se toca.

  • 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.
entradastringSÍEl id de la entrada en la cola: el outbox_id que devolvió encolarla (32 caracteres hexadecimales).

RESPUESTA 200

La entrada, ya en pending (o tal cual, si estaba en done).

CAMPOTIPOQUÉ ES
idstringEl id de la entrada (el outbox_id).
tipo"invoice" | "payment" | "customer"Factura, pago o cliente.
referencia_internastringLa tuya.
idem_keystringtipo:referencia_interna, la clave que impide encolarla dos veces.
payload_jsonstringLo que encolaste, como texto JSON (con las cifras como texto).
estadostringVer estados.
intentos · max_intentosintegerLos intentos hechos y cuántos tiene antes de quedar en dead.
resultado_jsonstring | nullAl terminar, lo que contestó tu software, como texto JSON: external_id (su id allí), estado y raw (su respuesta entera); en facturas, además cufe, numero y pdf_url si los da.
motivo_errorstring | nullPor qué falló el último intento, con el mensaje de tu software.
next_attempt_atnumber | nullDesde cuándo se puede volver a intentar. Segundos desde 1970.
created_at · updated_atnumberSegundos desde 1970, con decimales.

ESTADOS DE UNA ENTRADA

CAMPOTIPOQUÉ ES
pendingen colaEsperando a que se procese la cola.
processingen cursoMandándose ahora mismo.
doneterminadaTu software la aceptó, una sola vez. Con csv_export: lista para el archivo.
failedse reintentaFalló y le quedan intentos: va en el siguiente procesado a partir de next_attempt_at. Sin software configurado también espera aquí, sin gastar intentos.
deadparadaAgotó los intentos y ya no se reintenta sola. Mira motivo_error y reinténtala.

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.
404No hay una entrada con ese id en la cola del espacioentrada de outbox no encontrada.
502El módulo no está disponible en este momento: reintenta en unos minutos—

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

  • No la manda: después, procesa la cola.
  • No reinicia intentos: una entrada que estaba en dead tiene un intento más y, si vuelve a fallar, vuelve a dead. Corrige antes lo que dice motivo_error.