Vendedores

Descrição

O endpoint PostAddSeller é responsável pelo cadastro de um novo vendedor no sistema MIMS e pode ser visualizado na tela CAD054.

---

Como cadastrar um novo vendedor

Request HTTP Post

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

Parâmetros de Entrada

Parâmetro	Tipo	Obrigatório	Descrição
SellerNo	String(25)	Sim	Código externo do vendedor
CorporateName	String(40)	Sim	Nome do vendedor
BusinessName	String(40)	Sim	Nome fantasia do vendedor
ShortName	String(15)	Não	Nome reduzido
Address	AddressInfo	Sim	Objeto que contém as informações do endereço do vendedor
Phone	String(15)	Não	Número de telefone
Email	String(200)	Não	E-mail
FoundationDate	Data	Não	Data de nascimento
RegisterDate	DataHora	Não	Data de cadastro
FederalRegisterNo	String(14)	Sim	CNPJ
StateRegisterNo	String(20)	Sim	Inscrição estadual
PersonType	PersonType	Sim	Enumerador com os possíveis valores para o Tipo de pessoa: ptCompany (Pessoa Jurídica), ptPerson (Pessoa Física)
Commission	Float	Não	Percentual de comissão do vendedor
InternalCodeNo	String(25)	Não	Código de Integração do Vendedor
IsInactive	Boolean	Não	Flag que indica que o vendedor está inativo
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
SellerCode	Integer	Sim	Código interno do vendedor gerado no sistema MIMS

---

Exemplo de Request

curl --location --request POST '{{url_base}}/PostAddSeller' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "SellerNo": "VND12345",
    "CorporateName": "Vendedor Exemplo LTDA",
    "BusinessName": "Vendedor Exemplo",
    "ShortName": "VendEx",
    "Address": {
        "Street": "Rua Exemplo",
        "Number": "100",
        "City": "Cidade Exemplo",
        "State": "SP",
        "ZipCode": "01000-000"
    },
    "Phone": "11999990000",
    "Email": "vendedor@example.com",
    "FoundationDate": "2022-01-01",
    "RegisterDate": "2022-01-15T14:30:00",
    "FederalRegisterNo": "12345678000190",
    "StateRegisterNo": "123456789",
    "PersonType": "ptCompany",
    "Commission": 5.5,
    "InternalCodeNo": "INT123",
    "IsInactive": false,
    "OverwriteIfExists": true
}'

---

Exemplo de Response

{
    "WebServiceReturn": {
        "Status": "wrsSuccess",
        "ErrorCode": "",
        "Message": "",
        "Actor": "",
        "ReturnQuestion": null
    },
    "SellerCode": 789
}