Devolución Directa

---

Registro de Devolución Directa

El endpoint PostAddDirectReturn es responsable de registrar una nueva devolución directa de producto en el sistema MIMS y puede ser visualizada a través de la pantalla EXP005.

---

Cómo registrar una devolución directa de producto

HTTP POST Request

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostAddDirectReturn
Ejemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddDirectReturn"

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
DirectReturnNo	String(25)	Sí	Código de devolución directa en ERP
BranchNo	String(25)	Sí	Código externo de la filial
DirectReturnDate	DataHora	Sí	Fecha de devolución directa
DirectReturnReasonNo	String(25)	No	Código externo del motivo de devolución
WarehouseNo	String(25)	No	Código externo del almacén de devolución directa
OverwriteIfExists	Boolean	No	Flag que indica que los datos deben ser sobrescritos si el registro ya existe

---

Retorno

Parámetro	Tipo	Obligatorio	Descripción
WebServiceReturn	WebServiceReturn	Sí	Informaciones estándar de respuesta del WebService en la ejecución del método
DirectReturnCode	Integer	Sí	Código interno de devolución directa generado en el sistema MIMS

---

Ejemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddDirectReturn"' \
--header 'Content-Type: application/json' \
--data '{
    "DirectReturnNo": "DR98765",
    "BranchNo": "101",
    "DirectReturnDate": "2025-03-10T14:30:00Z",
    "DirectReturnReasonNo": "R002",
    "WarehouseNo": "WH05",
    "OverwriteIfExists": true
}'

---

Ejemplo de Response

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

---

🐞 Posibles Errores

Código	Mensaje
ADR‑001	El parámetro Código Externo de Devolución Directa (DirectReturnNo) informado ya existe!
ADR‑002	El estado actual de la Orden de Devolución Directa ("[estado de la orden de devolución]") no permite cambios. Operación no permitida!
ADR‑003	La Devolución Directa informada ya tiene lecturas. Modificación de almacén no permitida!

Exclusión de Devolución Directa

El endpoint PostDeleteDirectReturn es responsable de ejecutar la exclusión de una devolución directa de producto en el sistema MIMS y puede ser visualizada a través de EXP026.

---

Cómo excluir una devolución directa de producto

HTTP POST Request

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostDeleteDirectReturn
Ejemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeleteDirectReturn"

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
DirectReturnNo	String(25)	Sí	Código de devolución directa en ERP
ErrorIfNotFound	Boolean	No	Retorna error si la devolución informada no existe en la base de datos

---

Retorno

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

---

Ejemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeleteDirectReturn"' \
--header 'Content-Type: application/json' \
--data '{
    "DirectReturnNo": "DR98765",
    "ErrorIfNotFound": false
}'

---

Ejemplo de Response

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

---

🐞 Posibles Errores

Código	Mensaje
DDR‑001	El estado actual de la Devolución Directa informada ("[estado de devolución directa]") no permite exclusión!

---