Skapa
De två verktyg som skriver direkt, utan godkännande.
De här verktygen skriver direkt, men skapar inga bokföringsposter. Ett fakturautkast har inget fakturanummer och ingen verifikation. Båda går genom samma regler som appen.
create_customer
Skapa kund. Skapar en ny kund i kundregistret. Kontrollera först med list_customers att kunden inte redan finns. Kundnumret tilldelas automatiskt.
| Parameter | Typ | Krävs | Begränsning | Standard |
|---|---|---|---|---|
name | string | ja | 1–1024 tecken | |
org_number | string | nej | max 20 tecken | |
vat_number | string | nej | max 20 tecken | |
email | string | nej | max 320 tecken | |
phone | string | nej | max 50 tecken | |
address | string | nej | max 1024 tecken | |
postal_code | string | nej | max 10 tecken | |
city | string | nej | max 200 tecken | |
country_code | string | nej | max 2 tecken, ISO 3166-1 | SE |
notes | string | nej | max 1024 tecken |
Värden trimmas, och tomma strängar räknas som inte angivna.
Returnerar: id, customer_number, name och message.
Lägg upp Acme AB, org.nr 556677-8899, [email protected], som ny kund.
create_invoice_draft
Skapa fakturautkast. Skapar ett UTKAST till kundfaktura. Utkastet får inget fakturanummer, bokförs inte och skickas inte. Användaren granskar och skickar det själv i Klirr. Beloppen anges exklusive moms; Klirr räknar ut moms och summor. Använd vanlig svensk moms (25, 12, 6 eller 0 procent).
| Parameter | Typ | Krävs | Begränsning | Standard |
|---|---|---|---|---|
customer_number | string | ett av två | max 50 tecken | |
customer_id | string | ett av två | UUID. Används före customer_number. | |
invoice_date | string | nej | ÅÅÅÅ-MM-DD | i dag |
due_date | string | nej | ÅÅÅÅ-MM-DD, inte före fakturadatum | fakturadatum + 30 dagar |
notes | string | nej | max 2000 tecken, visas på fakturan | |
items | array | ja | 1–200 rader |
Varje rad i items:
| Fält | Typ | Krävs | Begränsning |
|---|---|---|---|
description | string | ja | 1–1000 tecken |
quantity | number | ja | |
unit_price | number | ja | kronor exklusive moms |
vat_rate | number | ja | 25, 12, 6 eller 0 |
Utkastet räknas mot planens fakturakvot. När kvoten är slut får du ett fel.
Returnerar: id, document_number, status, invoice_date, due_date, subtotal, vat_amount, total och message.
Gör ett fakturautkast till kund 1004: 12 timmar konsulting à 950 kr, 25 % moms.