Utwórz fakturę
Zakres: api:invoices:write. Niewysłane kwoty są wyliczane z services. Faktura powstaje jako draft.
Przy send_to_ksef=true nieudana wysyłka nie powoduje błędu żądania; błąd trafia wtedy do ksef_data.
POST
https://api.sandbox-infakt.pl/v3/invoices.jsonAutoryzacja
Query parameters
Treść żądania JSON required
- invoiceobjectwymagane
invoice_datedomyślnie to dzisiejsza data, apayment_datetoinvoice_dateplus termin płatności klienta lub konta.client_company_name(alboclient_first_nameiclient_last_namedla osób prywatnych) orazclient_citysą wymagane, chyba że rodzaj faktury nie ma klienta.sales_kinddomyślnie ma wartośćsprzedaz_podstawowa.vat_exchange_date_kinddomyślnie pochodzi z ustawień konta i jest wymagane dla walut obcych.
Example requests
{
"invoice": {
"kind": "vat",
"payment_method": "transfer",
"invoice_date": "2026-10-01",
"sale_date": "2026-10-01",
"payment_date": "2026-10-15",
"client_id": 1003,
"bank_account": "61109010140000071219812874",
"services": [
{
"name": "Usługa programistyczna",
"tax_symbol": "23",
"unit": "godz.",
"quantity": 1,
"unit_net_price": 10000,
"pkwiu": "62.01.11.0"
}
]
}
}{
"invoice": {
"client_id": 123456,
"services": [
{
"name": "Usługa programistyczna",
"tax_symbol": "23",
"unit_net_price": 10000
}
]
}
}Odpowiedzi
201
Utworzono
JSON
401
Brak klucza API, nieprawidłowy klucz albo klucz bez wymaganego zakresu uprawnień.
JSON
402
API niedostępne w obecnym planie (limit: plan_upgrade_needed) albo osiągnięty limit dokumentów.
JSON
403
Brak uprawnień, limit planu dla tej akcji (limit) albo zawieszone konto.
JSON
406
Ścieżka nie kończy się na .json.
JSON
422
Walidacja nie powiodła się; szczegóły w errors.
JSON
423
Niepotwierdzony adres e-mail albo wymagana weryfikacja tożsamości.
JSON
429
Przekroczony limit zapytań. Komunikat jest po angielsku, np. API rate limit exceeded. Try again in 60 seconds.
JSON