Informações de um Pedido de Devolução

Descrição

Este endpoint obtém as informações de um determinado pedido de devolução no sistema MIMS. Ele retorna detalhes completos sobre o pedido, incluindo código, filial, datas, motivo, status, tipo, notas, quantidade de itens e informações detalhadas sobre cada item devolvido.

---

Request HTTP GET

Tipo da Requisição	URL Exemplo
GET	{{url_base}}/GetReturnOrderInfo
Exemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/GetReturnOrderInfo

---

Parâmetros de Entrada

Nome	Tipo	Obrigatório	Comentários
ReturnOrderNo	String(25)	Sim	Código Externo do Pedido Devolução
BranchNo	String(25)	Sim	Código Externo da Filial

---

Retorno

Nome	Tipo	Obrigatório	Comentários
WebServiceReturn	WebServiceReturn	Sim	Informações padrão de resposta do webservice
ReturnOrderInfo	GetReturnOrderInfoData	Sim	Objeto contendo os dados do pedido de devolução

---

Objeto: GetReturnOrderInfoData

Descrição: Representa um pedido de devolução completo no sistema MIMS.

Propriedades

Nome	Tipo	Obrigatório	Comentários
ReturnOrderNo	String(25)	Sim	Código Externo do Pedido Devolução
SalesOrderNo	String(25)	Sim	Código Externo do Pedido de Venda
BranchNo	String(25)	Sim	Código Externo da Filial
ReturnOrderDate	DataHora	Sim	Data do pedido de devolução
ReturnOrderCloseDate	DataHora	Sim	Data de fechamento do pedido de devolução
ReturnOrderReasonNo	String(25)	Sim	Código Externo do Motivo da Devolução
ReturnOrderType	ReturnOrderType	Sim	Tipo da devolução: P = rtPartial (Parcial), T = rtTotal (Total)
ReturnOrderStatus	String(2)	Sim	Status do pedido de devolução
Notes	String(2000)	Sim	Observações do pedido de devolução
DestinationQty	Integer	Sim	Quantidade de Caixas Destinadas
ItemList	GetReturnOrderItemInfoList	Sim	Lista de todos os itens dos pedidos de devolução

---

Objeto: GetReturnOrderItemInfoList

Descrição: Representa um item do pedido de devolução, contendo informações detalhadas sobre quantidade, peso, valor e ajustes.

Propriedades

Nome	Tipo	Obrigatório	Comentários
ItemNo	String(25)	Sim	Código Externo do Item do Pedido Devolução
ProductNo	String(25)	Sim	Código Externo do Produto
Qty	Integer	Sim	Quantidade de caixas programadas para devolução
Weight	Float	Sim	Peso devolvido das caixas programadas
ReturnedQty	Integer	Sim	Quantidade de caixas lidas (identificadas)
ReturnedWeight	Float	Sim	Peso de caixas lidas (identificadas)
ReturnRealQty	Integer	Sim	Quantidade Real de Caixas Devolvidas
ReturnRealWeight	Float	Sim	Peso Real Devolvido
DispatchedQty	Integer	Sim	Quantidade de Caixas Entregues
DispatchedWeight	Float	Sim	Quantidade de Caixas Esperadas
DeliveredQty	Integer	Sim	Quantidade Entregue
DeliveredWeight	Float	Sim	Peso Entregue
OperationValue	Float	Sim	Valor Unitário do Produto
ReturnTotalValue	Float	Sim	Valor Total Devolvido
DispatchedTotalValue	Float	Sim	Valor Total Esperado
AdjustedQty	Integer	Sim	Quantidade de caixas ajustadas
AdjustedReasonNo	String(25)	Sim	Código Externo do Motivo do Ajuste
AdjustedReasonFactor	Integer	Sim	Fator do Motivo do Ajuste
AdjustedReasonNotes	String(2000)	Sim	Observações do Motivo do Ajuste
ShrinkPercentage	Float	Sim	Percentual de Quebra
ShrinkTotalValue	Float	Sim	Valor Total da Quebra
ShrinkWeight	Float	Sim	Peso da Quebra

---

Exemplo de Request

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

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

---

Exemplo de Response

{
  "WebServiceReturn": {
    "Success": true,
    "Message": "Informações do pedido de devolução obtidas com sucesso."
  },
  "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": "Devolução por defeito no produto.",
    "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 Dev

• Certifique-se de que ReturnOrderNo e BranchNo sejam válidos e existentes no sistema MIMS.
• Os campos de data, como ReturnOrderDate e ReturnOrderCloseDate, são retornados no formato ISO 8601 (ex.: 2025-02-07T14:30:00Z).
• O campo ReturnOrderType pode ser rtPartial (parcial) ou rtTotal (total), conforme o tipo de devolução.
• O campo ReturnOrderStatus indica o status atual do pedido (ex.: "T" para terminado).

---