# Faktury, paragony i korekty Faktury VAT, paragony i korekty w Ritevo: wystawianie z zamówień, numeracja, stawki VAT, OSS, WDT, PDF i przesyłanie do księgowości. Ritevo wystawia dokumenty sprzedaży prosto z zamówień: faktury VAT, paragony i korekty faktur. Dane bierzemy z zamówienia, a numer, stawki VAT, daty i dane sprzedawcy - z numeracji, czyli zestawu ustawień, który wybierasz przy wystawianiu. Gotowy dokument pobierzesz jako PDF i prześlesz do integracji księgowej. ## Rodzaje dokumentów - **Faktura VAT** (API: "Faktura VAT" = `INVOICE`; wartość w `billingType`) - ma termin płatności, kody GTU i procedury. - **Paragon** (API: "Paragon" = `RECEIPT`; wartość w `billingType`) - nie ma terminu płatności. Paragon możesz też wydrukować na drukarce fiskalnej. - **Korekta faktury** (API: "Korekta faktury" = `CORRECTION`; wartość w `billingType`) - poprawia wystawioną fakturę: dane sprzedawcy, dane nabywcy albo pozycje. Wystawiasz ją tylko do faktury. > **Warto wiedzieć:** Zamówienie może mieć naraz jedną fakturę i jeden paragon. Żeby wystawić nowy dokument tego samego rodzaju, usuń poprzedni. Korekt do jednej faktury możesz wystawić dowolnie wiele. ## Wystawianie Fakturę i paragon wystawiasz na trzy sposoby. Za każdym razem wybierasz numerację, według której powstanie dokument: - **W zamówieniu** - w karcie **Wystawione dokumenty** kliknij **Utwórz fakturę** albo **Utwórz paragon** i wybierz numerację z listy. - **Na liście zamówień** - zaznacz zamówienia i kliknij ikonę **Utwórz faktury** albo **Utwórz paragony**. Naraz do 1000 zamówień. Zamówienia, które mają już dokument tego rodzaju, pomijamy. - **Automatycznie** - krokiem **Wygeneruj fakturę** albo **Wygeneruj paragon** w [akcjach dla zamówień](https://ritevo.com/pl/docs/automations/order-actions). ![Karta Wystawione dokumenty w zamówieniu z rozwiniętym przyciskiem Utwórz fakturę i listą numeracji](https://ritevo.com/docs/orders/pl-billing-issue-invoice.webp) Nabywcą są dane firmy z zamówienia, czyli dane do faktury (nazwa, NIP, adres). Danych kupującego nie podstawiamy - jedynym wyjątkiem jest numer identyfikacyjny osoby, który bierzemy z danych kupującego. Jeśli zamówienie nie ma danych firmy, dokument nie ma nabywcy - uzupełnij dane w zamówieniu albo krokiem **Zaktualizuj dane firmy danymi kupującego** w [akcjach dla zamówień](https://ritevo.com/pl/docs/automations/order-actions) przed wystawieniem. Sprzedawcą jest firma wpisana w numeracji. Pozycje to produkty z zamówienia z ilością i ceną brutto, a przesyłka trafia na dokument według ustawień numeracji. Kwota zapłacona i waluta pochodzą z płatności zamówienia. Faktury i paragony: `POST /orders/billings/batch?billingType=INVOICE|RECEIPT&settingsId={id}` z listą id zamówień (1-1000) w treści. Działa w tle - odpowiedź 202, dokumenty powstają chwilę później, a błędy pojedynczych zamówień nie wracają w odpowiedzi. Pomijane są zamówienia z aktywnym dokumentem tego typu oraz nieistniejące i należące do innej firmy; gdy żadne się nie kwalifikuje - 409 `BILLING_ALREADY_EXISTS`. Numeracja innego typu albo innej firmy - 404 `BILLING_SETTINGS_BY_BILLING_TYPE_NOT_FOUND`; `billingType=CORRECTION` - 405. Listę numeracji zwraca `GET /orders/billing/settings`. W automatyzacji kroki `GENERATE_INVOICE`/`GENERATE_RECEIPT` przyjmują id numeracji. ## Numeracje Numeracja to zapisany zestaw ustawień dokumentu: wzór numeru, stawki VAT, przesyłka, daty, płatność i dane sprzedawcy. Znajdziesz je w **Zamówienia** → **Rozliczenia**, przycisk **Ustawienia numeracji**. Możesz mieć do 50 numeracji razem z domyślnymi, na przykład osobną dla sprzedaży za granicę. Rodzaju dokumentu numeracji nie zmienisz po utworzeniu. ![Strona Rozliczenia z listą dokumentów i zaznaczonym przyciskiem Ustawienia numeracji](https://ritevo.com/docs/orders/pl-billing-settings-where.webp) ![Lista numeracji z domyślnymi numeracjami faktury, korekty i paragonu oraz zaznaczonym przyciskiem Dodaj nową numerację](https://ritevo.com/docs/orders/pl-billing-settings-list.webp) Nową numerację dodasz przyciskiem **Dodaj nową numerację** - wybierasz rodzaj dokumentu: **Faktura VAT**, **Korekta faktury** albo **Paragon**. Numeracja powstaje z ustawieniami domyślnymi, które zmienisz w jej szczegółach. ![Rozwinięty przycisk Dodaj nową numerację z wyborem Faktura VAT, Korekta faktury i Paragon](https://ritevo.com/docs/orders/pl-billing-settings-add.webp) Każda firma dostaje na start po jednej domyślnej numeracji dla faktur, paragonów i korekt. Domyślnej numeracji nie usuniesz, tak samo jak numeracji, której używa już jakiś dokument. ### Format numeracji W polu **Format numeracji** wpisujesz wzór numeru. Zwykły tekst przepisujemy bez zmian, a znaczniki zamieniamy na wartości: | Znacznik | Co wstawiamy | Przykład | | --- | --- | --- | | `#N` | kolejny numer, zawsze 6 cyfr | 000001 | | `#MM` | miesiąc, dwie cyfry | 03 | | `#M` | miesiąc bez zera z przodu | 3 | | `#YYYY` | rok | 2026 | | `#YY` | rok, dwie ostatnie cyfry | 26 | Wzór `FV/#N/#MM/#YYYY` daje numery `FV/000001/03/2026`, `FV/000002/03/2026` i tak dalej. Domyślne wzory to `FV/#N/#MM/#YYYY` dla faktur, `P/#N/#MM/#YYYY` dla paragonów i `K/#N/#MM/#YYYY` dla korekt. Wielkość liter w znacznikach ma znaczenie. ![Podpowiedź przy polu Format numeracji z opisem znaczników #N, #MM, #M, #YYYY i #YY](https://ritevo.com/docs/orders/pl-billing-settings-format-hint.webp) > **Warto wiedzieć:** Licznik `#N` zaczyna się od 1 w każdym miesiącu, a miesiąc i rok w numerze to data wystawienia dokumentu. Dlatego wzór powinien mieć `#N`, miesiąc i rok - bez nich numery będą się powtarzać. Nie sprawdzamy tego przy zapisie. We wzorze działa jeden znacznik roku (`#YYYY` albo `#YY`) i jeden znacznik miesiąca (`#MM` albo `#M`). Licznik jest wspólny dla wszystkich numeracji tego samego rodzaju dokumentu. Jeśli masz dwie numeracje faktur, na przykład `FV/...` i `FE/...`, numery idą jednym ciągiem: `FV/000001`, `FE/000002`, `FV/000003`. ## Stawki VAT Stawkę dla produktów ustawiasz w numeracji w polu **Stawka VAT**: - **Z przypisaną stawką VAT produktu** (API: "Z przypisaną stawką VAT produktu" = `LINE_ITEM_ASSIGNED`; wartość w `taxRateOptions`) - każda pozycja dostaje stawkę, którą ma w zamówieniu. Domyślne ustawienie. - **OSS (Stawka VAT obowiązująca w kraju dostawy)** (API: "OSS (Stawka VAT obowiązująca w kraju dostawy)" = `VAT_OSS`; wartość w `taxRateOptions`) - stawka kraju, do którego jedzie paczka. Więcej w sekcji [OSS](#oss). - **Własna stawka VAT** (API: "Własna stawka VAT" = `CUSTOM`; wartość w `taxRateOptions`) - jedna stawka dla wszystkich produktów, wybrana w polu **Własna stawka VAT**. Przesyłka ma osobne pole **Stawka VAT dla przesyłki**: - **Proporcjonalnie do produktów** (API: "Proporcjonalnie do produktów" = `PROPORTIONAL_TO_PRODUCTS`; wartość w `shippingTaxRateOptions`) - przesyłka dostaje tę stawkę VAT, której pozycje mają największy udział w wartości brutto produktów na dokumencie (po pominięciu cen). Gdy na dokumencie nie ma produktów - 0%. Domyślne ustawienie. - **OSS (Stawka VAT obowiązująca w kraju dostawy)** (API: "OSS (Stawka VAT obowiązująca w kraju dostawy)" = `VAT_OSS`; wartość w `shippingTaxRateOptions`) - jak dla produktów, według kraju dostawy. - **Własna stawka VAT** (API: "Własna stawka VAT" = `CUSTOM`; wartość w `shippingTaxRateOptions`) - stawka wybrana w polu **Własna stawka VAT dla przesyłki**, domyślnie 23%. Oprócz zwykłych stawek procentowych są trzy stawki specjalne: - **Zw.** (API: "Zw." = `EXEMPT`; wartość w `lineItems[].taxRate`) - stawka zwolniona, na dokumencie „zw.". - **O.o** (API: "O.o" = `BUYER_CHARGED`; wartość w `lineItems[].taxRate`) - odwrotne obciążenie, na dokumencie „n.p.". - **WDT** (API: "WDT" = `ICSG`; wartość w `lineItems[].taxRate`) - stawka 0% oznaczona jako WDT. Więcej w sekcji [WDT](#wdt). ## OSS Przy ustawieniu OSS Ritevo samo dobiera stawkę VAT według kraju dostawy zamówienia. Tak ją włączysz: 1. W **Zamówienia** → **Rozliczenia** kliknij **Ustawienia numeracji** i dodaj numerację faktur albo paragonów, na przykład ze wzorem `OSS/#N/#MM/#YYYY`. 2. W polu **Stawka VAT** wybierz **OSS (Stawka VAT obowiązująca w kraju dostawy)**. 3. W polu **Stawka VAT dla przesyłki** też wybierz **OSS (Stawka VAT obowiązująca w kraju dostawy)**, żeby przesyłka miała tę samą stawkę co produkty. 4. Tę numerację wybierasz przy wystawianiu dokumentu - ręcznie albo w kroku akcji, na przykład z warunkiem **Kraj dostawy jest**. ![Ustawienia VAT numeracji z wybranym OSS w polach Stawka VAT i Stawka VAT dla przesyłki](https://ritevo.com/docs/orders/pl-billing-settings-oss.webp) Stawkę bierzemy z kraju adresu dostawy, nie z adresu kupującego. Używamy podstawowych stawek VAT (bez obniżonych). Dokument jest oznaczony jako OSS tylko wtedy, gdy OSS wybrano w polu **Stawka VAT** dla produktów; samo oznaczenie nie jest drukowane na PDF. Stawki według stanu na październik 2026: | Kraj | Kod | Stawka | | --- | --- | --- | | Austria | AT | 20% | | Belgia | BE | 21% | | Bułgaria | BG | 20% | | Cypr | CY | 19% | | Czechy | CZ | 21% | | Niemcy | DE | 19% | | Dania | DK | 25% | | Estonia | EE | 24% | | Hiszpania | ES | 21% | | Finlandia | FI | 25,5% | | Francja | FR | 20% | | Grecja | GR | 24% | | Chorwacja | HR | 25% | | Węgry | HU | 27% | | Irlandia | IE | 23% | | Włochy | IT | 22% | | Litwa | LT | 21% | | Luksemburg | LU | 17% | | Łotwa | LV | 21% | | Malta | MT | 18% | | Holandia | NL | 21% | | Polska | PL | 23% | | Portugalia | PT | 23% | | Rumunia | RO | 21% | | Szwecja | SE | 25% | | Słowenia | SI | 22% | | Słowacja | SK | 23% | > **Warto wiedzieć:** Jeśli kraju dostawy nie znajdziemy w tabeli - bo paczka jedzie poza Unię Europejską albo zamówienie nie ma kraju dostawy - ustawiamy stawkę 0%. > **Warto wiedzieć:** Stawka 0% jest też domyślna dla zamówień z kanałów sprzedaży: jeśli kanał nie przekaże stawki VAT pozycji, zamówienie przychodzi do Ritevo z 0%. Taka stawka trafi na dokument, jeśli w ustawieniach numeracji w polu **Stawka VAT** wybrano **Z przypisaną stawką VAT produktu**. Numeracja z OSS: `taxRateOptions: "VAT_OSS"` i `shippingTaxRateOptions: "VAT_OSS"`. Kraj: `delivery.address.countryCode` zamówienia; brak lub kraj spoza tabeli = `ZERO`. Dokument ma wtedy `oss: true` (tylko gdy `taxRateOptions` = `VAT_OSS`). Kraj zapisujemy w dokumencie jako `ossCountryCode` - także kraj spoza tabeli (np. `US`) przy stawce `ZERO`, a `null`, gdy zamówienie nie ma kraju dostawy; dokumenty sprzed października 2026 mają `null`. Integracja wFirma wysyła stawkę OSS według `ossCountryCode` i przyjmuje tylko kraje z tabeli. Pole `vatOss` w żądaniu numeracji nie jest zapisywane - decyduje `taxRateOptions`. Wartości stawek w API: `TaxRate`, np. `NINETEEN`, `TWENTY_THREE`, `TWENTY_FIVE_AND_A_HALF` (25,5%). ## WDT Stawka WDT to 0% z oznaczeniem WDT. Ritevo nie ustawia jej samo - dostaje ją dokument z numeracji, w której ją wybierzesz: 1. Dodaj numerację faktur, na przykład ze wzorem `WDT/#N/#MM/#YYYY`. 2. W polu **Stawka VAT** wybierz **Własna stawka VAT**, a w polu **Własna stawka VAT** - **WDT**. 3. W polu **Stawka VAT dla przesyłki** wybierz **Własna stawka VAT**, a w polu **Własna stawka VAT dla przesyłki** - **WDT**. 4. Tę numerację wybierasz przy wystawianiu faktury. Numer VAT nabywcy bierzemy z danych firmy w zamówieniu i nie sprawdzamy go. ![Ustawienia VAT numeracji z wybraną własną stawką WDT dla produktów i dla przesyłki](https://ritevo.com/docs/orders/pl-billing-settings-wdt.webp) ## Pozostałe ustawienia numeracji Poza numerem i stawkami numeracja decyduje o tym, co jeszcze trafia na dokument. ![Szczegóły numeracji faktury: ustawienia główne z formatem numeracji, daty i płatność, dane firmy i ustawienia VAT](https://ritevo.com/docs/orders/pl-billing-settings-invoice.webp) ### Przesyłka - **Nie uwzględniaj przesyłki** (API: "Nie uwzględniaj przesyłki" = `NONE`; wartość w `shippingInclusionType`) - dokument ma tylko produkty. - **Zawsze uwzględniaj przesyłkę** (API: "Zawsze uwzględniaj przesyłkę" = `INCLUDE_ALWAYS`; wartość w `shippingInclusionType`) - przesyłka jest osobną pozycją, także gdy kosztuje 0. Domyślne ustawienie. - **Uwzględniaj, jeśli koszt wysyłki jest powyżej 0** (API: "Uwzględniaj, jeśli koszt wysyłki jest powyżej 0" = `INCLUDE_IF_POSITIVE`; wartość w `shippingInclusionType`) - darmowa przesyłka nie trafia na dokument. - **Dodaj koszt przesyłki do ostatniego produktu** (API: "Dodaj koszt przesyłki do ostatniego produktu" = `ADD_TO_LAST_PRODUCT`; wartość w `shippingInclusionType`) - koszt przesyłki rozkładamy na sztuki ostatniej pozycji zamiast dodawać osobną: 4 sztuki po 5 zł i przesyłka 20 zł dają 4 sztuki po 10 zł. Jeśli koszt nie dzieli się równo na grosze, resztę groszy dostaje jedna wydzielona sztuka (3 sztuki po 5 zł i przesyłka 20 zł: 2 po 11,66 zł i 1 po 11,68 zł), więc suma zawsze zgadza się z zamówieniem. Przesyłka dostaje wtedy stawkę VAT tej pozycji - pole **Stawka VAT dla przesyłki** nie ma znaczenia. Jeśli wszystkie produkty zostaną pominięte, przesyłki nie ma na dokumencie. Pozycja przesyłki nazywa się tak jak metoda dostawy z zamówienia. W polu **Prefiks dla dostawy** możesz dopisać przed nią tekst, na przykład „Dostawa: ". ### Pomijanie produktów z cenami - **Uwzględnij wszystkie ceny** (API: "Uwzględnij wszystkie ceny" = `INCLUDE_ALL`; wartość w `priceSkipOption`) - na dokument trafiają wszystkie produkty z ceną. Pozycje bez ceny pomijamy zawsze. Domyślne ustawienie. - **Pomiń ceny równe 0** (API: "Pomiń ceny równe 0" = `SKIP_ZERO`; wartość w `priceSkipOption`) - bez gratisów i pozycji za 0. - **Pomiń ceny ujemne** (API: "Pomiń ceny ujemne" = `SKIP_NEGATIVE`; wartość w `priceSkipOption`) - bez rabatów zapisanych jako osobne pozycje z ujemną ceną. - **Pomiń ceny równe 0 i ujemne** (API: "Pomiń ceny równe 0 i ujemne" = `SKIP_BOTH`; wartość w `priceSkipOption`) - oba naraz. ### Daty i płatność - **Data sprzedaży taka jak data wystawienia** (API: "Data sprzedaży taka jak data wystawienia" = `SAME_AS_ISSUE_DATE`; wartość w `saleDateTerm`) - data sprzedaży to dzień wystawienia dokumentu. - **Data sprzedaży taka jak data płatności (lub aktualna)** (API: "Data sprzedaży taka jak data płatności (lub aktualna)" = `SAME_AS_PAYMENT_DATE`; wartość w `saleDateTerm`) - dzień opłacenia zamówienia, a jeśli nie jest opłacone - dzień wystawienia. - **Data sprzedaży taka jak data zamówienia** (API: "Data sprzedaży taka jak data zamówienia" = `SAME_AS_ORDER_DATE`; wartość w `saleDateTerm`) - dzień złożenia zamówienia. Domyślne ustawienie. Datą wystawienia jest zawsze chwila utworzenia dokumentu. **Termin płatności** liczymy od niej - wybierasz go z listy: **Brak terminu** (dokument nie ma terminu płatności), **Termin płatności na dzień wystawienia** albo od 3 do 120 dni (domyślnie 14 dni). Paragon nie ma terminu płatności. Metodę płatności ustawiasz w polu **Ustawienia płatności**: - **Z zamówienia** (API: "Z zamówienia" = `USE_FROM_ORDER`; wartość w `paymentMethodSettings`) - metoda płatności z zamówienia, a gdy jej brak - **Inne**. Domyślne ustawienie. - **Własne ustawienie** (API: "Własne ustawienie" = `CUSTOM`; wartość w `paymentMethodSettings`) - stała metoda wybrana w polu **Metoda płatności**, na przykład **Przelew**. ### Dane wystawcy i dodatkowe - **Dane wystawcy** - **Nazwa wystawcy** i **Miasto wystawienia**. Puste pola nie pojawiają się na dokumencie. - **Dane firmy** - dane sprzedawcy, tylko w numeracji faktur i paragonów. Korekta bierze sprzedawcę z faktury. - **Podstawowa jednostka miary (np. szt, kg, usł)** - jednostka każdej pozycji. Domyślnie „szt.". - **Kody GTU** i **Procedury** - oznaczenia zapisywane w fakturach i korektach i przekazywane do integracji księgowej. Nie są drukowane na PDF. - **Dodatkowe informacje na fakturze (jeśli dostępne)** - stały tekst zapisywany w dokumencie i przekazywany do integracji księgowej. Nie pojawia się na PDF wygenerowanym przez Ritevo. Numeracje: `GET /orders/billing/settings`, `GET`/`PATCH`/`DELETE /orders/billing/settings/{id}`. `POST /orders/billing/settings?billingType=INVOICE|RECEIPT|CORRECTION` (bez treści) tworzy numerację z wartościami domyślnymi - 201, a 422 `LIMIT_EXCEPTION` po przekroczeniu 50 (razem z domyślnymi). Pola ustawiasz przez `PATCH`: `name`, `numberFormat` i `defaultUnit` są wymagane, pozostałe `null` nie są zmieniane, a pola logiczne zawsze się nadpisują. Pola: `taxRateOptions` (`LINE_ITEM_ASSIGNED`, `VAT_OSS`, `CUSTOM`), `taxRate` (`TaxRate`, domyślnie `TWENTY_THREE`), `shippingInclusionType` (`NONE`, `INCLUDE_ALWAYS`, `INCLUDE_IF_POSITIVE`, `ADD_TO_LAST_PRODUCT`), `shippingTaxRateOptions` (`PROPORTIONAL_TO_PRODUCTS`, `VAT_OSS`, `CUSTOM`; ignorowane przy `ADD_TO_LAST_PRODUCT` - przesyłka ma stawkę ostatniej pozycji), `shippingTaxRate` (domyślnie `TWENTY_THREE`), `prefixForDeliveryName`, `priceSkipOption` (`INCLUDE_ALL`, `SKIP_ZERO`, `SKIP_NEGATIVE`, `SKIP_BOTH`), `paymentMethodSettings` (`USE_FROM_ORDER`, `CUSTOM`), `paymentMethod` (`BANK_TRANSFER` domyślnie, `CASH`, `CASH_ON_DELIVERY`, `COMPENSATION`, `CARD`, `PAYU`, `PAYPAL`, `P24`, `OTHER`), `saleDateTerm` (`SAME_AS_ISSUE_DATE`, `SAME_AS_PAYMENT_DATE`, `SAME_AS_ORDER_DATE`), `dueDateTerm` (`NONE_DISPLAY`, `ISSUE_DATE`, `DAYS_3`, `DAYS_7`, `DAYS_14`, `DAYS_21`, `DAYS_30`, `DAYS_45`, `DAYS_60`, `DAYS_90`, `DAYS_120`), `issueCity`, `issuerName`, `sellerCompany`, `gtuCodes` (`GTU_01`-`GTU_13`), `taxProcedures` (`TT_WNT`, `TT_D`, `I_42`, `I_63`, `B_SPV`, `B_SPV_DOSTAWA`, `B_MPV_PROWIZJA`, `SW`, `EE`, `WSTO_EE`, `VAT_RR`, `IED`, `TP`, `MR_T`, `MR_UZ`, `MPP`, `IMP`, `WEW`, `RO`, `FP`, `MK`), `additionalInformation`. Pola `recalculateCurrency`, `recalculateToCurrency`, `exchangeRateDate`, `countryCodeLanguage`, `unitPriceDisplay`, `displayVat` są przyjmowane, ale nie działają. Usuwanie: domyślna numeracja - 409 `DEFAULT_BILLING_SETTINGS_DELETION`; numeracja użyta przez dokumenty, także usunięte - 423 `BILLING_SETTINGS_REFERENCE`. ## Edycja i usuwanie - **Edycja** - w szczegółach dokumentu zmienisz dane sprzedawcy, dane nabywcy i pozycje (dodasz, poprawisz, usuniesz). Kwoty netto, VAT i sumy przeliczamy po każdej zmianie. Jeśli dokument wystawiono bez danych nabywcy, dopiszesz je tutaj. - **Usuwanie** - usunięty dokument znika z zamówienia, ale zostaje na liście **Rozliczenia** oznaczony jako usunięty, i można wystawić nowy. Faktury z korektą nie da się usunąć - najpierw usuń korekty. Naraz usuniesz do 1000 dokumentów; jeśli choć jedna z wybranych faktur ma korektę, nie usuniemy żadnego. ## Korekty Korektę tworzysz w szczegółach faktury przyciskiem **Utwórz korektę** albo ikoną przy fakturze na liście **Rozliczenia** - najpierw wybierasz numerację korekt. Korekta ma własną numerację i własny licznik, a numeracja korekt ma tylko ustawienia płatności, dat, wystawcy, jednostki, kodów GTU i procedur. Zaznaczasz, co poprawiasz: - **Korekta sprzedającego** - nowe dane sprzedawcy. - **Korekta kupującego** - nowe dane nabywcy. - **Korekta pozycji zamówienia** - nowa, pełna lista pozycji. Pozycja, której nie ma na liście, znika z korekty. ![Okno Utwórz korektę z polem Powód korekty, przełącznikami korekty i listą pozycji](https://ritevo.com/docs/orders/pl-billing-correction-dialog.webp) Dane sprzedawcy, nabywcy i pozycje, których nie zaznaczysz, przepisujemy z faktury. Daty, metodę płatności, kody GTU, procedury i dane wystawcy bierzemy z numeracji korekt. **Powód korekty** (do 255 znaków) wpisujesz przy tworzeniu - pole jest opcjonalne, a powód jest drukowany na PDF korekty. Waluta, kwota zapłacona i oznaczenie OSS przechodzą z faktury. Korekt nie wystawisz do paragonu ani do innej korekty, a automatyzacje ich nie tworzą. ![Szczegóły numeracji korekty: ustawienia główne, daty i płatność, dane wystawcy i kody GTU](https://ritevo.com/docs/orders/pl-billing-settings-correction.webp) Korekta: `POST /orders/billings/{invoiceId}/correction?settingsId={id}` - tylko do nieusuniętej faktury (`INVOICE`); odpowiedź 202, a 404 dla usuniętej lub nieistniejącej faktury i numeracji innego typu. Pola: flagi `correctionSeller`, `correctionBuyer`, `correctionLineItems` oraz `correctedSellerDetails`, `correctedBuyerDetails`, `correctedLineItems[]` (`name`, `quantity`, `unit`, `amount` - brutto za sztukę, `taxRate`; wymagane `quantity`, `amount`, `taxRate`), `correctionReason` do 255 znaków, opcjonalny. Flaga `true` bez danych - dane z faktury; `correctionLineItems: true` z pustą listą daje korektę bez pozycji. Korekta ma `originalInvoiceId`, a faktura listę `corrections`. ## PDF, druk i księgowość - **PDF** - każdy dokument pobierzesz jako PDF wygenerowany przez Ritevo, także po usunięciu; plik nazywa się jak numer dokumentu. Korekta pozycji pokazuje tabelę pozycji przed i po korekcie oraz różnicę w podsumowaniu VAT i kwocie do zapłaty. Korekta danych sprzedawcy albo nabywcy pokazuje te dane przed i po korekcie. - **Druk** - paragon wydrukujesz na drukarce podłączonej przez [Ritevo Printer](https://ritevo.com/pl/docs/integrations/ritevo-printer). Faktur i korekt na razie nie drukujemy. - **Księgowość** - dokument prześlesz do integracji księgowej w jego szczegółach, w karcie **Zew. systemy księgowe**, a fakturę albo paragon także krokiem akcji. Usuniętego dokumentu nie prześlesz. Który rodzaj dokumentu przyjmuje dana integracja, znajdziesz na jej stronie w sekcji integracji. ## Dokumenty w automatyzacjach Akcje dla zamówień potrafią wystawić fakturę albo paragon, usunąć je, przesłać do księgowości i wydrukować paragon. Wyzwalacze reagują na dodanie i usunięcie faktury albo paragonu oraz na ich udane przesłanie do księgowości, a warunki sprawdzają, czy zamówienie ma fakturę, paragon albo korektę, czy dokument został przesłany i czy klient prosi o fakturę. Pełna lista jest w [akcjach dla zamówień](https://ritevo.com/pl/docs/automations/order-actions). ## Czego nie robi - Nie ustawia samo stawki WDT - dostaje ją dokument z numeracji, w której ją wybierzesz. - Nie sprawdza numeru VAT UE nabywcy. - Nie przelicza kwot na inną walutę - dokument jest w walucie płatności zamówienia. - Nie wystawia PDF w innym języku niż polski. - Nie wysyła dokumentów e-mailem do klienta. - Opcje **Przeliczenie walut**, **Język dokumentu**, **Wyświetlanie cen** i **Pokazuj VAT** w ustawieniach numeracji na razie nie zmieniają dokumentu ani PDF. ## API Dokumenty: `GET /orders/billings` (lista ze stronicowaniem i filtrami), `GET /orders/billings/{id}`, `GET /orders/billings/pdf/{id}` (PDF Ritevo), `GET /orders/billings/{id}/get-external-billing-pdf/{accountingIntegrationId}` (PDF z integracji księgowej, po udanym przesłaniu), `PATCH /orders/billings/{id}/buyer` i `/seller` (zastępują całe dane - `null` czyści pole), `PATCH /orders/billings/{id}/paid-amount` z `{paidAmount}`, `POST /orders/billings/{id}/line-items`, `PATCH`/`DELETE /orders/billings/{id}/line-items/{lineItemId}`, `DELETE /orders/billings/batch` (do 1000, w tle; 422 `BILLING_HAS_CORRECTION`, gdy któraś faktura ma korektę), `POST /orders/billings/{billingId}/transfer-to-external-accounting/{integrationId}` (202; 409 `BILLING_ALREADY_TRANSFERRED`, gdy przesłanie do tej integracji udało się lub trwa; 404 dla usuniętego), `POST /orders/billings/{id}/print/{printerIntegrationId}` (202; 404, gdy to nie nieusunięty paragon). Edycja przez API nie jest blokowana dla dokumentów usuniętych ani przesłanych. Pola dokumentu: `id`, `orderId`, `billingSettingsId`, `billingType`, `billingNumber`, `sequenceNumber`, `sequenceMonth`, `sequenceYear`, `issueDate`, `saleDate`, `dueDate` (null dla paragonu), `paymentMethod`, `issuerName`, `issueCity`, `buyerDetails`, `sellerDetails`, `lineItems[]` (`name`, `quantity`, `unit`, `taxRate` oraz `amount`, `netAmount`, `taxAmount` - wartości za jedną sztukę: brutto, netto, VAT), `totalToPayAmount`, `totalToPayNetAmount`, `totalTaxAmount`, `paidAmount`, `currencyCode`, `oss`, `gtuCodes`, `taxProcedures`, `additionalInformation`, `correctionReason`, `originalInvoiceId`, `corrections[]`, `deleted`, `externalTransfers[]`. Aktualne ścieżki i pola są w Swaggerze: https://api.ritevo.com/api/v1/api-docs. --- Cała pomoc w jednym pliku: https://ritevo.com/llms-full.txt. Mapa pomocy z linkami do wszystkich stron: https://ritevo.com/llms.txt.