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.

Opublikowano
Zaktualizowano
Wersja systemu26.44
Czas czytania10 min
Na tej stronieWywoł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ówienia

Akcje 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).

AkcjaWrażliwaBezpieczne ponowienie
Wywołanie REST APInienie
Fakturownia: dokument sprzedażytaktak
Wyślij e-mailnienie
Ustaw zmiennąnietak
Operacja na encjitaknie
Pętlanietak
Wyślij paragon do drukarkinienie
Drukuj paragonnienie
Utwórz kod rabatowytaknie
Utwórz bontaknie
Wygeneruj dokument bonutaktak
Zrealizuj bontaknie
Wyszukaj bonnietak
Wygeneruj raportnietak
Drukuj raportnienie
Zapisz rekord rejestrutaknie
Usuń rekord rejestrutaknie
Zapytaj AInienie
Zwrot płatnościtaknie
Zmień status zamówieniataktak

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
ParametrTypWymaganyOpis
AdresteksttakMoże zawierać mentiony. Sekret wolno umieścić tylko w parametrach adresu, nie w hoście ani ścieżce
Metodalista wyborutakWartości: GET, POST, PUT, PATCH, DELETE.
NagłówkiJSONnieNp. Authorization: Bearer {{secret:CRM_TOKEN}}. Host adresu musi być na liście hostów sekretu, a połączenie musi iść przez HTTPS
TreśćtekstnieJSON. Wartości zmiennych, mentionów i sekretów są poprawnie escapowane
Zmienna na odpowiedźtekstnie

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
ParametrTypWymaganyOpis
Operacjalista wyborutakWystaw fakturę, Oznacz zapłatę, Pobierz PDF, Wystaw korektę, Pokaż dokumenty zamówienia
Zamówienietekst z mentionaminieDomyślnie zamówienie obiegu
Zakres korektylista wyborunieCałość (anulowanie) albo Do sumy zwrotów
Zmienna na wyniktekstniePrzy Pobierz PDF zawiera { fileId, filename } do załącznika w akcji Wyślij e-mail
Zatrzymaj obieg, gdy potrzebna decyzja człowiekatak/nienieNadpł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
ParametrTypWymaganyOpis
Odbiorcytekst z mentionamitak
Temattekst z mentionamitak
Treść HTMLtekst z mentionaminie
Profil pocztyliczbanie
ZałącznikiJSONnieZ 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
ParametrTypWymaganyOpis
Zmienna docelowateksttak
Operacjalista wyborutakWartości: set, increment, decrement, append, push_to_array, clear.
Źródło wartościlista wyborutakWartoś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
ParametrTypWymaganyOpis
Encjateksttak
Operacjalista wyborutakWartoś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
ParametrTypWymaganyOpis
Alias elementuteksttakUnikalny w całym obiegu
Rodzaj źródłalista wyborutakWartoś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
ParametrTypWymaganyOpis
Szablon paragonuliczbatak

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
ParametrTypWymaganyOpis
Szablon paragonuliczbatak

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
ParametrTypWymaganyOpis
Pola rabatuJSONtak

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
ParametrTypWymaganyOpis
Konfiguracja bonutekst z mentionamitak
Zmienna wynikowatekstnie

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
ParametrTypWymaganyOpis
Zmienna z bonemtekstnie
Zmienna wynikowatekstnie

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
ParametrTypWymaganyOpis
Tryb realizacjilista wyborutakWartoś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
ParametrTypWymaganyOpis
Kod bonutekst z mentionamitak

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
ParametrTypWymaganyOpis
Raportliczbatak
Formatlista wyborunieWartoś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
ParametrTypWymaganyOpis
Raportliczbatak

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
ParametrTypWymaganyOpis
Rejestrliczbatak

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
ParametrTypWymaganyOpis
Rejestrliczbatak

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
ParametrTypWymaganyOpis
Model AIliczbatak
Prompttekst z mentionamitak
Zmienna wynikowatekstnie

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
ParametrTypWymaganyOpis
Płatnośćtekst z mentionamitak

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
ParametrTypWymaganyOpis
Status docelowytekst z mentionamitak
PodsumowanieW skrócie
  • 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.