> ## Documentation Index > Fetch the complete documentation index at: https://docs.jaantonio.com/llms.txt > Use this file to discover all available pages before exploring further. # Error codes > Complete reference for every stamping failure and system-error code. Use this page to match the classification ID shown in a workspace note or notification. It lists every canonical error code with its title and message. Waiting states such as `parent_awaiting_stamp` are not error codes. See [Statuses](/stamping/statuses) for processing and parent-waiting states. ## Document failures These codes mean the document, fiscal evidence, linked documents, or provider response blocked safe stamping. See [Failures](/stamping/failures) for how to interpret this status. ### Business 68 classifications. | Code | Title | Message | | ----------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `validation_failed` | Validation failed | We're missing required fiscal fields. | | `reconciliation_failed` | Payment matching blocked | Payment data from CargoWise could not be matched. The issue details show which values disagree. | | `income_reconciliation_failed` | Income fields need review before stamp | We're missing required fiscal fields. | | `external_income_evidence_failed` | External stamp evidence needs review | This invoice has a data issue before stamping. Check the issue details before retrying. | | `bootstrap_uuid_unverified` | Parent stamp ID unverified | We could not verify the parent invoice stamp ID. Please confirm the parent invoice is stamped before continuing. | | `stamp_total_mismatch` | Stamped total mismatch | The stamped document does not match this invoice. Amounts must match before stamping again. | | `stamp_verification_failed` | Stamp verification failed | The stamped document does not match this invoice. Amounts must match before stamping again. | | `stamp_customer_enrichment_mismatch` | Customer mismatch | Customer details differ from your saved client. Confirm the correct bill-to before stamping. | | `cw_data_mismatch` | Source data changed after stamp | Source data changed after stamp and no longer matches the stamped document. | | `source_change_requires_decision` | CargoWise source changed | A newer CargoWise document has different fiscal values. The currently accepted fiscal input remains unchanged until this version is accepted or rejected. | | `cancel_blocked_child_reps` | Cancellation blocked by payments | Cancel linked payment receipts in Lambda before cancelling this invoice. | | `cancelled_reingest` | Cancelled invoice re-ingested | CargoWise sent a document again after Lambda had already recorded it as cancelled. Lambda keeps the cancellation result and does not create another stamp. | | `ledger_installment_conflict` | Installment already assigned | An installment for a linked invoice is already assigned to another payment. This REP was not stamped. | | `parent_not_stamped` | Parent blocked | This payment includes a parent invoice whose SAT stamp is unavailable or cancelled. The complete payment remains on hold; no linked invoice was omitted. | | `partial_credit_parent_cancelled` | Partial credit targets cancelled invoice | This partial credit cannot be applied because its parent invoice is already cancelled. | | `credit_currency_mismatch` | Credit currency mismatch | Credit currency does not match the parent invoice. | | `credit_exceeds_parent` | Credit exceeds parent | Credit amount exceeds the parent invoice total. | | `parent_cancel_blocked` | Parent cancellation blocked | Parent cancellation is blocked in CargoWise by linked payments or credits. | | `credit_reconciliation_failed` | Credit note needs review before stamp | We're missing required fiscal fields. | | `missing_payment_line_amount` | Invoice payment amount is missing | CargoWise did not include the amount applied to a linked invoice. | | `invalid_payment_line_amount` | Invoice payment amount is invalid | A payment applied to a linked invoice has an invalid amount. | | `rep_amount_unassigned` | Part of the REP is not assigned to an invoice | Part of this REP is not assigned to an invoice. | | `rep_applications_exceed_total` | Invoice applications exceed the REP total | Invoice applications on this REP add up to more than the REP total. | | `payment_exceeds_parent_balance` | REP payment exceeds invoice balance | Payment exceeds the current unpaid balance on the parent invoice. | | `payment_line_mxn_mismatch` | Invoice payment MXN amount does not match | A linked invoice payment does not match its MXN amount. | | `rep_local_mxn_total_inconsistent` | REP local MXN total is inconsistent | This REP balances in its own currency, but its local MXN total is inconsistent with the payment amount and exchange rate. | | `rep_parent_total_differs_from_stamped_invoice` | REP parent total differs from stamped invoice | A linked invoice has a different total in this REP than when it was stamped. | | `credit_parent_reference_conflict` | Conflicting credit parent references | This credit note points to more than one parent invoice reference. | | `parent_sat_uuid_conflict` | Parent stamp ID conflict | Parent invoice stamp ID disagrees with our records. | | `rep_parent_failed` | Parent invoice failed | This payment could not be stamped because a parent invoice failed before it was stamped. The complete payment was not stamped; no linked invoice was omitted. It can be retried after the parent invoice is corrected and stamped. | | `rep_parent_cancelled` | Parent invoice cancelled | This REP includes a cancelled invoice. A payment complement cannot be issued against that invoice. | | `missing_rep_installment_history` | Prior REP history is missing | Lambda cannot determine the payment installment because verified prior REP history is unavailable. Support must verify or restore that history before this REP can be stamped. | | `duplicate_parent_line` | Duplicate parent payment line | This receipt pays the same parent invoice more than once. | | `missing_payment_date` | Payment date missing | We're missing the payment date. | | `missing_parent_match_lines` | Parent invoice links missing | This receipt is not linked to parent invoices. | | `ambiguous_receipt_debtor` | Ambiguous receipt debtor | Match lines disagree on the customer. | | `line_subtotal` | Line subtotal mismatch | We're missing required fiscal fields. | | `line_vat_total` | Line VAT mismatch | We're missing required fiscal fields. | | `invoice_total` | Invoice total mismatch | We're missing required fiscal fields. | | `missing_line_tax` | Line tax missing | We're missing required fiscal fields. | | `line_quantity_collapsed` | Line quantity collapsed | We're missing required fiscal fields. | | `missing_customer_field` | Customer fiscal field missing | We're missing required fiscal fields. | | `missing_payment_form` | Payment form missing | We're missing required fiscal fields. | | `missing_payment_method` | Payment method missing | We're missing the dates needed to decide PUE or PPD. | | `missing_currency` | Currency missing | We're missing required fiscal fields. | | `unmapped_posting_journal` | Posting journal unmapped | We're missing required fiscal fields. | | `outstanding_balance_mismatch` | Outstanding balance mismatch | Outstanding balance does not match. | | `exchange_rate_mismatch` | Exchange rate mismatch | Exchange rate or MXN equivalent does not match. | | `tax_base_mismatch` | Tax base mismatch | Tax amount does not match. | | `missing_parent_currency` | Parent invoice currency is missing | The currency of a linked parent invoice is missing. | | `parent_total_mismatch` | Parent total mismatch | Parent invoice total does not match. | | `parent_currency_conflict` | Linked invoice currency conflicts with stamped invoice | A linked invoice has a different currency in this REP than the stamped invoice. | | `missing_parent_balance_evidence` | Parent balance evidence is missing | Lambda cannot determine the previous balance. Existing payment history does not prove it, and this receipt does not include OutstandingAmount. This REP was not stamped. | | `missing_exchange_rate_evidence` | Exchange-rate evidence is missing | CargoWise did not include exchange-rate detail on the match line. | | `missing_payment_tax_evidence` | Payment tax evidence is missing | CargoWise did not include tax detail for this payment. | | `unsupported_parent_tax_type` | Unsupported parent tax type | A linked invoice contains a tax type that Lambda cannot safely map to this payment complement. | | `payment_method_conflict` | Payment method conflict | Payment method evidence disagrees between the linked invoice records. | | `rep_not_allowed_for_pue_parent` | Payment receipt is not allowed for a PUE invoice | This invoice was paid in full at issue (PUE). A payment receipt is not allowed. | | `missing_parent_payment_method_evidence` | Parent payment method evidence is missing | We're missing the dates needed to decide PUE or PPD. | | `invalid_parent_payment_date` | Parent payment date is invalid | The parent invoice payment date is invalid, so Lambda cannot determine whether a payment complement is allowed. | | `payment_method_evidence_limit_exceeded` | Too many payment method values | CargoWise supplied more payment method values than Lambda can safely reconcile. | | `installment_sequence_conflict` | Installment sequence conflict | Verified payment installment numbers disagree. This REP was not stamped. | | `missing_payment_method_evidence` | Payment method evidence is missing | We're missing the dates needed to decide PUE or PPD. | | `missing_required_receipt_data` | Required receipt data is missing | We're missing required receipt fields. | | `missing_required_source_data` | Required source data is missing | We're missing required fiscal fields. | | `ppd_payment_form_unverified` | PPD payment form unverified | We're missing required fiscal fields. | | `missing_line_product_code` | Line product code missing | We're missing required fiscal fields. | | `missing_line_unit_code` | Line unit code missing | We're missing required fiscal fields. | ### Provider rejection 4 classifications. | Code | Title | Message | | ----------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------- | | `stamp_failed` | Stamp rejected | Tax authority rejected the stamp because required fiscal fields did not pass validation. | | `missing_required_stamp_data` | Required stamp data is missing | Facturapi rejected the stamp because required fiscal data is missing. | | `sat_validation_failed` | Stamp rejected | Tax authority rejected the stamp because required fiscal fields did not pass validation. | | `client_fiscal_data_rejected` | Client fiscal data rejected | Facturapi rejected the client fiscal profile. Correct the client data in Lambda to retry this document. | ### Configuration 1 classification. | Code | Title | Message | | ------------------------------------------ | ------------------------------------------------ | --------------------------------------------------------------------------------------------------- | | `stamping_action_skipped_by_configuration` | Automation skipped by organization configuration | This document arrived without an external stamp while Lambda automation was disabled for its route. | ## System errors These codes mean configuration, provider availability, delivery, recovery, or an internal invariant blocked safe continuation. See [System errors](/stamping/system-errors) for operational guidance. ### Configuration 4 classifications. | Code | Title | Message | | ----------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | `facturapi_configuration_missing` | Facturapi setup incomplete | Facturapi setup is incomplete for this workspace. Finish fiscal setup before retrying the stamp. | | `cw_outbound_configuration_missing` | CargoWise delivery configuration missing | Stamped files could not be delivered to CargoWise. Check inbound settings and credentials, then retry delivery. | | `cw_inbound_auth_failed` | Inbound auth rejected | CargoWise rejected inbound credentials. Update inbound credentials in settings, then retry delivery. | | `billing_stamp_credits_exhausted` | Stamp credits exhausted | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | ### Transient system 6 classifications. | Code | Title | Message | | -------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------ | | `capture_refresh_required` | Capture refresh required | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `stamp_system_error` | Stamp system error | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `ingress_enqueue_failed` | Stamp failed to start | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `stamp_workflow_stalled` | Stamp workflow stalled | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `cancel_failed` | Cancellation failed | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `parent_cancel_failed` | Parent cancellation failed | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | ### Permanent system 16 classifications. | Code | Title | Message | | ---------------------------------------- | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `unknown_system_error` | Unknown processing failure | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `missing_ingress_capture` | Ingress capture missing | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `corrupt_stored_intent` | Stored intent corrupted | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `stamp_complement_drift` | Stamped complement mismatch | We stamped this REP but did not send it to CargoWise because it failed an internal verification check after stamping. The support team has been notified. | | `cw_outbound_failed` | Outbound delivery failed | Stamped files could not be delivered to CargoWise. Check inbound settings and credentials, then retry delivery. | | `stamp_enqueue_exhausted` | Stamp never started | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `stamp_auto_retry_exhausted` | Stamp retries exhausted | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `cw_outbound_retry_exhausted` | Outbound recovery exhausted | Stamped files could not be delivered to CargoWise. Check inbound settings and credentials, then retry delivery. | | `cw_recovery_blocked` | Recovery blocked | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `ledger_installment_finalization_failed` | Installment record incomplete | This REP was stamped, but Lambda could not record its installment on the linked invoice. Support has been notified. Do not retry stamping. | | `parent_invalid` | Parent invoice data inconsistent | Lambda's saved data for the linked parent invoice is inconsistent. The Jaantonio team has been notified. | | `parent_has_reps` | Credit blocked by payments | Something went wrong while Lambda processed this document. The Jaantonio team has been notified. | | `parent_record_inconsistent` | Parent invoice data inconsistent | Lambda's saved data for the linked parent invoice is inconsistent. The Jaantonio team has been notified. | | `duplicate_parent_invoice_records` | Duplicate parent invoice records | Lambda found more than one stored invoice for a CargoWise parent reference. This REP was not stamped. Support has been notified. | | `ledger_installment_history_corrupt` | Payment installment history corrupt | Lambda's payment installment history for a linked invoice is contradictory or corrupt. This REP was not stamped. Support has been notified. | | `missing_parent_sat_uuid` | Parent stamp ID is missing | A linked invoice is marked as stamped, but its SAT UUID is missing from Lambda. This REP was not stamped. The Jaantonio team has been notified. |