Error codes

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 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 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 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.

Get started

Stamping

Analytics

Document failures

Business

Provider rejection

Configuration

System errors

Configuration

Transient system

Permanent system

​Document failures

​Business

​Provider rejection

​Configuration

​System errors

​Configuration

​Transient system

​Permanent system

Document failures

Business

Provider rejection

Configuration

System errors

Configuration

Transient system

Permanent system