Skip to content

Instantly share code, notes, and snippets.

@esdras-splitpay
Last active October 20, 2025 18:21
Show Gist options
  • Save esdras-splitpay/c46a139511b0b2fd7c1cf09e1c38ab47 to your computer and use it in GitHub Desktop.
Save esdras-splitpay/c46a139511b0b2fd7c1cf09e1c38ab47 to your computer and use it in GitHub Desktop.

Rotinas > Notas Fiscais > Emissão Automática

Rotina de emissão automática de notas fiscais.

As notas fiscais podem ser emitidas automáticamente pelo sistema conforme as receitas desde que cumpram os requisitos para a emissão automática listados abaixo.

Índice

  1. Requisitos 1.1. Deve Haver Receita Pendente de Emissão 1.2. Deve Haver Emissor Válido 1.3. Deve Haver Valores Para o Emissor
  2. Modelos de Divisão 2.1. Modelo 1 - Rotação Integral de Receitas 2.2. Modelo 2 - Rotação Parcial de Receitas 2.3. Modelo 3 - Divisão Percentual de Receitas
  3. Processos de Divisão 3.1. Processo de Rotação Total 3.2. Processo de Rotação Pessoas Jurídicas 3.3. Processo de Divisão Percentual 3.4. Processo de Ajuste de Saldo
  4. Tipos de Receita 4.1. Paciente Pediu Nota Fiscal 4.2. Paciente Pediu Nota Fiscal Com Reembolso 4.3. Paciente Não Pediu Nota Fiscal
  5. Tipos de Emissor 5.1. Unidade 5.2. Profissional
  6. Tipos de Entrada 6.1. Entrada Bancária 6.2. Entrada Maquininha 6.3. Entrada Caixa
  7. Tipos de Proveniencia de Receita 7.1. Tipo 1 - Exame 7.2. Tipo 2 - Serviço
  8. Cenários de Teste 8.1. Cenários Modelo 1 - Rotação Integral de Receitas 8.2. Cenários Modelo 2 - Rotação Parcial de Receitas 8.3. Cenários Modelo 3 - Divisão Percentual de Receitas
  9. Vocabulário 9.1. SRP 9.2. VPP 9.3. VPC 9.4. SPC

1. Requisitos

Para a emissão automática de notas fiscais pelo sistema é necessário a observação de alguns requisitos.

1.1. Deve Haver Receita Pendente de Emissão

As notas fiscais são emitidas automáticamente com base nas receitas, portanto é necessário que haja receitas prontas para emissão, isto é, receitas que já estejam divididas e cuja o emissor seja válido. Também é importante observar se o tipo da receita está entre os tipos váidos para emissão

1.2. Deve Haver Emissor Válido

Atualmente temos 2 tipos de emissores em nosso sistema, sendo eles Unidade e Profissional. Para a emissão automática de notas fiscais é necessário que o emissor esteja apto para emissão em nosso sistema.

PS: É possível observar se o emissor está apto para emissão no cadastro. Quando o emissor estiver apto aparecerá 2 bolinhas verdes a primeira representa o Split e a segunda a Emissão Automática

1.3. Deve Haver Valores Para o Emissor

Considerando as regras do Modelo de Divisão conforme o tipo de receita, é necessário que o emissor tenha valores receber (ou já recebidos) da receita para qual a nota será emitida.

PS: Caso o emissor não tenha valores a receber, mesmo que esteja apto para emissão, não será emitida nota fiscal. Apenas uma nota simbólica mostrando valores zerados (que não será enviada para NFE.io)

2. Modelos de Divisão

O Modelo de Divisão de Pagamentos define como o sistema irá dividir cada receita entre clínica e prestador, este modelo pode ser selecionado no cadastro do cliente e é aplicado a todas as unidades igualmente.

2.1. Modelo 1 - Rotação Integral de Receitas

Neste modelo o sistema irá rotacionar as receitas, isto é, enviar o valor integral da receita ora para o profissional, ora para unidade. Isto porém occorrerá no Processo de Divisão conforme o tipo de receita. Vejamos:

2.2. Modelo 2 - Rotação Parcial de Receitas

Neste modelo o sistema irá rotacionar apenas as receitas do Tipo 2 (Paciente Pediu Nota Com Reembolso). Para receitas sem reembolso o sistema irá dividir percentualmente. Vejamos:

2.3. Modelo 3 - Divisão Percentual de Receitas

Neste modelo NÃO existe pedido de reembolso. Podendo variar somente entre os tipos de receita abaixo (sem pedido de reembolso).

3. Processos de Divisão

Os processos de divisão de pagamentos são utilizados internamente pelo sistema para definir o valor que será repassado em cada receita para a clínica e para o profissional.

3.1. Processo de Rotação Total

No processo de rotação total o valor de cada receita será repassado de maneira integral, ou seja, sem divisões, inteiro, ora para a clínica ora para o profissional.

O sistema consultará o Saldo a Receber do ProfissionalSRP e:

  • Caso o Pendente Profissional seja positivo, o valor da receita será repassado integralmente para o profissional.

  • Caso o Pendente Profissional seja negativo ou zerado, o valor da receita será repassado integralmente para a clínica.

3.2. Processo de Rotação Pessoas Jurídicas

Neste processo, o valor de cada receita será repassado de maneira integral para pessoas jurídicas.

  • Caso o profissional seja pessoa física, o valor da receita sempre será repassado integralmente para a clínica.

  • Caso o profissional seja pessoa jurídica (com ou sem emissão), o valor da receita será repassado integralmente para clínica ou para o profissional conforme o saldo a receber (Pendente Profissional):

    • Caso o Pendente Profissional seja positivo, o valor da receita será repassado integralmente para o profissional.

    • Caso o Pendente Profissional seja negativo ou zerado, o valor da receita será repassado integralmente para a clínica.

3.3. Processo de Divisão Percentual

No processo de divisão percentual, o valor da receita será dividido entre clínica e profissional conforme especificado no serviço.

Independentemente do valor do repasse ser fixo ou percentual, o sistema sempre converterá para percentual no momento da divisão dos valores. Isto porque, assim, caso haja qualquer alteração de valor no momento do pagamento, o sistema saberá adequar-se aos novos valores.

3.4. Processo de Ajuste de Saldo

Neste processo, o sistema tentará ajustar o saldo, podendo enviar valores parciais ou integrais para os recebedores (clínica e profissional), sempre objetivando zerar o saldo.

O sistema irá consultar o Pendente Profissional e:

4. Tipos de Receita

As receitas podem ser provenientes de Exame ou de Serviço.

  • Quando proveniente de Exame, não há repasse para profissional, o valor será inteiro da clínica.

  • Já quando a receita é proveniente de um Serviço a divisão dos valores entre clínica e profissional seguirá os critérios conforme o tipo de receita e modelo de divisão selecionado.

Estes são os tipos de receitas que podem gerar nota fiscal e podem ser divididos pelo sistema.

PS: Outros tipos de receita NÃO gerarão notas fiscais e podem não ser capturados e divididos

4.1. Tipo 1 - Paciente Pediu Nota Fiscal

Neste tipo de receita, o sistema dividirá os valores conforme o Modelo de Divisão de Pagamentos selecionado.

4.2. Tipo 2 - Paciente Pediu Nota Fiscal Com Reembolso

Este tipo de receita só existe nos modelos 1 e 2 de divisão de pagamentos, NÃO existe no modelo 3. Quando selecionado este tipo de receita, o sistema sempre utilizará o Processo de Rotação Pessoas Jurídicas.

4.3. Tipo 3 - Paciente Não Pediu Nota Fiscal

Este tipo de receita sempre utilizará o Processo de Ajuste de Saldo (independentemente do modelo de divisão selecionado).

5. Tipos de Emissor

Estes são os tipos de emissores de nota fiscal automática pelo sistema

5.1. Unidade

Para que a unidade emita notas fiscais automáticas pelo sistema é necessário que o cadastro esteja preenchido de forma adequada. Caso não exista alguma informação, ao tentar emitir uma nota gerará um erro ou notificação.

É necessário observar também se as 2 opções (split e nota fiscal) estão verdesa no cadastro da unidade

a. Verde significa que está "apto" para emissão

5.2. Profissional

Para que o profissional emita nota fiscal automaticamente pelo sistema é necessário que o profissional seja do tipo PJ Com Emissão, além de estar habilitado as opções Split e Nota Fiscal no cadastro.

Também é importante observar se todas as informações necessárias para a emissão da nota estão preenchidas. Caso falte alguma informação ou esteja inválida, ocorrerá um erro ou notificação durante o processo de emissão.

6. Tipos de Entrada

Os Tipos de Entrada são formas de recebimento das receitas e cada um tem um fluxo diferente.

6.1. Entrada Bancária

Chamamos de Entrada Bancária tudo aquilo que entra diretamente na conta da clínica (sem passar pelo sistema), são entradas das quais o sistema não tem controle e não pode realizar ações como divisão ou captura.

São Entradas Bancárias:

  • Ted/Doc - Quando o paciente faz uma transferencia bancária para a conta da clínica.
  • Pix Sem Split - Quando o paciente realiza um Pix por fora do sistema, diretamente para a chave da clínica.
  • Crédito Maquininha Terceiros - Quando um pagamento é feito no crédito, porém o estabelecimento não utilizou uma maquininha parceira.
  • Débito Maquininha Terceiros - Quando pagamento é feito no débito, mas o estabelecimento não utilizou uma maquininha parceira.

6.2. Entrada Maquininha

São chamados de Entrada Maquininha todos os pagamentos em que o sistema pode realizar a divisão, ou seja, pagamentos que passam pelo nosso sistema.

Entrada Maquininha pode ser:

  • Crédito Maquininha Parceira - Quando um pagamento no crédito foi faturado em nosso sistema.

  • Débito Maquininha Parceira - Quando um pagamento no crédito foi faturado em nosso sistema.

  • Pix Com Split - Quando um QR Code gerado pelo sistema é pago.

6.3. Entrada Caixa

Entrada Caixa é quando um pagamento é efetuado em dinheiro. Este valor entra diretamente no caixa da clínica, o sistema não tem o controle sobre este valor, porém, se habilitado a calculadora de repasses, o sistema indicará o valor a ser repassado para o profissional.

PS: Vale lembrar que a calculadora de repasse é apenas um facilitador que indica o valor a ser repassado, mas é de responsabilidade da clínica (do operador de caixa) repassar este valor.

7. Tipos de Proveniecia de Receita

Os Tipos de Proveniencia de Receita podem ser:

  • Tipo 1 - Exame
  • Tipo 2 - Serviço

7.1. Tipo 1 - Exame

Quando o Tipo de Proveniencia de Receita for Exame, o valor da receita deve ir inteiro para a clínica.

7.2. Tipo 2 - Serviço

Quando o Tipo de Proveniencia de Receita for Serviço, o valor da receita será dividido conforme o Tipo de Receita e o Modelo de Divisão de Pagamentos selecionado.

8. Cenários de Teste

Com base nas regras aqui especificadas, pode-se extrair alguns cenários de teste.

Aqui estão organizados pelos seguintes critérios:

  1. Tipo de Proveniencia de Receita
  2. Modelo de Divisão de Pagamentos
  3. Tipo de Profissional (PF, PJ ou PJ Emissão)
  4. Tipo de Receita
  5. Tipo de Entrada
  6. Balanço do Profissional
# Proveniencia Modelo Divisão Emissor Receita Entrada Balanço Resultado Divisão Resultado NF
1 Exame N/A N/A N/A Bancária + Caixa N/A Unidade: 100% 1 NF (Cheia)
Unidade
2 Exame N/A N/A N/A Maquininha N/A Unidade: 100% 1 NF (Cheia)
Unidade
3 Serviço Modelo 1 PF Tipo 1 Bancária N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
4 Serviço Modelo 1 PF Tipo 1 Maquininha SRP > 0 Unidade: 0%
Profissional: 100%
N/A
5 Serviço Modelo 1 PF Tipo 1 Maquininha SRP <= 0 Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
6 Serviço Modelo 1 PF Tipo 1 Caixa SRP > 0 Unidade: VPC
Profissional: VPP
N/A
7 Serviço Modelo 1 PF Tipo 1 Caixa SRP <= 0 Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Unidade
8 Serviço Modelo 1 PF Tipo 2 N/A N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
9 Serviço Modelo 1 PF Tipo 3 Bancária N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
10 Serviço Modelo 1 PF Tipo 3 Maquininha SRP >= VPC Unidade: 0%
Profissional: 100%
N/A
11 Serviço Modelo 1 PF Tipo 3 Maquininha SRP > 0 . SRP < VPC Unidade: VPC - SRP
Profissional: VPP + SRP
1 NF (Parcial)
Unidade
12 Serviço Modelo 1 PF Tipo 3 Maquininha SPC > 0 . SPC < VPP Unidade: VPC + SPC
Profissional: VPP - SPC
1 NF (Parcial)
Unidade
13 Serviço Modelo 1 PF Tipo 3 Maquininha SPC >= VPP Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
14 Serviço Modelo 1 PF Tipo 3 Caixa SRP >= VPC Unidade: VPC
Profissional: VPP
N/A
15 Serviço Modelo 1 PF Tipo 3 Caixa SRP > 0 . SRP < VPC Unidade: VPC
Profissional: VPP
1 NF (Parcial)
Unidade
16 Serviço Modelo 1 PF Tipo 3 Caixa SPC > 0 . SPC < VPP Unidade: VPC
Profissional: VPP
1 NF (Parcial)
Unidade
17 Serviço Modelo 1 PF Tipo 3 Caixa SPC >= VPP Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
18 Serviço Modelo 1 PJ Tipo 1 Bancária N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
19 Serviço Modelo 1 PJ Tipo 1 Maquininha SRP > 0 Unidade: 0%
Profissional: 100%
N/A
20 Serviço Modelo 1 PJ Tipo 1 Maquininha SRP <= 0 Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
21 Serviço Modelo 1 PJ Tipo 1 Caixa SRP > 0 Unidade: VPC
Profissional: VPP
N/A
22 Serviço Modelo 1 PJ Tipo 1 Caixa SRP <= 0 Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Unidade
23 Serviço Modelo 1 PJ Tipo 2 Bancária N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
24 Serviço Modelo 1 PJ Tipo 2 Maquininha SRP > 0 Unidade: 0%
Profissional: 100%
N/A
25 Serviço Modelo 1 PJ Tipo 2 Maquininha SRP <= 0 Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
26 Serviço Modelo 1 PJ Tipo 2 Caixa SRP > 0 Unidade: VPC
Profissional: VPP
N/A
27 Serviço Modelo 1 PJ Tipo 2 Caixa SRP <= 0 Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Unidade
28 Serviço Modelo 1 PJ Tipo 3 Bancária N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
29 Serviço Modelo 1 PJ Tipo 3 Maquininha SRP >= VPC Unidade: 0%
Profissional: 100%
N/A
30 Serviço Modelo 1 PJ Tipo 3 Maquininha SRP > 0 . SRP < VPC Unidade: VPC - SRP
Profissional: VPP + SRP
1 NF (Parcial)
Unidade
31 Serviço Modelo 1 PJ Tipo 3 Maquininha SPC > 0 . SPC < VPP Unidade: VPC + SPC
Profissional: VPP - SPC
1 NF (Parcial)
Unidade
32 Serviço Modelo 1 PJ Tipo 3 Maquininha SPC >= VPP Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
33 Serviço Modelo 1 PJ Tipo 3 Caixa SRP >= VPC Unidade: VPC
Profissional: VPP
N/A
34 Serviço Modelo 1 PJ Tipo 3 Caixa SRP > 0 . SRP < VPC Unidade: VPC
Profissional: VPP
1 NF (Parcial)
Unidade
35 Serviço Modelo 1 PJ Tipo 3 Caixa SPC > 0 . SPC < VPP Unidade: VPC
Profissional: VPP
1 NF (Parcial)
Unidade
36 Serviço Modelo 1 PJ Tipo 3 Caixa SPC >= VPP Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Unidade
37 Serviço Modelo 1 PJE Tipo 1 Bancária N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
38 Serviço Modelo 1 PJE Tipo 1 Maquininha SRP > 0 Unidade: 0%
Profissional: 100%
1 NF (Cheia)
Profissional
39 Serviço Modelo 1 PJE Tipo 1 Maquininha SRP <= 0 Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
40 Serviço Modelo 1 PJE Tipo 1 Caixa SRP > 0 Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Profissional
41 Serviço Modelo 1 PJE Tipo 1 Caixa SRP <= 0 Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Unidade
42 Serviço Modelo 1 PJE Tipo 2 Bancária N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
43 Serviço Modelo 1 PJE Tipo 2 Maquininha SRP > 0 Unidade: 0%
Profissional: 100%
1 NF (Cheia)
Profissional
44 Serviço Modelo 1 PJE Tipo 2 Maquininha SRP <= 0 Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
45 Serviço Modelo 1 PJE Tipo 2 Caixa SRP > 0 Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Profissional
46 Serviço Modelo 1 PJE Tipo 2 Caixa SRP <= 0 Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Unidade
47 Serviço Modelo 1 PJE Tipo 3 Bancária N/A Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
48 Serviço Modelo 1 PJE Tipo 3 Maquininha SRP >= VPC Unidade: 0%
Profissional: 100%
1 NF (Cheia)
Profissional
49 Serviço Modelo 1 PJE Tipo 3 Maquininha SRP > 0 . SRP < VPC Unidade: VPC - SRP
Profissional: VPP + SRP
2 NFs (Parciais)
Unidade e Profissional
50 Serviço Modelo 1 PJE Tipo 3 Maquininha SPC > 0 . SPC < VPP Unidade: VPC + SPC
Profissional: VPP - SPC
2 NFs (Parciais)
Unidade e Profissional
51 Serviço Modelo 1 PJE Tipo 3 Maquininha SPC >= VPP Unidade: 100%
Profissional: 0%
1 NF (Cheia)
Unidade
52 Serviço Modelo 1 PJE Tipo 3 Caixa SRP >= VPC Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Profissional
53 Serviço Modelo 1 PJE Tipo 3 Caixa SRP > 0 . SRP < VPC Unidade: VPC
Profissional: VPP
1 NF (Parcial)
Unidade
54 Serviço Modelo 1 PJE Tipo 3 Caixa SPC > 0 . SPC < VPP Unidade: VPC
Profissional: VPP
1 NF (Parcial)
Unidade
55 Serviço Modelo 1 PJE Tipo 3 Caixa SPC >= VPP Unidade: VPC
Profissional: VPP
1 NF (Cheia)
Unidade

SRP - Saldo a Receber do Profissional VPC - Valor Projetado Clínica VPP - Valor Projetado Profissional

8.1. Cenários de Exames

Quando o Tipo de Proveniente de Receita for Exame:

  • Não fará diferença o Modelo de Divisão de Pagamentos selecionado.

  • O Tipo de Emissor será sempre Unidade.

  • O Tipo de Receita também não afetará em nada.

  • Com relação ao Tipo de Entrada, a única diferença é com relação a consulta após a captura, pois quando é uma Entrada Maquininha podemos consultar diretamente no painel do parceiro, para ver se a captura ocorreu.

  • Não há Balanço do Profissional a ser considerado, pois não existe profissional vinculado a Exame.

Cenário 1: Exame Com Entrada Bancária ou Entrada Caixa

A - Divisão de Pagamentos:

DADO QUE Existe receita proveniente de Exame E Foi Pago com Entrada Bancária OU com Entrada Caixa QUANDO A rotina de divisão de exames executar (/job/split/exam) ENTÃO O status do pagamento deve mudar para Dividido

B - Emissão de Notas Fiscais

DADO QUE Existe uma receita de Exame com status Dividido QUANDO Eu executar a rotina de emissão de notas fiscas (/job/invoices/pendings) ENTÃO A uma nota fiscal de exame deve ser emitida no Valor Bruto da receita

Cenário 2: Exame Com Entrada Maquininha

DADO QUE Existe uma receita proveniente de Exame E Foi Paga com Entrada Maquininha QUANDO Eu executar a rotina de divisão de exames (/job/split/exam) ENTÃO O status da receita deve ser alterado para Dividido E O pedido (ordem) no painel do Parceiro deve aparecer como Pago

8.2. Cenários Modelo 1 - Rotação Integral de Receitas

Cenário 3: Serviço de Pessoa Física com Pedido de Nota Pago com Entrada Bancária

A - Divisão de Pagamentos

DADO QUE Eu utilize o Modelo de Rotação Integral de Receitas E Existe uma receita Com Pedido de Nota Fiscal proveniente de um Serviço E O profissional seja Pessoa Física E Foi Paga com Entrada Bancária QUANDO A rotina de divisão de pagamentos executar (/job/non/split) ENTÃO O pagamento deve mudar o status para Dividido E A unidade deverá ter recebido o valor total da receita

B - Emissão de Notas Fiscais

DADO QUE Existe uma receita Com Pedido de Nota Fiscal E O status está Dividido E O valor foi inteiro para a Unidade QUANDO A rotina de emissão de notas fiscais executar (/job/invoices/pendings) ENTÃO Deve gerar uma nota fiscal para a Unidade com o valor total da receita

8.3. Cenários Modelo 2 - Rotação Parcial de Receitas

8.4. Cenários Modelo 3 - Divisão Percentual de Receitas

9. Vocabulário

9.1. SRP

Saldo a Receber do Profissional ou Pendente Profissional: Pode ser consultado no relatório de repasses.

Caso o valor esteja positivo, significa que o profissional tem valores a receber, ou seja, valores não repassados.

Caso o valor esteja negativo, significa que o profissional tem valores a serem descontados nas próximas receitas, ou seja, o profissional recebeu a mais do que deveria.

Caso o valor esteja zerado, significa que profissional e clínica estão sem pendências, ou seja, os valores repassados estão em conformidade com o valor especificado nos serviços

9.2. VPP

Valor Projetado Profissional: É o valor que o profissional tem direito a receber de cada receita conforme especificado no cadastro do serviço.

Por exemplo: Se o valor do serviço é de R$ 100,00 E o valor de repasse é R$ 60,00 Então o Valor Projetado Profissional será de 60% do valor da receita.

9.3. VPC

Valor Projetado Clínica: É o valor que a clínica tem direito a receber de cada receita conforme especificado no cadastro do serviço. É o valor restante após o repasse para o profissional.

Por exemplo: Se o valor do serviço é de R$ 100,00 E o valor de repasse é R$ 60,00 Então o Valor Projetado Clínica será de 40% do valor da receita.

9.4. SPC

Saldo Pendente Clínica ou Pendente Clínica: É o negativo do Pendente Profissional. Sempre que o SRP estiver positivo, o SPC estará negativo na mesma proporção e vice-versa

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment