Informaciones del Pedido de Devolución
El endpoint GetReturnOrderInfo retorna las informaciones de una orden de devolución específica en el sistema MIMS.
Cómo consultar las informaciones de Orden de Devolución
HTTP POST Request
| Tipo de Solicitud | URL Ejemplo |
|---|---|
| POST | {{url_base}}/GetReturnOrderInfo |
| Ejemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"GetReturnOrderInfo" |
Parámetros de Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ReturnOrderNo | String(25) | Sí | Código externo de orden de devolución |
| BranchNo | String(25) | Sí | Código externo de la filial |
Retorno
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sí | Informaciones estándar de respuesta del WebService en la ejecución del método |
| ReturnOrderInfo | GetReturnOrderInfoData | Sí | Objeto que contiene los datos de orden de devolución |
📝 Objeto GetReturnOrderInfoData
El objeto GetReturnOrderInfoData representa una orden de devolución.
Parámetros de Retorno
Parámetro Tipo Obligatorio Descripción ReturnOrderNo String(25) Sí Código externo de orden de devolución SalesOrderNo String(25) Sí Código externo de orden de venta BranchNo String(25) Sí Código externo de la filial ReturnOrderReasonNo String(25) Sí Código externo del motivo de devolución ReturnOrderDate DataHora Sí Fecha de orden de devolución ReturnOrderCloseDate DataHora Sí Fecha de cierre de orden de devolución ReturnOrderType ReturnOrderType Sí Enumerador con los posibles valores para Tipo de Devolución: rtPartial(Parcial),rtTotal(Total) ortLeftovers(Sobras de Carga)ReturnOrderStatus String(2) Sí Estado de orden de devolución Notes String(2000) Sí Observaciones de orden de devolución DestinationQty Integer Sí Cantidad de Cajas Destinadas ItemList GetReturnOrderItemInfoList Sí Lista de todos los items de orden de devolución
📝 Objeto GetReturnOrderItemInfoList
El objeto GetReturnOrderItemInfoList representa un item de orden de devolución.
Parámetros de Retorno
Parámetro Type Obligatorio Descripción ItemNo String(25) Sí Código externo de item de orden de devolución ProductNo String(25) Sí Código externo del producto Qty Integer Sí Cantidad de cajas programadas para devolución Weight Float Sí Peso de cajas programadas para devolución ReturnedQty Integer Sí Cantidad de cajas leídas (identificadas) ReturnedWeight Float Sí Peso de cajas leídas (identificadas) ReturnRealQty Integer Sí Cantidad real de cajas devueltas ReturnRealWeight Float Sí Peso real devuelto DispatchedQty Integer Sí Cantidad de cajas entregadas DispatchedWeight Float Sí Cantidad esperada de cajas DeliveredQty Integer Sí Cantidad entregada DeliveredWeight Float Sí Peso entregado OperationValue Float Sí Valor unitario del producto ReturnTotalValue Float Sí Valor total devuelto DispatchedTotalValue Float Sí Valor total esperado AdjustedQty Integer Sí Cantidad de cajas ajustadas AdjustedReasonNo String(25) Sí Código externo del motivo de ajuste AdjustedReasonFactor Integer Sí Factor del motivo de ajuste AdjustedReasonNotes String(2000) Sí Observaciones del motivo de ajuste ShrinkPercentage Float Sí Porcentaje de merma ShrinkTotalValue Float Sí Valor total de merma ShrinkWeight Float Sí Peso de merma
Ejemplo de Request
curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"GetReturnOrderInfo"' \
--header 'Content-Type: application/json' \
--data '{
"BranchNo": "0102",
"ReturnOrderNo": "2406145"
}'
Ejemplo de Response
{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
},
"ReturnOrderInfo": {
"ReturnOrderNo": "RET123",
"SalesOrderNo": "SO456",
"BranchNo": "BR001",
"ReturnOrderDate": "2025-02-07T14:30:00Z",
"ReturnOrderCloseDate": "2025-02-10T12:00:00Z",
"ReturnOrderReasonNo": "REAS001",
"ReturnOrderType": "rtPartial",
"ReturnOrderStatus": "T",
"Notes": "Devolución por defecto en el producto.",
"DestinationQty": 10,
"ItemList": [
{
"ItemNo": "ITEM001",
"ProductNo": "PROD001",
"Qty": 5,
"Weight": 10.0,
"ReturnedQty": 5,
"ReturnedWeight": 10.0,
"ReturnRealQty": 5,
"ReturnRealWeight": 10.0,
"DispatchedQty": 5,
"DispatchedWeight": 10.0,
"DeliveredQty": 5,
"DeliveredWeight": 10.0,
"OperationValue": 25.50,
"ReturnTotalValue": 127.50,
"DispatchedTotalValue": 127.50,
"AdjustedQty": 0,
"AdjustedReasonNo": "",
"AdjustedReasonFactor": 0,
"AdjustedReasonNotes": "",
"ShrinkPercentage": 0.0,
"ShrinkTotalValue": 0.0,
"ShrinkWeight": 0.0
}
]
}
}
🐞 Posibles Errores
| Código | Mensaje |
|---|---|
| GRO‑001 | El "ReturnOrderNo" informado ([valor enviado en la solicitud]) no existe en la filial "BranchNo" ([valor enviado en la solicitud]) informada |