API - dodawanie faktur z rabatem kwotowym lub procentowym

Utworzono: 2014-01-14
Ostatnia aktualizacja: 2025-10-09
Liczba odwiedzin posta: 7440

Chcesz dodać fakturę z rabatem poprzez API? W Fakturowni możesz uwzględnić zarówno rabaty kwotowe, jak i procentowe przy automatycznym wystawianiu faktur. Dowiedz się, jak poprawnie sformatować dane i z jakich parametrów skorzystać, aby sprawnie zarządzać rabatami na fakturach tworzonych przez API.     
 

API - dodawanie faktur z rabatem kwotowym lub procentowym


Dzięki API, Fakturownię można w łatwy sposób zintegrować z innymi aplikacjami. W związku z pytaniami i nieścisłościami z tym związanymi podajemy przykłady wywołania za pomocą narzędzia cURL, które można łatwo zastąpić wywołaniem dowolnego języka programowania.

Przykłady wywołań faktur z rabatem kwotowym lub procentowym dostępne są pod TYM linkiem. 


Wywołanie faktury z rabatem procentowym
 

UWAGA! Przed wywołaniem należy sprawdzić czy w zakładce Ustawienia > Ustawienia konta > Konfiguracja > Sposoby wyliczania > Jak obliczać rabat ustawiona jest opcja procentowo od ceny jednostkowej netto.

curl https://YOUR_DOMAIN.fakturownia.pl/invoices.json \
                -H 'Accept: application/json' \
                -H 'Content-Type: application/json' \
                -d '{
                "api_token": "API_TOKEN",
                "invoice": {
                    "kind":"vat",
                    "number": null,
                    "sell_date": "2025-03-31",
                    "issue_date": "2025-03-31",
                    "payment_to": "2025-04-07",
                    "seller_name": "Seller SA",
                    "seller_tax_no": "6272616681",
                    "buyer_name": "Client1 SA",
                    "buyer_tax_no": "6272616681",
                    "show_discount": true,
                    "discount_kind": "percent_unit",
                    "positions":[
                        {"name":"Produkt A1", "tax":23, "total_price_gross":10.23, "quantity":1, "discount_percent": 50},
                        {"name":"Produkt A2", "tax":0, "total_price_gross":50, "quantity":2, "discount_percent": 10}
                    ]
                }}'

 

Wywołanie faktury z rabatem kwotowym


UWAGA! Przed wywołaniem należy sprawdzić czy w zakładce Ustawienia > Ustawienia konta > Konfiguracja > Sposoby wyliczania > Jak obliczać rabat ustawiona jest opcja kwotowo.

curl https://YOUR_DOMAIN.fakturownia.pl/invoices.json \
                -H 'Accept: application/json' \
                -H 'Content-Type: application/json' \
                -d '{
                "api_token": "API_TOKEN",
                "invoice": {
                    "kind":"vat",
                    "number": null,
                    "sell_date": "2025-03-31",
                    "issue_date": "2025-03-31",
                    "payment_to": "2025-04-07",
                    "seller_name": "Seller SA",
                    "seller_tax_no": "6272616681",
                    "buyer_name": "Client1 SA",
                    "buyer_tax_no": "6272616681",
                    "show_discount": true,
                    "discount_kind": "amount",
                    "positions":[
                        {"name":"Produkt A1", "tax":23, "total_price_gross":10.23, "quantity":1, "discount": 5},
                        {"name":"Produkt A2", "tax":0, "total_price_gross":50, "quantity":2, "discount": 25}
                    ]
                }}'

            

Sprawdź również:
Integracja API co to jest?

Skąd pobrać kod autoryzacyjny API?
Wywołanie faktury e-mailem do klienta przez API
Integracja z Sugesterem 


Powrót


Komentarze

Avatar sugester medium
Paweł
Chciałbym dodać rabat kwotowy, ale jako wartość ujemna od całkowitej kwoty zamówienia. np. klient wpisuje podczas zamawiania kod kuponu, który obniża cała wartość zamówienia o np. 10 zł. Jak to przesłać przez API do fakturowni?

2025-10-08 22:14


juliaz
juliaz
Odpowiedź główna   Dzień dobry,

w Fakturowni nie ma możliwości dodania rabatu kwotowego obniżającego wartość całego dokumentu. Opcja rabatu działa jako przypisanie rabatu (procentowo lub kwotowo) do konkretnych pozycji za pomocą parametru "discount" : "" (zgodnie z naszą dokumentacją https://github.com/fakturownia/API).

Z tego powodu, jeśli chce Pan obniżyć wartość zamówienia o 10zł, w żądaniu API powinien zostać przesłany proporcjonalny rabat do każdej pozycji z osobna.

W razie dodatkowych pytań, pozostaję do dyspozycji.

Pozdrawiam
Julia

2025-10-09 16:57


Dodaj komentarz