CSV

Internet Cross-docking and Dropshipping Format (ICDF) is a standard designed by IAI S.A., used for dropshipping data interchange, based on the Creative Commons license. ICDF includes an XML and CSV data format specification as well as a dedicated SOAP API for exchanging data. ICDF lets you clearly define an order structure, together with basket and product information. This enables efficient order data interchange between systems, e.g. for orders placed by a retail client in an online shop to an external B2B store (which is a typical dropshipping scenario).

By design, the ICDF data format is clear and intuitive. The main goal here is to streamline the process of communication between online retail and wholesale stores, reduce the number of errors and automate repeatable tasks. ICDF in combination with the Internet Offer Format is a comprehensive toolset for building ecommerce integrations between systems operating in the cross-docking and dropshipping models.

  • in its basic form (CSV), ICDF includes essential order data, together with products and their quantities.
  • in its comprehensive form (XML), ICDF enables handling customer notes and file attachments. The XML format also allows for transferring data of products combined into sets and collections.

WHAT CAN BE ACHIEVED WITH ICDF?

ICDF is by default supported by all shops on the IdoSell Shop platform. It enables:
 Accepting dropshipping orders by a wholesale store, with the use of AJAX endpoints, by allowing external clients to:

  • validate whether products are in stock
  • create a shopping basket with the required products, sets collections
  • place a dropshipping order by providing the end-customer billing and shipping information, delivery method and time preferences

 Improved support for the cross-docking sales model by allowing for automatic product availability at supplier validation during the order placement process, with the use of AJAX endpoints.

 Creating dedicated integration solutions based on CustomerAPI-ICDF, which on top of the functionality provided by the AJAX endpoints allows for:

  • retrieving the list of couriers supported by the supplier
  • confirming the order status
  • managing existing end-customer billing and shipping data

ICDF XML STRUCTURE

The XML notation of ICDF is recommended for automatic data exchange.

The main, required node of the structure is products. All child elements of this node represent the shopping cart contents. The products node can be part of any other element which forms an envelope. In the example, the envelope is formed by the order element.

order - product set envelope (optional)
products - main node, contains the collection of products
products.product - product element, parameters:
products.product@code - product code (in the ecommerce system)
products.product@codeType - product code type: internal, producer, external
products.product@quantity - information about the quantity of a given product
products.product.comment - product comments, created by the customer (optional)
products.product.attachments - main node containing product attachments, added by the customer (optional)
products.product.attachments.attachment - attachment element
products.product.attachments.attachment.file - Base64 encoded file attachment
products.product.attachments.attachment.name - attachment name
products.product.products - internal collection of products, used e.g. when the main product element is a set or a collection of products
products.product.products.product - internal product element, parameters:
products.product.products.product@code -product code (in the ecommerce system)
products.product.products.product@codeType - product code type: internal, producer, external

ICDF ENABLED EXCHANGING SHOPPING CART CONTENT DATA

ICDF shopping cart data can be exchanged as CSV, or as the more structured XML (recommended). CSV can be used when the data does not contain information about attachments and when the cart does not contain products sets / collections.

1. Example ICDF XML structure

request.xml. 

2. Example ICDF CSV structure (simple mode)

SKU;quantity;comments

where:

  • SKU - product code in the system (internal)
  • quantity - numeric product quantity
  • comments - customer remarks

example-ICDF.csv

3. Example ICDF CSV structure (extended mode)

SKU;quantity;comments;product_code;external_code;display_code;size;name

where:

  • SKU - product code in the system (internal)
  • quantity - numeric product quantity
  • comments - customer remarks
  • product_code - manufacturer code, e.g. EAN-13
  • external_code - external system code
  • display_code - code displayed on the product details page
  • size - size name (deprecated)
  • name - product name (deprecated)

example-ICDF-ext.csv

This page uses cookie files to provide its services in accordance to Cookies Usage Policy. You can determine conditions of storing or access to cookie files in your web browser.
Close
pixel