Last updated

Application Service schemas

The Applications namespace is concerned with the Application as such. It contains the Application entity, Stores and other lookup data common to an Application.

Application

Application

The Application entity contains data specific to the current application. An Application belongs to a Client and one Client can have multiple Applications. A common usage is that an Application maps to a market or a domain such as .se, .com and such.

Idinteger or null(int32)

The system wide unique internal Storm Id for this Application.

ParentIdinteger or null(int32)

Id of the parent application, if any. Will be the same as Id if none exists. Applications with the same parentId share products and customers. Some content and navigation can differ.

Keystring(guid)

The system wide unique Key for this Application.

Namestring

The Name of this Application. MaxLength: 50.

Urlstring

The Url to the Application. MaxLength: 255.

SenderEmailAddressstring

The sender e-mail address for all external communication and notifications if Norce Storm email services are used. MaxLength: 255.

Clientobject(Client)(Client)
Culturesobject(Cultures)(Cultures)
Currenciesobject(Currencies)(Currencies)
Pricelistsobject(Pricelists)(Pricelists)
SalesAreasobject(SalesAreas)(SalesAreas)
Rolesobject(Roles)(Roles)
Countriesobject(Countries)(Countries)
AuthorizationsArray of objects(IdValue)(IdValue)

A list of authorizations available for this application. Can be used when creating customer accounts.

Client

The Client entity contains data specific to the current client. A Client can have multiple Applications and represents a customer (Merchant) to Norce.

Idinteger(int32)

The system wide unique internal Storm Id for the Client.

Keystring(guid)

The system wide unique Key for the Client.

Namestring

The Name of the Client. MaxLength: 100.

Countries

A list of Countries and a Default. Used in Application. Available Countries can be used to populate drop-down lists with countries when the end user enters addresses.

ListArray of objects(Country)(Country)

A list of countries.

Defaultobject(Country)(Country)

Country

The Country entity contains info about a country.

Idinteger(int32)

The internal Storm Id of the country.

Namestring

The name of the country. MaxLength: 50.

Codestring

The Code of the country. The ISO 3166-1 alpha-2 is used. SE for Sweden. MaxLength: 3.

Culture

The Culture entity contains info about a culture. It defines language and formats.

Codestring

The Code of the culture. Two letter or five letter codes. sv-SE for swedish. MaxLength: 16.

Namestring

The name of the culture. MaxLength: 50.

Cultures

A list of Cultures and a Default. Used in Application. Available Cultures can be used to let the end user select different languages within an Application.

ListArray of objects(Culture)(Culture)

A list of cultures.

Defaultobject(Culture)(Culture)

Currencies

A list of Currencies and a Default. Used in Application. Available Currencies can be used to let the end user select different currencies within an Application.

ListArray of objects(Currency)(Currency)

A list of currencies.

Defaultobject(Currency)(Currency)

Currency

The Currency entity contains info about a currency.

Idinteger(int32)

The internal Storm Id of the currency.

Namestring

The name of the currency. MaxLength: 50.

Codestring

The Code of the currency. ISO 4217 is used. SEK for Swedish kronor. MaxLength: 3.

Prefixstring

The Prefix sign/code if available. MaxLength: 10.

Suffixstring

The suffix sign/code if available. MaxLength: 10.

Pricelists

A list of public PriceListIds and a Default. Used in Application.

IdsArray of integers(int32)

A list of priceList ids.

Defaultinteger(int32)

The default priceList id from the list.

Role

The Role entity contains info about a Role. Roles can be used to authorize users to different actions within an Application.

Idinteger(int32)

The internal Id of the role.

Namestring

The Name of the role. MaxLength: 50.

Descriptionstring

The Description of the role. MaxLength: 500.

Roles

A list of Roles and a Default. Used in Application. Available Roles can be used in Account. Roles when creating customers with accounts.

ListArray of objects(Role)(Role)

A list of roles.

Defaultobject(Role)(Role)

SalesArea

A SaleArea defines a region within an Application(market) with specific default VAT and currency.

Idinteger(int32)

The internal Id of the SalesArea.

Namestring

The Name of the SalesArea. MaxLength: 50.

CurrencyIdinteger(int32)

The default id of the Currency for this SalesArea.

VatCodeIdinteger(int32)

The default id of the VatCode for this SalesArea.

SalesAreas

A list of SalesAreas and a Default. Used in Application.

ListArray of objects(SalesArea)(SalesArea)

A list of SalesAreas.

Defaultobject(SalesArea)(SalesArea)

Flags

No entities. See IdValues

InfoTypes

No entities. See IdNameDescription

Location

Location

This entity defines a location. If StoreId and StoreCode are both null, then WarehouseId and LocationId are not null and vice versa. All properties can have values if the Store is fetched from Norce [Storm]. The information can be used when specifying Store/Warehouse/Location in some API-methods.

StoreIdinteger or null(int32)

This is the internal Storm ID.

StoreCodestring

This is a code used to map Store from an external system. MaxLength: 50.

WarehouseIdinteger or null(int32)

This is the internal Storm ID.

LocationIdIdinteger or null(int32)

This is the internal Storm ID.

LocationInfo

LocationInfo aggregates Locations for a zipcode in a country. Available locations are Delivery, Pickup and Payment.

CountryCodestring

This is country code for the location. MaxLength: 3.

ZipCodestring

This is zip code for the location. MaxLength: 50.

Deliveryobject(Location)(Location)
Pickupobject(Location)(Location)
Paymentobject(Location)(Location)

Stores

Store

Represents a Store, Workshop or such. It is called Division in the Admin UI. The Store entity is a bit more heavy weight than it's counter part StoreItem and should be used to display a detail page for the Store.

Idinteger(int32)

The internal Id of the Store.

Namestring

The Name of the Store. MaxLength: 50.

Addressstring

The Address of the Store. MaxLength: 100.

PostalAddressstring

The PostalAddress of the Store. Zip and City. MaxLength: 100.

Phonestring

The PhoneNumber to the Store. MaxLength: 50.

Faxstring

The FaxNumber to the Store. MaxLength: 50.

OpeningWeekdaysstring

Defines the opening hours for the Store during week days. MaxLength: 255.

OpeningSaturdaysstring

Defines the opening hours for the Store during on Saturdays. MaxLength: 255.

OpeningSundaysstring

Defines the opening hours for the Store during on Sundays. MaxLength: 255.

Longitudenumber or null(double)

The longitude part of the location of the Store. Can be used to calculate distances to the Store.

Latitudenumber or null(double)

The latitude part of the location of the Store. Can be used to calculate distances to the Store.

Distancenumber or null(decimal)

Used when fetching Stores and we have a specified current location from which to calculate a distance to the Store.

Keystring(guid)

The system wide unique Key for the Store.

Typestring

The Type of the Store. Taken from Storm's Division.GroupName. MaxLength: 50.

SubTypestring

The SubType of the Store. Taken from Storm's Division.SubGroupName. MaxLength: 50.

InfoArray of objects(IdValue)(IdValue)

Contains a list of id-value pairs specific to the client for this Store. Use ApplicationService.ListStoreInfoTypes(string) for id lookup.

Pricelistsobject(Pricelists)(Pricelists)
Codestring

The external code. Usually the id in the erp system. MaxLength: 50.

Descriptionstring

The Description of the Store. MaxLength: max.

ImageKeystring 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.

UniqueNamestring

A unique name that can be used in Urls and to get this entity. GetStore and GetStoreByUniqueName gets the same Store. MaxLength: 100.

StoreInfo

StoreInfo contains all info fields for a given Store.

Idinteger(int32)

The internal id of the Store.

InfoArray of objects(IdValue)(IdValue)

Contains a list of id-value pairs specific to the client for this store. Use ApplicationService.ListStoreInfoTypes(string) for id lookup.

StoreInfoPagedList

The StoreInfoPagedList is a PagedList. The Items property contains all current items, depending on paging, and the ItemCount the total number of items.

ItemCountinteger(int32)

The total item count. Can be used to manage paging. This will always be the total number of available items, regardless of paging. Use PageSize to calculate number of pages.

ItemsArray of objects(StoreInfo)(StoreInfo)

Items contains the current list of StoreInfo for the current page if paging is used. Otherwise all items will be in the list.

StoreItem

Represents a Store, Workshop or such. It is called Division in the Admin UI. The StoreItem entity is a bit less heavy weight than it's counter part Store and is fetched in a list.

Idinteger(int32)

The internal Id of the Store.

Namestring

The Name of the Store. MaxLength: 50.

Addressstring

The Address of the Store. MaxLength: 100.

PostalAddressstring

The PostalAddress of the Store. Zip and City. MaxLength: 100.

OnHandValuenumber or null(decimal)

Obsolete! - Use OnHand

IncomingValuenumber or null(decimal)

Obsolete! - Use OnHand

NextDeliveryDatestring or null(date-time)

Obsolete! - Use OnHand

Distancenumber or null(decimal)

Used when fetching Stores and we have a specified current location from which to calculate a distance to the Store.

Typestring

The Type of the Store. Taken from Storm's Division.GroupName. MaxLength: 50.

SubTypestring

The SubType of the Store. Taken from Storm's Division.SubGroupName. MaxLength: 50.

Codestring

The external code. Usually the id in the erp system. MaxLength: 50.

OnHandobject(ProductsOnHand)(ProductsOnHand)
OnHandDemoobject(ProductsOnHand)(ProductsOnHand)
UniqueNamestring

A unique name that can be used in Urls and to get this entity. GetStoreItem and GetStoreItemByUniqueName gets the same StoreItem. MaxLength: 100.

StoreItemPagedList

The StoreItemPagedList is a PagedList. The Items property contains all current items, depending on paging, and the ItemCount the total number of items.

ItemCountinteger(int32)

The total item count. Can be used to manage paging. This will always be the total number of available items, regardless of paging. Use PageSize to calculate number of pages.

ItemsArray of objects(StoreItem)(StoreItem)

Items contains the current list of StoreItems for the current page if paging is used. Otherwise all items will be in the list.

Expose Service schemas

The Expose namespace has common entities to all other namespaces or things that does not fit under any other namespace.

ErrorMessages

No entities. See NameValue

IdNameDescription

An Entity used where Id, Name and Description is needed. It also has an optional ImageKey that gets populated when existing. Mostly used for lookup data.

Idinteger(int32)

The internal Id of the Entity.

Namestring

The Name of the Entity. MaxLength: 50.

Descriptionstring

The Description of the Entity. MaxLength: 500.

ImageKeystring 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.

Codestring

The Code of the Entity. MaxLength: 50.

IdValue

An Entity used where Id and Value is needed. Mostly used for lookup data.

Idinteger(int32)

The internal Id of the Entity. This Id might be different in different tiers such as Stage and Production. Use Code if hard coding is required.

Valuestring

The Value of the Entity. MaxLength: max.

Codestring

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

Ping

No entities.

Process

No entities.