GET/api/mod/facturacion/{espacio}/orders/{orden}

Una orden

La orden con su estado, sus líneas, su total, las cuentas donde pagar y qué datos de despacho faltan.

PERMISOlee (vale cualquier clave)
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).

RESPUESTA 200

CAMPO	TIPO	QUÉ ES
id · estado	string	El id de la orden y su estado: ver estados.
session_ref · lead_ref	string \| null	Tus referencias de la conversación y del cliente, las que mandaste al crearla.
lineas[]	{ variant_id, sku, nombre, cantidad, precio_unitario, total_linea, adjustments }	Cada línea con el precio que dio Productos al crearla. No cambia aunque el precio cambie después.
lineas[].adjustments	[{ promotion_id, regla, target, monto }]	Las promociones de Productos que rebajaron la línea. monto va en negativo. Vacío si ninguna.
subtotal · descuento_total	string	La suma de las líneas antes de promociones, y todos los descuentos: los de Productos más el descuento que mandaste.
envio	string	El envío que mandaste al crearla. 0 si no mandaste.
total	string	Lo que el cliente paga: el total de productos de Productos, menos tu descuento, más el envío.
moneda	string	Por defecto COP.
catalog_version · tarifa_version	string \| null	La versión de precios de Productos con la que se cotizó, y la de la tarifa de Comercial que mandaste.
reservation_refs	string[]	Las reservas de stock en Productos. Vacío si reservar_stock está apagado.
despacho	object \| null	Los datos de despacho guardados (campo → valor). Datos personales.
creado_at · actualizado_at	number	Segundos desde 1970, con decimales.
expira_at	number \| null	Hasta cuándo puede pagarse, en segundos desde 1970.
cuentas[]	{ metodo, etiqueta, numero, titular }	Las cuentas activas del espacio, para decirle al cliente dónde pagar. Salen de la configuración.
despacho_status	{ activo, completo, faltantes, campos }	Qué datos de despacho faltan. Con el despacho apagado: `activo: false` y `completo: true`.

ESTADOS DE UNA ORDEN

CAMPO	TIPO	QUÉ ES
pending_payment	esperando pago	Creada, con su total. Espera el pago hasta expira_at.
under_review	esperando revisión	Llegó un comprobante: espera que alguien lo apruebe o lo rechace.
rejected	esperando pago	Se rechazó el comprobante. Admite otro; el stock sigue reservado.
paid	pagada	Pago aprobado y venta confirmada en Productos. Lista para despachar.
fulfilled	terminada	Despachada.
expired	terminada	Venció sin pago (al llamar a vencer órdenes). Su stock se liberó.
cancelled	terminada	Cancelada. Su stock se liberó.

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.
404	No hay una orden con ese id en el espacio	orden no encontrada.

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

Quién movió la orden a cada estado, y por qué, en su historia.
Son datos personales del cliente: guárdalos solo donde los necesites y no los copies a registros ni a herramientas de terceros.