Fakturownia
Integracja z Fakturownia.pl wystawia dokumenty sprzedaży z zamówień, oznacza je jako opłacone, pobiera PDF dla klienta i wystawia korekty. Każda firma ma osobne konto testowe i produkcyjne, a tryb testowy tworzy wyłącznie proformy, które nie trafiają do KSeF i nie mają mocy prawnej.
Na tej stronie
Tryb testowy: konfiguracja bez skutków prawnychPołączenie kontUstawienia dokumentówPrzełączenie na produkcjęCo trafia na fakturęBezpieczeństwo i RODOUprawnieniaIntegracja składa się z dwóch części. Tutaj, w Integracjach, łączysz konto Fakturowni i ustawiasz zasady wystawiania. W obiegu decydujesz, kiedy powstaje faktura: na przykład po opłaceniu zamówienia, razem z wysłaniem PDF do klienta. Obieg nie zawiera żadnego tokenu ani przełącznika trybu, więc nie da się przez pomyłkę wystawić prawdziwej faktury z obiegu, który ktoś skopiował do testów.
Tryb testowy: konfiguracja bez skutków prawnych#
Nowa firma zawsze startuje w trybie testowym (pomarańczowy znacznik TRYB TESTOWY — tylko proformy). W tym trybie:
- Powstają wyłącznie proformy z opisem „DOKUMENT TESTOWY … nie ma mocy prawnej”. Proforma nie jest fakturą VAT i nie trafia do KSeF.
- Bitee nigdy nie zleca wysyłki do KSeF ani wysyłki e-maila z Fakturowni. PDF do klienta wysyła obieg, więc możesz go wysyłać na własny adres testowy.
- Numer zamówienia jest przekazywany do Fakturowni z prefiksem
TEST-, więc proforma testowa nie zablokuje późniejszej prawdziwej faktury do tego samego zamówienia. - Jeżeli Fakturownia mimo wszystko zwróci dokument innego rodzaju niż proforma albo zgłoszony do KSeF, obieg zatrzymuje się z alarmem zamiast iść dalej.
- Korekta w trybie testowym tylko odrzuca proformę. Nic nie jest księgowane.
Połączenie kont#
- W Fakturowni skopiuj token: Ustawienia → Ustawienia konta → Integracja → Kod autoryzacyjny API.
- W sekcji Konto testowe wpisz Subdomenę konta, czyli część adresu przed
.fakturownia.pl(np. dlamojafirma-test.fakturownia.plwpiszmojafirma-test). - Wklej Token API i kliknij Zapisz na dole strony. Przy polu pojawi się znacznik zapisany.
- Kliknij Testuj połączenie. Test wykonuje tylko odczyt na koncie i niczego nie wystawia.
Konto produkcyjne wypełniasz tak samo. Zapisanie tokenu produkcyjnego niczego jeszcze nie wystawia: konto zostanie użyte dopiero po przełączeniu trybu.
Tokeny są szyfrowane i działają w trybie tylko do zapisu. Po zapisie pole pokazuje kropki z dopiskiem „puste = bez zmiany”. Zostaw je puste, żeby zachować zapisany token, albo wklej nowy, żeby go wymienić.
Ustawienia dokumentów#
| Pole | Znaczenie |
|---|---|
| Kiedy wystawiać | Do każdego zamówienia albo Tylko firmom (NIP) lub na żądanie klienta. W drugim przypadku zamówienie osoby prywatnej bez żądania faktury jest pomijane (akcja zwraca informację o pominięciu, obieg idzie dalej). Żądanie to oznaczenie invoice_requested w danych zamówienia |
| KSeF (tylko produkcja) | Zgodnie z ustawieniem konta Fakturowni (decyduje „Automatyczna wysyłka” na koncie) albo Zlecaj wysyłkę przy wystawieniu |
| Stawka VAT dostawy | Automatycznie (z netto/brutto zamówienia) albo stała stawka: 23%, 8%, 5%, 0%, zw, np |
| Stawka VAT opłaty za małe zamówienie | Jak wyżej |
| SKU kaucji | Pozycje systemu kaucyjnego (np. KAUCJA-PET). Trafiają na dokument jako „np” i nie są objęte rabatem |
| Sposób płatności na dokumencie | Np. transfer |
| Termin płatności (dni) | 0–120 |
| Język dokumentu | Np. pl |
| ID działu (opcjonalnie) | Dział sprzedawcy w Fakturowni, jeśli masz ich kilka |
| Przechowywanie kopii PDF w Bitee (dni) | Kopia PDF w Bitee służy tylko do wysłania maila i jest potem kasowana. Oryginał dokumentu księgowego przechowuje Fakturownia |
Numerację dokumentów zawsze nadaje Fakturownia, według ustawień Twojego konta.
Przełączenie na produkcję#
- Przetestuj obieg w trybie testowym: stawki VAT, rabaty i kody, dostawę, dane nabywcy (firma z NIP i osoba prywatna), wysyłkę PDF i korektę.
- Zapisz Konto produkcyjne i sprawdź je przyciskiem Testuj połączenie.
- Kliknij Przełącz na produkcję…. Przycisk jest nieaktywny, dopóki konto produkcyjne nie jest zapisane.
- Przeczytaj ostrzeżenie, zaznacz Rozumiem i przetestowałem obieg w trybie testowym i kliknij Włącz produkcję.
Od tej chwili obiegi wystawiają faktury VAT na koncie produkcyjnym, a strona pokazuje czerwony komunikat Tryb produkcyjny z datą włączenia. Zmiana trybu trafia do dziennika zdarzeń.
Powrót jest zawsze możliwy: Wróć do trybu testowego przełącza tryb, a Usuń tokeny kasuje oba tokeny i także przywraca tryb testowy.
Co trafia na fakturę#
- Nabywca: nazwa, adres i NIP z adresu rozliczeniowego zamówienia. NIP polski jest sprawdzany (suma kontrolna), a błędny zatrzymuje wystawienie z czytelnym komunikatem. Bez NIP dokument jest wystawiany na osobę prywatną.
- Pozycje: produkty z ilością, ceną i stawką VAT pozycji. Stawki „zw” i „0%” są rozróżniane.
- Rabaty i kody rabatowe: rozkładane proporcjonalnie na pozycje i ich stawki VAT. Suma dokumentu jest zawsze równa sumie zamówienia co do grosza, a jeśli nie da się tego uzyskać, wystawienie jest wstrzymywane.
- Dostawa i opłata za małe zamówienie: osobne pozycje ze stawką według ustawień.
- Kaucje: osobne pozycje „np”, bez rabatu.
- Waluta: dokument w walucie zamówienia. Przy walucie obcej VAT jest przeliczany na złote.
- Zamówienia dodatkowe: każde dostaje własny dokument.
Bezpieczeństwo i RODO#
- Do Fakturowni nie trafia e-mail ani telefon klienta, tylko dane wymagane na fakturze. Fakturę do klienta wysyła obieg z Twojej poczty.
- Kopia PDF w Bitee leży w prywatnym katalogu bez publicznego adresu i jest kasowana po ustawionej liczbie dni.
- Tokeny nie trafiają do historii obiegu, dziennika zdarzeń ani do Bitee AI.
- Komunikaty błędów nie zawierają danych nabywcy.
Uprawnienia#
Dostęp nadajesz w rolach i uprawnieniach na module Integracje → Fakturownia: odczyt konfiguracji oraz zmiana (zapis, test połączenia, przełączenie trybu, usunięcie tokenów). Moduł pojawia się w menu dopiero, gdy rola ma do niego prawo widoczności. Listę dokumentów zamówienia przez API odczyta osoba z prawem odczytu Fakturowni albo zamówień.
Połącz konto testowe i ćwicz obiegi na proformach, które nie trafiają do KSeF. Gdy wszystko się zgadza, zapisz konto produkcyjne i świadomie przełącz tryb. Tokeny są szyfrowane, numerację nadaje Fakturownia, a klient dostaje PDF z Twojej poczty.
