Article

the Article API

get

Path parameters

idinteger · int64Required

an article id

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

Responses

200

OK

*/*

get

/erp/articles/{id}

HTTPcURLJavaScriptPython

GET /api/erp/articles/{id} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "active": true,
  "baseArticle": true,
  "productType": "WITH_STOCK",
  "priceBase": "NET_PRICE",
  "serialType": "NONE",
  "expiryDateType": "NONE",
  "warrantyInMonths": 1,
  "serialNumberLabelingType": "MANUAL",
  "number": "text",
  "sellable": true,
  "purchasable": true,
  "solvable": false,
  "mergeable": false,
  "salesUnit": 1,
  "grossMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "netMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "grossVolumeInCubicMeters": 1,
  "productUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "capacity": 1,
  "capacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "baseCapacity": 1,
  "baseCapacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "productRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "productGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "netSalesPrice": 1,
  "grossSalesPrice": 1,
  "taxSchemaRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliveryMethodRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "basePriceUnit": 1,
  "discountGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliverable": true,
  "customsTariffNumber": "text",
  "countryOfOriginRef": {
    "id": 1,
    "isoAlpha2": "text",
    "label": "text"
  },
  "manufacturerId": "text",
  "tags": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "type": "COMMON",
      "label": "text",
      "color": "text",
      "editColor": "text",
      "searchColor": "text",
      "tagGroup": {
        "id": "text",
        "label": "text",
        "description": "text"
      }
    }
  ],
  "listingId": "text",
  "taxLiabilityReversed": false,
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "value": "text",
      "name": "text"
    }
  ],
  "name": "text",
  "alternativeName": "text",
  "description": "text",
  "listingDescriptionCustom": {},
  "availabilityDetermination": {
    "inStock": "IGNORE",
    "reserved": "IGNORE",
    "ordered": "IGNORE",
    "inPicking": "IGNORE",
    "reporting": "IGNORE"
  },
  "listingCustom": {},
  "languageCode": "text",
  "dangerousGoodInformationRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "isDangerousGood": false,
  "availableAlone": true,
  "pickingType": "ACCORDING_TO_TEMPLATE",
  "workUnitInMinutes": 1,
  "initialLastPurchasePrice": 1,
  "initialAvgPurchasePrice": 1,
  "determineAvgPurchasePrice": true,
  "commissionable": true,
  "cashDiscountable": true,
  "discountable": true,
  "contingentArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "printWarningIfNoContingentAvailable": true,
  "freelyPickable": false,
  "shippingLabelPrinting": false,
  "permissibleForOrderProposal": true,
  "dropShippingPolicy": "STORAGE",
  "fabrication": false,
  "onlyManualFabrication": false,
  "fabricationOfComponents": "NEVER",
  "printLabelSettings": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "report": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "incomingCalculationMode": "NO_LABEL",
    "incomingPrintQuantity": 1,
    "outgoingCalculationMode": "NO_LABEL",
    "outgoingPrintQuantity": 1
  },
  "needsAssessmentOnlyOnReservationBasis": false,
  "onGoodsArrivalConvertIntoBundleArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "remark": "text",
  "note": "text"
}

Update existing article

put

Path parameters

idinteger · int64Required

an article id

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

Body

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

activebooleanRead-onlyOptional

active

Default: true

baseArticlebooleanRead-onlyOptional

Ist das der Basis-Artikel des Produkts?

Default: true

productTypestring · enumRead-onlyOptional

Artikelarten

Possible values:

priceBasestring · enumOptional

Preisbasis

Possible values:

serialTypestring · enumRead-onlyOptional

Serientyp eines Artikels

Possible values:

expiryDateTypestring · enumRead-onlyOptional

Art des Haltbarkeitsdatums bei Serienartikeln

Possible values:

warrantyInMonthsinteger · int32Read-onlyOptional

Garantie in Monaten

serialNumberLabelingTypestring · enumRead-onlyOptional

Seriennummer Auszeichnungsart

Possible values:

numberstring · max: 255Required

unique product number

sellablebooleanOptional

is this product sellable

Default: true

purchasablebooleanOptional

is this product purchasable

Default: true

solvablebooleanOptional

is this product solvable to another package-variant

Default: false

mergeablebooleanOptional

is this product mergeable to another package-variant

Default: false

salesUnitnumberOptional

Verkaufseinheit

grossVolumeInCubicMetersnumberOptional

gross Volume in cubic meters

capacitynumberOptional

capacity

baseCapacitynumberOptional

base capacity

netSalesPricenumberOptional

net sales prices

grossSalesPricenumberOptional

gross sales prices

customobjectOptional

Search-Dialog

basePriceUnitnumberOptional

Basispreiseinheit

deliverablebooleanRequired

Ist der Artikel noch lieferbar?

Default: true

customsTariffNumberstring · max: 15Optional

Zolltarifnummer

manufacturerIdstringOptional

Hersteller des Produkts

listingIdstringOptional

die id des Listings

taxLiabilityReversedbooleanOptional

Umkehrung der Steuerschuld nach §13b UStG?

Default: false

sellableWithoutStockbooleanOptional

is this product sellable without any quantity at the stock

Default: false

listedbooleanOptional

soll der Artikel gelistet werden

Default: true

listingStatestring · enumRead-onlyOptional

Synchronisationsstatus eines Listings

Possible values:

listingStateChangeTimestring · date-timeRead-onlyOptional

die letzte Aktualisierung des listingStates

namestringOptional

name of this product

alternativeNamestringOptional

alternative name of this product

descriptionstringOptional

description of this product

listingDescriptionCustomobjectOptional

Search-Dialog

listingCustomobjectOptional

Search-Dialog

languageCodestringOptional

Einschränkung auf Land

isDangerousGoodbooleanOptional

Artikel ist Gefahrgut

Default: false

availableAlonebooleanOptional

alleine lieferbarer Artikel?

Default: true

pickingTypestring · enumOptional

Definiert die Art, wie ein Artikel kommissioniert werden darf

Default: ACCORDING_TO_TEMPLATEPossible values:

workUnitInMinutesinteger · int32Optional

Arbeitseinheit in Minuten

initialLastPurchasePricenumberOptional

Letzter EKP (Startwert)

initialAvgPurchasePricenumberOptional

Durchschnittl. EKP (Startwert)

determineAvgPurchasePricebooleanOptional

dEK berechnen?

Default: true

commissionablebooleanOptional

provisionsberechtiger Artikel?

Default: true

cashDiscountablebooleanOptional

skontierbarer Artikel?

Default: true

discountablebooleanOptional

rabattierbarer Artikel?

Default: true

printWarningIfNoContingentAvailablebooleanOptional

Nur für Kontingentartikel: soll bei der Abrechnung angedruckt werden, dass kein Kontingent vorhanden ist?

Default: true

freelyPickablebooleanOptional

Frei kommissionierbar

Default: false

shippingLabelPrintingbooleanOptional

Versandlabeldruck

Default: false

permissibleForOrderProposalbooleanOptional

zulässig für Aufnahme in Bestellvorschläge

Default: true

dropShippingPolicystring · enumRequired

Definiert, ob und wie ein Artikel per Streckengeschäft verkauft werden darf

Default: STORAGEPossible values:

fabricationbooleanOptional

Produktion

Default: false

onlyManualFabricationbooleanOptional

Nur manuelle Produktion

Default: false

fabricationOfComponentsstring · enumOptional

Produktion von Komponenten

Possible values:

needsAssessmentOnlyOnReservationBasisbooleanOptional

Bedarfsermittlung nur über Reservierungen

Default: false

remarkstringOptional

Sonderbemerkung

notestringOptional

Notiz

Responses

200

successful operation

*/*

404

Resource was not found

*/*

422

Resource was not valid to process

*/*

put

/erp/articles/{id}

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{id} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 2638

{
  "version": "text",
  "info": {},
  "id": "text",
  "priceBase": "NET_PRICE",
  "number": "text",
  "sellable": true,
  "purchasable": true,
  "solvable": false,
  "mergeable": false,
  "salesUnit": 1,
  "grossMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "netMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "grossVolumeInCubicMeters": 1,
  "productUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "capacity": 1,
  "capacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "baseCapacity": 1,
  "baseCapacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "productRef": {
    "id": "text"
  },
  "productGroupRef": {
    "id": "text"
  },
  "netSalesPrice": 1,
  "grossSalesPrice": 1,
  "taxSchemaRef": {
    "id": "text"
  },
  "deliveryMethodRef": {
    "id": "text"
  },
  "custom": {},
  "basePriceUnit": 1,
  "discountGroupRef": {
    "id": "text"
  },
  "deliverable": true,
  "customsTariffNumber": "text",
  "countryOfOriginRef": {
    "id": 1,
    "isoAlpha2": "text"
  },
  "manufacturerId": "text",
  "tags": [
    {
      "version": "text",
      "info": {},
      "id": "text",
      "type": "COMMON",
      "label": "text",
      "color": "text",
      "editColor": "text",
      "searchColor": "text",
      "tagGroup": {
        "id": "text",
        "label": "text"
      }
    }
  ],
  "listingId": "text",
  "taxLiabilityReversed": false,
  "sellableWithoutStock": false,
  "listed": true,
  "identifiers": [
    {
      "version": "text",
      "info": {},
      "id": "text",
      "value": "text",
      "name": "text"
    }
  ],
  "name": "text",
  "alternativeName": "text",
  "description": "text",
  "listingDescriptionCustom": {},
  "availabilityDetermination": {
    "inStock": "IGNORE",
    "reserved": "IGNORE",
    "ordered": "IGNORE",
    "inPicking": "IGNORE",
    "reporting": "IGNORE"
  },
  "listingCustom": {},
  "languageCode": "text",
  "dangerousGoodInformationRef": {
    "id": "text"
  },
  "isDangerousGood": false,
  "availableAlone": true,
  "pickingType": "ACCORDING_TO_TEMPLATE",
  "workUnitInMinutes": 1,
  "initialLastPurchasePrice": 1,
  "initialAvgPurchasePrice": 1,
  "determineAvgPurchasePrice": true,
  "commissionable": true,
  "cashDiscountable": true,
  "discountable": true,
  "contingentArticleRef": {
    "id": "text"
  },
  "printWarningIfNoContingentAvailable": true,
  "freelyPickable": false,
  "shippingLabelPrinting": false,
  "permissibleForOrderProposal": true,
  "dropShippingPolicy": "STORAGE",
  "fabrication": false,
  "onlyManualFabrication": false,
  "fabricationOfComponents": "NEVER",
  "printLabelSettings": {
    "version": "text",
    "info": {},
    "id": "text",
    "report": {
      "id": "text"
    },
    "incomingCalculationMode": "NO_LABEL",
    "incomingPrintQuantity": 1,
    "outgoingCalculationMode": "NO_LABEL",
    "outgoingPrintQuantity": 1
  },
  "needsAssessmentOnlyOnReservationBasis": false,
  "onGoodsArrivalConvertIntoBundleArticleRef": {
    "id": "text"
  },
  "remark": "text",
  "note": "text"
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "active": true,
  "baseArticle": true,
  "productType": "WITH_STOCK",
  "priceBase": "NET_PRICE",
  "serialType": "NONE",
  "expiryDateType": "NONE",
  "warrantyInMonths": 1,
  "serialNumberLabelingType": "MANUAL",
  "number": "text",
  "sellable": true,
  "purchasable": true,
  "solvable": false,
  "mergeable": false,
  "salesUnit": 1,
  "grossMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "netMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "grossVolumeInCubicMeters": 1,
  "productUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "capacity": 1,
  "capacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "baseCapacity": 1,
  "baseCapacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "productRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "productGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "netSalesPrice": 1,
  "grossSalesPrice": 1,
  "taxSchemaRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliveryMethodRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "basePriceUnit": 1,
  "discountGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliverable": true,
  "customsTariffNumber": "text",
  "countryOfOriginRef": {
    "id": 1,
    "isoAlpha2": "text",
    "label": "text"
  },
  "manufacturerId": "text",
  "tags": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "type": "COMMON",
      "label": "text",
      "color": "text",
      "editColor": "text",
      "searchColor": "text",
      "tagGroup": {
        "id": "text",
        "label": "text",
        "description": "text"
      }
    }
  ],
  "listingId": "text",
  "taxLiabilityReversed": false,
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "value": "text",
      "name": "text"
    }
  ],
  "name": "text",
  "alternativeName": "text",
  "description": "text",
  "listingDescriptionCustom": {},
  "availabilityDetermination": {
    "inStock": "IGNORE",
    "reserved": "IGNORE",
    "ordered": "IGNORE",
    "inPicking": "IGNORE",
    "reporting": "IGNORE"
  },
  "listingCustom": {},
  "languageCode": "text",
  "dangerousGoodInformationRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "isDangerousGood": false,
  "availableAlone": true,
  "pickingType": "ACCORDING_TO_TEMPLATE",
  "workUnitInMinutes": 1,
  "initialLastPurchasePrice": 1,
  "initialAvgPurchasePrice": 1,
  "determineAvgPurchasePrice": true,
  "commissionable": true,
  "cashDiscountable": true,
  "discountable": true,
  "contingentArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "printWarningIfNoContingentAvailable": true,
  "freelyPickable": false,
  "shippingLabelPrinting": false,
  "permissibleForOrderProposal": true,
  "dropShippingPolicy": "STORAGE",
  "fabrication": false,
  "onlyManualFabrication": false,
  "fabricationOfComponents": "NEVER",
  "printLabelSettings": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "report": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "incomingCalculationMode": "NO_LABEL",
    "incomingPrintQuantity": 1,
    "outgoingCalculationMode": "NO_LABEL",
    "outgoingPrintQuantity": 1
  },
  "needsAssessmentOnlyOnReservationBasis": false,
  "onGoodsArrivalConvertIntoBundleArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "remark": "text",
  "note": "text"
}

delete

Path parameters

idinteger · int64Required

an article id

Responses

200

OK

*/*

delete

/erp/articles/{id}

HTTPcURLJavaScriptPython

DELETE /api/erp/articles/{id} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

Update existing Resource

put

Path parameters

idinteger · int64Required

ID of Article

taxIdinteger · int64Required

ID of product-tax

Body

application/json

steuerzuordnung eines artikels

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

countryCodestringRequired

the country, this entry is valid for

validFromstring · dateRequired

the date, this entry is valid from

articleIdinteger · int64Read-onlyOptional

the date, this entry is valid from

Responses

200

successful operation

*/*

404

Resource was not found

*/*

422

Resource was not valid to process

*/*

put

/erp/articles/{id}/taxes/{taxId}

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{id}/taxes/{taxId} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "version": "text",
  "info": {},
  "id": "text",
  "typeRef": {
    "id": "text",
    "label": "text"
  },
  "countryCode": "text",
  "validFrom": "2026-02-10"
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "typeRef": {
    "id": "text",
    "label": "text",
    "description": "text"
  },
  "countryCode": "text",
  "validFrom": "2026-02-10",
  "articleId": 1
}

Delete an existing Resource

delete

Path parameters

idinteger · int64Required

ID of Article

taxIdinteger · int64Required

ID of product-tax

Responses

200

successful operation

*/*

404

Resource was not found

*/*

delete

/erp/articles/{id}/taxes/{taxId}

HTTPcURLJavaScriptPython

DELETE /api/erp/articles/{id}/taxes/{taxId} HTTP/1.1
Host: localhost:53907
Accept: */*

{
  "context": "text",
  "messageValue": "text"
}

Verlängert eine Sperre

put

Path parameters

idinteger · int64Required

ID der gesperrten Resource

lockTokeninteger · int64Required

Token der zu verlängernden Sperre

Query parameters

leasePeriodinteger · int64Required

Optionale Lease-Dauer in Sekunden

Responses

200

OK

*/*

put

/erp/articles/{id}/leasable-lock/{lockToken}

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{id}/leasable-lock/{lockToken}?leasePeriod=1 HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "key": "text",
  "token": 1,
  "userId": 1,
  "lockedBySystem": true,
  "validUntil": "2026-02-10T16:45:00.533Z",
  "id": "1"
}

Gibt ein Sperre frei

delete

Path parameters

idinteger · int64Required

ID der gesperrten Resource

lockTokeninteger · int64Required

Token der freizugebenden Sperre

Responses

200

OK

No content

delete

/erp/articles/{id}/leasable-lock/{lockToken}

HTTPcURLJavaScriptPython

DELETE /api/erp/articles/{id}/leasable-lock/{lockToken} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

No content

get

Path parameters

idinteger · int64Required

an article id

componentIdinteger · int64Required

an component id

Query parameters

languageCodestringOptional

Responses

200

OK

*/*

get

/erp/articles/{id}/fabrication-components/{componentId}

HTTPcURLJavaScriptPython

GET /api/erp/articles/{id}/fabrication-components/{componentId} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "fabricationArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "componentArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "quantity": 1,
  "deviatingUnitRef": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "name": "text",
  "description": "text",
  "forSerialInheritance": false,
  "sortOrder": 1,
  "active": true
}

put

Path parameters

idinteger · int64Required

an article id

componentIdinteger · int64Required

an component id

Query parameters

languageCodestringOptional

Body

application/json

Komponente eines Produktionsartikels

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

quantitynumberRequired

Menge

namestring · max: 255Optional

Bezeichnung

descriptionstring · max: 2147483647Optional

Beschreibung

forSerialInheritancebooleanOptional

Basis für die Vererbung der Seriennummer

Default: false

sortOrderinteger · int32Optional

Sortierreihenfolge

activebooleanRead-onlyOptional

Aktiv?

Default: true

Responses

200

OK

*/*

put

/erp/articles/{id}/fabrication-components/{componentId}

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{id}/fabrication-components/{componentId} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 395

{
  "version": "text",
  "info": {},
  "id": "text",
  "fabricationArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "componentArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "quantity": 1,
  "deviatingUnitRef": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "name": "text",
  "description": "text",
  "forSerialInheritance": false,
  "sortOrder": 1
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "fabricationArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "componentArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "quantity": 1,
  "deviatingUnitRef": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "name": "text",
  "description": "text",
  "forSerialInheritance": false,
  "sortOrder": 1,
  "active": true
}

delete

Path parameters

idinteger · int64Required

an article id

componentIdinteger · int64Required

an component id

Responses

200

OK

*/*

delete

/erp/articles/{id}/fabrication-components/{componentId}

HTTPcURLJavaScriptPython

DELETE /api/erp/articles/{id}/fabrication-components/{componentId} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

deaktiviert eine bestehende Resource

put

Path parameters

idinteger · int64Required

identifier

Responses

200

successful operation

*/*

404

Resource was not found

*/*

422

Resource was not valid to process

*/*

put

/erp/articles/{id}/deactivate

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{id}/deactivate HTTP/1.1
Host: localhost:53907
Accept: */*

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "active": true,
  "baseArticle": true,
  "productType": "WITH_STOCK",
  "priceBase": "NET_PRICE",
  "serialType": "NONE",
  "expiryDateType": "NONE",
  "warrantyInMonths": 1,
  "serialNumberLabelingType": "MANUAL",
  "number": "text",
  "sellable": true,
  "purchasable": true,
  "solvable": false,
  "mergeable": false,
  "salesUnit": 1,
  "grossMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "netMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "grossVolumeInCubicMeters": 1,
  "productUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "capacity": 1,
  "capacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "baseCapacity": 1,
  "baseCapacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "productRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "productGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "netSalesPrice": 1,
  "grossSalesPrice": 1,
  "taxSchemaRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliveryMethodRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "basePriceUnit": 1,
  "discountGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliverable": true,
  "customsTariffNumber": "text",
  "countryOfOriginRef": {
    "id": 1,
    "isoAlpha2": "text",
    "label": "text"
  },
  "manufacturerId": "text",
  "tags": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "type": "COMMON",
      "label": "text",
      "color": "text",
      "editColor": "text",
      "searchColor": "text",
      "tagGroup": {
        "id": "text",
        "label": "text",
        "description": "text"
      }
    }
  ],
  "listingId": "text",
  "taxLiabilityReversed": false,
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "value": "text",
      "name": "text"
    }
  ],
  "name": "text",
  "alternativeName": "text",
  "description": "text",
  "listingDescriptionCustom": {},
  "availabilityDetermination": {
    "inStock": "IGNORE",
    "reserved": "IGNORE",
    "ordered": "IGNORE",
    "inPicking": "IGNORE",
    "reporting": "IGNORE"
  },
  "listingCustom": {},
  "languageCode": "text",
  "dangerousGoodInformationRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "isDangerousGood": false,
  "availableAlone": true,
  "pickingType": "ACCORDING_TO_TEMPLATE",
  "workUnitInMinutes": 1,
  "initialLastPurchasePrice": 1,
  "initialAvgPurchasePrice": 1,
  "determineAvgPurchasePrice": true,
  "commissionable": true,
  "cashDiscountable": true,
  "discountable": true,
  "contingentArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "printWarningIfNoContingentAvailable": true,
  "freelyPickable": false,
  "shippingLabelPrinting": false,
  "permissibleForOrderProposal": true,
  "dropShippingPolicy": "STORAGE",
  "fabrication": false,
  "onlyManualFabrication": false,
  "fabricationOfComponents": "NEVER",
  "printLabelSettings": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "report": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "incomingCalculationMode": "NO_LABEL",
    "incomingPrintQuantity": 1,
    "outgoingCalculationMode": "NO_LABEL",
    "outgoingPrintQuantity": 1
  },
  "needsAssessmentOnlyOnReservationBasis": false,
  "onGoodsArrivalConvertIntoBundleArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "remark": "text",
  "note": "text"
}

get

Path parameters

idinteger · int64Required

an article id

componentIdinteger · int64Required

an component id

Query parameters

languageCodestringOptional

Responses

200

OK

*/*

get

/erp/articles/{id}/components/{componentId}

HTTPcURLJavaScriptPython

GET /api/erp/articles/{id}/components/{componentId} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "containerArticleId": 1,
  "componentArticleId": 1,
  "number": "text",
  "name": "text",
  "description": "text",
  "quantity": 1,
  "position": 1,
  "salesPrice": 1,
  "purchasePrice": 1,
  "grossWeight": 1,
  "netWeight": 1,
  "stockAmount": 1,
  "stockAvailable": 1
}

put

Path parameters

idinteger · int64Required

an article id

componentIdinteger · int64Required

an component id

Query parameters

languageCodestringOptional

Body

application/json

Komponenten eines Baugruppen- oder Jumbo-Artikels

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

containerArticleIdinteger · int64Required

Baugruppen- oder Jumbo-Artikel

componentArticleIdinteger · int64Required

Artikel dieser Komponente

numberstringOptional

Artikelnummer der Komponente

namestringOptional

Name der Komponente

descriptionstringOptional

Beschreibung der Komponente

quantitynumberOptional

Menge der Komponente

positioninteger · int32Optional

Position der Komponente innerhalb des Containers

salesPricenumberOptional

Verkaufspreis der Komponente

purchasePricenumberOptional

Einkaufspreis (DEK) der Komponente

grossWeightnumberOptional

Brutto-Gewicht der Komponente

netWeightnumberOptional

Netto-Gewicht der Komponente

stockAmountnumberOptional

Bestand der Komponente

stockAvailablenumberOptional

verfügbare Menge der Komponente

Responses

200

OK

*/*

put

/erp/articles/{id}/components/{componentId}

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{id}/components/{componentId} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "version": "text",
  "info": {},
  "id": "text",
  "containerArticleId": 1,
  "componentArticleId": 1,
  "number": "text",
  "name": "text",
  "description": "text",
  "quantity": 1,
  "position": 1,
  "salesPrice": 1,
  "purchasePrice": 1,
  "grossWeight": 1,
  "netWeight": 1,
  "stockAmount": 1,
  "stockAvailable": 1
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "containerArticleId": 1,
  "componentArticleId": 1,
  "number": "text",
  "name": "text",
  "description": "text",
  "quantity": 1,
  "position": 1,
  "salesPrice": 1,
  "purchasePrice": 1,
  "grossWeight": 1,
  "netWeight": 1,
  "stockAmount": 1,
  "stockAvailable": 1
}

delete

Path parameters

idinteger · int64Required

an article id

componentIdinteger · int64Required

an component id

Responses

200

OK

*/*

delete

/erp/articles/{id}/components/{componentId}

HTTPcURLJavaScriptPython

DELETE /api/erp/articles/{id}/components/{componentId} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

aktiviert eine bestehende Resource

put

Path parameters

idinteger · int64Required

identifier

Responses

200

successful operation

*/*

404

Resource was not found

*/*

422

Resource was not valid to process

*/*

put

/erp/articles/{id}/activate

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{id}/activate HTTP/1.1
Host: localhost:53907
Accept: */*

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "active": true,
  "baseArticle": true,
  "productType": "WITH_STOCK",
  "priceBase": "NET_PRICE",
  "serialType": "NONE",
  "expiryDateType": "NONE",
  "warrantyInMonths": 1,
  "serialNumberLabelingType": "MANUAL",
  "number": "text",
  "sellable": true,
  "purchasable": true,
  "solvable": false,
  "mergeable": false,
  "salesUnit": 1,
  "grossMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "netMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "grossVolumeInCubicMeters": 1,
  "productUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "capacity": 1,
  "capacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "baseCapacity": 1,
  "baseCapacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "productRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "productGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "netSalesPrice": 1,
  "grossSalesPrice": 1,
  "taxSchemaRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliveryMethodRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "basePriceUnit": 1,
  "discountGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliverable": true,
  "customsTariffNumber": "text",
  "countryOfOriginRef": {
    "id": 1,
    "isoAlpha2": "text",
    "label": "text"
  },
  "manufacturerId": "text",
  "tags": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "type": "COMMON",
      "label": "text",
      "color": "text",
      "editColor": "text",
      "searchColor": "text",
      "tagGroup": {
        "id": "text",
        "label": "text",
        "description": "text"
      }
    }
  ],
  "listingId": "text",
  "taxLiabilityReversed": false,
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "value": "text",
      "name": "text"
    }
  ],
  "name": "text",
  "alternativeName": "text",
  "description": "text",
  "listingDescriptionCustom": {},
  "availabilityDetermination": {
    "inStock": "IGNORE",
    "reserved": "IGNORE",
    "ordered": "IGNORE",
    "inPicking": "IGNORE",
    "reporting": "IGNORE"
  },
  "listingCustom": {},
  "languageCode": "text",
  "dangerousGoodInformationRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "isDangerousGood": false,
  "availableAlone": true,
  "pickingType": "ACCORDING_TO_TEMPLATE",
  "workUnitInMinutes": 1,
  "initialLastPurchasePrice": 1,
  "initialAvgPurchasePrice": 1,
  "determineAvgPurchasePrice": true,
  "commissionable": true,
  "cashDiscountable": true,
  "discountable": true,
  "contingentArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "printWarningIfNoContingentAvailable": true,
  "freelyPickable": false,
  "shippingLabelPrinting": false,
  "permissibleForOrderProposal": true,
  "dropShippingPolicy": "STORAGE",
  "fabrication": false,
  "onlyManualFabrication": false,
  "fabricationOfComponents": "NEVER",
  "printLabelSettings": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "report": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "incomingCalculationMode": "NO_LABEL",
    "incomingPrintQuantity": 1,
    "outgoingCalculationMode": "NO_LABEL",
    "outgoingPrintQuantity": 1
  },
  "needsAssessmentOnlyOnReservationBasis": false,
  "onGoodsArrivalConvertIntoBundleArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "remark": "text",
  "note": "text"
}

get

Path parameters

articleIdinteger · int64Required

an article id

listingIdinteger · int64Required

a listing id

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

Responses

200

OK

*/*

get

/erp/articles/{articleId}/listings/{listingId}

HTTPcURLJavaScriptPython

GET /api/erp/articles/{articleId}/listings/{listingId} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": {
    "value": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ],
    "defaultValue": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ]
  },
  "name": {
    "value": "text",
    "defaultValue": "text"
  },
  "alternativeName": {
    "value": "text",
    "defaultValue": "text"
  },
  "description": {
    "value": "text",
    "defaultValue": "text"
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "descriptionCustom": {
    "value": {},
    "defaultValue": {}
  },
  "proposedLowestPriceNet": 1,
  "proposedLowestPriceGross": 1,
  "customLowestPriceNet": 1,
  "customLowestPriceGross": 1
}

put

Path parameters

articleIdinteger · int64Required

an article id

listingIdinteger · int64Required

an sales-channel id

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

Body

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

sellableWithoutStockbooleanOptional

is this product sellable without any quantity at the stock

Default: false

listedbooleanOptional

soll der Artikel gelistet werden

Default: true

listingStatestring · enumRead-onlyOptional

Synchronisationsstatus eines Listings

Possible values:

listingStateChangeTimestring · date-timeRead-onlyOptional

die letzte aktualisierung des listingStates

customobjectOptional

Search-Dialog

proposedLowestPriceNetnumberRead-onlyOptional

Niedrigster Netto-Preis der letzten 30 Tage (vom System ermittelt)

proposedLowestPriceGrossnumberRead-onlyOptional

Niedrigster Brutto-Preis der letzten 30 Tage (vom System ermittelt)

customLowestPriceNetnumberOptional

Niedrigster Netto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)

customLowestPriceGrossnumberOptional

Niedrigster Brutto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)

Responses

200

OK

*/*

put

/erp/articles/{articleId}/listings/{listingId}

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{articleId}/listings/{listingId} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 416

{
  "version": "text",
  "info": {},
  "id": "text",
  "sellableWithoutStock": false,
  "listed": true,
  "identifiers": {
    "value": [
      {
        "version": "text",
        "info": {},
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ]
  },
  "name": {
    "value": "text"
  },
  "alternativeName": {
    "value": "text"
  },
  "description": {
    "value": "text"
  },
  "salesChannelRef": {
    "id": "text"
  },
  "custom": {},
  "descriptionCustom": {
    "value": {},
    "defaultValue": {}
  },
  "customLowestPriceNet": 1,
  "customLowestPriceGross": 1
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": {
    "value": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ],
    "defaultValue": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ]
  },
  "name": {
    "value": "text",
    "defaultValue": "text"
  },
  "alternativeName": {
    "value": "text",
    "defaultValue": "text"
  },
  "description": {
    "value": "text",
    "defaultValue": "text"
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "descriptionCustom": {
    "value": {},
    "defaultValue": {}
  },
  "proposedLowestPriceNet": 1,
  "proposedLowestPriceGross": 1,
  "customLowestPriceNet": 1,
  "customLowestPriceGross": 1
}

patch

Path parameters

articleIdinteger · int64Required

an article id

listingIdinteger · int64Required

an listingId id

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

Body

application/json

objectOptional

Search-Dialog

Responses

200

OK

*/*

patch

/erp/articles/{articleId}/listings/{listingId}

HTTPcURLJavaScriptPython

PATCH /api/erp/articles/{articleId}/listings/{listingId} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": {
    "value": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ],
    "defaultValue": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ]
  },
  "name": {
    "value": "text",
    "defaultValue": "text"
  },
  "alternativeName": {
    "value": "text",
    "defaultValue": "text"
  },
  "description": {
    "value": "text",
    "defaultValue": "text"
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "descriptionCustom": {
    "value": {},
    "defaultValue": {}
  },
  "proposedLowestPriceNet": 1,
  "proposedLowestPriceGross": 1,
  "customLowestPriceNet": 1,
  "customLowestPriceGross": 1
}

put

Path parameters

articleIdinteger · int64Required

an article id

listingIdinteger · int64Required

an listing id

Query parameters

statestring · enumRequired

Synchronisationsstatus eines Listings

Possible values:

Responses

200

OK

No content

put

/erp/articles/{articleId}/listings/{listingId}/state

HTTPcURLJavaScriptPython

PUT /api/erp/articles/{articleId}/listings/{listingId}/state?state=DISABLED HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

No content

Führt den Druck eines Etikettendruck-Stapels durch

put

Path parameters

batchIdstring · uuidRequired

Body

application/json

exportFormatstring · enumOptional

output forma für mail/file-export

Possible values:

exportFilenamestringOptional

filename (ohne extension) bei einem file-export

outputTypestringOptional

outputType

groupIdentifierstringOptional

OutputReportGroup Identifier (optional), sonst Default-Group des Moduls

publishedbooleanOptional

sollen nur bereits veröffentlichte Dokumente beachtet werden?

Responses

200

OK

*/*

Responseobject

put

/erp/articles/print-labels/{batchId}

HTTPcURLJavaScriptPython

PUT /api/erp/articles/print-labels/{batchId} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "exportFormat": "PDF",
  "exportFilename": "text",
  "outputType": "text",
  "groupIdentifier": "text",
  "published": true
}

200

OK

{}

Neuen Artikel (ggf. mit Produkt) erzeugen

post

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

Body

application/json

productTypestring · enumOptional

Artikelarten

Possible values:

serialTypestring · enumOptional

Serientyp eines Artikels

Possible values:

createArticlesOrBundlesbooleanOptional

Direkt Artikel/Gebinde anlegen

Default: false

bundlebooleanOptional

Nur wenn productRef leer ist: Handelt es sich um ein Gebinde?

Default: false

numberstringOptional

Artikel-Nummer (nicht, wenn es ein Gebinde ist und ein Produkt angegeben ist

namestringOptional

Bezeichnung

priceUnitnumberRequired

Preiseinheit

priceBasestring · enumOptional

Preisbasis

Possible values:

bundleSchemaIdinteger · int64Optional

Vorlage zum Erstellen mehrerer Artikel

createTemplateIdinteger · int64Optional

Vorlage zum Erstellen eines Artikel

Responses

200

OK

*/*

post

/erp/articles

HTTPcURLJavaScriptPython

POST /api/erp/articles HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 456

{
  "productRef": {
    "id": "text"
  },
  "productType": "WITH_STOCK",
  "serialType": "NONE",
  "createArticlesOrBundles": false,
  "bundle": false,
  "number": "text",
  "name": "text",
  "unitTypeRef": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "productGroupRef": {
    "id": "text"
  },
  "priceUnit": 1,
  "taxSchemaRef": {
    "id": "text"
  },
  "priceBase": "NET_PRICE",
  "bundleSchemaId": 1,
  "createTemplateId": 1,
  "variantDefinitionRef": {
    "id": "text"
  },
  "values": [
    {
      "id": "text",
      "productVariantAttributeRefs": {
        "id": "text"
      }
    }
  ]
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "active": true,
  "baseArticle": true,
  "productType": "WITH_STOCK",
  "priceBase": "NET_PRICE",
  "serialType": "NONE",
  "expiryDateType": "NONE",
  "warrantyInMonths": 1,
  "serialNumberLabelingType": "MANUAL",
  "number": "text",
  "sellable": true,
  "purchasable": true,
  "solvable": false,
  "mergeable": false,
  "salesUnit": 1,
  "grossMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "netMetric": {
    "weight": 1,
    "weightUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "sizeX": 1,
    "sizeY": 1,
    "sizeZ": 1
  },
  "grossVolumeInCubicMeters": 1,
  "productUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "capacity": 1,
  "capacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "baseCapacity": 1,
  "baseCapacityUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "productRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "productGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "netSalesPrice": 1,
  "grossSalesPrice": 1,
  "taxSchemaRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliveryMethodRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "basePriceUnit": 1,
  "discountGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "deliverable": true,
  "customsTariffNumber": "text",
  "countryOfOriginRef": {
    "id": 1,
    "isoAlpha2": "text",
    "label": "text"
  },
  "manufacturerId": "text",
  "tags": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "type": "COMMON",
      "label": "text",
      "color": "text",
      "editColor": "text",
      "searchColor": "text",
      "tagGroup": {
        "id": "text",
        "label": "text",
        "description": "text"
      }
    }
  ],
  "listingId": "text",
  "taxLiabilityReversed": false,
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "value": "text",
      "name": "text"
    }
  ],
  "name": "text",
  "alternativeName": "text",
  "description": "text",
  "listingDescriptionCustom": {},
  "availabilityDetermination": {
    "inStock": "IGNORE",
    "reserved": "IGNORE",
    "ordered": "IGNORE",
    "inPicking": "IGNORE",
    "reporting": "IGNORE"
  },
  "listingCustom": {},
  "languageCode": "text",
  "dangerousGoodInformationRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "isDangerousGood": false,
  "availableAlone": true,
  "pickingType": "ACCORDING_TO_TEMPLATE",
  "workUnitInMinutes": 1,
  "initialLastPurchasePrice": 1,
  "initialAvgPurchasePrice": 1,
  "determineAvgPurchasePrice": true,
  "commissionable": true,
  "cashDiscountable": true,
  "discountable": true,
  "contingentArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "printWarningIfNoContingentAvailable": true,
  "freelyPickable": false,
  "shippingLabelPrinting": false,
  "permissibleForOrderProposal": true,
  "dropShippingPolicy": "STORAGE",
  "fabrication": false,
  "onlyManualFabrication": false,
  "fabricationOfComponents": "NEVER",
  "printLabelSettings": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "report": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "incomingCalculationMode": "NO_LABEL",
    "incomingPrintQuantity": 1,
    "outgoingCalculationMode": "NO_LABEL",
    "outgoingPrintQuantity": 1
  },
  "needsAssessmentOnlyOnReservationBasis": false,
  "onGoodsArrivalConvertIntoBundleArticleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "remark": "text",
  "note": "text"
}

Find all existing article-taxes

get

Path parameters

idinteger · int64Required

ID of Article

Responses

200

successful operation

*/*

404

Resource with given ID was not found

*/*

get

/erp/articles/{id}/taxes

HTTPcURLJavaScriptPython

GET /api/erp/articles/{id}/taxes HTTP/1.1
Host: localhost:53907
Accept: */*

[
  {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "typeRef": {
      "id": "text",
      "label": "text",
      "description": "text"
    },
    "countryCode": "text",
    "validFrom": "2026-02-10",
    "articleId": 1
  }
]

Create new ProductTax

post

Path parameters

idinteger · int64Required

ID of Article

Body

application/json

steuerzuordnung eines artikels

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

countryCodestringRequired

the country, this entry is valid for

validFromstring · dateRequired

the date, this entry is valid from

articleIdinteger · int64Read-onlyOptional

the date, this entry is valid from

Responses

200

successful operation

*/*

422

Resource was not valid to process

*/*

post

/erp/articles/{id}/taxes

HTTPcURLJavaScriptPython

POST /api/erp/articles/{id}/taxes HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "version": "text",
  "info": {},
  "id": "text",
  "typeRef": {
    "id": "text",
    "label": "text"
  },
  "countryCode": "text",
  "validFrom": "2026-02-10"
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "typeRef": {
    "id": "text",
    "label": "text",
    "description": "text"
  },
  "countryCode": "text",
  "validFrom": "2026-02-10",
  "articleId": 1
}

Prüft, ob eine Resource gesperrt ist

get

Path parameters

idinteger · int64Required

ID einer Resource

Responses

200

OK

*/*

get

/erp/articles/{id}/leasable-lock

HTTPcURLJavaScriptPython

GET /api/erp/articles/{id}/leasable-lock HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "key": "text",
  "token": 1,
  "userId": 1,
  "lockedBySystem": true,
  "validUntil": "2026-02-10T16:45:00.533Z",
  "id": "1"
}

Erstellt eine neue Sperre, optional mit einer Gültigkeitsdauer

post

Path parameters

idinteger · int64Required

ID der zu sperrenden Resource

Query parameters

leasePeriodinteger · int64Optional

Optionale Lease-Dauer in Sekunden

Responses

200

OK

*/*

post

/erp/articles/{id}/leasable-lock

HTTPcURLJavaScriptPython

POST /api/erp/articles/{id}/leasable-lock HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "key": "text",
  "token": 1,
  "userId": 1,
  "lockedBySystem": true,
  "validUntil": "2026-02-10T16:45:00.533Z",
  "id": "1"
}

post

Path parameters

idinteger · int64Required

an article id

Query parameters

languageCodestringOptional

Body

application/json

Komponente eines Produktionsartikels

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

quantitynumberRequired

Menge

namestring · max: 255Optional

Bezeichnung

descriptionstring · max: 2147483647Optional

Beschreibung

forSerialInheritancebooleanOptional

Basis für die Vererbung der Seriennummer

Default: false

sortOrderinteger · int32Optional

Sortierreihenfolge

activebooleanRead-onlyOptional

Aktiv?

Default: true

Responses

200

OK

*/*

post

/erp/articles/{id}/fabrication-components

HTTPcURLJavaScriptPython

POST /api/erp/articles/{id}/fabrication-components HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 395

{
  "version": "text",
  "info": {},
  "id": "text",
  "fabricationArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "componentArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "quantity": 1,
  "deviatingUnitRef": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "name": "text",
  "description": "text",
  "forSerialInheritance": false,
  "sortOrder": 1
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "fabricationArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "componentArticleRef": {
    "id": 1,
    "number": "text",
    "unit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    }
  },
  "quantity": 1,
  "deviatingUnitRef": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "name": "text",
  "description": "text",
  "forSerialInheritance": false,
  "sortOrder": 1,
  "active": true
}

get

Path parameters

idinteger · int64Required

an article id

Query parameters

languageCodestringOptional

Responses

200

OK

*/*

get

/erp/articles/{id}/components

HTTPcURLJavaScriptPython

GET /api/erp/articles/{id}/components HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "components": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "containerArticleId": 1,
      "componentArticleId": 1,
      "number": "text",
      "name": "text",
      "description": "text",
      "quantity": 1,
      "position": 1,
      "salesPrice": 1,
      "purchasePrice": 1,
      "grossWeight": 1,
      "netWeight": 1,
      "stockAmount": 1,
      "stockAvailable": 1
    }
  ],
  "totalSalesPrice": 1,
  "totalPurchasePrice": 1,
  "totalNetWeight": 1,
  "totalGrossWeight": 1
}

post

Path parameters

idinteger · int64Required

an article id

Query parameters

languageCodestringOptional

Body

application/json

Komponenten eines Baugruppen- oder Jumbo-Artikels

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

containerArticleIdinteger · int64Required

Baugruppen- oder Jumbo-Artikel

componentArticleIdinteger · int64Required

Artikel dieser Komponente

numberstringOptional

Artikelnummer der Komponente

namestringOptional

Name der Komponente

descriptionstringOptional

Beschreibung der Komponente

quantitynumberOptional

Menge der Komponente

positioninteger · int32Optional

Position der Komponente innerhalb des Containers

salesPricenumberOptional

Verkaufspreis der Komponente

purchasePricenumberOptional

Einkaufspreis (DEK) der Komponente

grossWeightnumberOptional

Brutto-Gewicht der Komponente

netWeightnumberOptional

Netto-Gewicht der Komponente

stockAmountnumberOptional

Bestand der Komponente

stockAvailablenumberOptional

verfügbare Menge der Komponente

Responses

200

OK

*/*

post

/erp/articles/{id}/components

HTTPcURLJavaScriptPython

POST /api/erp/articles/{id}/components HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "version": "text",
  "info": {},
  "id": "text",
  "containerArticleId": 1,
  "componentArticleId": 1,
  "number": "text",
  "name": "text",
  "description": "text",
  "quantity": 1,
  "position": 1,
  "salesPrice": 1,
  "purchasePrice": 1,
  "grossWeight": 1,
  "netWeight": 1,
  "stockAmount": 1,
  "stockAvailable": 1
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "containerArticleId": 1,
  "componentArticleId": 1,
  "number": "text",
  "name": "text",
  "description": "text",
  "quantity": 1,
  "position": 1,
  "salesPrice": 1,
  "purchasePrice": 1,
  "grossWeight": 1,
  "netWeight": 1,
  "stockAmount": 1,
  "stockAvailable": 1
}

get

Path parameters

articleIdinteger · int64Required

an article id

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

allSalesChannelsbooleanOptional

sollen alle SalesChannel gelesen werden, auch die die kein listing haben

Default: false

Responses

200

OK

*/*

get

/erp/articles/{articleId}/listings

HTTPcURLJavaScriptPython

GET /api/erp/articles/{articleId}/listings HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

[
  {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "sellableWithoutStock": false,
    "listed": true,
    "listingState": "DISABLED",
    "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
    "identifiers": {
      "value": [
        {
          "version": "text",
          "info": {
            "createdAt": "2026-02-10T16:45:00.533Z",
            "createdFrom": "text",
            "updatedAt": "2026-02-10T16:45:00.533Z",
            "updatedFrom": "text"
          },
          "id": "text",
          "value": "text",
          "name": "text"
        }
      ],
      "defaultValue": [
        {
          "version": "text",
          "info": {
            "createdAt": "2026-02-10T16:45:00.533Z",
            "createdFrom": "text",
            "updatedAt": "2026-02-10T16:45:00.533Z",
            "updatedFrom": "text"
          },
          "id": "text",
          "value": "text",
          "name": "text"
        }
      ]
    },
    "name": {
      "value": "text",
      "defaultValue": "text"
    },
    "alternativeName": {
      "value": "text",
      "defaultValue": "text"
    },
    "description": {
      "value": "text",
      "defaultValue": "text"
    },
    "salesChannelRef": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "custom": {},
    "descriptionCustom": {
      "value": {},
      "defaultValue": {}
    },
    "proposedLowestPriceNet": 1,
    "proposedLowestPriceGross": 1,
    "customLowestPriceNet": 1,
    "customLowestPriceGross": 1
  }
]

post

Path parameters

articleIdinteger · int64Required

an article id

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

Body

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

sellableWithoutStockbooleanOptional

is this product sellable without any quantity at the stock

Default: false

listedbooleanOptional

soll der Artikel gelistet werden

Default: true

listingStatestring · enumRead-onlyOptional

Synchronisationsstatus eines Listings

Possible values:

listingStateChangeTimestring · date-timeRead-onlyOptional

die letzte aktualisierung des listingStates

customobjectOptional

Search-Dialog

proposedLowestPriceNetnumberRead-onlyOptional

Niedrigster Netto-Preis der letzten 30 Tage (vom System ermittelt)

proposedLowestPriceGrossnumberRead-onlyOptional

Niedrigster Brutto-Preis der letzten 30 Tage (vom System ermittelt)

customLowestPriceNetnumberOptional

Niedrigster Netto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)

customLowestPriceGrossnumberOptional

Niedrigster Brutto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)

Responses

200

OK

*/*

post

/erp/articles/{articleId}/listings

HTTPcURLJavaScriptPython

POST /api/erp/articles/{articleId}/listings HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 416

{
  "version": "text",
  "info": {},
  "id": "text",
  "sellableWithoutStock": false,
  "listed": true,
  "identifiers": {
    "value": [
      {
        "version": "text",
        "info": {},
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ]
  },
  "name": {
    "value": "text"
  },
  "alternativeName": {
    "value": "text"
  },
  "description": {
    "value": "text"
  },
  "salesChannelRef": {
    "id": "text"
  },
  "custom": {},
  "descriptionCustom": {
    "value": {},
    "defaultValue": {}
  },
  "customLowestPriceNet": 1,
  "customLowestPriceGross": 1
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "sellableWithoutStock": false,
  "listed": true,
  "listingState": "DISABLED",
  "listingStateChangeTime": "2026-02-10T16:45:00.533Z",
  "identifiers": {
    "value": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ],
    "defaultValue": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "value": "text",
        "name": "text"
      }
    ]
  },
  "name": {
    "value": "text",
    "defaultValue": "text"
  },
  "alternativeName": {
    "value": "text",
    "defaultValue": "text"
  },
  "description": {
    "value": "text",
    "defaultValue": "text"
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "custom": {},
  "descriptionCustom": {
    "value": {},
    "defaultValue": {}
  },
  "proposedLowestPriceNet": 1,
  "proposedLowestPriceGross": 1,
  "customLowestPriceNet": 1,
  "customLowestPriceGross": 1
}

Erstellt einen Etikettendruck-Stapel

post

Bodyobject[]

application/json

Anfrage Welche Artikel wie oft gedruckt werden soll

printbooleanOptional

Etikettendruck

Default: false

quantityinteger · int32Optional

Menge

Default: 1

Responses

200

OK

*/*

Responsestring · uuid

post

/erp/articles/print-labels

HTTPcURLJavaScriptPython

POST /api/erp/articles/print-labels HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 106

[
  {
    "article": {
      "id": "text"
    },
    "report": {
      "id": "text"
    },
    "serialNumber": {
      "id": "text"
    },
    "print": false,
    "quantity": 1
  }
]

200

OK

123e4567-e89b-12d3-a456-426614174000

Liefert den Status der aktuellen Workflow-Instanz zu der gegebenen Referenz

get

Path parameters

refIdinteger · int64Required

Responses

200

Workflow-Instanz gefunden

*/*

Responsestring · enum

Status einer Workflow-Instanz

Possible values:

404

Es existiert noch keine Workflow-Instanz

*/*

get

/erp/articles/{refId}/workflow-state

HTTPcURLJavaScriptPython

GET /api/erp/articles/{refId}/workflow-state HTTP/1.1
Host: localhost:53907
Accept: */*

CREATED

Liefert ein Query-Preset zur Selektion aller Workflow-Instanzen zu der gegebenen Referenz

get

Path parameters

refIdinteger · int64Required

Responses

200

Workflow-Instanz gefunden

*/*

get

/erp/articles/{refId}/workflow-instances-preset

HTTPcURLJavaScriptPython

GET /api/erp/articles/{refId}/workflow-instances-preset HTTP/1.1
Host: localhost:53907
Accept: */*

200

Workflow-Instanz gefunden

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "mode": "QUERY",
  "templateId": "text",
  "templateGroupKey": "text",
  "label": "text",
  "uiPayload": {},
  "variables": [
    {
      "path": "text",
      "definition": {
        "_type": "text",
        "attribute": "text",
        "path": "text",
        "displayName": "text",
        "displayNameOverride": false,
        "groupDisplayName": "text",
        "parentDisplayName": "text",
        "resultable": true,
        "filterable": true,
        "sortable": true,
        "visible": true,
        "functions": [
          "text"
        ],
        "sortDirection": "text",
        "constraint": {
          "minLength": 1,
          "maxLength": 1,
          "minValue": 1,
          "includeMinValue": true,
          "maxValue": 1,
          "includeMaxValue": true,
          "notNull": false,
          "notBlank": true
        },
        "dataType": {
          "identifier": "text",
          "jsType": "text",
          "objectRefIdentifier": "text",
          "filterOptions": {
            "filterValues": [
              "text"
            ],
            "filterDialog": {},
            "multipleChoice": false
          },
          "functions": [
            "text"
          ],
          "predicateOperations": [
            "AND"
          ]
        },
        "dataTypeIdentifier": "text",
        "modelType": "STATIC",
        "headers": [
          {
            "displayName": "text",
            "displayNameOverride": false,
            "dataType": {
              "identifier": "text",
              "jsType": "text",
              "objectRefIdentifier": "text",
              "filterOptions": {
                "filterValues": [
                  "text"
                ],
                "filterDialog": {},
                "multipleChoice": false
              },
              "functions": [
                "text"
              ],
              "predicateOperations": [
                "AND"
              ]
            },
            "dataTypeIdentifier": "text",
            "groupDisplayName": "text",
            "data": {}
          }
        ]
      },
      "mandatory": true,
      "variableName": "text",
      "visible": true,
      "alignX": 1,
      "alignY": 1,
      "alignWidth": 1,
      "searchDialog": {},
      "allowDialogMultipleChoice": false
    }
  ],
  "queryStatement": "text",
  "queryPredicate": {
    "type": "JUNCTION",
    "operator": "AND",
    "children": [
      {
        "type": "JUNCTION",
        "operator": "AND",
        "children": [
          {
            "type": "JUNCTION",
            "operator": "AND",
            "children": "[Circular Reference]",
            "property": "text",
            "values": [
              "text"
            ],
            "visible": true,
            "functions": [
              "text"
            ]
          }
        ],
        "property": "text",
        "values": [
          "text"
        ],
        "visible": true,
        "functions": [
          "text"
        ]
      }
    ],
    "property": "text",
    "values": [
      "text"
    ],
    "visible": true,
    "functions": [
      "text"
    ]
  },
  "results": [
    {
      "property": "text",
      "displayName": "text",
      "functions": [
        "text"
      ],
      "visible": true
    }
  ],
  "sortAndOrders": [
    {
      "property": "text",
      "functions": [
        "text"
      ],
      "direction": "ASC"
    }
  ],
  "pageable": {
    "limit": 1
  },
  "option": {
    "distinctResult": true
  },
  "transformations": [
    {
      "crossTable": {
        "rowSpecs": [
          {
            "property": "text",
            "displayName": "text",
            "functions": [
              "text"
            ],
            "visible": true
          }
        ],
        "columnSpecs": [
          {
            "property": "text",
            "displayName": "text",
            "functions": [
              "text"
            ],
            "visible": true
          }
        ],
        "results": [
          {
            "result": {
              "property": "text",
              "displayName": "text",
              "functions": [
                "text"
              ],
              "visible": true
            },
            "cellView": "AS_IS",
            "sumColumn": false,
            "rowMode": "DATA",
            "aggregateFunction": "text"
          }
        ]
      }
    }
  ],
  "arithmeticQueryTerms": [
    {
      "termName": "text",
      "terms": [
        {
          "fragment": {
            "operations": [
              "PLUS"
            ]
          },
          "attribute": "text",
          "fixedValue": 1
        }
      ],
      "operations": [
        "PLUS"
      ]
    }
  ],
  "definition": [
    {
      "_type": "text",
      "attribute": "text",
      "path": "text",
      "displayName": "text",
      "displayNameOverride": false,
      "groupDisplayName": "text",
      "parentDisplayName": "text",
      "resultable": true,
      "filterable": true,
      "sortable": true,
      "visible": true,
      "functions": [
        "text"
      ],
      "sortDirection": "text",
      "constraint": {
        "minLength": 1,
        "maxLength": 1,
        "minValue": 1,
        "includeMinValue": true,
        "maxValue": 1,
        "includeMaxValue": true,
        "notNull": false,
        "notBlank": true
      },
      "dataType": {
        "identifier": "text",
        "jsType": "text",
        "objectRefIdentifier": "text",
        "filterOptions": {
          "filterValues": [
            "text"
          ],
          "filterDialog": {},
          "multipleChoice": false
        },
        "functions": [
          "text"
        ],
        "predicateOperations": [
          "AND"
        ]
      },
      "dataTypeIdentifier": "text",
      "modelType": "STATIC",
      "headers": [
        {
          "displayName": "text",
          "displayNameOverride": false,
          "dataType": {
            "identifier": "text",
            "jsType": "text",
            "objectRefIdentifier": "text",
            "filterOptions": {
              "filterValues": [
                "text"
              ],
              "filterDialog": {},
              "multipleChoice": false
            },
            "functions": [
              "text"
            ],
            "predicateOperations": [
              "AND"
            ]
          },
          "dataTypeIdentifier": "text",
          "groupDisplayName": "text",
          "data": {}
        }
      ]
    }
  ],
  "permissionAggregation": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "userPermissions": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "userRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "operation": "READ_ONLY"
      }
    ],
    "groupPermissions": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T16:45:00.533Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T16:45:00.533Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "groupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "operation": "READ_ONLY"
      }
    ],
    "operationForAllUsers": "READ_ONLY"
  },
  "forWorkflow": false,
  "userOptions": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "pinned": false
  }
}

Liefert die neuste Workflow-Instanz zu der gegebenen Referenz

get

Path parameters

refIdinteger · int64Required

Responses

200

Workflow-Instanz gefunden

*/*

404

Es existiert noch keine Workflow-Instanz

*/*

get

/erp/articles/{refId}/latest-workflow-instance

HTTPcURLJavaScriptPython

GET /api/erp/articles/{refId}/latest-workflow-instance HTTP/1.1
Host: localhost:53907
Accept: */*

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "state": "CREATED",
  "workflowRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "workItems": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "state": "OPEN",
      "workflowElementRef": 1,
      "parentWorkItemRef": 1,
      "responsibleUserRef": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "logEntries": [
        {
          "version": "text",
          "info": {
            "createdAt": "2026-02-10T16:45:00.533Z",
            "createdFrom": "text",
            "updatedAt": "2026-02-10T16:45:00.533Z",
            "updatedFrom": "text"
          },
          "id": "text",
          "workflowInstanceId": 1,
          "workItemId": 1,
          "logTime": "2026-02-10T16:45:00.533Z",
          "origin": "DEBUG",
          "message": "text",
          "messageKey": "text",
          "propertyPath": "text",
          "messageParameter": {
            "ANY_ADDITIONAL_PROPERTY": {}
          }
        }
      ],
      "splitResult": "text"
    }
  ],
  "logEntries": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T16:45:00.533Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T16:45:00.533Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "workflowInstanceId": 1,
      "workItemId": 1,
      "logTime": "2026-02-10T16:45:00.533Z",
      "origin": "DEBUG",
      "message": "text",
      "messageKey": "text",
      "propertyPath": "text",
      "messageParameter": {
        "ANY_ADDITIONAL_PROPERTY": {}
      }
    }
  ]
}

find all active ui hints of one article

get

Path parameters

idinteger · int64Required

Responses

200

successful operation

*/*

Responsestring[]

404

Resource with given ID was not found

*/*

get

/erp/articles/{id}/ui-hints

HTTPcURLJavaScriptPython

GET /api/erp/articles/{id}/ui-hints HTTP/1.1
Host: localhost:53907
Accept: */*

[
  "text"
]

get

Path parameters

idinteger · int64Required

an article id

Responses

200

OK

*/*

get

/erp/articles/{id}/products

HTTPcURLJavaScriptPython

GET /api/erp/articles/{id}/products HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T16:45:00.533Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T16:45:00.533Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "bundle": false,
  "bundleSchemaRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "type": "WITH_STOCK",
  "articleRefs": [
    {
      "id": 1,
      "number": "text",
      "unit": {
        "id": 1,
        "name": "text",
        "abbreviation": "text"
      }
    }
  ],
  "availabilityDetermination": {
    "inStock": "IGNORE",
    "reserved": "IGNORE",
    "ordered": "IGNORE",
    "inPicking": "IGNORE",
    "reporting": "IGNORE"
  },
  "serialType": "NONE",
  "expiryDateType": "NONE",
  "warrantyInMonths": 1,
  "serialNumberLabelingType": "MANUAL",
  "fabricationSerialNumberLabelingType": "QUERY_ON_START",
  "customsTariffNumber": "text",
  "countryOfOrigin": {
    "id": 1,
    "isoAlpha2": "text",
    "label": "text"
  },
  "regionOfOrigin": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "useSerialSequencerConfiguration": true,
  "serialSequencerConfiguration": {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T16:45:00.533Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T16:45:00.533Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "key": "text",
    "configurationGroup": "text",
    "configurationDetail": {
      "type": "NON_POOLED_SEQUENCES",
      "assignmentMode": "MANUAL",
      "length": 1,
      "padChar": "text",
      "expression": "text",
      "postExpression": "text",
      "initialValue": 1,
      "numberUnique": true
    },
    "alternativeConfiguration": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "active": true
  },
  "variantValues": [
    {
      "id": "text",
      "label": "text",
      "description": "text",
      "productVariantAttributeRefs": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      }
    }
  ],
  "productVariantRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "mainVariantProductRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  }
}

get

Responses

200

OK

*/*

get

/erp/articles/variables

HTTPcURLJavaScriptPython

GET /api/erp/articles/variables HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

[
  {
    "_type": "text",
    "definition": "[Circular Reference]",
    "value": "[Circular Reference]",
    "attribute": "text",
    "path": "text",
    "displayName": "text",
    "displayNameOverride": false,
    "groupDisplayName": "text",
    "parentDisplayName": "text",
    "resultable": true,
    "filterable": true,
    "sortable": true,
    "visible": true,
    "functions": [
      "text"
    ],
    "sortDirection": "text",
    "constraint": {
      "minLength": 1,
      "maxLength": 1,
      "minValue": 1,
      "includeMinValue": true,
      "maxValue": 1,
      "includeMaxValue": true,
      "notNull": false,
      "notBlank": true
    },
    "dataType": {
      "identifier": "text",
      "jsType": "text",
      "objectRefIdentifier": "text",
      "filterOptions": {
        "filterValues": [
          "text"
        ],
        "filterDialog": {},
        "multipleChoice": false
      },
      "functions": [
        "text"
      ],
      "predicateOperations": [
        "AND"
      ]
    },
    "dataTypeIdentifier": "text",
    "modelType": "STATIC",
    "headers": [
      {
        "displayName": "text",
        "displayNameOverride": false,
        "dataType": {
          "identifier": "text",
          "jsType": "text",
          "objectRefIdentifier": "text",
          "filterOptions": {
            "filterValues": [
              "text"
            ],
            "filterDialog": {},
            "multipleChoice": false
          },
          "functions": [
            "text"
          ],
          "predicateOperations": [
            "AND"
          ]
        },
        "dataTypeIdentifier": "text",
        "groupDisplayName": "text",
        "data": {}
      }
    ]
  }
]

Erstellt entweder eine Etikettendruck-Vorschau zu einem Beleg oder einem Artikel

get

Query parameters

documentIdinteger · int64Optional

Beleg

articleIdinteger · int64Optional

Artikel

Responses

200

OK

*/*

get

/erp/articles/print-labels/candidates

HTTPcURLJavaScriptPython

GET /api/erp/articles/print-labels/candidates HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

[
  {
    "position": 1,
    "article": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "report": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "serialArticle": true,
    "serialNumber": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "print": true,
    "quantity": 1
  }
]

delete

Path parameters

idinteger · int64Required

an article id

listingIdinteger · int64Required

a listing id

Query parameters

languageCodestringOptional

Gewünschte Sprache (z.B. de)

Responses

200

OK

*/*

delete

/erp/articles/{id}/listings/{listingId}

HTTPcURLJavaScriptPython

DELETE /api/erp/articles/{id}/listings/{listingId} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}