Entrada de Materiais

O endpoint PostAddMaterialReceiving é responsável pelo cadastro de uma nova entrada de materiais no sistema MIMS e pode ser consultada na PRO202.

---

Request HTTP Post

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

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
ReceivingNo	String(25)	Sim	Código do pedido no ERP
BranchNo	String(25)	Sim	Código externo da filial
ReceivingDate	DataHora	Sim	Data da entrada de materiais
SupplierNo	String(25)	Sim	Código externo do fornecedor
DocumentNo	String(20)	Sim	Número do documento da entrada
DocumentTypeNo	String(5)	Não	Sigla do tipo de documento da entrada de materiais
PurchaseOrderNo	String(10)	Não	Código do pedido de compra no ERP
Notes	String(2000)	Não	Observações do pedido
ItemList	AddMaterialReceivingItemList	Sim	Lista de itens da entrada de materiais

📝 Objeto AddMaterialReceivingItemList

O objeto AddMaterialReceivingItemList representa a lista de itens da entrada de materiais.

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
MaterialNo	String(25)	Sim	Código externo do material
WarehouseNo	String(25)	Não	Código externo do almoxarifado do material da entrada
CostCenterNo	String(25)	Não	Código externo do centro de custo do material
Qty	Float	Sim	Quantidade de material
UnitValue	Float	Sim	Valor unitário do material
DiscountValue	Float	Não	Valor de desconto do material
SupplierLotNo	String(50)	Não	Lote do fornecedor do material
LotNo	String(50)	Não	Lote do material

---

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
ReceivingCode	Integer	Sim	Código interno da entrada de materiais gerado no sistema MIMS

---

Exemplo de Request

curl --location --request POST 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddMaterialReceiving"' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
  "ReceivingNo": "REC002",
  "BranchNo": "101",
  "ReceivingDate": "2025-02-07T14:30:00Z",
  "SupplierNo": "F12345",
  "DocumentNo": "DOC987654",
  "DocumentTypeNo": "NF",
  "PurchaseOrderNo": "PO456789",
  "Notes": "Entrada de materiais para reposição.",
  "ItemList": [
    {
      "MaterialNo": "1076",
      "WarehouseNo": "1000101",
      "CostCenterNo": "",
      "Qty": 10,
      "UnitValue": 15.50,
      "DiscountValue": 1.50,
      "SupplierLotNo": "SL20250207",
      "LotNo": "L20250207"
    }
  ]
}'

---

Exemplo de Response

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

---

🐞 Possíveis Erros

Código	Mensagem
AMR‑001	Parâmetro Código Externo da Entrada de Materiais (ReceivingNo) informado já existe!
AMR‑002	Parâmetro Código Externo do Fornecedor (SupplierNo) pertence a um fornecedor que não é do tipo "Fornecedor". Operação não permitida!
AMR‑003	Material "[valor enviado na requisição]" informado no índice [[código do índice]] não possui Almoxarifado padrão. Operação não permitida!
AMR‑004	Material "[valor enviado na requisição]" informado no índice [[código do índice]] controla Número de Lote do Fornecedor e o parâmetro de Lote do Fornecedor (SupplierLotNo) não foi informado. Operação não permitida!
AMR‑005	Material "[valor enviado na requisição]" informado no índice [[código do índice]] controla Número de Lote e o parâmetro de Lote (LotNo) não foi informado. Operação não permitida!
AMR‑006	Operação de movimentação do Material não configurada no banco de dados. Operação não permitida!

---