---
name: "fakturownia-warehouse-documents"
description: "Fakturownia CLI warehouse documents: list, fetch, create, update, and delete warehouse documents, including kind selection and invoice linking through payload fields."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-products"
    - "fakturownia-invoices"
    - "fakturownia-warehouses"
    - "fakturownia-warehouse-actions"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "warehouse-document list"
    - "warehouse-document get"
    - "warehouse-document create"
    - "warehouse-document update"
    - "warehouse-document delete"
  cli_help: "fakturownia warehouse-document --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema warehouse-document list --json` for output discovery and `fakturownia schema warehouse-document create --json` before building `warehouse_actions[]` or `invoice_ids[]` payloads."
---

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

# Warehouse Documents

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

## Use This Skill When

- The task is about warehouse transfers, receipts, releases, or related warehouse-document maintenance.
- You need to choose warehouse document kinds through the payload, or link invoices using `invoice_ids[]` during updates.

## Covered Commands

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

## Notable Flags

- `--page` (default `1`): Requested result page
- `--per-page` (default `25`): Requested result count per page
- `--id` (required): Warehouse document ID
- `--input` (required): Warehouse document JSON input as inline JSON, @file, or - for stdin
- `--yes` (required, default `false`): Confirm warehouse document 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 warehouse-document list --json
fakturownia warehouse-document list --columns id,kind,number,client_name
fakturownia warehouse-document list --page 2 --per-page 25 --raw
fakturownia warehouse-document get --id 15
fakturownia warehouse-document get --id 15 --fields id,kind,warehouse_actions[].quantity --json
fakturownia warehouse-document get --id 15 --raw
fakturownia warehouse-document create --input '{"kind":"mm","warehouse_id":1,"warehouse_actions":[{"product_id":7,"quantity":2,"warehouse2_id":3}]}' --json
fakturownia warehouse-document create --input '{"kind":"wz","client_id":12,"warehouse_actions":[{"product_id":7,"tax":"23","price_net":"100","quantity":2}]}' --json
fakturownia warehouse-document create --input @warehouse-document.json
fakturownia warehouse-document create --input '{"kind":"mm"}' --dry-run --json
fakturownia warehouse-document update --id 15 --input '{"invoice_ids":[100,111]}' --json
fakturownia warehouse-document update --id 15 --input @warehouse-document-update.json
fakturownia warehouse-document update --id 15 --input '{"kind":"pz"}' --dry-run --json
fakturownia warehouse-document delete --id 15 --yes --json
fakturownia warehouse-document delete --id 15 --yes
fakturownia warehouse-document delete --id 15 --yes --dry-run --json
```

## Related Skills

- [fakturownia-shared](../shared/SKILL.md)
- [fakturownia-products](../products/SKILL.md)
- [fakturownia-invoices](../invoices/SKILL.md)
- [fakturownia-warehouses](../warehouses/SKILL.md)
- [fakturownia-warehouse-actions](../warehouse-actions/SKILL.md)
- [fakturownia-schema](../schema/SKILL.md)
- [fakturownia-doctor](../doctor/SKILL.md)