Elbuz dodaje do tabeli kolumnę z przyciskiem: z wiersza zamówienia lub produktu otwiera on link, wysyła dane na Twój serwer lub do API przewoźnika, otwiera okno albo uruchamia scenariusz Flow.
Kiedy to się przyda:
- Trzeba śledzić paczkę po numerze listu przewozowego — przycisk otwiera stronę przewoźnika z numerem z wiersza.
- Dane zamówienia mają trafić na Twój serwer — webhook wysyła je jednym kliknięciem.
- List przewozowy trzeba utworzyć bez programowania — żądanie idzie do API przewoźnika, a numer z odpowiedzi zapisuje się w polu zamówienia.
- Przycisk nie jest potrzebny we wszystkich wierszach — warunek go ukrywa lub dezaktywuje.
Od czego zacząć: lista dokumentów → menu ≡ → „Skonfiguruj tabelę” → „Dodaj nowe pole” → „Przycisk”.
Co potrafi przycisk w tabeli
- Otworzyć link lub okno Elbuz — z danymi wiersza w adresie.
- Wysłać żądanie HTTP (webhook) — dane wiersza w makrach, dane dostępowe ze słownika połączeń.
- Zapisać odpowiedź serwera w polu — : jego numer lub link do śledzenia.
- Działać w tabelach produktów, dokumentów, kontrahentów — i Flow w ośmiu tabelach.
Jak dodać przycisk do tabeli
Dla tabeli zamówień: lista dokumentów → menu ≡ → „Skonfiguruj tabelę” → „Dodaj nowe pole” → typ „Przycisk” → „Nazwa przycisku”. Zaraz po utworzeniu otwiera się okno „Akcja przycisku”; później otwiera je ikona koła zębatego „Ustaw działanie przycisku” w wierszu tego pola, w tym samym oknie ustawień tabeli.
Jak ustawić działanie przycisku
Okno ma pięć kroków:
- „Co robi przycisk” — „Otwórz link”, „Wyślij żądanie HTTP (webhook)”, „Otwórz okno Elbuz” lub „Uruchom scenariusz Flow”.
- „Parametry akcji”. Dla webhooka — „Adres (URL)”, „Metoda”, „Typ treści”, „Treść żądania”, „Nagłówki” (po jednym w wierszu, „Nazwa: wartość”) i „Połączenie z danymi dostępowymi”: login, hasło i token pochodzą ze słownika połączeń zewnętrznych, w przycisku nie są przechowywane. Dane wiersza wstawia się makrami i do adresu, i do treści: wybierz pole z listy „Pola wiersza” i kliknij „+” przy właściwym polu wprowadzania. W wartości są escapowane automatycznie.
- „Wygląd przycisku” — napis (też z makrami), ikona, kolor.
- „Kiedy przycisk jest aktywny” — warunek dla wiersza: pusty — przycisk jest aktywny zawsze; w pozostałych wierszach można go pokazać jako nieaktywny lub ukryć.
- „Potwierdzenie i odpowiedź” — „Pytaj o potwierdzenie” z treścią pytania, a także „Ścieżka do wartości w odpowiedzi” (np.
data.tracking_url) i „Zapisz w polu”: wartość z odpowiedzi Twojego serwera zapisze się w polu tego rekordu.
1
Wyślij żądanie HTTP (webhook)2
Adres (URL)3
Treść żądania4
Pola wiersza- Wybrana akcja: po kliknięciu program wysyła żądanie na podany adres.
- Adres, który odbiera żądanie.
- Treść żądania: makra w nawiasach klamrowych są zastępowane wartościami klikniętego wiersza.
- Lista pól wiersza: wybierz pole, aby wstawić jego makro tam, gdzie był kursor, albo użyj „+” obok nazwy pola.
Dokąd można wysłać żądanie i ile razy
- Adres. Żądanie wychodzi z serwera Elbuz, a nie z przeglądarki, więc adres musi zaczynać się od http:// lub https:// i prowadzić do internetu. localhost, adresy sieci lokalnej i nazwę, której nie udało się znaleźć, program odrzuca z komunikatem „Odrzucono adres żądania:”.
- Limit. Jeden użytkownik może kliknąć przyciski wysyłające żądania najwyżej 30 razy na minutę — potem pojawia się „Zbyt wiele kliknięć z rzędu, odczekaj minutę”.
- Dziennik. Kliknięcia webhooka i scenariusza Flow zapisują się w „Dzienniku operacji” (Panel klienta → Dziennik operacji), a nie w historii karty dokumentu. Nie zapisują się „Otwórz link”, „Otwórz okno” ani kliknięcia, które program odrzucił z powodu limitu, uprawnień lub warunku przycisku.
Jak sprawdzić przycisk, niczego nie psując
Przycisk „Sprawdź” najpierw zapisuje ustawienia, a potem wysyła prawdziwe żądanie — z danymi najnowszego rekordu tabeli, który spełnia warunek przycisku.
Twój serwer otrzyma je jako zwykłe, kliknięcie zapisze się w dzienniku i wliczy do limitu 30 na minutę, a jeśli ustawiono „Zapisz w polu”, wartość z odpowiedzi zapisze się w tym prawdziwym rekordzie. Sprawdzaj na adresie testowym albo wtedy, gdy takie żądanie niczego nie zepsuje.
W jakich tabelach działa webhook i Flow
Webhook i Flow są dostępne w tabelach produktów katalogu, produktów z cenników, kontrahentów, dokumentów, pozycji dokumentów, kategorii, producentów i artykułów. W innych tabelach okno pokaże „W tej tabeli dostępne są tylko akcje wykonywane przez przeglądarkę: otwarcie linku i otwarcie okna”.
Jeśli dane mają być wysyłane same, bez kliknięcia — to reguła automatyczna z poleceniem żądania HTTP.
Scenariusze
Przycisk śledzenia paczki po numerze listu przewozowego
Co zrobić. W tabeli zamówień dodaj pole typu „Przycisk” o nazwie „Śledzenie”. W „Co robi przycisk” wybierz „Otwórz link”. W „Adres (URL)” wklej adres strony śledzenia Twojego przewoźnika, a w miejsce numeru — makro pola z numerem listu przewozowego: wybierz pole z listy „Pola wiersza” i kliknij „+”.
Efekt. Wartość zostanie wstawiona z wiersza, w którym kliknięto przycisk, i automatycznie zakodowana dla adresu. Aby przycisk był widoczny tylko tam, gdzie numer listu przewozowego jest wypełniony, ustaw warunek w kroku „Kiedy przycisk jest aktywny”.
Wysłać zamówienie na własny serwer
Co zrobić. W oknie „Akcja przycisku” wybierz „Wyślij żądanie HTTP (webhook)”, podaj „Adres (URL)”, metodę i w „Treść żądania” wstaw makra potrzebnych pól zamówienia z listy „Pola wiersza”. Kliknij „Zapisz”.
Efekt. Przycisk pojawi się jako kolumna w tabeli zamówień i będzie wysyłać dane wiersza, w którym go kliknięto. Kliknięcie zapisuje się w „Dzienniku operacji”.
Utworzyć list przewozowy w API przewoźnika i zapisać numer
Typowy przykład — integracja z przewoźnikiem bez programowania: przycisk w tabeli zamówień wysyła dane zamówienia do API InPost lub innego przewoźnika, żeby utworzyć list przewozowy, a numer listu lub link do śledzenia z odpowiedzi zapisuje w polu zamówienia.
Format treści żądania ustalasz sam według dokumentacji przewoźnika — automatyzacja jest tu całkowicie w Twoich rękach, gotowych szablonów dla przewoźników w oknie nie ma.
Co zrobić. Wybierz „Wyślij żądanie HTTP (webhook)”, podaj adres API przewoźnika, „Metoda” i „Treść żądania” z makrami pól zamówienia. Klucz dostępu wybierz w „Połączenie z danymi dostępowymi”. W kroku „Potwierdzenie i odpowiedź” wpisz „Ścieżka do wartości w odpowiedzi”, np. data.tracking_url, a w „Zapisz w polu” — pole zamówienia.
Efekt. Po kliknięciu wartość z odpowiedzi zapisze się w tym rekordzie. Numer listu przewozowego zapisuje się tak samo: ścieżka do niego w odpowiedzi i osobne pole zamówienia na numer listu.
Co zrobić, gdy przycisk nie zadziałał
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Odrzucono adres żądania:” | adres prowadzi do localhost, do sieci lokalnej albo nazwy nie znaleziono | podać adres serwera w internecie z http:// lub https:// (ograniczenia) |
| „Zbyt wiele kliknięć z rzędu, odczekaj minutę” | ponad 30 kliknięć przycisków wysyłających żądania w ciągu minuty | odczekać do minuty i kliknąć ponownie |
| „W tej tabeli dostępne są tylko akcje wykonywane przez przeglądarkę: otwarcie linku i otwarcie okna” | webhook i Flow nie działają we wszystkich tabelach | sprawdzić listę tabel lub wysyłać żądanie regułą automatyczną |
| Przycisk w wierszu jest nieaktywny lub go nie ma | wiersz nie spełnia warunku z kroku „Kiedy przycisk jest aktywny” | zmienić warunek lub wypełnić potrzebne pole w wierszu |
Najczęstsze pytania
Przycisk z webhookiem pokazuje „Zbyt wiele kliknięć z rzędu, odczekaj minutę”. Jaki jest limit?
30 kliknięć przycisków z webhookiem i scenariuszami Flow na minutę na użytkownika, łącznie ze „Sprawdź”. Licznik zeruje się z kolejną minutą. „Otwórz link” i „Otwórz okno Elbuz” nie są wliczane do limitu.
Czy można wysyłać dane na serwer bez klikania przycisku?
Tak, ale to już nie przycisk, tylko reguła automatyczna z poleceniem żądania HTTP: uruchamia się sama po zdarzeniu.
Gdzie widać, kto i kiedy kliknął przycisk?
W „Dzienniku operacji” (Panel klienta → Dziennik operacji) — dla webhooków i scenariuszy Flow. Do historii karty dokumentu kliknięcia nie są zapisywane.
Czy przycisk przechowuje hasło lub token do API?
Nie. Login, hasło i token pochodzą ze słownika połączeń zewnętrznych przez „Połączenie z danymi dostępowymi”, w samym przycisku nie są przechowywane.
Czy są gotowe ustawienia dla InPost lub innych przewoźników?
Nie, gotowych szablonów dla przewoźników w oknie nie ma. Format treści żądania ustalasz sam według dokumentacji przewoźnika.
Gdzie to jest i kto ma dostęp
- Dodać przycisk
- tabela → menu ≡ → „Skonfiguruj tabelę” → „Dodaj nowe pole” → „Przycisk”
- Zmienić działanie
- ikona koła zębatego „Ustaw działanie przycisku” w wierszu pola
- Przygotować
- dla webhooka — adres i format żądania Twojego serwera lub przewoźnika
Przycisk dodaje się nie w „Ustawieniach tabel”, tylko w samej tabeli, w której jest potrzebny. Podobnie jak „Pasek postępu”, to pole wirtualne: nie tworzy kolumny w bazie, nie można według niego filtrować, sortować ani go eksportować.
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu własnych pól — dodatkowe pola.
- Jeśli dane mają być wysyłane same, bez kliknięcia — reguły automatyczne.
- Jeśli przycisk ma być widoczny w tabeli współpracownika — ustawienia tabeli.
