Estrutura básica de componentes

Documentação

Referência da API

Novidades

Base39

Início

Originação

Cobrança

Integrações

Para desenvolvedores

Release notes

Suporte

Status

Objetos principais

Introdução

Soluções

Este guia fornece uma lista abrangente de itens a serem configurados para inicializar o seu ambiente, seja ele de teste ou de produção, na plataforma.

Checklist

Visão geral

Configuração de estilos customizados para o Portal do Cliente

Estilos customizados

Configuração de textos customizados para o Portal Cliente

Textos Customizados

Status da Base39

Central de Ajuda

Elegibilidade

Regras de elegibilidade

Oferta

Documentos

Desembolso

Detalhes de como realizar a migração da criação de documentos do empréstimo para as etapas da Esteira

Migração da criação de documentos

Recálculo de oferta

Antecipação de salário

Esteira é um conjunto de etapas que definem o ciclo de vida de um empréstimo, desde a originação até o desembolso.

Esteira

Descreve o funcionamento de dependência entre as etapas da esteira.

Dependências

Os passsos configurados em todos os níveis são somados e exibidos na ordem de prioridade.

Hierarquia e exceções

Verificação de documento

Verificação de assinatura

Desembolsar

A etapa do tipo criação de documentos pode ser utilizada para criar documentos referentes ao empréstimo.

Criação de documentos

A etapa da Esteira do tipo UNICO pode ser utilizada para assegurar os dados de biometria de funcionários que solicitam empréstimo.

UNICO

Eventos do webhook publicados pelo fluxo de esteira

Eventos do webhook

Hooks

Templates

Políticas de crédito

Visualização das filas

Criando uma Fila

Editando uma Fila

Removendo uma Fila

O registro de vínculo empregatício preserva informações essenciais sobre a remuneração e margem consignável do cliente.

Guia de configurações necessárias para realizar o processo de transferência de funcionário entre empresas filiais.

Transferência entre filiais

Rescisão

Regras de transferência de funcionários

Importação de base de funcionários

Operadores

QITech

API Externa

Objetos mock, objetos simulados ou simplesmente mock são objetos que simulam o comportamento de objetos reais de forma controlada.

Mock

Clientes

Email

Notificação de cobrança via automação

Temas

Configure os domínios das aplicações da Base39

Domínios

Validação de chave PIX

Guia passo a passo sobre como consultar parcelas vencidas e gerar uma fatura.

Vencidas

Pagamento excedente nas parcelas

Estorno e redistribuição automática

Guia de como criar uma fatura de devolução.

Devolução

Guia de como criar uma fatura de redistribuição entre parcelas.

Redistribuir

Guia de como criar uma fatura recorrente da empresa.

Fatura recorrente da empresa

Fatura de rescisão

Propósitos da fatura

Importação de fatura

Alterar a data de vencimento de um boleto

Integração para desembolso e validação de chave PIX com a QITech.

Infobip

Twilio

SMTP

Sendgrid

Envio de e-mail sem SMTP

Envio de e-mail através da Base39

Kobana

reCAPTCHA

A Base39 fornece ambientes diferentes para testes e produção. Esse guia mostra como usar esses ambientes.

Ambientes

Tipos de erros

Você pode usar esse parâmetro para anexar dados de valor-chave a esses objetos.

Metadata

Paginação

Tolerant reader

Expandindo referências

A sintaxe de pesquisa foi projetada para ser simples e intuitiva, permitindo que você realize buscas complexas com facilidade.

Pesquisa

A funcionalidade de campos solicitados oferece flexibilidade ao permitir a definição de campos específicos a serem incluídos nas respostas das chamadas de API.

Campos solicitados

Chaves de API

Data e hora

Valores percentuais

Valores financeiros

Formato do ID

Saiba mais sobre os limites de requisições da API e como trabalhar com eles

Limite de requisiões

Ambiente de testes

Auditoria

Idempotência

Escute os eventos da sua conta Base39 para que sua integração possa desencadear reações automaticamente.

Webhooks

Implemente essas práticas recomendadas ao usar webhooks.

Melhores práticas

Tipos de eventos

Na Base39, adotamos uma abordagem inovadora para garantir a máxima disponibilidade e resiliência dos nossos serviços

Resiliência

Descreve as configurações de rede necessárias para se comunicar com a Base39.

Rede

Obter empréstimo

Retorna todas os empréstimos. 

Os itens são retornados e ordenados por data de criação, com os itens mais recentes primeiro.

Listar empréstimos

Pesquise empréstimos que você criou anteriormente usando a linguagem de query.

Pesquisar empréstimos

Lista todas as parcelas de um empréstimo. 

Os itens são retornados e ordenados por data de criação, com os itens mais recentes primeiro. Fluxo de quitação antecipada: Para saber o valor das parcelas em um caso de quitação antecipada, envie o campo `payment_for` com a data de pagamento pretendida, assim o valor da parcela será calculado com base no valor presente (`VP`) da data de pagamento pretendida.

Listar parcelas

Retorna todas as etapas da esteira do empréstimo.

Os itens são retornados e ordenados por data de criação, com os itens mais recentes primeiro.

Listar passos da esteira de empréstimos

Atualiza o empréstimo especificado definindo os valores dos parâmetros passados. Quaisquer parâmetros não fornecidos serão deixados inalterados.

Essa requisição aceita praticamente os mesmos argumentos que a requisição de criação do empréstimo.

Atualizar empréstimo

Criar empréstimo

Cancelar empréstimo

Anular empréstimo

Marcar empréstimo como expirado

Altera o estado de um empréstimo para aberto.

Alterar o estado de um empréstimo para aberto

Desembolsar empréstimo

Criar transação

Criar parcela

Marcar empréstimo como pendente

Anexar arquivo ao empréstimo

Assinar empréstimo

Exclui permanentemente um empréstimo. Não pode ser desfeito.

Excluir empréstimo

Remove do empréstimo o vínculo de um arquivo (esta operação não deletará o arquivo).

Desanexar arquivo do empréstimo

Retorna todas as políticas de crédito. 

Os itens são retornados e ordenados por data de criação, com os itens mais recentes primeiro.

Listar políticas de crédito

Obter política de crédito

Criar política de crédito

Atualizar política de crédito

Deletar uma política de crédito

Listar etapas

Atualizar etapa

Reexecuta a validação de uma etapa do empréstimo. Só é possível reexecutar passos com status diferente de `done`.

Revalidar etapa

Retorna todos os produtos. 

Os itens são retornados e ordenados por data de criação, com os itens mais recentes primeiro.

Listar produtos

Listar produtos elegíveis

Obter produto

Criar produto

Atualiza o produto especificado definindo os valores dos parâmetros passados. Quaisquer parâmetros não fornecidos serão deixados inalterados.

Essa requisição aceita praticamente os mesmos argumentos que a requisição de criação do produto.

Atualizar produto

Exclui permanentemente um produto. Não pode ser desfeito.

Excluir produto

Obter oferta

Calcular oferta

Obter parcela

Retorna todas as parcelas.
Os itens são retornados e ordenados por data de criação, com os itens mais recentes primeiro.

Anular parcela

Marcar parcela como incobrável

Exportar parcelas

Retorna todas as empresas. 

Os itens são retornados e ordenados por data de criação, com os itens mais recentes primeiro.

Listar empresas

Obter empresa

Pesquise empresas que você criou anteriormente usando a linguagem de query.

Pesquisar empresas

Inclui uma nova empresa com informações como nome, endereço, documento e outros detalhes relevantes. A operação retorna um identificador único da empresa para futuras consultas e operações

Criar empresa

Atualiza a empresa especificado definindo os valores dos parâmetros passados. Quaisquer parâmetros não fornecidos serão deixados inalterados.

Essa requisição aceita praticamente os mesmos argumentos que a requisição de criação da empresa.

Atualizar empresa

Exclui permanentemente uma empresa. Não pode ser desfeito.

Excluir empresa

Obter grupo de empresas

Retorna todos os grupos de empresas.

Os itens são retornados e ordenados por data de criação, com os itens mais recentes primeiro.

Listar grupos de empresas

Pesquise grupos de empresas que você criou anteriormente usando a linguagem de query.

Pesquisar grupos de empresas

Atualiza o grupo de empresas especificado definindo os valores dos parâmetros passados. Quaisquer parâmetros não fornecidos serão deixados inalterados.

Essa requisição aceita praticamente os mesmos argumentos que a requisição de criação do grupo de empresas.

Atualizar grupo de empresas

Criar grupo de empresas

Exclui permanentemente um grupo de empresas. Não pode ser desfeito.

Objeto	Descrição
`operator`	Define o usuário que acessa o Backoffice e Portal Empresa. Normalmente esse usuário possui um email corporativo. Caso esse operador não faça mais parte da empresa, o acesso é completamente removido.
`customer`	Define o usuário que acessar o Portal Empresa e solicita empréstimos. Normalmente esse usuário possui um email pessoal e continua com acesso mesmo após um desligamento.
`employment`	Define o vínculo empregatício. Vincula um CPF a uma empresa e também armazena o status, salário bruto, salário líquido e data de admissão do funcionário. Esse objeto é imutável e, normalmente, possui validade de 30 dias.
`company`	Define os dados da empresa ou convênio.
`offer`	Define os valores de uma oferta/simulação. Contem apenas informações de taxas, valores e quantidaade de parcelas. Esse objeto sempre é usado dentro de um empréstimo (`loan`)
`product`	Define um produto de crédito, como Empréstimo Consignado ou Antecipação de Salário. Cada produto possui uma configuração específica de elegibilidade e oferta.
`loan`	Esse objeto define uma solicitação/contrato. É responsável por gerenciar o status e vincular todos os outros objetos envolvidos na solicitação/contrato, como `customer`, `employment` e `offer`
`installment`	Define individualmente uma parcela. Cada `loan` possui várias `installments`. Esse objeto também é imutável. Se for necessário alguma mudança nas parcelas após o desembolso, será necessário criar um novo item e anular o anterior.
`invoice`	Define uma fatura. Uma fatura possui vários itens. Cada item de fatura possui um `installment` e um valor que pode ou não ser o total da `installment`. É necessário uma fatura fechada para enviar um link de pagamento e gerar o boleto de pagamento.
`tenant`	`Tenant` ou `Org` define a separação da sua conta com a de outros clientes da Base39.

Primeiros Passos

Tema

Suporte

​Estrutura básica de componentes

Estrutura básica de componentes