CSV stary
Internet Cross-docking and Dropshipping Format (ICDF) jest zaprojektowanym przez IAI S.A. protokołem wymiany danych, udostępnianym na licencji Creative Commons. ICDF to format XML i CSV a także dedykowane SOAP API - nazwaliśmy je CustomerAPI, do wymiany danych. Dzięki ICDF opiszesz strukturę zamówienia, przekazując dane o produktach w koszyku. To otwiera Ci możliwości przenoszenia zamówień pomiędzy systemami np. od zamówienia złożonego przez klienta detalicznego, w programie sklepu internetowego, do zamówienia B2B w hurtowni internetowej - realizując tym samym sprzedaż w modelu dropshippingu.
ICDF to format, który z założenia charakteryzuje się uporządkowaną, uniwersalną i intuicyjną strukturą. Jego głównym założeniem jest skomunikowanie hurtowni i sklepów internetowych tak, aby minimalizować ilość błędów przy przenoszeniu zamówień i automatyzować powtarzalne czynności. ICDF w wykorzystaniu razem z IOF - formatem opisu oferty produktów pomiędzy hurtowniami i sklepami internetowymi, są gotowymi narzędziami by zbudować integracje systemów działających w modelu cross-docking i dropshipping.
- Format ICDF w swojej najprostszej postaci (CSV) zawiera podstawowe informacje o produktach z systemu sklepowego i ich składzie ilościowym.
- W bardziej rozbudowanej formie (XML) obsługuje komentarze klienta do produktów i pliki załączników. Format XML umożliwia przeniesienie informacji o towarach ze złożoną strukturą np. zestawach, które mogą składać się z towarów składowych w różnych rozmiarach.
CO MOŻNA OSIĄGNĄĆ WYKORZYSTUJĄC ICDF?
Protokół wymiany danych ICDF obsługiwany jest w każdym sklepie IAI-Shop.com i umożliwia:
Wykorzystując CustomerAPI przygotować zaawansowane rozwiązanie dla hurtowni przystosowując je do przyjmowania zamówień dropshippingowych ze współpracujących sklepów, oferując:
- sprawdzenie czy towary, które sklep chce zamówić są w wystarczających ilościach u dostawcy (w hurtowni)
- wgranie towarów do koszyka hurtowni
- pozwala integrującym się sklepom pobrać listę kurierów, których oferuje hurtownia
- odpytywać o status zamówień sklepu w hurtowni
- modyfikować i zarządzać danymi adresowymi tych klientów, których sklep przekazał do hurtowni
Z wykorzystaniem bramek AJAX usprawnić współpracę w modelu cross-docking pomiędzy sklepem i dostawcą, poprzez wykorzystanie automatycznej weryfikacji dostępności towarów, w magazynach dostawcy, w trackie składania zamówienia w sklepie internetowym.
STRUKTURA FORMATU ICDF W XML
Postać ICDF w notacji XML jest bardziej rozbudowana, ale przy tym rekomendowana przy wymianie danych pomiędzy systemami zautomatyzowanymi.
Głównym i obowiązkowym elementem struktury jest węzeł products. Wszelki zawarte w nim elementy tworzą zawartość koszyka. Węzeł products może być zawarty w dowolny elemencie tworzącym tzw. „kopertę”. W przykładowej strukturze tworzy ją element order.
order - tzw. „koperta” głównej sekcji zbioru produktów, nieobowiązkowa
products - węzeł główny zawierająca informację o paczce produktów
products.product - sekcja zawierająca informację o elemencie paczki produktów, zawiera argumenty:
products.product@code - kod produktu w systemie sklepowym
products.product@codeType - określa rodzaj kodu produktu: internal, producer, external
products.product@quantity - zawiera informację o ilości danego produktu
products.product.comment - sekcja zawierająca dodawany przez klienta do produktu komentarz, element opcjonalny
products.product.attachments - węzeł główny zawierająca dodawane przez klienta do produktu załączniki, element opcjonalny
products.product.attachments.attachment - sekcja wewnętrzna zawierająca załączniki
products.product.attachments.attachment.file - załącznik, którego zawartość kodowana jest w Base64
products.product.attachments.attachment.name - nazwa załącznika
products.product.products - sekcja wewnętrzna dodawana do elementu product w przypadku, gdy jest on typem złożonym np. zestawem. Może zawierać elementy product, składowe produktu złożonego.
products.product.products.product - element produktu złożonego, zawiera argumenty:
products.product.products.product@code - kod produktu w systemie sklepowym
products.product.products.product@codeType - określa rodzaj kodu produktu: internal, producer, external
ICDF UMOŻLIWIAJĄCE WGRANIE KOSZYKA
Paczkę danych do "wgrania" koszyka w ICDF można przekazać w prostym formacie CSV lub bardziej rozbudowanym XML (rekomendowany). Format CSV wykorzystywany jest w przypadku, gdy dane nie muszą zawierać informacji w postaci załączników dołączanych przez klienta oraz gdy towary w koszyku nie mają złożonej struktury (nie są zestawami / kolekcjami).
2. Postać struktury ICDF w formacie CSV (tryb prosty)
kod_SKU;ilość;uwagi
gdzie:
- kod_SKU - kod produktu w systemie sklepowym: kod IAI
- ilość - ilość towaru określonego przez kod
- uwagi - uwagi do produktu
Przykłady struktury ICDF w formacie CSV (tryb prosty)
95101-93;6,00;"Produkt z komentarzem"
97101-35;4;;
Przykładowy plik CSV ICDF: example-ICDF.csv
3. Postać struktury ICDF w formacie CSV (tryb rozszerzony)
kod_SKU;ilość;uwagi;kod_KP;kod_KZS;kod_WKP;rozmiar;nazwa_towaru
gdzie:
- kod_SKU - kod produktu w systemie sklepowym: kod IAI
- ilość - ilość towaru określonego przez kod
- uwagi - uwagi do produktu
- kod_KP - kod producenta np. w formacie EAN-13
- kod_KZS - kod zewnętrznego systemu
- kod_WKP - kod wyświetlany na karcie produktu np. kod_IAI
- rozmiar - nazwa rozmiaru (aktualnie nieobsługiwana)
- nazwa_towaru - nazwa towaru (aktualnie nieobsługiwana)
Przykłady struktury ICDF w formacie CSV (tryb rozszerzony)
;4,00;;vmp-197230039-34;;;;
;15,00;"Produkt z komentarzem";pz15-producer-code;;;;
95101-93;6,00;"Produkt z komentarzem";;;;;
Przykładowy plik CSV ICDF: example-ICDF-ext.csv