Skip to main content

Retorna os dados comerciais do fornecedor

Este endpoint é responsável por retornar dados comerciais cadastrados do fornecedor.

Método: GET

URI do Endpoint: https://integration-marketplace.orbia.nom.co/orbia-marketplace-hub/v1/supplierConfiguration/supplierData

Requisição

Esse endpoint não tem parâmetro para requisição, isso é feito pelas credenciais.

Possíveis Respostas

Códigos de Resposta e seus significados:

Status CodeDescrição
200Sucesso: A requisição foi bem-sucedida.
400Bad Request: Erro de validação ou processamento da requisição. Verifique o corpo da requisição.
401Unauthorized: Autenticação necessária e não fornecida.
403Forbidden: A requisição foi autenticada, mas o usuário não tem permissões para a ação.
502Bad Gateway: O servidor, atuando como gateway ou proxy, recebeu uma resposta inválida do servidor upstream.

Exemplos de Respostas:

  • Sucesso (200):

{
"supplierData": {
"document": "string",
"stateRegistration": "string",
"companyName": "string",
"commercialName": "string",
"commercialPhone": "string",
"webSite": "string",
"email": "string",
"taxRegime": "string"
}
}

Descrição das propriedades:

Nome da propriedadeDescriçãoTipo
supplierDataObjeto da respostaobject
documentDocumento “CPF” ou “CNPJ”string
stateRegistrationRegistro estadualstring
companyNameNome da empresastring
commercialNameNome comercialstring
commercialPhoneData de nascimento do contato financeirostring
webSiteSite do fornecedorstring
emailEmail de contato do fornecedorstring
taxRegimeRegime tributário da empresastring
  • Erro (400):

{
"statusCode": 0,
"message": "string",
"errors": {
"additionalProp1": ["string"],
"additionalProp2": ["string"],
"additionalProp3": ["string"]
}
}

Cómo Testar o Endpoint

Para testar este endpoint, você pode usar ferramentas como Postman ou cURL. Siga as instruções abaixo:

  1. Abra o Postman.

  2. Selecione o método GET e insira a URL do endpoint.

  3. No corpo da requisição, insira o JSON do exemplo fornecido.

  4. Envie a requisição e observe a resposta.

Importante

Para um teste bem-sucedido, certifique-se de que você tem as credenciais corretas (se necessário) e que o corpo da requisição está corretamente formatado conforme o exemplo.

Este documento serve como um guia básico para entender e testar o endpoint específico. Ajuste as seções conforme necessário para se adequar ao seu ambiente de negócios e práticas de desenvolvimento.