> For the complete documentation index, see [llms.txt](https://ajuda.financeiro.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.financeiro.app/guia-completo-3.0/gestao/sistema/integracao-inpeace.md).

# Integração InPeace

Como a integração InPeace importa os pagamentos de eventos para o Contas a receber do Falcon Finanças 3.0, como ativar, acompanhar e resolver pendências.

A **InPeace** é parceira do Falcon Finanças: as igrejas que usam a InPeace acessam o Falcon pelo endereço [inpeace.financeiro.app](https://inpeace.financeiro.app/), com a logo e as cores da InPeace.

A integração traz para o **Contas a receber** os pagamentos de **eventos** feitos pela InPeace (inscrições pagas). Cada pagamento confirmado vira uma receita já recebida, pelo valor líquido, sem digitação. As **doações** não entram na integração.

A integração aparece só nas contas da InPeace, em **Gestão > Sistema**, aba **Integrações**, bloco **Integração InPeace**. Só o **administrador da conta** configura, ativa e desativa.

## Antes de começar

* Peça à InPeace o **UUID da conta financeira**: um código de 36 caracteres, diferente do ID numérico da igreja.
* A InPeace precisa liberar o acesso do Falcon a esse UUID.
* O vínculo vale para a empresa (igreja) aberta no topo da tela. Se a conta tem mais de uma igreja, abra a igreja certa antes.

## Como ativar

1. Em **Gestão > Sistema**, abra a aba **Integrações**.
2. No bloco **Integração InPeace**, informe o **UUID da conta financeira**.
3. Escolha a **Conta financeira**, a **Categoria de receita** e o **Cliente** que vão receber os pagamentos, ou deixe em **Automático** (veja abaixo o que o automático faz).
4. Informe o **Início do histórico**: o primeiro dia das movimentações que serão buscadas na InPeace. A data não pode ser futura.
5. Clique em **Salvar**. Salvar não ativa a importação.
6. Clique em **Conferir prévia**. O Falcon consulta a InPeace e mostra quantos pagamentos de eventos, estornos e doações existem no período e o valor líquido, sem criar nenhuma receita. A prévia vale por 30 minutos.
7. Clique em **Ativar integração** e confirme.

<figure><img src="https://3337761020-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyf74IuhXCfVaITu0Fji%2Fuploads%2Fgit-blob-f220edd85bce46daf0d82d750bdde02feb78a2ab%2F3-0-integracao-inpeace.png?alt=media" alt="Bloco Integração InPeace na aba Integrações, com o UUID da conta financeira, os campos em Automático, o início do histórico, os botões e o estado da integração"><figcaption></figcaption></figure>

A partir daí, a importação roda sozinha no servidor, a cada 5 minutos. Na primeira vez, o histórico é buscado aos poucos (algumas semanas por rodada) até chegar ao dia de hoje; depois, cada rodada traz só o que é novo.

{% hint style="info" %}
Alterar o UUID, a conta, a categoria, o cliente ou o início do histórico desativa a integração. Confira uma nova prévia e ative de novo. As receitas que já foram importadas não são apagadas.
{% endhint %}

## Como os pagamentos entram no Falcon

Cada pagamento confirmado de evento vira uma receita **recebida**, com:

* **Descrição**: "InPeace - " seguido do nome do evento.
* **Valor**: o valor líquido informado pela InPeace (já descontadas as taxas).
* **Data**: a data em que a InPeace registrou o pagamento.
* **Número do documento**: o identificador do pagamento na InPeace.
* **Centro de custo**: um centro de custo por evento, criado na primeira vez com o nome do evento. Assim dá para ver o resultado de cada evento nos relatórios por centro de custo.

Com os campos em **Automático**:

* **Conta financeira**: o Falcon cria e reutiliza uma conta do tipo carteira chamada **INPEACE - TRANSITORIA** (seguida do início do UUID). Ela mostra o que a InPeace confirmou, não o dinheiro que já caiu no banco.
* **Categoria de receita**: os pagamentos de eventos vão para a categoria **EVENTO**, criada se ainda não existir.
* **Cliente**: o pagador é procurado pelo CPF ou CNPJ informado pela InPeace. Se ainda não existe cadastro, ele é criado como cliente. Pagamentos sem um documento válido vão para o cliente **Pagador não identificado**, criado uma única vez na igreja.

{% hint style="warning" %}
A conta transitória não comprova o repasse bancário. Quando a InPeace transferir o dinheiro para a conta da igreja, registre a transferência da conta transitória para a conta do banco, para o saldo das duas ficar certo.
{% endhint %}

## Acompanhar a integração

O quadro **Estado da integração** mostra quantos pagamentos foram **importados**, quantos **estornos** foram baixados e quantas **pendências** existem, além da última tentativa, do último sucesso e até que dia o histórico já foi consultado.

Um mesmo pagamento nunca entra duas vezes: se a InPeace mandar de novo um pagamento que já foi importado, ele é ignorado.

## Pendências

Em **Ver pendências** ficam os movimentos que o Falcon não importou sozinho e que precisam de revisão.

<figure><img src="https://3337761020-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyf74IuhXCfVaITu0Fji%2Fuploads%2Fgit-blob-630a9332cc255e0ba5074aeba4482445bd49a181%2F3-0-integracao-inpeace-pendencias.png?alt=media" alt="Janela Pendências InPeace com a data, o tipo, o valor líquido, o motivo e os identificadores do pagamento e do movimento"><figcaption></figcaption></figure>

Os motivos mais comuns:

| Motivo                                               | O que significa                                                                                                                             |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Estorno aguardando homologação financeira            | A InPeace devolveu o pagamento. A baixa automática de estornos ainda não está liberada; a receita do pagamento original continua recebida.  |
| Estorno não corresponde à confirmação integral ativa | O valor devolvido é diferente do valor recebido (devolução parcial). Ajuste a receita manualmente, se for o caso.                           |
| Confirmação original ausente/pendente                | O estorno chegou, mas o pagamento original não está entre os importados (por exemplo, é anterior ao início do histórico).                   |
| Cadastro de pagador ambíguo ou inativo               | Existe mais de um cadastro com o mesmo CPF/CNPJ, ou o cadastro está inativo. Corrija o cadastro em **Cadastros > Fornecedores e clientes**. |

Depois de corrigir a causa, clique em **Reprocessar pendências**: o Falcon consulta a InPeace de novo a partir da pendência mais antiga, sem duplicar o que já foi importado. Pendências que continuam com o mesmo problema seguem na lista.

### Estornos

Quando a baixa automática de estornos estiver liberada, um estorno **integral** (mesmo valor do pagamento) remove o recebimento e a receita do pagamento original, e o saldo da conta volta ao que era. Estornos parciais continuam pendentes para revisão.

## Desativar

Clique em **Desativar integração** e confirme. As novas importações param; as receitas já importadas continuam no Falcon.

## Dúvidas comuns

### Por que o saldo da conta INPEACE - TRANSITORIA é diferente do que caiu no banco?

A conta transitória soma os pagamentos confirmados pela InPeace. O repasse para o banco acontece depois, nas datas da InPeace, e pode reunir vários pagamentos. Registre cada repasse como transferência para a conta do banco.

### As doações feitas pela InPeace entram no Falcon?

Não. Nesta fase, a integração importa só os pagamentos de eventos. A prévia mostra quantas doações existem no período, mas elas não viram receitas.

### Posso escolher a minha própria conta, categoria ou cliente?

Sim. Escolha nos campos **Conta financeira**, **Categoria de receita** e **Cliente** antes de conferir a prévia. Com um cliente escolhido, todos os pagamentos importados ficam nesse cadastro.