TL;DR — Resumo Rápido
Resolva erros de carimbo CFDI no CONTPAQi Nóminas: RFC inválido, complemento de folha 1.2, códigos de percepção incorretos, timeout do PAC e cancelamento SAT.
Erros no Carimbo de Recibos de Salário CFDI no CONTPAQi
O carimbo de recibos de salário no CONTPAQi concentra múltiplas validações do SAT ao mesmo tempo: dados do funcionário, catálogos de percepções e deduções, estrutura do CFDI 4.0 com Complemento de Folha 1.2, e a disponibilidade do PAC. Quando falha no fechamento do período de pagamento, dezenas de funcionários podem ficar sem recibo fiscal e a empresa enfrenta inadimplência fiscal imediata.
O Erro
As mensagens de erro mais frequentes na tela de carimbo em massa do CONTPAQi Nóminas são:
- “Error al timbrar recibo de nómina” — aparece em vermelho ao lado do nome do funcionário, geralmente com um código numérico do PAC.
- “El RFC del trabajador no existe en el SAT” — o RFC não passa na validação contra a lista LRFC do SAT.
- “Error en complemento de nómina: campo requerido ausente” — campos obrigatórios do Complemento de Folha 1.2 estão ausentes, como o regime fiscal do receptor ou o CEP do domicílio fiscal.
- “Error: el total de percepciones no coincide” — a soma dos conceitos de percepção não é igual ao campo TotalSueldos do cabeçalho.
- “Error al cancelar CFDI de nómina” — ao tentar cancelar um recibo já carimbado fora da janela de 72 horas sem solicitar aceitação do receptor.
Causa do Problema
Os erros de carimbo no CONTPAQi Nóminas têm quatro origens principais:
1. Dados fiscais do funcionário incompletos ou incorretos. Com o CFDI 4.0, o SAT cruza as validações do receptor com a LRFC. O RFC deve existir no cadastro, o regime fiscal do receptor deve ser “605 - Sueldos y Salarios”, e o CEP do domicílio fiscal do emissor deve coincidir com o registrado no SAT.
2. Códigos de percepção e dedução fora do catálogo SAT. O Complemento de Folha 1.2 exige que cada conceito de percepção e dedução use um código do catálogo publicado pelo SAT. Empresas que personalizaram conceitos em versões antigas do CONTPAQi podem ter códigos que não existem mais.
3. Erros aritméticos na estrutura do recibo. O SAT valida que TotalPercepciones seja igual à soma de todos os nós Percepcion e que NetoPagar seja a diferença correta. As horas extras devem incluir o tipo (dupla ou tripla) e a quantidade de horas.
4. Problemas de conexão com o PAC e timeouts. Durante o carimbo em massa, o PAC pode levar mais de 30 segundos por recibo. O timeout padrão do CONTPAQi pode marcar o recibo como erro mesmo que o PAC o tenha processado corretamente, gerando duplicidades ao tentar recarimbar.
Solução Passo a Passo
Passo 1: Lista de verificação antes do carimbo
| Verificação | Localização | Ação se falhar |
|---|---|---|
| RFC com 13 caracteres | Catálogo > Funcionários | Corrigir com certidão SAT |
| CURP com 18 caracteres | Catálogo > Funcionários | Verificar no RENAPO |
| Regime fiscal = 605 | Dados fiscais do funcionário | Atualizar na ficha do funcionário |
| CEP do emissor | Configuração > Empresa | Corrigir com certidão SAT do empregador |
| Códigos de percepção/dedução | Conceitos de Folha | Mapear ao catálogo SAT vigente |
| CSD vigente | Configuração > Certificados | Renovar no portal SAT |
| Credenciais PAC ativas | Configuração > PAC | Verificar saldo e vigência |
Passo 2: Validar códigos de percepção e dedução
Acesse Configuração > Conceitos de Folha e revise a coluna “Código SAT”. Percepções comuns:
- 001 — Salários e jornais
- 019 — Horas extras (dupla)
- 020 — Horas extras (tripla)
- 023 — Bônus de férias
- 025 — 13º salário (aguinaldo)
Deduções comuns:
- 001 — Previdência social (IMSS)
- 002 — Imposto de renda (ISR)
- 007 — Descontos por empréstimos
- 080 — Pensão alimentícia
Passo 3: Configurar a conexão com o PAC
Para Facturama: insira o usuário e senha do portal, selecione o ambiente “Produção” e clique em “Testar conexão.” Se falhar, verifique que o domínio api.facturama.mx não esteja bloqueado pelo firewall corporativo.
Para SW Sapien: configure o token de API no campo correspondente. O token é obtido no painel SW em portal.sw.com.mx.
Aumente o timeout de resposta para 60 segundos na configuração do PAC para evitar falsos erros durante o carimbo em massa.
Passo 4: Verificar totais antes de carimbar
Execute o Relatório de Pré-Folha em Relatórios > Folha > Pré-liquidação. Verifique que a soma das percepções individuais seja igual ao total do cabeçalho, as horas extras tenham tipo e quantidade corretos, e os recibos de funcionários desligados incluam a data de encerramento do vínculo.
Passo 5: Carimbo em massa em lotes controlados
Em Folha > Carimbar Recibos, filtre por departamento ou inicial do sobrenome. Processe no máximo 50 funcionários por lote. Para funcionários com erro, clique duas vezes para ver o detalhe do erro do PAC, corrija o dado e use “Recarimbar selecionados.”
Passo 6: Cancelamentos e recarimbo
- Vá a CFDIs Emitidos > Folha e localize o recibo.
- Clique em Cancelar e selecione: “01 - com substituto” se gerará novo recibo, ou “02 - sem substituto” se não haverá substituto.
- Após 72 horas, o sistema envia solicitação à caixa postal tributária do funcionário — ele tem 3 dias úteis para aceitar.
- Após cancelado, gere e carimbe o novo recibo corrigido.
Solução Alternativa
Se o problema for timeout em massa do PAC, use o carimbo diferido: exporte a folha em formato XML do CONTPAQi, suba os XMLs diretamente ao portal do seu PAC, baixe os XMLs carimbados e use a opção de importação de CFDI no CONTPAQi para registrá-los. Este método evita o gargalo da conexão em tempo real.
Prevenção
- Mantenha o cadastro de funcionários atualizado — atualize RFC e CEP no CONTPAQi sempre que um funcionário obtiver nova certidão de situação fiscal.
- Programe o carimbo em massa em horários de menor demanda (22h–6h), quando os PACs têm maior disponibilidade.
- Atribua o código SAT correto imediatamente ao adicionar um novo conceito de folha.
- Revise o log de carimbo após cada processo em massa para identificar padrões de erro.
Problemas Relacionados
| Erro | Causa | Solução rápida |
|---|---|---|
| ”NSS do funcionário inválido” | NSS sem 11 dígitos ou diferente do IMSS | Verificar no cartão IMSS ou portal IDSE |
| ”Data fora do período fiscal” | O recibo tem data anterior ao período | Corrigir a data de pagamento no período |
| ”Certificado CSD expirado” | O CSD do emissor venceu | Gerar novo CSD no portal SAT e carregar no CONTPAQi |
| ”Erro de conexão SSL” | Certificado SSL do PAC não reconhecido | Atualizar Java ou .NET Framework no servidor |
| ”CURP não registrada no RENAPO” | Erro tipográfico no CURP | Verificar em renapo.gob.mx |
Resumo
- Valide RFC, CURP, regime fiscal 605 e CEP de todos os funcionários antes do carimbo em massa.
- Verifique que cada conceito de percepção e dedução use um código válido do catálogo SAT vigente.
- Configure o timeout do PAC em 60 segundos e carimbe em lotes de no máximo 50 funcionários.
- Confira os totais de percepções com o relatório de pré-folha antes de carimbar.
- Para cancelamentos após 72 horas, selecione o motivo correto e aguarde aceitação do funcionário.