fiz-invoicinglisted

# FIZ Invoicing Issue invoices with the FIZ Public API — a REST gateway at `https://api.fiz.co`. This skill walks through the full lifecycle: find or create the customer, find or create the items, build a **draft** invoice, **issue** it (this is the legally binding step), and optionally download the PDF. ## Setup Every request needs the client's API key in the `x-api-key` header. Get a key at **https://app.fiz.co/settings/integrations**. Store it in an environment variable so it never gets hardcoded into commands: ```bash export FIZ_API_KEY="fiz_api_..." # the user's key from app.fiz.co export FIZ_API_URL="https://api.fiz.co" # optional; this is the default ``` All examples below use `$FIZ_API_KEY` and `$FIZ_API_URL`. If `FIZ_API_URL` is unset, use `https://api.fiz.co`. If `FIZ_API_KEY` is unset, **stop and tell the user to set it in their environment** (`export FIZ_API_KEY=…` in their shell, or a secret manager) — **do not ask them to paste the key into the chat**, and never print or echo the key value. An API key is a credential; keep it out of the conversation transcript. A reusable curl helper is provided in `scripts/fiz.sh`. Commands run from the session's working directory (your project root), **not** the skill directory, so source the helper by its absolute path via `${CLAUDE_SKILL_DIR}` (Claude Code sets this to the skill's own directory): ```bash source "${CLAUDE_SKILL_DIR}/scripts/fiz.sh" # resolves from any working directory fiz GET /invoices ``` O