---
name: "fakturownia-issuers"
description: "Fakturownia CLI issuers: list, fetch, create, update, and delete issuers with README-backed field and payload discovery."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-invoices"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "issuer list"
    - "issuer get"
    - "issuer create"
    - "issuer update"
    - "issuer delete"
  cli_help: "fakturownia issuer --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema issuer list --json` for output fields and `fakturownia schema issuer create --json` before building issuer payloads."
---

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

# Issuers

> **PREREQUISITE:** Read [`fakturownia-shared`](../shared/SKILL.md) first.

## Use This Skill When

- The task is about reading or mutating invoice issuers.
- You need README-backed issuer fields such as `name` and `tax_no` before creating or updating an issuer.

## Covered Commands

- `fakturownia issuer list` — List issuers
- `fakturownia issuer get` — Fetch a single issuer by ID
- `fakturownia issuer create` — Create an issuer
- `fakturownia issuer update` — Update an issuer
- `fakturownia issuer delete` — Delete an issuer

## Notable Flags

- `--page` (default `1`): Requested result page
- `--per-page` (default `25`): Requested result count per page
- `--id` (required): Issuer ID
- `--input` (required): Issuer JSON input as inline JSON, @file, or - for stdin
- `--yes` (required, default `false`): Confirm issuer deletion

## Environment

- `FAKTUROWNIA_PROFILE`: Select a profile unless --profile is provided
- `FAKTUROWNIA_URL`: Override the base account URL from any profile
- `FAKTUROWNIA_API_TOKEN`: Override the API token from any profile

## Output and Request Discovery

- Use `fakturownia schema issuer list --json` and `fakturownia schema issuer get --json` before building selectors.
- Read `output.known_fields` to discover README-backed issuer output fields such as `name` and `tax_no`.
- Use `fakturownia schema issuer create --json` and `fakturownia schema issuer update --json` to inspect `request_body_schema` and accepted `--input` modes.
- `--input` accepts inline JSON, `@file`, or `-` for stdin, and the CLI wraps the inner object into the upstream `issuer` envelope.

## Examples

```bash
fakturownia issuer list --json
fakturownia issuer list --columns id,name,tax_no
fakturownia issuer list --page 2 --per-page 25 --raw
fakturownia issuer get --id 3
fakturownia issuer get --id 3 --fields id,name,tax_no --json
fakturownia issuer get --id 3 --raw
fakturownia issuer create --input '{"name":"HQ","tax_no":"1234567890"}' --json
fakturownia issuer create --input @issuer.json
fakturownia issuer create --input '{"name":"HQ"}' --dry-run --json
fakturownia issuer update --id 3 --input '{"tax_no":"1234567890"}' --json
fakturownia issuer update --id 3 --input @issuer-update.json
fakturownia issuer update --id 3 --input '{"name":"HQ"}' --dry-run --json
fakturownia issuer delete --id 3 --yes --json
fakturownia issuer delete --id 3 --yes --dry-run --json
```

## Related Skills

- [fakturownia-shared](../shared/SKILL.md)
- [fakturownia-invoices](../invoices/SKILL.md)
- [fakturownia-schema](../schema/SKILL.md)
- [fakturownia-doctor](../doctor/SKILL.md)