BRIDGE API - REST - Devolución de un Pedido
CONTENIDO
Este servicio permitirá solicitar la devolución sin referencia de un pedido, desde una fuente externa.
- Se invoca de la siguiente manera: https://[direccion_ip]:[puerto]/order/returnBill - Ejemplo: https://200.100.100.100:8090/order/returnBill
- Se invoca vía POST.
Tener en cuenta:
- Primero se debe invocar al servicio de autenticación para obtener un token.
- Cuando se llama a cualquier servicio este token se envía como un parámetro más de la llamada en el header (x-access-token).
- Si al llamar al servicio el token expiró, se recibirá respuesta de token inválido y se deberá volver a pedir uno nuevo.
JSON ejemplo
{
"internalNumber":"bridge0000000179",
"manualDiscountAmount":10,
"detail":[
{
"itemCode":"SPRITE354",
"description":"SPRITE",
"storeCode":"1",
"locationCode":"DEP1",
"unitPrice":100,
"orderedQty":2,
"priceModifiers":[
{
"amount":20,
"reasonText":"Cupón de regalo"
}
]
}
]
}
Descripción de los campos:
Importante: los campos que poseen este ícono 
, son valores tipificados que deben respetar los valores expuestos por BRIDGE en sus servicios.
| Campo | Tipo | Descripción | Requerido | Ejemplos | Validación (código) |
|---|---|---|---|---|---|
| internalNumber | String | Código de la orden interna asignado por BRIDGE. Este código se retorna al momento de la creación de la orden. | SI | "bridge0000000182" | 991: el código de orden es requerido. |
| manualDiscountAmount | Number | Monto de descuento al total de la transacción | NO | 10.0 | |
| detail [ ] | Lista | Lista de artículos del pedido a devolver | SI | ||
| Por cada ítem tendrá la siguiente información: | |||||
| itemCode | String | SKU del artículo | SI | "111" ver servicio item/all o /item/[código] | |
| barcode | String | Código de barras del artículo | NO | "77987845213" | |
| description | String | Descripción del artículo | SI | "Combo vitamina c textura ligera" | Si viene informado se toma ese valor, sino el del maestro |
| storeCode | String | Código de la tienda del pedido | SI | "10" | 1012: el código de tienda del stock es requerido. |
| locationCode | String | Código del depósito del artículo | NO | "DEP1" | Si no se informa, toma el default del ítem. |
| unitPrice | Number | Precio unitario | SI | 12.00 | 1015: el precio unitario es requerido. |
| orderedQty | Number | Cantidad a devolver | SI | 1 | 1014: la cantidad pedida es obligatoria. |
| priceModifiers [ ] | Lista de descuentos del artículo | NO | |||
| Por cada descuento (priceModifiers) | |||||
| amount | Number | Monto de descuento del artículo | SI | 1.0 | |
| reasonText | String | Razón del descuento | SI | "Oferta del día" | |
Respuesta del servicio:
{
"ack":0,
"message":"Se crea la tarea de devolución de factura para la orden: bridge0000000182"
}
- ack es el código de respuesta, en caso de ser un error, mirar tabla a continuación.
- message: descripción del error en caso de existir.
| Código de Error | Descripción |
|---|---|
| 0 | La operación se ha ejecutado con éxito. |
| 9999 | Error desconocido |