Skip to main content

shipping_length

Optional Field

This field is optional, but omitting it may leave out functionality on Prisjakt for your offers

Description​

It is recommended to add this attribute if delivery costs based on dimensions. This attribute is required if any of your shipping services in Business Center has a size condition, since the shipping of an offer can only be built from such a service when all three of shipping_length, shipping_width and shipping_height are known and fall inside the configured range.

Effects When Omitted​

  • An offer that is missing any of the three dimensions can never be matched by a Business Center shipping service that has a size condition. If all your services have size conditions, such an offer is published without shipping information.

Validation Rules​

  • Length must be between 1-50 characters
  • Unit must be one of cm or in
  • Value and unit must be separated by a single space, for example 24.5 cm
  • Matching against Business Center. Dimensions are compared after conversion to centimetres, so you can use either unit. A size condition is only matched when all three dimensions are present on the offer. A minimum in a size condition is inclusive and a maximum is exclusive

Example Values​

Here are examples of how a valid shipping_length value should look like in XML and CSV (with header) respectively.

Valid Value
<g:shipping_length>10.12 cm</g:shipping_length>
Click to show more valid XML examples
<g:shipping_length>10.12 cm</g:shipping_length>
<g:shipping_length>0 cm</g:shipping_length>
<g:shipping_length>0.0 in</g:shipping_length>
<g:shipping_length>11 cm</g:shipping_length>
<g:shipping_length>15.2 in</g:shipping_length>
<g:shipping_length>1E+02 cm</g:shipping_length>

Error Codes​

Below you will find possible error codes generated when validating this field alongside with an example in XML and CSV that would trigger the code. Please refer to the validation rules to understand the cause.

validation_invalid_format
<g:shipping_length>123cm</g:shipping_length>
<g:shipping_length>in</g:shipping_length>
validation_invalid_length_unit
<g:shipping_length>2 m</g:shipping_length>
validation_invalid_value
<g:shipping_length>unkn own</g:shipping_length>
<g:shipping_length>111.222.333 in</g:shipping_length>

Properties​

PropertyValueDescription
Data TypestringClosest data type in code
NestedFalseDefines if this field consists of one or more sub-fields
Case SensitiveFalseIf small or large letters matter for this field
RepeatableFalseIf you can supply multiple items of this field (it´s a list)
Repeatable limit0If a list, this specifices the max number of items

Changelog​

📅 2026-08-17

Changed

Documented that all three dimensions are needed to match shipping services with a size condition in Business Center.

📅 2022-12-07

Added

Initial definition

References​