Cadastro de uma Nova Carga de Entrada de Produto

Descrição

Este endpoint cadastra uma nova carga de entrada de produtos de terceiros no sistema MIMS. Ele registra informações como código da carga, filial, data, placa do veículo, modo de carga, transportador, usuário criador e detalhes dos produtos da entrada.

---

Request HTTP Post

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

---

Parâmetros de Entrada

Nome	Tipo	Obrigatório	Descrição
BranchNo	String(25)	Sim	Código externo na filial
LoadNo	String(25)	Sim	Código externo da carga
LoadDate	DataHora	Sim	Data da carga
VehiclePlateNo	String(8)	Sim	Placa do veículo
LoadMode	LoadMode	Sim	Modo de carregamento: ImPurchase (Compra), ImTransfer (Transferência)
TransporterNo	String(25)	Sim	Código externo do transportador
DriverNo	String(25)	Sim	Código externo do motorista da carga
LoadCreatedUserNo	String(25)	Sim	Código externo do usuário da criação da carga
Notes	String(25)	Não	Observações
ProductEntranceList	AddProductEntrance	Sim	Lista com as entradas de produtos da carga

---

Retorno

Nome	Tipo	Obrigatório	Descrição
WebServiceReturn	WebServiceReturn	Sim	Informações padrão de resposta do WebService na execução do método
LoadProductEntranceCode	Integer	Sim	Código interno da carga de entrada de produtos gerado no sistema MIMS

---

Objeto: AddProductEntrance

Descrição: Objeto que representa uma entrada de produtos na carga.

Parâmetros de Entrada

Nome	Tipo	Obrigatório	Descrição
PurchaseOrderNo	String(10)	Sim	Código do pedido de compra no ERP
PurchaseOrderDate	DataHora	Sim	Data/hora da entrada da compra no ERP
SupplierNo	String(25)	Sim	Código externo do fornecedor
SupplierTypeNo	String(25)	Não	Código externo do tipo de fornecedor
DocumentNo	String(25)	Não	Código dos tipos de documento
DocumentType	DocumentType	Não	Tipo de documento
DocumentDate	DataHora	Não	Data/hora da emissão do documento
Notes	String(25)	Não	Observações
ProductEntranceItemList	AddProductEntranceItem	Sim	Lista com os produtos da entrada

---

Objeto: AddProductEntranceItem

Descrição: Objeto que representa um item da entrada de produtos.

Propriedades

Nome	Tipo	Obrigatório	Descrição
ProductNo	String(25)	Sim	Código externo do produto da entrada
WarehouseNo	String(25)	Sim	Código externo do almoxarifado do material da entrada
SupplierNo	String(25)	Sim	Código externo do fornecedor
CostCenterNo	String(25)	Não	Código externo do centro de custo do material
Qty	Float	Sim	Quantidade de caixas
Weight	Float	Sim	Peso unitário da caixa
ProductionDate	DataHora	Não	Data/hora de fabricação
ExpirationDate	DataHora	Não	Data de validade
SupplierLotNo	String(50)	Sim	Lote do fornecedor do produto
UnitValue	Float	Sim	Valor unitário do produto
DiscountValue	Float	Não	Valor de desconto do produto

---

Exemplo de Request

POST http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/PostAddProductEntrance
Content-Type: application/json

{
  "BranchNo": "BR001",
  "LoadNo": "LOAD123",
  "LoadDate": "2025-02-20T12:00:00Z",
  "VehiclePlateNo": "ABC1234",
  "LoadMode": "ImPurchase",
  "TransporterNo": "TRANS001",
  "DriverNo": "DRV001",
  "LoadCreatedUserNo": "USER001",
  "Notes": "Carga de produtos terceirizados",
  "ProductEntranceList": {
    "PurchaseOrderNo": "PO123",
    "PurchaseOrderDate": "2025-02-20T10:00:00Z",
    "SupplierNo": "SUP001",
    "SupplierTypeNo": "ST001",
    "DocumentNo": "DOC123",
    "DocumentType": "Invoice",
    "DocumentDate": "2025-02-20T11:00:00Z",
    "Notes": "Entrada de produtos frescos",
    "ProductEntranceItemList": [
      {
        "ProductNo": "PROD001",
        "WarehouseNo": "WH001",
        "SupplierNo": "SUP001",
        "CostCenterNo": "CC001",
        "Qty": 100.0,
        "Weight": 15.0,
        "ProductionDate": "2025-02-20T09:00:00Z",
        "ExpirationDate": "2025-08-20T23:59:59Z",
        "SupplierLotNo": "LOT001",
        "UnitValue": 25.50,
        "DiscountValue": 2.50
      }
    ]
  }
}

---

Exemplo de Response

{
  "WebServiceReturn": {
    "Success": true,
    "Message": "Carga de entrada de produtos cadastrada com sucesso."
  },
  "LoadProductEntranceCode": 789
}

---

Notas de Dev

• Certifique-se de que BranchNo, LoadNo, TransporterNo, DriverNo, LoadCreatedUserNo, PurchaseOrderNo, SupplierNo e outros códigos externos sejam válidos e existentes no sistema MIMS.
• Os campos de data, como LoadDate, PurchaseOrderDate, DocumentDate, ProductionDate e ExpirationDate, devem estar no formato ISO 8601 (ex.: 2025-02-20T12:00:00Z).
• O campo LoadMode aceita valores como ImPurchase (Compra) ou ImTransfer (Transferência).
• O campo DocumentType pode variar conforme o tipo de documento (ex.: Invoice para fatura).