Faktura cykliczna przez API - własna definicja towaru i kupującego

Faktura cykliczna przez API - własna definicja towaru i kupującego

Podczas tworzenia faktury cyklicznej przez API z własną definicją (bez wskazywania istniejącej faktury jako wzorca) wymagane jest podanie “department_id” - bez tego pola system zwraca błąd z komunikatem o konieczności wyboru dokumentu lub wypełnienia własnej definicji.

Jak znaleźć “department_id”?

1. Zaloguj się do Fakturowni i przejdź do Ustawienia > Dane firmy.
2. Kliknij w formularz edycji działu.
3. Sprawdź pasek adresu w przeglądarce - znajdziesz tam fragment podobny do: departments/1234567890/edit.
4. Liczba między departments/ a /edit to Twoje department_id.

Przykładowe poprawne zapytanie

curl https://twojadomena.fakturownia.pl/recurrings.json \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' \
    -d '{
        "api_token": "TWOJ_TOKEN_API",
        "recurring": {
            "name": "Nazwa cykliczności - własna definicja",
            "start_date": "2026-07-01",
            "every": "1m",
            "issue_working_day_only": false,
            "send_email": true,
            "buyer_email": "email@kupujacy.pl",
            "department_id": 1234567890,
            "client_id": 9876543210,
            "product_id": 8844775511336,
            "price_gross": "80.00",
            "currency": "PLN",
            "quantity": "1.0"
        }
    }'

Kluczowa różnica względem zapytania na podstawie faktury to obecność pola department_id.

Wiele pozycji na fakturze cyklicznej (własna definicja)

Własna definicja w trybie API obsługuje jedną pozycję na fakturze cyklicznej. Jeśli potrzebujesz faktury z wieloma pozycjami, skonfiguruj cykl na podstawie istniejącej faktury, która zawiera wszystkie wymagane pozycje.