PUT
/api/mod/facturacion/{espacio}/orders/{orden}/despachoGuarda los datos de despacho
Añade a la orden los datos para enviarla (nombre, cédula, dirección…), a medida que los tengas. Solo si el espacio activó el despacho.
- 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 |
|---|---|---|---|
| datos | { campo: valor } | SÍ | Los datos que tengas, por su campo de la configuración. Se suman a los que ya había; "" borra un campo. |
RESPUESTA 200
La orden, con despacho y despacho_status al día.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| despacho | { campo: valor } | Todos los datos guardados. |
| despacho_status.completo | boolean | true cuando están todos los requeridos. |
| despacho_status.faltantes | string[] | Los requeridos que faltan. |
| despacho_status.campos[] | { campo, etiqueta, requerido } | Los campos activos, para saber qué pedir. |
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. |
| 409 | El espacio no tiene el despacho activo (se comprueba antes que la orden) | {"mensaje": "…", "code": "despacho_inactivo"} |
| 404 | No hay una orden con ese id en el espacio | orden no encontrada. |
| 409 | La orden ya está despachada, vencida o cancelada | {"mensaje": "…", "code": "despacho_cerrado", "estado": "<estado>"} |
| 422 | Un campo que no está activo en la configuración. No se guarda nada | {"mensaje": "…", "code": "campos_desconocidos", "campos": [ … ]} |
| 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
- Aquí
detailes un objeto: decide por sucode, no por el texto demensaje. - Son datos personales. Se guardan solo en la orden; el registro de cambios apunta qué campos tocaste, nunca sus valores.