---
name: "fakturownia-invoice-ksef-create-send"
description: "Create an invoice with the API-native `gov` companion flag that queues the document for KSeF submission right away."
metadata:
  bundle: "fakturownia"
  category: "recipe"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-invoices"
    - "fakturownia-schema"
  command_refs:
    - "invoice create"
    - "invoice update"
---

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

# Create And Immediately Send To KSeF

> Read [fakturownia-invoices](../../subskills/invoices/SKILL.md) first.

Use this when the invoice should go to KSeF as part of the same create or update call.

`gov` is the upstream API name for the KSeF integration surface.

## Create And Queue For KSeF

```bash
fakturownia invoice create \
  --gov-save-and-send \
  --input '{
    "kind":"vat",
    "buyer_company":true,
    "seller_tax_no":"5252445767",
    "seller_street":"ul. Przykładowa 10",
    "seller_post_code":"00-001",
    "seller_city":"Warszawa",
    "buyer_name":"Klient ABC Sp. z o.o.",
    "buyer_tax_no":"9876543210",
    "positions":[{"name":"Usługa","quantity":1,"total_price_gross":1230,"tax":23}]
  }' \
  --json
```

## Update And Requeue For KSeF

```bash
fakturownia invoice update --id 111 --gov-save-and-send --input '{"buyer_tax_no_kind":"nip_ue","buyer_tax_no":"DE123456789"}' --json
```

## Notes

- `--gov-save-and-send` is a top-level companion flag outside the inner invoice object.
- Inspect `fakturownia schema invoice create --json` before automating KSeF payload generation.

## Related Skills

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