Fakturownia w obiegu
Akcja obiegu „Fakturownia” wystawia fakturę z zamówienia, oznacza ją jako opłaconą, pobiera PDF do załącznika maila i wystawia korekty. Jedno zamówienie ma zawsze jedną fakturę, nawet gdy płatność przyjdzie dwa razy albo krok zostanie powtórzony.
Na tej stronie
Operacje akcjiPrzepis: faktura po płatności z PDF do klientaSytuacje szczególneBitee AI buduje ten obieg za CiebieAkcja nie ma pola na token ani przełącznika test/produkcja. O tym, czy powstaje proforma testowa, czy prawdziwa faktura VAT, decyduje wyłącznie tryb ustawiony w Integracje → Fakturownia. Dzięki temu ten sam obieg przechodzi z testów na produkcję bez żadnej zmiany.
Operacje akcji#
| Operacja | Co robi | Typowe miejsce w obiegu |
|---|---|---|
| Wystaw fakturę | Tworzy dokument z danych zamówienia. Jedna faktura na zamówienie: powtórzenie kroku zwraca istniejący dokument. W trybie testowym powstaje proforma | Po wyjściu Opłacono kroku oczekiwania |
| Oznacz zapłatę | Ustawia status „opłacona” albo „częściowo opłacona” z kwotą, według sumy wpłat zamówienia. Powtórzenie jest bezpieczne | Zaraz po wystawieniu albo po kolejnej wpłacie |
| Pobierz PDF | Zapisuje prywatną kopię PDF (z retencją) i zwraca { fileId, filename } do załącznika maila | Przed akcją Wyślij e-mail |
| Wystaw korektę | Całość (anulowanie) albo Do sumy zwrotów. Kolejne zwroty dają kolejne korekty, bez duplikatów. W trybie testowym proforma jest tylko odrzucana | Po anulowaniu lub zwrocie |
| Pokaż dokumenty zamówienia | Zwraca listę dokumentów zamówienia do dalszych warunków w obiegu | Bramki i diagnostyka |
| Pole | Znaczenie |
|---|---|
| Zamówienie | Puste oznacza zamówienie, do którego należy obieg. Możesz podać mention, np. {{order_field:id}} |
| Zmienna na wynik | Np. faktura. Potem użyjesz {{context_variable:faktura.number}} albo, przy Pobierz PDF, załącznika ze zmiennej |
| Zatrzymaj obieg, gdy potrzebna decyzja człowieka | Włączone (zalecane) zatrzymuje obieg przy nadpłacie, wpłacie po anulowaniu, wpłacie bez faktury i zmianie zamówienia po wystawieniu |
| Zakres i Przyczyna korekty | Tylko dla Wystaw korektę. Przyczyna trafia na dokument i może zawierać mentiony |
Wynik w zmiennej zawiera m.in.: number (numer z Fakturowni), kind (vat, proforma, correction), mode (test albo production), isTest, status, paymentStatus, totalGross, created (czy dokument powstał teraz), skipped (powód pominięcia) i needsReview (powód zatrzymania).
Przepis: faktura po płatności z PDF do klienta#
- Utwórz obieg i dodaj zmienne
fakturaifaktura_pdf(typ obiekt JSON). - Za startem dodaj krok Oczekiwanie → Płatność zamówienia, np. z terminem 72 godziny. Podepnij wyjścia Opłacono i Przeterminowano.
- Z wyjścia Opłacono dodaj krok serwisowy „Faktura w Fakturowni” z trzema akcjami w kolejności: Wystaw fakturę (Zmienna na wynik:
faktura), Oznacz zapłatę, Pobierz PDF (Zmienna na wynik:faktura_pdf). - Dodaj krok serwisowy z akcją Wyślij e-mail: odbiorca
{{order_field:customer_email}}, temat np.Faktura {{context_variable:faktura.number}} do zamówienia {{order_field:number}}, Załączniki → Zmienna obiegu →faktura_pdf. - Każdej akcji Fakturowni ustaw Gdy akcja zawiedzie → Wstrzymaj obieg. To dokumenty księgowe: błąd ma zobaczyć człowiek, a w instancji pojawią się przyciski Ponów i Pomiń.
- Zapisz diagram i uruchom obieg na zamówieniu testowym w trybie testowym integracji.
Na gałęzi Przeterminowano możesz umieścić krok z akcją Wystaw korektę → Całość (anulowanie). Ma to sens, gdy firma wystawia fakturę jeszcze przed wpłatą (np. przy przelewie z terminem). Jeśli faktury nie ma, akcja zwraca „pominięto: brak faktury” i obieg idzie dalej.
Sytuacje szczególne#
| Sytuacja | Co robi akcja |
|---|---|
| Podwójne powiadomienie o płatności, ponowienie kroku, restart serwera | Nie tworzy drugiej faktury. Gdy połączenie zerwie się po zapisaniu dokumentu w Fakturowni, dokument jest odszukiwany zamiast wystawiany ponownie |
| Limity API Fakturowni | Ponawia z odczekaniem wskazanym przez Fakturownię |
| Płatność częściowa | Oznacz zapłatę ustawia „częściowo opłacona” z kwotą. Kolejna wpłata i ponowne wywołanie dają „opłacona” |
| Płatność po terminie | Zwykłe „opłacona” z faktyczną datą zapłaty |
| Nadpłata, wpłata po anulowaniu, wpłata bez faktury | Zatrzymanie do decyzji (gdy włączone „Zatrzymaj obieg…”) |
| Zamówienie zmienione po wystawieniu faktury | Ponowne Wystaw fakturę nie tworzy drugiej faktury, tylko zgłasza zmianę i zatrzymuje obieg do decyzji. Popraw dokument korektą |
| Osoba prywatna bez żądania faktury przy ustawieniu „Tylko firmom…” | Pominięcie, obieg idzie dalej |
| Błędny NIP | Zatrzymanie z komunikatem o błędnym NIP: popraw dane zamówienia i kliknij Ponów |
| Zamówienie za 0 zł | Pominięcie |
| Brak połączenia lub zły token | Błąd z czytelnym komunikatem. Sprawdź Testuj połączenie w integracji |
Bitee AI buduje ten obieg za Ciebie#
W edytorze obiegu otwórz Bitee AI i opisz efekt, np.:
Po opłaceniu zamówienia wystaw fakturę w Fakturowni, oznacz ją jako opłaconą i wyślij klientowi PDF. Jeśli płatność nie przyjdzie w 72 godziny, wystaw korektę.
Asystent zaproponuje kroki i akcje według przepisu powyżej, ustawi regułę Wstrzymaj obieg dla akcji Fakturowni i pokaże różnice do zatwierdzenia. Nie doda żadnego klucza do obiegu, bo konto Fakturowni jest skonfigurowane w integracji. Czat Bitee AI odpowie też na pytania o konfigurację, tryb testowy i KSeF.
Konto i tryb ustawiasz w integracji, a obieg tylko wywołuje operacje: wystaw, oznacz zapłatę, pobierz PDF, wyślij e-mail, a w razie potrzeby korekta. Jedna faktura na zamówienie, zatrzymanie przy sytuacjach wymagających decyzji i tryb testowy bez KSeF chronią przed błędami w dokumentach księgowych.