> ## 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 reference
> Meanings, triggers, effects, impacts, responses, and safe actions for every supported operation.reason key.
Use this page when the workspace, a notification, or a shared support note contains an
`operation.reason` key.
Each anchor exactly matches the key:
```text theme={null}
/stamping/error-reference#reconciliation.values_conflict
```
The operation and reason form the stable client-facing contract. Provider responses and migrated
legacy identifiers can add evidence, but they do not change the key.
The current workspace observation remains the authority for a specific document.
## Mapping
### `mapping.input_missing`
Lambda was turning CargoWise source evidence into a fiscal intent. Required input is absent.
**Common triggers**
* Required invoice, receipt, product, unit, customer, or immutable capture data is absent.
* **Effect:** `not_started`
* **Likely impact:** `failed`
* **Lambda response:** Lambda stops before reconciliation or issuance and names the missing subject.
* **Safe action:** Complete the named source evidence, then use corrective recovery.
### `mapping.input_invalid`
Lambda was turning CargoWise source evidence into a fiscal intent. Input exists but is not valid for this operation.
**Common triggers**
* A posting journal, date, amount, identifier, external stamp, or XML shape cannot be mapped safely.
* **Effect:** `not_started`
* **Likely impact:** `failed`
* **Lambda response:** Lambda preserves the capture and sends no provider create request.
* **Safe action:** Correct the named source value, then use corrective recovery.
### `mapping.reference_unresolved`
Lambda was turning CargoWise source evidence into a fiscal intent. A required document or evidence reference cannot be resolved.
**Common triggers**
* A saved CargoWise event or its immutable capture cannot be loaded for pre-stamp work.
* **Effect:** `not_started`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda blocks issuance because remapping without the original evidence is unsafe.
* **Safe action:** Contact support so the missing source reference can be restored or verified.
### `mapping.values_conflict`
Lambda was turning CargoWise source evidence into a fiscal intent. Two or more observed values disagree.
**Common triggers**
* New CargoWise evidence conflicts with the source bound to an issued document.
* **Effect:** `applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda keeps the issued result and records the drift instead of rewriting history.
* **Safe action:** Review the changed values and use the approved source-change decision.
### `mapping.operation_blocked`
Lambda was turning CargoWise source evidence into a fiscal intent. The current lifecycle or relationship state prevents the operation.
**Common triggers**
* A cancelled or terminal document cannot restart the mapping path.
* **Effect:** `not_started`
* **Likely impact:** `failed`
* **Lambda response:** Lambda leaves the existing lifecycle result unchanged.
* **Safe action:** Review the lifecycle and use the action offered in the workspace.
### `mapping.invariant_violated`
Lambda was turning CargoWise source evidence into a fiscal intent. Lambda found internally inconsistent state.
**Common triggers**
* Stored source, capture identity, or fiscal intent state is internally inconsistent.
* **Effect:** `not_started`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda stops before issuance and preserves the conflicting evidence.
* **Safe action:** Contact support. Do not recreate the document while its identity is under review.
## Reconciliation
### `reconciliation.input_missing`
Lambda was comparing amounts, parents, balances, taxes, and fiscal evidence. Required input is absent.
**Common triggers**
* A required amount, tax, currency, payment method, date, balance, or installment value is absent.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda lists the missing subjects and does not submit the fiscal request.
* **Safe action:** Complete the named CargoWise evidence, then use corrective recovery.
### `reconciliation.input_invalid`
Lambda was comparing amounts, parents, balances, taxes, and fiscal evidence. Input exists but is not valid for this operation.
**Common triggers**
* A payment amount, date, tax type, line quantity, or PPD evidence has an invalid format or range.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda records the invalid field and stops before issuance.
* **Safe action:** Correct the named value, then use corrective recovery.
### `reconciliation.reference_unresolved`
Lambda was comparing amounts, parents, balances, taxes, and fiscal evidence. A required document or evidence reference cannot be resolved.
**Common triggers**
* A parent, SAT UUID, match line, installment history, debtor, or other required relation cannot be resolved.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda blocks the dependent document. A healthy unstamped parent uses Waiting for parent.
* **Safe action:** Review the named relation and correct it only after confirming the intended parent.
### `reconciliation.values_conflict`
Lambda was comparing amounts, parents, balances, taxes, and fiscal evidence. Two or more observed values disagree.
**Common triggers**
* Payment, balance, currency, tax, SAT UUID, credit, exchange-rate, or parent values disagree.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda shows the conflicting safe values and does not choose one silently.
* **Safe action:** Reconcile the named CargoWise values, then use corrective recovery.
### `reconciliation.rule_rejected`
Lambda was comparing amounts, parents, balances, taxes, and fiscal evidence. A required fiscal, provider, or product rule rejected the operation.
**Common triggers**
* A receipt contains only PUE parents, or another required eligibility rule rejects the relation.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda stops before provider submission and records the rejected rule.
* **Safe action:** Confirm that the source evidence supports an eligible fiscal route.
### `reconciliation.operation_blocked`
Lambda was comparing amounts, parents, balances, taxes, and fiscal evidence. The current lifecycle or relationship state prevents the operation.
**Common triggers**
* A related parent is failed, cancelled, or otherwise unable to support the operation.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda preserves the dependency chain and stops the child operation.
* **Safe action:** Resolve the parent first, then allow dependency recovery to continue the child.
### `reconciliation.resource_exhausted`
Lambda was comparing amounts, parents, balances, taxes, and fiscal evidence. A bounded service or organization resource has no remaining capacity.
**Common triggers**
* Payment-method evidence or another bounded reconciliation resource exceeds its supported limit.
* **Effect:** `known_not_applied`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda stops instead of guessing from incomplete evidence.
* **Safe action:** Contact support to review the bounded evidence set.
### `reconciliation.invariant_violated`
Lambda was comparing amounts, parents, balances, taxes, and fiscal evidence. Lambda found internally inconsistent state.
**Common triggers**
* Duplicate parent records, corrupt installment history, or inconsistent saldo state is detected.
* **Effect:** `known_not_applied` or `unknown`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda preserves the conflicting records and blocks further fiscal changes.
* **Safe action:** Contact support. Do not create a replacement document while the chain is reviewed.
## Issuance
### `issuance.input_missing`
Lambda was preparing or sending the Facturapi create request. Required input is absent.
**Common triggers**
* A migrated or prepared document lacks required recipient, item, or fiscal payload data.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda does not send an incomplete request to Facturapi.
* **Safe action:** Complete the named source field, then use corrective recovery.
### `issuance.rule_rejected`
Lambda was preparing or sending the Facturapi create request. A required fiscal, provider, or product rule rejected the operation.
**Common triggers**
* Facturapi or SAT rejects recipient, certificate, catalog, tax, RFC, PUE, or PPD data.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda stores safe provider evidence and does not repeat the rejected request.
* **Safe action:** Correct the named source or approved configuration, then use corrective recovery.
### `issuance.operation_blocked`
Lambda was preparing or sending the Facturapi create request. The current lifecycle or relationship state prevents the operation.
**Common triggers**
* A live Edward proposal is denied or its bounded recovery action cannot continue.
* **Effect:** `not_started`
* **Likely impact:** `failed` or `system_error`
* **Lambda response:** Lambda keeps the document unissued and records the review outcome.
* **Safe action:** Use the standard corrective or support path shown in the workspace.
### `issuance.configuration_missing`
Lambda was preparing or sending the Facturapi create request. Required organization configuration is absent.
**Common triggers**
* A Facturapi binding, certificate, or required stamping setting is absent.
* **Effect:** `not_started`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda blocks issuance before sending a provider request.
* **Safe action:** Ask an administrator to complete the named Stamping configuration.
### `issuance.configuration_invalid`
Lambda was preparing or sending the Facturapi create request. Required organization configuration cannot perform this operation.
**Common triggers**
* A stamping route is disabled or changed, or Facturapi test or live readiness is invalid.
* **Effect:** `not_started`
* **Likely impact:** `failed` or `system_error`
* **Lambda response:** Lambda records the route or readiness decision and does not issue the CFDI.
* **Safe action:** Review Stamping settings and repair the named route or environment.
### `issuance.dependency_unavailable`
Lambda was preparing or sending the Facturapi create request. A required service is unavailable.
**Common triggers**
* Durable work, Facturapi, or another required issuance dependency is unavailable.
* **Effect:** `not_started` or `unknown`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda uses automatic recovery when the exact operation can be resumed safely.
* **Safe action:** Wait for recovery. If the incident opens, contact support instead of resending.
### `issuance.resource_exhausted`
Lambda was preparing or sending the Facturapi create request. A bounded service or organization resource has no remaining capacity.
**Common triggers**
* The organization has no stamp credits or an issuance capacity gate is exhausted.
* **Effect:** `not_started`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda stops before provider submission.
* **Safe action:** Restore the named resource, then allow the appropriate recovery lane to continue.
### `issuance.outcome_unknown`
Lambda was preparing or sending the Facturapi create request. The provider may have applied the operation, so the result must be verified.
**Common triggers**
* The connection ends after provider submission without a proven create result.
* **Effect:** `unknown`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda verifies the exact attempt and provider identity before any further create action.
* **Safe action:** Wait for recovery or contact support. Do not resend or stamp elsewhere.
### `issuance.attempts_exhausted`
Lambda was preparing or sending the Facturapi create request. Automatic recovery reached its bounded attempt limit.
**Common triggers**
* Workflow dispatch or exact-attempt recovery reaches its bounded limit.
* **Effect:** `not_started` or `unknown`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda opens the incident with the last safe attempt evidence.
* **Safe action:** Contact support so the exact attempt can be inspected before another issuance decision.
### `issuance.invariant_violated`
Lambda was preparing or sending the Facturapi create request. Lambda found internally inconsistent state.
**Common triggers**
* Stored attempt, intent, provider identity, or lifecycle state is inconsistent.
* **Effect:** `unknown`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda blocks further create requests and preserves the evidence.
* **Safe action:** Contact support. Do not initiate another stamp while the attempt is verified.
## Verification
### `verification.values_conflict`
Lambda was checking an issued result against the intended fiscal result. Two or more observed values disagree.
**Common triggers**
* CargoWise values change after issuance or conflict with the fiscal snapshot.
* **Effect:** `applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda keeps the issued CFDI and records the drift.
* **Safe action:** Compare the workspace values with the XML and use the approved source-change path.
### `verification.outcome_unknown`
Lambda was checking an issued result against the intended fiscal result. The provider may have applied the operation, so the result must be verified.
**Common triggers**
* Provider verification fails after a Facturapi identity is known.
* **Effect:** `unknown`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda preserves the provider identity and verifies before changing fiscal state.
* **Safe action:** Wait for recovery or contact support. Do not issue a replacement CFDI.
### `verification.postcondition_mismatch`
Lambda was checking an issued result against the intended fiscal result. The completed result differs from the expected result.
**Common triggers**
* Stamped totals, complement values, SAT identity, or enriched recipient data differs from the request.
* **Effect:** `applied`
* **Likely impact:** `failed` or `system_error`
* **Lambda response:** Lambda keeps the issued evidence and blocks automatic replacement.
* **Safe action:** Review the XML comparison, then use the approved correction or cancellation path.
## Cancellation
### `cancellation.reference_unresolved`
Lambda was cancelling a fiscal document through Facturapi and SAT. A required document or evidence reference cannot be resolved.
**Common triggers**
* The parent Facturapi identity or another verified cancellation target is unavailable.
* **Effect:** `not_started`
* **Likely impact:** `failed`
* **Lambda response:** Lambda does not send an unverified cancellation request.
* **Safe action:** Resolve the named parent or provider identity before continuing.
### `cancellation.rule_rejected`
Lambda was cancelling a fiscal document through Facturapi and SAT. A required fiscal, provider, or product rule rejected the operation.
**Common triggers**
* Facturapi, SAT, or a full-credit relationship rule rejects the cancellation.
* **Effect:** `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda leaves the original CFDI issued and records the rejection.
* **Safe action:** Review the motive, parent relation, and provider evidence before choosing another action.
### `cancellation.operation_blocked`
Lambda was cancelling a fiscal document through Facturapi and SAT. The current lifecycle or relationship state prevents the operation.
**Common triggers**
* Linked REPs, an active request, external ownership, or a terminal target prevents cancellation.
* **Effect:** `not_started`
* **Likely impact:** `failed`
* **Lambda response:** Lambda preserves the current fiscal chain and sends no cancellation.
* **Safe action:** Resolve the blocking relation or wait for the active cancellation to finish.
### `cancellation.configuration_invalid`
Lambda was cancelling a fiscal document through Facturapi and SAT. Required organization configuration cannot perform this operation.
**Common triggers**
* The full-credit parent-cancel route is disabled or no longer authorized.
* **Effect:** `not_started` or `known_not_applied`
* **Likely impact:** `failed`
* **Lambda response:** Lambda leaves the parent issued and records the route decision.
* **Safe action:** Enable a valid credit or cancellation route in Stamping settings.
### `cancellation.outcome_unknown`
Lambda was cancelling a fiscal document through Facturapi and SAT. The provider may have applied the operation, so the result must be verified.
**Common triggers**
* Facturapi or SAT does not return a conclusive cancellation result.
* **Effect:** `unknown`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda checks the exact cancellation before sending another request.
* **Safe action:** Wait for recovery or contact support. Do not submit a second cancellation.
## Delivery
### `delivery.configuration_missing`
Lambda outbound was delivering stored artifacts to CargoWise inbound. Required organization configuration is absent.
**Common triggers**
* The CargoWise outbound target or a required artifact document type is absent.
* **Effect:** `not_started`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda keeps the stamped artifacts stored and blocks only delivery.
* **Safe action:** Complete the CargoWise target and document-type settings.
### `delivery.configuration_invalid`
Lambda outbound was delivering stored artifacts to CargoWise inbound. Required organization configuration cannot perform this operation.
**Common triggers**
* CargoWise authentication, target URL, or another delivery setting is invalid.
* **Effect:** `not_started`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda preserves the CFDI and waits for a usable connection.
* **Safe action:** Ask an administrator to verify the CargoWise target and credentials.
### `delivery.dependency_unavailable`
Lambda outbound was delivering stored artifacts to CargoWise inbound. A required service is unavailable.
**Common triggers**
* CargoWise inbound times out or a required delivery service is unavailable.
* **Effect:** `known_not_applied`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda retries the same idempotent delivery without creating another CFDI.
* **Safe action:** Wait for delivery recovery. The fiscal document may already exist.
### `delivery.operation_blocked`
Lambda outbound was delivering stored artifacts to CargoWise inbound. The current lifecycle or relationship state prevents the operation.
**Common triggers**
* The delivery claim, lifecycle, or required artifact state prevents recovery.
* **Effect:** `known_not_applied`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda leaves the fiscal result unchanged and preserves the pending delivery.
* **Safe action:** Contact support to inspect delivery. Do not re-stamp the document.
### `delivery.attempts_exhausted`
Lambda outbound was delivering stored artifacts to CargoWise inbound. Automatic recovery reached its bounded attempt limit.
**Common triggers**
* Repeated CargoWise inbound failures exhaust the delivery recovery limit.
* **Effect:** `known_not_applied`
* **Likely impact:** `system_error`
* **Lambda response:** Lambda opens a delivery incident and keeps the CFDI and artifacts intact.
* **Safe action:** Contact support to restore delivery. Do not issue a replacement CFDI.