POST
/api/mod/contabilidad/{espacio}/outbox/processProcesa la cola
Manda a tu software lo que está en la cola y ya toca: lo nuevo y los fallos cuyo next_attempt_at ya pasó. Las va mandando una a una y responde con el resumen. Nunca falla por una entrada: cada una queda con su estado.
- 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. |
| limit | int, query | no | Cuántas entradas como mucho, las más antiguas primero. Por defecto 50. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| claimed | integer | Las que tomó. |
| done | integer | Las que tu software aceptó. |
| failed | integer | Las que fallaron y se reintentarán. |
| dead | integer | Las que agotaron sus intentos. |
| deferred | integer | Solo si no hay software configurado: las que esperan sin gastar intentos (quedan en failed). |
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 | — |
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
- En el Estudio es el botón «Procesar cola ahora» del panel de Contabilidad. Llamarla seguido no duplica nada: cada entrada se manda una sola vez.