Fiscal operations

Separate fiscal lifecycle

A fiscal operation represents a jurisdiction/provider action related to an issued invoice. Persisted operation status, submission-attempt status, and normalized external-outcome certainty are distinct. A technical failure can be ambiguous if a request may have reached an authority.

• Use the invoice fiscal-status endpoint for the invoice summary.
• Use fiscal-operation reads for operation details and provider response evidence.
• Use reconciliation endpoints for supported outcome reconciliation; ambiguous operations are not safe generic retries.
• Do not infer tax authority acceptance from invoice issuance, Worker completion, transport HTTP status, or simulator acceptance.

External result terminology

Accepted, accepted with errors, rejected, processing, failed, manual review, cancelled, and indeterminate refer to different business/transport facts. The exact outcome comes from the persisted fiscal operation and submission response, not an immutable invoice field named fiscal_status.

• Issuance versus fiscal acceptance
• Fiscal API operations