Información de un Pedido de Devolución

Descripción

Este endpoint obtiene la información de un determinado pedido de devolución en el sistema MIMS. Devuelve detalles completos sobre el pedido, incluyendo código, sucursal, fechas, motivo, status, tipo, notas, cantidad de elementos e información detallada sobre cada elemento devuelto.

---

Request HTTP GET

Tipo de Solicitud	URL Ejemplo
GET	{{url_base}}/GetReturnOrderInfo
Ejemplo	http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/GetReturnOrderInfo

---

Parámetros de Entrada

Nombre	Tipo	Obligatorio	Comentarios
ReturnOrderNo	String(25)	Sí	Código Externo del Pedido Devolución
BranchNo	String(25)	Sí	Código Externo de la Sucursal

---

Retorno

Nombre	Tipo	Obligatorio	Comentarios
WebServiceReturn	WebServiceReturn	Sí	Información estándar de respuesta del webservice
ReturnOrderInfo	GetReturnOrderInfoData	Sí	Objeto conteniendo los datos del pedido de devolución

---

Objeto: GetReturnOrderInfoData

Descripción: Representa un pedido de devolución completo en el sistema MIMS.

Propiedades

Nombre	Tipo	Obligatorio	Comentarios
ReturnOrderNo	String(25)	Sí	Código Externo del Pedido Devolución
SalesOrderNo	String(25)	Sí	Código Externo del Pedido de Venta
BranchNo	String(25)	Sí	Código Externo de la Sucursal
ReturnOrderDate	DataHora	Sí	Fecha del pedido de devolución
ReturnOrderCloseDate	DataHora	Sí	Fecha de cierre del pedido de devolución
ReturnOrderReasonNo	String(25)	Sí	Código Externo del Motivo de la Devolución
ReturnOrderType	ReturnOrderType	Sí	Tipo de la devolución: P = rtPartial (Parcial), T = rtTotal (Total)
ReturnOrderStatus	String(2)	Sí	Status del pedido de devolución
Notes	String(2000)	Sí	Observaciones del pedido de devolución
DestinationQty	Integer	Sí	Cantidad de Cajas Destinadas
ItemList	GetReturnOrderItemInfoList	Sí	Lista de todos los elementos de los pedidos de devolución

---

Objeto: GetReturnOrderItemInfoList

Descripción: Representa un elemento del pedido de devolución, conteniendo información detallada sobre cantidad, peso, valor y ajustes.

Propiedades

Nombre	Tipo	Obligatorio	Comentarios
ItemNo	String(25)	Sí	Código Externo del Elemento del Pedido 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 devuelto de las cajas programadas
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 de Cajas Esperadas
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 del Ajuste
AdjustedReasonFactor	Integer	Sí	Factor del Motivo del Ajuste
AdjustedReasonNotes	String(2000)	Sí	Observaciones del Motivo del Ajuste
ShrinkPercentage	Float	Sí	Porcentaje de Merma
ShrinkTotalValue	Float	Sí	Valor Total de la Merma
ShrinkWeight	Float	Sí	Peso de la Merma

---

Ejemplo de Request

GET http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/GetReturnOrderInfo
Content-Type: application/json

{
  "ReturnOrderNo": "RET123",
  "BranchNo": "BR001"
}

---

Ejemplo de Response

{
  "WebServiceReturn": {
    "Success": true,
    "Message": "Información del pedido de devolución obtenida con éxito."
  },
  "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
      }
    ]
  }
}

---

Notas de Desarrollo

• Asegúrese de que ReturnOrderNo y BranchNo sean válidos y existentes en el sistema MIMS.
• Los campos de fecha, como ReturnOrderDate y ReturnOrderCloseDate, son devueltos en formato ISO 8601 (ej.: 2025-02-07T14:30:00Z).
• El campo ReturnOrderType puede ser rtPartial (parcial) o rtTotal (total), conforme el tipo de devolución.
• El campo ReturnOrderStatus indica el status actual del pedido (ej.: "T" para terminado).

---