Aktualizacja 6.3.4 / 6.3.5

Poniżej prezentujemy listę nowości, jakie pojawiły się w systemie. Zmiany wprowadzono w module API oraz integracjach – DHL, PayU oraz InPost Pay. Dodano rozwiązanie związane z unijną dyrektywą GARAN, a także integrację z czeskim i słowackim odpowiednikiem GUS – ARES / RUZ.

---

Multichannel

Allegro

Dodano nowy przycisk do tworzenia aukcji Allegro

Czego dotyczy zmiana?

Do wystawiania aukcji poprzez Allegro dodano nowy przycisk: pobierz kategorię.

Jak to działa?

W Multichannel → Allegro – aukcje podczas tworzenia aukcji widoczny jest przycisk. Po wpisaniu EAN, i kliknięciu w przycisk – poprawnie uzupełni nam kategorie dla aukcji.

Allegro – filtrowanie aukcji po atrybutach produktu

Czego dotyczy zmiana?

Dodano nowy filtr w widoku ofert Allegro – Atrybuty.

Jak to działa?

Pozwala filtrować oferty produktów po atrybucie z panelu AtomStore. Filtr znajdziesz przechodząc do: Multichannel → Allegro – aukcje. 

---

Marketing i promocje

Akcje promocyjne

Dodano wczytywanie produktów z pliku CSV do akcji promocyjnych

Czego dotyczy zmiana?

Dodano możliwość zaczytywania produktów z pliku CSV w akcjach promocyjnych.

Jak to działa?

Plik ma być w formacie: kod_produktu; cena. Na początku należy wczytać obecny zakres produktów z tabelki powyżej, zaimportowac plik i kliknąć: Wczytaj.

---

CMS

Blog

Dodano spis treści w artykułach bloga

Czego dotyczy zmiana?

Dodano Spis treści dla artykułów blogowych

Jak to działa?

Spis treści można właczyć w danym artykule blogu (setting pod polem treści bloga):

Spis treści generowany jest z nagłówków H2 oraz H3 zachowując ich hierarchie. Aby wygenerować poprawnie spis treści należy zastosować formatowanie nagłówków H2 jako rozdział oraz h3 jako podrozdziały. Po kliknięciu w dany spis, klient zostanie przekierowany do kotwicy, danego nagłówka na blogu. Do użytku jest również tłumaczenie z etykietą:

Przykład spisu treści:

---

Ustawienia

Konfiguracja sklepu

Rozbudowano ustawienia związane z dyrektywą UE GARAN

Czego dotyczy zmiana?

Dodano ustawienia związane z dyrektywą UE GARAN.

Jak to działa?

Nowe ustawienia znajdziesz po przejściu do: Ustawienia → Konfiguracja sklepu → Katalog i magazyn → Gwarancja trwałości (GARAN). Są nimi:

1. Gwarancja trwałości producenta – atrybut – podaj czas dodatkowej gwarancji i to ma priorytet nad ustawieniem w produkcie; 

I później wyświetlane jest w dwóch miejscach:

oraz po kliknięciu w powyższe:

2. Marka / znak towarowy – podaj markę, jak nie ma w produkcie tego atrybutu to pobierze z producenta;

3. Model produktu – jak nie będzie w produkcie to nie wstawi nic;

wyświetlane w tej dużej etykiecie

4. Wyświetlaj etykietę GARAN pod nazwą produktu

• Tak – wyświetlona będzie etykieta pod nazwą i nie trzeba pracy webmastera;
• Nie – wyświetlana będzie pod producentem.

Rozbudowano moduł reklamacji o nowe funkcjonalności

Czego dotyczy zmiana?

Dodano nową funkcjonalność dla modułu reklamacji.

Jak to działa?

Dla konfiguracji rodzaju reklamacji dodano nowe ustawienia (/admin/complaint_kinds) – Adres odbioru oraz Adres doręczenia:

Pozwalają one wyświetlać/nie wyświetlać/zgodnie z statusem pola do wypełnienia adresu doręczania i odbioru. Także dodano to dla pół własnych (/admin/complaint_fields):

Dostępne w edycji danego pola własnego.

Rozbudowano przekierowania dla multistore

Czego dotyczy zmiana?

Dodano nowe ustawienie: Przekieruj klienta do pierwszej (głównej) domeny bieżącego multistore’a.

Jak to działa?

Ustawienie znajduje się po przejściu do: Ustawienia → Konfiguracja sklepu → Sprzedaż i ceny → Multistore.

pozwala przekierować stronę tak aby multistore mógł mieć przekierownia np. www.test.pl → test.pl

Zmodyfikowano ustawienie kwoty do zwrotu w kontekście zmian statusów zamówienia

Czego dotyczy zmiana?

Zmodyfikowano ustawienie: Kwota do zwrotu – zmiana statusu zamówienia.

Jak to działa?

Po wprowadzeniu kwoty w polu własnym „Kwota do zwrotu” w szczegółach zamówienia przez handlowca dedykowany skrypt powinien automatycznie zmienić status zamówienia na „PK – wymaga zwrotu”. 

Dodano nową opcję w wymuszaniu wariantu testów A/B

Czego dotyczy zmiana?

Dodano ustawienie: Sekret wymuszania wariantu testu A/B.

Jak to działa?

Ustawienie znajdziesz po przejściu do: Ustawienia → Konfiguracja sklepu → Marketing → Testy A/B. 

Token używany w parametrach URL (ab_test_id, ab_variant, ab_secret) do wymuszenia wariantu A/B na potrzeby QA i testów analityki GA4. Puste = funkcja wyłączona.

Przykładowy url do weryfikacji testu AB https://domenasklepu.pl/?ab_test_id=4&ab_variant=A&ab_secret=test123

• ab_test_id – id testu AB;
• ab_varaint – wariant który chcesz wymusić do weryfikacji;
• ab_secret – dane z ustawienia: Sekret wymuszania wariantu testu A/B, potrzebne do wymuszenia testu.

Wprowadzono ograniczenie możliwości zwrotów przy zakupach produktów z akcji promocyjnych

Czego dotyczy zmiana?

Dodano ograniczenie możliwości zwrotów przy zakupach produktów z akcji promocyjnych.

Jak to działa?

W Ustawienia → Konfiguracja sklepu → B2B → Reklamacje dodano ustawienie: Typy zgłoszeń odpowiadających zwrotom. 

Zabezpieczenie, jeżeli w zamówieniu był gratis, to zwracając ostatni produkt z tego zamówienia należy zwrócić też gratis

---

Integracje

DHL

Zmodyfikowano integrację z DHL w kontekście znaków kod pocztowego

Czego dotyczy zmiana?

Dodano wycinanie znaków z kodu pocztowego w integracji z DHL.

Jak to działa?

Zmiana działa w taki sposób, że np. w Czechach podano kod 10 000 i on nie jest respektowany w DHL, więc kod będzie zamieniany na 10000.

 "receiver": {
        "country": "CZ",
        "name": "Test Test",
        "postalCode": "10000",

InPost von Halsky

Rozbudowano InPost von Halsky o nowe funkcje

Czego dotyczy zmiana?

Dodano nowe funkcje dla InPost Von Halsky.

Jak to działa?

Nowe funkcje to:

1. Nowy filtr w Katalog → Produkty  – Inpost von Halsky

działa na podobnej zasadzie co filtr Allegro.

Natomiast podczas grupowego wystawiania ofert:

2. Zaznaczanie tylko wariantów niewystawionych

3. Oznaczenie produktów/wariantów już wystawionych.

Allegro

Dodano nowe ustawienia dot. sygnatury oferty w Allegro

Czego dotyczy zmiana?

Dodano nowe ustawienia: Sygnatura oferty (external.id) – źródło wartości oraz Sygnatura oferty – atrybut (gdy źródłem jest “Wybrany atrybut”).

Jak to działa?

Ustawienia znajdziesz po przejściu do: Ustawienia → Konfiguracja sklepu → Multichannel → Allegro.

Wysyłają one parametr: Sygnatura dla oferty Allegro.

W tym celu w ustawieniu należy wybrać kod produktu albo id produktu lub atrybut, z kolei należy w ustawieniu: Sygnatura oferty – atrybut (gdy źródłem jest “Wybrany atrybut”), wybrać odpowiedni atrybut.

Dodano ustawienie User Agent w Allegro REST API

Czego dotyczy zmiana?

W integracji z Allegro dodano nowe ustawienie: Allegro REST API – User Agent.

Jak to działa?

Znajdziesz je po przejściu do: Ustawienia → Konfiguracja sklepu → Multichannel → Allegro → Allegro Rest API.

Umożliwia to dostosowanie nazwy sklepu w nagłówku User-Agent wysyłanym do Allegro API. Dozwolone są tylko znaki a-z, 0-9, myślnik i podkreślenie. Aplikacja będzie się identyfikować jako AtomStore-[wpisana_nazwa], np. wpisując sklep_wedkarski wyśle AtomStore-sklep_wedkarski i taka musi być nazwa aplikacji w Allegro. Jeśli pole jest puste, nazwa zostanie pobrana z ustawienia Nazwa sklepu z usuniętymi spacjami i polskimi znakami diakrytycznymi, np. Sklep wędkarski -> AtomStore-Sklepwdkarski.

PayU

Dodano nowe ustawienie portfela Google Pay w integracji z PayU

Czego dotyczy zmiana?

Dodano nowe ustawienie: Google Pay – identyfikator sprzewacy Google Pay & Wallet Console.

Jak to działa?

Ustawienie znajdziesz po przejściu do: Ustawienia → Konfiguracja sklepu → Płatności online → PayU.pl.

Jeżeli to ustawienie jest uzupełnione, to już w sklepie będzie widoczny taki przycisk:

Przy braku uzupełnienia, będzie to zwykły napis: Zapłać. Jednocześnie usunięte zostało ustawienie: Google Pay – prezentuj przycisk na stronie sklepu.

ARES / FINANCNASPRAVA

Dodano integrację z ARES i FINANCNASPRAVA

Czego dotyczy zmiana?

Dodano ustawienia do modułu CrossBorder: 

• Adres URL API ARES – Publiczne REST API czeskiego rejestru ARES (ares.gov.cz). Dodaj https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/;
• Data początkowa wyszukiwania (RÚZ)- Parametr “zmenene-od” dla API registeruz.sk. Format: YYYY-MM-DD. Domyślnie może być to – 2000-01-01;
• Adres URL API RUZ– Publiczne REST API słowackiego rejestru RUZ. Dodaj:https://www.registeruz.sk/cruz-public/api/uctovne-jednotky.

Jak to działa?

Ustawienia znajdziesz po przejściu do: Ustawienia → Konfiguracja sklepu → Sprzedaż i ceny → Cross Border. 

Są odpowiedzialne za odpytywanie odpowiednich baz analogicznych do GUS, dla Czech ARES, dla Słowacki RUZ. Po uzupełnieniu ustawień zgodnie z tooltip, po wpisaniu NIP w formularzu adresowym automatycznie zostaną pobrane dane firmy.  Istotny jest wybrany kraj w formularzu adresowym, bo to na jego podstawie odpytywane jest odpowiednie API. 

InPost Pay

Dodano opcje Google Analytics 4 do integracji z InPost Pay

Czego dotyczy zmiana?

Dodano ustawienia w integracji z InPost Pay: Google Analytics 4 – Measurement Protocol – ID oraz  Google Analytics 4 – Measurement Protocol – API SECRET.

Jak to działa?

Ustawienia znajdziesz po przejściu do: Ustawienia → Konfiguracja sklepu → Płatności online → InPost Pay.

Dane uzupełnij jeżeli chcesz dla integracji z Inpost Pay wykorzystywać inne konto do raportowania zakupów aniżeli konto w integracji GA4.

wFirma.pl

Dodano nowe ustawienie w integracji z wFirma.pl

Czego dotyczy zmiana?

Dodano nowe ustawienie w module wFirma: Domyślna rola dodatkowego odbiorcy (Podmiot 3 KSeF)

Jak to działa?

Znajdziesz je po przejściu do: Ustawienia → Konfiguracja sklepu → API i integracje FK/ERP → wFirma.pl. Ustawienie ma opcje jak w KSEF:

• Faktor – w przypadku, gdy na fakturze występują dane faktora,
• Odbiorca – w przypadku, gdy na fakturze występują dane jednostek wewnętrznych,
  oddziałów, wyodrębnionych w ramach nabywcy, które same nie stanowią nabywcy
  w rozumieniu ustawy,
• Podmiot pierwotny – w przypadku, gdy na fakturze występują dane podmiotu będącego
  w stosunku do podatnika podmiotem przejętym lub przekształconym, który dokonywał
  dostawy lub świadczył usługę (z wyłączeniem przypadków, o których mowa w art. 106j ust. 2
  pkt 3 ustawy, gdy dane te wykazywane są w części Podmiot1K),
• Dodatkowy nabywca – w przypadku, gdy na fakturze występują dane kolejnych (innych niż
  wymieniony w części Podmiot2) nabywców,
• Wystawca faktury – w przypadku, gdy na fakturze występują dane podmiotu
  wystawiającego fakturę w imieniu podatnika (nie dotyczy przypadku, gdy wystawcą faktury
  jest nabywca),
• Dokonujący płatności – w przypadku, gdy na fakturze występują dane podmiotu
  regulującego zobowiązanie w miejsce nabywcy,
• Jednostka samorządu terytorialnego – wystawca,
• Jednostka samorządu terytorialnego – odbiorca,
• Członek grupy VAT – wystawca,
• Członek grupy VAT – odbiorca,
• Pracownik.

Zależnie od wyboru w ustawieniu, przy przesyłaniu danych odbiorcy przesyłany jest odpowiedni znacznik role. Przykładowy przesył danych odbiorcy do API wFirma:

W ustawieniu: Domyślna rola dodatkowego odbiorcy (Podmiot 3 KSeF) była wybrana opcja: Jednostka samorządu terytorialnego – wystawca. Do tego by dodawać dane dostawcy do zamówienia, potrzebne jest włączenie ustawienia -> Zezwalaj na wprowadzenie adresu odbiorcy (Proces zakupowy i konta klientów).

Dodano pole opisu w przekazywaniu faktur do wFirma

Czego dotyczy zmiana?

Dodano pole: Opis, przy generowaniu dokumentów do wFirma. 

Jak to działa?

Przy generowaniu faktur i dokumentów do wFirma domyślnie jeżeli to pole jest puste, to przekazywana jest informacja: Zamówienie nr x, gdzie x – to numer zamówienia. 

---

API

POST

Dodano nowy endpoint w API

Czego dotyczy zmiana?

Dodano nowy endpoint POST /api/attribute_values/bulk

Jak to działa?

1. Dodanie opisów do istniejących wartości atrybutu 35 (aktualizacja po ID wartości):

[
{
“id”: 30,
“description”: {
“pol”: “Opis wartości po polsku”,
“eng”: “Value description in English”
}
},
{
“id”: 31,
“description”: {
“pol”: “Opis drugiej wartości”
}
}
]

Aktualizacja tłumaczeń i opisu jednocześnie, dodanie nowej wartości i usunięcie:
[
{
“id”: 30,
“value”: { “pol”: “Czerwony”, “eng”: “Red” },
“description”: { “pol”: “Opis”, “eng”: “Description” }
},
{
“attribute_id”: 35,
“value”: { “pol”: “Zielony”, “eng”: “Green” },
“description”: { “pol”: “Opis nowej wartości” }
},
{ “id”: 32, “delete”: 1 }
]

2. Aktualizacja: identyfikacja po id wartości. Wysyłane są tylko pola, które chcesz zmienić.
3. Nowa wartość: bez id, z obowiązkowym attribute_id. Wartość w języku domyślnym jest wymagana. attribute_id nie da się zmienić przy aktualizacji.

[
{
“id”: 30,
“value”: { “pol”: “Czerwony”, “eng”: “Red” },
“description”: { “pol”: “Opis”, “eng”: “Description” }
},
{
“attribute_id”: 35,
“value”: { “pol”: “Zielony”, “eng”: “Green” },
“description”: { “pol”: “Opis nowej wartości” }
},
{ “id”: 32, “delete”: 1 }
]

4. Aktualizacja: identyfikacja po id wartości. Wysyłane są tylko pola, które chcesz zmienić.
5. Nowa wartość: bez id, z obowiązkowym attribute_id. Wartość w języku domyślnym jest wymagana. attribute_id nie da się zmienić przy aktualizacji.
6. Usunięcie: id plus “delete”: 1.
7. Klucze w value i description: kody języków sklepu (Language.locale).

SOAP API

Dodano nowy parametr do metody GetPrices w SOAP API

Czego dotyczy zmiana?

Do metody GetPrices w SOAP API dodano parametr: price_list_id.

Jak to działa?

Pozwala on pobrać cenę ze wskazanego ID cennika dodatkowego (parametr opcjonalny).

Dodano obsługę nowych znaczników w SOAP API

Czego dotyczy zmiana?

Dotyczy SOAP API dla kontrahentów (user_api) – SetOrders. Dodano obsługę znaczników:

• <shippingMethodId>…</shippingMethodId> – podaj ID formy dostawy;
  
• <shippingMethod>…</shippingMethod> – podaj nazwę formy dostawy.

Jak to działa?

Znaczniki pozwalają na wybranie metody dostawy dla zamówienia przez klienta oraz obliczenie kosztu dostawy. W poprawnej odpowiedzi dostaniesz ID złożonego zamówienia. Jeśli w panelu dana forma dostawy jest niedostępna, zwrócona zostanie odpowiedź: User API: niedostępna forma dostawy

Dodano funkcjonalność do SOAP API związaną z powiadomieniem o aktywacji konta

Czego dotyczy zmiana?

Dodano nową funkcjonalność do SOAP API – SetUsers: Zapis klientów (SetUsers) – wysyłaj powiadomienie o aktywacji konta

Jak to działa?

Ustawienie znajduje się po przejściu do: Ustawienia → Konfiguracja sklepu → API i integracje FK/ERP → ATOM SOAP API → Zapis i odczyt klientów (SetUsers, GetUsers).

Możliwe są trzy opcje do wyboru

• tak – po zmianie z nieaktywnego na aktywne – w tej sytuacji zmiana parametru <active>1</active> podczas edycji klienta po API spowoduje wysłanie maila o aktywacji konta;
• tak – przy dodawaniu i aktywacji konta – gdy tworzysz konto klienta i ustawisz <active>1</active> – spowoduje wysłanie maila o aktywacji konta. Tyczy się także edycji już istniejącego klienta;
• nie – utworzenie/edycja konta klienta nie spowoduje wysłania maila.