Skip to main content

Configuração fornecedor dados bancários

Este endpoint é responsável por recuperar os dados bancários configurados pelo fornecedor.

Método: GET

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

Requisição e Tipos de Dados

Tipo de Conteúdo da Requisição: application/json

Corpo da Requisição:

Nesse endpoint é usado o clientId para identificar o fornecedor

Possíveis Respostas

Códigos de Resposta e seus significados:

Status CodeDescriçãoObservaçãoCorpo da Resposta
200Sucesso na operaçãoRetorna em qualquer tipo de requisição com sucessoSim
400Bad Request: Erro de validação ou processamento da requisição.Verifique o corpo da requisição.Sim
401Unauthorized: Autenticação necessária e não fornecida.Verifique seu ClientId, ClientSecret e o Token enviadoNão
403Forbidden: A requisição foi autenticada, mas o usuário não tem permissões para a ação.Verifique suas configurações de rede ou VPNNão
502BadGateway: indica que ele, enquanto atuando como um servidor intermediário, recebeu uma resposta inválida do servidor para o qual a requisição foi encaminhada.Verifique sua requisiçãoNão

Exemplos de Respostas:

  • Sucesso (200):

{
"supplierBankResponse": {
"ownerName": "string",
"documentType": "string",
"document": "string",
"bankId": "string",
"bankBranch": "string",
"bankBranchDigit": "string",
"accountNumber": "string",
"accountNumberDigit": "string",
"accountType": "string",
"checkingCopyURL": "string" (base64)
}
}

  • 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.

Casos de uso

  1. Pensando que o fornecedor exista, vamos recuperar os dados bancários do mesmo.

Buscamos os dados bancários no endpoint GET: supplierConfiguration/supplierBankData

teste