> ## Documentation Index
> Fetch the complete documentation index at: https://docs.transitive.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Failure codes

> The failure codes, in groups.

A failure code tells you why Transitive did not complete a step. The app shows the code next to the failure. Each code has a page that tells you what it means and how to correct it.

* A failure that stops the stamp changes the status to **Failed**.
* A failure of a cancellation changes the status to **Cancellation didn't go through**. The CFDI stays valid.
* A failure of a CargoWise delivery shows on the timeline. The status does not change.

When the stamping provider rejects a document, the timeline also shows the code and the message of the provider. Use them to find the incorrect value.

The codes are in groups. Each group is about the same data or the same step.

| Group | What it is about | Codes |
| - | - | - |
| [Invoices](/reference/failures/overview#invoices) | The amounts, the taxes, the lines and the payment method of an invoice. | 10 |
| [Currency and exchange rates](/reference/failures/overview#currency-and-exchange-rates) | The currency and the exchange rate of a document or a payment. | 4 |
| [Payment complements](/reference/failures/overview#payment-complements) | The receipt, its payments and the invoices that it pays. The payment complement (REP) uses these data. | 27 |
| [Credit notes](/reference/failures/overview#credit-notes) | A credit note and the invoice that it credits. | 6 |
| [Related documents](/reference/failures/overview#related-documents) | A document that this document refers to, for example the invoice of a credit note. | 7 |
| [Receipt reversals](/reference/failures/overview#receipt-reversals) | A CargoWise reversal and the receipt that it reverses. | 2 |
| [Issuer](/reference/failures/overview#issuer) | The company and the RFC that issue the CFDI. | 2 |
| [SAT and stamping provider](/reference/failures/overview#sat-and-stamping-provider) | The stamping provider (PAC) or the SAT did not accept the document. | 13 |
| [Transitive processing](/reference/failures/overview#transitive-processing) | Transitive could not complete a step with its own records. | 7 |
| [Cancellations](/reference/failures/overview#cancellations) | A cancellation request did not cancel the CFDI. The CFDI stays valid. | 3 |
| [CargoWise delivery](/reference/failures/overview#cargowise-delivery) | Transitive did not deliver the CFDI files to CargoWise. The CFDI is not affected. | 5 |

## Invoices

The amounts, the taxes, the lines and the payment method of an invoice.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`income_subtotal_mismatch`](/reference/failures/income_subtotal_mismatch) | Invoice subtotal does not match its lines | **Failed** status |
| [`income_vat_total_mismatch`](/reference/failures/income_vat_total_mismatch) | Invoice VAT does not match its lines | **Failed** status |
| [`income_line_vat_mismatch`](/reference/failures/income_line_vat_mismatch) | A line's VAT does not match its rate | **Failed** status |
| [`income_total_mismatch`](/reference/failures/income_total_mismatch) | Invoice total does not match its lines | **Failed** status |
| [`income_line_tax_missing`](/reference/failures/income_line_tax_missing) | A line has no VAT | **Failed** status |
| [`income_vat_without_line_taxes`](/reference/failures/income_vat_without_line_taxes) | Invoice VAT has no taxed lines | **Failed** status |
| [`income_line_product_key_missing`](/reference/failures/income_line_product_key_missing) | A line has no SAT product key | **Failed** status |
| [`payment_method_missing`](/reference/failures/payment_method_missing) | Payment method is missing | **Failed** status |
| [`payment_method_conflict`](/reference/failures/payment_method_conflict) | Payment methods conflict | **Failed** status |
| [`payment_method_fields_exceeded`](/reference/failures/payment_method_fields_exceeded) | Too many payment method fields | **Failed** status |

## Currency and exchange rates

The currency and the exchange rate of a document or a payment.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`exchange_rate_mismatch`](/reference/failures/exchange_rate_mismatch) | Exchange rate does not match the totals | **Failed** status |
| [`exchange_rate_missing`](/reference/failures/exchange_rate_missing) | Exchange rate is missing | **Failed** status |
| [`local_currency_not_mxn`](/reference/failures/local_currency_not_mxn) | Local currency is not MXN | **Failed** status |
| [`payment_conversion_unresolved`](/reference/failures/payment_conversion_unresolved) | Payment cannot be converted to the invoice currency | **Failed** status |

## Payment complements

The receipt, its payments and the invoices that it pays. The payment complement (REP) uses these data.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`payment_date_missing`](/reference/failures/payment_date_missing) | Payment date is missing | **Failed** status |
| [`receipt_total_missing`](/reference/failures/receipt_total_missing) | Receipt total is missing | **Failed** status |
| [`payment_form_missing`](/reference/failures/payment_form_missing) | Payment form is missing | **Failed** status |
| [`payment_basis_ambiguous`](/reference/failures/payment_basis_ambiguous) | Receipt amount is ambiguous | **Failed** status |
| [`receipt_debtor_ambiguous`](/reference/failures/receipt_debtor_ambiguous) | Receipt has more than one debtor | **Failed** status |
| [`receipt_uuid_conflict`](/reference/failures/receipt_uuid_conflict) | Receipt has more than one SAT UUID | **Failed** status |
| [`payment_has_no_applications`](/reference/failures/payment_has_no_applications) | Payment is not applied to any invoice | **Failed** status |
| [`payment_line_amount_missing`](/reference/failures/payment_line_amount_missing) | Amount applied to an invoice is missing | **Failed** status |
| [`payment_lines_unmapped`](/reference/failures/payment_lines_unmapped) | Some receipt lines could not be read | **Failed** status |
| [`parent_currency_missing`](/reference/failures/parent_currency_missing) | Invoice currency is missing | **Failed** status |
| [`payment_line_amount_invalid`](/reference/failures/payment_line_amount_invalid) | Amount applied to an invoice is invalid | **Failed** status |
| [`parent_applied_twice`](/reference/failures/parent_applied_twice) | Invoice is applied twice | **Failed** status |
| [`payment_exceeds_parent_balance`](/reference/failures/payment_exceeds_parent_balance) | Payment exceeds the invoice balance | **Failed** status |
| [`rep_applications_exceed_total`](/reference/failures/rep_applications_exceed_total) | Applied amounts exceed the receipt total | **Failed** status |
| [`rep_amount_unassigned`](/reference/failures/rep_amount_unassigned) | Part of the receipt is not applied | **Failed** status |
| [`settlement_contribution_unapplied`](/reference/failures/settlement_contribution_unapplied) | Settlement contribution is not applied | **Failed** status |
| [`payment_entry_without_contribution`](/reference/failures/payment_entry_without_contribution) | Payment names an unknown contribution | **Failed** status |
| [`settlement_contribution_invalid`](/reference/failures/settlement_contribution_invalid) | Settlement contribution amount is invalid | **Failed** status |
| [`parent_balance_mismatch`](/reference/failures/parent_balance_mismatch) | Invoice balance does not match its payments | **Failed** status |
| [`parent_balance_evidence_missing`](/reference/failures/parent_balance_evidence_missing) | Invoice balance cannot be proven | **Failed** status |
| [`payment_tax_base_mismatch`](/reference/failures/payment_tax_base_mismatch) | Payment tax base does not match the invoice | **Failed** status |
| [`payment_tax_evidence_missing`](/reference/failures/payment_tax_evidence_missing) | Payment taxes are missing | **Failed** status |
| [`parent_total_differs_from_cfdi`](/reference/failures/parent_total_differs_from_cfdi) | Invoice total does not match its CFDI | **Failed** status |
| [`parent_currency_differs_from_cfdi`](/reference/failures/parent_currency_differs_from_cfdi) | Invoice currency does not match its CFDI | **Failed** status |
| [`parent_tax_differs_from_cfdi`](/reference/failures/parent_tax_differs_from_cfdi) | Invoice taxes cannot be carried by the payment | **Failed** status |
| [`payment_has_pending_reversal`](/reference/failures/payment_has_pending_reversal) | Receipt has a pending reversal | **Failed** status |
| [`payment_amount_out_of_bounds`](/reference/failures/payment_amount_out_of_bounds) | Payment amount is out of range | **Failed** status |

## Credit notes

A credit note and the invoice that it credits.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`credit_total_missing`](/reference/failures/credit_total_missing) | Credit note total is missing | **Failed** status |
| [`credit_line_product_key_missing`](/reference/failures/credit_line_product_key_missing) | A credit note line has no SAT product key | **Failed** status |
| [`credit_parent_ambiguous`](/reference/failures/credit_parent_ambiguous) | Credit note names more than one invoice | **Failed** status |
| [`credit_exceeds_parent`](/reference/failures/credit_exceeds_parent) | Credit note exceeds its invoice | **Failed** status |
| [`credit_currency_mismatch`](/reference/failures/credit_currency_mismatch) | Credit note currency does not match its invoice | **Failed** status |
| [`credit_within_rounding_of_parent`](/reference/failures/credit_within_rounding_of_parent) | Credit note is almost its invoice total | **Failed** status |

## Related documents

A document that this document refers to, for example the invoice of a credit note.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`parent_failed`](/reference/failures/parent_failed) | The related invoice was not stamped | **Failed** status |
| [`parent_cancelled`](/reference/failures/parent_cancelled) | The related invoice is cancelled | **Failed** status |
| [`parent_has_active_payments`](/reference/failures/parent_has_active_payments) | The related invoice has valid payments | **Failed** status |
| [`parent_uuid_conflict`](/reference/failures/parent_uuid_conflict) | The related invoice's SAT UUID does not match | **Failed** status |
| [`parent_from_other_issuer`](/reference/failures/parent_from_other_issuer) | The related invoice belongs to another issuer | **Failed** status |
| [`parent_dependency_conflict`](/reference/failures/parent_dependency_conflict) | Related document needs review | **Failed** status |
| [`related_cancellation_not_completed`](/reference/failures/related_cancellation_not_completed) | The related document was not cancelled | **Failed** status |

## Receipt reversals

A CargoWise reversal and the receipt that it reverses.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`reversal_target_unmatched`](/reference/failures/reversal_target_unmatched) | Reversal does not match its receipt | **Failed** status |
| [`reversal_target_uuid_missing`](/reference/failures/reversal_target_uuid_missing) | Reversed receipt has no SAT UUID | **Failed** status |

## Issuer

The company and the RFC that issue the CFDI.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`issuer_organization_mismatch`](/reference/failures/issuer_organization_mismatch) | CargoWise company does not match | **Failed** status |
| [`issuer_rfc_mismatch`](/reference/failures/issuer_rfc_mismatch) | Issuer RFC does not match | **Failed** status |

## SAT and stamping provider

The stamping provider (PAC) or the SAT did not accept the document.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`recipient_data_missing`](/reference/failures/recipient_data_missing) | Debtor data is missing | **Failed** status |
| [`recipient_tax_id_rejected`](/reference/failures/recipient_tax_id_rejected) | Debtor RFC was rejected | **Failed** status |
| [`recipient_name_rejected`](/reference/failures/recipient_name_rejected) | Debtor legal name was rejected | **Failed** status |
| [`recipient_postal_code_rejected`](/reference/failures/recipient_postal_code_rejected) | Debtor postal code was rejected | **Failed** status |
| [`recipient_tax_regime_rejected`](/reference/failures/recipient_tax_regime_rejected) | Debtor tax regime was rejected | **Failed** status |
| [`recipient_cfdi_use_rejected`](/reference/failures/recipient_cfdi_use_rejected) | CFDI use was rejected | **Failed** status |
| [`payment_balance_rejected`](/reference/failures/payment_balance_rejected) | The SAT rejected the invoice balance | **Failed** status |
| [`product_key_rejected`](/reference/failures/product_key_rejected) | A SAT product key was rejected | **Failed** status |
| [`tax_rate_rejected`](/reference/failures/tax_rate_rejected) | Tax rate was rejected | **Failed** status |
| [`provider_request_invalid`](/reference/failures/provider_request_invalid) | Stamping request was invalid | **Failed** status |
| [`pac_rejected`](/reference/failures/pac_rejected) | Stamping was rejected | **Failed** status |
| [`pac_invoice_canceled`](/reference/failures/pac_invoice_canceled) | Stamping was cancelled at the provider | **Failed** status |
| [`provider_unavailable`](/reference/failures/provider_unavailable) | The stamping provider was unavailable | **Failed** status |

## Transitive processing

Transitive could not complete a step with its own records.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`parent_records_duplicated`](/reference/failures/parent_records_duplicated) | Related invoice is recorded twice | **Failed** status |
| [`parent_uuid_missing`](/reference/failures/parent_uuid_missing) | Related invoice has no SAT UUID on record | **Failed** status |
| [`installment_ledger_corrupt`](/reference/failures/installment_ledger_corrupt) | Related invoice's payment history needs review | **Failed** status |
| [`parent_record_inconsistent`](/reference/failures/parent_record_inconsistent) | Related invoice needs review | **Failed** status |
| [`document_mapping_invalid`](/reference/failures/document_mapping_invalid) | Document could not be read | **Failed** status |
| [`stamp_path_unsupported`](/reference/failures/stamp_path_unsupported) | Document cannot be stamped this way yet | **Failed** status |
| [`processing_failed`](/reference/failures/processing_failed) | Document could not be processed | **Failed** status |

## Cancellations

A cancellation request did not cancel the CFDI. The CFDI stays valid.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`cancellation_failed`](/reference/failures/cancellation_failed) | Cancellation failed | Timeline |
| [`cancellation_request_rejected`](/reference/failures/cancellation_request_rejected) | Cancellation request was refused | Timeline |
| [`substitute_cancelled`](/reference/failures/substitute_cancelled) | Replacement was cancelled | Timeline |

## CargoWise delivery

Transitive did not deliver the CFDI files to CargoWise. The CFDI is not affected.

| Code | What the app shows | Where it shows |
| - | - | - |
| [`sendback_transport_failed`](/reference/failures/sendback_transport_failed) | Could not reach CargoWise | Timeline |
| [`sendback_outcome_unknown`](/reference/failures/sendback_outcome_unknown) | CargoWise delivery is unconfirmed | Timeline |
| [`sendback_rejected`](/reference/failures/sendback_rejected) | CargoWise rejected the file | Timeline |
| [`sendback_not_configured`](/reference/failures/sendback_not_configured) | CargoWise delivery is not set up | Timeline |
| [`sendback_artifact_invalid`](/reference/failures/sendback_artifact_invalid) | File to deliver is invalid | Timeline |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.