---
name: "fakturownia-warehouses"
description: "Fakturownia CLI warehouses: list, fetch, create, update, and delete warehouses, and inspect README-backed warehouse fields and request schemas."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-warehouse-actions"
    - "fakturownia-warehouse-documents"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "warehouse list"
    - "warehouse get"
    - "warehouse create"
    - "warehouse update"
    - "warehouse delete"
  cli_help: "fakturownia warehouse --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema warehouse list --json` for output discovery and `fakturownia schema warehouse create --json` before building warehouse payloads."
---

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

# Warehouses

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

## Use This Skill When

- The task is about reading or mutating warehouse definitions.
- You need README-backed warehouse fields before creating or updating a warehouse payload.

## Covered Commands

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

## Notable Flags

- `--page` (default `1`): Requested result page
- `--per-page` (default `25`): Requested result count per page
- `--id` (required): Warehouse ID
- `--input` (required): Warehouse JSON input as inline JSON, @file, or - for stdin
- `--yes` (required, default `false`): Confirm warehouse 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 warehouse list --json` and `fakturownia schema warehouse get --json` before building selectors.
- Read `output.known_fields` to discover conservative README-backed warehouse fields such as `name`, `kind`, and `description`.
- Use `fakturownia schema warehouse create --json` and `fakturownia schema warehouse 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 `warehouse` envelope.

## Examples

```bash
fakturownia warehouse list --json
fakturownia warehouse list --columns id,name,kind,description
fakturownia warehouse list --page 2 --per-page 25 --raw
fakturownia warehouse get --id 1
fakturownia warehouse get --id 1 --fields id,name,description --json
fakturownia warehouse get --id 1 --raw
fakturownia warehouse create --input '{"name":"my_warehouse","kind":null,"description":null}' --json
fakturownia warehouse create --input @warehouse.json
printf '%s\n' '{"name":"my_warehouse"}' | fakturownia warehouse create --input - --json
fakturownia warehouse create --input '{"name":"my_warehouse"}' --dry-run --json
fakturownia warehouse update --id 1 --input '{"description":"new_description"}' --json
fakturownia warehouse update --id 1 --input @warehouse-update.json
printf '%s\n' '{"name":"my_warehouse"}' | fakturownia warehouse update --id 1 --input - --json
fakturownia warehouse update --id 1 --input '{"description":"new_description"}' --dry-run --json
fakturownia warehouse delete --id 1 --yes --json
fakturownia warehouse delete --id 1 --yes
fakturownia warehouse delete --id 1 --yes --dry-run --json
```

## Related Skills

- [fakturownia-shared](../shared/SKILL.md)
- [fakturownia-warehouse-actions](../warehouse-actions/SKILL.md)
- [fakturownia-warehouse-documents](../warehouse-documents/SKILL.md)
- [fakturownia-schema](../schema/SKILL.md)
- [fakturownia-doctor](../doctor/SKILL.md)