Skip to main content

Shipping

shipping: Nullable<Shipping>

Information about shipping, such as available options, selected option and custom labels. This property may be null depending on the page it is accessed from.

PropertyTypeAlways presentDescription
selectedstring or nullNoSelected shipping option ID.
optionsShippingOption[]NoList of available shipping options.
custom_labelsRecord<string, string>NoCustom labels assigned to shipping options.

ShippingOption (each element of shipping.options):

PropertyTypeAlways presentDescription
idstringYesUnique identifier for the shipping option.
original_namestring or nullNoOriginal name of the shipping option.
namestring or nullNoDisplay name of the shipping option.
codestring or nullNoShipping method code.
referencestring or nullNoReference code for the shipping option.
typestring or nullNoType of shipping method.
pricenumberYesPrice of the shipping option.
price_merchantnumberYesMerchant price of the shipping option.
currencystringYesCurrency of the shipping cost.
min_delivery_datestring or nullNoEstimated minimum delivery date.
max_delivery_datestring or nullNoEstimated maximum delivery date.
phone_requiredbooleanYesWhether a phone number is required for shipping.
id_requiredbooleanYesWhether an ID is required for shipping.
accepts_codbooleanYesWhether cash on delivery is accepted.
free_shipping_eligiblebooleanYesWhether the option is eligible for free shipping.
extraobjectNoExtra shipping details (e.g. show_time, warning, free_shipping fields).
methodstring or nullNoShipping method identifier.
app_idstring or nullNoApplication ID associated with the shipping option.
hiddenbooleanYesWhether the shipping option is hidden.
prioritynumber or nullNoPriority of the shipping option.
shippablebooleanYesWhether the shipping option is available.
smart_dateobjectNoSmart date information for delivery estimates.

For the exact TypeScript definitions (including nested extra and smart_date shapes), use the types from @tiendanube/nube-sdk-types (e.g. Shipping, ShippingOption).