Fornecedores

O endpoint PostAddSupplier é responsável por cadastrar novos fornecedores.

No sistema Edata, consideramos três tipos de fornecedores, que podem ser cadastrados e consultados:

1. Transportadores: Fornecedores que realizam o transporte de produtos e mercadorias e que podem ser manipulados pela rotina CAD056 - Cadastro de Transportadores.
2. Fornecedores de Insumos: Aqueles que fornecem materiais e insumos utilizados na produção e que podem ser manipulados pela rotina CAD053 - Cadastro de Fornecedor.
3. Integrados: Fornecedores que participam diretamente da cadeia produtiva integrada e que podem ser manipulados pela rotina CAD085 - Cadastro de Integrados.

---

Como cadastrar um fornecedor

Request HTTP Post

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

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
SupplierNo	String(25)	Sim	Código externo do Fornecedor
CorporateName	String(40)	Sim	Nome do fornecedor
BusinessName	String(40)	Sim	Nome fantasia do fornecedor
ShortName	String(15)	Não	Nome reduzido do fornecedor
Phone	String(15)	Não	Número de telefone
Email	String(200)	Não	E-mail
RegisterDate	DataHora	Não	Data do cadastro
FederalRegisterNo	String(14)	Sim	CNPJ (Pessoa Jurídica) ou CPF (Pessoa Física)
StateRegisterNo	String(20)	Sim	Inscrição estadual (Pessoa Jurídica) ou RG (Pessoa Física)
Address	AddressInfo	Sim	Objeto que contém as informações do endereço do Fornecedor
SupplierType	SupplierType	Sim	Enumerador com os possíveis valores para o tipo do fornecedor: stIntegrator (Integrado), stTransporter (Transportador) ou stSupplier (Fornecedor)
PersonType	PersonType	Sim	Enumerador com os possíveis valores para o Tipo de pessoa: ptCompany (Pessoa Jurídica) ou ptPerson (Pessoa Física)
IsSelfEmployed	Boolean	Não	Flag que indica que o fornecedor é Autônomo
OverwriteIfExists	Boolean	Não	Flag que indica que os dados devem ser sobrescritos caso o registro já exista

Observação

• A obrigatoriedade do parâmetro Address é definida por configuração. Por padrão, esse parâmetro é obrigatório. Para alterar esse comportamento, consulte o consultor responsável.
• O valor informado no parâmetro FederalRegisterNo deve respeitar o tamanho conforme o tipo de pessoa especificado no parâmetro PersonType:
  • 14 caracteres quando PersonType = ptCompany (corresponde ao CNPJ)
  • 11 caracteres quando PersonType = ptPerson (corresponde ao CPF)

---

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
SupplierCode	Integer	Sim	Código interno do fornecedor gerado no sistema MIMS

---

Exemplo de Request

curl --location 'http://localhost:8080/datasnap/rest/RESTWebServiceMethods/"PostAddSupplier"' \
--header 'Content-Type: application/json' \
--data-raw '{
  "SupplierNo": "F12345",
  "CorporateName": "Fornecedor Exemplo",
  "BusinessName": "Fornecedor Exemplo",
  "ShortName": "Fornecedor",
  "Address": {  
    "AddressType": "Rua",  
    "Address": "Antônio Alves",
    "Number": "35",
    "District": "Vila Universitaria",
    "ZIPCode": "17012431",
    "City": "BAURU",
    "State": "SAO PAULO",
    "StateInitials": "SP",
    "Country": "BRASIL",
    "SubLogisticRegionNo": "001",
    "PersonAdressNo": "98765"
  },
  "SupplierType": "stTransporter",
  "Phone": "01431618500",
  "Email": "exemplo@edata.com.br",
  "RegisterDate": "2025-01-21T00:00:00",
  "FederalRegisterNo": "12345678000195",
  "StateRegisterNo": "123456789",  
  "PersonType": "ptCompany",  
  "IsSelfEmployed": false,
  "OverwriteIfExists": true
}'

---

Exemplo de Response

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

---

🐞 Possíveis Erros

Código	Mensagem
ASP‑001	Parâmetro Código Externo do Fornecedor (SupplierNo) informado já existe!
ASP‑002	Não é possível modificar o tipo de Fornecedor (SupplierType) de um Fornecedor já cadastrado!
ASP‑003	O parâmetro "PersonType" foi inserido como "ptPerson", mas o valor inserido no parâmetro "FederalRegisterNo" ([valor enviado na requisição]) tem mais de 11 dígitos.

---