Create an unsent invoice document
superfaktura_create_invoiceDestructive
WRITE: creates ONE document in SuperFaktura for the user to review: type draft (concept, default), estimate (quote), order or proforma. A final regular invoice cannot be created here. It is NOT sent (no e-mail, no post), NOT marked paid or sent, and has no payment link or discount. Give an existing client_id (its name is read first with one extra GET /clients/view/{id}, so the call uses 2 requests of the daily quota) OR a new client's name (+ optional ico/dic/ic_dph/address...). Items: name, unit price without VAT, VAT rate, quantity. Not idempotent: pass a checksum (max 32 chars) so a timed-out call can be recovered with superfaktura_get_response_by_checksum instead of retried. POST /invoices/create.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| due | No | Due date. | |
| name | No | Document title (default generated from the number). | |
| type | No | Document type: draft (default), estimate, order or proforma. | |
| items | Yes | 1-100 items. | |
| comment | No | Comment on the document. | |
| created | No | Issue date (default today). | |
| checksum | No | Your own unique token (max 32 chars) to recover the reply if the call times out. | |
| constant | No | Constant symbol. | |
| delivery | No | Delivery date. | |
| order_no | No | Order number. | |
| specific | No | Specific symbol. | |
| variable | No | Variable symbol (the document number when empty). | |
| client_id | No | Existing client id (superfaktura_list_clients). Give this OR client_name. | |
| client_dic | No | Client tax id (DIČ), with client_name. | |
| client_ico | No | Client company id (IČO), with client_name. | |
| client_zip | No | Client ZIP, with client_name. | |
| client_city | No | Client city, with client_name. | |
| client_name | No | Name of a new/matching client (used when client_id is not given). | |
| sequence_id | No | Numbering sequence id (superfaktura_list_sequences). | |
| client_email | No | Client e-mail, with client_name (stored only; nothing is sent). | |
| client_ic_dph | No | Client VAT id, with client_name. | |
| client_address | No | Client street and number, with client_name. | |
| header_comment | No | Comment above the items (shown on the document). | |
| internal_comment | No | Internal comment (not shown on the document). | |
| invoice_currency | No | 3-letter currency code, e.g. EUR, CZK. | |
| client_country_id | No | Client country id (superfaktura_list_countries), with client_name. |