Há casos em que funcionários podem ser transferidos para empresas filiais, que pertencem ao mesmo grupo de empresas, porém, com outro nome e CNPJ. Confira abaixo as configurações necessárias para que o processo de transferência do funcionário para a nova empresa funcione corretamente na aplicação.

​
Pré requisitos

Antes de iniciar as configurações é necessário ter as seguintes informações:
  • ID da empresa antiga
  • ID da nova empresa
  • CPF do funcionário a ser transferido

​
Configurações

​
1. Criar um novo vínculo empregatício

Primeiramente, é necessário criar manualmente um novo vínculo empregatício, que será responsável por indicar a aplicação sobre a transferência de CNPJ do funcionário.
  • Crie um novo vínculo através do endpoint: Criar vínculo empregatício
    • No parâmetro status , indicar a opção transferred
    • No parâmetro company, inserir o ID da antiga empresa
    • No parâmetro transferredTo, inserir ID da nova empresa
    • No parâmetro customer, é obrigatório preencher o campo document com o CPF do funcionário que está sendo transferido

Exemplo da chamada:

{

  

"status":  "transferred",

  

"customer":  {

  

"document":  "23894709283"

  

},

  

"company":  "comp_65243323b5ce5da15dc65be1",

  

"transferredTo":  "comp_62d9889bd3985729e5a048ef"

  

}
Esta configuração é a única que deve ser feita manualmente. Todas as outras configurações a seguir são feitas automaticamente pela aplicação.

​
2. Obter ID do cliente

A aplicação obtem o ID do cliente (o funcionário que está sendo transferido) através do endpoint: Listar clientes
    • O parâmetro document é preenchido com o CPF do cliente
    • ID obtido e salvo pela aplicação

​
3. Listar empréstimos em aberto

Antes de fazer a transferência de CNPJ, é fundamental saber se o funcionário possui empréstimos em aberto.
  • A aplicação executa o endpoint: Listar empréstimos
    • No parâmetro customer, a aplicação inseri o ID do cliente (obtido no passo 2)
    • No parâmetro status, seleciona a opção open

​
4. Encontrar as parcelas não pagas de cada empréstimo em aberto (encontrado no passo anterior)

  • Para encontrar as parcelas não pagas, a aplicação utiliza o endpoint: Listar parcelas
    • No parâmetro loan, a aplicação preenche com o ID do empréstimo em aberto (encontrado no passo anterior)
    • O parâmetro payer, é preenchido com o ID da empresa antiga
    • O parâmetro status, é selecionado com a opção unpaid
Agora a aplicação tem todas as parcelas não pagas da empresa antiga e que precisam ser transferidas para a nova empresa.

​
5. Criar uma nova parcela para cada parcela não paga (encontrada no passo anterior)

  • Para criar uma nova parcela, a aplicação utiliza o endpoint: Criar parcela
  • Todos os campos da nova parcela são preenchidos exatamente igual aos da parcela do passo anterior, apenas o campo payer, que é alterado e preenchido com o ID da nova empresa.

​
6. Checar se existe transação na parcela

Para cada parcela em aberto (encontrada no passo 4) é necessário checar se existe alguma transação. Como por exemplo, verificar se já foi feito algum tipo de pagamento, há casos em que parte da parcela já pode ter sido paga.
  • Para checar, a aplicação utiliza o endpoint: Listar parcelas
    • Na resposta, a aplicação verifica se existe alguma informação no campo transactions
    • Caso exista alguma informação, é necessário criar uma nova fatura
  • Para criar uma nova fatura, a aplicação utiliza o endpoint: Criar fatura
    • É necessário criar dois itens de fatura
  • Primeiro item:
    • O parâmetro installment, é preenchido pela aplicação com o ID da parcela antiga (que tem transação)
    • O parâmetro amount, é preenchido com o valor negativo da transação (por exemplo, se a parcela é de 400 e tem uma transação de 200, -200 é o valor a ser preenchido)
    • O parâmetro discount, também é preenchido com o valor negativo da transação
  • Segundo item:
    • O parâmetro installment, é preenchido com o ID da parcela nova (obtido no passo 5)
    • O parâmetro amount, é preenchido com o valor da transação (por exemplo, se a parcela é de 400 e tem transação de 200, 200 é o valor a ser preenchido)
    • O parâmetro discount, é preenchido com o valor da transação
  • Ainda em fatura:
    • O parâmetro type, é selecionado com a opção company_recurring
    • O parâmetro payer, é preenchido com ID da nova empresa
    • O parâmetro dueDate, é preenchido com a data do dia em que a fatura está sendo criada
    • O parâmetro beneficiary, é preenchido com o ID do fundo da parcela
    • O parâmetro autoFinalize, é selecionado com o valor true
    • O parâmetro updateInvoiceItemOnInsert, é selecionado com o valor false

​
7. Anular parcelas antigas

Por último, depois de ter criado as novas faturas com sucesso, é necessário que a aplicação anule as parcelas antigas.
  • Para anular parcelas, a aplicação utiliza o endpoint: Anular parcela
    • O parâmetro installment, é preenchido com o ID da parcela antiga
Parcelas com payer da antiga empresa que não foram pagas, o status é definido como void.
O parâmetro company nos empréstimos (loans) do cliente não é atualizado durante o processo de transferência.