Connect Supplier schemas

Import of supplier product data. Product content import (e.g. contentlist, images, parametrics) via Supplier will soon be deprecated.

Entities

Image

ExternalCode required	string Must match code from Administration setting in Norce Commerce.
FileTypeName required	string File type. Should match file info set up in Norce Commerce, e.g. "MainImage", "Additional", "Embedded".
Url required	string <uri> Ulr to image that is accessible for Norce Commerce Connect for upload to the CDN.
Filename	string Image file name. If omitted will be parsed from the url.
LastModified	string <DateTime> Deprecated

Parametric

ParametricCode required	string Must be set to the specific code the parameter has in Norce Commerce. Max length: 50
	Array of objects <ParametricMultipleCodeValuePair> (ParametricMultipleCodeValuePair) If parameter is of type multiple list this field is used and all other fields are ignored.
ValueBoolean	boolean If parameter is of type boolean this field is used and all other fields are ignored.
ValueCode	string If parameter is of type list this field is used and all other fields are ignored. Max length: 255
ValueDateTime	string <DateTime> If parameter is of type datetime this field is used and all other fields are ignored.
ValueDecimal	number If parameter is of type decimal this field is used and all other fields are ignored.
ValueInt	integer <int32> If parameter is of type integer this field is used and all other fields are ignored.
ValueText	string This value field is preferred for supplier integrations. If parameter is of type text value this field is used and all other fields are ignored. Max length: 255

ParametricMultipleCodeValuePair

Code required	string Parametric selection value code. Used for matching in Norce Commerce. Max length: 255
Value required	string Value for selection. Max length: 255

ProductCulture

CultureCode required	string ISO language codes, e.g. "sv-SE".
Description	string Article description.
DescriptionHeader	string Article description header. Max length: 255
IsUniqueUrlNameManuallyMaintained	boolean Determines if UniqueUrlName is manually maintained.
MetaDescription	string Aricle meta descriptions.
MetaTags	string Article meta tags.
Name	string Article name. Max length: 255
SubDescription	string Article additional description.
SubHeader	string Article additional header. Max length: 255
Synonyms	string List of words used in search. Max length: 500
Tags	string Article tags.
Title	string Article title. Max length: 255
UniqueUrlName	string Used for bread crumbs, if provided and enabled in Admin GUI, it will override Norce Commerce automation tool.

SupplierOnHand

LocationCode required	string Name of location, must match supplier location name configured in Norce Commerce. Max length: 50
WarehouseCode required	string Name of Warehouse, must match supplier warehouse name configured in Norce Commerce. Max length: 50
ExternalStockValue	number Stock value for external display.
IncomingValue	number Quantity of items currently inbound to warehouse.
IsActive	boolean Sets on hand information to active or inactive. Defaults to true.
IsReturnable	boolean Determines if article is returnable.
LeadTimeDayCount	integer <int32> Indication of time for delivery from warehouse to client.
MinimumOrderValue	number Minimum quantity of items on a purchase order, default is 1.
Name	string Storage site name, for presentation only. Max length: 255
NextDeliveryDate	string <DateTime> Expected next delivery date for incoming stock.
PackageValue	number Quantity of items in a package, default is 1.
StoppedDate	string <DateTime> Date when on hand information was deactivated.
Value required	number Onhand value

SupplierPrice

PriceListCode required	string Must match code from the supplier price list in Norce Commerce. Max length: 50
CostFee	number Cost fee
CostPurchase	number Supplier sale price
CostPurchaseValidTo	string <DateTime> Valid to date for price information.
CurrencyCode	string Currency Code, in ISO 4217 format. For example "SEK", "EUR", "USD", default is currency on configured sales area in Norce Commerce. Max length: 3
DiscountPct	number Discount
FreightCost	number Freight cost.
IsActive	boolean Sets price to active or inactive. Defaults to true.
IsFocus	boolean Is focus.
IsPromotion	boolean True if price information is based on temporary campaign.
PriceCatalog	number Catalog price.
PriceDealer	number Dealer price.
PriceMax	number Max price for end customer.
PriceRanking	integer <int32> Price ranking.
PriceRecommended	number Recommended price for end customer.
QtyBreak	integer <int32> Quantity of items required for price, default is 1. This is used for discounts for large orders.

SupplierProduct

SupplierPartNo required	string Supplier article number. Max length: 50
CategoryCode	string Name or code of the category, ideally this something readable, like "Utensils" or with a hierachy "Kitchen\|Utensils". Max length: 255
CommodityCode	string A classification of goods for import and export between countries. Max length: 50
	Array of objects <ProductCulture> (ProductCulture) List of culture specific texts on article.
EanCode	string Bar code. Max length: 50
GrossWeight	number Actual weight including package etc.
	Array of objects <Image> (Image) Additional images, use high definition. Norce Commerce will provide real-time resizing when used in Norce Commerce Services and Norce Administration GUI.
LogisticDepth	number Logistic depth.
LogisticHeight	number Logistic height
LogisticWidth	number Logistic width
	object <Image> (Image) Represents an image that should be uploaded to Norce Commerce from the supplier regarding the specified article. The type and code must be set up in Norce Commerce Administration settings.
Manufacturer	string Manufacturer code or name, required together with ManufacturerPartNo to be unique. Max length: 50
ManufacturerPartNo	string Manufacturer article number, required together with Manufacturer to be unique. Max length: 50
NetWeight	number Obsolete. Weight of item, without packaging.
	Array of objects <SupplierOnHand> (SupplierOnHand) Stock values, at least one is required.
	Array of objects <Parametric> (Parametric) List of supplier specific content attributes, like color or size.
	Array of objects <SupplierPrice> (SupplierPrice) Purchase cost and other price information. At least one is required.
	Array of objects <SupplierProductInfo> (SupplierProductInfo) List of supplier specific setting attributes. This is article specific information needed for supplier integrations, but will not be shown as content. For example "OnlySoldInSweden".
ProductName	string Name of the article in default language. Max length: 500
ProductType	string Product type.
UnitOfMeasurementCode	integer <int32> Unit of measurement code for item: 0 = Unknown, 1 = Pieces, 2 = Hours, 3 = Kilograms, 4 = Litres. Default is pieces.
UnitOfMeasurementCount	integer <int32> Number of units in the package.
VatCode	integer <int32> Vat rate in percent

SupplierProductHeader

AccountId required	integer <int32> Account which initiated the import. Learn about system accounts here.
FieldsThatAreSet required	Array of strings Specifies which product fields to be updated. (Use the integer instead of the name for the xml content type) 0 = SupplierPartNo 1 = ProductName 2 = CategoryCode 3 = ProductType 4 = Manufacturer 5 = ManufacturerPartNo 6 = EanCode 7 = CommodityCode 8 = GrossWeight 9 = NetWeight 10 = UnitOfMeasurementCode 11 = UnitOfMeasurementCount 12 = VatCode 13 = LogisticWidth 14 = LogisticHeight 15 = LogisticDepth Items Enum: "SupplierPartNo" "ProductName" "CategoryCode" "ProductType" "Manufacturer" "ManufacturerPartNo" "EanCode" "CommodityCode" "GrossWeight" "NetWeight" "UnitOfMeasurementCode" "UnitOfMeasurementCount" "VatCode" "LogisticWidth" "LogisticHeight" "LogisticDepth"
FullFile required	boolean Flag that specified how Norce Commerce Connect will handle the import. If true, all articles not in this feed will be handled as deleted and are deactivated in Norce. If false, the import will be handled as an update only on the articles in the feed, other articles will not be changed.
ContentFieldsThatAreSet	Array of strings Specifies which product culture fields to be updated. (Use the integer instead of the name for the xml content type) 0 = Name 1 = NameCreateOnly (Value is only set if the entity is created by the import) 2 = SubHeader 3 = SubDescription 4 = DescriptionHeader 5 = Description 6 = DescriptionCreateOnly (Value is only set if the entity is created by the import) 7 = Synonyms 8 = Title 9 = Tags 10 = MetaTags 11 = MetaDescription 12 = NameLimitedUpdate (If name is manually changed in the Admin UI, import is ignored) 13 = UniqueUrlName 14 = IsUniqueUrlNameManuallyMaintained 15 = UniqueUrlNameCreateOnly (Value is only set if the entity is created by the import) Items Enum: "Name" "NameCreateOnly" "SubHeader" "SubDescription" "DescriptionHeader" "Description" "DescriptionCreateOnly" "Synonyms" "Title" "Tags" "MetaTags" "MetaDescription" "NameLimitedUpdate" "UniqueUrlName" "IsUniqueUrlNameManuallyMaintained" "UniqueUrlNameCreateOnly"
JobId	string Norce Commerce Connect job id. Only exists in import logs. Should be omitted in the import request.
OnhandFieldsThatAreSet	Array of strings Specifies which on hand fields to be updated. (Use the integer instead of the name for the xml content type) 0 = Value 1 = IncomingValue 2 = NextDeliveryDate 3 = StoppedDate 4 = IsReturnable 5 = LeadTimeDayCount 6 = ExternalStockValue 7 = PackageValue 8 = MinimumOrderValue 9 = IsActive Items Enum: "Value" "IncomingValue" "NextDeliveryDate" "StoppedDate" "IsReturnable" "LeadTimeDayCount" "ExternalStockValue" "PackageValue" "MinimumOrderValue" "IsActive"
PriceFieldsThatAreSet	Array of strings Specifies which price fields to be updated. (Use the integer instead of the name for the xml content type) 0 = CostPurchase 1 = CostPurchaseValidTo 2 = PriceRecommended 3 = PriceMax 4 = PriceDealer 5 = IsPromotion 6 = IsFocus 7 = PriceRanking 8 = FreightCost 9 = CostFee 10 = DiscountPct 11 = IsActive 12 = PriceCatalog Items Enum: "CostPurchase" "CostPurchaseValidTo" "PriceRecommended" "PriceMax" "PriceDealer" "IsPromotion" "IsFocus" "PriceRanking" "FreightCost" "CostFee" "DiscountPct" "IsActive" "PriceCatalog"
ProductInfoFieldsThatAreSet	Array of strings Specifies which product info fields to be updated. (Use the integer instead of the name for the xml content type) 0 = Value Items Value: "Value"
SerializationType	Array 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"
StorageName	string <uri> Location of the import file on Norce's file area. Can be used instead of sending data directly in payload.
SupplierId required	integer <int32> Norce Commerce's internal Supplier identifier.

SupplierProductInfo

Code required	string Information field code. Max length: 50
Value required	string Value to set. Max length: 255