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 Code | Descrição | Observação | Corpo da Resposta |
|---|---|---|---|
| 200 | Sucesso na operação | Retorna em qualquer tipo de requisição com sucesso | Sim |
| 400 | Bad Request: Erro de validação ou processamento da requisição. | Verifique o corpo da requisição. | Sim |
| 401 | Unauthorized: Autenticação necessária e não fornecida. | Verifique seu ClientId, ClientSecret e o Token enviado | Não |
| 403 | Forbidden: 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 VPN | Não |
| 502 | BadGateway: 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ção | Nã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:
-
Abra o Postman.
-
Selecione o método
GETe insira a URL do endpoint. -
No corpo da requisição, insira o JSON do exemplo fornecido.
-
Envie a requisição e observe a resposta.
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
- Pensando que o fornecedor exista, vamos recuperar os dados bancários do mesmo.
Buscamos os dados bancários no endpoint GET: supplierConfiguration/supplierBankData
