Contrato Fornecimento Produto

O endpoint AddProductSupplyContract é responsável pelo cadastro de um novo Contrato de Fornecimento de Produtos no sistema MIMS e pode ser visualizado na tela CAD420.

---

Como cadastrar um contrato de fornecimento de produto

Request HTTP Post

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

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
ContractNo	String(25)	Sim	Código externo do contrato de fornecimento de produtos
BranchNo	String(25)	Sim	Código externo da filial
ContractNumber	String(25)	Sim	Número do contrato de fornecimento de produtos
ContractName	String(40)	Não	Descrição do contrato de fornecimento de produtos
SupplierNo	String(25)	Sim	Código externo do fornecedor
ProductNo	String(25)	Sim	Código externo do produto
ContractTermStartDate	DataHora	Sim	Data inicial da vigência
ContractTermEndDate	DataHora	Sim	Data final da vigência
TotalContractedQty	Integer	Sim	Quantidade total contratada (UN)
TotalContractedWeight	Float	Não	Peso total contratado (Kg)
ContractedValuePerKilo	Float	Sim	Valor contratado por Kg
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
ContractCode	Integer	Sim	Código interno do Contrato de Fornecimento de Produtos gerado no sistema MIMS

---

Exemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddProductSupplyContract"' \
--header 'Content-Type: application/json' \
--data '{
  "ContractNo": "CTR-2025-001",
  "BranchNo": "FIL-001",
  "ContractNumber": "CTN-987654",
  "ContractName": "Contrato de Fornecimento de Milho 2025",
  "SupplierNo": "115370",
  "ProductNo": "PROD-MILHO-001",
  "ContractTermStartDate": "2025-01-01T00:00:00",
  "ContractTermEndDate": "2025-12-31T23:59:59",
  "TotalContractedQty": 50000,
  "TotalContractedWeight": 3000000.5,
  "ContractedValuePerKilo": 1.75,
  "OverwriteIfExists": true
}'

---

Exemplo de Response

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

---

🐞 Possíveis Erros

Código	Mensagem
PSC‑001	Parâmetro Código Externo do Contrato de Fornecimento de Produto (ContractNo) informado já existe!

---