Causa Prima

Generate Invoice

Generate an invoice. **Phase 1 supports Germany (DE) and the United States (US) only** — DE emits an EN 16931-compliant XRechnung (UBL by default, CII via format_override) or ZUGFeRD COMFORT, US emits a plain PDF. Any other sender jurisdiction is rejected with `unsupported_jurisdiction`. The format is selected automatically from the sender's country (override with `format_override`, or auto-select XRechnung UBL by setting `recipient.leitweg_id`); German output is validated against EN 16931 befor

Fetch Invoice

Fetch a previously generated invoice by its `invoice_id` and return its current metadata plus a freshly signed download URL. Read-only and tenant-scoped — cross-tenant lookups return 404. Use this after `create_invoice` to re-download bytes from a different device, or to obtain a new signed URL after the original expires.

List Supported Jurisdictions

List jurisdictions Scribo can emit invoices for, with each jurisdiction's available formats and the default format applied when no override is given. Phase 1 returns Germany (DE — XRechnung / ZUGFeRD) and the United States (US — plain PDF) only. Read-only and side-effect-free; safe to call before `create_invoice` to confirm a country is supported. Returns an array of `{ jurisdiction, formats[], default_format }`.

Verify Email Code

Use this after `create_invoice` returns `verification_required`. Arguments: `{ challenge_id, code }`. On success returns a `verification_token`. Retry `create_invoice` with the same arguments plus that `verification_token` passed in its `verification_token` field. The token is reusable for ~30 min, so thread the same one into every subsequent `create_invoice` for the same sender email until it expires.