Dokumentacja Internet Cross-docking and Dropshipping Format (ICDF)

Zapoznaj się z podstawowymi założeniami oraz pełną dokumentacją standardu Internet Cross-docking and Dropshipping Format (ICDF) umożliwiającym importowanie koszyka do systemu sklepu i realizacje zamówień dropshippingowych

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

1. Przykład struktury ICDF w formacie XML

ICDF_structure

Powyższy przykład możesz pobrać stąd: request.xml.

Szczegóły techniczne dotyczące bramki ajax/basket-import umożliwiającą wgranie zawartości koszyka klienta z wykorzystaniem formatu ICDF, znajdziesz w dokumentacji bramki


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

ICDF w dropshippingu

Oprócz podstawowego zastosowania formatu ICDF umożliwiającego wgranie towarów do koszyka sklepu internetowego, format wykorzystywany jest do obsługi zamówień dropshippingowych. Jego zastosowanie znajdziesz w: