COMMERCE CONNECT
/
Supplier Service
/
Product
/
Import supplier products.

Documentation Norce Commerce Connect Supplier Service (4.0)

The Supplier Service has Entities and Operations to create and update supplier products and content in Norce Commerce.

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

Product

Operations

Import supplier products.

Request

Use this to import whole supplier product catalogs with their prices (costs) and availability (onhand).
Read more about the method here.

Headers
X-StormConnect-Headerstringrequired

JSON or XML serialized string of the SupplierProductHeader object.
Note that the enums must be of integer values when using application/xml encoding and can be both string or integer for application/json.

Body
required

List of supplier products to import.

Array [
SupplierPartNostringrequired

Supplier article number. Max length: 50

CategoryCodestring

Name or code of the category, ideally this something readable, like "Utensils" or with a hierachy "Kitchen|Utensils". Max length: 255

CommodityCodestring

A classification of goods for import and export between countries. Max length: 50

ContentListArray of objects(ProductCulture)(ProductCulture)

List of culture specific texts on article.

EanCodestring

Bar code. Max length: 50

GrossWeightnumber

Actual weight including package etc.

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

LogisticDepthnumber

Logistic depth.

LogisticHeightnumber

Logistic height

LogisticWidthnumber

Logistic width

MainImageobject(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.

Manufacturerstring

Manufacturer code or name, required together with ManufacturerPartNo to be unique. Max length: 50

ManufacturerPartNostring

Manufacturer article number, required together with Manufacturer to be unique. Max length: 50

NetWeightnumber

Obsolete. Weight of item, without packaging.

OnHandArray of objects(SupplierOnHand)(SupplierOnHand)

Stock values, at least one is required.

ParametricsArray of objects(Parametric)(Parametric)

List of supplier specific content attributes, like color or size.

PriceListArray of objects(SupplierPrice)(SupplierPrice)

Purchase cost and other price information. At least one is required.

ProductInfoArray 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".

ProductNamestring

Name of the article in default language. Max length: 500

ProductTypestring

Product type.

UnitOfMeasurementCodeinteger(int32)

Unit of measurement code for item: 0 = Unknown, 1 = Pieces, 2 = Hours, 3 = Kilograms, 4 = Litres. Default is pieces.

UnitOfMeasurementCountinteger(int32)

Number of units in the package.

VatCodeinteger(int32)

Vat rate in percent

]
curl -i -X POST \
  https://customer-slug.api-se.norce.tech/commerce/connect/4.0/Supplier/ImportProducts \
  -H 'Content-Type: application/json' \
  -H 'X-StormConnect-Header: string' \
  -d '[
    {
      "SupplierPartNo": "string",
      "CategoryCode": "string",
      "CommodityCode": "string",
      "ContentList": [
        {
          "CultureCode": "string",
          "Description": "string",
          "DescriptionHeader": "string",
          "IsUniqueUrlNameManuallyMaintained": true,
          "MetaDescription": "string",
          "MetaTags": "string",
          "Name": "string",
          "SubDescription": "string",
          "SubHeader": "string",
          "Synonyms": "string",
          "Tags": "string",
          "Title": "string",
          "UniqueUrlName": "string"
        }
      ],
      "EanCode": "string",
      "GrossWeight": 0,
      "Images": [
        {
          "ExternalCode": "string",
          "FileTypeName": "string",
          "Url": "http://example.com",
          "Filename": "string",
          "LastModified": "string"
        }
      ],
      "LogisticDepth": 0,
      "LogisticHeight": 0,
      "LogisticWidth": 0,
      "MainImage": {
        "ExternalCode": "string",
        "FileTypeName": "string",
        "Url": "http://example.com",
        "Filename": "string",
        "LastModified": "string"
      },
      "Manufacturer": "string",
      "ManufacturerPartNo": "string",
      "NetWeight": 0,
      "OnHand": [
        {
          "LocationCode": "string",
          "WarehouseCode": "string",
          "ExternalStockValue": 0,
          "IncomingValue": 0,
          "IsActive": true,
          "IsReturnable": true,
          "LeadTimeDayCount": 0,
          "MinimumOrderValue": 0,
          "Name": "string",
          "NextDeliveryDate": "string",
          "PackageValue": 0,
          "StoppedDate": "string",
          "Value": 0
        }
      ],
      "Parametrics": [
        {
          "ParametricCode": "string",
          "MultipleValues": [
            {
              "Code": "string",
              "Value": "string"
            }
          ],
          "ValueBoolean": true,
          "ValueCode": "string",
          "ValueDateTime": "string",
          "ValueDecimal": 0,
          "ValueInt": 0,
          "ValueText": "string"
        }
      ],
      "PriceList": [
        {
          "PriceListCode": "string",
          "CostFee": 0,
          "CostPurchase": 0,
          "CostPurchaseValidTo": "string",
          "CurrencyCode": "string",
          "DiscountPct": 0,
          "FreightCost": 0,
          "IsActive": true,
          "IsFocus": true,
          "IsPromotion": true,
          "PriceCatalog": 0,
          "PriceDealer": 0,
          "PriceMax": 0,
          "PriceRanking": 0,
          "PriceRecommended": 0,
          "QtyBreak": 0
        }
      ],
      "ProductInfo": [
        {
          "Code": "string",
          "Value": "string"
        }
      ],
      "ProductName": "string",
      "ProductType": "string",
      "UnitOfMeasurementCode": 0,
      "UnitOfMeasurementCount": 0,
      "VatCode": 0
    }
  ]'

Responses

Success

Body
StatusCodestring

Status of the job

Descriptionstring

Short message describing the job

JobIdstring(int32)

Norce Commerce's interal id created for this job. Refer to this for future requests.

ValidationSummaryobject(ValidationSummary)(ValidationSummary)

Validation data for accepted payload

Response
{
  "StatusCode": "string",
  "Description": "string",
  "JobId": "string",
  "ValidationSummary": {
    "NrOfItemsInTotal": 0,
    "NrOfValidationFailures": 0,
    "Messages": [ … ]
  }
}