TL;DR — Quick Summary
Fix CONTPAQi Nóminas CFDI payroll stamping errors: invalid RFC, payroll complement 1.2, wrong perception codes, PAC timeouts, and SAT cancellation process.
CONTPAQi Nóminas CFDI Payroll Stamping Errors
Stamping payroll receipts (timbrado de recibos de nómina) in CONTPAQi concentrates multiple SAT validations simultaneously: employee data, perception and deduction catalogs, CFDI 4.0 structure with Payroll Complement 1.2, and PAC availability. When the process fails at the end of a pay period, dozens of employees may be left without a valid fiscal receipt and the company faces immediate non-compliance.
The Error
The most frequent error messages in CONTPAQi’s mass stamping screen are:
- “Error al timbrar recibo de nómina” — appears in red next to the employee’s name, usually with a numeric PAC error code.
- “El RFC del trabajador no existe en el SAT” — the RFC fails validation against the SAT’s LRFC taxpayer list.
- “Error en complemento de nómina: campo requerido ausente” — required Payroll Complement 1.2 fields are missing, such as the recipient’s tax regime or the employer’s postal code.
- “Error: el total de percepciones no coincide” — the sum of perception items does not equal the TotalSueldos field in the receipt header.
- “Error al cancelar CFDI de nómina” — when cancelling a previously stamped receipt outside the 72-hour window without requesting recipient acceptance.
Root Cause
Stamping errors in CONTPAQi Nóminas have four main origins:
1. Incomplete or incorrect employee fiscal data. CFDI 4.0 cross-validates the recipient’s RFC against the LRFC. The recipient’s tax regime must be “605 - Wages and Salaries,” and the employer’s postal code in CONTPAQi must match their SAT registration.
2. Perception and deduction codes outside the SAT catalog. Payroll Complement 1.2 requires every perception (salary, overtime, vacation bonus, Christmas bonus) and deduction (IMSS, income tax, loans) to use a code from the SAT-published catalog. Companies that customized concepts in older CONTPAQi versions may have codes that no longer exist.
3. Arithmetic errors in the receipt structure. SAT validates that TotalPercepciones equals the sum of all Percepcion nodes and that NetoPagar is the correct difference. Overtime must include the type (double or triple) and the number of hours.
4. PAC connection issues and timeouts. During mass stamping, the PAC may take more than 30 seconds per receipt. CONTPAQi’s default timeout can mark a receipt as failed even if the PAC processed it correctly, causing duplicates if you retry without checking actual status.
Step-by-Step Solution
Step 1: Pre-stamping validation checklist
| Check | Location | Action if failed |
|---|---|---|
| 13-character RFC | Catalog > Employees | Correct using SAT certificate |
| 18-character CURP | Catalog > Employees | Verify at renapo.gob.mx |
| Tax regime = 605 | Employee fiscal data | Update in employee profile |
| Employer postal code | Configuration > Company | Correct with employer’s SAT certificate |
| Perception/deduction codes | Payroll Concepts | Map to current SAT catalog |
| Valid CSD | Configuration > Certificates | Renew at SAT portal |
| Active PAC credentials | Configuration > PAC | Verify balance and validity |
Step 2: Validate perception and deduction codes
Go to Configuration > Payroll Concepts and review the “SAT Code” column. Common perception codes:
- 001 — Wages and salaries
- 019 — Overtime (double)
- 020 — Overtime (triple)
- 023 — Vacation bonus
- 025 — Christmas bonus (aguinaldo)
Common deduction codes:
- 001 — Social security (IMSS)
- 002 — Income tax (ISR)
- 007 — Loan repayments
- 080 — Child support (pensión alimenticia)
Step 3: Configure the PAC connection
For Facturama: enter the portal username and password, select the “Production” environment, and click “Test connection.” If the test fails, verify the api.facturama.mx domain is not blocked by corporate firewall.
For SW Sapien: configure the API token in the corresponding field. SW Sapien uses token-based authentication — obtain the token from the SW panel at portal.sw.com.mx.
Increase the response timeout to 60 seconds in the PAC settings to prevent false errors during mass stamping.
Step 4: Verify totals before stamping
Run the Pre-payroll Report from Reports > Payroll > Pre-liquidation. Verify that the sum of all individual perception items equals the header total, overtime has the correct type and hours, and terminated employee receipts (finiquito/liquidación) include the employment end date.
Step 5: Mass stamping in controlled batches
In Payroll > Stamp Receipts, filter by department or employee name initial. Process a maximum of 50 employees per batch and confirm each shows “Stamped” status before continuing. For employees with errors, double-click to view the specific PAC error detail, correct the data, and use “Re-stamp selected” for only the failed receipts.
Step 6: Cancellations and re-stamping
- Go to Issued CFDIs > Payroll and find the receipt.
- Click Cancel and select the reason: “01 - Receipt issued with errors with replacement” if generating a substitute, or “02 - Receipt issued with errors without replacement” if not.
- After 72 hours, the system sends a cancellation request to the employee’s SAT tax mailbox — the employee has 3 business days to accept.
- Once cancelled, generate and stamp the corrected receipt.
Alternative Solution
If mass PAC timeouts are the issue, use deferred stamping: export the payroll as XML from CONTPAQi, upload the XMLs directly to your PAC portal (Facturama or SW Sapien), download the stamped XMLs, and use CONTPAQi’s CFDI import option to register them. This avoids the real-time connection bottleneck.
Prevention
- Keep employee records current — update RFC and postal code in CONTPAQi whenever an employee obtains a new tax status certificate.
- Schedule mass stamping during off-peak hours (10:00 PM–6:00 AM) when PACs have higher availability.
- Assign the correct SAT code immediately whenever you add a new payroll concept such as a bonus or commission.
- Review the stamping log file after every mass stamping run to catch error patterns before they accumulate.
Related Issues
| Error | Cause | Quick fix |
|---|---|---|
| ”Invalid employee NSS” | NSS is not 11 digits or does not match IMSS | Verify on IMSS card or IDSE portal |
| ”Date outside fiscal period” | Receipt date precedes the payroll period | Correct the payment date in the period |
| ”Expired CSD certificate” | Issuer’s CSD has expired | Generate a new CSD at SAT portal and reload in CONTPAQi |
| ”SSL connection error” | PAC SSL certificate not recognized | Update Java or .NET Framework on the server |
| ”CURP not registered in RENAPO” | Typographical error in the CURP | Verify at renapo.gob.mx using employee biometric data |
Summary
- Validate RFC, CURP, tax regime 605, and postal code for all employees before mass stamping.
- Verify every perception and deduction concept uses a valid code from the current SAT catalog.
- Set PAC timeout to 60 seconds and stamp in batches of no more than 50 employees.
- Run the pre-payroll report to confirm perception totals match before stamping.
- For cancellations after 72 hours, select the correct reason and await employee acceptance via SAT tax mailbox.