Wsparcie dla starego modułu dokumentów będzie do 30.11.2025. Stary moduł zostanie całkowicie usunięty 31.01.2026. Zachęcamy do zapoznania się już teraz z możliwościami, które daje nowy moduł dokumentów sprzedażowych w tym artykule ⇨
Kiedy współpracujesz z zewnętrznymi klientami lub hurtownią, konieczne może być udostępnienie oferty Twojego sklepu w formie pliku XML. Wszelkie niezbędne informacje znajdziesz poniżej.
Jak udostępnić plik XML z ofertą sklepu Sellingo?
Aby udostępnić plik XML musisz najpierw włączyć
moduł B2B w sklepie. W tym celu skontaktuj się z nami. Możesz to zrobić przez
formularz lub telefonicznie pod numerem
123-450-773.
Kiedy już masz moduł B2B włączony, otrzymujesz dwa ogólne pliki XML.
Duży plik służący do importu produktów znajdziesz pod adresem http://DOMENA TWOJEGO SKLEPU/api/xml_big
Jeśli sklep ma zainstalowany certyfikat ssl, adres będzie wyglądać:
https://DOMENA TWOJEGO SKLEPU/api/xml_big
Mały plik służący do aktualizacji znajdziesz pod adresem http://DOMENA TWOJEGO SKLEPU/api/xml_small
Jeśli sklep ma zainstalowany certyfikat ssl, adres będzie wyglądać:
https://DOMENA TWOJEGO SKLEPU/api/xml_small
Poza ogólnymi plikami XML możesz też udostępnić wybranym klientom spersonalizowane pliki XML z ustalonymi rabatami.
Jak udostępnić spersonalizowane pliki?
1. Przejdź do Klienci ⇨ Lista.
2. Edytuj klienta, któremu chcesz udostępnić plik XML.
4. Zaznacz opcję Dostęp do spersonalizowanego XML.
5. Zapisz zmiany. Możesz też najpierw ustawić rabaty dla klienta.
Po zapisaniu zmian wyświetlą się linki do plików XML. Klient po zalogowaniu do swojego konta zobaczy linki w zakładce Moje dane.
Kiedy są aktualizowane pliki XML?
Duży plik XML służy do towarowania sklepów. Jego wygenerowanie trwa dłużej, dlatego jest on odświeżany raz na 12 godzin. Mały plik XML służy do sprawdzania stanów magazynowych. Jego wygenerowanie zajmuje mniej czasu, dlatego jest on odświeżany co 10 minut.
Opis struktury pliku XML
products - główny znacznik zawierający produkty
product - produkt
*id - id produktu
*date_add - data dodania
name - nazwa produktu
*language - język
manufacturer - producent przypisany do produktu
presale_date - data przedsprzedaży
category - główna kategoria produktu
descriptions - opis produktu
description - opis produktu, produkt może mieć kilka opisów np. krótki opis, długi opis
vat - stawka VAT przypisana do produktu
attributes - atrybuty produktu
attribute
name - nazwa atrybuty
*lang - język
value - wartość atrybutu
*lang - język
options - opcje
option -
*id - id opcji
name - nazwa opcji
*lang - język
value - wartość opcji
*lang - język
price_modify - informacja o edycji ceny głównej produktu
variants - warianty
variant
*id - id variantu
catalog - numer katalogowy przypisany do wariantu
presale_date - data przedsprzedaży
ean - numer EAN przypisany do wariantu
symbol - symbol przypisany do wariantu
weight - waga wariantu
price - cena danego wariantu
*currency - waluta
price_for_you - cena z uwzględnioną zniżką dla klienta, wraz z ceną promocyjną -
*currency - waluta
quantity - stan magazynowy
properties - wartości wariantu
name - nazwa
*lang - język
value - wartość
*lang - język
catalog - numer katalogowy
ean - numer EAN
symbol - symbol
weight - waga
price - cena
*currency - waluta
price_for_you - cena z uwzględnioną zniżką dla klienta, oraz cenę promocyjną
*currency zawiera walutę
images - zdjęcia
image - zdjęcie, wartość może zawierać atrybut variants z informacją o przypisany wariancie
Za pomocą * oznaczone są atrybuty.
Obsługa zestawów w pliku XML B2B
W celu ulepszenia naszego systemu, wprowadziliśmy nowe elementy w
pliku XML B2B, które umożliwiają efektywne zarządzanie zestawami
produktów.
W pliku XML dla produktów, które są zestawami, wprowadziliśmy dodatkowy znacznik
. Ten znacznik zawiera informację o zestawach.
Struktura pliku XML dla zestawów:
Nowy element :
W
znajdują się informacje o składnikach zestawu, w tym:
- product_id - ID produktu w zestawie
- price - Cena produktu w zestawie
- quantity - Ilość sztuk danego produktu w zestawie
W elemencie product dodaliśmy atrybut as_set, który przyjmuje wartość 1, aby oznaczyć, że dany produkt jest zestawem.
Te zmiany pozwalają na bardziej szczegółowe zarządzanie zestawami produktów w systemie B2B, ułatwiając integrację.
