Connect Customer schemas
Import of customer and company data.
Entities
Account
Customer account information
Application identifier. Determines which application the account belongs to.
Account login name
Account password
List of account roles to assign
Account status: 1 = Active, 2 = Inactive (Use integers if import format is XML)
AccountRole
Determines what actions account can perform
Unique code of account role (e.g. Administrator, User). The role needs to exist in Norce Commerce.
Sets account role to active or inactive. Default is true.
Address
Customer address information
First line of address
Second line of address
Care of
City
System agnostic identifier for the company or customer. Max length: 50
ISO country code (e.g. SE, BY). Max length: 2
Global Location Number. Max length: 50
Set to true to indicate primary delivery address. Null will not change anything. Only one address can be marked primary.
Set to true to indicate that the address has been validated. Null will not change anything.
Region
Phone number for shipping notifications (if used as delivery address). Max length: 50
Zip code
Company
Company information
Application identifier. Determines which application company belongs to.
List of additional information fields
Company code. Used for company matching if Norce Commerce company id is omitted.
List of company contacts
List of customers belonging to company. Customers must exist already in Norce Commerce to be added as a relation to this Company. Any identifier can be used and they are ordered as Id, Code, EmailAddress. The first that is given will be used.
List of delivery addresses
List of delivery methods applicable to company
List of company discounts
Contact email address
List of company flags
Norce Commerce's internal company id
Company or customer address information
Sets company to active or inactive. Default is true.
If false customers that are not provided for this company in request will be deactivated from the relation to this Company. Default is false.
Image information
Company name
Organization number. Used for company matching if Norce Commerce's internal company id and company code are omitted and SearchOnlyByCode is false in header.
Can be used for setting parent company (if exists)
List of company payment methods
Contact phone number
List of company price lists
Vat Number
Use in conjunction with an invoice address to set the delivery address to the same as the invoice address. Both must be active for the import.
CompanyIdentifier
Company identifier when matching company. Used to match companies to customers. The first found identifier will be used. At least one must be provided.
Company code. Used for company matching if Norce Storm company id is omitted.
Norce [Storm]'s internal company id
Sets company as primary for the customer. Default is false.
Company name
Organization number. Used for company matching if Norce [Storm]'s internal company id and company code are omitted and SearchOnlyByCode is false in header.
Contact
Company contact information
Contact code. Used for contact matching.
Sets contact to active or inactive. Default true.
Customer
Customer information
List of registered customer accounts
List of additional information fields
Application identifier. Determines which application company belongs to.
Mobile phone number
Customer code. Used for customer matching if Norce Commerce's internal customer id is omitted.
List of companies belonging to this customer. Companies must exist already in Norce Commerce to be added as a relation to this Customer. Any identifier can be used and they are ordered as Id, Code, OrganizationNo. The first that is given will be used. If more than one is marked IsPrimary then only the first will be marked as primary.
Used to save the customer external id from a crm-system
Delivery address
Customer email address. Used for customer matching if Norce Commerce customer id and code is omitted and SearchOnlyByCode is false in header.
First name
Customer flags
Norce Commerce's internal customer id
Company or customer address information
Sets customer to active or inactive. Default is true.
If false companies that are not provided for this customer in request will be deactivated from the relation to this Company. Default is false.
Last name
Middle name
Phone number
Customer price lists
Social security number
Title
Customer type: 1 = Customer, 2 = Company contact
CustomerHeader
Import meta information
Account which initiated the import. Learn about system accounts <a href='/connectintegration/#using-system-accounts'>here</a>.
Array of strings representing company fields to be processed.<br/>(Use the integer instead of the name for the xml content type)<br/>Not required for ImportCustomers<br/><br/>0 = ApplicationKey<br>1 = Id<br>2 = Code<br>3 = OrganizationNo<br>4 = Name<br>5 = EmailAddress<br>6 = PhoneNumber<br>7 = LogoImage<br>8 = ParentCompanyCode<br>9 = IsActive<br>10 = InvoiceAddress<br>11 = DeliveryAddresses<br>12 = AdditionalInfo<br>13 = Contacts<br>14 = Customers (set values in CustomerFieldsThatAreSet)<br>15 = DeliveryMethods<br>16 = Discounts<br>17 = Flags<br>18 = PaymentMethods<br>19 = PriceLists<br>20 = SearchOnlyByCode (matches the customer only on the value on the code field, allows for duplicated OrganizationNo)<br>21 = VatNo<br>22 = PreserveFlags (Flags not passed in, will be left on the entity, otherwise they will be removed and replaced with the ones imported)
Array of strings representing customer fields to be processed.<br/>(Use the integer instead of the name for the xml content type)<br/>Not required for ImportCompanies, but if used there, 'Customers' must be set in CompanyFieldsThatAreSet<br/><br/>0 = ApplicationKey<br>1 = Id<br>2 = Code<br>3 = EmailAddress<br>4 = SocialSecurityNumber<br>5 = Title<br>6 = FirstName<br>7 = MiddleName<br>8 = LastName<br>9 = PhoneNumber<br>10 = CellPhoneNumber<br>11 = IsActive<br>12 = InvoiceAddress<br>13 = DeliveryAddresses<br>14 = Accounts (set values in AccountFieldsThatAreSet)<br>15 = AdditionalInfo<br>16 = Flags<br>17 = PriceLists<br>18 = SearchOnlyByCode (matches the customer only on the value on the code field, alows for duplicated email addresses)<br>19 = Companies (set values in CompanyFieldsThatAreSet)<br>20 = CrmId<br>21 = PreserveFlags (Flags not passed in, will be left on the entity, otherwise they will be removed and replaced with the ones imported)
Array of strings representing account fields to be processed.<br/>(Use the integer instead of the name for the xml content type)<br/>Not required for ImportCompanies<br/>Required settings: Accounts (in CustomerFieldsThatAreSet)<br/><br/>0 = PasswordCreateOnly (Value is only set if the entity is created by the import)<br>1 = Status<br>2 = StatusCreateOnly (Value is only set if the entity is created by the import)<br>3 = Roles<br>4 = RolesCreateOnly (Value is only set if the entity is created by the import)
Norce Commerce Connect job id. Only exists in import logs. Should be omitted in the import request.
Request serialization type.(Use the integer instead of the name for the xml content type)<br/><br/>0 = JSON, 1 = XML
Location of the import file on Norce's file area. Can be used instead of sending data directly in payload.
Derived from base header. Ignored in this import.
DeliveryMethod
Company delivery method information
Delivery method code
Sets delivery method to active or inactive. Default is true.
Discount
Discount rules applied to a specific company
Value of the discount (in percent)
Comma separated list of price list types
Type of discount: 1 = Category, 2 = Product Discount Class, 3 = Product Flag
Value code, for Category type this is the category code. For Discount class its the class identifier used in Norce Commerce.
Flag
Company flag
Flag code. Used for flag matching.
Sets flag to active or inactive. Default is true.
If true, data is only saved if flag record is new. Default is false.
If true, data is only saved if flag record is new or last updated by the same account as the one initiating the update. Default is false.
Sets the stop date explicitly for inactivated flags. Time of process is used as default.
Image
Image information
Code for image matching
File type. Should match file info set up in Norce Commerce, e.g. MainImage, Additional, Embedded.
URL where image should be taken from
Image file name. If omitted will be parsed form URL.
Time when image was changed. Should be set to synchronize image updates.
Info
Additional information field
Information field code. Used for info matching.
Value to set
PaymentMethod
Payment method applied to company
Payment method code. Used for payment method matching.
Used for specifying the invoice capture setting to use.
Sets payment method relation to active or inactive. Default true.
PriceList
Customer or company specific price list
Price list code. Used for price list matching.
Determines if price list is exclusive, an exclusive price list overrides best price calculation in Norce Commerce Shopping API.