Przejdź do treści

API - dodawanie faktur z rabatem kwotowym lub procentowym

Wyświetleń: 8985 3 min czytania

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}                     ]                 }}'              Skąd pobrać kod autoryzacyjny API? Wywołanie faktury e-mailem do klienta przez API Integracja z Sugesterem 

Czy ten wpis był pomocny?

Udostępnij

Główna odpowiedź Julia Ziółkowska 2025-10-09 16:57

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

Komentarze (4)

Julia Ziółkowska 2025-10-09 16:57 Główna odpowiedź
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
Anonymous 2025-10-08 22:14
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?