Fakturownia CLI

SKILL.md

---
name: "fakturownia"
description: "Fakturownia CLI bundle: shared guidance, auth, accounts, departments, issuers, users, categories, clients, payments, bank accounts, products, price lists, invoices, recurrings, warehouses, warehouse actions, warehouse documents, webhooks, self-update, schema discovery, diagnostics, and generated invoice recipes for the `fakturownia` command. Use when an agent needs to work with Fakturownia through this CLI."
metadata:
  category: "bundle"
  cli_help: "fakturownia --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Open the bundle-local skills index first, then read the shared skill, then the area skill that matches the task."
---

> Auto-generated by `go run ./cmd/gen-skills`. Do not edit manually.

# fakturownia

Use this as the entrypoint for the generated Fakturownia CLI skill bundle.

## Start Here

1. Open the [skills index](references/skills-index.md) to choose the right subskill.
2. Read [fakturownia-shared](subskills/shared/SKILL.md) for auth prerequisites, global flags, output behavior, and schema discovery.
3. Then open the subskill that matches the task area.

## Before You Use It

- Confirm `fakturownia` is already available on `PATH` with `fakturownia --version` before attempting task-specific commands.
- Save credentials before API calls with `fakturownia auth login --prefix acme --api-token "$FAKTUROWNIA_API_TOKEN"`.
- If the environment already provides credentials, still run `fakturownia auth status --json` to confirm the resolved profile, prefix, and token source.
- Run `fakturownia account get --json` as the first authenticated smoke test before attempting task-specific writes or reads.

## Subskills

- [fakturownia-shared](subskills/shared/SKILL.md): Fakturownia CLI shared patterns: authentication prerequisites, global flags, output modes, `--fields` vs `--columns`, `--raw`, schema discovery, and binary maintenance. Use before any area-specific fakturownia task.
- [fakturownia-auth](subskills/auth/SKILL.md): Fakturownia CLI auth: persist, inspect, and remove profiles and API tokens with `fakturownia auth ...`.
- [fakturownia-accounts](subskills/accounts/SKILL.md): Fakturownia CLI accounts: create, inspect, delete, and unlink system accounts using the README-backed account contract, with sanitized structured output and optional profile persistence.
- [fakturownia-departments](subskills/departments/SKILL.md): Fakturownia CLI departments: list, fetch, create, update, delete, and upload department logos, with README-backed request and output discovery.
- [fakturownia-issuers](subskills/issuers/SKILL.md): Fakturownia CLI issuers: list, fetch, create, update, and delete issuers with README-backed field and payload discovery.
- [fakturownia-users](subskills/users/SKILL.md): Fakturownia CLI users: create or invite account users through the README-backed add-user endpoint and inspect the accepted user payload shape.
- [fakturownia-webhooks](subskills/webhooks/SKILL.md): Fakturownia CLI webhooks: list, fetch, create, update, and delete webhooks using conservative README-backed request and output discovery.
- [fakturownia-categories](subskills/categories/SKILL.md): Fakturownia CLI categories: list, fetch, create, update, and delete categories, and inspect README-backed category fields and request schemas.
- [fakturownia-clients](subskills/clients/SKILL.md): Fakturownia CLI clients: list, fetch, create, update, and delete clients, and inspect README-backed client fields and request schemas.
- [fakturownia-payments](subskills/payments/SKILL.md): Fakturownia CLI payments: list, fetch, create, update, and delete banking payments, including the README-backed `include=invoices` list mode and request-body discovery.
- [fakturownia-bank-accounts](subskills/bank-accounts/SKILL.md): Fakturownia CLI bank accounts: list, fetch, create, update, and delete bank accounts, and inspect the bank-account addendum fields that also affect invoice payloads.
- [fakturownia-products](subskills/products/SKILL.md): Fakturownia CLI products: list, fetch, create, update, and delete products, including warehouse-aware reads and README-backed request schemas.
- [fakturownia-price-lists](subskills/price-lists/SKILL.md): Fakturownia CLI price lists: list, fetch, create, update, and delete price lists, including upstream-shaped position payloads and schema-backed discovery.
- [fakturownia-invoices](subskills/invoices/SKILL.md): Fakturownia CLI invoices: list, fetch, create, update, delete, email, cancel, send to KSeF through the API-native `gov` flow, download invoice attachments, and discover invoice fields and payloads through schema output.
- [fakturownia-recurrings](subskills/recurrings/SKILL.md): Fakturownia CLI recurrings: list, create, update, and delete recurring invoice definitions with README-backed request and output discovery.
- [fakturownia-warehouses](subskills/warehouses/SKILL.md): Fakturownia CLI warehouses: list, fetch, create, update, and delete warehouses, and inspect README-backed warehouse fields and request schemas.
- [fakturownia-warehouse-actions](subskills/warehouse-actions/SKILL.md): Fakturownia CLI warehouse actions: list warehouse actions with explicit README-backed filters and inspect conservative action fields through schema output.
- [fakturownia-warehouse-documents](subskills/warehouse-documents/SKILL.md): Fakturownia CLI warehouse documents: list, fetch, create, update, and delete warehouse documents, including kind selection and invoice linking through payload fields.
- [fakturownia-schema](subskills/schema/SKILL.md): Fakturownia CLI schema discovery: inspect supported commands, flags, examples, exit codes, and output schemas with `fakturownia schema ...`.
- [fakturownia-doctor](subskills/doctor/SKILL.md): Fakturownia CLI diagnostics: validate config resolution, credential-store access, reachability, authenticated API access, and release integrity with `fakturownia doctor run`.

## Recipes

- Open the [recipes index](recipes/index.md) for higher-level invoice and recurring workflows from the upstream README.

## CLI Entry Point

```bash
fakturownia --help
```