Integracja Shoper ze stanami, fakturami i statusami zamówień
Zamówienia z Shopera przepisywane do programu do faktur, stany poprawiane ręcznie po dostawie, numer przesyłki wklejany klientowi do maila. Każdą z tych czynności da się przenieść na połączenie przez API.
Autor: Szymon Łakomy. Aktualizacja:
Co przepływa między Shoperem a resztą firmy
| Dane | Kierunek | Kiedy |
|---|---|---|
| Nowe zamówienie z danymi klienta | z Shopera do programu do faktur, magazynu lub CRM | od razu po powiadomieniu z webhooka |
| Stany magazynowe | z magazynu lub ERP do Shopera | po każdej zmianie albo według harmonogramu |
| Ceny i promocje | z programu, w którym prowadzisz cennik, do Shopera | po zmianie cennika |
| Status zamówienia | w obie strony, według spisanej tabeli statusów | przy każdej zmianie |
| Numer przesyłki | z systemu kurierskiego do zamówienia w Shoperze | po nadaniu paczki |
Jakie zdarzenia wywołują webhook i które pola udostępnia API, sprawdzam w dokumentacji Shopera przed wyceną.
REST API i webhooki Shopera od strony technicznej
Shoper udostępnia REST API, przez które integracja czyta i zapisuje zamówienia, produkty oraz stany. Webhook działa odwrotnie: sklep sam wysyła powiadomienie, gdy pojawi się nowe zamówienie albo zmieni się status, więc nie muszę odpytywać go co kilka minut. Dla integracji zakładam osobny dostęp z uprawnieniami tylko do potrzebnych danych, zamiast korzystać z loginu właściciela sklepu. Sama logika działa poza Shoperem, na serwerze albo w n8n, z kolejką i ponowieniem, gdy drugi program chwilowo nie odpowiada.
Kiedy wystarczy aplikacja ze sklepu z aplikacjami Shopera
Gotowa aplikacja
Twój program do faktur lub magazyn ma gotowe połączenie, a sklep działa według prostych zasad: jeden magazyn, typowe statusy, faktura po opłaceniu. Wtedy konfiguruję aplikację i nie piszę kodu.
Aplikacja plus brakujący fragment
Gotowe połączenie wystawia faktury, ale nie przenosi statusów albo numerów przesyłek. Dokładam tylko ten element, a resztę zostawiam bez zmian.
Własna integracja
Program nie ma aplikacji dla Shopera, masz kilka magazynów, inne reguły dla klientów hurtowych albo dane mają trafiać do CRM lub własnego panelu.
Stany i ceny: jeden program nadrzędny
Najwięcej błędów bierze się z tego, że stan lub cenę zmienia się w dwóch miejscach naraz. Przed budową ustalamy, który program jest nadrzędny dla każdej z tych danych.
- Kod produktu w Shoperze musi zgadzać się z kodem w magazynie. Rozbieżności wyłapuję raportem przed pierwszą synchronizacją.
- Warianty, na przykład rozmiar i kolor, mają osobne stany, więc każdy dostaje własny kod.
- Ustalamy, czy zamówienie złożone, ale jeszcze nieopłacone, ma od razu zmniejszać stan w magazynie.
- Gdy ceny i stany przychodzą od dostawcy, ich wczytywanie opisuję na stronie integracja z hurtownią XML i CSV.
Shoper razem z BaseLinkerem, kurierami i KSeF
Jeśli zamówienia z Shopera i innych kanałów obsługujesz w BaseLinkerze, połączenie z programem do faktur często lepiej zrobić tam, a nie w sklepie. Ten wariant opisuję na stronie integracja BaseLinker. Nadawanie paczek i powrót numeru śledzenia do zamówienia to temat strony integracja z InPost i kurierami. Co obowiązek wystawiania faktur w KSeF zmienia przy zamówieniach ze sklepu, wyjaśniam w tekście KSeF w sklepie internetowym.
Koszt i pierwsze dni po uruchomieniu
Połączenie Shopera z programem do faktur, w którym opłacone zamówienie zamienia się w dokument, to zakres od około 800 zł netto. Synchronizację stanów z magazynem, kilka sklepów albo CRM wyceniam po rozmowie, bo zależy od liczby produktów i wyjątków. Przez pierwsze dni po starcie codziennie przeglądam log integracji i porównuję dokumenty z zamówieniami. Jak liczę takie projekty, piszę w poradniku ile kosztuje integracja API, a samo wystawianie dokumentów opisuje strona automatyzacja fakturowania.
Najczęstsze pytania
Czy po integracji praca w sklepie zmieni się dla zespołu?
Zespół dalej pracuje w panelu Shopera i w swoim programie. Znika przepisywanie zamówień i poprawianie stanów, a o błędach, na przykład o odrzuconej fakturze, wskazana osoba dostaje powiadomienie mailem.
Mam program do faktur bez aplikacji dla Shopera. Czy da się go połączyć?
Najczęściej tak. Wystarczy, że program ma interfejs API albo potrafi wczytać dokument z pliku, na przykład XML. Zanim podam kwotę, sprawdzam, na co pozwala Twoja wersja i licencja.
Co się stanie, gdy Shoper albo program do faktur będzie niedostępny?
Zamówienie czeka w kolejce i zostaje przetworzone, gdy oba systemy znów odpowiadają. Nic nie przepada i nie powstaje druga faktura do tego samego zamówienia, bo integracja zapamiętuje, co już zrobiła.
Czy mogę przenieść sklep z Shopera i zachować integrację?
Część logiki, na przykład mapowanie statusów i reguły faktur, da się przenieść. Połączenie ze sklepem trzeba jednak napisać od nowa pod API nowej platformy, więc taką zmianę wyceniam osobno.
Powiązane strony
Chcesz połączyć sklep na Shoperze z innym programem?
Napisz, z jakim programem do faktur lub magazynem pracujesz i ile zamówień dziennie obsługuje sklep.