fiz-invoicinglisted

Issue Portuguese fiscal documents through the FIZ Public API (https://api.fiz.co). Use when the user wants to create or issue an invoice, bill a customer, create a customer or product/service item, register a payment on an issued invoice, issue a credit note, work out the correct VAT rate for a sale, create a transport document (guia de transporte), look up bank transactions, or download a document PDF in FIZ. Triggers include "issue an invoice", "bill <customer>", "create an invoice for ...", "send a fatura", "add a customer/item in FIZ", "mark invoice X as paid", "credit note", "what VAT should I charge", "guia de transporte", "get the invoice PDF".
FIZ-co/fiz-invoicing-skill · ★ 4 · Data & Documents · score 78

Install: claude install-skill FIZ-co/fiz-invoicing-skill

# FIZ Invoicing Issue Portuguese fiscal documents 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), record a payment, and download the PDF. It also covers credit notes, transport documents (guias de transporte), the VAT calculator, and reading bank transactions. ## 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