Pedido de Devolución

Descripción

Inclusión de un nuevo pedido de devolución en el sistema MIMS y puede ser consultado a través de la EXP027.

Proceso Completo para ejecución de este método consiste en la secuencia abajo:

AddSalerOrder (Crear un pedido de venta)

AddLoad (Crear una carga, vincular ese pedido de venta creado)

AddReturnOrder (Crear un pedido de devolución)

AddReturnOrderLoad(Crear una carga de devolución, vincular ese pedido de devolución creado)

---

Request HTTP Post

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostAddReturnOrder
Ejemplo	http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/PostAddReturnOrder

---

Parámetros de Entrada

Nombre	Tipo	Obligatorio	Comentarios
ReturnOrderNo	String(25)	Sí	Código externo del pedido de devolución
SalesOrderNo	String(25)	Sí	Código externo del pedido de venta asociado
BranchNo	String(25)	Sí	Código externo de la sucursal
ReturnOrderDate	DataHora	Sí	Fecha del pedido de devolución
RegisterDate	DataHora	Sí	Fecha de digitación del pedido de devolución
ReturnOrderReasonNo	String(25)	No	Código externo del motivo de la devolución
ReturnOrderType	ReturnOrderType	Sí	Tipo de la devolución: P = rtPartial (Parcial), T = rtTotal (Total)
Notes	String(2000)	No	Observaciones del pedido de devolución
ItemList	AddReturnOrderItemList	Sí	Lista de elementos del pedido de devolución

---

Retorno

Nombre	Tipo	Obligatorio	Comentarios
WebServiceReturn	WebServiceReturn	Sí	Información estándar de respuesta del webservice
ReturnOrderCode	Integer	Sí	Código interno del pedido de devolución generado en el MIMS

---

Objeto: AddReturnOrderItemList

Descripción: Representa un elemento del pedido de devolución.

Propiedades

Nombre	Tipo	Obligatorio	Comentarios
ItemNo	String(25)	No	Código externo del elemento del pedido de devolución
SalesOrderItemNo	String(25)	No	Código externo del elemento del pedido de venta
ProductNo	String(25)	Sí	Código externo del producto
UnitValue	Float	No	Valor unitario
Qty	Integer	No	Cantidad de cajas devueltas
Weight	Float	No	Peso devuelto
TotalValue	Float	No	Valor total

---

Ejemplo de Request

POST http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/PostAddReturnOrder
Content-Type: application/json

{
  "ReturnOrderNo": "RET123",
  "SalesOrderNo": "SO456",
  "BranchNo": "BR001",
  "ReturnOrderDate": "2025-02-07T14:30:00Z",
  "RegisterDate": "2025-02-07T15:00:00Z",
  "ReturnOrderReasonNo": "REAS001",
  "ReturnOrderType": "rtPartial",
  "Notes": "Devolución por defecto en el producto.",
  "ItemList": [
    {
      "ProductNo": "PROD001",
      "UnitValue": 25.50,
      "Qty": 5,
      "Weight": 10.0,
      "TotalValue": 127.50
    }
  ]
}

---

Ejemplo de Response

{
  WebServiceReturn: {
    Success: true,
    Message: "Pedido de devolución creado con éxito."
  },
  ReturnOrderCode: 789
}

---

Notas de Desarrollo

• Asegúrese de que ReturnOrderDate y RegisterDate estén en formato ISO 8601 (ej.: 2025-02-07T14:30:00Z).
• El campo ReturnOrderType acepta apenas rtPartial (parcial) o rtTotal (total). Use el valor correcto conforme el tipo de devolución.
• Si ItemList contiene elementos con SalesOrderItemNo, asegúrese de que estén asociados al SalesOrderNo informado.

---

Eliminación Pedido de Devolución

Descripción

Este endpoint ejecuta la eliminación de un pedido de devolución en el sistema MIMS.

---

Request HTTP Post

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostDeleteReturnOrder
Ejemplo	http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/PostDeleteReturnOrder

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
ReturnOrderNo	String(25)	Sí	Código Externo del Pedido de Devolución. Ejemplo: "RET98765"
ErrorIfNotFound	Boolean	No	Devuelve error en caso de que el pedido informado no exista en la base de datos. Ejemplo: true

---

Retorno

Parámetro	Tipo	Obligatorio	Descripción
WebServiceReturn	WebServiceReturn	Sí	Información estándar de respuesta del Webservice en la ejecución del método.

---

Ejemplo de Request

curl --location --request POST '{{url_base}}/PostDeleteReturnOrder' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "ReturnOrderNo": "RET98765",
    "ErrorIfNotFound": true
}'

---

Ejemplo de Response

{
    "WebServiceReturn": {
        "Status": "wrsSuccess",
        "ErrorCode": "",
        "Message": "",
        "Actor": "",
        "ReturnQuestion": null
    }
}