A plataforma suporta várias camadas de personalização. Este guia se divide em duas partes: configurações básicas iniciais e configurações avançadas, que incluem integrações e regras de negócio.

​
Checklist para ambiente de teste

Siga esses itens para configurar um ambiente básico e simular as jornadas dos usuários utilizando mock.
1

Criar produto

Utilize o endpoint Criar produto para criar um novo produto, especificando o nome e slug. Você pode usar name: "Empréstimo Consignado" e slug: "consignado" para começar.
curl --request POST \
  --url https://api.base39.io/v1/products \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "slug": "consignado",
    "name": "Empréstimo Consignado",
    "status": "active",
    "settings": {
      "products": {
        "eligibility": {
          "type": "mock",
          "options": {
            "maxLoanAmount": 10000,
            "minLoanAmount": 200,
            "maxNumberOfInstallments": 48,
            "minNumberOfInstallments": 6,
            "maxInstallmentValue": 5000,
            "minInstallmentValue": 200
          }
        },
        "offer": {
          "options": {
            "insurance": {
              "amount": 0,
              "fee": 1.73,
              "type": "required",
              "number": 123456,
              "insurer": "Cia de Seguros"
            },
            "monthlyFee": 1.99,
            "numberOfInstallments": [
              6,
              12,
              18,
              24,
              30,
              36,
              48
            ],
            "daysUntilDisbursement": 7,
            "monthsUntilFirstDueDate": 1,
            "creditOperationType": "CCB",
            "rebates": [
              {
                "feeType": "tac",
                "amountType": "absolute",
                "amount": 250,
                "description": "Tarifa de cadastro"
              }
            ]
          }
        },
        "documents": {
          "toRequest": [
            {
              "purpose": "identity_document_front",
              "name": "Frente do RG/CNH",
              "owner": "customer",
              "expireInDays": 365
            },
            {
              "purpose": "identity_document_back",
              "name": "Verso do RG/CNH",
              "owner": "customer",
              "expireInDays": 365
            },
            {
              "purpose": "pay_stub",
              "name": "Holerite",
              "owner": "customer",
              "expireInDays": 30
            }
          ]
        },
        "disbursement": "mock"
      }
    }
  }
  '
2

Criar fundo

Use o endpoint Criar fundo para criar um fundo que será utilizado na CCB e outros procedimentos de cobrança.
curl --request POST \
  --url https://api.base39.io/v1/funds \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "name": "FIDIC 01",
    "document": "000000000000"
  }
  '
3

Criar empresa

Empresa é a entidade que gerencia os seus convênios, os funcionários, política de crédito e produtos são vinculados a essa entidade.Crie uma empresa com name e document através do endpoint Criar uma empresa.
curl --request POST \
  --url https://api.base39.io/v1/companies \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "name": "Empresa Mock LTDA",
    "document": "000000000000"
  }
  '
4

Criar operador para o Backoffice

Crie um através do endpoint Criar operador e em seguida configure as permissões através do endpoint Configurar permissões do operador.Para começar e conhecer melhor como funcionam os fluxos, recomendamos que você crie um operador com a permissão backoffice com o company: "*" para permitir o acesso em todas as empresas/convênios.
Consulte as URLs de acesso aos portais com o Suporte da Base39.
  1. Crie um novo operador
curl --request POST \
  --url https://api.base39.io/v1/operators \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "document": "000000000000",
    "name": "John Doe",
    "email": "john@mail.com",
    "username": "john@mail.com"
  }
  '
  1. Adicione a permissão de backoffice em todas as empresas * no operador usando o id da resposta anterior.
curl --request POST \
  --url 'https://api.base39.io/v1/permissions?operator=<id-do-operador>' \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "company": "*",
    "roles": [
      "backoffice"
    ]
  }
  '
  1. Acesse o Backoffice com o email cadastrado.
Você pode usar alias de email para facilitar os testes. Por exemplo, se o seu email é john@mail.com, use john+operador@mail.com. Todos os emails serão enviados para a mesma caixa de entrada do seu email principal.
5

Criar operador para o Portal da Empresa

Crie um através do endpoint Criar operador e em seguida configure as permissões através do endpoint Configurar permissões do operador.Para começar e conhecer melhor como funcionam os fluxos, recomendamos que você crie um operador com as permissões approver e financial para a primeira empresa que você criou.
Consulte as URLs de acesso aos portais com o Suporte da Base39.
  1. Crie um novo operador
curl --request POST \
  --url https://api.base39.io/v1/operators \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "document": "000000000000",
    "name": "Jane Doe",
    "email": "jane@mail.com",
    "username": "jane@mail.com"
  }
  '
  1. Adicione a permissão de approver e financial na empresa criada no operador usando o id da resposta anterior.
curl --request POST \
  --url 'https://api.base39.io/v1/permissions?operator=<id-do-operador>' \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "company": "<id-da-empresa>",
    "roles": [
      "approver",
      "financial"
    ]
  }
  '
  1. Acesse o Portal da Empresa com o email cadastrado.
6

Criar vínculo empregatício

Você pode fazer a importação de um arquivo com os funcionários através do Portal da Empresa ou através do endpoint Criar vínculo empregatício.
Consulte as URLs de acesso aos portais com o Suporte da Base39.
Recomendamos que você informe pelo menos os campos:
  • Salário bruto (grossSalary)
  • Salário líquido (netSalary)
  • Data de admissão (hiredAt)
  • Margem consignável (limitPerInstallment)
Os dados do objeto employment.customer não criam e atualizam os campos do objeto customer na API de Clientes. As informações de customer no employment são apenas para consultar os dados que a empresa fornece e, caso queira, você pode consultar esses dados para fazer relatórios ou campanhas de marketing para incentivar o cadastro. O customer é criado somente quando o cliente faz o próprio cadastro pelo Portal do Cliente.
É necessário o id da empresa criado no item 3 de empresa para preencher o campo company.
curl --request POST \
  --url https://api.base39.io/v1/employments \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "status": "working",
    "customer": {
      "document": "000000000000"
    },
    "grossSalary": 10000,
    "netSalary": 8000,
    "hiredAt": "2021-07-25",
    "limitPerInstallment": 2800,
    "company": "<id-da-empresa>"
  }
  '
Não é necessário cadastrar um cliente para criar um novo vínculo empregatício. Nesse momento é usado o documento do cliente.
7

Configurar etapas da esteira

Para que a proposta com o desembolso do tipo simule o status desembolsado ao final do processo, é necessário configurar apenas o passo de desembolso na esteira.
curl --request POST \
  --url https://api.base39.io/v1/settings \
  --header 'authorization: Basic <sua-api-key>' \
  --data '
  {
    "steps": {
      "desembolso": {
        "title": "Desembolsar",
        "type": "disburse"
      }
    }
  }
  '
Você pode configurar várias etapas de verificação antes do desembolso, como averbação, análise de risco, análise de documentos, etc. Veja alguns templates no guia da Esteira
8

Enviar proposta

Agora você pode acessar o Portal do Cliente com o documento usado na criação do vínculo empregatício no item 5. Você deve visualizar o produto criado no item 1. Siga os passos para visualizar os valores da simulação e enviar a proposta.
Os valores da simulação mock podem ser alterados alterando a requisição de exemplo no item 1.
Como configurado no item anterior, todos as propostas criadas serão desembolsadas automaticamente em alguns segundos. O status será alterado para desembolsado e todas as parcelas serão criadas automaticamente. A proposta enviada será exibida no Backoffice e Portal Empresa.
As configurações da esteira com aprovações manuais ou automáticas podem ser feitas seguindo o guia da Esteira.

​
Checklist para ambiente de produção

Siga esses itens para configurar os itens necessários para operar em ambiente produtivo.