TL;DR — Quick Summary

CONTPAQi Comercial payment complement errors: fix PPD flow, wrong UUID, exceeded balance, exchange rate, multi-invoice payments and complement cancellation.

Payment complement errors in CONTPAQi Comercial are a persistent frustration for accountants and administrators in Mexico. From the “Error generating payment complement” message to PAC rejections due to incorrect dates, these issues block accounts receivable workflows and can lead to tax inconsistencies. This article covers all the most frequent errors in CFDI payment receipt processing in CONTPAQi Comercial and how to fix them.

The Error

CONTPAQi Comercial can display several error messages when working with payment complements in the accounts receivable payment receipt module:

  • “Error generating payment complement” — generic error when attempting to create the complement from the payment record
  • “Error: payment amount exceeds pending balance” — the entered amount exceeds the invoice outstanding balance
  • “Error stamping payment complement: payment date is prior to the related document date” — PAC rejects the complement because the collection date precedes the source invoice
  • “Error: incorrect payment form” — the SAT catalog key does not correspond to the payment method used
  • “Related invoice UUID not found” — the referenced fiscal folio does not exist or does not match
  • “Exchange rate error: value out of range” — the captured exchange rate for foreign currency payments is not valid
  • “Distribution error: applied amounts do not equal total payment” — in multi-invoice payment, partial amounts do not add up
  • “Error canceling payment complement” — failure when trying to cancel and replace an already-stamped complement

These errors appear in the Accounts Receivable > Payment Receipts module when recording a collection or running the complement stamping process.

Root Cause

The payment complement flow requires several data points to match precisely between the source invoice and the payment receipt document. Errors arise when any of these elements do not align.

Invoice with incorrect payment method. Only invoices issued with PPD (Deferred Payment) require a payment complement. If an invoice was issued with PUE (Single Payment), no complement is needed — apply the payment directly in accounts receivable. Confusing both methods is the leading cause of errors.

Incorrect UUID in the related document. The payment complement must reference the exact UUID of the invoice being settled. If the system points to the wrong UUID — for example, from a canceled version of the invoice — the PAC will reject stamping.

Out-of-sync outstanding balance. For partial payments, the system must correctly calculate the pending balance after each installment. If a previous payment was recorded incorrectly or voided without updating the balance, the next payment may exceed the allowed amount.

Exchange rate out of range or incorrect. When paying a USD invoice with Mexican pesos, the exchange rate must match the rate published in the DOF for the payment date. A manually entered rate with an error or outdated information causes rejection.

Payment date prior to invoice date. The SAT does not allow the payment receipt date to be earlier than the original invoice issue date. This error occurs when a collection is backdated.

Incorrect distribution in multi-invoice payment. When a single collection settles multiple invoices, the sum of amounts assigned to each invoice must be exactly equal to the total payment. Cent-level differences due to exchange rate rounding are a frequent cause.

Invalid payment form. The SAT payment form catalog is specific: 01 Cash, 02 Nominative check, 03 Electronic transfer, 04 Credit card, 28 Debit card, among others. An incorrect code or one that does not match the actual payment method causes rejection.

Step-by-Step Solution

1. Verify the payment method on the source invoice

Before recording any payment, open the invoice in CONTPAQi Comercial and check the Payment Method field:

  • PPD — requires a payment complement for each collection received
  • PUE — no complement needed; apply the payment directly in accounts receivable

If the invoice has PUE but the customer paid in installments, the correct solution is to cancel the invoice (reason 01) and reissue it with PPD before recording the collections.

2. Record the payment receipt with complete data

Go to Accounts Receivable > Payment Receipts > New receipt and enter:

  1. Customer — RFC and name exactly as they appear on the invoice
  2. Payment date — actual date the money was received (same as or after the invoice date)
  3. Payment form — correct SAT catalog key matching the method used
  4. Currency — MXN, USD or other as the payment was actually received
  5. Exchange rate — if currency is not MXN, enter the DOF rate for the payment date
  6. Total amount received — exact amount collected

3. Apply the payment to the PPD invoices

In the Related documents section:

  • Select the pending PPD invoice(s) for that customer
  • Confirm the displayed UUID matches the invoice fiscal folio (you can verify by opening the invoice XML in parallel)
  • Enter the amount to apply to each invoice, without exceeding the outstanding balance shown
  • The installment number updates automatically; verify it is sequential (1, 2, 3…)

4. Validate distribution in multi-invoice payment

If the collection covers more than one invoice:

  1. Assign amounts to each invoice within the same payment receipt screen
  2. Verify the sum of all assigned amounts is exactly equal to the total payment
  3. If there is a discrepancy due to exchange rate rounding, adjust the amount on one invoice so the total matches to the cent
  4. The system should show a zero remaining balance before allowing stamping

5. Stamp the complement with the PAC

Once the payment receipt is saved:

  1. Select the record and choose Stamp payment complement
  2. If the PAC rejects due to date, correct the payment date to the actual receipt date
  3. If rejected for payment form, verify the SAT catalog key and correct it
  4. If rejected for exchange rate, consult the DOF for the payment date and update the value
  5. Retry stamping until you receive the fiscal folio for the complement

6. Reconcile in accounts receivable

After successful stamping:

  1. Go to Accounts Receivable > Customer statement
  2. Confirm the invoice balance was reduced by the complement amount
  3. If the invoice balance is zero, it will appear as settled
  4. Download and archive the complement XML alongside the original invoice XML

Alternative Solution

If the error persists after following the steps above, there is an alternative route to record the payment without blocking the accounts receivable workflow:

  1. Record the collection manually in the Cash/Bank module without linking it to the PPD invoice
  2. Apply the advance against the invoice from Accounts Receivable > Advance Application to update the balance
  3. Generate the complement directly from the invoice using the Generate payment complement from document option, which in some CONTPAQi Comercial versions allows forcing generation with verified data

This route is useful when the problem is in payment receipt configuration and you need to keep operations running while working with CONTPAQi support.

Complement Cancellation and Replacement

When a stamped complement already exists with errors, the cancellation process is more delicate:

  1. Locate the complement in Accounts Receivable > Payment Receipts
  2. Select Cancel CFDI and choose Reason 01 — document issued with errors with relation
  3. Enter the UUID of the new complement that will replace it (you can leave it blank if it does not exist yet; the receiver will accept it later)
  4. Wait for the receiver’s acceptance: they have 72 hours to accept or reject the cancellation from the SAT portal
  5. Once the cancellation is accepted, correct the data in the payment receipt and stamp the new complement
  6. Verify the invoice balance was restored correctly before applying the new complement

Important: Do not cancel a complement without first verifying the receiver has not already deducted the VAT. Cancellation can create inconsistencies in the customer’s accounting records.

Prevention

To avoid payment complement errors in the future:

  • Set the correct payment method when invoicing. If the customer pays in installments, always use PPD. If they pay at the time of purchase, use PUE.
  • Record payments on the same day they are received. The payment date must match the actual collection date; do not backdate payments prior to the invoice.
  • Check the DOF exchange rate before entering USD payments. Use the rate published by Banxico/DOF for the exact date of payment.
  • Verify the outstanding balance before each receipt. Open the customer statement in CONTPAQi before recording to confirm exactly how much remains pending.
  • Update CONTPAQi Comercial regularly. The SAT updates payment form and currency catalogs; without recent updates your system may have outdated codes.
  • Configure balance alerts. Enable notifications in CONTPAQi for PPD invoices with pending balance so no collection goes without its corresponding complement.

The system does not automatically generate the complement when recording a payment. This occurs when the payment receipt module is not configured to generate and stamp the complement in the same process. Go to Settings > Accounts receivable parameters and enable automatic payment complement generation when recording collections on PPD invoices.

Accounts receivable discrepancy after stamping the complement. If the invoice balance does not decrease after the complement, the payment may be applied as an advance rather than linked to the invoice. Check the advances module and apply it manually to the corresponding PPD invoice.

Error importing the complement into CONTPAQi Contabilidad. The CFDI payment complement can be automatically imported into accounting entries. If the import fails, verify the complement UUID matches in both systems and the exchange rate is consistent with the collection journal entry.

PAC rejection for invalid RFC in the complement. With CFDI 4.0, both the issuer and receiver RFC are validated in real time against the SAT registry. Any discrepancy causes rejection. Verify both RFCs are correct and the receiver is not on the SAT 69-B list (taxpayers with non-existent operations).

Summary

  • Only invoices with PPD payment method require a payment complement; PUE invoices do not generate complements
  • The referenced invoice UUID must be exact; an incorrect UUID causes immediate PAC rejection
  • The applied amount cannot exceed the outstanding balance; verify prior installments before each payment
  • For USD-to-MXN payments, use the DOF exchange rate for the exact date of collection
  • For multi-invoice payments, the sum of distributed amounts must equal exactly the total received
  • The payment date cannot be earlier than the source invoice issue date
  • To cancel a complement with errors, use cancellation reason 01 and reference the substitute complement UUID
  • Always reconcile the stamped complement against the accounts receivable balance to avoid accounting discrepancies