Jak połączyć Oblio z easySales: pełny przewodnik konfiguracji
Podłącz Oblio do easySales: trzy dane dostępowe, co naprawdę robi zdejmowanie ze stanu, serie faktur i paragonów, opcje dostępne tylko dla Oblio i znaczenie każdej odmowy.
Co daje Ci połączenie Oblio
Z podłączonym Oblio easySales wystawia fakturę do zamówienia, wysyła ją klientowi, oznacza jako opłaconą, anuluje lub stornuje i potrafi utrzymywać magazyn w Oblio w zgodzie z easySales — bez otwierania Oblio.
Ten przewodnik opisuje całe połączenie, łącznie z ustawieniem, które decyduje o tym, czy faktury w ogóle wychodzą.
Zanim zaczniesz
Konto Oblio z dostępem do API
Token wydawany jest na stronie ustawień konta w Oblio. Jeśli nie ma go tam, plan nie obejmuje dostępu do API, a połączenie zakończy się błędem You are not allowed to use this API.
CIF taki, jaki ma Oblio
Numer rejestracyjny firmy jest porównywany z firmami w Twoim koncie Oblio, a nie tylko sprawdzany pod kątem formatu.
Seria faktur utworzona w Oblio
easySales wysyła serię z zamówienia. Każda seria, której może użyć, musi najpierw istnieć w Oblio — inaczej faktura nie powstanie.
Decyzja w sprawie magazynu
Czy magazyn Oblio ma być zdejmowany przy wystawianiu faktury. Jeśli tak, musi być prowadzony rzetelnie — zbyt niski stan w Oblio zatrzymuje fakturę.
Krok 1 — Otwórz stronę Oprogramowanie księgujące
Wejdź w Integracje → Oprogramowanie księgujące i wyszukaj oblio.
Kliknij Połącz na karcie Oblio. Jeśli masz już połączenie, kliknij Edytuj.
Krok 2 — Trzy dane dostępowe
| Pole | Co to jest |
|---|---|
| Alias | Twoja własna nazwa tego połączenia. Nigdy nie trafia do Oblio. |
| NIP |
Rumuński CIF firmy wystawiającej faktury, dokładnie taki, jaki ma Oblio. Wysyłany z każdym żądaniem jako cif; firma, której Oblio nie rozpozna, kończy się błędem The company with cif … does not exist.
|
| Nazwa użytkownika (E-mail) | Adres e-mail konta Oblio. Oblio używa go jako identyfikatora klienta API. |
| Token | Sekret API z ustawień konta Oblio. To nie jest hasło do Oblio. |
Krok 3 — Zdecyduj o magazynie, zanim zapiszesz
Użyj źródła stockowego to najważniejsze pole tego formularza — rumuński interfejs nazywa je wprost: zdejmij towar z magazynu przy fakturowaniu.
Krok 4 — Serie, stanowisko i reszta
| Pole | Co robi |
|---|---|
| Użyj źródła stockowego | Tak sprawia, że każda faktura zdejmuje też towar z magazynu Oblio. Zobacz ostrzeżenie powyżej. |
| Nazwa magazynu | Magazyn Oblio, z którego schodzi towar. Opcjonalny, rozróżnia wielkość liter i w praktyce niezbędny, gdy tylko włączysz zdejmowanie ze stanu lub masz więcej niż jeden magazyn. |
| Nazwa stanowiska pracy | Punkt Oblio, z którego wystawiany jest dokument. Opcjonalny, rozróżnia wielkość liter. |
| Seria paragonów | Seria, której Oblio ma użyć, gdy płatność rozliczana jest paragonem. Ignorowana przy każdym innym typie rozliczenia. |
| Wyślij aktualizacje ceny | Wysyła zmiany cen z easySales do odpowiadającego produktu w Oblio. Wymagane — formularz nie zapisze się bez odpowiedzi. |
| Użyj opisu produktu | Umieszcza opis produktu w wierszu faktury zamiast samej nazwy. |
| Szablon | Adnotacja drukowana na fakturze. |
Pole Szablon ustala treść adnotacji drukowaną na każdej fakturze z tego połączenia. Przyciski nad nim wstawiają wartości z zamówienia — numer zamówienia, platformę, obserwacje, numer listu przewozowego, kuriera, metodę płatności.
Krok 5 — Opcje zaawansowane
Nic tutaj nie jest obowiązkowe, ale cztery opcje istnieją wyłącznie dla Oblio, a jedna zapobiega duplikatom faktur.
| Opcja | Co robi |
|---|---|
| Język faktury | Wymusza jeden język dla wszystkich faktur. Pozostawiony pusty sprawia, że easySales używa języka sklepu lub marketplace'u, z którego przyszło zamówienie, o ile Oblio go obsługuje. |
| NIP wystawiającego i Imię i nazwisko wystawiającego | Drukowane na fakturze jako osoba wystawiająca. Rumuński CNP jest sprawdzany co do 13 cyfr. |
| Termin zapłaty | Ile dni od wystawienia faktura jest wymagalna. |
| Typ płatności | Wymusza typ rozliczenia zapisywany przez Oblio — paragon, bon fiskalny, karta, polecenie przelewu i pozostałe. Pozostawiony pusty sprawia, że easySales wyprowadza go z metody płatności zamówienia. Po wybraniu paragonu używana jest Seria paragonów powyżej. |
| Wybierz nazwę produktu | Która nazwa trafia do wiersza faktury: nazwa produktu czy ta z zamówienia. |
| Automatyczne wykrywanie | Ustala dzielnicę Bukaresztu na podstawie adresu, gdy zamówienie jej nie zawiera. |
| Wygeneruj unikalny kod zniżkowy | Tylko Oblio. Wysyła każdy rabat jako osobny kodowany wiersz zamiast je łączyć. |
| Ustaw odwrócony podatek | Tylko Oblio. Oznacza fakturę jako odwrotne obciążenie. |
| Aby zastosować stawkę podatku 0%, podaj tylko nazwę VAT | Tylko Oblio. Wysyła nazwę zwolnienia z VAT wyłącznie w wierszach zerowych, a nie we wszystkich. |
| Włącz klucz idempotentności | Tylko Oblio. Nie pozwala, by powtórzone żądanie utworzyło drugą fakturę do tego samego zamówienia. |
Oblio jako źródło zapasu
Połączenie powyżej wystawia faktury. Utrzymywanie stanów magazynowych easySales w zgodzie z Oblio to drugie, osobne połączenie z własnymi danymi dostępowymi.
Wejdź w Integracje → Źródła zapasu, kliknij Połącz na karcie Oblio i wpisz ten sam NIP, token i e-mail, a do tego magazyn, z którego czytany jest stan.
Kiedy Oblio odrzuca fakturę
Komunikat wraca od Oblio bez zmian i jest pokazywany na zamówieniu. Magazyn jest zdecydowanie najczęstszym powodem.
| Co mówi Oblio | Co zrobić |
|---|---|
Nu am putut descarca gestiunea pentru acest document. Produsele urmatoare nu au stoc suficient:
|
Stan w Oblio jest za niski dla wymienionych produktów. Popraw stan w Oblio albo wyłącz Użyj źródła stockowego, jeśli nie prowadzisz magazynu Oblio na bieżąco. |
Produsul "…" nu are stoc suficient.
|
To samo dla pojedynczego produktu. |
Concurrent requests timeout. Please make one request at a time.
|
Oblio dostało kilka żądań dla Twojego konta naraz. Nic nie ginie; fakturę można wystawić ponownie. |
Too Many Requests, check back later
|
Limit żądań Oblio dla Twojego konta. Zwalnia się sam. |
The access token provided has expired
|
Oblio zakończyło sesję wcześniej, niż się spodziewano. Wystaw fakturę ponownie — easySales tworzy nową sesję, gdy stara wygaśnie. |
Internal error. Please try again later. / pusta odpowiedź albo 504
|
Oblio nie odpowiedziało. Po Twojej stronie nic nie jest nie tak; spróbuj ponownie. |
You are not allowed to use this API.
|
Konto Oblio nie ma dostępu do API w swoim planie. |
The company with cif … does not exist
|
NIP na połączeniu nie jest firmą w tym koncie Oblio. |
Tipul produsului nu a fost gasit, tipul trebuie sa fie unul din: Marfa, Semifabricate, …
|
Produkt ma w Oblio typ, którego Oblio tutaj nie przyjmuje. Popraw typ produktu w Oblio. |
Introdu o serie de document valida.
|
Ten komunikat pochodzi z easySales, nie z Oblio: seria z zamówienia nie istnieje w Twoim koncie Oblio. |
Korekty, anulowania i płatności
| Czynność | Co dzieje się w Oblio |
|---|---|
| Oznaczenie zamówienia jako opłaconego | Faktura zostaje rozliczona w Oblio typem z Typu płatności albo tym wyprowadzonym z metody płatności zamówienia. Rozliczenie paragonem używa Serii paragonów. |
| Zwrot zamówienia | easySales prosi Oblio o storno do pierwotnej faktury. |
| Anulowanie faktury | Oblio anuluje dokument; numer pozostaje zużyty, tak jak powinien. |
| Usunięcie faktury | Możliwe tylko dopóki Oblio na to pozwala — w przeciwnym razie fakturę należy anulować. |