Go to Apicbase

Create Assortment File

Creates an assortment file to be processed asynchronously.

Creates an assortment file identified by a customer_number (in this context the customer number here works more like an "assortment ID"). The file is processed asynchronously, i.e. the file is not processed right after posted.

The file argument must be the file binary content encoded in UTF-8. The file content must be an array of objects, where each object contains a product/article. The object fields are the following:

Field nameTypeConstraintsRequired
third_party_idStringAlphanumeric, 50 charsYes
shared_idStringAlphanumeric, 50 charsNo
nameStringAlphanumeric, 300 charsYes
brandStringAlphanumeric, 150 charsNo
descriptionStringAlphanumericNo
package_typeStringAlphanumeric, 50 charsNo
priceDecimalUp to 3 decimal placesNo
price_type_codeIntegerEither 0 (per package) or 1 (per unit).
Default: 0.
No, unless price_unit is set (then price_type_code=1).
price_unitStringMust be one of our supported units.No, unless price_type_code=1
orderableBooleanDefault: true.No
package_descriptionObjectPlease check below.Yes
lead_timeStringDuration in the format: [DD] [HH:[MM:]]ss[.uuuuuu]No
weightedBooleanDefault: false.No

The package_description is a nested object representing the product content. The innermost object contains the following fields:

Field nameTypeConstraintsRequired
quantityIntegerN/AYes
unit_nameStringMust be one of our supported units .Yes
gtinStringAccepted formats: EAN-13, EAN-8, UPC (12-digit) and GTIN (EAN-14).No

The other object levels contains the fields below:

Field nameTypeConstraintsRequired
quantityDecimalUp to 6 decimal places.Yes
packageObjectAn object which the data is either the innermost object (table above) or another level (this table).Yes
gtinStringAccepted formats: EAN-13, EAN-8, UPC (12-digit) and GTIN (EAN-14).No

For example, a Coca-Cola pack of 12 units of 1.5 liters each would be a 2-levels object:

{
  "gtin": "6415600501828",
  "quantity": 12,
  "package": {
    "gtin": "6415600501811",
    "quantity": 1.5,
    "unit_name": "L"
  }
}

Please consult our guide for more details about the assortment data.

Language
Credentials
OAuth2
Click Try It! to start a request and see the response here!