Mobilna Faktura
Zaloguj
Integracje

Integracja z Shopify

Jak połączyć Mobilną Fakturę ze sklepem Shopify tokenem Admin API: pobieranie zamówień, faktury pojedynczo i zbiorczo, NIP nabywcy z zamówienia i synchronizacja stanów do lokalizacji Shopify (pakiet Max).

Co daje integracja z Shopify?

Pakiet Max.

  • Lista zamówień ze sklepu Shopify,
  • faktury do zamówień — pojedynczo albo zbiorczo dla zaznaczonych,
  • NIP nabywcy odczytany z zamówienia,
  • synchronizacja stanów magazynowych — stan z panelu trafia do wybranej lokalizacji (magazynu) w Shopify.

Menu: Sklepy → Shopify (Lista zamówień, Ustawienia).

Krok 1: token w Shopify

W panelu Shopify: Settings → Apps and sales channels → Develop apps → utwórz aplikację → nadaj uprawnienia read_orders, read_products, read_locations, write_inventory → Install app → skopiuj Admin API access token.

Shopify pokazuje token tylko raz — zapisz go od razu w panelu.

Krok 2: ustawienia w panelu

Sklepy → Shopify → Ustawienia (albo przycisk Ustawienia nad listą zamówień).

Połączenie ze sklepem

  • Domena sklepu — adres .myshopify.com; możesz wkleić pełny link, panel go skróci,
  • Token dostępu (Admin API) — puste pole przy kolejnej edycji zachowuje zapisany token,
  • Wersja API — zostaw domyślną, chyba że masz powód ją zmienić,
  • przycisk Testuj połączenie.

Zamówienia

  • Domyślne statusy płatności — które zamówienia pokazywać domyślnie na liście,
  • Skąd pobierać NIP nabywcy — Pole dodatkowe zamówienia (note_attributes) albo Nazwa firmy w adresie (company); przy polu dodatkowym podaj Nazwę pola z NIP-em (wielkość liter nie ma znaczenia).

Shopify nie ma osobnego pola na NIP. Jeśli w wybranym miejscu go nie będzie, panel sprawdzi też drugie. Rozpoznaje 10 cyfr w dowolnym formacie (np. PL 123-456-32-18).

Na koniec Zapisz ustawienia. Ustawienia Shopify nie mają opcji automatycznego wystawiania faktur — faktury wystawiasz z listy zamówień.

Zamówienia i faktury

  1. Sklepy → Shopify → Lista zamówień.
  2. Ustaw daty Od i Do oraz Statusy płatności → Pobierz zamówienia.
  3. Wystaw fakturę ikoną przy zamówieniu albo zaznacz kilka (Zaznacz wszystkie / Odznacz wszystkie) → Wystaw faktury dla zaznaczonych → potwierdź.

Kolumny: Numer, Klient, Płatność, Realizacja, Data, Suma, Faktura.

  • Fakturę można wystawić tylko do zamówień opłaconych, częściowo opłaconych, częściowo zwróconych lub autoryzowanych.
  • Zamówienie z wystawioną fakturą ma w kolumnie Faktura oznaczenie Wystawiona — drugiej faktury do niego nie wystawisz.
  • Standardowe uprawnienie read_orders daje dostęp tylko do zamówień z ostatnich 60 dni. Pełna historia wymaga zgody Shopify.

Synchronizacja stanów magazynowych

Sekcja Synchronizacja stanów magazynowych w ustawieniach:

  1. Zapisz ustawienia i Testuj połączenie — panel pobierze listę lokalizacji ze sklepu.
  2. Wybierz Lokalizację magazynu — magazyn Shopify, do którego trafiają stany (bez niej synchronizacja nie działa).
  3. Kliknij Dopasuj produkty po SKU — panel połączy towary z kartoteki z wariantami Shopify po kodzie (kod towaru = SKU). Wystarczy raz, przed włączeniem synchronizacji.
  4. Zaznacz Włącz wysyłanie stanów do Shopify i zapisz.
  5. Opcjonalnie Wyślij stany teraz — jednorazowo dodaje wszystkie dopasowane towary do kolejki.

Od tej pory zmiany stanów (dokumenty magazynowe, MM, inwentaryzacja, faktura sprzedaży) wysyłane są automatycznie co ok. 5 minut. Wysyłany jest tylko stan — ceny i opisy zostają w Shopify.

Synchronizacja przez REST API obsługuje sklepy do 100 wariantów produktów.

Zobacz także