Przesyłanie zamówień z Apilo do Comarch ERP Optima
Kod wtyczki: ERB_CAI_COM_ORD_OPT_100
Użyta wersja wtyczki: VER_RTM_v156.0
Co powinieneś wiedzieć na początku ?
Wtyczka pozwala Ci na wygenerowanie zamówień od klienta lub bezpośrednio dokumentów sprzedaży w systemie docelowym (ERP) Comarch ERP Optima na bazie zamówienia w Apilo. Proces generowania dokumentów bazuje na danych widniejących na zamówieniach w systemie źródłowym (e-Commerce) Apilo.
Wtyczka umożliwia Ci stworzenie dokumentów rezerwujących stan magazynowy na czas obsługi zamówienia przez magazyn(ZK), posiada także funkcjonalność do mapowania towarów oraz kontrahentów między systemami. Opcjonalnie wtyczka może od razu generować i drukować dokumenty sprzedaży. Jest dostosowana do samodzielnej konfiguracji w oparciu o scenariusz złożony z szeregu pytań.
Scenariusz konfiguracyjny
- Punkt pierwszy jest to informacja znacząca dla klientów. Może przydać się m.in w kontakcie z działem wsparcia.
- Każdy z naszych klientów posiada własne ID. W zależności od źródła uruchomienia integracji posiada on różne przedrostki.
- Wersja integracji, którą Państwo posiadają. Więcej informacji tutaj.
2. Do ilu dni wstecz chcesz przetwarzać zamówienia?
Funkcjonalność ta pozwala wybrać do ilu dni wstecz integracja ma przetwarzać zamówienia w Apilo. Domyślnie można wybrać z zakresu od 1 do 14 dni wstecz. Aby zwiększyć ten zakres do maksymalnie 150 dni należy zakupić SI Extender - rozszerzenie funkcjonalności integracji
PAMIĘTAJ
Integracja podczas weryfikacji, które zamówienia są w zakresie przetwarzania sprawdza datę złożenia zamówienia w Apilo.
3. Czy przetwarzać zamówienia istniejące przed skonfigurowaniem integracji?
Funkcjonalność ta pozwala wybrać, czy integracja ma sprawdzać zamówienia, których data jest starsza niż data pierwszej konfiguracji integracji.
Dostępne opcje:
a) Nie, przetwarzaj tylko dokumenty dodane po pierwszym skonfigurowaniu integracji
Integracja będzie sprawdzała zamówienia maksymalnie do dnia zapisu pierwszej konfiguracji.
b) Tak, przetwarzaj dokumenty istniejące od:
Integracja będzie sprawdzała zamówienia domyślnie maksymalnie do 7 dni. Aby zwiększyść ten zakres do maksymalnie 90 dni należy zakupić SI Extender - rozszerzenie funkcjonalności integracji
UWAGA
Punkt 2. oraz punkt 3. scenariusza są ze sobą powiązane. Data z punktu 3. ogranicza maksymalny zakres działania integracji do daty tam wskazanej. Jeśli ustawienie z punktu 2. wykracza poza datę z punktu 3 to integracja nie przetworzy zamówień wstecz
4. Czy chcesz, żeby integracja uruchamiała się automatycznie?
Funkcjonalność ta daje możliwość wyboru uruchomienia integracji w zależności od potrzeb:
Dostępne opcje:
a) Tak, tylko automatycznie uruchomienie
Funkcjonalność ta pozwala również na:
- Ustawienie przerwy między uruchomieniami wtyczki.
- Wybranie zakresu godziny, w których wtyczka ma działać (od 1:00 do 23:00).
- Wybranie dni tygodnia, w których wtyczka ma działać.
b) Nie, tylko uruchom ręcznie
Funkcjonalność ta wymaga naciśnięcia przycisku “Uruchom teraz” w głównym panelu wtyczki.
PAMIĘTAJ
Ustaw wtyczkę na uruchamianie z taką częstotliwością jakiej realnie potrzebujesz do aktualizacji. W zależności od ilości posiadanych danych do przetworzenia możesz uniknąć obciążania twojego serwera, jak i systemu źródłowego oraz docelowego.
5. Połączenie z Comarch ERP Optima
Dane do logowania do Comarch ERP Optima można wpisac w integratorze, który pobieramy po zakończeniu konfiguracji scenariusza.
PAMIĘTAJ
Integrator wystarczy pobrać tylko jeden raz - przy pierwszej konfiguracji scenariusza. Nie ma potrzeby pobierania go ponownie przy dodawaniu kolejnych wtyczek lub przy wprowadzaniu zmian w scenariuszu.
6. Połączenie z Apilo
Należy wprowadzić dane wymagane do połączenia Apilo.

UWAGA
Aby pobrać wymagane dane należy utworzyć nową aplikację REST API w systemie Apilo w zakładce Administracja > Klucze API Apilo . W zakładce API Apilo możemy sprawdzić także datę ważności tokenów.
Skąd pobrać dane do połączenia z Apilo?
7. Posiadam następujące moduły Optima (wymagany jest co najmiej jeden moduł Handel i jeden Kasa/Bank)
W punkcie siódmym należy zaznaczyć posiadane moduły w Comarch ERP Optima. Poprawne podanie dostępnych modułów jest niezbędne do poprawnego połączenia do Optimy w celu realizacji procesu. Integracja do prawidłowego działania wymaga jednego modułu Handel oraz jednego modułu Kasa/Bank.
PAMIĘTAJ
Poprawne podanie dostępnych modułów jest niezbędne do poprawnego połączenia do Optimy w celu realizacji procesu. Podanie niepoprawnych modułów będzie skutkować wyświetleniem błędów informujących, że Comarch ERP Optima działa w trybie tylko do odczytu.
PAMIĘTAJ
Do pracy integracji niezbędny jest minimum jeden moduł “Handel” i jeden “Kasa/Bank”. W przypadku ich braku integracja nie zadziała.
8. Dokumenty z jakim statusem chcesz przetwarzać do Comarch ERP Optima?
Funkcjonalność ta pozwala wybrać, na których statusach zamówień integracja ma pracować.
UWAGA
Numer zamówienia w Apilo musi być podany jako numer oryginału na zamówieniu w Comarch ERP Optima z prefiksem B_
Dostępne opcje:
a) Wszystkie
Integracja sprawdzi wszystkie statusy zamówień w Apilo i przetworzy te zamówienia, których nie odnajdzie w Comarch ERP Optima (integracja sprawdza, czy zamówienie było już przetworzone na podstawie numeru oryginału dokumentu B_NumerZamówienia)
b) O statusie
Integracja sprawdzi tylko zamówienia, o statusach o określonych ID w tym punkcie. Możliwe jest podanie kilku statusów wpisując je ręcznie po przecinku. Integracja tworząc dokument w Comarch ERP Optima wpisze w numer oryginału wartość B_NumerZamówienia.
PODPOWIEDŹ
Tworzenie nowych statusów oraz informacja o ich ID znajdują się w Administracja, a następnie Statusy zamówień.

PODPOWIEDŹ
Dla zapewnienia płynnej i bezproblemowej pracy integracji zalecamy ustawienie tylko tych statusów, z których faktycznie chcemy przetwarzać zamówienia.
9. Jaki status chcesz nadać zamówieniom w Apilo, poprawnie przeniesionym do Comarch ERP Optima?
Funkcjonalność ta pozwala zdecydować, czy integracja ma zmienić status zamówienia w Apilo po utworzeniu dokumentu w Comarch ERP Optima.
Dostępne opcje:
a) Nie zmieniaj statusu
Integracja po przetworzeniu zamówienia do dokumentu końcowego nie zmieni statusu zamówienia na Apilo.
b) Ustaw status
Integracja po przetworzeniu zamówienia do dokumentu końcowego zmieni jego status na podany w konfiguracji.
Opcje zaawansowane:
c) Zgodnie z tabelą
Funkcjonalność ta pozwala ustawienie mapowania tak, aby z wybranego statusu przenosić zamówienia do danego statusu.
Status A -> Status B

10. Jaki status chcesz nadać zamówieniom w Apilo, które nie mogą być przeniesione do Comarch ERP Optima w razie błędu zapisu?
Funkcjonalność ta pozwala zdecydować, czy w przypadku wystąpienia błędu podczas procesowania przenieść takie zamówienia do oddzielnego statusu.
Dostępne opcje:
a) Nie zmieniaj statusu
Integracja w przypadku wystąpienia błędu podczas procesowania zamówienia nie zmieni jego statusu i zostawi to zamówienie w pierwotnym statusie.
b) Ustaw status
Integracja w przypadku wystąpienia błędu podczas procesowania zamówienia zmieni jego status na ten podany w konfiguracji. Status ten traktowany jest jako ogólny status błędu.
11. Jaki status chcesz nadać zamówieniom w Apilo, które nie mogą być przeniesione do Comarch ERP Optima w przypadku braku stanu?
Dostępne opcje:
a) Nie zmieniaj statusu
Integracja w przypadku wystąpienia błędu podczas procesowania zamówienia nie zmieni jego statusu i zostawi to zamówienie w pierwotnym statusie.
b) Ustaw status
Integracja w przypadku wystąpienia błędu podczas procesowania zamówienia zmieni jego status na ten podany w konfiguracji.
* Dodatkowo nie zapisuj dokumentu w Comarch ERP Optima (ustawienie możliwe do zaznaczenia tylko w przypadku wyboru powyżej zmiany statusu w przypadku braku stanu)
12. Jaki status chcesz nadać zamówieniom w Apilo, które nie mogą być przeniesione do Comarch ERP Optima w przypadku braku kartoteki towaru?
Funkcjonalność ta pozwala zdecydować, czy w przypadku braku kartoteki towaru w trakcie tworzenia dokumentu w Comarch ERP Optima przenieść zamówienie do określonego statusu.
Dostępne opcje:
a) Nie zmieniaj statusu
Integracja w przypadku braku kartoteki nie zmieni statusu zamówienia.
b) Ustaw status
Integracja w przypadku braku kartoteki podczas procesowania zamówienia zmieni jego status na ten podany w konfiguracji.
* Pomimo braku towaru przenieś zamówienie do Comarch ERP Optima.
W przypadku zaznaczenia tej opcji integracja pomimo braku towaru przeniesie zamówienie do Optima.
UWAGA
W tym przypadku zostanie stworzone puste zamówienie.
13. Zamówienia z jakich statusów w Apilo, mają być usunięte z Comarch ERP Optima?
Funkcjonalność ta pozwala usunąć zamówienia z Comarch ERP Optima z określonym statusem w Apilo.
Dostępne opcje:
a) Nie usuwaj zamówień
Domyślne działanie, integracja nie będzie usuwać zamówień.
b) Usuń zamówienia z Comarch ERP Optima znajdujące się w statusie / statusach
Integracja będzie usuwać zamówienia z Comarch ERP Optima, znajdujące się w określonych statusach.
PAMIĘTAJ
Statusy podane w tym punkcie muszą być również wpisane w punkcie 7. w statusach do procesowania
-
Dodatkowo zmień ich status w Apilo na
Opcja ta pozwala ustawić status do którego mają trafiać zamówienia po usunięciu dokumentu z Comarch ERP Optima.
14. Jakie dokumenty w Comarch ERP Optima mają być tworzone?
Funkcjonalność ta pozwala zadecydować jakie dokumenty będą tworzone w Comarch ERP Optima podczas procesowania zamówień.
Dostępne opcje:
a) Zamówienia RO
Integracja utworzy dokument Rezerwacja odbiorcy.
b) Paragony imienne lub faktury VAT na żądanie klienta (klient zaznaczył, że chce fakturę)
Integracja utworzy paragon imienny lub fakturę VAT zależnie od tego, co zaznaczył klient na zamówieniu w Apilo. Przy zaznaczonym “Klient chce fakturę” integracja utworzy fakturę VAT przy procesowaniu.
c) Paragony imienne
Integracja utworzy zawsze paragon imienny.
d) Faktury VAT
Integracja utworzy zawsze fakturę VAT niezależnie od opcji zaznaczonej w Apilo. Wymaga ona wyłączonego Sprawdzania poprawności NIP w Comarch ERP Optima, aby tworzyć faktury VAT bez NIP.
Integracja utworzy zawsze fakturę proforma.
f) Wydania zewnętrzne
Integracja utworzy zawsze Wydanie zewnętrzne.
h) Zgodnie z Tabelą
Pozwala na utworzenie mapowania tak, aby tworzyć dany rodzaj dokumentu z danego statusu np.
Status A -> Paragony imienne
Status B -> Wydania zewnętrzne
Status C -> Faktury VAT
PAMIĘTAJ
Statusy podane w tym punkcie muszą byc również wpisane w punkcie 7. w statusach do procesowania
Przy tworzeniu faktur stwórz dodatkowo dokument WZ?
Ta opcja pozwala przy tworzeniu faktury w Comarch ERP Optima dodatkowo utworzyć dokument WZ.
a) Nie
b) Tak
Przy tworzeniu paragonu zatwierdzaj go i stwórz dodatkowo dokument WZ?
Ta opcja pozwala przy tworzeniu faktury w Comarch ERP Optima dodatkowo utworzyć dokument WZ.
a) Nie
b) Tak
15. Mapowanie serii tworzonych dokumentów
Funkcjonalność ta pozwala na przypisanie serii do tworzonych dokumentów, oraz wybranie symboli dokumentu.
Jakiego pola z zamówienia chcesz użyć do mapowania?
Opcja ta pozwala wybrać na podstawie jakiego pola z zamówienia ma być utworzone mapowanie.
- ID statusu zamówienia
- ID zamówienia
Należy w tym punkcie ustawić mapowanie symboli bezpośrednio do każdego dokumentu oraz ustalić mapowanie serii na podstawie tabeli.
PODPOWIEDŹ
Serie można znaleźć w konfiguracji Optima: Konfiguracja -> Firma -> Definicje dokumentów -> Handel -> Serie dokumentów.
16. Czy wykorzystane mają być kwoty netto czy brutto z zamówień Apilo?
Funkcjonalność ta pozwala zadecydować jaki rodzaj ceny ma być wykorzystany podczas procesowania produktów z zamówienia.
UWAGA
Jeśli prowadzisz sprzedaż zarówno B2B, jak i B2C zdecydowanie zalecamy skorzystanie z opcji wykorzystaj ceny brutto. Wynika to z różnicy w specyfice zaokrąglania cen na dokumentach w przypadku przeliczania dokumentu z netto na brutto po wskazanej stawce VAT. Każdy system zaokrągla ceny na własny sposób i może to powodować różnice w wartości zamówienia
Dostępne opcje:
a) Wykorzystaj ceny netto
Integracja wykorzysta ceny netto przy przeliczaniu dokumentu w trakcie procesowania zamówienia. Zalecamy tylko w przypadku sprzedaży skupionej wyłącznie na B2B.
b) Wykorzystaj ceny brutto
Integracja wykorzysta ceny brutto przy przeliczaniu dokumentu w trakcie procesowania zamówienia. Aby uniknąć problemów z różnicami w wartości zamówienia zalecamy korzystać z tej opcji.
c) Ustaw zgodnie z mapowaniem
Można ustawić mapowanie według wartości wybranego pola w Apilo (dostępne w rozwijanej liście)
17. Dokumentom tworzonym w Comarch ERP Optima ustal kategorię
Funkcjonalność ta pozwala stworzyć mapowanie, które ustawi wskazaną kategorię na dokumencie w trakcie procesowania.
Dostępne opcje:
a) Pozostaw domyślną
b) Ustaw na
Tutaj należy wprowadzić nazwę kategorii z Optima. Można skorzystać z zielonej lupki.
UWAGA
Ustawiona kategoria musi być utworzona w Comarch ERP Optima.
18. Jak chcesz przetwarzać kontrahenta zamówienia?
Funkcjonalność ta pozwala zadecydować, jak integracja ma procesować kontrahentów z zamówienia w Apilo na dokument w Comarch ERP Optima.
Dostępne opcje:
a) Powiąż stałego, zawsze tego samego kontrahenta
Integracja zawsze przypisze tworzony dokument do jednego wybranego kontrahenta.
b) Zawsze wybieraj kontrahenta nieokreślonego
Integracja zawsze utworzy kontrahenta nieokreślonego.
Kontrahent nieokreślony przechowuje dane na temat kontrahenta tylko dla konkretnego dokumentu (po wejściu w kartotekę kontrahenta nie będą widoczne żadne dane) i nie tworzy pełnego wpisu na bazie.

c) Zawsze twórz nową kartotekę kontrahenta
Integracja zawsze utworzy nową kartotekę kontrahenta.
Kartoteka kontrahenta na stałe przechowuje dane kontrahenta i tworzy pełnoprawny wpis na bazie.

d) Powiąż kontrahenta do kartoteki zgodnie z ustawieniami mapowania
Integracja będzie produkować kontrahentów zgodnie z utworzonym mapowaniem.
Mapowanie:
Priorytet mapowania określa, który klucz mapowania będzie sprawdzany jako pierwszy (wpisujemy wartości 1, 2, 3 itd.).
Pole w Apilo
Wybieramy, które pole z zamówienia w Apilo ma być przyrównywane do wybranej wartości w Comarch ERP Optima.
- Login
- Telefon
- Email
- Nazwa odbiorcy
- Nazwa płatnika
- NIP
Pole w Comarch ERP Optima
Wybieramy do jakiej wartości z kartoteki kontrahenta integracja ma przyrównywać wybraną wartość z zamówienia w Apilo.
- Akronim
- Nazwa
- Email
- Telefon
- NIP
-
W momencie kiedy kontrahent nie zostanie odnaleziony w Comarch ERP Optima
a) Utwórz kartotekę kontrahenta stałego
Nie znalezienie kontrahenta w bazie Comarch ERP Optima spowoduje utworzenie nowej pełnej kartoteki kontrahenta.
b) Wybierz kontrahenta nieokreślonego
Nie znalezienie kontrahenta w bazie Comarch ERP Optima spowoduje wybranie kontrahenta nieokreślonego.
-
Jakie dane istniejącego kontrahenta chcesz zaktualizować w Comarch ERP Optima
a) Nie aktualizuj żadnych danych
W przypadku znalezienia kontrahenta w bazie Comarch ERP Optima integracja nie zmieni żadnych danych odnalezionego kontrahenta.
W przypadku znalezienia kontrahenta w bazie Comarch ERP Optima integracja zaktualizuje dane dostawy odnalezionego kontrahenta.
c) Aktualizuj wszystkie dane kontrahenta
W przypadku znalezienia kontrahenta w bazie Comarch ERP Optima integracja zaktualizuje wszystkie dane odnalezionego kontrahenta.
-
Czy chcesz weryfikować aktywność klienta w systemie VIES? (pole ‘Podatnik VAT czynny/Aktywny w VIES’ będzie zależne od tego czy NIP klienta jest aktywny w VIES)
Opcja ta pozwala określić czy płatność integracja ma weryfikować aktywność Kontrahenta w VIES
-
Czy adres dostawy na dokumencie w Comarch ERP Optima był nadpisywany danymi punktu odbioru z Apilo:
Opcja ta pozwala określić, aby adres dostawy na dokumencie był nadpisywany danymi z pola “Punkt odbioru” w Apilo.
-
Jakie atrybuty kontrahenta chcesz przypisać?:
Opcja ta pozwala na przepisanie atrybutów kontrahenta zgodnie z ustawionym mapowaniem.
19. Jak chcesz przetwarzać produkty?
Dostępne opcje:
a) Powiąż kartotekę produktu z Comarch ERP Optima na podstawie następującego mapowania
Integracja będzie szukać produktów na podstawie określonego mapowania.
Mapowanie:
Pole w Apilo
Wybieramy, które pole z zamówienia w Apilo ma być przyrównywane do wybranej wartości w Comarch ERP Optima.
- EAN
- SKU
- Nazwa
- Id Produktu
Comarch ERP Optima
Wybieramy do jakiej wartości z kartoteki produktu integracja ma przyrównywać wybraną wartość z zamówienia w Apilo.
- Akronim
- Nazwa
- Podstawowy kod kreskowy
- Atrybut
- Atrybut (najwyższy stan)
- Wewnętrzny identyfikator towaru
- Numer katalogowy
Podstawowe wartości mapowania możemy znaleźć w Comarch ERP Optima w tym miejscu:

b) Ustaw kartotekę w Comarch ERP Optima bez względu na kartotekę w Apilo
Integracja przypisze do dokumentu zawsze ten sam towar bez względu na kartotekę towaru w Apilo.
c) Powiąż kartotekę produkt Apilo oraz Comarch ERP Optima na podstawie następującej tabeli
Funkcjonalność ta pozwala na bezpośrednie powiązanie produktów z Apilo z produktami w Comarch ERP Optima, na podstawie mapowania.
Mapowanie:
Apilo
Wybieramy, które pole z zamówienia w Apilo ma być przyrównywane do wybranej wartości w Comarch ERP Optima.
- EAN
- SKU
- Nazwa
- Id Produktu
Comarch ERP Optima
Wybieramy do jakiej wartości z kartoteki produktu integracja ma przyrównywać wybraną wartość z zamówienia w Apilo.
- Akronim
- Nazwa
- Podstawowy kod kreskowy
- Atrybut
- Atrybut (najwyższy stan)
- Wewnętrzny identyfikator towaru
- Numer katalogowy
Wybierz pole z Apilo
Wpisujemy wartość wybranego w poprzedniej opcji pola. Przykładowo jeśli wybraliśmy Nazwa to w tym miejscu wpisujemy nazwę wybranego towaru.
Wybierz pole z Comarch ERP Optima
Wpisujemy wartość wybranego w poprzedniej opcji pola. Przykładowo jeśli wybraliśmy Nazwa to w tym miejscu wpisujemy nazwę wybranego towaru.
PAMIĘTAJ
To mapowanie działa na zasadzie Produkt - Produkt. Oznacza to, że każdy produkt w Comarch ERP Optima musi mieć przypisany produkt w Apilo. W przeciwnym wypadku utworzy się dokument bez wybranego produktu.
Gdy klucz mapowania jest pusty nie twórz zamówienia i przenieś je do statusu błędu
Zaznaczenie tej opcji spowoduje przerwanie tworzenia dokumentu i przeniesienie zamówienia do statusu błędu w przypadku gdy towar nie zostanie odnaleziony na podstawie mapowania w tabeli.
d) Powiąż kartotekę produktu na podstawie mapowania priorytetowego
Integracja będzie procesować produkty zgodnie z utworzonym mapowaniem.
Mapowanie:
Priorytet mapowania określa, który klucz mapowania będzie sprawdzany jako pierwszy (wpisujemy wartości 1, 2, 3 itd.).
Pole w Apilo
Wybieramy, które pole z zamówienia w Apilo ma być przyrównywane do wybranej wartości w Comarch ERP Optima.
- EAN
- SKU
- Nazwa
- Id Produktu
Pole w Comarch ERP Optima
Wybieramy do jakiej wartości z kartoteki produktu integracja ma przyrównywać wybraną wartość z zamówienia w Apilo.
- ID Produktu
- Akronim
- Nazwa
- EAN
-
Numer katalogowy
-
Czy chcesz przypisać inną jednostkę miary niż domyślna?
Opcja ta pozwala na przypisanie do towaru innej jednostki miary. Jednostka musi istnieć w Comarch ERP Optima, w przypadku pozostawienia tego pola pustego, integracja przypisze do każdego towaru domyślną jednostkę miary z Comarch ERP Optima. Wartość można wpisać ręcznie, lub wybrać z listy po skorzystaniu z lupy.
-
W jaki sposób obsługiwać zestawy (towary złożone)?
Opcja ta pozwala na określenie w jaki sposób obsługiwać zestawy produktów.
a) Nie obsługuj zestawów
Integracja nie będzie obsługiwać zestawów.
Integracja będzie obsługiwać zestawy i zestawy promocyjne, na dokument zostaną dodane składniki zestawu.
Integracja będzie obsługiwać zestawy i zestawy promocyjne, na dokument zostanie dodany cały zestaw, tak jak w przypadku dodawania ręcznego w Comarch ERP Optima.
-
Czy aktualizować nazwę pozycji na dokumencie?
Opcja ta pozwala na określenie czy pozycja towaru na dokumencie ma mieć nazwę zgodną z nazwą w Apilo lub Comarch ERP Optima.
a) Tak (nazwa pozycji będzie zgodna z nazwą produktu w Apilo)
Produkt będzie miał nazwę zgodną z nazwą w Apilo.
b) Nie (nazwa pozycji będzie zgodna z nazwą produktu w Comarch ERP Optima)
Produkt będzie miał nazwę zgodną z nazwą produktu w Comarch ERP Optima.
UWAGA
Atrybuty produktu muszą istnieć w Comarch ERP Optima. W przeciwnym przypadku integracja zwróci błąd i dokument nie zostanie utworzony.
20. Jak chcesz przetwarzać koszty transportu?
Funkcjonalność ta pozwala zadecydować, jak integracja ma procesować koszty dostawy na zamówieniach w Comarch ERP Optima.
Dostępne opcje:
a) Nie obsługuj
Integracja pominie koszty dostawy w trakcie procesowania zamówienia.
b) Dodaj jako usługę stałą
Integracja doda za każdym razem usługę jednorazową o nazwie podanej w polu.
c) Zgodnie z mapowaniem
Integracja doda za każdym razem wybraną usługę istniejącą w Optima.
Mapowanie:
Pole w Apilo
Należy wybrać czy mapowanie ma być po metodzie transportu czy po ID statusu zamówienia.
Wartość pola w Apilo
Należy wprowadzić wartość zgodnie z wcześniej ustawionym polem.
Akronim metody dostawy w Comarch ERP Optima
Należy wprowadzić metodę dostawy istniejącą w Optima.
Czy chcesz podzielić dostawę na odrębne stawki VAT
Funkcjonalność pozwala wybrać, czy dostawa ma mieć osobne stawki VAT.
Czy pominąć zapis dokumentu i zmienić status na status błędu kiedy nie uda się dodać metody transportu
Przy oznaczeniu “tak” integracja przeniesie zamówienie do statusu błędu.
UWAGA
Błąd nie pojawi się w dzienniku zdarzeń. Zamówienie zostanie po prostu przeniesione do statusu błędu
21. Czy chcesz ustawiać płatnika w zależności od metody płatności?
Dostępne opcje:
a) Nie obsługuj
Integracja nie przypisze odpowiedniej metody płatności do kontrahenta w Comarch ERP Optima.
b) Ustaw płatnika w zależności od metody płatności zgodnie z mapowaniem
Opcja Ustaw płatnika w zależności od metody płatności zgodnie z mapowaniem pozwala Ci nadanie symbolu kontrahenta w zależności od zmapowanej metody płatności. Skonfigurujesz mapowanie scenariusza uzupełniając pole z kolumny “Nazwa metody płatności w Apilo” i odpowiadające mu pole w kolumnie “Symbol kontrahenta w Comarch ERP Optima.”
22. Jak chcesz przetwarzać sposób płatności?
Dostępne opcje:
a) Chcę zawsze przypisywać stałą płatność
b) Zgodnie z poniższą tabelą
Mapowanie:
Pole w Apilo
- Status zamówienia
- Sposób płatności
- Sposób wysyłki
- Źródło zamówienia
Wartość pola w Apilo
Należy wprowadzić wartość pola wcześniej zmapowanego. Należy również wybrać czy dana płatność jest pobraniem.
Należy wprowadzić płatność istniejącą w Optima.
Czy chcesz przetwarzać płatności nieopłacone
Jeśli nie uda się zmapować płatności
- Nie przetwarzaj zamówienia
- Ustaw wybraną płatność
23. Wskaż symbole magazynów na których ma zostać wykonane przesunięcie
Funkcjonalność ta pozwala ustawić przesunięcie stanu magazynowego między magazynami w przypadku braku stanu na docelowym magazynie.
Dostępne opcje:
a) Nie wykonuj przesunięć
Integracja w przypadku braku stanu nie będzie wykonywać przesunięcia magazynowego.
b) Przesunięcie zgodnie z mapowaniem magazynów, zależne od wartości pól w Apilo
Mapowanie:
Pole w Apilo
- Nie obsługuj
- Zew. numer zamówienia
Jest to numer zamówienia nadany w sklepie przy składaniu zamówienia i zaciągany jest on do Apilo.
- Kod kraju (dane do faktury)
Obsługiwane są kody w formacie ISO alfa-2.
- Kod kraju (dane do dostawy)
Obsługiwane są kody w formacie ISO alfa-2.
- Symbol waluty
Pod uwagę brany jest symbol waluty w zamówieniu w Apilo.
- Identyfikator statusu zamówienia
Identyfikator statusu można znaleźć w Administracja -> Statusy zamówień.
- Źródło zamówienia
Wartość pola w Apilo
Podajemy wartość zgodną z wybranym wcześniej polem.
Skąd
Podajemy symbol źródłowego magazynu, z którego integracja ma wykonać przesunięcie.
Dokąd
Podajemy symbol docelowego magazynu, na który integracja ma wykonać przesunięcie.
24. Przypisuj rodzaje transakcji VAT na podstawie mapowania (opcjonalnie)
Funkcjonalność ta pozwala zadecydować w jaki sposób integracja ma przetwarzać zamówienia w obcej walucie.
Dostępne opcje:
a) Pozostaw domyślną
Integracja utworzy zamówienie z walutą wpisaną na zamówieniu w Apilo.
b) Stosuj walutę PLN
Integracja przeliczy zamówienie na PLN według kursu z dnia poprzedzającego wystawienie dokumentu.
Typy kursu w Comarch ERP Optima można znaleźć tutaj:

25. Jak chcesz przetwarzać stawki VAT produktów?
Funkcjonalność ta pozwala na wybranie w jaki sposób integracja ma ustawiać stawkę VAT dla poszczególnych towarów na zamówieniu.
Dostępne opcje:
a) Zgodnie z ustawieniami w Comarch ERP Optima
Integracja przy procesowaniu produktów z zamówienia ustawi stawkę VAT z Optima.
b) Zgodnie z ustawieniami w Apilo
Integracja przy procesowaniu produktów z zamówienia ustawi stawkę VAT taką, jak widnieje przy produkcie na zamówieniu w Apilo.
c) Zgodnie z mapowaniem
Integracja przy procesowaniu produktów z zamówienia ustawi stawkę VAT zgodnie z mapowaniem.
Mapowanie:
Obsługa dla
Wybieramy czy dane mapowanie ma dotyczyć towaru, czy usługi transportu.
a) Produkt
b) Transport
Wartość stawki VAT w Comarch ERP Optima
Wpisujemy wartość stawki VAT w Comarch ERP Optima, jaka ma zostać ustawiona na towarze/usłudze transportu. Wartość można wpisać ręcznie, lub wybrać z listy po skorzystaniu z lupy.
Wartość stawki VAT w Apilo
Wpisujemy wartość stawki VAT w Apilo na podstawie, której ma zostać przypisana stawka VAT w Comarch ERP Optima. Wartość można wpisać ręcznie, lub wybrać z listy po skorzystaniu z lupy.
Warunek dodatkowy
Opcja ta pozwala dodać kolejny warunek do ustawionego mapowania.
a) Nie
b) Tak
Apilo
W pierwszym polu wybieramy z listy warunek dodatkowy. Dostępne opcje to:
- Kod kraju (dane do faktury)
- Kod kraju (dane do dostawy)
- Symbol waluty
- Identyfikator statusu zamówienia
W drugim polu wpisujemy wartość wybranej w poprzednim polu opcji. Przykładowo jeśli wybraliśmy Identyfikator statusu zamówienia to w tym miejscu wpisujemy identyfikator wybranego statusu.
PODPOWIEDŹ
Aby mieć pewność, że zarówno towary jak i usługi transportu zostały zmapowane poprawnie, najlepiej jest utworzyć mapowanie najpierw dla produktu, następnie odpowiadające mu mapowanie dla usług transportu.
26. Czy chcesz przypisać rodzaj transakcji VAT do dokumentu w Comarch ERP Optima?
Funkcjonalność ta pozwala przypisać rodzaj transakcji VAT do dokumentu w Comarch ERP Optima.
Dostępne opcje:
a) Nie przypisuj
Integracja będzie pomijać przypisywanie rodzaju transakcji VAT.
b) Zgodnie z mapowaniem
Integracja będzie przypisywać rodzaj transakcji VAT do dokumentu zgodnie z ustawionym mapowaniem.
Mapowanie:
Pole w Apilo
Ta opcja pozwala wybrać dla jakiej pozycji na zamówieniu tworzymy mapowanie w danym wierszu. Dostępne opcje to:
- Kod kraju (dane do faktury)
- Kod kraju (dane do dostawy)
- Symbol waluty
-
Identyfikator statusu zamówienia
-
Wartość pola w Apilo
Wpisujemy wartość wybranego w poprzedniej opcji pola. Przykładowo jeśli wybraliśmy Identyfikator statusu zamówienia to w tym miejscu wpisujemy identyfikator wybranego statusu.
Identyfikator źródła zamówienia można wyciągnąć przy użyciu API Apilo.
27. Czy chcesz przypisać dodatkowe oznaczenia JPK VAT do dokumentu w Comarch ERP Optima?
Funkcjonalność ta pozwala przypisać oznaczenia JPK VAT do dokumentu w Comarch ERP Optima.
Dostępne opcje:
a) Nie przypisuj
Integracja będzie pomijać przypisywanie oznaczenia JPK VAT.
b) Zgodnie z mapowaniem
Integracja będzie przypisywać oznaczenia JPK VAT do dokumentu zgodnie z ustawionym mapowaniem.
Mapowanie:
Pole w Apilo
Ta opcja pozwala wybrać dla jakiej pozycji na zamówieniu tworzymy mapowanie w danym wierszu. Dostępne opcje to:
- Kod kraju (dane do faktury)
- Kod kraju (dane do dostawy)
- Symbol waluty
- Identyfikator statusu zamówienia
Wartość pola w Apilo
Wpisujemy wartość wybranego w poprzedniej opcji pola. Przykładowo jeśli wybraliśmy Identyfikator statusu zamówienia to w tym miejscu wpisujemy identyfikator wybranego statusu.
Oznaczenie JPK VAT w Comarch ERP Optima
Wybieramy z listy oznaczenie JPK VAT w Comarch ERP Optima.
Oznaczenie JPK VAT na dokumencie widoczne jest w tym miejscu:

28. Wskaż, na którym magazynie w Comarch ERP Optima mają pojawiać się zamówienia
Funkcjonalność ta pozwala wybrać na jaki magazyn w Comarch ERP Optima mają trafiać dokumenty generowane przy użyciu integracji.
Dostępne opcje:
a) Na jednym magazynie
Ta opcja pozwala określić jeden magazyn, na który trafią wszystkie tworzone dokumenty. Wartość można wpisać ręcznie, lub wybrać z listy po skorzystaniu z lupy. Symbol magazynu w Comarch ERP Optima można znaleźć tutaj:

b) Zgodnie z poniższą tabelą
Ta opcja pozwala utworzyć mapowanie, które utworzy dokumenty na określonym magazynie zależnie od statusu zamówienia. Możliwe jest podanie kilku statusów po przecinku.
Mapowanie:
Status zamówienia z Apilo
Wpisujemy identyfikator statusu zamówienia. Wartość można wpisać ręcznie, lub wybrać z listy po skorzystaniu z lupy.
PODPOWIEDŹ
Tworzenie nowych statusów oraz informacja o ich ID znajdują się w Administracja, a następnie Statusy zamówień.

PAMIĘTAJ
Statusy, które podane są w mapowaniu muszą być wpisane też w punkcie 8 scenariusza.
Magazyn z Comarch ERP Optima
Wpisujemy symbol magazynu w Comarch ERP Optima. Wartość można wpisać ręcznie, lub wybrać z listy po skorzystaniu z lupy.
Symbol magazynu w Comarch ERP Optima można znaleźć tutaj:

UWAGA
Magazyn musi istnieć w Comarch ERP Optima. W przeciwnym przypadku integracja zwróci błąd i zamówienia nie zostaną przetworzone.
Zmień status zamówienia jeżeli nie uda się stworzyć dokumentu z powodu braku stanu jednej z pozycji na wybranym magazynie
Ta opcja pozwala na zmianę statusu zamówienia w przypadku gdy na danym magazynie brakuje stanu dla jednego z towarów.
Mapowanie:
Symbol magazynu w Comarch ERP Optima
Wpisujemy symbol magazynu w Comarch ERP Optima. Wartość można wpisać ręcznie, lub wybrać z listy po skorzystaniu z lupy.
Symbol magazynu w Comarch ERP Optima można znaleźć tutaj:

UWAGA
Magazyn musi istnieć w Comarch ERP Optima. W przeciwnym przypadku integracja zwróci błąd i zamówienia nie zostaną przetworzone.
Status zamówienia w Apilo
Wpisujemy identyfikator statusu zamówienia. Wartość można wpisać ręcznie, lub wybrać z listy po skorzystaniu z lupy.
PODPOWIEDŹ
Tworzenie nowych statusów oraz informacja o ich ID znajdują się w Administracja, a następnie Statusy zamówień.

PODPOWIEDŹ
Funkcjonalność przyda się kiedy chcesz aby zamówienie w momencie braku możliwości stworzenia na magazynie X z powodu braku stanu zostało zapisane na magazynie Y. Status, który podasz wystarczy zmapować z wybranym magazynem Y w tabeli powyżej.
29. W uwagach do dokumentu w Comarch ERP Optima będą widoczne
Funkcjonalność ta pozwala wybrać jakie wartości będą przenoszone do uwag dokumentu tworzonego w Comarch ERP Optima. Kolejność uwag w tym punkcie określa kolejność wpisywania ich na dokument w Comarch ERP Optima.
Dostępne opcje:
- Własny tekst
- Imię i Nazwisko - Dane do faktury
- Imię i Nazwisko - Dane do dostawy
- Komentarz kupującego
- Identyfikator zamówienia
- Login użytkownika
- Telefon użytkownika
- Email użytkownika
- Sposób płatności
- Kurs waluty
- Sposób dostawy
- Czy klient chce fakturę
- Kwota wpłacona
Poszczególne elementy rozdziel znakiem
Ta opcja pozwala określić jakim znakiem będą oddzielane poszczególne elementy w uwagach. Jeśli w uwagach wystąpi dwa razy ten sam symbol np. “**” oznacza to, że jedna z wybranych wartości była pusta.
Po przeniesieniu uwagi będą widoczne na dokumencie w tym miejscu:

30. Jak długa ma być rezerwacja towaru?
Funkcjonalność ta pozwala wybrać okres rezerwacji towaru.
Dostępne opcje:
a) Domyślna (zgodnie z ustawieniami Comarch ERP Optima, zazwyczaj 1 dzień)
Integracja ustawi rezerwację towaru zgodnie z domyślnymi ustawieniami Comarch ERP Optima.
b) Określona liczba dni rezerwacji
Integracja ustawi rezerwację towaru zgodnie z ustawieniem wpisanym w konfiguracji.
31. Jaką datę ustawić jako datę wystawienia dokumentu?
Funkcjonalność ta pozwala wybrać z jaką datą mają być dodawane dokumenty do Comarch ERP Optima.
Dostępne opcje:
a) Data złożenia zamówienia w Apilo
Integracja ustawi na dokumencie datę złożenia zamówienia w Apilo.
b) Data utworzenia dokumentu w Comarch ERP Optima
Integracja ustawi na dokumencie datę utworzenia dokumentu w Comarch ERP Optima.
a) Data płatności w Apilo
Integracja ustawi na dokumencie datę opłacenia zamówienia w Apilo.
32. Jaka ma być rola kontrahenta na dokumencie (osoba fizyczna czy podmiot gospodarczy)?
Funkcjonalność pozwala wybrać rolę kontrahenta na dokumencie dodanym do Comarch ERP Optima.
Dostępne opcje:
a) Domyślna rola (zgodnie z ustawieniami Comarch ERP Optima, zazwyczaj "Osoba fizyczna")
Integracja ustawi rolę kontrahenta zgodnie z ustawieniami Comarch ERP Optima.
b) Osoba fizyczna (domyślnie) lub podmiot gospodarczy (dla zamówień, na których kontrahent zaznaczył opcję otrzymania faktury oraz wpisał NIP)
Integracja ustawi rolę kontrahenta jako osobę fizyczną w przypadku, gdy kontrahent nie podał numeru NIP oraz nie zaznaczył opcji otrzymania faktury, w przeciwnym przypadku rola kontrahenta zostanie ustalona jako podmiot gospodarczy.