Link Search Menu Expand Document
  1. DODAWANIE FAKTUR PDF Z INSERT SUBIEKT GT DO ZAMÓWIENIA W BASELINKER
  2. Dane wtyczki
  3. Wymagania:
  4. Do ilu dni wstecz chcesz przetwarzać dokumenty?
  5. Czy przetwarzać dokumenty istniejące przed skonfigurowaniem integracji?
  6. Czy chcesz, żeby integracja uruchamiała się automatycznie?
  7. Połączenie z Baselinker
  8. Dla zamówień z którego statusu chcesz przesyłać fakturę PDF?
  9. Jaki status chcesz nadać zamówieniom w BaseLinker, do których zostanie przypisana faktura PDF?
  10. Jaki status chcesz nadać zamówieniom w BaseLinker, do których nie zostanie przypisana faktura PDF z powodu błędu?
  11. Jakie dokumenty z Subiekt GT mają być przesyłane?
  12. Jakie wzorce wydruku chcesz wykorzystać?
  13. Jak chcesz powiązać zamówienia z dokumentami:
  14. Jaka informacja z BaseLinker jest zapisana w numerze oryginału w dokumencie w Subiekt GT?
  15. W momencie kiedy do paragonu została wystawiona faktura detaliczna, wysyłaj jej plik PDF:

DODAWANIE FAKTUR PDF Z INSERT SUBIEKT GT DO ZAMÓWIENIA W BASELINKER

Integracja umożliwia automatyczne dodawanie faktur w formacie PDF z systemu Subiekt GT do zamówienia w BaseLinker. Pozwala wybrać czy dodawać faktury do wszystkich zamówień, czy tylko tych o określonym statusie, a także wybrać status tych zamówień, do których przypisano faktury.

Wtyczkę możesz zakupić tutaj

Dane wtyczki

Kod wtyczki: SGT_CAI_COM_INV_BLK_100

Wymagania:

  • Dostęp do serwera SQL z bazą danych systemu Subiekt GT
  • Aktywna Sfera w czasie pracy integracji
  • Zainstalowany endpoint
  • Stały dostęp do internetu
  • Poprawna konfiguracja

    Aby dokument wygenerowany w Subiekcie GT został podpięty pod zamówienie w Baselinkerze, na karcie zamówienia musi być wystawiona wewnętrzna faktura.
    1. Można zautomatyzować ten proces przez wystawienie Automatycznych Akcji po stronie Baselinkera
    2. Można wystawić fakturę ręcznie na karcie zamówienia w Baselinker
    3. Możemy użyć opcji mapowania w pytaniu Jak chcesz powiązać zamówienia z dokumentami

Invoice_On_Baselinker
Warunek podpięcia dokumentu z systemu Subiekt GT (26.01.2021)

Pytania ze scenariusza

Do ilu dni wstecz chcesz przetwarzać dokumenty?

Funkcja ta pozwala przetwarzać zamówienia z datą wstecz.
W darmowym wsparciu możemy cofnąć się do 14 dni, jeśli interesuje Cię większy przedział czasowy Sprawdź tutaj

Sync_Day_Past Przetwarzanie dokumentów wstecz (25.01.2021)

Zastosowanie

Z tej funkcjonalności korzystają firmy, które:

  • chcą podpiąć dokument, który został utworzony przed aktualnym dniem. Przykładowo, jeśli dodajemy w jeden dzień dokumenty stworzone na przestrzeni całego tygodnia.

Czy przetwarzać dokumenty istniejące przed skonfigurowaniem integracji?

Opcja umożliwa przetwarzanie dokumentu sprzed daty pierwszej konfiguracji wtyczki.
W darmowym wsparciu możemy cofnąć się do 7 dni, jeśli interesuje Cię większy przedział czasowy Sprawdź tutaj

Sync_Day_Past_By_First_Setup Przetwarzanie dokumentów wstecz od pierwszej konfiguracji (25.01.2021)

Zastosowanie

Z tej funkcjonalności korzystają firmy, które:

  • potrzebują przesłać dokumenty utworzone przed pierwszym skonfigurowaniem integracji.

Czy chcesz, żeby integracja uruchamiała się automatycznie?

Pytanie dotyczące sposobu uruchamiania integracji Wybranie sposobu uruchomienia integracji (20.01.2021)

Funkcja pozwala nam na ustawienie trybu pracy integracji

Uruchomienie automatyczne umożliwia ustawienie :

  • przedziału czasowego pomiędzy zakończeniem, a ponownym uruchomieniem integracji
  • dni działania integracji (np. tylko dni robocze)
  • (opcjonalnie) godziny uruchomienia integracji (np. w godzinach pracy 7 - 15)

Uruchomienie ręczne integracji :

przy wyborze tej opcji, aby uruchomić integrację należy dodatkowo użyć przycisku “Synchronizuj teraz”

Manual_Start
Uruchomienie ręczne integracji (20.01.2021)


Połączenie z Baselinker

W tym miejscu należy wprowadzić klucz API z konta Baselinker, w celu skopiowania tokenu przechodzimy : Moje konto -> API Get_Baselinker_API
Pobranie tokenu API z Baselinker (20.01.2021)

Następnie kopiujemy do pola w scenariuszu konfiguracyjnym
Baselinker_API_Question
Połączenie z API Baselinkera (20.01.2021)


Dla zamówień z którego statusu chcesz przesyłać fakturę PDF?

Funkcja ta umożliwa podanie ID statusu / statusów Baselinker, z których mają być przetwarzane zamówienia.

Zastosowanie

Z tej funkcjonalności korzystają firmy, które:

  • mają wyznaczone statusy dla poszczególnego stanu zamówienia - pozwala to utrzymać większy porządek oraz ułatwia weryfikację w momencie wystąpienia błędu.
Konfiguracja scenariusza

Kiedy zdecydujemy się, aby pracować na statusach, w scenariuszu wybieramy opcje “O statusie”, następnie klikamy niebieską lupkę. Jeśli poprawnie wprowadziliśmy klucz API, integracja wyświetli dostępne statusy z Baselinkera. Przy wybranych należy zaznaczyć checkbox.

Working_Status
Wybór opcji integracji z poszczególnych zamówień (20.01.2021)

Choose_Working_Status
Wybór statusów z których będziemy przetwarzać zamówienia (20.01.2021)

Jeśli wprowadziliśmy błędny klucz API lub wystąpi problem z połączeniem do Baselinkera, statusy mogą nie być widoczne po wybraniu niebieskiej lupki. W tym wypadku należy ID statusów wprowadzić ręcznie po przecinku.

API_Error
Komunikat o błędzie związany z kluczem API (20.01.2021)

Get_StatusID
ID statusu znajduje się na końcu linku strony (20.01.2021)

Wynik działania

W momencie synchronizacji integracja przetworzy Zamówienia Klientów tylko z podanych statusów.

Jeśli wybierzemy opcje Wszystkie zostanie wysłane zapytanie o zamówienia we wszystkich statusach.
Rozwiązywanie problemów

Błędnie podane ID statusu należy zweryfikować czy zostało poprawnie wprowadzone oraz czy poszczególne elementy są oddzielone przecinkiem. Zamówienie nie posiada stworzonego Dokumentu sprzedaży w Subiekcie GT.


Jaki status chcesz nadać zamówieniom w BaseLinker, do których zostanie przypisana faktura PDF?

Funkcja umożliwia po poprawnym dodaniu Faktury / Paragonu do zamówienia, zmianę jego statusu po stronie Baselinkera.

Zastosowanie

Z tej funkcjonalności korzystają firmy, które:

  • nie wysyłają wiadomości e-mail do klienta z dokumentem, tylko z linkiem do strony z zamówieniem, z którego klient może samodzielnie pobrać Fakturę lub Paragon,
  • chcą mieć wydzielone zamówienia z popawnie dodanymi fakturami PDF, co skutkuje zachwowaniem porządku oraz szybszej weryfikacji zamówień przy których wystąpi błąd.
Konfiguracja scenariusza

W scenariuszu należy wybrać opcję “Ustaw status”, następnie po kliknięciu niebieskiej lupki wybrać checkbox przy statusie, do którego mają trafić zamówienia z poprawnie podpiętym dokumentem PDF.

Correct_Generated_Document
Ustawienie statusu dla poprawnie wygenerowanego dokumentu (26.01.2021)

Wynik działania

W momencie synchronizacji integracja podepnie dokumenty do zamówień znajdujących się we wskazanym statusie.

Jeśli wybierzemy opcje Nie zmieniaj statusu zostanie wysłane zapytania o zamówienia we wszystkich statusach.
Rozwiązywanie problemów
  • Brak wystawionej faktury po stronie Baselinkera na Karcie zamówienia - musi być ona wystawiona, żebyśmy mogli podpiąć dokument z Subiekta GT.
  • Brak Faktury po stronie Subiekta GT - należy zweryfikować, czy dokument jest wystawiony poprawnie.
  • Błędnie podane ID statusu - należy zweryfikować, czy zostało poprawnie wprowadzone, oraz czy poszczególne elementy są oddzielone przecinkiem.

Jaki status chcesz nadać zamówieniom w BaseLinker, do których nie zostanie przypisana faktura PDF z powodu błędu?

Funkcjonalność umożliwia ustawienie statusu błędu dla zamówienia, do którego nie możemy podpiąć dokumentu.

Zastosowanie

Z tej funkcjonalności korzystają firmy, które:

  • w przypadku wystąpienia błędu, chcą mieć wydzielone zamówienia do weryfikacji.
Konfiguracja scenariusza

W scenariuszu należy wybrać opcję “Ustaw status”, następnie po kliknięciu niebieskiej lupki wybrać checkbox przy statusie, do którego mają trafić zamówienia, które nie mają podpiętego dokumentu z powodu błędu.

Error_Status
Ustawienie statusu błędu (26.01.2021)

Wynik działania

W momencie synchronizacji jeśli wystąpi błąd np. zamówienie nie będzie miało wystawionej faktury w Subiekcie lub wygenerowanego dokumentu po stronie Baselinkera zostanie przeniesione do wskazanego statusu.

Wybór opcji Nie zmieniaj statusu może skutkować wydłużonym czasem reakcji na zamówienie z błędem, oraz weryfikację błędu.
Rozwiązywanie problemów
  • Brak wystawionej faktury po stronie Baselinkera na Karcie zamówienia - musi być ona wystawiona, żebyśmy mogli podpiąć dokument z Subiekta GT.
  • Brak Faktury po stronie Subiekta GT - należy zweryfikować czy dokument jest wystawiony poprawnie.
  • Błędnie podane ID statusu - należy zweryfikować czy zostało poprawnie wprowadzone.

Jakie dokumenty z Subiekt GT mają być przesyłane?

Funkcja służy do wybrania typu dokumentu jaki ma być podpinany pod zamówienia w Baselinkerze.

Konfiguracja scenariusza

W scenariuszu należy wybrać odpowiedni checkbox przy rodzaju dokumentów jakie chcemy przesyłać.

Select_Doc_Type
Wybór typu dokumentu do przesłania (26.01.2021)

Dla każdego typu dokumentów po stronie musi być wystawiona Faktura po stronie Baselinkera, niezależnie czy dodajemy Paragon czy Fakturę.
Wynik działania

Po synchronizacji dodany dokument zostanie podpięty pod fakturę wystawioną w Baselinkerze, dzięki czemu klient będzie miał dostęp do swojego dokumentu z poziomu Karty zamówienia.

Rozwiązywanie problemów
  • Wystawienie paragonu po stronie Baselinkera - nasze integrację odnoszą się do pola faktury, dlatego dla każdego typu dokumentu musi być wystawiona Faktura.

Jakie wzorce wydruku chcesz wykorzystać?

Używając tej funkcji mamy możliwość ustawienia wzroca dla danego dokumentu.

Konfiguracja scenariusza

Funkcjonalność umożliwia :

  • wybranie domyślnych wzorców wydruków,
  • zmapowanie wzorca wydruku do rodzaju dokumentu.

Select_Print_Pattern
Tabela mapowania wzorców do typów dokumentu (26.01.2021)

W celu sprawdzenia czy wykorzystywany wzorzec jest domyślny należy sprawdzić
Widok -> Administracja -> Wzorce wydruków

Domyślne wzorce są oznaczone w kolumnie “W” zielonym znacznikiem

Print_Pattern
Widok wzorców w Subiekcie GT (wersja Subiekta GT 1.62 SP2 HF2)

W celu ustawienia wybranego wzorca jako domyślny, wyszukujemy go na liście, następnie otwieramy okno edycji i zaznaczamy checkbox “Wzorzec domyślny dla wybranego typu wydruku”.

Set_Default_Pattern
Ustawienie wybranego wzorca jako domyślny (wersja Subiekta GT 1.62 SP2 HF2)

Używając tabeli do mapowania należy wybrać “Klucz mapowania”, np. może być to Identyfikator statusu, następnie wpisujemy “Wartość klucza” w tym przypadku będzie to ID statusu. W kolejnej rubryce wpisujemy “Nazwę wzorca wydruku”, oraz wybieramy “Symbol dokumentu” z listy.

Print_Pattern_Mapping
Przykładowe ustawienia mapowania (26.01.2021)

W przypadku wybrania Klucza mapowania jako Identyfikator źródła zamówienia należy sprawdzić ID źródła w API Baselinkera.

Na początku przechodzimy do Testera wywołań następnie wykonujemy następujące kroki:

  • Wpisujemy token API - z naszego konta Baselinker
  • Wybieramy metodę “GetOrders” z listy rozwijanej
  • Wpisujemy parametry metody w następujący sposób :
    {
    “order_id”: wpisujemy numer zamówienia,
    “get_unconfirmed_orders”: false
    }
  • Klikamy “Wyślij”
  • W wyniku wyszukujemy parametr “order_source_id” i otrzymaną wartość wpisujemy w “Wartość klucza”

API_Testing
Testowanie wywołań API (26.01.2021)

Wynik działania

Po synchronizacji do zamówienia w Baselinkerze, zostanie podpięty dokument o odpowiednim wzorcu wydruku.

Rozwiązywanie problemów

Przy wybraniu opcji wykorzystania domyślnego wzorca, brak oznaczenia warunku w ustawieniach wybranego wzorca wydruku.
Używając mapowania należy zweryfikować poprawność wpisanych “Wartości klucza” oraz “Nazwy wzorca wydruku”.

Jak chcesz powiązać zamówienia z dokumentami:

Funkcjonalność umożliwa ustawienie własnej serii numeracji wystawianego, oraz automatyczne utworzenie dokumentu po stronie Baselinkera, pod który wgrywany będzie dokument sprzedażowy z Subiekta GT.

Zastosowanie

Z tej funkcjonalności korzystają firmy, które:

  • chcą zautomatyzować wystawianie dokumentów po stronie Baselinker,
  • potrzebują infomracji, jaki format dokumentu będzie finalnie wgrany pod zamówienie w Baselinker,
  • chcą mieć uporządkowany schemat numeracji.
Konfiguracja scenariusza

Integracja wymaga mapowania danego “statusu Baselinker” do “Idenyfikatora Serii Dokumentów”.

Document_Series_Mapping
Mapowanie serii dokumentów (26.01.2021)

W celu ustawienia własnego wzoru serii dokumentów po stronie Baselinkera z bocznego pasku edycji wybieramy “Zamówienia”. Przechodzimy do opcji “Faktury” i wybieramy zakładkę “Ustawienia”.

BLK_Series_Doc
Dodanie własnej serii dokumentu (26.01.2021)

Po wybraniu “Nowa seria numeracji” należy uzupełnić okno dialogowe, według własnych preferencji i zapisać ustawienia.

Jeżeli zakończymy tworzenie odpowiednich serii po stronie Baselinkera, w scenariuszu po wybraniu lupki możemy wybrać odpowiednią serię.

BLK_Series_Doc_select
Wybranie odpowiedniej serii w scenariuszu (26.01.2021)

Wynik działania

Po synchronizacji zostanie dodany dokument po stronie Baselinkera z ustalonym rodzajem serii dla wybranego statusu.
BLK_example
Przykład na karcie zamówienia w Baselinkerze (26.01.2021)

Rozwiązywanie problemów

Brak dodanej odpowiednio nowej serii dokumentu - należy zweryfikować czy zostało poprawnie dodane po stronie Baselinkera


Jaka informacja z BaseLinker jest zapisana w numerze oryginału w dokumencie w Subiekt GT?

Funkcjonalność umożliwia wskazanie jaki numer znajduje się w numerze oryginału dokumentu.

Konfiguracja scenariusza

Podczas konfiguracji należy wybrać jedną z trzech opcji :
origin_number_select
Wybór opcji w scenariuszu (26.01.2021)

Numer zamówienia BaseLinker - numer będzie w formacie B_numerBL
Numer zamówienia z oryginalnego źródła zamówienia - numer nadany np. w serwisie Allegro
Numer zamówienia ze sklepu - numer nadany przez sklep

Wynik działania

Po synchronizacji integracja będzie wiedziała po jakim numerze ma szukać zamówień.

Rozwiązywanie problemów

Jeśli wybierzemy daną opcję, a przykładowo utworzymy dokument ręcznie to integracja nie zobaczy tego dokumentu, można poprawić numer oryginału ręcznie zgodnie z zasadą numeracji.


W momencie kiedy do paragonu została wystawiona faktura detaliczna, wysyłaj jej plik PDF:

Funkcja umożliwia dodanie pod zamówienie wystawionej do paragonu Faktury detalicznej.

Konfiguracja scenariusza

W celu ustawienia tej funkcji, należy wybrać odpowiednio w scenariuszu TAK lub NIE.

RetailInvoice_To_Order
Wybór opcji dodania Faktury detalicznej (26.01.2021)

Wynik działania

Jeżeli do paragonów tworzymy faktury detaliczne i w scenariuszu wybierzemy “TAK”, pod zamówienie zostanie podpięty właśnie ten dokment. W przeciwnym wyborze (opcja “NIE”) pod zamówienie zostanie wysłany paragon.

Rozwiązywanie problemów

Brak wystawionej faktury detalicznej w systemie Subiekt GT - należy zweryfikować czy dokument istnieje po stronie ERP.