Jak połączyć FGO z easySales: kompletny przewodnik konfiguracji
Połącz FGO z easySales: trzy kroki do wykonania najpierw w FGO, każde ustawienie połączenia, jak powstają faktury, co oznacza każdy błąd FGO i FGO jako źródło stanów magazynowych.
Co daje Ci połączenie z FGO
FGO to rumuński serwis do fakturowania. Połączony z easySales wystawia fakturę do zamówienia bez przepisywania czegokolwiek — z listy zamówień, z samego zamówienia, zbiorczo albo automatycznie z flow. Tego samego użytkownika API FGO możesz wykorzystać drugi raz, w osobnym połączeniu, żeby wczytywać stany magazynowe z FGO do easySales.
Zanim zaczniesz
Konto FGO z dostępem do API
Użytkownika API z kroku 1 można utworzyć tylko na planie FGO, który obejmuje dostęp do API. Sprawdź swój plan w FGO, zanim zaczniesz.
Użytkownik API utworzony w FGO
To nie jest Twój zwykły login. FGO generuje dla niego hasło, a to hasło jest tym, co easySales nazywa Kluczem prywatnym.
Twoje CUI
Rumuński kod podatkowy pokazywany w FGO w Setări → Firmă. To jego wpisujesz w pole NIP, nie polski numer NIP.
Gotowa seria faktur
Z uprawnieniami API, ważnym okresem i wolnymi numerami. To krok pomijany najczęściej.
Kroki od 1 do 3 wykonujesz w FGO, a nie w easySales. Każdy z nich kończy się inną awarią, a pominięcie któregokolwiek daje komunikat błędu, który ma sens dopiero wtedy, gdy wiesz, czego dotyczy — dlatego warto zrobić wszystkie trzy, zanim otworzysz easySales.
Krok 1 — Utwórz użytkownika API w FGO
W panelu administracyjnym FGO otwórz Setări → Utilizatori (Ustawienia → Użytkownicy) i dodaj użytkownika API. FGO wygeneruje dla niego hasło: skopiuj tę wartość od razu, bo to właśnie ona jest tym, co easySales nazywa polem Klucz prywatny.
Krok 2 — Pozwól FGO przyjmować wywołania z easySales
W FGO otwórz Setări → eCommerce → Setări API (Ustawienia → eCommerce → Ustawienia API) i dodaj https://easy-sales.com do listy witryn, które mogą łączyć się przez API.
Krok 3 — Przygotuj serię faktur
W FGO otwórz Setări → Serii Documente (Ustawienia → Serie dokumentów) i sprawdź serię, którą zamierzasz fakturować. Musi mieć uprawnienie User API — zarówno na samym użytkowniku API, jak i na wpisie obejmującym wszystkich użytkowników — oraz okres od / do obejmujący dzisiejszą datę i wolne numery.
Krok 4 — Połącz FGO w easySales
Przejdź do Konfiguracja → Integracje → Oprogramowanie księgujące i znajdź kafelek FGO.
Naciśnij Połącz i wypełnij formularz.
| Pole | Co robi |
|---|---|
| Alias | Wymagane. Twoja własna etykieta. Staje się nazwą zakładki, jeśli podłączysz więcej niż jedno konto FGO. |
| NIP | Wymagane. Twoje CUI, dokładnie tak, jak FGO pokazuje je w Setări → Firmă. Mimo nazwy pola nie chodzi tu o polski numer NIP. |
| Klucz prywatny | Wymagane. Hasło, które FGO wygenerowało dla użytkownika API w kroku 1. Na tym formularzu jest pokazywane jawnie, a nie maskowane. |
| Typ Faktury | Jaki dokument FGO ma wystawić — Factura dla zwykłej faktury, a łącznie jedenaście opcji, w tym Proforma, Aviz, odwrotne obciążenie i procedura marży. |
| Metoda powiązania produktów | Jak easySales mówi FGO, którego artykułu dotyczy pozycja. SKU wysyła kod zapasu produktu, a w razie jego braku SKU. Nazwa nie wysyła żadnego kodu i pozwala FGO dopasować po nazwie artykułu. |
| Użyj źródła stockowego | Wymagane, ale dla FGO nic nie zmienia. Tym, co faktycznie sprawia, że FGO zdejmuje towar ze stanu, jest poniższe pole Kod Saga Warehouse. |
| Kod Saga Warehouse | Magazyn FGO, na który księgowana jest każda pozycja faktury — to on sprawia, że FGO zdejmuje towar ze stanu. Wpisz go dokładnie tak, jak nazywa się w FGO. Zostaw puste, jeśli nie prowadzisz tam stanów. |
| Szablon | Dowolny tekst drukowany w uwagach faktury. Przyciski powyżej wstawiają zmienne — numer zamówienia, numer listu przewozowego, kuriera, metodę płatności albo listę zamówionych produktów. |
Krok 5 — Opcje zaawansowane
Sekcja Pokaż opcje zaawansowane jest domyślnie zwinięta i nic w niej nie jest wymagane, ale dwa ustawienia rozwiązują problemy, które inaczej trudno zdiagnozować.
| Ustawienie | Co robi |
|---|---|
| Kody identyfikacyjne opłat | Mapuje pozycje wysyłki, rabatu i opłat na kody artykułów, których używasz w FGO. Dla każdej podajesz slug, fragment nazwy opłaty i kod artykułu FGO. Bez tego takie pozycje trafiają do FGO jako niedopasowane artykuły. |
| Użyj opisu produktu | Decyduje, co trafia do kolumny opisu na fakturze — nic, kod produktu, jego nazwa, właściwości albo EAN. |
| Wybierz nazwę produktu | Która z trzech nazw przechowywanych w easySales zostanie wydrukowana: Magazynowa nazwa produktu, Nazwa produktu czy Nazwa oferty. |
| Wyświetl produkty darmowe jako osobna zniżka | Umieszcza darmowe pozycje na fakturze jako linię rabatu zamiast produktu w cenie zero. |
| Usuń znaki specjalne | Usuwa znaki specjalne z nazw i adresów klientów przed wysłaniem. Przydatne, gdy FGO odrzuca znak diakrytyczny albo symbol. |
| Wygeneruj gwarancję po wystawieniu faktury | Tworzy przy okazji kartę gwarancyjną z wybranego szablonu i potrafi scalić ją z fakturą w jeden PDF. |
| Wyklucz rabaty z faktur | Całkowicie pomija pozycje rabatowe na dokumencie. |
Krok 6 — Wskaż easySales, której serii ma użyć
Połączenie samo w sobie nie niesie serii. easySales ustala ją dla każdego zamówienia po kolei: najpierw seria ustawiona na połączeniu z marketplace'em, z którego przyszło zamówienie, potem ta ustawiona na witrynie, a na końcu ta, która jest już na samym zamówieniu.
Wystawianie faktur
| Skąd | Czym | Seria |
|---|---|---|
| Lista zamówień | Szybko stwórz w kolumnie faktury | Brana z zamówienia |
| Strona samego zamówienia | Stwórz fakturę | Brana z zamówienia |
| Lista zamówień, kilka naraz | Generuj fakturę — do 50 zamówień, jedna faktura na każde | Ustalana osobno dla zamówienia |
| Grupa przetwarzania | Stwórz fakturę | Ustalana osobno dla zamówienia |
| Flow automatyzacji | Akcja Stwórz fakturę | Ustalana osobno dla zamówienia |
Kiedy faktura się nie uda
Odmowy z FGO przekazujemy słowo w słowo, po rumuńsku, niezależnie od tego, w jakim języku używasz easySales. Są precyzyjne, kiedy już umiesz je odczytać.
| Co mówi FGO | Co zrobić |
|---|---|
Platforma https://easy-sales.com nu este inregistrata in FGO
|
Krok 2 został pominięty. Dodaj ten adres w FGO w Setări → eCommerce → Setări API. |
Registrul pentru seria … nu este definit sau a expirat.
|
Seria nie ma uprawnień API, jej okres minął albo skończyły się numery. Sprawdź wszystkie trzy rzeczy w Setări → Serii Documente. |
Campul 'Serie' este obligatoriu.
|
Do FGO nie dotarła żadna seria. Ustaw ją na połączeniu z marketplace'em albo na witrynie. |
Hash-ul transmis nu este corect.
|
Klucz prywatny jest błędny albo został zmieniony w FGO. Wklej aktualny jeszcze raz. |
Utilizatorul nu exista sau nu are drepturi de acces.
|
Użytkownik API został usunięty albo stracił uprawnienia. Utwórz go ponownie w Setări → Utilizatori. |
Codul unic nu exista sau nu este asociat.
|
Wartość w polu NIP nie zgadza się z CUI konta FGO. |
Campul Client[CodUnic] este obligatoriu.
|
Klient jest firmą, ale zamówienie nie ma CUI. Uzupełnij je w danych do faktury na zamówieniu. |
Judetul … nu exista in nomenclator
|
Adres do faktury nie ma okręgu albo ma taki, którego FGO nie rozpoznaje. Wybierz okręg na zamówieniu. |
CotaTVA … nu exista in nomenclator.
|
Stawka VAT z pozycji nie istnieje w FGO. Dodaj ją w FGO albo popraw na zamówieniu. |
Factura este deja stornata.
|
Do tej faktury istnieje już korekta. |
Factura a fost transmisa in SPV. Nu se poate anula.
|
Faktura została złożona w ANAF i nie da się jej już anulować — wystaw korektę. |
Opcjonalnie — FGO jako źródło stanów magazynowych
FGO może też powiedzieć easySales, ile towaru masz na stanie. To drugie, osobne połączenie w Konfiguracja → Integracje → Źródła zapasu, z tym samym CUI i tym samym hasłem użytkownika API, i musi zostać przypięte do witryny, zanim cokolwiek się zsynchronizuje.
