Como configurar e emitir notas com retenção de PIS/COFINS (Nota Gateway)

Módulo: Configuração › Cadastros
Caminho de acesso: Menu Principal › Configuração › Cadastros › Impostos
Versão mínima: 4.35b612 ou superior

O que é e para que serve

Este artigo explica como configurar o Sankhya Om para calcular e enviar corretamente as retenções de PIS e COFINS na emissão de notas fiscais de serviço via Nota Gateway. O procedimento garante que as notas sejam autorizadas na prefeitura sem rejeições por falta de tags fiscais, cobrindo tanto o cenário de retenção direta na nota quanto a retenção via módulo Financeiro. O artigo não cobre a configuração geral de impostos no sistema — apenas as parametrizações específicas para retenção de PIS e COFINS.

Antes de começar

• Permissões necessárias: acesso às telas de Impostos, Central de Vendas e Portal de Vendas.
• Configurações relacionadas: Tipo de Operação (TOP) vinculado e autorizado a calcular a retenção, configurada na aba TOP do cadastro de impostos.

Como funciona a hierarquia de envio (nota x financeiro)

O sistema possui uma lógica automática para montar o arquivo enviado à prefeitura. Ele busca os dados de retenção respeitando a seguinte ordem:

1. Prioridade na nota: o sistema verifica se a aba Outros Impostos possui PIS/COFINS retido. Se sim, envia esses valores.
2. Busca no financeiro: se a nota não possuir o imposto destacado, o sistema busca automaticamente no título gerado no módulo Financeiro. Se encontrar a retenção lá, preenche as tags corretamente e envia a nota.

Passo a passo: parametrização dos impostos

Para que o sistema saiba onde aplicar a retenção (na nota ou no financeiro), configure as regras no cadastro de impostos.

1. Acesse a tela Impostos.
2. Selecione ou crie o imposto desejado (ex: PIS ou COFINS).
3. No painel principal, preencha as definições gerais (Nome, Tipo, Base para impostos).
4. Navegue até as abas inferiores (Empresa, Parceiro e Serviço).
5. Preencha as alíquotas e defina o local da retenção conforme o cenário:

Para reter na nota fiscal:

• Na aba Serviço, no campo Na Nota, selecione Subtrair.
• No campo No Financeiro de Origem Estoque, selecione Nenhum. Com essa configuração, o valor da nota na Central passa a representar o valor do serviço com a dedução dos impostos retidos, enquanto no financeiro é considerado o valor líquido.

Para reter apenas no financeiro:

• No campo Na Nota, selecione Incluso.
• No campo No Financeiro de Origem Estoque, selecione Subtrair. Com essa configuração, o valor da nota na Central passa a representar o valor do serviço sem a dedução dos impostos retidos, enquanto no financeiro é considerado o valor bruto, com os impostos devidamente provisionados.

Passo a passo: emissão na Central de Vendas

Após a parametrização, realize a emissão normalmente:

1. Acesse a Central de Vendas.
2. Lance o cabeçalho informando a Empresa, Parceiro e TOP configurados.
3. Insira o item (Serviço) e confirme.
4. Para validar se o cálculo ocorreu na nota, selecione o item inserido, acesse as opções secundárias da grade de itens e clique em Outros Impostos Item da Nota.
5. Verifique se os impostos aparecem com o Tipo Imposto igual a Retido e com os valores corretos de Base, Alíquota e Valor.

Resultado esperado

1. Acesse o Portal de Vendas e aprove a nota fiscal.
2. O sistema acionará a integração.
3. O arquivo JSON gerado nos bastidores conterá as tags obrigatórias preenchidas corretamente (ex: "tipoRetencaoPisCofins": "PisCofinsRetido"), acompanhadas dos valores exatos de PIS e COFINS, garantindo a aprovação do documento na prefeitura sem falhas de integração.