v1

latestOpenAPI 3.0.02026-07-2455104.8 MB
Product

Update multiple products V2

Update multiple products at once.

patch/api/v2/products

Request body

idstring

Resource identifier.

namestring

Name of the product.

numberstring

Number / SKU of the product.

descriptionstring nullable

Description of the product.

internalCommentstring nullable

Text only for internal information.

shortDescriptionstring nullable

Short description of the product.

customsTariffNumberstring nullable

Customs tariff number of the product.

eanstring nullable

EAN of the product.

minimumOrderQuantitynumber

Numerical minimum order quantity of the product.

minimumStorageQuantitynumber

Numerical minimum storage quantity of the product.

serialNumbersMode'disabled' | 'user' | 'product' | 'productAndWarehouse'

4 different modes available if the product has serial numbers or not and how they are handled. For more information about the different modes have a look into our handbook.

disabledReasonstring nullable

Shows the reason why the product is locked when clicking into the product.

ageRating'' | '16' | '18' nullable

Sets an age rating for the product. Currently only used for the shipping service provider DHL.

countryOfOriginstring nullable

Two-digit ISO country code for country of origin of the product.

unitstring nullable

Unit of the product.

salesTax'standard' | 'reduced' | 'free'

Selection of three possible values for the sales tax of the product.

isShippingCostsProductboolean

Determines if a product is used as a shipping costs product. For more information have a look into our handbook.

isMatrixProductboolean

Determines if a product is a matrix product. For more information have a look into our handbook.

regionOfOrigin'' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '99' nullable

01 - Schleswig-Holstein, 02 - Hamburg, 03 - Niedersachsen, 04 - Bremen, 05 - Nordhrein-Westfalen, 06 - Hessen, 07 - Rheinland-Pfalz, 08 - Baden-Württemberg, 09 - Bayern, 10 - Saarland, 11 - Berlin, 12 - Brandenburg, 13 - Mecklenburg-Vorpommern, 14 - Sachsen, 15 - Sachsen-Anhalt, 16 - Thüringen, 99 - foreign origin

Example request

[
  {
    "id": "17",
    "name": "Shipping Discount Small",
    "number": "SKU123456",
    "project": {
      "id": "1337"
    },
    "description": "This is a detailed description of the product.",
    "internalComment": "Handle with care; sensitive material.",
    "shortDescription": "A compact and efficient shipping solution.",
    "customsTariffNumber": "1234.56.78",
    "ean": "1234567890123",
    "minimumOrderQuantity": 10,
    "minimumStorageQuantity": 5,
    "serialNumbersMode": "user",
    "disabledReason": "Product is out of stock.",
    "ageRating": "18",
    "countryOfOrigin": "DE",
    "unit": "Pack",
    "measurements": {
      "width": {
        "value": 20,
        "unit": "cm"
      },
      "height": {
        "value": 10,
        "unit": "cm"
      },
      "length": {
        "value": 30,
        "unit": "cm"
      },
      "weight": {
        "value": 2,
        "unit": "kg"
      },
      "netWeight": {
        "value": 1.5,
        "unit": "kg"
      }
    },
    "manufacturer": {
      "name": "Test Innovations",
      "number": "AC12345",
      "link": "https://www.samplesite.com"
    },
    "salesTax": "reduced",
    "merchandiseGroup": {
      "id": "1337"
    },
    "categories": [
      {
        "id": "1"
      },
      {
        "id": "2"
      }
    ],
    "standardSupplier": {
      "id": "12345"
    },
    "isShippingCostsProduct": true,
    "discount": {
      "isDiscountProduct": false,
      "discountPercentage": 15.5
    },
    "stockTaking": {
      "hasStockTakingValue": true,
      "stockTakingValue": 100.75
    },
    "calculatedPurchasePrice": {
      "hasCalculatedPurchasePrice": false,
      "price": {
        "amount": "100.00",
        "currency": "EUR"
      }
    },
    "calculatoryPurchasePriceSettings": {
      "addPurchasePriceToCalculationTriggers": [
        "onPurchaseOrderCompletion"
      ],
      "calculatoryPurchasePriceRecalculationTriggers": [
        "onPurchaseOrderCompletion"
      ],
      "calculatoryPurchasePriceRecalculationMethod": "latestPurchaseOrdersWeightedAverage"
    },
    "regionOfOrigin": "04",
    "salesChannel": {
      "description": "This is a product description.",
      "meta": {
        "title": "Product Title",
        "description": "Detailed product description.",
        "keywords": "keyword1, keyword2, keyword3"
      },
      "isStockNumberSyncActive": true,
      "isSoldOut": false,
      "isRemainingQuantity": true,
      "suggestedRetailPrice": "99.99",
      "isVisible": true,
      "suggestedStockQuantity": "100",
      "deliveryTime": "1 week",
      "createNewProductDuringImport": true
    },
    "freeFields": [
      {
        "id": "17",
        "value": "Sample Product"
      }
    ],
    "tags": [
      {
        "id": "12345",
        "key": "prod-001",
        "name": "Sample Product",
        "color": "ff0000"
      }
    ],
    "variantOf": {
      "id": "parent-product-98765"
    }
  }
]

Response

Operation completed successfully, no response body