Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/facturacion/{espacio}/orders/{orden}/fulfill

Marca 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

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Facturación.
ordenstringSÍEl id de la orden: el que devolvió crearla (32 caracteres hexadecimales).

CUERPO · JSON

CAMPOTIPOREQUERIDOQUÉ ES
actorstringnoQuién la despacha. Por defecto "operador".
motivostringnoUna nota: la guía de envío, la transportadora…

RESPUESTA 200

La orden, en fulfilled, con los campos de GET orders/{orden}.

CAMPOTIPOQUÉ ES
estado"fulfilled"Despachada.

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

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Facturaciónmódulo no habilitado para este espacio.
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.
404No hay una orden con ese id en el espacioorden no encontrada.
409Faltan datos de despacho requeridos{"mensaje": "faltan datos de despacho requeridos para despachar.", "code": "despacho_incompleto", "faltantes": [ … ]}
409La orden no está pagadatransición ilegal: <de> → fulfilled
422Falta 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 {}.