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