Fiscalização

Conexão de registradores fiscais e gateways em nuvem para conformidade com a legislação tributária.

1. Visão geral#

Fiscalização é uma exigência legal em muitos países: cada transação com o cliente deve ser registrada no sistema tributário e confirmada por um recibo fiscal.

A Cenaly aborda isso de duas formas:

O que é suportado hoje:

Um contorno adjacente, mas diferente — o documento eletrônico com o governo (não o recibo ao cliente):

Kasa fiskalna ≠ KSeF: a primeira é o recibo para pessoa física, a segunda é a fatura para pessoa jurídica. Uma não substitui a outra.

2. Como funciona#

O cliente paga o pedido
       ↓
O Caixa Cenaly reúne os itens, as alíquotas de imposto e as formas de pagamento
       ↓
O recibo é enviado ao registrador fiscal (via ponte) ou ao gateway em nuvem
       ↓
O dispositivo/serviço registra a transação na receita federal
       ↓
O cliente recebe o recibo fiscal

Detalhe importante: o registrador fiscal pertence a você e está registrado com os seus dados fiscais. A Cenaly é o transporte e a fila, não o operador de dados fiscais.

3. Conexão do registrador fiscal via ponte#

Famílias suportadas#

Impressoras de recibo comuns (não fiscais), compatíveis com ESC/POS, são conectadas pela mesma ponte como um dispositivo separado e imprimem pré-recibos, comandas de cozinha e recibos de mercadoria.

Se não houver impressora de recibo na unidade, a conta do cliente (pré-recibo) é impressa pelo próprio registrador fiscal — a largura da linha é obtida do aparelho, para que a coluna de valores não seja cortada. Daisy, ATOL e SHTRIH-M conseguem fazer isso; os Thermal poloneses não imprimem texto livre e recusam honestamente. O registrador fiscal, nesse caso, continua sendo um registrador fiscal: nossos documentos comuns (comandas de cozinha, cópias de recibos) não vão para ele — apenas a impressão de teste e o pré-recibo.

Conexão passo a passo#

Passo 1. Instale a ponte#

Abra Hardware no painel: se a ponte ainda não estiver instalada, a própria página oferecerá o download para o seu sistema operacional — instalador para Windows ou arquivo portátil, para Linux x64/ARM — um comando único de instalação do serviço. A ponte funciona no mesmo computador ao qual o registrador fiscal está conectado.

Passo 2. Conecte o registrador fiscal ao computador#

São suportados porta serial (COM/USB-COM), conexão de rede e spooler de impressão do sistema — depende do modelo. A ponte consegue encontrar o hardware sozinha: o botão de busca automática sugere os dispositivos encontrados, e eles podem ser adicionados à configuração com um clique.

Passo 3. Verifique#

No card do registrador fiscal é possível ver o modelo, o número de série, as alíquotas de imposto, o status do papel e o número do último relatório Z. Ali também estão os botões de impressão de teste, abertura da gaveta de dinheiro e emissão do relatório X.

Para os registradores Daisy, o painel inclui guias separados: como colocar o registrador no modo de impressora fiscal e o que fazer com os erros típicos.

Passo 4. Configure o clichê e as alíquotas#

O botão "Configurações do registrador" abre um editor linha a linha do cabeçalho e do rodapé do recibo, sinalizadores (linhas vazias, separador, logotipo, recibo detalhado), modo de corte, alíquotas de imposto e dados do operador (número, senha, nome).

4. Configuração por país#

🇬🇪 Geórgia — Revenue Service#

Requisitos:

• registrador fiscal cadastrado em rs.ge, com módulo fiscal (testado no Daisy eXpert SX);
• número de identificação (საიდენტიფიკაციო ნომერი).

Configuração:

1. Coloque o registrador fiscal no modo serial "Fiscal printer" (o painel tem um guia com a sequência exata no teclado).
2. Adicione-o na seção Hardware como registrador fiscal.
3. Emita um recibo de teste e tire o relatório Z — os valores devem bater.

Separadamente dos recibos, na Geórgia funciona a seção rs.ge: notas fiscais eletrônicas de mercadorias recebidas de fornecedores, sua confirmação e rejeição, cadastros, verificação do INN e do status de contribuinte de IVA.

🇵🇱 Polônia — kasa fiskalna online#

Desde 2021, restaurantes, bares e cafés são obrigados a ter um caixa online que transmite dados ao CRK (Centralne Repozytorium Kas). Não é possível criar seu próprio caixa virtual sem o certificado GUM, então há dois caminhos:

1. Sua própria impressora fiscal pelo protocolo POSNET Thermal — conectada pela ponte (veja a seção 3). Um único driver cobre a maior parte do parque: Posnet, Emar, Innova, Torell, Elzab Mera. Hoje na Polônia só funciona esse caminho.
2. API de um caixa certificado de terceiros — 🛠 em desenvolvimento. O gateway está escrito, mas sua parte de servidor não está implantada, e ainda não há adaptador para um caixa certificado específico: os caixas virtuais poloneses não têm especificação pública, e os adaptadores (XKasa, WKF, Aclas) são adicionados conforme sua documentação é obtida. Não há card de conexão nas integrações da unidade.

O gateway não inventa a alíquota de IVA: a matriz por canal (comida 8 %, para levar 5 %, café e álcool 23 %) é calculada pela própria plataforma, e o gateway apenas converte o percentual na letra PTU do caixa específico.

KSeF (faturas B2B) — um circuito separado na seção Contrapartes: o XML no formato FA(3) é montado a partir do documento emitido, criptografado e enviado ao sistema do Ministério da Fazenda, e o status e o número UPO retornam para o card.

🇰🇿 Cazaquistão — KKM#

A partir de 01.01.2026, os artigos 110–111 do Código Tributário da República do Cazaquistão exigem recibo de KKM no dia da compra para qualquer pagamento em dinheiro — incluindo cartão no site, Kaspi Pay/QR e Apple/Google Pay.

🛠 A conexão ainda não está disponível. O gateway para o operador de KKM (primeiro driver — Webkassa) está escrito, mas sua parte de servidor não está implantada: não há card de conexão nas integrações da unidade, e hoje não é possível cadastrar os dados. Quando o gateway abrir, ele funcionará assim: dados do operador de KKM → verificação de conexão → o recibo é enviado automaticamente, e o IVA é calculado conforme o regime tributário da unidade. Precisa do Cazaquistão — escreva para o suporte, as prioridades são definidas pela demanda.

🇷🇺 Rússia — 54-FZ#

Dois modos, que podem ser combinados:

• Seu próprio KKT pela ponte — ATOL, Mercury, SHTRIH-M, Pirit/Viki Print. Compatível com FFD 1.05 e 1.2, recibos de correção, marcação Chestny ZNAK, EGAIS UTM.
• Caixa na nuvem — seção API do caixa (Rússia): HTTP-API compatível com o protocolo ATOL Online (v5 = FFD 1.2, v4 = FFD 1.05). Seu site ou CMS envia o recibo em JSON, o serviço o coloca na fila, e o recibo é emitido no seu próprio KKT. O caixa continua sendo seu e está registrado no seu INN — a plataforma é apenas transporte e fila.

Circuitos russos adjacentes: verificação do status dos códigos de marcação Chestny ZNAK e baixa de VSD recebidos no sistema federal Mercury (aba "VSD recebidos" no depósito).

5. Emissão de recibos e relatórios#

No caixa (POS)#

O recibo é emitido no pagamento, na seção Caixa. Lá também: reimpressão (sob PIN do gerente), devolução — total ou parcial, troca com revenda, busca no histórico de recibos e pré-recibo ("conta do cliente" antes do pagamento).

O pré-recibo é impresso na impressora de recibos ou, se não houver uma na unidade, no próprio registrador fiscal (veja a seção 3). Nesse caso, a tarefa não entra na fila da impressora offline: o cliente espera a conta agora, não "quando a impressora voltar".

Na seção "Pedidos"#

Para um pedido online, o recibo pode ser emitido direto do card do pedido — o comando vai pelo canal de nuvem até a ponte da unidade necessária, mesmo que você esteja em outro computador no momento.

Relatórios X e Z#

• Relatório X — intermediário, sem fechar o turno. O botão está tanto na seção Hardware quanto no caixa.
• Relatório Z — fechamento do turno com confirmação; no caixa, ele é combinado com o fechamento do turno de caixa e a conferência real/esperado (faltas e sobras aparecem na hora).

O diário de turnos de caixa fechados — operador de caixa, fundo de troco, vendas em dinheiro e cartão, dinheiro esperado e real, divergências — fica na seção Finanças, aba "Caixa".

Se o recibo não foi emitido#

O caixa é hardware, e ele falha: acabou o papel, o turno não foi fechado, há um recibo aberto no aparelho, passou mais de um dia sem relatório Z. Antes, nesse caso, aparecia uma dica passageira com o texto do driver — dela não dava para entender nem a causa nem o que fazer.

Agora, em vez dela, abre-se a janela "Recibo não emitido": nela está escrito o que exatamente aconteceu e, passo a passo, o que fazer. O caixa é levado em conta pelo seu próprio código de erro, não pela formulação do driver: ele não raro sugere o que não é o caso (em alguns modelos, a dica "mude o modo" vem junto com o código "um dia sem relatório Z", embora o modo esteja certo).

• Se a causa for visível pela nuvem — a janela oferece os botões "Emitir relatório Z" e "Repetir recibo".
• Se o conserto for no próprio aparelho (sem papel, recibo aberto, erro que precisa ser zerado com uma tecla no caixa), a janela diz isso e conduz passo a passo.
• Se for um defeito para o técnico de serviço (modem, SIM, memória), a repetição não é oferecida — não vai adiantar.
• Os detalhes técnicos ficam escondidos na linha "detalhes" — é prático anexá-los a um chamado no suporte.

A janela pode ser fechada a qualquer momento: a venda já foi registrada no histórico de recibos e o pagamento foi processado, e emitir o recibo fiscal novamente pode ser feito de lá mesmo, quando o caixa estiver pronto. A fila não deve esperar.

6. O que é impresso no recibo#

O conteúdo do recibo fiscal é definido pela lei do país, e tudo o que pode ser gerenciado está reunido nas “Configurações do registrador” da seção Hardware:

• linhas do cabeçalho e do rodapé (editor linha a linha);
• logotipo, separador, linhas em branco;
• recibo detalhado ou resumido;
• modo de corte;
• alíquotas de impostos e sua vinculação a grupos;
• dados do operador.

7. Recibos eletrônicos#

• Na Rússia, o recibo eletrônico ao comprador é enviado pelo OFD — por telefone ou e-mail, informados no momento do pagamento; isso faz parte da 54-FZ, e não é uma função separada do painel.
• Independentemente da fiscalização, o Cenaly envia ao cliente a confirmação do pedido e a notificação de pagamento por e-mail, e o cliente pode salvar o link da tela do pedido nos favoritos.
• O e-mail do cliente é coletado no checkout, se você ativou esse campo nas configurações da vitrine.

8. Relatórios para a contabilidade#

O registro de recibos é mantido por cada unidade, e com base nele são gerados:

• Finanças → Caixa — diário de turnos de caixa, dinheiro em espécie, divergências;
• Finanças → Visão geral / Vendas — faturamento, impostos, formas de pagamento, canais;
• Finanças → P&L — relatório simplificado de lucros com despesas manuais;
• Configurações → Exportação de dados — arquivo ZIP com todos os dados da conta, incluindo pedidos e catálogo em CSV (abre no Excel e no “Google Planilhas”) — veja Exportação de dados.

A plataforma não gera exportações nos formatos DSFinV-K e SAF-T — isso faz parte dos contornos alemão e europeu, que ainda não existem.

9. Perguntas frequentes#

A fiscalização é obrigatória?#

Depende do país e do tipo de atividade: na Polônia e na Rússia, a caixa online é obrigatória para o setor de alimentação; no Cazaquistão, a partir de 2026, o recibo de registrador fiscal é exigido em qualquer transação em dinheiro. Consulte seu contador ou a receita federal para saber os requisitos exatos do seu negócio.

É possível trabalhar sem impressora física?#

Hoje, não: os gateways em nuvem do Cazaquistão (Webkassa) e da Polônia (kasa online via API) ainda não estão abertos para conexão, por isso em todos os países suportados é necessário ter um aparelho próprio. Na Rússia, a KKT física é necessária em qualquer caso, mas é possível gerenciá-la da nuvem pela seção “API da caixa” — o computador com a caixa fica em um só lugar, e os recibos são enviados a ele tanto pelo site quanto pelo 1C.

O que fazer em caso de defeito na caixa?#

A ponte mostra honestamente o status do dispositivo e o texto do erro, em vez de “engolir” a falha em silêncio. Enquanto a caixa estiver indisponível, os pedidos e pagamentos continuam ativos no sistema — mas o documento fiscal não será gerado sem uma KKT em funcionamento, e na maioria dos países isso é motivo para suspender as transações e notificar a receita federal.

Como conectar várias caixas?#

O hardware é gerenciado por unidade: cada local tem sua própria ponte (ou várias — universal, para hardware, para câmeras, para telefonia), e no registro de hardware da conta é possível ver todas as pontes e todos os dispositivos de todas as unidades ao mesmo tempo, com atribuição da ponte a unidades adicionais.

Qual é a diferença entre kasa fiskalna e KSeF?#

Kasa fiskalna é o recibo para pessoa física, regulador GUM e KAS, repositório CRK. KSeF é a fatura eletrônica para pessoa jurídica, sistema do Ministério da Fazenda. Documentos diferentes e obrigações diferentes; a existência de um não elimina o outro.

10. Suporte#

• Cenaly: support@cenaly.com → assunto “Fiscalização”
• Para questões de registro de caixas — procure a receita federal do seu país
• Seções relacionadas: Hardware, Caixa (POS), Recibos, rs.ge