Einzelnes Produkt abrufen

URL

GET/pimapi/v1/catalogs/{catalogId}/products/{productId}

Ruft eine vollständige, detailgetreue JSON-Repräsentation eines Produkts ab, einschließlich seiner Varianten, Preise, zugeordneten Klassifikationen, Dokumentdateien, Beziehungen und Attributwerte.

---

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
catalogId	string	Ja	Eindeutige ID des Katalogs, der das Produkt enthält (z. B. CAT_STANDARD).
productId	string	Ja	Eindeutige ID des abzurufenden Produkts (z. B. PROD_1001).

Abfrageparameter (Query-Parameter)

Parameter	Typ	Erforderlich	Beschreibung
languageId	string	Nein	Sprachkürzel zur Lokalisierung von Beschreibungen (z. B. en, de). Wenn weggelassen, werden alle übersetzten Werte zurückgegeben.

---

Code-Beispiele

cURL

curl -X GET "https://dev.pxm.eu.prodexa.com/pxm/pimapi/v1/catalogs/CAT_STANDARD/products/PROD_1001?languageId=de" \
  -H "X-API-KEY: ihr_hex_api_schluessel" \
  -H "Accept: application/json"

JavaScript (Fetch)

const headers = new Headers();
headers.append("X-API-KEY", "ihr_hex_api_schluessel");
headers.append("Accept", "application/json");

fetch("https://dev.pxm.eu.prodexa.com/pxm/pimapi/v1/catalogs/CAT_STANDARD/products/PROD_1001?languageId=de", {
  method: 'GET',
  headers: headers
})
  .then(response => response.json())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

---

Antwortstruktur

HTTP 200 OK Antwort

Gibt das vollständige Produkt-Stammdatenobjekt zurück.

{
  "status": 200,
  "meta": {
    "languageId": "de"
  },
  "data": {
    "productId": "PROD_1001",
    "catalogId": "CAT_STANDARD",
    "catalogId.description": "Standard-Produktkatalog",
    "supplierId": "SUP_ACME",
    "supplierId.description": "Acme Lieferant GmbH",
    "statusId": "APPROVED",
    "statusId.description": [
      {
        "languageId": "de",
        "value": "Freigegeben"
      }
    ],
    "mfgProductId": "MFG_99823",
    "manufacturerId": "MFG_COMP",
    "manufacturerId.name": "Component Manufacturer Corp.",
    "manufacturerName": "Component Manufacturer Corp.",
    "unitOfMeasureId": "UOM_PIECE",
    "unitOfMeasureId.symbol": "pcs",
    "unitOfMeasureId.description": [
      {
        "languageId": "de",
        "value": "Stück"
      }
    ],
    "salesUnitOfMeasureId": "UOM_BOX",
    "salesUnitOfMeasureId.symbol": "box",
    "salesUnitOfMeasureId.description": [
      {
        "languageId": "de",
        "value": "Karton mit 10 Stück"
      }
    ],
    "extProductId": "EXT_PROD_1001",
    "productIdExtension": "",
    "keywords": "schraube, metall, acme",
    "validFrom": "2026-06-15T00:00:00Z",
    "validTo": null,
    "variants": [
      {
        "variantId": "VAR_RED",
        "statusId": "APPROVED",
        "statusId.description": [
          {
            "languageId": "de",
            "value": "Freigegeben"
          }
        ],
        "createdOn": "2026-06-15T09:00:00Z",
        "createdBy": "admin",
        "changedOn": "2026-06-15T09:00:00Z",
        "changedBy": "admin"
      }
    ],
    "productGroups": [
      {
        "classificationId": "ECLASS_10",
        "classificationGroupId": "SCREWS",
        "orderNo": 1,
        "variant": "VAR_RED",
        "classificationGroupId.description": [
          {
            "languageId": "de",
            "value": "Metallschrauben"
          }
        ],
        "createdOn": "2026-06-15T09:00:00Z",
        "createdBy": "admin",
        "changedOn": "2026-06-15T09:00:00Z",
        "changedBy": "admin"
      }
    ],
    "values": {
      "COLOR": "RED"
    },
    "optionAttributes": {},
    "variantAttributes": {},
    "variantValues": {},
    "productDocuments": [
      {
        "path": "manuals/m6_screw_manual_de.pdf",
        "documentViewTypeId": "MANUAL",
        "orderNo": 1,
        "languageId": "de",
        "description": "Produkt-Benutzerhandbuch",
        "caption": "Handbuch",
        "validFrom": "2026-06-15T00:00:00Z",
        "status": "APPROVED",
        "variant": "VAR_RED",
        "extDocumentId": "EXT_DOC_1",
        "documentViewTypeId.name": "Handbuch",
        "createdOn": "2026-06-15T09:00:00Z",
        "createdBy": "admin",
        "changedOn": "2026-06-15T09:00:00Z",
        "changedBy": "admin"
      }
    ],
    "prices": [
      {
        "contractId": "CON_2026",
        "statusId": "APPROVED",
        "variant": "VAR_RED",
        "currencyId": "EUR",
        "priceTypeId": "NET",
        "price": 12.99,
        "validFromQuantity": 1.0,
        "priceUnit": 1,
        "vatPercentage": 19.0,
        "isPreferred": true,
        "unitOfMeasureId": "UOM_PIECE",
        "unitOfMeasureId.symbol": "pcs",
        "contractId.description": "Standardvertrag 2026",
        "priceTypeId.description": [
          {
            "languageId": "de",
            "value": "Nettopreis"
          }
        ],
        "createdOn": "2026-06-15T09:00:00Z",
        "createdBy": "admin",
        "changedOn": "2026-06-15T09:00:00Z",
        "changedBy": "admin"
      }
    ],
    "relations": [
      {
        "productId": "PROD_1001",
        "catalogId": "CAT_STANDARD",
        "relatedProductId": "PROD_1002",
        "relatedCatalogId": "CAT_STANDARD",
        "typeId": "ACCESSORY",
        "quantity": 1.0,
        "statusId": "APPROVED",
        "createdOn": "2026-06-15T09:00:00Z",
        "createdBy": "admin",
        "changedOn": "2026-06-15T09:00:00Z",
        "changedBy": "admin"
      }
    ],
    "createdOn": "2026-06-15T09:00:00Z",
    "createdBy": "admin",
    "changedOn": "2026-06-17T11:00:00Z",
    "changedBy": "editor_1"
  }
}

HTTP 404 Not Found Antwort

Wird zurückgegeben, wenn die Produkt-ID im Katalog nicht existiert.

{
  "status": 404,
  "meta": {
    "languageId": "de"
  },
  "error": "Product [PROD_1001] was not found in the catalog [CAT_STANDARD]"
}