Devolução Direta

---

Cadastro de Devolução Direta

O endpoint PostAddDirectReturn é responsável por cadastrar uma nova devolução direta de produtos no sistema MIMS e pode ser visualizado através da tela EXP005.

---

Como cadastrar uma devolução direta de produtos

Request HTTP Post

Tipo da Requisição	URL Exemplo
POST	{{url_base}}/PostAddDirectReturn
Exemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddDirectReturn"

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
DirectReturnNo	String(25)	Sim	Código da devolução direta no ERP
BranchNo	String(25)	Sim	Código externo da filial
DirectReturnDate	DataHora	Sim	Data da devolução direta
DirectReturnReasonNo	String(25)	Não	Código externo do motivo da devolução
WarehouseNo	String(25)	Não	Código externo do almoxarifado da devolução direta
OverwriteIfExists	Boolean	Não	Flag que indica que os dados devem ser sobrescritos caso o registro já exista

---

Retorno

Parâmetro	Tipo	Obrigatório	Descrição
WebServiceReturn	WebServiceReturn	Sim	Informações padrão de resposta do WebService na execução do método
DirectReturnCode	Integer	Sim	Código interno da devolução direta gerada no sistema MIMS

---

Exemplo 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
}'

---

Exemplo de Response

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

---

🐞 Possíveis Erros

Código	Mensagem
ADR‑001	Parâmetro Código Externo da Devolução Direta (DirectReturnNo) informado já existe!
ADR‑002	O status atual do Pedido de Devolução Direta ("[status do pedido de devolução]") não permite alterações. Operação não permitida!
ADR‑003	A Devolução Direta informada já possui leituras. Modificação do almoxarifado não permitida!

Exclusão de Devolução Direta

O endpoint PostDeleteDirectReturn é responsável por executar a exclusão de uma devolução direta de produtos no sistema MIMS e pode ser visualizado através da EXP026.

---

Como excluir uma devolução direta de produtos

Request HTTP Post

Tipo da Requisição	URL Exemplo
POST	{{url_base}}/PostDeleteDirectReturn
Exemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeleteDirectReturn"

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
DirectReturnNo	String(25)	Sim	Código da devolução direta no ERP
ErrorIfNotFound	Boolean	Não	Retorna erro caso a devolução informada não exista no banco de dados

---

Retorno

Parâmetro	Tipo	Obrigatório	Descrição
WebServiceReturn	WebServiceReturn	Sim	Informações padrão de resposta do WebService na execução do método

---

Exemplo de Request

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

---

Exemplo de Response

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

---

🐞 Possíveis Erros

Código	Mensagem
DDR‑001	O status atual da Devolução Direta ("[status da devolução direta]") informada não permite exclusão!

---