Maquininhas de cartão
Traz para o financeiro as vendas passadas na maquininha da Stone, do PagBank, da Rede, da Getnet ou da Cielo. Cada venda entra como lançamento de receita, com uma conta a receber por parcela na data prevista, e a parcela é baixada quando o depósito cai na conta.
Use esta importação quando as vendas da maquininha não forem lançadas no CleanFin de outra forma (pelo PDV ou pela venda). Senão, a receita entra em dobro.
Como funciona
- Você cadastra a integração da maquininha com os números dos estabelecimentos e a conta que recebe os depósitos.
- Você conecta: cada maquininha tem o seu jeito (chave, token, aprovação no portal ou extrato enviado ao CleanFin).
- A partir daí, as vendas, as parcelas e os depósitos entram sozinhos, todo dia, a partir da data que você escolheu.
Cada maquininha tem uma integração por empresa: se você tem vários estabelecimentos na mesma maquininha, informe todos na mesma integração, separados por vírgula.
Cadastrar a integração
- Abra Serviços de terceiros e clique em Novo
Em IntegraçõesServiços de terceiros.
- Escolha a maquininha em Tipo de Integração
Aparecem duas partes: Conexão com a maquininha e Importação das vendas. O apelido já vem com o nome da maquininha.
- Preencha a conexão
O documento do titular e os números dos estabelecimentos. O que cada maquininha pede está na tabela mais abaixo.
- Preencha a importação das vendas
A conta que recebe os depósitos, a data a partir da qual importar e como as taxas entram no financeiro.
- Salve no ✓ verde
A janela continua aberta depois de salvar, já com o botão para o próximo passo.
- Conecte
Clique em Pedir aprovação por e-mail ou Testar acesso (Stone), Testar acesso (PagBank), Pedir acesso à Rede, Conectar Cielo ou Conferir recebimento (Getnet e Cielo). O sistema avisa o resultado numa mensagem.
O que cada maquininha pede
| Maquininha | O que informar | Como conectar |
|---|---|---|
| Stone | Stonecodes: todos os da empresa, separados por vírgula. Loja credenciada na Stone desde setembro de 2026 pode não ter Stonecode: deixe em branco. | Duas formas. Aprovação por e-mail (recomendado): o titular não gera chave; depois de salvar, clique em Pedir aprovação por e-mail, e a Stone manda ao e-mail principal do primeiro Stonecode a mensagem "Conciliação Stone - Solicitação de acesso por CleanFin". Aprovado, a integração liga sozinha; se o e-mail não chegar, use Reenviar o e-mail. Chave do Portal Stone: o titular gera a chave em Perfil › Chaves de Autenticação › Criar Chave › API de Conciliação Stone e, depois de salvar, Testar acesso. As vendas por Pix também entram, já pagas no dia. Enquanto não há aprovação nem chave, as vendas entram pelas planilhas do portal (veja abaixo). |
| PagBank | Números de estabelecimento e o Token do extrato EDI. | O titular pede o token ao PagBank, pelo portal de atendimento, em Novas Ativações - EDI (com vários estabelecimentos, peça o modelo 1xN). O token chega por e-mail em até 2 dias úteis. Depois de salvar, Testar acesso. |
| Rede | PVs (números de estabelecimento na Rede). | Não tem chave. Depois de salvar, Pedir acesso à Rede: o titular aprova no Portal Rede. Aprovado, a importação começa sozinha em até uma hora. |
| Getnet | Códigos de estabelecimento e o Protocolo do pedido do extrato, opcional. | Não tem chave. O titular habilita o Extrato Eletrônico no portal Minha Conta, escolhendo o conciliador Outros e copiando os dados que a tela mostra. A Getnet leva até 7 dias úteis para começar a enviar. Conferir recebimento confere se o extrato já chegou. |
| Cielo | Só o documento do titular: os estabelecimentos vêm da autorização. | Depois de salvar, Conectar Cielo: o titular entra na Cielo, escolhe os estabelecimentos e clica em Permitir acesso. A Cielo começa a enviar os arquivos no dia seguinte. |
O quadro azul de cada maquininha, dentro do formulário, traz o caminho exato no portal dela.
Algumas maquininhas precisam liberar o CleanFin antes da primeira conexão. Enquanto isso, o formulário mostra um aviso amarelo: dá para salvar a integração e deixar a importação configurada, e a conexão aparece ali quando a liberação sair.
Importação das vendas
| Taxas da maquininha | Como fica no financeiro |
|---|---|
| Separada e amarrada à venda | A taxa vira uma despesa própria de cada venda. É o padrão. |
| Fechamento diário, por dia do pagamento | As taxas viram um lançamento por dia de pagamento, para cada conta. |
| Fechamento diário, consolidado na operação | As taxas viram um lançamento só para cada conta, com a data do fechamento. |
| Embutida no recebimento | A taxa é descontada do próprio recebimento, sem despesa separada. |
Acompanhar as importações
Depois de salva, a integração mostra as Últimas importações, cada uma com a data e a situação (Concluída ou Com pendência) e o resumo do que entrou.
| Botão | Para que serve |
|---|---|
| Importar agora | Traz já o que a maquininha tem, sem esperar a importação automática. |
| Reimportar a partir de... | Lê de novo o movimento a partir do dia escolhido. O que já entrou não duplica, e as parcelas que ficaram para conferir são baixadas se você já corrigiu o cadastro (a conta do depósito, por exemplo). |
| Enviar planilhas do portal | Stone e Rede: envia as planilhas de vendas e de recebimentos (ou de pagamentos e ajustes, na Rede) baixadas do portal, em CSV, várias de uma vez. É o caminho enquanto a conexão automática não sai. Uma linha que não se lê recusa o envio inteiro. |
| Atualizar / Ver todas | Recarrega a lista das importações ou abre todas, nos Logs de integrações. |
A importação automática roda todo dia. A Rede tem dois dias de defasagem (ela fecha o movimento do dia depois); as outras, um dia. Na Getnet e na Cielo, a importação roda a cada arquivo que chega ao CleanFin.
Dúvidas comuns
"Este contrato já tem uma integração Stone" ao salvar
Cada maquininha tem uma integração só por empresa. Abra a que já existe e acrescente os estabelecimentos nela, separados por vírgula.
A Cielo parou de mandar os arquivos
A autorização do extrato na Cielo vale um ano. Renove no Site Cielo, em Vendas e Recebíveis › Extrato Eletrônico › Visão geral | Permissões › Estender validade, e depois clique em Conectar Cielo de novo na integração. A gestão é avisada 30, 7 e 1 dia antes de vencer, e também se o extrato parar de chegar.
Uma importação ficou "Com pendência"
Leia o resumo da importação: ele diz o que ficou para conferir. Corrija o cadastro (a conta do depósito, por exemplo) e use Reimportar a partir de... com o dia da pendência: o que já entrou não duplica, e as parcelas que ficaram para conferir são baixadas.