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).

request.xml

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