Why?

This attribute is optional. Please note, that shipping is required for all products sold on French market. The shipping attribute is used to specify the cost of shipping of a product.

Format

  • Type: Nested

  • Encoding: UTF-8

  • Repeatable: yes, up to 100

  • Subattributes:

    • country (required) - String, ISO 3166 alpha-2 code

    • service (optional) - String, 50 characters

    • region (optional) - String, 50 characters

    • price (required) - PriceField, Number, currency (ISO 4217) and decimal point

    • min_handling_time (optional) - Integer

    • max_handling_time (optional) - Integer

    • min_transit_time (optional) - Integer

    • max_transit_time (optional) - Integer

Accepted values

  • Submit complete shipping information

  • Overestimate if you can't provide accurate shipping cost

  • Submit shipping cost including VAT, use local currency

  • If you provide information about handling or transit time then min_handling_time should be lesser or equal to max_handling_time and min_transit_time should be lesser or equal to max_transit_time

XML examples

  • Example 1

<shipping>
<price>20 SEK</price>
<country>SE</country>
</shipping>
  • Example 2

<shipping>
<price>20 SEK</price>
<country>SE</country>
<service>DHL</service>
</shipping>
  • Example 3

<shipping>
<price>20 SEK</price>
<country>SE</country>
<service>DHL</service>
<min_handling_time>1</min_handling_time>
<max_handling_time>3</max_handling_time>
<min_transit_time>3</min_transit_time>
<max_transit_time>5</max_transit_time>
</shipping>
  • Example 4

<shipping>
<price>20 SEK</price>
<country>SE</country>
<region>Skåne</region>
<service>Postnord</service>
</shipping>
  • Example 5

<shipping>
<price>20 SEK</price>
<country>SE</country>
<region>Gotland</region>
<service>Postnord</service>
<min_handling_time>1</min_handling_time>
<max_handling_time>3</max_handling_time>
<min_transit_time>3</min_transit_time>
<max_transit_time>5</max_transit_time>
</shipping>
  • Example 6

<shipping>
<price>20 SEK</price>
<country>SE</country>
<region>Skåne</region>
<service>DHL</service>
</shipping>

CSV examples

  • Example 1

    Column: shipping

    Value: SE:Skåne:DHL:20 SEK

shipping SE:Skåne:DHL:20 SEK

**NOTE: If you don't specify subattributes in brackets we expect all 4 values in following order: `country`, `region`, `service`, `price`. If you don't have some of them leave them blank, but remember about `":"` separator. If you want to specify more than `country`, `region`, `service` and `price`, don't use `shipping` header, but use extended header syntax - `shipping(country:region:service:price:min_handling_time)`.**

  • Example 2

    Column: shipping(country:price)

    Value: SE:20 SEK

shipping(country:price) SE:20 SEK
  • Example 3

    Column: shipping(country:price:service)

    Value: SE:20 SEK:DHL

shipping(country:price:service) SE:20 SEK:DHL
  • Example 4

    Column: shipping(country:price:service:min_handling_time:max_handling_time:min_transit_time:max_transit_time)

    Value: SE:20 SEK:DHL:1:3:2:5

shipping(country:price:service:min_handling_time:max_handling_time:min_transit_time:max_transit_time) SE:20 SEK:DHL:1:3:2:5
  • Example 5

    Column: shipping(country:region:price:service)

    Value: SE:Skåne:20 SEK:DHL

shipping(country:region:price:service) SE:Skåne:20 SEK:DHL
  • Example 6

    Column: shipping(country:region:price:service:min_handling_time:max_handling_time:min_transit_time:max_transit_time)

    Value: SE:Gotland:20 SEK:DHL:1:3:2:5

shipping(country:region:price:service:min_handling_time:max_handling_time:min_transit_time:max_transit_time) SE:Gotland:20 SEK:DHL:1:3:2:5
  • Example 7

    Column: shipping(price:country:region:service),shipping(price:country:region:service)

    Value: 20:SE:Skåne:Postnord,20:SE:Skåne:DHL

shipping(price:country:region:service),shipping(price:country:region:service) 20:SE:Skåne:Postnord,20:SE:Skåne:DHL

Requirements explained

  • It's highly recommended as an offer without shipping it's less attractive for the user

  • It is also recommended to include this cost to improve conversion

  • Keep shipping information as precise as possible. Add multiple shipping attributes if shipping cost or time varies for different country, region or service.

  • Don't provide comma or point as separator for both thousands and fractional part of the shipping price, i.e. we don't support 1,000,00 SEK and 1.000.00 SEK formats

Did this answer your question?