---
name: "fakturownia-price-lists"
description: "Fakturownia CLI price lists: list, fetch, create, update, and delete price lists, including upstream-shaped position payloads and schema-backed discovery."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-products"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "price-list list"
    - "price-list get"
    - "price-list create"
    - "price-list update"
    - "price-list delete"
  cli_help: "fakturownia price-list --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema price-list list --json` for output fields and `fakturownia schema price-list create --json` for the upstream-shaped request contract, especially `price_list_positions_attributes`."
---

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

# Price Lists

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

## Use This Skill When

- The task is about reading or mutating price lists and their position entries.
- You need to inspect the verified `price-list get` output shape or build upstream-shaped `price_list_positions_attributes` payloads before create or update calls.

## Covered Commands

- `fakturownia price-list list` — List price lists
- `fakturownia price-list get` — Fetch a single price list by ID
- `fakturownia price-list create` — Create a price list
- `fakturownia price-list update` — Update a price list
- `fakturownia price-list delete` — Delete a price list

## Notable Flags

- `--page` (default `1`): Requested result page
- `--per-page` (default `25`): Requested result count per page
- `--id` (required): Price list ID
- `--input` (required): Price list JSON input as inline JSON, @file, or - for stdin
- `--yes` (required, default `false`): Confirm price list 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

## Examples

```bash
fakturownia price-list list --json
fakturownia price-list list --columns id,name,currency,description
fakturownia price-list list --page 2 --per-page 25 --raw
fakturownia price-list get --id 8523
fakturownia price-list get --id 8523 --fields id,name,price_list_positions[].price_gross --json
fakturownia price-list get --id 8523 --raw
fakturownia price-list create --input '{"name":"Dropshipper","currency":"PLN"}' --json
fakturownia price-list create --input '{"name":"Dropshipper","price_list_positions_attributes":{"0":{"priceable_id":97149307,"price_gross":"33.16","tax":"23"}}}' --json
fakturownia price-list create --input @price-list.json
fakturownia price-list create --input '{"name":"Dropshipper"}' --dry-run --json
fakturownia price-list update --id 8523 --input '{"description":"updated"}' --json
fakturownia price-list update --id 8523 --input @price-list-update.json
fakturownia price-list update --id 8523 --input '{"currency":"EUR"}' --dry-run --json
fakturownia price-list delete --id 8523 --yes --json
fakturownia price-list delete --id 8523 --yes
fakturownia price-list delete --id 8523 --yes --dry-run --json
```

## Related Skills

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