Elbuz pobiera zamówienia z CRM SalesDrive do dokumentów sprzedaży, a katalog i stany — z jego eksportu XML, więc sprzedaż, magazyn i dokumenty spotykają się w jednym miejscu bez ręcznego przenoszenia.
Kiedy to się przyda:
- Menedżerowie pracują w SalesDrive — nowe zamówienie pojawia się w Elbuz w kilka sekund.
- W CRM zebrała się historia — pierwszy import przez API przenosi ją stronami, bez tworzenia duplikatów.
- Katalog jest prowadzony w SalesDrive — produkty i stany przychodzą z feedu, a pozycje zamówień od razu znajdują swoje karty.
- Status zamówienia zmienił się w CRM — dokument aktualizuje płatność i dostawę, a statusu menedżera nie nadpisuje.
Od czego zacząć: weź z SalesDrive link do eksportu XML i klucz API, potem utwórz szablon „CRM SalesDrive”.
Co potrafi integracja z SalesDrive
Integracja działa dwoma kanałami jednocześnie: zamówienia przychodzą webhookiem i przez , katalog — z feedu XML.
- Natychmiastowe przyjmowanie zamówień — sam wysyła zamówienie do Elbuz, gdy tylko zostanie utworzone lub zmienione.
- Przeniesienie historii — klucz API pobiera wszystkie stare zamówienia stronami i uzupełnia to, co pominął.
- Ochrona Twoich poprawek — kwota, klient, skład i dokumentu po utworzeniu nie są nadpisywane.
- Katalog i stany z eksportu XML — produkty trafiają do katalogu bazowego, a pozycje zamówień są do nich dopasowywane po .
- Klienci i karty dla nieznanych produktów — kontrahenci i kategoria techniczna tworzą się sami.
Czego potrzebujesz od SalesDrive
| Gdzie w SalesDrive | Co zrobić |
|---|---|
| «Установки» → «Товари/Послуги» → «Експорт XML» (Ustawienia → Produkty/Usługi → Eksport XML) | skopiować link do eksportu |
| «Установки» → «Загальні налаштування і інтеграції» → «Інші сервіси» → „Webhook” (Ustawienia → Ustawienia ogólne i integracje → Inne serwisy) | wkleić adres webhooka z Elbuz |
| «Установки» → «Загальні налаштування і інтеграції» → «Інші сервіси» → „API” | utworzyć klucz z uprawnieniem «Заявки — читання» (Zamówienia — odczyt) |
Elbuz pobiera zamówienia i niczego nie zmienia w CRM, więc kluczowi wystarczy uprawnienie odczytu zamówień. Nie dawaj integracji zbędnych uprawnień.
Jak podłączyć
- Utwórz szablon typu „CRM SalesDrive” i zapisz go — adres webhooka pojawia się właśnie dla zapisanego szablonu.
- Wklej link do eksportu XML, subdomenę konta i klucz API.
- Skopiuj adres webhooka i wpisz go w ustawieniach SalesDrive; w karcie „Odbiór zamówień (Webhook)” zaznacz „Używaj webhooków”.
- Najpierw uruchom import katalogu, żeby produkty były już w Elbuz, a dopiero potem włączaj zamówienia: wtedy pozycje zamówień od razu znajdą swoje karty, zamiast tworzyć na wpół puste duplikaty.
- Sprawdź pierwsze zamówienia na oko — skład, kwotę, klienta, przewoźnika. Jeśli wszystkie dokumenty przyszły z tym samym statusem, wypełnij tabele dopasowania (które dokładnie).
Co trafia do dokumentu z zamówieniem
| Dane SalesDrive | Pole dokumentu w Elbuz |
|---|---|
| zewnętrzny numer zamówienia | Numer dokumentu |
| daty utworzenia i zmiany | Data zamówienia, data zmiany |
| imię, imię odojcowskie, nazwisko kontaktu | Imię i nazwisko klienta |
| telefon i e-mail kontaktu | Telefon, e-mail |
| kwota do zapłaty | Kwota dokumentu |
| komentarz | Opis zamówienia |
| status zamówienia | Status dokumentu (przez dopasowanie) |
| sposób płatności | Rodzaj płatności (przez dopasowanie) |
| przewoźnik, status listu przewozowego | Rodzaj dostawy, status dostawy |
| numer listu przewozowego, miasto, adres, oddział | Dane dostawy |
| pozycje: nazwa, kod produktu, cena, ilość | Wiersze dokumentu |
Statusy zamówienia, rodzaje płatności i przewoźnicy przychodzą kodami SalesDrive. Dopasuj je do swoich słowników przyciskami w karcie „Powiązane ustawienia” w formularzu szablonu — to różne tabele: osobno statusy zamówienia, osobno statusy dostawy, płatności i rodzaje płatności.
Jeśli w zamówieniu na pozycję ustawiono rabat — procentowy lub kwotowy — Elbuz od razu przelicza cenę wiersza z uwzględnieniem tego rabatu. Dlatego cena pozycji w Elbuz może różnić się od „bazowej” ceny produktu: to cena, za którą faktycznie sprzedano.
Klienci i kategoria techniczna
Klienci. Każde zamówienie szuka kontrahenta po e-mailu, potem po telefonie, potem po identyfikatorze kontaktu SalesDrive — i zakłada nowego w grupie „Klient”, jeśli nikogo nie znalazło. Jeśli w zamówieniu jest kontakt SalesDrive, a nie ma e-maila ani telefonu, program także zakłada nowego kontrahenta i wiąże go z ID tego kontaktu.
Technicznemu kontrahentowi „Odbiorca końcowy” przypada tylko zamówienie bez kontaktu, e-maila i telefonu: tworzy się raz i dalej przyjmuje wszystkie takie dokumenty. Usunięty „Odbiorca końcowy” wróci sam z pierwszym takim zamówieniem.
Kategoria dla nieznanych pozycji. Jeśli produktu z wiersza zamówienia nie ma w katalogu, Elbuz zakłada dla niego kartę i kładzie ją do kategorii technicznej „Produkty - salesdrive - nazwa Twojego szablonu”. Tworzy się ona wyłączona i nie bierze udziału w eksportach; następny przebieg znajduje ją po nazwie i kładzie karty tam samo.
- Kontrahent po usunięciu najpierw leży w koszu. Nowe zamówienie z tym samym e-mailem lub telefonem znów znajdzie właśnie jego. Trwałe usunięcie kontrahenta nie psuje dokumentów: pozycje, kwoty i nazwisko klienta w nich zostają, znika tylko odwołanie do karty.
- Kategorię techniczną usuwaj tylko pustą — razem z kategorią usuwane są produkty, dla których jest główna. Wiersze już zaimportowanych dokumentów nie ucierpią: nazwę, kod, cenę i ilość dokument przechowuje we własnych polach. Kolejność rozkładania — w przeglądzie importu danych.
Jak przychodzą zamówienia i co ponowny przebieg robi z poprawkami
Większość integracji w Elbuz działa przez odpytywanie — program co jakiś czas pyta platformę, czy są nowości. SalesDrive działa webhookiem (tak samo przyjmowane są zamówienia z Shopify i Wix): CRM sam puka do Elbuz, gdy tylko zamówienie zostanie utworzone lub zmienione. Zamówienie pojawia się w Elbuz w kilka sekund, a nie według harmonogramu.
Adres webhooka zawiera tajny klucz, który Elbuz generuje przy pierwszym otwarciu formularza szablonu — właśnie po nim rozpoznaje, do którego szablonu włożyć zamówienie. Dlatego nie publikuj adresu nigdzie poza ustawieniami samego CRM.
Oba kanały zapisują zamówienia z tymi samymi znacznikami źródła, więc zamówienie, które przyszło i webhookiem, i planowym importem, się nie dubluje: Elbuz rozpoznaje je po wewnętrznym ID zamówienia SalesDrive i pracuje na tym samym dokumencie. Webhook łapie bieżący strumień, a planowy import uzupełnia zgubione (np. gdy Elbuz był niedostępny) i przenosi historię przy pierwszym podłączeniu.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Co ponowny przebieg robi z Twoimi poprawkami
To samo zamówienie trafia do Elbuz więcej niż raz: najpierw webhookiem, potem może je przynieść planowy import, a po zmianie w CRM — znów webhook. Dokument jest przy tym zawsze jeden: program szuka go po wewnętrznym ID zamówienia SalesDrive razem z kodem źródła salesdrive.
| Co jest w dokumencie | Co robi ponowny przebieg |
|---|---|
| Kwota, imię i nazwisko klienta, telefon, e-mail, komentarz, miasto, adres, oddział, numer listu przewozowego | Nie zmienia: zapisują się tylko przy tworzeniu dokumentu |
| Skład dokumentu — nazwy, ceny, ilości w wierszach | Nie zmienia, nawet jeśli w CRM je potem zmieniono |
| Sposób płatności, przewoźnik, status dostawy | Doprowadza do tego, co podał CRM |
| Status płatności | Nie zmienia: zamówienie SalesDrive go nie przekazuje |
| Twój status | Zmienia tylko wtedy, gdy status w CRM jest inny niż poprzednio |
| Status samego zamówienia | Zapisuje w kolumnie „Status dokumentu (sklep)” listy zamówień |
| Dowolne pole zatwierdzonego dokumentu | Nie zmienia |
Istniejący dokument aktualizują nie wszystkie kanały:
- webhook o nowym zamówieniu tylko tworzy dokument, którego jeszcze nie ma;
- webhook o zmianie statusu w CRM aktualizuje dokument według tabeli powyżej;
- planowy import aktualizuje, gdy w bloku „Zaawansowane” jest już data w polu „Import zamówień począwszy od daty (RRRR-MM-DD)”;
- pierwsze przeniesienie historii (pola „Zaawansowane” puste) nie rusza istniejących dokumentów — tylko dodaje nowe.
Numer listu przewozowego, miasto i adres są brane z zamówienia tylko przy tworzeniu dokumentu. Jeśli list przewozowy wystawia menedżer CRM już po tym, jak zamówienie przyszło, wpisz numer w dokumencie ręcznie. Tak samo z kwotą i pozycjami: dodanie produktu do zamówienia po stronie SalesDrive niczego nie zmieni w dokumencie Elbuz.
Niedopasowany status niczego nie psuje. Jeśli dla statusu zamówienia lub płatności nie ma wiersza w tabeli dopasowania, w dokumencie zostaje to, co już jest. Rodzaj płatności i rodzaj dostawy nie bywają puste: bez wiersza dopasowania program dobiera je po nazwie z CRM, a gdy i to się nie uda — ustawia wartość domyślną.
Tabela dopasowania statusów działa w momencie przyjęcia zamówienia: jeśli wypełnisz ją później, już zaimportowanych dokumentów to nie zmieni — ich status zmienia się ręcznie.
Zatwierdź dokument: w zatwierdzonym import nie zmienia żadnego pola. Znacznik widać w kolumnie „Status zatwierdzenia”. Ogólne omówienie „kto kogo nadpisuje” — w przeglądzie importu zamówień.
Jak zaimportować katalog i stany
Produkty z SalesDrive przychodzą nie przez API, tylko zwykłym feedem XML: wklejasz link do eksportu z konta, a Elbuz czyta go tak samo jak każdy inny cennik XML. Feed można otworzyć w przeglądarce i zobaczyć, co dokładnie oddaje CRM.
Główna korzyść z tego kanału to dopasowanie pozycji. W zamówieniu SalesDrive każda pozycja ma pole «ID товару/послуги» (ID produktu/usługi) i właśnie tam trafia identyfikator z feedu. Gdy katalog i zamówienia przychodzą z jednego źródła, pozycje dopasowują się do Twoich kart automatycznie, bez zgadywania po nazwie.
Katalog z feedu trafia do katalogu bazowego — do okna „Produkty”, a nie do cenników dostawców. Karta jest rozpoznawana po identyfikatorze oferty z feedu: zgadza się — aktualizują się stan, cena, kategoria, kod produktu, nazwa i opis; nie zgadza się — zakładana jest nowa karta. Co pobierać z feedu oprócz produktów, włącza się opcjami w sekcji „Co importować”: „Importuj atrybuty”, „Importuj zdjęcia”, „Uzupełniaj słownik producentów”.
Jedno uruchomienie szablonu wykonuje obie prace po kolei: najpierw czyta feed XML, potem idzie przez API po zamówienia. Puste pole linku oznacza „nie importuj katalogu”, pusty klucz API — „nie importuj zamówień”.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Na witrynę i platformy katalog sam nie trafi — potrzebny jest do tego osobny „Eksport danych” (kiedy zaimportowane trafi dalej).
Czego zabrakło w feedzie
Pozycja zniknęła z eksportu XML — domyślnie jej karta zostaje w katalogu z ostatnią ceną i stanem, bez wiersza w dzienniku. Zmienia to opcja „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” w sekcji „Co importować”: dla SalesDrive naprawdę działa, bo katalog przychodzi feedem. Jak dokładnie usuwa — w przeglądzie importu danych.
Wybór nie jest zawężony do produktów tego źródła: do usunięcia trafia także to, co dodano ręcznie lub zaimportowano z innej integracji, a także kategorie, których nie ma w feedzie. Włączaj ją tylko wtedy, gdy feed SalesDrive jest jedynym źródłem Twojego katalogu. Już zaimportowane zamówienia na tym nie cierpią: wiersz dokumentu przechowuje nazwę, kod, cenę i ilość we własnych polach.
Aktualizacja według harmonogramu i wyłączanie
API SalesDrive ma twarde limity: około 10 zapytań na minutę, 100 na godzinę i 1000 na dobę. Elbuz pobiera zamówienia stronami po 100 sztuk z przerwą 6 sekund między stronami, więc masowy import historii idzie powoli. Harmonogram planowego importu ustawiaj nie częściej niż co 15 minut: bieżący strumień i tak łapie webhook.
W nagłówku karty szablonu jest plakietka „Aktywny” / „Wyłączony”, a w sekcji przyjmowania zamówień — opcja „Używaj webhooków”. Wyłączają one różne rzeczy.
1
Plakietka stanu: „Wyłączony”- Plakietka stanu — „Wyłączony” zdejmuje szablon z harmonogramu i zatrzymuje przyjmowanie webhooków.
| Co zrobiono | Co przestaje działać |
|---|---|
| Plakietkę przełączono na „Wyłączony” | planista już nie bierze tego szablonu, a webhook też przestaje być przyjmowany: zamówienia od SalesDrive Elbuz nie zapisze |
| Odznaczono „Używaj webhooków” | webhook nie jest przyjmowany, harmonogram działa jak wcześniej |
| Usunięto klucz API | zamówienia przez API nie są pobierane, katalog z feedu się importuje |
| Usunięto link do eksportu XML | katalog się nie importuje, zamówienia są przyjmowane |
Gdy szablon jest wyłączony lub opcja odznaczona, Elbuz nie odpowiada CRM niczym i nic nie zapisuje w dzienniku: po stronie SalesDrive wysyłka wygląda na udaną, a zamówienia w Elbuz nie ma. Dlatego po wyłączeniu szablonu patrz na listę zamówień, a nie na raport webhooków po stronie CRM.
Po ponownym włączeniu klucze, opcje, harmonogram i adres webhooka są na miejscu, w CRM niczego nie trzeba przestawiać. Zamówień, które SalesDrive próbował oddać w czasie przestoju, webhook ponownie nie przyśle, ale uzupełni je import przez API: bierze zamówienia zmienione po dacie w polu „Import zamówień począwszy od daty”. Przycisk „Importuj” działa także w wyłączonym szablonie (wyłączyć czy usunąć szablon).
Jak sprawdzić przebieg i naprawić błąd
Dziennik importu otwiera się w Centrum operacji — prawym panelu, który nie blokuje pracy: kartę szablonu można zamknąć, przebieg się od tego nie zatrzyma.
| Wiersz dziennika | Co oznacza |
|---|---|
| „SalesDrive: strona zamówień 2 z 5, pobrano łącznie: 200” | ile stron API już przeczytano i ile zamówień z nich przetworzono |
| „Pobrano zamówień: 100” | ile zamówień przyniosła ta strona — łącznie nowych i już znanych |
| „Łącznie zaimportowano zamówień: 12” | ile z nich stało się nowymi dokumentami; reszta już była w bazie. Brak wiersza — nic nowego |
| „Łącznie zaimportowano produktów: 3” | ile kart trzeba było założyć dla pozycji, których nie było w katalogu |
| „SalesDrive: błąd API — …” | czerwony wiersz z tekstem odmowy od CRM; przebieg się na nim zatrzymuje |
| „Import danych zakończony!” | koniec przebiegu, obok — czas trwania |
Na liście zamówień przyjęcie potwierdzają kolumny „Źródło: nazwa” (nazwa Twojego szablonu) i „Źródło (kod)” z wartością salesdrive. Obok przydadzą się jeszcze cztery:
- „Nr dokumentu (sklep)” — numer zamówienia w CRM;
- „Zewnętrzne ID dokumentu (ciąg UUID)” — jego wewnętrzny identyfikator, po którym dokument jest rozpoznawany przy ponownym przebiegu;
- „Data dodania (źródło)” i „Data aktualizacji (źródło)” — daty samego zamówienia, a nie momentu importu.
Brak potrzebnej kolumny — włącz ją w ustawieniach kolumn okna. Zamówienia, które przyszło webhookiem, szuka się tam samo: webhook nie pokazuje karty operacji z podsumowaniem.
Jeśli przebieg się przerwał
Strona 100 zamówień jest czytana z API i od razu zapisywana do bazy, i od razu przesuwa się znacznik „dokąd doszliśmy” — pola „Import zamówień począwszy od ID” i „Import zamówień począwszy od daty” w bloku „Zaawansowane” karty szablonu. Dlatego przerwanie dzieli pracę na dwie części: przeczytane strony już są dokumentami, do reszty nie doszło.
1
Import zamówień począwszy od ID2
Import zamówień począwszy od daty- Począwszy od ID — pokazuje, dokąd doszedł import zamówień.
- Począwszy od daty — planowy import bierze zamówienia zmienione od tej daty.
Powtórzenie jest bezpieczne: zamówienie, które już stało się dokumentem, jest rozpoznawane po swoim ID i nie tworzy drugiego dokumentu. Na przerwanie reaguj więc prosto — uruchom import jeszcze raz.
- Program czeka na CRM 30 sekund na połączenie i do 120 sekund na odpowiedź. Jeśli się nie doczeka lub dostanie odmowę — czerwony wiersz „SalesDrive: błąd API —”, a przebieg się zatrzymuje; ponownych prób ta integracja nie ma.
- Przycisk zatrzymania przy zamówieniach działa między stronami: bieżącą stronę program doczytuje i zapisuje, a następnej już nie bierze.
Jeśli zaimportowano nie to
Najczęstszy powód — pierwszy przebieg z niewypełnionymi tabelami dopasowania: zamówienia przyszły, ale wszystkie z jednym statusem. Leczy się to nie ponownym importem, tylko filtrem i usunięciem.
- Na liście zamówień przefiltruj „Źródło (kod)” po wartości
salesdrivei dodaj filtr po „Data dodania” — wyjdzie dokładnie to, co ta integracja dodała danego dnia. - Zaznacz wiersze i usuń partią. Zaraz po usunięciu pojawia się komunikat „Usunięto dokumentów: N” z przyciskiem „Cofnij”, który przywraca całą partię razem z wierszami. Jeśli przegapisz ten moment, partia przez 30 dni leży w „Koszu dokumentów” (menu okna).
- Wyczyść w bloku „Zaawansowane” pola „Import zamówień począwszy od ID” i „Import zamówień począwszy od daty”, zapisz szablon i uruchom import od nowa — zamówienia przyjdą już przez wypełnione tabele dopasowania. Bez tego kroku usunięte zamówienia same nie wrócą: znacznik „dokąd doszliśmy” jest już przesunięty.
Zatwierdzonych dokumentów partia nie zabierze: w odpowiedzi przyjdzie „Nie usunięto zatwierdzonych dokumentów (N). Najpierw anuluj zatwierdzenie.” To celowe — usunięcie zatwierdzonego nie cofnęłoby ani obrotu kontrahenta, ani rezerwacji.
Scenariusze
Zamówienia z CRM — do dokumentów, katalog prowadzisz w Elbuz sam
Wypełnij „Konto SalesDrive” i „Klucz API”, pole „Link API” zostaw puste, adres webhooka wpisz w SalesDrive, a w karcie „Odbiór zamówień (Webhook)” zaznacz „Używaj webhooków”. Uruchomienie szablonu nie czyta wtedy feedu, tylko importuje zamówienia przez API, a nowe zamówienia z webhooka stają się dokumentami sprzedaży.
Katalog się przy tym nie aktualizuje. Pozycję zamówienia program szuka w Twoich kartach po nazwie razem z kodem, potem po samej nazwie; jeśli nie znajdzie — zakłada kartę w kategorii technicznej.
Przenieść historię zamówień przy podłączeniu
Wypełnij „Konto SalesDrive” i „Klucz API”, pola „Import zamówień począwszy od ID” i „Import zamówień począwszy od daty (RRRR-MM-DD)” w bloku „Zaawansowane” zostaw puste i uruchom szablon. Zamówienia przychodzą stronami po 100 z przerwą 6 sekund, każda strona zapisuje się do bazy przed zapytaniem o następną, a pola „Zaawansowane” wypełniają się same. Ten przebieg nie zmienia istniejących dokumentów.
Potrzebujesz historii nie od początku — wpisz w pole „Import zamówień począwszy od ID” wewnętrzne ID zamówienia SalesDrive, do którego włącznie przenosić nie trzeba, a pole daty zostaw puste: przebieg zacznie od następnego.
Statusy i płatność z CRM docierają do dokumentu, a menedżer prowadzi własny status
W karcie „Powiązane ustawienia” wypełnij tabele „Statusy zamówienia” i „Statusy dostawy”, włącz webhook i harmonogram planowego importu. Gdy zamówienie w CRM się zmienia, dokument dostaje nową płatność i dostawę, a Twój status — tylko jeśli status w samym CRM jest inny niż poprzednio. Kwota, skład, klient i numer listu przewozowego zostają takie, z jakimi dokument powstał; zatwierdzonych dokumentów aktualizacja nie rusza.
Katalog Elbuz w pełni odzwierciedla feed SalesDrive
Wklej link do eksportu XML w „Link API” i w sekcji „Co importować” zaznacz „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku”. Produkty i kategorie, których nie ma w feedzie, są usuwane fizycznie — w tym karty dodane ręcznie (czego zabrakło w feedzie). Już zaimportowane dokumenty na tym nie cierpią.
Co zrobić, gdy zamówienia nie przychodzą
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Zamówienie jest w SalesDrive, a w Elbuz się nie pojawia | Adres webhooka skopiowano niecały lub nie wpisano go w SalesDrive; szablon jest wyłączony albo odznaczono „Używaj webhooków” | Skopiuj adres razem z kluczem na końcu i sprawdź stan szablonu (co wyłącza co) |
| „SalesDrive: podaj konto i klucz API, aby importować zamówienia” | Klucz jest wypełniony, a pole „Konto SalesDrive” puste | Wpisz subdomenę konta (pola połączenia) |
| Przebieg zrobił tylko katalog, o zamówieniach w dzienniku nic | Pole „Klucz API” jest puste | Utwórz klucz w SalesDrive i wklej do szablonu (skąd wziąć) |
| „SalesDrive: błąd API — …” o przekroczeniu limitów | Harmonogram uruchamia import zbyt często | Ustaw harmonogram nie częściej niż co 15 minut (limity) |
| Pozycje zamówień nie dopasowują się do katalogu | Katalog w Elbuz przyszedł nie z tego eksportu XML: identyfikatory są różne | Zaimportuj katalog z feedu SalesDrive (katalog i stany) |
| Wszystkie zamówienia przyszły z tym samym statusem | Tabela dopasowania statusów nie jest wypełniona | Wypełnij tabelę i zaimportuj okres ponownie (jak) |
| Listu przewozowego wystawionego w CRM nie ma w dokumencie | List przewozowy jest brany tylko przy tworzeniu dokumentu | Wpisz numer ręcznie (co się aktualizuje) |
Najczęstsze pytania
Jakich uprawnień potrzebuje klucz API SalesDrive?
Wystarczy odczyt zamówień («Заявки — читання»): Elbuz pobiera dane i niczego nie zmienia w CRM. Klucz tworzy się w «Установки» → «Загальні налаштування і інтеграції» → «Інші сервіси» → «API» (Ustawienia → Ustawienia ogólne i integracje → Inne serwisy → API).
Po co webhook, skoro jest klucz API?
Webhook przynosi zamówienia natychmiast, a klucz API przenosi historię przy pierwszym podłączeniu i uzupełnia to, co mogło nie dojść. To samo zamówienie się przy tym nie dubluje (jak działają kanały).
Dlaczego import historii jest taki powolny?
Z powodu limitów SalesDrive — około 10 zapytań na minutę. Elbuz robi przerwy między stronami, dlatego duża historia przenosi się stopniowo (limity).
Skąd biorą się produkty — też przez API?
Nie, katalog i stany przychodzą z eksportu XML SalesDrive, którego link wkleja się w pole „Link API”. To daje też dokładne dopasowanie pozycji w zamówieniach.
Czy ponowny import zetrze moje poprawki w zamówieniu?
Nie: kwota, klient, komentarz, adres, list przewozowy i skład dokumentu zostają Twoje, a Twój status zmienia się dopiero po zmianie statusu w CRM. Zatwierdzony dokument w ogóle się nie zmienia (tabela pól).
Zamówienia zaimportowano przez pomyłkę — jak je usunąć?
Przefiltruj listę zamówień po „Źródło (kod)” = salesdrive i usuń partią; przycisk „Cofnij” i „Kosz dokumentów” przywracają usunięte (krok po kroku).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych
- Typ szablonu
- „CRM SalesDrive”
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- link do eksportu XML, subdomenę konta i klucz API SalesDrive
W karcie „Połączenie” szablonu są trzy pola, a każde odpowiada za swój kanał:
| Pole | Za co odpowiada |
|---|---|
| Link API | Eksport XML produktów z SalesDrive — katalog i stany |
| Konto SalesDrive | Subdomena Twojego konta (np. mycompany) — potrzebna do importu zamówień przez API |
| Klucz API | Klucz do odczytu zamówień — historia zamówień i uzupełnianie zmienionych |
Osobno w formularzu jest pole z adresem webhooka: Elbuz generuje go sam, Tobie zostaje skopiować go (wystarczy kliknąć pole) i wkleić w ustawieniach SalesDrive.
1
Link API2
Konto SalesDrive3
Klucz API- Link API — link do eksportu XML z katalogiem i stanami.
- Konto SalesDrive — subdomena Twojego konta SalesDrive.
- Klucz API — służy do importu zamówień.
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu, jak zamówienia z różnych systemów stają się dokumentami, — Import zamówień przez API.
- Jeśli produkty z feedu mają trafić na stronę lub platformę — Kiedy zaimportowane trafi dalej.
- Jeśli zamówienie trzeba zatwierdzić i zarezerwować towar — Zamówienie klienta.
