Shopping Service schemas

Entities and methods to handle baskets and payments.

Basket

Basket

Represents a basket where you can add/remove/update items and information such as discountcodes and pass forward information types.

Id
integer or null <int32>

The internal id of the basket. Used to get a specific basket. Ignored in CreateBasket.

CustomerId
integer or null <int32>

The customer internal id for a specific customer associated with this basket. This can be set in CreateBasket if the user is logged in. Otherwise use UpdateBuyer to set customer.

CompanyId
integer or null <int32>

The company internal id for a specific company associated with this basket. This can be set in CreateBasket if the user is logged in with a company. Otherwise use UpdateBuyer to set customer and company.

SalesContactId
integer or null <int32>
StatusId
integer <int32>

Internal id for the current status of the basket. See ListBasketStatuses.

CurrencyId
integer <int32>

The currency internal id of the basket. This defines the currency used when processing payments. Can be set when creating a Basket or change later with UpdateBasket. Use either CurrencyId or CurrencyCode. If not specified, the default for the Application will be used.

CurrencyCode
string

The CurrencyCode of the basket. This defines the currency used when processing payments. Can be set when creating a Basket or change later with UpdateBasket. Use either CurrencyId or CurrencyCode. If not specified, the default for the Application will be used. MaxLength: 3

Comment
string

Free text comment that will be propagated to the order. MaxLength: 250

OrderReference
string

An OrderReference which will be tagged on the order. Can be set in CreateBasket or updated in UpdateBasket. MaxLength: 50

DiscountCode
string

A comma separated list of used discount codes. To clear the value set it to null or String.Empty an call UpdateBasket. MaxLength: max

ReferId
integer or null <int32>
ReferUrl
string

MaxLength: 255

ValidTo
string or null <date-time>
IsEditable
boolean

Specifies if the basket is editable. If not, any method that changes the basket will throw Exceptions (Bad Request). It will be false when the basket is no longer a basket. That is when it's paid for or cancelled.

Array of objects <BasketItem> (BasketItem)

List of the items in the basket.

Array of objects <ExtraInfo> (ExtraInfo)

List of information types with values that may be propagated on the order.

object <Summary> (Summary)
Array of objects <Promotion> (Promotion)

Contains all Promotions valid for a Basket, whether or not they are applied. If any promotions are applied more info about them are added to the corresponding Basket.Items.

IpAddress
string

The user's IpAddress when the basket was created. The value should be fetched from the user request to the application. MaxLength: 50

AttestedBy
integer or null <int32>
TypeId
integer <int32>

The internal type id of the Basket. Can be 1 = Basket, 2 = Saved Basket, 3 = Template Basket for Subscriptions.

DoHold
boolean

DoHold specifies if the resulting order should be on hold until all items on the order can be shipped or not. Default is false. This can be set in the Checkout with UpdateBasket if the Customer does not want part deliveries.

IsBuyable
boolean

IsBuyable is a rule based property indicating if the Basket's status allows the basket to be purchased. It should be regarded as readonly.

InvoiceReference
string

An InvoiceReference which will be tagged on the order. Can be set in CreateBasket or updated in UpdateBasket. MaxLength: 50

PaymentMethodId
integer or null <int32>

The PaymentMethodId from Storm. Can be set in CreateBasket or updated in UpdatePaymentMethod.

DeliveryMethodId
integer or null <int32>

The DeliveryMethodId from Storm. Can be set in CreateBasket or updated in UpdateDeliveryMethod.

SalesAreaId
integer <int32>

The SalesArea internal id of the basket. This defines the default VAT-rate used. Can be set when creating a Basket or change later with UpdateBasket. If not specified, the default for the Application will be used.

BasketItem

Id
integer or null <int32>

Internal id of the basket item. Used to refer to this particular row in different methods.

LineNo
integer <int32>

Line number of the item. Used to refer to this particular row in different methods.

ParentLineNo
integer or null <int32>

If this item is part of a bundle, an attached item from promotion or such this property will refer to the associated line number.

ProductId
integer <int32>

Internal product id of the product for this basket item.

PartNo
string

The PartNo of this Item. Must be specified when adding items to a basket. MaxLength: 50

ManufacturerPartNo
string

Manufacturer part number. Populated by Storm. MaxLength: 50

Name
string

Name of the product. Populated by Storm. MaxLength: 255

SubHeader
string

Sub header of the product. Populated by Storm. MaxLength: 255

ThumbnailImage
string

MaxLength: 255

FlagIdSeed
string

A comma separated list of internal flag ids. MaxLength: max

Type
integer <int32>

The internal type id of the underlying product. See ListSkuTypes under Products.

PriceDisplay
number <decimal>

This is the price, excluding VAT, after applying company discounts and promotions. It is what the customer is paying.

Price
number or null <decimal>

This is the snapshot value, excluding VAT, of PriceDisplay when the basket is bought. Should be null. Can be used to set a price from the application when updating or creating BasketItems. Then IsPriceManual must be set to true as well.

PriceOriginal
number <decimal>

This is the original price of the SKU, excluding VAT.

Cost
number or null <decimal>

CostPurchase from Storm Admin, excluding VAT.

VatRate
number <decimal>

A rate to multiply with price to get price inc VAT. 25% VAT equals a VatRate of 1.25.

Quantity
number <decimal>

The Quantity of this Item. Must be specified when adding items to a basket.

UOM
string

MaxLength: 50

UOMCount
number or null <decimal>
Comment
string

Free text comment for this basket item. MaxLength: 255

PriceListId
integer <int32>

The internal pricelist id of this Item. Must be specified when adding items to a basket. Use the PriceListId from Product or ProductItem.

ReferId
integer or null <int32>

Used to tag a BasketItem with some external id.

ReferUrl
string

Used to tag a BasketItem with an incoming URL. MaxLength: 255

IsEditable
boolean

Indicates if a basket item is editable or not. This can happen when the API splits rows in promotions. Can be checked to see if an item should be allowed for UpdateBasketItem.

IsDiscountable
boolean
Array of objects <ExtraInfo> (ExtraInfo)

List of information types and values associated with this particular basket item.

OptionalItems
Array of objects <BasketItem> (BasketItem)
OnHandValue
number <decimal>
IncomingValue
number <decimal>
NextDeliveryDate
string or null <date-time>
LeadtimeDayCount
integer or null <int32>
PromotionIdSeed
string

Internal ids of promotions applied on this product. MaxLength: max

ImageKey
string or null <guid>

A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.

ManufacturerName
string

Name of the manufacturer of the product. Populated by Storm. MaxLength: 100

CategoryId
integer or null <int32>
object <ProductsOnHand> (ProductsOnHand)
object <ProductsOnHand> (ProductsOnHand)
PriceRecommended
number or null <decimal>

The rule based price, excluding VAT, from a priceList, if specified.

ManufacturerId
integer <int32>

Internal manufacturer id for the product. Populated by Storm.

UniqueName
string

A unique name that can be used in Urls and to get a Product. GetProduct and GetProductByUniqueName gets the same Product. MaxLength: 500

StatusId
integer <int32>

The status of the underlying product. Lookup references in ListStatuses.

StockDisplayBreakPoint
integer or null <int32>

A value that can be used for display logic regarding OnHand.

PriceCatalog
number or null <decimal>

The original price, excluding VAT, if specified.

IsBuyable
boolean

Indicates if the item is buyable or not. Will always be false if the status is closed. An exception will be thrown if IsBuyable is false and an attempt to buy the item is made.

SubDescription
string

Sub description from Storm Admin. MaxLength: max

CategoryIdSeed
string

A comma separated list of internal category ids ordered so the primary category is first. MaxLength: max

RecommendedQuantity
number or null <decimal>

Indicates the default value used as quantity when buying the product. If IsRecommendedQuantityFixed is true, only multiples of this quantity should be allowed.

IsRecommendedQuantityFixed
boolean

If this is set to true only multiples of RecommendedQuantity should be allowed.

Array of objects <AppliedPromotionOnItem> (AppliedPromotionOnItem)

Applied promotions for this item, if any. It will contain some info about what promotion was applied and amount applied.

RequirementPromotionIdSeed
string

A comma separated list of promotion internal ids for this item that are fulfilling the requirements. MaxLength: max

IsSubscribable
boolean

True if this item can be added to a Subscription. False otherwise. Can be used when copying BasketItems from one Basket to a TemplateBasket in a Subacription.

DescriptionHeader
string

DescriptionHeader for the product as specified in Storm Admin. MaxLength: 255

IsPriceManual
boolean

Used when setting price on a BasketItem from the application. Manual prices are not discountable when applying promotions or company discounts.

PriceStandard
number or null <decimal>

The standard price, excluding VAT, if specified.

EanCode
string

SKU EAN code. MaxLength: 50

CostUnit
number or null <decimal>

CostUnit, excluding VAT, from Storm Admin.

PriceDisplayIncVat
number <decimal>

This is the price including VAT after applying company discounts and promotions. It is what the customer is paying.

PriceListLocked
boolean or null

Set to true to exclude this item's price list from business logic when selecting cheapest price. Will be set to false if price list is unavailable.

PriceOriginalIncVat
number <decimal>

This is the original price of the SKU, including VAT.

PriceRecommendedIncVat
number or null <decimal>

The rule based price, including VAT, from a priceList, if specified.

PriceCatalogIncVat
number or null <decimal>

The original price, including VAT, if specified.

PriceStandardIncVat
number or null <decimal>

The standard price, including VAT, if specified.

BasketPagedList

ItemCount
integer <int32>

Total number of baskets.

Array of objects <Basket> (Basket)

List of baskets.

InsertItemsPostPurchaseData

Used as input to InsertItemsPostPurchase since WCF cannot take more than one complex type at once as parameter.

Array of objects <BasketItem> (BasketItem)

The items to add to the purchase. The items to insert must have its PartNo, Quantity and PriceListId set. ParentLineNo, Name, Comment, ReferId and ReferUrl can be used if other values than the default are wanted. All other properties will be populated from the system.

Array of objects <NameValue> (NameValue)

Roundtrip of the parameters received in the original payment response.

SavedBasket

Id
integer <int32>

Internal id of the saved basket.

Name
string

Name given to this specific saved basket. MaxLength: 50

Created
string <date-time>

Creation date.

CustomerId
integer or null <int32>

Internal customer id of associated customer, if any.

ValidTo
string or null <date-time>

Valid date, if any.

Summary

The Summary is a grouping of BasketItem totals. This can be used to display summaries for a Basket.

object <SummaryItem> (SummaryItem)
object <SummaryItem> (SummaryItem)
object <SummaryItem> (SummaryItem)
object <SummaryItem> (SummaryItem)

SummaryItem

The SummaryItem is the summary used for each item in Summary.

Amount
number <decimal>

Total Amount exclusive VAT. PriceDisplay * Quantity.

Vat
number <decimal>

The total VAT amount.

AmountIncVat
number <decimal>

Total Amount including VAT. PriceDisplayIncVat * Quantity.

Checkout

Checkout

Used to connect a specific basket with customer information, payment and delivery options.

object <Basket> (Basket)
object <CustomersCustomer> (CustomersCustomer)
object <CustomersCustomer> (CustomersCustomer)
object <CustomersCustomer> (CustomersCustomer)
Array of objects <PaymentMethod> (PaymentMethod)

List of available payment methods for this checkout. May be changed depending on basket contents. Generated by Storm.

Array of objects <DeliveryMethod> (DeliveryMethod)

List of available delivery methods for this checkout. May be changed depending on basket contents. Generated by Storm.

Array of objects <Payment> (Payment)

List of payment attemtps made for this checkout. Each payment method selected will create it's own entry in this list.

Payment

Represents a single payment attempt for this basket.

PaymentCode
integer <int32>

System generated id for this particular payment. Client specific.

Amount
number <decimal>

Payment amount, including VAT.

CardNo
string

Card number if payment has been made by credit card or gift card. Populated by PSP. MaxLength: max

PaymentMethodId
integer <int32>

Internal id of the payment method for this payment. Application specific.

PaymentServiceId
integer <int32>

Internal id of the payment service for this payment. System specific. Indicates the PSP.

PurchaseEx2Data

Used as input to PurchaseEx2 since WCF cannot take more than one complex type at once as parameter.

object <Checkout> (Checkout)
Array of objects <NameValue> (NameValue)

General: 'test'=true to enable tests. When 'test' is used no payments will be processed for real. Payments may interpret supplied values such as cardNumber or ssn to simulate failures. Not implemented. Klarna: 'sessionId'=id. Used to provide a sessionId to Klarna payments. Not implemented. Payex and Dibs. Supported values are 'returnUrl' and 'cancelUrl'. Values should point to where the payment service should go in case of success/failure.

DeliveryMethods

BasketDeliveryMethodUpdate

Used when updating the Checkout with a DeliveryMethod. See UpdateDeliveryMethod4 for more info.

Id
integer <int32>

The internal id of the DeliveryMethod.

Price
number or null <decimal>

The Price of the DeliveryMethod, excluding VAT. Prices set here will be handled as manual prices. If not set the Price will be taken from Storm and be treated as a normal price.

object <DropPoint> (DropPoint)
Code
string

An external Code for the DeliveryMethod. This should not be set if the Code defined in Storm is to be used. MaxLength: 50

Carrier
string

The carrier providing the delivery method MaxLength: 50

DeliveryMethod

Represent a DeliveryMethod in Norce. DeliveryMethods can be specified in the Admin UI or fetch from integrated Delivery providers such as ShipAdvisor. Application specific.

Id
integer <int32>

The internal id of the DeliveryMethod.

Name
string

The Name of the DeliveryMethod. MaxLength: 50

TypeId
integer <int32>

The internal type id of the DeliveryMethod. DeliveryMethodTypes are logical groupings of different types such as home delivery, pickup and such.

TypeName
string

The TypeName of the DeliveryMethodType. MaxLength: 50

Description
string

The Description of the DeliveryMethod. MaxLength: max

PartNo
string

The part number, if any, of the product representing the DeliveryMethod. Products setup for delivery methods must have a SkuType equal to Freight. These are handled by Storm and added and removed automatically. MaxLength: 50

Price
number <decimal>

The Price of the DeliveryMethod, excluding VAT.

VatRate
number <decimal>

A rate to multiply with price to get price inc VAT. 25% VAT equals a VatRate of 1.25.

IsNotifiable
boolean

Indicates if the DeliveryMethod has delivery notifications.

ImagePath
string

MaxLength: 255

IsSelected
boolean

IsSelected is set to true for the currently selected DeliveryMethod on baskets. All other DeliveryMethods have this set to false. If no DeliveryMethod has been set all will have this value set to false.

ImageKey
string or null <guid>

A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.

IsForCompanyOnly
boolean

Indicates if the DeliveryMethod has is for Companies only.

IsForPersonOnly
boolean

Indicates if the DeliveryMethod has is for Customers only.

Cost
number <decimal>

The Cost of the DeliveryMethod.

StoreId
integer or null <int32>

The internal store id of any Store connected to this DeliveryMethod. Most often this will be set if ZipCode mappings exist in Storm.

WarehouseId
integer or null <int32>

The internal warehouse id of any Warehouse connected to this DeliveryMethod. Most often this will be set if ZipCode mappings exist in Storm.

LocationId
integer or null <int32>

The internal location id of any WarehouseLocation connected to this DeliveryMethod. Most often this will be set if ZipCode mappings exist in Storm.

Array of objects <DropPoint> (DropPoint)

A list of DropPoint, if any, for the DeliveryMethod. These are not kept in Storm but fetched from integrated DeliveryMethod providers such as ShipAdvisor.

Code
string

An external Code for the DeliveryMethod. MaxLength: 50

Carrier
string

Optional information about carrier MaxLength: 50

DropPoint

The DropPoint entity represents a pickup place for deliveries. Only used for external or integrated DeliveryMethod providers.

Code
string

Code is the external/integrated DeliveryMethod provider's code for the pickup store. MaxLength: 50

RoutingCode
string

MaxLength: 50

Depot
string

MaxLength: 50

Name1
string

The name of the place to pickup the goods. MaxLength: 100

Name2
string

The name part 2 of the place to pickup the goods. MaxLength: 100

Address1
string

The Address of the place to pickup the goods. MaxLength: 100

Address2
string

The Address part 2 of the place to pickup the goods. MaxLength: 100

PostalCode
string

The ZipCode of the place to pickup the goods. MaxLength: 50

City
string

The City of the place to pickup the goods. MaxLength: 50

CountryCode
string

The CountryCode of the place to pickup the goods. MaxLength: 3

Contact
string

The Contact of the place to pickup the goods. MaxLength: 100

Phone
string

The Phone to the place to pickup the goods. MaxLength: 50

Fax
string

MaxLength: 50

Email
string

The Email to the place to pickup the goods. MaxLength: 255

Latitude
number <double>

The Latitude part of the location of the pickup. Can be used to calculate distances.

Longitude
number <double>

The Longitude part of the location of the pickup. Can be used to calculate distances.

Distance
number <double>

The Distance to the location of the pickup.

Array of objects <OpeningHours> (OpeningHours)

A list of opening hours for the pickup.

IsSelected
boolean

Indicates if this is the selected DropPoint or not. Gets set by Storm.

OpeningHours

Day
string
Open
string

MaxLength: 255

Close
string

MaxLength: 255

InfoTypes

ExtraInfo

Information carrying entity to convey customer specific information from the basket to the order, PSP et.al.

TypeId
integer <int32>

The internal id of type. This TypeId might be different in different tiers such as Stage and Production. Use Code if hard coding is required.

Value
string

The Value of the Entity. MaxLength: max

Code
string

The Code of the type, if existing. Use this value when hard coding is required. MaxLength: 50

OnHand

No entities. See ProductOnHand

OrderRequest

No entities. Returns raw xml. TODO!

PaymentMethods

PaymentMethod

Represents a specific payment method in Norce. A PSP may be represented with multiple payment methods. Application specific.

Id
integer <int32>

Internal id for this payment method.

Name
string

Descriptive name of the payment method. MaxLength: 50

TypeId
integer <int32>

Internal type id for this payment method.

TypeName
string

Clear text name of the type of this payment method. MaxLength: 50

Description
string

Free text description of the payment method. MaxLength: max

PartNo
string

Part number for this payment method, if configured. MaxLength: 50

Price
number <decimal>

Price, excluding VAT, to use this payment method, if configured.

VatRate
number <decimal>

A rate to multiply with price to get price inc VAT. 25% VAT equals a VatRate of 1.25.

ImagePath
string

MaxLength: 500

IsSelected
boolean

Indicates if this is the currently selected payment method for the Checkout. Only one may have this flag set to true. Use UpdatePaymentMethod3 to set this property.

object <PaymentService> (PaymentService)
ImageKey
string or null <guid>

A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.

IsForCompanyOnly
boolean

Indicates if this payment method is only allowed for companies. Cannot be combined with IsForPersonOnly.

IsForPersonOnly
boolean

Indicates if this payment method is only allowed for persons. Cannot be combined with IsForCompanyOnly.

PaymentService

Represents a way of payment. A client may have several payment methods using the same service. A PSP may offer several payment services.

Id
integer <int32>

Internal id of this payment service.

Name
string

Descriptive name of this payment service. MaxLength: 50

Description
string

MaxLength: 500

ImagePath
string

MaxLength: 500

ImageKey
string or null <guid>

A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.

Payments

PaymentResponse

Response from payment service calls such as GetPaymentForm, Purchase, PurchaseEx.

Status
string

String response. OK if successful, otherwise may have different values depending on PSP. MaxLength: 50

StatusDescription
string

Descriptive text for the status. MaxLength: 255

BasketId
integer or null <int32>

Internal id of the associated basket.

OrderNo
string

Order number if order's been created. MaxLength: 50

PaymentCode
string

Internal identifier of this specific payment attempt. MaxLength: int

PaymentReference
string

External identifier of this specific payment attempt, usually from the PSP. MaxLength: 50

HostedPaymentPage
string

Used when a payment should be finalized on a different platform, e.g. sending a link by SMS to customer. MaxLength: 50

RedirectUrl
string

Configurated redirection URL after successful payment. MaxLength: 255

Array of objects <NameValue> (NameValue)

PSP specific data returned for the payment. See PSP documentation.

IsSyncronous
boolean or null

Indicates if the payment attempt was synchronous or not.

PaymentServiceId
integer or null <int32>

Internal id of the payment service used.

Promotions

AppliedPromotionOnItem

AppliedPromotionOnItem entity represents promotions applied on Basket.Items. Only Basket.Items with any promotions applied will have any.

Id
integer or null <int32>

The internal id of the Promotion.

Name
string

The Name of the Promotion. MaxLength: 255

DiscountCode
string

Will contain the discountCode if the promotion has a discountCode requirement. MaxLength: max

AppliedAmount
number or null <decimal>

Applied discount amount, excluding VAT, for this Promotion on this BasketItem.

AppliedAmountIncVat
number or null <decimal>

Applied discount amount, including VAT, for this Promotion on this BasketItem.

Promotion

The Promotion entity represents a promotion in Norce. It contains some meta data from the Promotion as well as applied total amount when applicable.

Id
integer or null <int32>

The internal id of the Promotion.

Name
string

The Name of the Promotion. MaxLength: 255

Header
string

SubHeader from Storm. MaxLength: 255

ShortDescription
string

DescriptionHeader from Storm. MaxLength: 255

Description1
string

Description from Storm. MaxLength: max

Description2
string

SubDescription from Storm. MaxLength: max

StartDate
string or null <date-time>

The StartDate of the Promotion, if any. Only valid promotions will be returned.

EndDate
string or null <date-time>

The EndDate of the Promotion, if any. Only valid promotions will be returned.

ImageKey
string or null <guid>

A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.

RequirementSeed
string

A comma separated list of fulfilled requirements for this promotion. MaxLength: max

DiscountCode
string

Will contain the discountCode if the promotion has a discountCode requirement. MaxLength: max

IsExcludedFromPriceCalculation
boolean

A value of true means the promotion was applied last an not included in any price calculations.

AllowProductListing
boolean

This flag can be checked to see whether the promotion allows listing of products from requirements. Use Products.ListProductsByPromotionRequirement to list products. Note that if this property is true and no product requirements exists, no products will be listed.

Array of objects <File> (File)

A list of additional images files uploaded for the promotion. Images can be differentiated by using different types. See ListPromotionImageTypes for available types.

Array of objects <PromotionProductFilter> (PromotionProductFilter)

A list of productFilters for the promotion. Can be used to filter or fetch promotions matched by Products. match the products properties against the filter values Each ProductFilter must match all existing values and if any ProductFilter matches the promotion will be valid for that product.

AppliedAmount
number or null <decimal>

Applied discount amount, excluding VAT, if fetched on AppliedPromotions property on the basket. In that case it will be the sum of all applied amounts on all Basket.Items. This value is rounded to two decimals.

EffectSeed
string

A comma separated list of applicable effects for this promotion. MaxLength: max

FreightDiscountPct
number or null <decimal>

FreightDiscountPct can be used to calculate external freight prices. The value is given as percentage as 100.00 for 100% discount. Only used for FreightDiscounts.

IsStackable
boolean

Promotion effect quantity or basket discount is multiplied with how many times requirement is fulfilled.

AppliedAmountIncVat
number or null <decimal>

Applied discount amount, including VAT, for this Promotion on this BasketItem.

ExclusivityType
integer <int32>

ExclusivityType allows setting promotions as NotExclusive = 0, Exclusive = 1, or IgnoreExclusivity = 2.

PromotionProductFilter

PromotionProductFilter shows what any product in the requirement or effect is filtered by. Values should be AND:ed if used to filter products.

ManufacturerId
integer or null <int32>

An optional Manufacturer internal id for filtered products.

CategorySeed
string

An optional CategorySeed for filtered products. MaxLength: int

TypeId
integer or null <int32>

An optional SKU Type internal id for filtered products.

ProductId
integer or null <int32>

An optional Product internal id for filtered products.

VariantProductId
integer or null <int32>

An optional VariantProduct internal id for filtered products. Equal to use PartNo.

PartNo
string

An optional PartNo for filtered products. Equal to use VariantProductId. MaxLength: 50

PricelistId
integer or null <int32>

An optional pricelist internal id for filtered products.

FlagId
integer or null <int32>

An optional Flag internal id for filtered products. Only set if flagId is inclusive.

Subscriptions

Subscription

A Subscription is created by a user. A subscription is backed by a quotation acting as a template for creating orders at scheduled intervals.

Id
integer or null <int32>

A unique internal id for this Subscription. When creating new Subscription this should be left as null and will be ignored.

Name
string

The name of the Subscription. This will also be the name of the template basket. Can be used to distinguish Subscriptions from each other. MaxLength: 50

object <Basket> (Basket)
object <SubscriptionType> (SubscriptionType)
StatusId
integer <int32>

The internal status id for this Subscription. When a Subscription is created the status will be 0 (Inactive) and ignored. To activate a Subscription it must pass through the Checkout process. See ListSubscriptionStatus for valid values. Can only be changed between Active and Paused. To delete a Subscription use DeleteSubscription.

HoldUntilDate
string or null <date-time>

A date used to temporarily pause the Subscription and automatically activate it again on the specified date. If no HoldFromDate is specified the pause will start immediately.

StartDate
string or null <date-time>

An optional start date for the Subscription. The Subscription can be activated but no orders will be processed before this date if specified. Can only be changed if a specified date has not passed or if the Subscription is still inactive. If no StartDate is specified when activating the Subscription this will be set to the activation date.

EndDate
string or null <date-time>

An optional end date for the Subscription. The Subscription will be deleted after this date if specified. See DeleteSubscription for details about deleting subscriptions.

Array of objects <SubscriptionSchedule> (SubscriptionSchedule)

The schedules for this Subscription. Any Subscription must have at least one schedule when activated.

HoldFromDate
string or null <date-time>

A date used to temporarily pause the Subscription from the specified date and automatically activate it again on HoldUtilDate. If this is specified HoldUntilDate must also be specified.

NextRun
string or null <date-time>

Calculated date for next time an order will be created by this subscription

SubscriptionSchedule

A specific schedule for a Subscription. Schedules are used to determine when orders should be created from the template basket. The StartDate of the Subscription is used as start for the Schedule.

Id
integer or null <int32>

A unique internal id for this SubscriptionSchedule. When creating new schedules this should be left as null.

IsActive
boolean

Specifies if the schedule is active or not. Only active schedules are considered when creating orders.

object <IdValue> (IdValue)
RecurValue
integer <int32>

Specifies how often the Frequency should be applied. If Frequency is 'Daily' and RecurValue is 2 then the schedule is every second day.

IsOnMonday
boolean

Specifies if the schedule should be applied on a Monday. Only used when Frequency is 'Weekly'. At least one of the IsOnDay values must be specified.

IsOnTuesday
boolean

Specifies if the schedule should be applied on a Tuesday. Only used when Frequency is 'Weekly'. At least one of the IsOnDay values must be specified.

IsOnWednesday
boolean

Specifies if the schedule should be applied on a Wednesday. Only used when Frequency is 'Weekly'. At least one of the IsOnDay values must be specified.

IsOnThursday
boolean

Specifies if the schedule should be applied on a Thursday. Only used when Frequency is 'Weekly'. At least one of the IsOnDay values must be specified.

IsOnFriday
boolean

Specifies if the schedule should be applied on a Friday. Only used when Frequency is 'Weekly'. At least one of the IsOnDay values must be specified.

IsOnSaturday
boolean

Specifies if the schedule should be applied on a Saturday. Only used when Frequency is 'Weekly'. At least one of the IsOnDay values must be specified.

IsOnSunday
boolean

Specifies if the schedule should be applied on a Sunday. Only used when Frequency is 'Weekly'. At least one of the IsOnDay values must be specified.

MonthlyDay
integer <int32>

Specifies if the schedule should be applied on a specific day. Only used when Frequency is 'Monthly' and not any of the MonthlyInterval values are used.

object <IdValue> (IdValue)
object <IdValue> (IdValue)
TimeOfDay
string

Specifies at what time the schedule should be applied. Just the Hours and Minutes parts are used. Formats 'hh:mm.ss' or 'hh:mm'.

SubscriptionScheduleData

General data for scheduling Subscriptions. Data can be used to populate drop lists with values needed when creating SubscriptionSchedules.

Array of objects <IdValue> (IdValue)

A list of frequencies. Defines how often should a Subscription should produce an order. See SubscriptionSchedule for usage.

Array of objects <IdValue> (IdValue)

A list of intervals used together with MonthlyIntervalValues. See SubscriptionSchedule for usage.

Array of objects <IdValue> (IdValue)

A list of interval values used together with MonthlyIntervals. See SubscriptionSchedule for usage.

SubscriptionType

A SubscriptionType specified for the application. Used by Subscription. SubscriptionTypes are created in the Admin UI.

Id
integer <int32>

A internal id for this type.

Code
string

An external code use to identify this type. Used when creating Subscription. MaxLength: 50

Name
string

The name of the type. MaxLength: 50

Description
string

A description of the type. MaxLength: 500

EndDate
string or null <date-time>

An optional end date for the SubscriptionType. Subscriptions created for this SubscriptionType can not have an end date later than this.