---
name: "fakturownia-bank-accounts"
description: "Fakturownia CLI bank accounts: list, fetch, create, update, and delete bank accounts, and inspect the bank-account addendum fields that also affect invoice payloads."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-invoices"
    - "fakturownia-departments"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "bank-account list"
    - "bank-account get"
    - "bank-account create"
    - "bank-account update"
    - "bank-account delete"
  cli_help: "fakturownia bank-account --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema bank-account list --json` for output discovery and `fakturownia schema bank-account create --json` before building `bank_account` payloads with `name`, `bank_account_number`, and `bank_currency` or invoice bank-account fields."
---

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

# Bank Accounts

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

## Use This Skill When

- The task is about reading or mutating bank accounts exposed by API_RACHUNKI_BANKOWE.md.
- You need invoice bank-account fields such as `bank_account_id`, `buyer_mass_payment_code`, or embedded `bank_accounts[]` and want the matching schema guidance.

## Covered Commands

- `fakturownia bank-account list` — List bank accounts
- `fakturownia bank-account get` — Fetch a single bank account by ID
- `fakturownia bank-account create` — Create a bank account
- `fakturownia bank-account update` — Update a bank account
- `fakturownia bank-account delete` — Delete a bank account

## Notable Flags

- `--page` (default `1`): Requested result page
- `--per-page` (default `25`): Requested result count per page
- `--id` (required): Bank account ID
- `--input` (required): Bank account JSON input as inline JSON, @file, or - for stdin
- `--yes` (required, default `false`): Confirm bank account 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 bank-account list --json` and `fakturownia schema bank-account get --json` before building selectors.
- Read `output.known_fields` to discover addendum-backed bank-account fields such as `name`, `bank_name`, `bank_account_number`, `bank_currency`, `bank_account_id`, `default`, and nested `bank_account_version_departments[]` settings.
- Use `fakturownia schema bank-account create --json` and `fakturownia schema bank-account 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 `bank_account` envelope.
- The addendum documents `name`, `bank_account_number`, and `bank_currency` in CRUD payloads, while returned objects also expose `bank_account_id` alongside `id`.
- Invoice schemas now also cite the bank-account addendum for `bank_account_id`, `buyer_mass_payment_code`, and embedded `bank_accounts[]` fields.

## Examples

```bash
fakturownia bank-account list --json
fakturownia bank-account list --columns id,name,bank_account_number,bank_currency,default
fakturownia bank-account list --page 2 --per-page 25 --raw
fakturownia bank-account get --id 100
fakturownia bank-account get --id 100 --fields id,name,bank_account_number --json
fakturownia bank-account get --id 100 --raw
fakturownia bank-account create --input '{"name":"Rachunek główny PLN","bank_account_number":"PL61 1090 1014 0000 0712 1981 2874","bank_name":"Santander Bank Polska","bank_currency":"PLN","default":true}' --json
fakturownia bank-account create --input '{"name":"Rachunek działu","bank_account_version_departments":[{"department_id":5,"main_on_department":true,"show_on_invoice":true}]}' --json
fakturownia bank-account create --input @bank-account.json
fakturownia bank-account create --input '{"name":"Rachunek testowy"}' --dry-run --json
fakturownia bank-account update --id 100 --input '{"default":false}' --json
fakturownia bank-account update --id 100 --input '{"bank_account_version_departments":[{"department_id":5,"remove":true}]}' --json
fakturownia bank-account update --id 100 --input @bank-account-update.json
fakturownia bank-account update --id 100 --input '{"bank_swift":"ABCDPLPW"}' --dry-run --json
fakturownia bank-account delete --id 100 --yes --json
fakturownia bank-account delete --id 100 --yes
fakturownia bank-account delete --id 100 --yes --dry-run --json
```

## Related Skills

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