Skip to content

shipping

Delivery method

Overview

k.commerce.shipping provides operations related to delivery methods, used to obtain delivery configurations of physical products and digital products.

list()

Get a list of delivery methods for physical products.

ts
k.api.get(() => {
    const shippings = k.commerce.shipping.list()
    return { count: shippings.length, items: shippings }
})

parameter:

ParameterTypeRequiredDescription
options.countrystringnoFilter by country

Return: ShippingItem[]

digitalList()

Get a list of shipping methods for digital products.

Parameters: none.

ts
k.api.get(() => {
    const digitalShippings = k.commerce.shipping.digitalList()
    return { count: digitalShippings.length, items: digitalShippings }
})

Return: DigitalShipping[]

structure

ShippingItem Properties

PropertyDescriptionType
IDShipping method IDstring
nameShipping method namestring
descriptionShipping method descriptionstring
baseCostBasic shipping feenumber
additionalCostsAdditional freight listAdditionalCost
isDefaultIs it the default shipping method?boolean
countriesSupported country listSupportCountry
currentCostCurrent shipping costsnumber
codeExpress company codestring
currencycurrency codestring
symbolcurrency symbolstring

DigitalShipping Property

PropertyDescriptionType
IDShipping method IDstring
nameShipping method namestring
descriptionShipping method descriptionstring
mailServerTypeMail server typestring
koobooEmailAddressKooboo email addressstring
customMailServerCustom mail serverMailServer
mailTemplateEmail template{ subject: string, body: string }
isDefaultIs it the default shipping method?boolean
createdAtcreation timeDate
updatedAtUpdate timeDate

AdditionalCost Property

PropertyDescriptionType
costAdditional shipping amountnumber
descriptionAdditional shipping descriptionstring
conditionAdditional shipping conditionsCondition

SupportCountry Property

PropertyDescriptionType
namecountry codestring
displayCountry display namestring
estimatedDaysOfArrivalEstimated days of arrivalnumber

Condition property

PropertyDescriptionType
isAnyAny condition can be metboolean
itemsList of conditional itemsConditionItem

ConditionItem Property

PropertyDescriptionType
optionCondition optionsstring
Methodconditional methodstring
valuecondition valuestring