# Import products

Use this to import whole product catalogs. To create products manufacturer code, manufacturer part no and your SKU part no is required. However, for updates either manufacturer code and manufacturer part no or SKU part no is needed. If Code is set in ProductFieldsThatAreSet it is mandatory for variant cluster creation and update, but otherwise it can be inferred from existing data. However, if fullfile is true code is mandatory as well to enable variant cluster management.Only one price record is allowed per product. Use ImportSkuPriceList to add more prices. To import availability data use ImportOnhands.Read more about the method here.

Endpoint: POST /Product/ImportProducts
Version: 4.0

## Header parameters:

  - `X-StormConnect-Header` (string, required)
    Json serialized string

## Request fields (application/json):

  - `Code` (string)
    Product code. Used for product cluster matching in Norce Commerce.

  - `ManufacturerCode` (string)
    Manufacturer code. Required when creating products or as part of identifier of a product combined with ManufacturerPartNo on variant.

  - `AdditionalImages` (array)
    List of additional product images.

  - `AdditionalImages.ExternalCode` (string, required)
    External identifier for image matching.

  - `AdditionalImages.FileTypeName` (string, required)
    File type code. Should match file info set up in Norce Commerce, e.g. "MainImage", "Additional", "Embedded".

  - `AdditionalImages.Url` (string, required)
    Url to where the image is located. Must be a publically accessible endpoint.

  - `AdditionalImages.FileName` (string)
    Image file name. If omitted it will be parsed from the url. Max length: 50

  - `AdditionalImages.LastModified` (string)
    Time when image was last updated. Deprecated.

  - `AdditionalImages.Cultures` (array)
    Localized values for image.

  - `AdditionalImages.Cultures.CultureCode` (string, required)
    Culture code, e.g. "sv-SE".

  - `AdditionalImages.Cultures.Name` (string)
    Localized name of the image.

  - `AdditionalImages.Cultures.Description` (string)
    Localized description of the image.

  - `AdditionalImages.Cultures.AltText` (string)
    Localized alt text for the image.

  - `Alias` (string)
    Product alias.

  - `AssortmentCode` (string)
    Product assortment code. If set, assortment with this code will be associated to product.

  - `Categories` (array)
    List of categories product shall be placed in.

  - `Categories.Code` (string, required)
    Category code. Used for category matching in Norce Commerce.

  - `Categories.SortOrder` (integer)
    Determines in which order this category shall be applied to product. Use sort order 1 for primary category.

  - `Cultures` (array)
    List of translated product information fields.

  - `Cultures.CultureCode` (string, required)
    Culture code, e.g. "en-GB". Required to import cultures.

  - `Cultures.Description` (string)
    Translated product description.

  - `Cultures.DescriptionHeader` (string)
    Translated product description header. Max length: 255

  - `Cultures.IsUniqueUrlNameManuallyMaintained` (boolean)
    Determines if UniqueUrlName is manually maintained.

  - `Cultures.MetaDescription` (string)
    Translated product meta description.

  - `Cultures.MetaTags` (string)
    Translated product meta tags.

  - `Cultures.Name` (string)
    Translated product name. Max length: 255

  - `Cultures.SubDescription` (string)
    Translated additional product description.

  - `Cultures.SubHeader` (string)
    Translated additional product header. Max length: 255

  - `Cultures.Synonyms` (string)
    Translated product synonymous names. Max length: 500

  - `Cultures.Tags` (string)
    Translated product tags.

  - `Cultures.Title` (string)
    Translated product title. Max length: 255

  - `Cultures.UniqueUrlName` (string)
    Language specific unique prodct url name, called 'Unique url' in administration gui.

  - `Family` (object)
    Product family information. Families that can not be matched will not be created but give a warning in the logs.

  - `Family.Code` (string, required)
    Externally defined product family code. Used for product family matching in Norce Commerce.

  - `Family.Name` (string)
    Product family name.

  - `MainImage` (object)
    Product image information.

  - `ManufacturerName` (string)
    Manufacturer name. If manufacturer doesn't exist this field is required to create a new manufacturer.

  - `ProductFlags` (array)
    List of flags applied to product.

  - `ProductFlags.Code` (string, required)
    Product flag code. Used for product flag matching in Norce Commerce.

  - `ProductFlags.IsSet` (boolean, required)
    Determines if a product flag is to be set or unset.

  - `ProductFlags.IsCreateOnly` (boolean)
    If true, data is only saved if flag record is new. Default: false.

  - `ProductFlags.IsLimitedUpdate` (boolean)
    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: false

  - `ProductFlags.StopDate` (string)
    Shows when flag was disabled for product.

  - `ProductParametrics` (array)
    List of parametrics applied to product.

  - `ProductParametrics.ParametricCode` (string, required)
    External parametric code configured in Norce Commerce. Used to match parameter.

  - `ProductParametrics.Cultures` (array)
    List of parametric translations.

  - `ProductParametrics.Cultures.ValueText` (string, required)
    Translated text parametric value. Max length 255 chars for text-values, unlimited for HTML-values.

  - `ProductParametrics.MultipleValueList` (array)
    List of possible values to set for parametrics with multiple value choice.

  - `ProductParametrics.MultipleValueList.Code` (string, required)
    Parametric value code. Use for parametric value matching in Norce Commerce.

  - `ProductParametrics.MultipleValueList.Value` (string, required)
    Value to set

  - `ProductParametrics.MultipleValueList.Description` (string)
    Description of the value

  - `ProductParametrics.MultipleValueList.Cultures` (array)
    Array with localized versions of value and description

  - `ProductParametrics.MultipleValueList.Cultures.CultureCode` (string, required)
    Culture code for this value

  - `ProductParametrics.MultipleValueList.Cultures.Value` (string)
    Localized value

  - `ProductParametrics.MultipleValueList.Cultures.Description` (string)
    Localized description

  - `ProductParametrics.ValueBoolean` (boolean)
    Boolean value to set.

  - `ProductParametrics.ValueDateTime` (string)
    Date/time value to set.

  - `ProductParametrics.ValueDecimal` (number)
    Decimal value to set.

  - `ProductParametrics.ValueInteger` (integer)
    Integer value to set.

  - `ProductParametrics.ValueList` (object)
    Parametric value for list of choices.

  - `VariantDefinitionGroup` (object)
    Variant definition information.

  - `VariantDefinitionGroup.Code` (string, required)
    Variant definition group code.

  - `VariantDefinitionGroup.Name` (string)
    Variant definition group name.

  - `VariantDefinitionGroup.Types` (array)
    List of variant definition types.

  - `VariantDefinitionGroup.Types.Code` (string, required)
    Variant definition type code. Used for variant type matching in Norce Commerce.

  - `VariantDefinitionGroup.Types.Name` (string)
    Type name.

  - `VariantDefinitionGroup.Types.ParametricCode` (string)
    Variant definition type parametric code.

  - `VariantDefinitionGroup.Types.SortOrder` (integer)
    Sort order.

  - `Variants` (array)
    List of product variants.

  - `Variants.ManufacturerPartNo` (string, required)
    Manufacturer part number. Required when creating products or in combination with ManufacturerCode as identifier of a specific product.

  - `Variants.AdditionalImages` (array)
    List of additional images.

  - `Variants.Cultures` (array)
    List of translated variant information fields.

  - `Variants.Cultures.CultureCode` (string, required)
    Culture code, e.g. "en-GB". Required when working with variant culture information.

  - `Variants.Cultures.Description` (string)
    Translated variant description.

  - `Variants.Cultures.DescriptionHeader` (string)
    Translated variant description header. Max length: 255

  - `Variants.Cultures.MetaDescription` (string)
    Translated variant meta description.

  - `Variants.Cultures.MetaTags` (string)
    Translated variant meta tags.

  - `Variants.Cultures.Name` (string)
    Translated variant name.

  - `Variants.Cultures.SubDescription` (string)
    Translated additional variant description.

  - `Variants.Cultures.SubHeader` (string)
    Translated additional variant header. Max length: 255

  - `Variants.Cultures.Synonyms` (string)
    Translated variant synonymous names. Max length: 500

  - `Variants.Cultures.Tags` (string)
    Translated variant tags.

  - `Variants.Cultures.Title` (string)
    Translated variant title. Max length: 255

  - `Variants.Cultures.UniqueUrlName` (string)
    Unique URL

  - `Variants.DeliveryMethods` (array)
    List of delivery methods applicable to variant. Use this to restrict which delivery methods that is allowed on the product.

  - `Variants.DeliveryMethods.Code` (string, required)
    Delivery method code. Used for delivery method matching in Norce Commerce.

  - `Variants.DeliveryMethods.IsActive` (boolean)
    Sets product delivery method to active or inactive. Default true.

  - `Variants.DeliveryMethods.PackagePercentage` (number)
    Package percentage.

  - `Variants.IsDagerousGoods` (boolean)
    Determines if a variant is dangerous goods.

  - `Variants.NonParametricVariantDefinitions` (array)
    List of variant definitions.

  - `Variants.NonParametricVariantDefinitions.TypeCode` (string, required)
    Variant type code. Used for variant type matching in Norce Commerce.

  - `Variants.NonParametricVariantDefinitions.Cultures` (array)
    List of translated variant definitions.

  - `Variants.NonParametricVariantDefinitions.Cultures.CultureCode` (string, required)
    Culture code, e.g. "en-GB"

  - `Variants.NonParametricVariantDefinitions.Cultures.Value` (string, required)
    Translated definition value.

  - `Variants.Skus` (array)
    List of SKUs associated to variant.NOTE: Only one SKU is allowed, multiple SKUs creation for the same product is deprecated, use variantization instead.

  - `Variants.Skus.PartNo` (string, required)
    SKU part no. Required when creating new products with SKUs or as identifier of existing SKUs.

  - `Variants.Skus.ActualWeight` (number)
    SKU weight. If null is imported will be set to inherit from category.

  - `Variants.Skus.CommodityCode` (string)
    Commodity code.

  - `Variants.Skus.Cultures` (array)
    List of SKU information translations.

  - `Variants.Skus.Cultures.CultureCode` (string, required)
    Culture code, e.g. "en-GB". Required when importing SKU cultures.

  - `Variants.Skus.Cultures.Comment` (string)
    Translated comment.

  - `Variants.Skus.Cultures.ErpName` (string)
    Translated ERP name.

  - `Variants.Skus.DiscountClass` (string)
    Discount class.

  - `Variants.Skus.EanCode` (string)
    EAN code, or GS1 code.

  - `Variants.Skus.IntegrationPartNo` (string)
    The replaceable sku in other systems than Norce Commerce. Used when Norce Commerce has SKU's other systems does not recognize and the integration partno is sent instead.

  - `Variants.Skus.IsBuyable` (boolean)
    Determines if SKU can be bought.

  - `Variants.Skus.IsDropShipOnly` (boolean)
    Determines if SKU can only be sold using drop shipment.

  - `Variants.Skus.IsRecommendedSalesQtyFixed` (boolean)
    Determines if recommended sales quantity is fixed.

  - `Variants.Skus.LogisticDepth` (number)
    SKU depth

  - `Variants.Skus.LogisticHeight` (number)
    SKU height

  - `Variants.Skus.LogisticWidth` (number)
    SKU width

  - `Variants.Skus.RecommendedSalesQty` (number)
    Recommended sales quantity

  - `Variants.Skus.StandardPrice` (object)
    SKU price information. Send to Norce Commerce the price information that should be updated. Use the header fields to control what is updated. Any values that are null or 0 will be ignored (not overwrite current value in Norce), but if the field (e.g. PriceSale) is listed in IgnoreSkuPriceListFieldsWhenEmpty will cause the entire price entity to be ignored.

  - `Variants.Skus.StandardPrice.PartNo` (string, required)
    SKU part number.

  - `Variants.Skus.StandardPrice.PriceListCode` (string, required)
    Agreement code on the price list. Used for matching in Norce Commerce.

  - `Variants.Skus.StandardPrice.CostPurchase` (number)
    Purchase cost from supplier.

  - `Variants.Skus.StandardPrice.CostUnit` (number)
    Unit cost.

  - `Variants.Skus.StandardPrice.CurrencyCode` (string)
    Currency code in ISO 4217 format, e.g. "SEK", "EUR", "USD".

  - `Variants.Skus.StandardPrice.IsActive` (boolean)
    Sets SKU price to active or inactive.

  - `Variants.Skus.StandardPrice.IsPriceDiscountable` (boolean)
    Determines if discounts can be applied to the price.

  - `Variants.Skus.StandardPrice.PriceCatalog` (number)
    Catalog price.

  - `Variants.Skus.StandardPrice.PricePrevious` (number)
    Previous price. Can be used to show discounts.

  - `Variants.Skus.StandardPrice.PriceRecommended` (number)
    Recommended sale price.

  - `Variants.Skus.StandardPrice.PriceRule` (integer)
    Price rule for this SKU.1 = CostPlus_PurchaseCost2 = FixedPrice3 = Margin_PurchaseCost4 = UseRecommendedPrice5 = CostPlus_UnitCost6 = Margin_UnitCost7 = UseStandardPrice_PctDiscount8 = Competitive_PurchaseCost9 = Competitive_UnitCost10 = UseStandardPrice_FixedDiscount11 = StructureCalculation12 = UseCatalogPrice

  - `Variants.Skus.StandardPrice.PriceRuleValue` (number)
    Value to apply for selected Price Rule.

  - `Variants.Skus.StandardPrice.PriceSale` (number)
    Sale price.

  - `Variants.Skus.StandardPrice.QuantityBreak` (integer)
    Threshold which determines minimum quantity of items required for specified price list to be applied.

  - `Variants.Skus.StartDate` (string)
    SKU activation time.

  - `Variants.Skus.Status` (integer)
    SKU status. Required when creating new SKUs.1 = Active2 = Coming3 = Expiring4 = Hidden5 = Inactive6 = NotActivated

  - `Variants.Skus.StopDate` (string)
    SKU deactivation time.

  - `Variants.Skus.StructureItems` (array)
    List of items included in SKU structure.

  - `Variants.Skus.StructureItems.PartNo` (string, required)
    Part number of item to add to structure.

  - `Variants.Skus.StructureItems.Quantity` (number, required)
    Quantity of items included in structure.

  - `Variants.Skus.StructureItems.StructurePartNo` (string, required)
    Structure item part number, the parent package part number.

  - `Variants.Skus.StructureItems.AdditionalInfo` (array)
    List of additional 3rd party information fields.

  - `Variants.Skus.StructureItems.AdditionalInfo.Code` (string, required)
    External code for additional information field to be matched in Norce Commerce.

  - `Variants.Skus.StructureItems.AdditionalInfo.Value` (string, required)
    Value to be set or updated on the information field.

  - `Variants.Skus.StructureItems.SortOrder` (integer)
    Item sort order in structure.

  - `Variants.Skus.StructureItems.StandardStructureItemPrice` (object)
    Structure item price list information.

  - `Variants.Skus.StructureItems.StandardStructureItemPrice.ItemPriceListCode` (string, required)
    Structure item price list code. Used for price list matching in Norce Commerce.

  - `Variants.Skus.StructureItems.StandardStructureItemPrice.PartNo` (string, required)
    This item part number.

  - `Variants.Skus.StructureItems.StandardStructureItemPrice.PriceListCode` (string, required)
    Structure price list code (parent). Used for price list matching in Norce Commerce.

  - `Variants.Skus.StructureItems.StandardStructureItemPrice.PriceSale` (number, required)
    Structure item sale price

  - `Variants.Skus.StructureItems.StandardStructureItemPrice.QuantityBreak` (integer)
    Minimum quantity required for a price rule to be applied.

  - `Variants.Skus.TrackingCode` (string)
    Tracking code.

  - `Variants.Skus.Type` (integer)
    SKU type. Required when creating new SKUs.1 = ErpStandard2 = ErpRefurbished3 = Freight4 = Insurance8 = Structure9 = Invoice11 = Service14 = Standard15 = ErpExtended16 = ErpStandardNoStock17 = ErpPackage19 = ErpTempOutOfStock20 = EnvironmentalFee21 = PackingFee24 = ErpPackageWithCalc25 = DisplayOnly29 = ErpStandard233 = License

  - `Variants.Skus.UnitOfMeasurementCount` (number)
    Number of units in the specified type.

  - `Variants.Skus.UnitOfMeasurementType` (integer)
    Unit of measurement type.1 = Pieces2 = Hour3 = Kilogram4 = Litre5 = Pair6 = SquareMeter7 = Meter

  - `Variants.Skus.VatRates` (array)
    List of VAT rates applicable for SKU.

  - `Variants.Skus.VatRates.Rate` (number)
    VAT rate

  - `Variants.Skus.VatRates.SalesArea` (integer, required)
    Sales area identifier.1 = Sweden2 = Norway3 = Denmark4 = Finland5 = UnitedKingdom6 = Estonia7 = Greenland8 = Germany9 = Italy10 = Austria11 = Spain12 = Netherlands13 = Belgium14 = France15 = Switzerland17 = USA18 = Ireland19 = Canada20 = Lithuania21 = Latvia22 = Japan23 = SouthKorea24 = Australia25 = Europe26 = Poland27 = CzechRepublic28 = Russia29 = NoVAT36 = Bulgaria37 = Croatia38 = Cyprus39 = Greece40 = Hungary41 = Luxembourg42 = Malta43 = Portugal44 = Romania45 = Slovakia46 = Slovenia

  - `Variants.Skus.VolumeWeight` (number)
    Deprecated. If required add as parameter instead.

  - `Variants.SortOrderValue` (integer)
    Sort order of variant among all the variants.

  - `Variants.StockDisplayBreakPoint` (array)
    Stock display break point. Can be used to change the stock value that is displayed.

  - `Variants.TranslationRequested` (string)
    Set to the point in time the translation was requested or null to reset.

  - `Variants.VariantFlags` (array)
    List of flags applied to variant.

  - `Variants.VariantParametrics` (array)
    List of parametrics applied to variant.

## Response 200 fields (application/json):

  - `StatusCode` (string)
    Status of the job

  - `Description` (string)
    Short message describing the job

  - `JobId` (string)
    Norce interal id created for this job. Refer to this for future requests.

  - `ValidationSummary` (object)
    Validation data for accepted payload

  - `ValidationSummary.NrOfItemsInTotal` (integer)
    Total number of items in payload.

  - `ValidationSummary.NrOfValidationFailures` (integer)
    Number of items that failed initial validation.

  - `ValidationSummary.Messages` (array)
    Messages concerning the validation.