Katalog akcji workflow
Dziewiętnaście akcji systemowych, z których składasz kroki obiegu. Dla każdej opisujemy parametry, wyniki, to, czy jej powtórzenie jest bezpieczne, oraz czy dotyka pieniędzy lub dokumentów.
Na tej stronie
Wywołanie REST APIFakturownia: dokument sprzedażyWyślij e-mailUstaw zmiennąOperacja na encjiPętlaWyślij paragon do drukarkiDrukuj paragonUtwórz kod rabatowyUtwórz bonWygeneruj dokument bonuZrealizuj bonWyszukaj bonWygeneruj raportDrukuj raportZapisz rekord rejestruUsuń rekord rejestruZapytaj AIZwrot płatnościZmień status zamówieniaAkcje dodajesz do kroków typu Start, Zadanie, Zadanie serwisowe, Pętla i Koniec. Wynik akcji zapisuje się w zmiennej wyjściowej, z której korzystasz w kolejnych krokach (zobacz Mentiony i zmienne).
| Akcja | Wrażliwa | Bezpieczne ponowienie |
|---|---|---|
| Wywołanie REST API | nie | nie |
| Fakturownia: dokument sprzedaży | tak | tak |
| Wyślij e-mail | nie | nie |
| Ustaw zmienną | nie | tak |
| Operacja na encji | tak | nie |
| Pętla | nie | tak |
| Wyślij paragon do drukarki | nie | nie |
| Drukuj paragon | nie | nie |
| Utwórz kod rabatowy | tak | nie |
| Utwórz bon | tak | nie |
| Wygeneruj dokument bonu | tak | tak |
| Zrealizuj bon | tak | nie |
| Wyszukaj bon | nie | tak |
| Wygeneruj raport | nie | tak |
| Drukuj raport | nie | nie |
| Zapisz rekord rejestru | tak | nie |
| Usuń rekord rejestru | tak | nie |
| Zapytaj AI | nie | nie |
| Zwrot płatności | tak | nie |
| Zmień status zamówienia | tak | tak |
Wywołanie REST API#
Wysyła żądanie HTTP do zewnętrznego systemu i zapisuje odpowiedź do zmiennej. Klucze API podawaj wyłącznie przez Sekrety: z listy Sekrety firmy przy polu wartości albo jako {{secret:NAZWA}} w nagłówku, parametrze lub treści. Nigdy nie wpisuj klucza na stałe.
- Typ techniczny:
CallRestApiAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
status,data,error
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Adres | tekst | tak | Może zawierać mentiony. Sekret wolno umieścić tylko w parametrach adresu, nie w hoście ani ścieżce |
| Metoda | lista wyboru | tak | Wartości: GET, POST, PUT, PATCH, DELETE. |
| Nagłówki | JSON | nie | Np. Authorization: Bearer {{secret:CRM_TOKEN}}. Host adresu musi być na liście hostów sekretu, a połączenie musi iść przez HTTPS |
| Treść | tekst | nie | JSON. Wartości zmiennych, mentionów i sekretów są poprawnie escapowane |
| Zmienna na odpowiedź | tekst | nie |
Fakturownia: dokument sprzedaży#
Wystawia fakturę z danych zamówienia (w trybie testowym proformę bez KSeF), oznacza zapłatę, pobiera PDF do załącznika maila albo wystawia korektę. Konto i tryb test/produkcja ustawiasz w Integracje → Fakturownia: akcja nie ma pola na klucz ani tryb. Jedno zamówienie ma jedną fakturę, nawet przy ponowieniach. Pełny opis i przepis na obieg: Fakturownia w obiegu.
- Typ techniczny:
FakturowniaAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: tak
- Pola wyniku:
invoiceId,externalId,number,kind,mode,status,paymentStatus,totalGross,isTest,created,drift,skipped,needsReview,fileId,filename
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Operacja | lista wyboru | tak | Wystaw fakturę, Oznacz zapłatę, Pobierz PDF, Wystaw korektę, Pokaż dokumenty zamówienia |
| Zamówienie | tekst z mentionami | nie | Domyślnie zamówienie obiegu |
| Zakres korekty | lista wyboru | nie | Całość (anulowanie) albo Do sumy zwrotów |
| Zmienna na wynik | tekst | nie | Przy Pobierz PDF zawiera { fileId, filename } do załącznika w akcji Wyślij e-mail |
| Zatrzymaj obieg, gdy potrzebna decyzja człowieka | tak/nie | nie | Nadpłata, wpłata po anulowaniu, zmiana zamówienia po wystawieniu |
Wyślij e-mail#
Wysyła wiadomość z profilu poczty firmy, z mentionami w adresach, temacie i treści.
- Typ techniczny:
SendEmailAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
success,messageId,dbId,error
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Odbiorcy | tekst z mentionami | tak | |
| Temat | tekst z mentionami | tak | |
| Treść HTML | tekst z mentionami | nie | |
| Profil poczty | liczba | nie | |
| Załączniki | JSON | nie | Z biblioteki multimediów albo ze zmiennej obiegu, np. PDF faktury z akcji Fakturownia (Pobierz PDF) lub dokument bonu |
Ustaw zmienną#
Zapisuje wartość do zmiennej procesu — z wartości stałej, pola zamówienia, wyniku akcji albo skryptu.
- Typ techniczny:
VariableAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: tak
- Pola wyniku:
value
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Zmienna docelowa | tekst | tak | |
| Operacja | lista wyboru | tak | Wartości: set, increment, decrement, append, push_to_array, clear. |
| Źródło wartości | lista wyboru | tak | Wartości: static, dictionary_item, order_field, order_status, context_variable, upstream_action, json_template. |
Operacja na encji#
Tworzy, aktualizuje lub usuwa rekord w wybranej encji systemu.
- Typ techniczny:
EntityCrudAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
success,id,data,message
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Encja | tekst | tak | |
| Operacja | lista wyboru | tak | Wartości: create, update, delete. |
Pętla#
Iteruje po kolekcji i wykonuje kroki podrzędne dla każdego elementu.
- Typ techniczny:
LoopAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: tak
- Pola wyniku:
items,count,results
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Alias elementu | tekst | tak | Unikalny w całym obiegu |
| Rodzaj źródła | lista wyboru | tak | Wartości: process_variable, json, model, action_result. |
Wyślij paragon do drukarki#
Wysyła wydruk z szablonu paragonu na wskazane urządzenie przez Print Hub.
- Typ techniczny:
SendReceiptTemplateAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
ok,printHub.job_id,printHub.status,printHub.message
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Szablon paragonu | liczba | tak |
Drukuj paragon#
Drukuje szablon paragonu na drukarce przypisanej do użytkownika.
- Typ techniczny:
PrintReceiptTemplateAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
ok,printHub.job_id,printHub.status,printHub.message
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Szablon paragonu | liczba | tak |
Utwórz kod rabatowy#
Generuje kod rabatowy według zadanych pól (każde pole: {mode:"simple",value} albo {mode:"sql",expression}). type: PERCENT | AMOUNT | FIXEDPRICE (value = cena sztuki) | FREEITEM (gratis). Cele: targetproducts / targetcategories / targetbundles (ID po przecinku), includemode INCLUDE|EXCLUDE. Sztuki: maxdiscountedunits, unitpriority CHEAPEST|MOSTEXPENSIVE, quantitystep + discountedquantityperstep. Odbiorcy: audiencemode ALL|LOGGEDONLY|GUESTONLY|SPECIFICUSERS|SEGMENT + audienceuserids / audiencesegmentids.
- Typ techniczny:
CreateDiscountCodeAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
id,code,success,message
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Pola rabatu | JSON | tak |
Utwórz bon#
Wystawia bon na podstawie konfiguracji bonu i pozycji zamówienia.
- Typ techniczny:
CreateVoucherAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
vouchers,count,voucherId,code
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Konfiguracja bonu | tekst z mentionami | tak | |
| Zmienna wynikowa | tekst | nie |
Wygeneruj dokument bonu#
Renderuje PDF lub DOCX bonu z opublikowanego szablonu dokumentu.
- Typ techniczny:
RenderVoucherDocumentAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: tak
- Pola wyniku:
filename,content,contentType
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Zmienna z bonem | tekst | nie | |
| Zmienna wynikowa | tekst | nie |
Zrealizuj bon#
Realizuje bon w całości, na kwotę albo na wybrane pozycje.
- Typ techniczny:
RedeemVoucherAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
success,redemptionId,balance,status
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Tryb realizacji | lista wyboru | tak | Wartości: full, amount, items. |
Wyszukaj bon#
Znajduje bon po kodzie i zapisuje jego dane do zmiennej.
- Typ techniczny:
VoucherLookupAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: tak
- Pola wyniku:
found,voucher,balance,status
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Kod bonu | tekst z mentionami | tak |
Wygeneruj raport#
Uruchamia raport i zapisuje wynik (dane, CSV, PDF) do zmiennej.
- Typ techniczny:
GenerateReportAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: tak
- Pola wyniku:
success,data,csv,attachment,error
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Raport | liczba | tak | |
| Format | lista wyboru | nie | Wartości: json, csv, excel, pdf. |
Drukuj raport#
Drukuje raport na drukarce termicznej przez Print Hub.
- Typ techniczny:
PrintReportAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
ok,printHub.job_id,printHub.status,printHub.message
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Raport | liczba | tak |
Zapisz rekord rejestru#
Tworzy lub aktualizuje rekord w rejestrze danych (no-code).
- Typ techniczny:
UpsertRegistryEntityAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
success,id,created,data
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Rejestr | liczba | tak |
Usuń rekord rejestru#
Usuwa rekord z rejestru danych.
- Typ techniczny:
DeleteRegistryEntityAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
success,deleted
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Rejestr | liczba | tak |
Zapytaj AI#
Wysyła prompt do wybranego modelu i zapisuje odpowiedź do zmiennej.
- Typ techniczny:
AiAction - Dotyka pieniędzy lub dokumentów: nie
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
content,outputImages,savedMedia,usage
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Model AI | liczba | tak | |
| Prompt | tekst z mentionami | tak | |
| Zmienna wynikowa | tekst | nie |
Zwrot płatności#
Zleca zwrot u operatora płatności dla wskazanej płatności zamówienia.
- Typ techniczny:
InitiatePaymentRefundAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: nie
- Pola wyniku:
success,refundId,status,error
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Płatność | tekst z mentionami | tak |
Zmień status zamówienia#
Ustawia status zamówienia po nazwie albo identyfikatorze.
- Typ techniczny:
ChangeOrderStatusAction - Dotyka pieniędzy lub dokumentów: tak
- Powtórzenie jest bezpieczne: tak
- Pola wyniku:
success,statusId,statusName,error
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| Status docelowy | tekst z mentionami | tak |
- Do dyspozycji jest 20 akcji: komunikacja, zamówienia i płatności, dokumenty i druk (w tym faktury z Fakturowni), bony i rabaty oraz logika.
- Każda akcja ma jasno opisane parametry i pola wyniku, których używasz dalej.
- Akcje wrażliwe i niepowtarzalne mają ostrzeżenia lintera, więc nie wystawisz przypadkiem bonu dwa razy.
