POST
/api/mod/facturacion/{espacio}/orders/{orden}/fulfillMarca una orden despachada
Cierra una orden pagada: pasa de paid a fulfilled. Si el despacho está activo y lo exige, antes tienen que estar todos sus datos requeridos.
- 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 Facturación. |
| orden | string | SÍ | El id de la orden: el que devolvió crearla (32 caracteres hexadecimales). |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| actor | string | no | Quién la despacha. Por defecto "operador". |
| motivo | string | no | Una nota: la guía de envío, la transportadora… |
RESPUESTA 200
La orden, en fulfilled, con los campos de GET orders/{orden}.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| estado | "fulfilled" | Despachada. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Facturación | módulo no habilitado para este espacio. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 404 | No hay una orden con ese id en el espacio | orden no encontrada. |
| 409 | Faltan datos de despacho requeridos | {"mensaje": "faltan datos de despacho requeridos para despachar.", "code": "despacho_incompleto", "faltantes": [ … ]} |
| 409 | La orden no está pagada | transición ilegal: <de> → fulfilled |
| 422 | Falta un campo obligatorio o uno no es de 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
- El cuerpo es obligatorio aunque sus campos no: manda al menos
{}.