Onboarding
A API para consulta de condições comerciais possibilita que seja consultado os limites, permissões e acordos entre as
partes para determinado produto Pottencial.
Pré-requisitos
Antes de começar a utilizar a API, é fundamental compreender os requisitos de autenticação e obter as credenciais
necessárias.
Certifique-se de revisar a seção de
autenticação
para garantir uma integração segura e bem-sucedida.
Consultar condições comerciais
Obtém condições comerciais para determinado produto Pottencial.
Requisição (Request)
| Url |
https://api-sandbox.pottencial.com.br/onboarding/v1/products/{product_key}/commercial-conditions |
| Method |
GET |
| Query |
product_key |
Chave de identificação do produto
- maquinas-equipamentos
- benfeitorias
- penhor-rural
|
| Headers |
client_id |
Client ID da App. |
|
access_token |
Token de acesso gerado para a App. |
Resposta (Response)
| Status |
Descrição |
Tipo |
| 200 |
Obtém a lista de condições comerciais. |
Lista de CommercialConditionsResponse |
| 400 |
Os dados da requisição estão inválidos. |
ErrorResult |
| 401 |
Parceiro não autorizado a realizar a operação. |
ErrorResult |
| 403 |
Parceiro não autorizado a realizar a operação. |
ErrorResult |
| 429 |
Quantidade de requisições excede o limite permitido para o período. |
ErrorResult |
| 500 |
Erro interno da API. Por favor tente novamente mais tarde ou contate o suporte técnico da Pottencial. |
ErrorResult |
Exemplo
[
{
"key": "CommissionPercentage",
"default": 0.23,
"min": 0.23,
"max": 0.3,
"description": "Percentual de comissão"
},
{
"key": "PaymentType",
"default": "Boleto",
"description": "Forma de pagamento"
},
{
"key": "MaxInterestFreeInstallments",
"default": 5,
"description": "Número máximo de parcelas sem juros"
},
{
"key": "MultiPaymentType",
"default": [
"Boleto",
"Debit"
],
"description": "Formas combinadas de pagamento (1ª e demais parcelas)"
}
]
Consultar compromissos
Obtém compromissos disponíveis para determinado produto.
Requisição (Request)
| Url |
https://api-sandbox.pottencial.com.br/onboarding/v1/products/{product_key}/appointments |
| Method |
GET |
| Query |
product_key |
Chave de identificação do produto
- maquinas-equipamentos
- benfeitorias
- penhor-rural
|
| Headers |
client_id |
Client ID da App. |
|
access_token |
Token de acesso gerado para a App. |
Resposta (Response)
| Status |
Descrição |
Tipo |
| 200 |
Obtém a lista de compromissos. |
Lista de AppointmentsResponse |
| 400 |
Os dados da requisição estão inválidos. |
ErrorResult |
| 401 |
Parceiro não autorizado a realizar a operação. |
ErrorResult |
| 403 |
Parceiro não autorizado a realizar a operação. |
ErrorResult |
| 429 |
Quantidade de requisições excede o limite permitido para o período. |
ErrorResult |
| 500 |
Erro interno da API. Por favor tente novamente mais tarde ou contate o suporte técnico da Pottencial. |
ErrorResult |
Exemplo
[
{
"name": "Empresa X S.A.",
"documentNumber": "02299555000444",
"defaultPercentage": 0,
"minPercentage": 0,
"maxPercentage": 0.25
},
{
"name": "Empresa Y S.A.",
"documentNumber": "00333311000111",
"defaultPercentage": 0,
"minPercentage": 0,
"maxPercentage": 0.25
}
]
Dicionário
CommercialConditionsResponse
| Campo |
Tipo |
Regras |
Descrição |
| key |
string |
Somente Leitura |
Identificador único da condição comercial. |
| default |
string | decimal | int | array |
Somente Leitura |
Valor padrão da condição comercial. |
| min |
decimal | int |
Somente Leitura |
Valor mínimo da condição comercial. |
| max |
decimal | int |
Somente Leitura |
Valor máximo da condição comercial. |
| description |
string |
Somente Leitura |
Descrição da condição comercial. |
AppointmentsResponse
| Campo |
Tipo |
Regras |
Descrição |
| name |
string |
Somente Leitura |
Nome da pessoa. |
| documentNumber |
string |
Somente Leitura |
Documento da pessoa. |
| defaultPercentage |
decimal |
Somente Leitura |
Valor percentual padrão para a pessoa. |
| minPercentage |
decimal |
Somente Leitura |
Valor percentual mínimo para a pessoa. |
| maxPercentage |
decimal |
Somente Leitura |
Valor percentual máximo para a pessoa. |
Resolução de erros
ErrorResult
Representa um resultado de erro na chamada da plataforma.
| Campo |
Tipo |
Regras |
Descrição |
| errors |
Lista de ErrorMessage |
Opcional |
Lista de erros da solicitação. |
ErrorMessage
Contém informações de um erro.
| Campo |
Tipo |
Regras |
Descrição |
| code |
string |
Opcional |
Código de identificação do erro. |
| message |
string |
Opcional |
Descrição do erro. |