Condições Comerciais

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