Skip to content

Documentation Norce [Storm] Connect Customer Service (4.0)

The Customer Service has Entities and Operations concerned with Customers and Companies in Norce Commerce.

Download OpenAPI description
Languages
Servers
https://customer-slug.api-se.norce.tech/commerce/connect/4.0/

Schemas

Schemas

CustomerHeader

AccountIdinteger(int32)required

Account which initiated the import. Learn about system accounts here.

CompanyFieldsThatAreSetArray of stringsrequired

Array of strings representing company fields to be processed.
(Use the integer instead of the name for the xml content type)
Not required for ImportCustomers

0 = ApplicationKey
1 = Id
2 = Code
3 = OrganizationNo
4 = Name
5 = EmailAddress
6 = PhoneNumber
7 = LogoImage
8 = ParentCompanyCode
9 = IsActive
10 = InvoiceAddress
11 = DeliveryAddresses
12 = AdditionalInfo
13 = Contacts
14 = Customers (set values in CustomerFieldsThatAreSet)
15 = DeliveryMethods
16 = Discounts
17 = Flags
18 = PaymentMethods
19 = PriceLists
20 = SearchOnlyByCode (matches the customer only on the value on the code field, allows for duplicated OrganizationNo)
21 = VatNo
22 = PreserveFlags (Flags not passed in, will be left on the entity, otherwise they will be removed and replaced with the ones imported)

Items Enum"ApplicationKey""Id""Code""OrganizationNo""Name""EmailAddress""PhoneNumber""LogoImage""ParentCompanyCode""IsActive"
CustomerFieldsThatAreSetArray of stringsrequired

Array of strings representing customer fields to be processed.
(Use the integer instead of the name for the xml content type)
Not required for ImportCompanies, but if used there, 'Customers' must be set in CompanyFieldsThatAreSet

0 = ApplicationKey
1 = Id
2 = Code
3 = EmailAddress
4 = SocialSecurityNumber
5 = Title
6 = FirstName
7 = MiddleName
8 = LastName
9 = PhoneNumber
10 = CellPhoneNumber
11 = IsActive
12 = InvoiceAddress
13 = DeliveryAddresses
14 = Accounts (set values in AccountFieldsThatAreSet)
15 = AdditionalInfo
16 = Flags
17 = PriceLists
18 = SearchOnlyByCode (matches the customer only on the value on the code field, alows for duplicated email addresses)
19 = Companies (set values in CompanyFieldsThatAreSet)
20 = CrmId
21 = PreserveFlags (Flags not passed in, will be left on the entity, otherwise they will be removed and replaced with the ones imported)

Items Enum"ApplicationKey""Code""EmailAddress""SocialSecurityNumber""Title""FirstName""MiddleName""LastName""PhoneNumber""CellPhoneNumber"
AccountFieldsThatAreSetArray of strings

Array of strings representing account fields to be processed.
(Use the integer instead of the name for the xml content type)
Not required for ImportCompanies
Required settings: Accounts (in CustomerFieldsThatAreSet)

0 = PasswordCreateOnly (Value is only set if the entity is created by the import)
1 = Status
2 = StatusCreateOnly (Value is only set if the entity is created by the import)
3 = Roles
4 = RolesCreateOnly (Value is only set if the entity is created by the import)

Items Enum"PasswordCreateOnly""Status""StatusCreateOnly""Roles""RolesCreateOnly"
JobIdstring(int32)

Norce Commerce Connect job id. Only exists in import logs. Should be omitted in the import request.

SerializationTypeArray of strings

Request serialization type.(Use the integer instead of the name for the xml content type)

0 = JSON, 1 = XML

Items Enum"JSON""XML"
StorageNamestring(uri)

Location of the import file on Norce's file area. Can be used instead of sending data directly in payload.

SupplierIdstring(int32)

Derived from base header. Ignored in this import.

{ "AccountId": 0, "CompanyFieldsThatAreSet": [ "ApplicationKey" ], "CustomerFieldsThatAreSet": [ "ApplicationKey" ], "AccountFieldsThatAreSet": [ "PasswordCreateOnly" ], "JobId": "string", "SerializationType": [ "JSON" ], "StorageName": "http://example.com", "SupplierId": "string" }

Account

Customer account information

ApplicationKeystring(uuid)required

Application identifier. Determines which application the account belongs to.

LoginNamestringrequired

Account login name

Passwordstring

Account password

RolesArray of objects(AccountRole)(AccountRole)

List of account roles to assign

Statusinteger(int32)

Account status: 1 = Active, 2 = Inactive (Use integers if import format is XML)

{ "ApplicationKey": "15d62d1f-3a4e-4111-845a-4db40bf08e87", "LoginName": "string", "Password": "string", "Roles": [ {} ], "Status": 0 }

AccountRole

Determines what actions account can perform

Codestringrequired

Unique code of account role (e.g. Administrator, User). The role needs to exist in Norce Commerce.

IsActiveboolean

Sets account role to active or inactive. Default is true.

{ "Code": "string", "IsActive": true }

Customers

Operations