Crear una nueva orden
POST/api/orders
Crea una orden de envío, genera la guía de despacho y descuenta el costo del saldo prepago.
Antes de crear la orden, obtén estos IDs:
| Campo de la orden | De dónde sale | Campo de la respuesta |
|---|---|---|
branchInfo.branchAddressId (dirección de recolecta) | GET /api/branchs/branchsAddresses, o el que devuelve POST /api/branchs/branchsAddresses al crearla | branchAddressId |
branchInfo.branchsClientId (cliente y dirección de entrega) | GET /api/branchs/branchsClient o GET /api/branchs/branchsClient/search, o el que devuelve POST /api/branchs/branchsClient al registrarlo | branchsClientId |
courier.courierServiceId (mensajería y servicio) | POST /api/courier (cotizar), enviando la dirección de recolecta y el municipio del cliente | courierServiceId |
courier.agencias (opcional) | GET /api/courier/agencies, solo si la mensajería trabaja con agencias | ID de la agencia |
La dirección de entrega no se envía aparte: es la que tiene registrada el cliente.
La validación se hace por secciones (branchInfo, courier, location, product, order) y se informa el primer error encontrado.
Petición
Respuestas
- 201
- 400
- 401
- 409
- 422
- 500
Orden creada correctamente
Datos de la solicitud inválidos
Falta el token, venció (dura 15 minutos) o no es válido. Repite el login para obtener uno nuevo.
Regla de negocio (monto insuficiente, dirección que no pertenece al comercio, saldo)
La mensajería no pudo generar el comprobante de la guía. Intenta nuevamente o elige otro servicio en la cotización.
Error interno al crear la orden. El mensaje puede variar e incluir el detalle del error.