> For the complete documentation index, see [llms.txt](https://developer.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.vario-software.de/api-reference/article.md).

# Article

Manage articles via the VARIO Cloud REST API, including product data, taxes, components, listings, locks, workflows, and label printing.

the Article API

## GET /erp/articles/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}":{"get":{"tags":["Article"],"operationId":"getArticleById","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","required":false,"style":"form","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Article"}}}}}}}},"components":{"schemas":{"erp-product-Article":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"active":{"type":"boolean","default":true,"description":"active","readOnly":true},"baseArticle":{"type":"boolean","default":true,"description":"Is this the product's base article?","readOnly":true},"productType":{"type":"string","description":"Article types.","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Price base.","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Expiry date type for serial articles.","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"minimumRemainingDaysBeforeExpiryDateOnGoodsReceipt":{"type":"integer","format":"int32","description":"Minimum remaining shelf life incoming (days): minimum remaining shelf life in days an article must still have when booked into a sales storage.","readOnly":true},"minimumRemainingDaysBeforeExpiryDateForGoodsIssued":{"type":"integer","format":"int32","description":"Minimum remaining shelf life outgoing (days): minimum remaining shelf life in days an article must still have when sold.","readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Warranty in months.","readOnly":true},"lotOnlyRequiredWhenBookedToSalesStorage":{"type":"boolean","default":false,"description":"A lot must be assigned when booking into a sales storage (for serial types LOT and BEST_BEFORE).","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Serial number labeling type.","enum":["MANUAL","AUTOMATIC_ON_SUPPLIER_ORDER","AUTOMATIC_ON_SUPPLIER_DELIVERY"],"readOnly":true},"number":{"type":"string","description":"unique product number","maxLength":255,"minLength":0},"sellable":{"type":"boolean","default":true,"description":"is this product sellable"},"purchasable":{"type":"boolean","default":true,"description":"is this product purchasable"},"solvable":{"type":"boolean","default":false,"description":"is this product solvable to another package-variant"},"mergeable":{"type":"boolean","default":false,"description":"is this product mergeable to another package-variant"},"salesUnit":{"type":"number","description":"Sales unit."},"grossMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"netMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"grossVolumeInCubicMeters":{"type":"number","description":"gross Volume in cubic meters"},"productUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"capacity":{"type":"number","description":"capacity"},"capacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"baseCapacity":{"type":"number","description":"base capacity"},"baseCapacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"productRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"productGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"netSalesPrice":{"type":"number","description":"net sales prices"},"grossSalesPrice":{"type":"number","description":"gross sales prices"},"taxSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliveryMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"basePriceUnit":{"type":"number","description":"Base price unit."},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Is the article still deliverable?"},"customsTariffNumber":{"type":"string","description":"Customs tariff number.","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Product tags.","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"Listing identifier."},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Is the tax liability reversed under §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"type":"array","description":"all (external) product numbers (SKU, EAN, ...)","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"name":{"type":"string","description":"name of this product"},"alternativeName":{"type":"string","description":"alternative name of this product"},"description":{"type":"string","description":"description of this product"},"listingDescriptionCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"availabilityDetermination":{"$ref":"#/components/schemas/erp-product-ArticleAvailabilityDetermination"},"listingCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"targetTradingMargin":{"type":"number","description":"Target trading margin."},"languageCode":{"type":"string","description":"Restriction to a country."},"dangerousGoodInformation":{"$ref":"#/components/schemas/erp-product-DangerousGoodInformation"},"dangerousGoods":{"type":"boolean","default":false,"description":"The article is dangerous goods."},"availableAlone":{"type":"boolean","default":true,"description":"Is the article deliverable on its own?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Defines how an article may be picked.","enum":["ACCORDING_TO_TEMPLATE","PICKING_ALLOWED","PICKING_NOT_ALLOWED","ONLY_SINGLE_ORDER_PICKING_ALLOWED","ONLY_COLLECTIVE_ORDER_PICKING_ALLOWED"]},"workUnitInMinutes":{"type":"integer","format":"int32","description":"Work unit in minutes.","minimum":0},"initialLastPurchasePrice":{"type":"number","description":"Last purchase price (initial value)."},"initialAvgPurchasePrice":{"type":"number","description":"Average purchase price (initial value)."},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"Should the average purchase price be calculated?"},"commissionable":{"type":"boolean","default":true,"description":"Is this article eligible for commission?"},"cashDiscountable":{"type":"boolean","default":true,"description":"Is this article eligible for the payment discount?"},"discountable":{"type":"boolean","default":true,"description":"Is this article eligible for discount?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Only for quota articles: should the billing print a note that no quota is available?"},"freelyPickable":{"type":"boolean","default":false,"description":"Freely pickable."},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Shipping label printing."},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"Eligible for inclusion in order proposals."},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Defines whether and how an article may be sold by drop shipping.","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Fabrication."},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Manual fabrication only."},"fabricationOfComponents":{"type":"string","description":"Component fabrication.","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"defaultFabricationCost":{"type":"number","description":"Predefined production costs."},"printLabelSettings":{"$ref":"#/components/schemas/erp-product-ArticlePrintLabelSettings"},"manufacturerRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"responsibleUserRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"manufacturerArticleNumber":{"type":"string","description":"Article number."},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Demand determination based on reservations only."},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Special remark."},"note":{"type":"string","description":"Note."},"forcedRecommendedRetailPrice":{"type":"boolean","description":"Is the recommended retail price mandatory?"},"articleAssetInformation":{"$ref":"#/components/schemas/erp-product-ArticleAssetInformation"},"returnable":{"type":"boolean","default":true,"description":"Is this returnable?"},"storageInfo":{"type":"string","description":"Kommissionierungshinweis","maxLength":2147483647,"minLength":0},"priceLookUpCode":{"type":"string","description":"Price look-up code (PLU)."}},"required":["deliverable","dropShippingPolicy","productGroupRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-Article.Metric":{"description":"weight and size w.o. packaging","properties":{"weight":{"type":"number","description":"weight"},"weightUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeX":{"type":"number","description":"size"},"sizeY":{"type":"number","description":"size"},"sizeZ":{"type":"number","description":"size"}}},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"common-masterdata-CountryReference":{"description":"Country of origin.","properties":{"id":{"type":"integer","format":"int64","description":"Country identifier."},"isoAlpha2":{"type":"string","description":"Country ISO Alpha-2 code."},"isoAlpha3":{"type":"string","description":"Country ISO Alpha-3 code."},"label":{"type":"string","description":"Country label.","readOnly":true}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag types.","enum":["COMMON","ACCOUNT","PRODUCT","ASSET","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Tag label."},"color":{"type":"string","description":"Color for displaying the tag."},"editColor":{"type":"string","description":"Color in the management UI."},"searchColor":{"type":"string","description":"Color in the search UI."},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Availability determination for the article master data and the stock view.","properties":{"inStock":{"type":"string","description":"How the stock is handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"How reserved quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"How ordered quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"How quantities in picking are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"How reorder levels are handled.","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-DangerousGoodInformation":{"description":"Dangerous goods information.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"description":{"type":"string","description":"description"},"shippingName":{"type":"string","description":"shipping name"},"technicalName":{"type":"string","description":"technical name"},"adrNumber":{"type":"string","description":"adr identification number"},"unNumber":{"type":"string","description":"united nations number (un number)"},"identificationClass":{"type":"string","description":"identification class"},"classificationCode":{"type":"string","description":"classification code"},"packingGroup":{"type":"string","description":"packing group (I, II, III or blank)"},"packingCode":{"type":"string","description":"packing code"},"transportCategory":{"type":"string","description":"transportation category"},"regulationCode":{"type":"string","description":"regulation code","enum":["FR","LQ","EQ","LR"]},"regulationSet":{"type":"string","description":"regulation Set, e.g. ADR","enum":["ADR","IATA"]},"hazardousWeight":{"type":"number","description":"weight of the hazardous part"},"subsidiaryRisk":{"type":"boolean","default":false,"description":"secundary risk of the dangerous good"},"tunnelRestrictionCode":{"type":"string","description":"tunnel restriction classes","enum":["A","B","C","D","E"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Label printing settings.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"report":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"incomingCalculationMode":{"type":"string","description":"Incoming goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Incoming goods: print quantity."},"outgoingCalculationMode":{"type":"string","description":"Outgoing goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Outgoing goods: print quantity."}}},"erp-product-ArticleAssetInformation":{"description":"Information about the connection between the asset and the Article.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"createAssetOnStorageEntry":{"type":"boolean","default":false,"description":"Create assets automatically on stock receipt."},"createAssetOnSale":{"type":"boolean","default":false,"description":"Create the asset automatically on sale."},"createAssetOnDocumentCategory":{"type":"string","description":"Create the asset for this document category.","enum":["CUSTOMER_DELIVERY","CUSTOMER_INVOICE"]},"createWithAssetType":{"$ref":"#/components/schemas/erp-asset-AssetType"}}},"erp-asset-AssetType":{"description":"Asset.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"label":{"type":"string","description":"Label."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}}}}}}
```

## PUT /erp/articles/{id}

> Update existing article

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}":{"put":{"tags":["Article"],"summary":"Update existing article","operationId":"update_76","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","required":false,"style":"form","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-Article"}}},"required":true},"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Article"}}}},"404":{"description":"Resource was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}},"422":{"description":"Resource was not valid to process","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-Article":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"active":{"type":"boolean","default":true,"description":"active","readOnly":true},"baseArticle":{"type":"boolean","default":true,"description":"Is this the product's base article?","readOnly":true},"productType":{"type":"string","description":"Article types.","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Price base.","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Expiry date type for serial articles.","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"minimumRemainingDaysBeforeExpiryDateOnGoodsReceipt":{"type":"integer","format":"int32","description":"Minimum remaining shelf life incoming (days): minimum remaining shelf life in days an article must still have when booked into a sales storage.","readOnly":true},"minimumRemainingDaysBeforeExpiryDateForGoodsIssued":{"type":"integer","format":"int32","description":"Minimum remaining shelf life outgoing (days): minimum remaining shelf life in days an article must still have when sold.","readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Warranty in months.","readOnly":true},"lotOnlyRequiredWhenBookedToSalesStorage":{"type":"boolean","default":false,"description":"A lot must be assigned when booking into a sales storage (for serial types LOT and BEST_BEFORE).","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Serial number labeling type.","enum":["MANUAL","AUTOMATIC_ON_SUPPLIER_ORDER","AUTOMATIC_ON_SUPPLIER_DELIVERY"],"readOnly":true},"number":{"type":"string","description":"unique product number","maxLength":255,"minLength":0},"sellable":{"type":"boolean","default":true,"description":"is this product sellable"},"purchasable":{"type":"boolean","default":true,"description":"is this product purchasable"},"solvable":{"type":"boolean","default":false,"description":"is this product solvable to another package-variant"},"mergeable":{"type":"boolean","default":false,"description":"is this product mergeable to another package-variant"},"salesUnit":{"type":"number","description":"Sales unit."},"grossMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"netMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"grossVolumeInCubicMeters":{"type":"number","description":"gross Volume in cubic meters"},"productUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"capacity":{"type":"number","description":"capacity"},"capacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"baseCapacity":{"type":"number","description":"base capacity"},"baseCapacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"productRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"productGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"netSalesPrice":{"type":"number","description":"net sales prices"},"grossSalesPrice":{"type":"number","description":"gross sales prices"},"taxSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliveryMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"basePriceUnit":{"type":"number","description":"Base price unit."},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Is the article still deliverable?"},"customsTariffNumber":{"type":"string","description":"Customs tariff number.","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Product tags.","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"Listing identifier."},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Is the tax liability reversed under §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"type":"array","description":"all (external) product numbers (SKU, EAN, ...)","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"name":{"type":"string","description":"name of this product"},"alternativeName":{"type":"string","description":"alternative name of this product"},"description":{"type":"string","description":"description of this product"},"listingDescriptionCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"availabilityDetermination":{"$ref":"#/components/schemas/erp-product-ArticleAvailabilityDetermination"},"listingCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"targetTradingMargin":{"type":"number","description":"Target trading margin."},"languageCode":{"type":"string","description":"Restriction to a country."},"dangerousGoodInformation":{"$ref":"#/components/schemas/erp-product-DangerousGoodInformation"},"dangerousGoods":{"type":"boolean","default":false,"description":"The article is dangerous goods."},"availableAlone":{"type":"boolean","default":true,"description":"Is the article deliverable on its own?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Defines how an article may be picked.","enum":["ACCORDING_TO_TEMPLATE","PICKING_ALLOWED","PICKING_NOT_ALLOWED","ONLY_SINGLE_ORDER_PICKING_ALLOWED","ONLY_COLLECTIVE_ORDER_PICKING_ALLOWED"]},"workUnitInMinutes":{"type":"integer","format":"int32","description":"Work unit in minutes.","minimum":0},"initialLastPurchasePrice":{"type":"number","description":"Last purchase price (initial value)."},"initialAvgPurchasePrice":{"type":"number","description":"Average purchase price (initial value)."},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"Should the average purchase price be calculated?"},"commissionable":{"type":"boolean","default":true,"description":"Is this article eligible for commission?"},"cashDiscountable":{"type":"boolean","default":true,"description":"Is this article eligible for the payment discount?"},"discountable":{"type":"boolean","default":true,"description":"Is this article eligible for discount?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Only for quota articles: should the billing print a note that no quota is available?"},"freelyPickable":{"type":"boolean","default":false,"description":"Freely pickable."},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Shipping label printing."},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"Eligible for inclusion in order proposals."},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Defines whether and how an article may be sold by drop shipping.","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Fabrication."},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Manual fabrication only."},"fabricationOfComponents":{"type":"string","description":"Component fabrication.","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"defaultFabricationCost":{"type":"number","description":"Predefined production costs."},"printLabelSettings":{"$ref":"#/components/schemas/erp-product-ArticlePrintLabelSettings"},"manufacturerRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"responsibleUserRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"manufacturerArticleNumber":{"type":"string","description":"Article number."},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Demand determination based on reservations only."},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Special remark."},"note":{"type":"string","description":"Note."},"forcedRecommendedRetailPrice":{"type":"boolean","description":"Is the recommended retail price mandatory?"},"articleAssetInformation":{"$ref":"#/components/schemas/erp-product-ArticleAssetInformation"},"returnable":{"type":"boolean","default":true,"description":"Is this returnable?"},"storageInfo":{"type":"string","description":"Kommissionierungshinweis","maxLength":2147483647,"minLength":0},"priceLookUpCode":{"type":"string","description":"Price look-up code (PLU)."}},"required":["deliverable","dropShippingPolicy","productGroupRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-Article.Metric":{"description":"weight and size w.o. packaging","properties":{"weight":{"type":"number","description":"weight"},"weightUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeX":{"type":"number","description":"size"},"sizeY":{"type":"number","description":"size"},"sizeZ":{"type":"number","description":"size"}}},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"common-masterdata-CountryReference":{"description":"Country of origin.","properties":{"id":{"type":"integer","format":"int64","description":"Country identifier."},"isoAlpha2":{"type":"string","description":"Country ISO Alpha-2 code."},"isoAlpha3":{"type":"string","description":"Country ISO Alpha-3 code."},"label":{"type":"string","description":"Country label.","readOnly":true}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag types.","enum":["COMMON","ACCOUNT","PRODUCT","ASSET","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Tag label."},"color":{"type":"string","description":"Color for displaying the tag."},"editColor":{"type":"string","description":"Color in the management UI."},"searchColor":{"type":"string","description":"Color in the search UI."},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Availability determination for the article master data and the stock view.","properties":{"inStock":{"type":"string","description":"How the stock is handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"How reserved quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"How ordered quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"How quantities in picking are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"How reorder levels are handled.","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-DangerousGoodInformation":{"description":"Dangerous goods information.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"description":{"type":"string","description":"description"},"shippingName":{"type":"string","description":"shipping name"},"technicalName":{"type":"string","description":"technical name"},"adrNumber":{"type":"string","description":"adr identification number"},"unNumber":{"type":"string","description":"united nations number (un number)"},"identificationClass":{"type":"string","description":"identification class"},"classificationCode":{"type":"string","description":"classification code"},"packingGroup":{"type":"string","description":"packing group (I, II, III or blank)"},"packingCode":{"type":"string","description":"packing code"},"transportCategory":{"type":"string","description":"transportation category"},"regulationCode":{"type":"string","description":"regulation code","enum":["FR","LQ","EQ","LR"]},"regulationSet":{"type":"string","description":"regulation Set, e.g. ADR","enum":["ADR","IATA"]},"hazardousWeight":{"type":"number","description":"weight of the hazardous part"},"subsidiaryRisk":{"type":"boolean","default":false,"description":"secundary risk of the dangerous good"},"tunnelRestrictionCode":{"type":"string","description":"tunnel restriction classes","enum":["A","B","C","D","E"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Label printing settings.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"report":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"incomingCalculationMode":{"type":"string","description":"Incoming goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Incoming goods: print quantity."},"outgoingCalculationMode":{"type":"string","description":"Outgoing goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Outgoing goods: print quantity."}}},"erp-product-ArticleAssetInformation":{"description":"Information about the connection between the asset and the Article.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"createAssetOnStorageEntry":{"type":"boolean","default":false,"description":"Create assets automatically on stock receipt."},"createAssetOnSale":{"type":"boolean","default":false,"description":"Create the asset automatically on sale."},"createAssetOnDocumentCategory":{"type":"string","description":"Create the asset for this document category.","enum":["CUSTOMER_DELIVERY","CUSTOMER_INVOICE"]},"createWithAssetType":{"$ref":"#/components/schemas/erp-asset-AssetType"}}},"erp-asset-AssetType":{"description":"Asset.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"label":{"type":"string","description":"Label."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}}}}}
```

## DELETE /erp/articles/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}":{"delete":{"tags":["Article"],"operationId":"deleteById","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}}}}}
```

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

> Update existing Resource&#x20;

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/taxes/{taxId}":{"put":{"tags":["Article"],"summary":"Update existing Resource ","operationId":"updateTax","parameters":[{"name":"id","in":"path","description":"ID of Article","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"taxId","in":"path","description":"ID of product-tax","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleTax"}}},"required":true},"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleTax"}}}},"404":{"description":"Resource was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}},"422":{"description":"Resource was not valid to process","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-ArticleTax":{"description":"Article tax assignment.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"typeRef":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"},"countryCode":{"type":"string","description":"the country, this entry is valid for","minLength":1},"validFrom":{"type":"string","format":"date","description":"the date, this entry is valid from"},"articleId":{"type":"integer","format":"int64","description":"the date, this entry is valid from","readOnly":true}},"required":["countryCode","typeRef","validFrom"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

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

> Delete an existing Resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/taxes/{taxId}":{"delete":{"tags":["Article"],"summary":"Delete an existing Resource","operationId":"deleteTax","parameters":[{"name":"id","in":"path","description":"ID of Article","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"taxId","in":"path","description":"ID of product-tax","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}},"404":{"description":"Resource was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

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

> Extend a lock

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/leasable-lock/{lockToken}":{"put":{"tags":["Article"],"summary":"Extend a lock","operationId":"refreshLeasableLock_1","parameters":[{"name":"id","in":"path","description":"Locked resource identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"lockToken","in":"path","description":"Token of the lock to extend.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"leasePeriod","in":"query","description":"Optional lease duration in seconds.","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-unknownmodule-LeasableLock"}}}}}}}},"components":{"schemas":{"core-unknownmodule-LeasableLock":{"properties":{"key":{"type":"string","minLength":1},"token":{"type":"integer","format":"int64"},"userId":{"type":"integer","format":"int64"},"lockedBySystem":{"type":"boolean"},"validUntil":{"type":"string","format":"date-time"},"id":{"type":"string","description":"Unique identifier of the Object","readOnly":true}},"required":["key","token"]}}}}
```

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

> Release a lock

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/leasable-lock/{lockToken}":{"delete":{"tags":["Article"],"summary":"Release a lock","operationId":"releaseLeasableLock_1","parameters":[{"name":"id","in":"path","description":"Locked resource identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"lockToken","in":"path","description":"Token of the lock to release.","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/fabrication-components/{componentId}":{"get":{"tags":["Article"],"operationId":"getFabricationComponent","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"Component identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleFabricationComponent"}}}}}}}},"components":{"schemas":{"erp-product-ArticleFabricationComponent":{"description":"Fabrication article component.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"fabricationArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"componentArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"sourceBundleArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"quantity":{"type":"number","description":"Quantity."},"deviatingUnitRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"deviatingUnitPrice":{"type":"number","description":"Deviating production costs."},"name":{"type":"string","description":"Label.","maxLength":255,"minLength":0},"description":{"type":"string","description":"Description.","maxLength":2147483647,"minLength":0},"forSerialInheritance":{"type":"boolean","default":false,"description":"Basis for inheriting the serial number."},"sortOrder":{"type":"integer","format":"int32","description":"Sort order."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}},"required":["componentArticleRef","fabricationArticleRef","quantity"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ProductArticleRef":{"description":"All articles belonging to this product.","properties":{"id":{"type":"integer","format":"int64","description":"Article identifier."},"number":{"type":"string","description":"Article number"},"name":{"type":"string","description":"Label."},"description":{"type":"string","description":"Description."},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"]},"unit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"}},"required":["unit"]},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/fabrication-components/{componentId}":{"put":{"tags":["Article"],"operationId":"updateFabricationComponent","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"Component identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleFabricationComponent"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleFabricationComponent"}}}}}}}},"components":{"schemas":{"erp-product-ArticleFabricationComponent":{"description":"Fabrication article component.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"fabricationArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"componentArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"sourceBundleArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"quantity":{"type":"number","description":"Quantity."},"deviatingUnitRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"deviatingUnitPrice":{"type":"number","description":"Deviating production costs."},"name":{"type":"string","description":"Label.","maxLength":255,"minLength":0},"description":{"type":"string","description":"Description.","maxLength":2147483647,"minLength":0},"forSerialInheritance":{"type":"boolean","default":false,"description":"Basis for inheriting the serial number."},"sortOrder":{"type":"integer","format":"int32","description":"Sort order."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}},"required":["componentArticleRef","fabricationArticleRef","quantity"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ProductArticleRef":{"description":"All articles belonging to this product.","properties":{"id":{"type":"integer","format":"int64","description":"Article identifier."},"number":{"type":"string","description":"Article number"},"name":{"type":"string","description":"Label."},"description":{"type":"string","description":"Description."},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"]},"unit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"}},"required":["unit"]},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/fabrication-components/{componentId}":{"delete":{"tags":["Article"],"operationId":"deleteFabricationComponent","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"Component identifier.","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}}}}}
```

## PUT /erp/articles/{id}/deactivate

> Deactivate an existing resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/deactivate":{"put":{"tags":["Article"],"summary":"Deactivate an existing resource","operationId":"deactivate_37","parameters":[{"name":"id","in":"path","description":"identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Article"}}}},"404":{"description":"Resource was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}},"422":{"description":"Resource was not valid to process","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-Article":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"active":{"type":"boolean","default":true,"description":"active","readOnly":true},"baseArticle":{"type":"boolean","default":true,"description":"Is this the product's base article?","readOnly":true},"productType":{"type":"string","description":"Article types.","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Price base.","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Expiry date type for serial articles.","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"minimumRemainingDaysBeforeExpiryDateOnGoodsReceipt":{"type":"integer","format":"int32","description":"Minimum remaining shelf life incoming (days): minimum remaining shelf life in days an article must still have when booked into a sales storage.","readOnly":true},"minimumRemainingDaysBeforeExpiryDateForGoodsIssued":{"type":"integer","format":"int32","description":"Minimum remaining shelf life outgoing (days): minimum remaining shelf life in days an article must still have when sold.","readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Warranty in months.","readOnly":true},"lotOnlyRequiredWhenBookedToSalesStorage":{"type":"boolean","default":false,"description":"A lot must be assigned when booking into a sales storage (for serial types LOT and BEST_BEFORE).","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Serial number labeling type.","enum":["MANUAL","AUTOMATIC_ON_SUPPLIER_ORDER","AUTOMATIC_ON_SUPPLIER_DELIVERY"],"readOnly":true},"number":{"type":"string","description":"unique product number","maxLength":255,"minLength":0},"sellable":{"type":"boolean","default":true,"description":"is this product sellable"},"purchasable":{"type":"boolean","default":true,"description":"is this product purchasable"},"solvable":{"type":"boolean","default":false,"description":"is this product solvable to another package-variant"},"mergeable":{"type":"boolean","default":false,"description":"is this product mergeable to another package-variant"},"salesUnit":{"type":"number","description":"Sales unit."},"grossMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"netMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"grossVolumeInCubicMeters":{"type":"number","description":"gross Volume in cubic meters"},"productUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"capacity":{"type":"number","description":"capacity"},"capacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"baseCapacity":{"type":"number","description":"base capacity"},"baseCapacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"productRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"productGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"netSalesPrice":{"type":"number","description":"net sales prices"},"grossSalesPrice":{"type":"number","description":"gross sales prices"},"taxSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliveryMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"basePriceUnit":{"type":"number","description":"Base price unit."},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Is the article still deliverable?"},"customsTariffNumber":{"type":"string","description":"Customs tariff number.","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Product tags.","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"Listing identifier."},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Is the tax liability reversed under §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"type":"array","description":"all (external) product numbers (SKU, EAN, ...)","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"name":{"type":"string","description":"name of this product"},"alternativeName":{"type":"string","description":"alternative name of this product"},"description":{"type":"string","description":"description of this product"},"listingDescriptionCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"availabilityDetermination":{"$ref":"#/components/schemas/erp-product-ArticleAvailabilityDetermination"},"listingCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"targetTradingMargin":{"type":"number","description":"Target trading margin."},"languageCode":{"type":"string","description":"Restriction to a country."},"dangerousGoodInformation":{"$ref":"#/components/schemas/erp-product-DangerousGoodInformation"},"dangerousGoods":{"type":"boolean","default":false,"description":"The article is dangerous goods."},"availableAlone":{"type":"boolean","default":true,"description":"Is the article deliverable on its own?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Defines how an article may be picked.","enum":["ACCORDING_TO_TEMPLATE","PICKING_ALLOWED","PICKING_NOT_ALLOWED","ONLY_SINGLE_ORDER_PICKING_ALLOWED","ONLY_COLLECTIVE_ORDER_PICKING_ALLOWED"]},"workUnitInMinutes":{"type":"integer","format":"int32","description":"Work unit in minutes.","minimum":0},"initialLastPurchasePrice":{"type":"number","description":"Last purchase price (initial value)."},"initialAvgPurchasePrice":{"type":"number","description":"Average purchase price (initial value)."},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"Should the average purchase price be calculated?"},"commissionable":{"type":"boolean","default":true,"description":"Is this article eligible for commission?"},"cashDiscountable":{"type":"boolean","default":true,"description":"Is this article eligible for the payment discount?"},"discountable":{"type":"boolean","default":true,"description":"Is this article eligible for discount?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Only for quota articles: should the billing print a note that no quota is available?"},"freelyPickable":{"type":"boolean","default":false,"description":"Freely pickable."},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Shipping label printing."},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"Eligible for inclusion in order proposals."},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Defines whether and how an article may be sold by drop shipping.","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Fabrication."},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Manual fabrication only."},"fabricationOfComponents":{"type":"string","description":"Component fabrication.","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"defaultFabricationCost":{"type":"number","description":"Predefined production costs."},"printLabelSettings":{"$ref":"#/components/schemas/erp-product-ArticlePrintLabelSettings"},"manufacturerRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"responsibleUserRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"manufacturerArticleNumber":{"type":"string","description":"Article number."},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Demand determination based on reservations only."},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Special remark."},"note":{"type":"string","description":"Note."},"forcedRecommendedRetailPrice":{"type":"boolean","description":"Is the recommended retail price mandatory?"},"articleAssetInformation":{"$ref":"#/components/schemas/erp-product-ArticleAssetInformation"},"returnable":{"type":"boolean","default":true,"description":"Is this returnable?"},"storageInfo":{"type":"string","description":"Kommissionierungshinweis","maxLength":2147483647,"minLength":0},"priceLookUpCode":{"type":"string","description":"Price look-up code (PLU)."}},"required":["deliverable","dropShippingPolicy","productGroupRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-Article.Metric":{"description":"weight and size w.o. packaging","properties":{"weight":{"type":"number","description":"weight"},"weightUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeX":{"type":"number","description":"size"},"sizeY":{"type":"number","description":"size"},"sizeZ":{"type":"number","description":"size"}}},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"common-masterdata-CountryReference":{"description":"Country of origin.","properties":{"id":{"type":"integer","format":"int64","description":"Country identifier."},"isoAlpha2":{"type":"string","description":"Country ISO Alpha-2 code."},"isoAlpha3":{"type":"string","description":"Country ISO Alpha-3 code."},"label":{"type":"string","description":"Country label.","readOnly":true}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag types.","enum":["COMMON","ACCOUNT","PRODUCT","ASSET","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Tag label."},"color":{"type":"string","description":"Color for displaying the tag."},"editColor":{"type":"string","description":"Color in the management UI."},"searchColor":{"type":"string","description":"Color in the search UI."},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Availability determination for the article master data and the stock view.","properties":{"inStock":{"type":"string","description":"How the stock is handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"How reserved quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"How ordered quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"How quantities in picking are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"How reorder levels are handled.","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-DangerousGoodInformation":{"description":"Dangerous goods information.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"description":{"type":"string","description":"description"},"shippingName":{"type":"string","description":"shipping name"},"technicalName":{"type":"string","description":"technical name"},"adrNumber":{"type":"string","description":"adr identification number"},"unNumber":{"type":"string","description":"united nations number (un number)"},"identificationClass":{"type":"string","description":"identification class"},"classificationCode":{"type":"string","description":"classification code"},"packingGroup":{"type":"string","description":"packing group (I, II, III or blank)"},"packingCode":{"type":"string","description":"packing code"},"transportCategory":{"type":"string","description":"transportation category"},"regulationCode":{"type":"string","description":"regulation code","enum":["FR","LQ","EQ","LR"]},"regulationSet":{"type":"string","description":"regulation Set, e.g. ADR","enum":["ADR","IATA"]},"hazardousWeight":{"type":"number","description":"weight of the hazardous part"},"subsidiaryRisk":{"type":"boolean","default":false,"description":"secundary risk of the dangerous good"},"tunnelRestrictionCode":{"type":"string","description":"tunnel restriction classes","enum":["A","B","C","D","E"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Label printing settings.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"report":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"incomingCalculationMode":{"type":"string","description":"Incoming goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Incoming goods: print quantity."},"outgoingCalculationMode":{"type":"string","description":"Outgoing goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Outgoing goods: print quantity."}}},"erp-product-ArticleAssetInformation":{"description":"Information about the connection between the asset and the Article.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"createAssetOnStorageEntry":{"type":"boolean","default":false,"description":"Create assets automatically on stock receipt."},"createAssetOnSale":{"type":"boolean","default":false,"description":"Create the asset automatically on sale."},"createAssetOnDocumentCategory":{"type":"string","description":"Create the asset for this document category.","enum":["CUSTOMER_DELIVERY","CUSTOMER_INVOICE"]},"createWithAssetType":{"$ref":"#/components/schemas/erp-asset-AssetType"}}},"erp-asset-AssetType":{"description":"Asset.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"label":{"type":"string","description":"Label."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/components/{componentId}":{"get":{"tags":["Article"],"operationId":"getComponent","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"Component identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleComponent"}}}}}}}},"components":{"schemas":{"erp-product-ArticleComponent":{"description":"Assembly or jumbo article components.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"containerArticleId":{"type":"integer","format":"int64","description":"Assembly or jumbo article."},"componentArticleId":{"type":"integer","format":"int64","description":"Component article."},"number":{"type":"string","description":"Component article number."},"name":{"type":"string","description":"Component name."},"description":{"type":"string","description":"Component description."},"quantity":{"type":"number","description":"Component quantity."},"position":{"type":"integer","format":"int32","description":"Component position within the container."},"salesPrice":{"type":"number","description":"Component sales price."},"purchasePrice":{"type":"number","description":"Component purchase price (average)."},"grossWeight":{"type":"number","description":"Component gross weight."},"netWeight":{"type":"number","description":"Component net weight."},"stockAmount":{"type":"number","description":"Component stock."},"stockAvailable":{"type":"number","description":"Available component quantity."}},"required":["componentArticleId","containerArticleId"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/components/{componentId}":{"put":{"tags":["Article"],"operationId":"updateComponent","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"Component identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleComponent"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleComponent"}}}}}}}},"components":{"schemas":{"erp-product-ArticleComponent":{"description":"Assembly or jumbo article components.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"containerArticleId":{"type":"integer","format":"int64","description":"Assembly or jumbo article."},"componentArticleId":{"type":"integer","format":"int64","description":"Component article."},"number":{"type":"string","description":"Component article number."},"name":{"type":"string","description":"Component name."},"description":{"type":"string","description":"Component description."},"quantity":{"type":"number","description":"Component quantity."},"position":{"type":"integer","format":"int32","description":"Component position within the container."},"salesPrice":{"type":"number","description":"Component sales price."},"purchasePrice":{"type":"number","description":"Component purchase price (average)."},"grossWeight":{"type":"number","description":"Component gross weight."},"netWeight":{"type":"number","description":"Component net weight."},"stockAmount":{"type":"number","description":"Component stock."},"stockAvailable":{"type":"number","description":"Available component quantity."}},"required":["componentArticleId","containerArticleId"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/components/{componentId}":{"delete":{"tags":["Article"],"operationId":"deleteComponent","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"Component identifier.","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}}}}}
```

## PUT /erp/articles/{id}/activate

> Activate an existing resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/activate":{"put":{"tags":["Article"],"summary":"Activate an existing resource","operationId":"activate_37","parameters":[{"name":"id","in":"path","description":"identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Article"}}}},"404":{"description":"Resource was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}},"422":{"description":"Resource was not valid to process","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-Article":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"active":{"type":"boolean","default":true,"description":"active","readOnly":true},"baseArticle":{"type":"boolean","default":true,"description":"Is this the product's base article?","readOnly":true},"productType":{"type":"string","description":"Article types.","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Price base.","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Expiry date type for serial articles.","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"minimumRemainingDaysBeforeExpiryDateOnGoodsReceipt":{"type":"integer","format":"int32","description":"Minimum remaining shelf life incoming (days): minimum remaining shelf life in days an article must still have when booked into a sales storage.","readOnly":true},"minimumRemainingDaysBeforeExpiryDateForGoodsIssued":{"type":"integer","format":"int32","description":"Minimum remaining shelf life outgoing (days): minimum remaining shelf life in days an article must still have when sold.","readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Warranty in months.","readOnly":true},"lotOnlyRequiredWhenBookedToSalesStorage":{"type":"boolean","default":false,"description":"A lot must be assigned when booking into a sales storage (for serial types LOT and BEST_BEFORE).","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Serial number labeling type.","enum":["MANUAL","AUTOMATIC_ON_SUPPLIER_ORDER","AUTOMATIC_ON_SUPPLIER_DELIVERY"],"readOnly":true},"number":{"type":"string","description":"unique product number","maxLength":255,"minLength":0},"sellable":{"type":"boolean","default":true,"description":"is this product sellable"},"purchasable":{"type":"boolean","default":true,"description":"is this product purchasable"},"solvable":{"type":"boolean","default":false,"description":"is this product solvable to another package-variant"},"mergeable":{"type":"boolean","default":false,"description":"is this product mergeable to another package-variant"},"salesUnit":{"type":"number","description":"Sales unit."},"grossMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"netMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"grossVolumeInCubicMeters":{"type":"number","description":"gross Volume in cubic meters"},"productUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"capacity":{"type":"number","description":"capacity"},"capacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"baseCapacity":{"type":"number","description":"base capacity"},"baseCapacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"productRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"productGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"netSalesPrice":{"type":"number","description":"net sales prices"},"grossSalesPrice":{"type":"number","description":"gross sales prices"},"taxSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliveryMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"basePriceUnit":{"type":"number","description":"Base price unit."},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Is the article still deliverable?"},"customsTariffNumber":{"type":"string","description":"Customs tariff number.","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Product tags.","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"Listing identifier."},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Is the tax liability reversed under §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"type":"array","description":"all (external) product numbers (SKU, EAN, ...)","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"name":{"type":"string","description":"name of this product"},"alternativeName":{"type":"string","description":"alternative name of this product"},"description":{"type":"string","description":"description of this product"},"listingDescriptionCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"availabilityDetermination":{"$ref":"#/components/schemas/erp-product-ArticleAvailabilityDetermination"},"listingCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"targetTradingMargin":{"type":"number","description":"Target trading margin."},"languageCode":{"type":"string","description":"Restriction to a country."},"dangerousGoodInformation":{"$ref":"#/components/schemas/erp-product-DangerousGoodInformation"},"dangerousGoods":{"type":"boolean","default":false,"description":"The article is dangerous goods."},"availableAlone":{"type":"boolean","default":true,"description":"Is the article deliverable on its own?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Defines how an article may be picked.","enum":["ACCORDING_TO_TEMPLATE","PICKING_ALLOWED","PICKING_NOT_ALLOWED","ONLY_SINGLE_ORDER_PICKING_ALLOWED","ONLY_COLLECTIVE_ORDER_PICKING_ALLOWED"]},"workUnitInMinutes":{"type":"integer","format":"int32","description":"Work unit in minutes.","minimum":0},"initialLastPurchasePrice":{"type":"number","description":"Last purchase price (initial value)."},"initialAvgPurchasePrice":{"type":"number","description":"Average purchase price (initial value)."},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"Should the average purchase price be calculated?"},"commissionable":{"type":"boolean","default":true,"description":"Is this article eligible for commission?"},"cashDiscountable":{"type":"boolean","default":true,"description":"Is this article eligible for the payment discount?"},"discountable":{"type":"boolean","default":true,"description":"Is this article eligible for discount?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Only for quota articles: should the billing print a note that no quota is available?"},"freelyPickable":{"type":"boolean","default":false,"description":"Freely pickable."},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Shipping label printing."},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"Eligible for inclusion in order proposals."},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Defines whether and how an article may be sold by drop shipping.","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Fabrication."},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Manual fabrication only."},"fabricationOfComponents":{"type":"string","description":"Component fabrication.","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"defaultFabricationCost":{"type":"number","description":"Predefined production costs."},"printLabelSettings":{"$ref":"#/components/schemas/erp-product-ArticlePrintLabelSettings"},"manufacturerRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"responsibleUserRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"manufacturerArticleNumber":{"type":"string","description":"Article number."},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Demand determination based on reservations only."},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Special remark."},"note":{"type":"string","description":"Note."},"forcedRecommendedRetailPrice":{"type":"boolean","description":"Is the recommended retail price mandatory?"},"articleAssetInformation":{"$ref":"#/components/schemas/erp-product-ArticleAssetInformation"},"returnable":{"type":"boolean","default":true,"description":"Is this returnable?"},"storageInfo":{"type":"string","description":"Kommissionierungshinweis","maxLength":2147483647,"minLength":0},"priceLookUpCode":{"type":"string","description":"Price look-up code (PLU)."}},"required":["deliverable","dropShippingPolicy","productGroupRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-Article.Metric":{"description":"weight and size w.o. packaging","properties":{"weight":{"type":"number","description":"weight"},"weightUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeX":{"type":"number","description":"size"},"sizeY":{"type":"number","description":"size"},"sizeZ":{"type":"number","description":"size"}}},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"common-masterdata-CountryReference":{"description":"Country of origin.","properties":{"id":{"type":"integer","format":"int64","description":"Country identifier."},"isoAlpha2":{"type":"string","description":"Country ISO Alpha-2 code."},"isoAlpha3":{"type":"string","description":"Country ISO Alpha-3 code."},"label":{"type":"string","description":"Country label.","readOnly":true}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag types.","enum":["COMMON","ACCOUNT","PRODUCT","ASSET","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Tag label."},"color":{"type":"string","description":"Color for displaying the tag."},"editColor":{"type":"string","description":"Color in the management UI."},"searchColor":{"type":"string","description":"Color in the search UI."},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Availability determination for the article master data and the stock view.","properties":{"inStock":{"type":"string","description":"How the stock is handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"How reserved quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"How ordered quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"How quantities in picking are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"How reorder levels are handled.","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-DangerousGoodInformation":{"description":"Dangerous goods information.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"description":{"type":"string","description":"description"},"shippingName":{"type":"string","description":"shipping name"},"technicalName":{"type":"string","description":"technical name"},"adrNumber":{"type":"string","description":"adr identification number"},"unNumber":{"type":"string","description":"united nations number (un number)"},"identificationClass":{"type":"string","description":"identification class"},"classificationCode":{"type":"string","description":"classification code"},"packingGroup":{"type":"string","description":"packing group (I, II, III or blank)"},"packingCode":{"type":"string","description":"packing code"},"transportCategory":{"type":"string","description":"transportation category"},"regulationCode":{"type":"string","description":"regulation code","enum":["FR","LQ","EQ","LR"]},"regulationSet":{"type":"string","description":"regulation Set, e.g. ADR","enum":["ADR","IATA"]},"hazardousWeight":{"type":"number","description":"weight of the hazardous part"},"subsidiaryRisk":{"type":"boolean","default":false,"description":"secundary risk of the dangerous good"},"tunnelRestrictionCode":{"type":"string","description":"tunnel restriction classes","enum":["A","B","C","D","E"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Label printing settings.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"report":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"incomingCalculationMode":{"type":"string","description":"Incoming goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Incoming goods: print quantity."},"outgoingCalculationMode":{"type":"string","description":"Outgoing goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Outgoing goods: print quantity."}}},"erp-product-ArticleAssetInformation":{"description":"Information about the connection between the asset and the Article.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"createAssetOnStorageEntry":{"type":"boolean","default":false,"description":"Create assets automatically on stock receipt."},"createAssetOnSale":{"type":"boolean","default":false,"description":"Create the asset automatically on sale."},"createAssetOnDocumentCategory":{"type":"string","description":"Create the asset for this document category.","enum":["CUSTOMER_DELIVERY","CUSTOMER_INVOICE"]},"createWithAssetType":{"$ref":"#/components/schemas/erp-asset-AssetType"}}},"erp-asset-AssetType":{"description":"Asset.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"label":{"type":"string","description":"Label."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{articleId}/listings/{listingId}":{"get":{"tags":["Article"],"operationId":"getListing","parameters":[{"name":"articleId","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"Listing identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","required":false,"style":"form","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleListing"}}}}}}}},"components":{"schemas":{"erp-product-ArticleListing":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsListArticleIdentifier"},"name":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"alternativeName":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"description":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"salesChannelRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"descriptionCustom":{"$ref":"#/components/schemas/erp-product-ArticleListing.CustomFieldWithDefaults"},"proposedLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (determined by the system).","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (determined by the system).","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (user-defined input)."},"customLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (user-defined input)."},"categoryRefs":{"type":"array","description":"Categories this listing is assigned to.","items":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}}},"required":["salesChannelRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ArticleListing.WithDefaultsListArticleIdentifier":{"description":"all (external) article numbers (SKU, EAN, ...)","properties":{"value":{"type":"array","description":"Sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Default sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"},"readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Sales channel value."},"defaultValue":{"type":"string","description":"Default sales channel value.","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"erp-product-ArticleListing.CustomFieldWithDefaults":{"description":"description custom data","properties":{"value":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"defaultValue":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{articleId}/listings/{listingId}":{"put":{"tags":["Article"],"operationId":"updateListing","parameters":[{"name":"articleId","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"Sales channel identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","required":false,"style":"form","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleListing"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleListing"}}}}}}}},"components":{"schemas":{"erp-product-ArticleListing":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsListArticleIdentifier"},"name":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"alternativeName":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"description":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"salesChannelRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"descriptionCustom":{"$ref":"#/components/schemas/erp-product-ArticleListing.CustomFieldWithDefaults"},"proposedLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (determined by the system).","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (determined by the system).","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (user-defined input)."},"customLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (user-defined input)."},"categoryRefs":{"type":"array","description":"Categories this listing is assigned to.","items":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}}},"required":["salesChannelRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ArticleListing.WithDefaultsListArticleIdentifier":{"description":"all (external) article numbers (SKU, EAN, ...)","properties":{"value":{"type":"array","description":"Sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Default sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"},"readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Sales channel value."},"defaultValue":{"type":"string","description":"Default sales channel value.","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"erp-product-ArticleListing.CustomFieldWithDefaults":{"description":"description custom data","properties":{"value":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"defaultValue":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{articleId}/listings/{listingId}":{"patch":{"tags":["Article"],"operationId":"partialUpdateListing","parameters":[{"name":"articleId","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"Listing identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","required":false,"style":"form","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleListing"}}}}}}}},"components":{"schemas":{"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"erp-product-ArticleListing":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsListArticleIdentifier"},"name":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"alternativeName":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"description":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"salesChannelRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"descriptionCustom":{"$ref":"#/components/schemas/erp-product-ArticleListing.CustomFieldWithDefaults"},"proposedLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (determined by the system).","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (determined by the system).","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (user-defined input)."},"customLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (user-defined input)."},"categoryRefs":{"type":"array","description":"Categories this listing is assigned to.","items":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}}},"required":["salesChannelRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ArticleListing.WithDefaultsListArticleIdentifier":{"description":"all (external) article numbers (SKU, EAN, ...)","properties":{"value":{"type":"array","description":"Sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Default sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"},"readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Sales channel value."},"defaultValue":{"type":"string","description":"Default sales channel value.","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"erp-product-ArticleListing.CustomFieldWithDefaults":{"description":"description custom data","properties":{"value":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"defaultValue":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{articleId}/listings/{listingId}/state":{"put":{"tags":["Article"],"operationId":"updateListingState","parameters":[{"name":"articleId","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"Listing identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"]}}],"responses":{"200":{"description":"OK"}}}}}}
```

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

> Print a label printing batch

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/print-labels/{batchId}":{"put":{"tags":["Article"],"summary":"Print a label printing batch","operationId":"printBatch","parameters":[{"name":"batchId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-output-OutputRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"common-output-OutputRequest":{"properties":{"exportFormat":{"type":"string","description":"Output format for the mail or file export.","enum":["PDF","XLSX","JSON_RAW","REPORT_TEMPLATE"]},"exportFilename":{"type":"string","description":"File name (without extension) for a file export."},"mailRecipients":{"type":"array","description":"Recipient.","items":{"$ref":"#/components/schemas/common-output-OutputRecipient.MailRecipient"}},"outputType":{"type":"string","description":"outputType"},"groupIdentifier":{"type":"string","description":"OutputReportGroup identifier (optional), otherwise the module default group."},"published":{"type":"boolean","default":false,"description":"Should only documents that are already published be considered?"},"directPrintEnabled":{"type":"boolean","default":true,"description":"Return output directly to the client."}}},"common-output-OutputRecipient.MailRecipient":{"description":"Recipient.","properties":{"type":{"type":"string","description":"(mail) recipient type","enum":["TO","CC","BCC"]},"address":{"type":"string","description":"(mail) recipient address"},"name":{"type":"string","description":"(mail) recipient name"}}}}}}
```

## GET /erp/article-accessories/{id}

> Find an existing Resource by identifier

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/article-accessories/{id}":{"get":{"tags":["Article"],"summary":"Find an existing Resource by identifier","operationId":"getById_78","parameters":[{"name":"id","in":"path","description":"an identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Accessory"}}}},"404":{"description":"Resource with given ID was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-Accessory":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"mainArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accessoryArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"insertQuantity":{"type":"number","description":"Insert quantity."},"insertTerm":{"type":"string","description":"Accessory insert term.","enum":["MANUAL","AUTOMATIC_QUANTITY_IF_ACCESSORY_INSERTED","AUTOMATIC_PROPORTIONAL_QUANTITY","AUTOMATIC_FIXED_QUANTITY"]},"sortOrder":{"type":"integer","format":"int32","description":"Sort order."}},"required":["accessoryArticleRef","insertQuantity","insertTerm","mainArticleRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

## PUT /erp/article-accessories/{id}

> Update existing Resource&#x20;

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/article-accessories/{id}":{"put":{"tags":["Article"],"summary":"Update existing Resource ","operationId":"update_81","parameters":[{"name":"id","in":"path","description":"an identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-Accessory"}}},"required":true},"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Accessory"}}}},"404":{"description":"Resource was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}},"422":{"description":"Resource was not valid to process","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-Accessory":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"mainArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accessoryArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"insertQuantity":{"type":"number","description":"Insert quantity."},"insertTerm":{"type":"string","description":"Accessory insert term.","enum":["MANUAL","AUTOMATIC_QUANTITY_IF_ACCESSORY_INSERTED","AUTOMATIC_PROPORTIONAL_QUANTITY","AUTOMATIC_FIXED_QUANTITY"]},"sortOrder":{"type":"integer","format":"int32","description":"Sort order."}},"required":["accessoryArticleRef","insertQuantity","insertTerm","mainArticleRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

## DELETE /erp/article-accessories/{id}

> Delete an existing Resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/article-accessories/{id}":{"delete":{"tags":["Article"],"summary":"Delete an existing Resource","operationId":"delete_77","parameters":[{"name":"id","in":"path","description":"an identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}},"404":{"description":"Resource was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}},"409":{"description":"unable to delete Resource, due to constraints, existing references or internal state","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

## POST /erp/articles

> Create a new article (optionally with a product)

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles":{"post":{"tags":["Article"],"summary":"Create a new article (optionally with a product)","operationId":"create_72","parameters":[{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","required":false,"style":"form","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-CreateArticleRequestApi"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Article"}}}}}}}},"components":{"schemas":{"erp-product-CreateArticleRequestApi":{"properties":{"productRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"productType":{"type":"string","description":"Article types.","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"]},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"]},"createArticlesOrBundles":{"type":"boolean","default":false,"description":"Create the article or container directly."},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"Eligible for inclusion in order proposals."},"bundle":{"type":"boolean","default":false,"description":"Only when productRef is empty: is this a container?"},"number":{"type":"string","description":"Article number (not when it is a container and a product is given)."},"name":{"type":"string","description":"Label."},"unitTypeRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"productGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"priceUnit":{"type":"number","description":"Price unit."},"taxSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"priceBase":{"type":"string","description":"Price base.","enum":["NET_PRICE","GROSS_PRICE"]},"dropShippingPolicy":{"type":"string","description":"Defines whether and how an article may be sold by drop shipping.","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"bundleSchemaId":{"type":"integer","format":"int64","description":"Template for creating several articles."},"createTemplateId":{"type":"integer","format":"int64","description":"Template for creating an article."},"variantSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"values":{"type":"array","description":"Variant values.","items":{"$ref":"#/components/schemas/common-variant-VariantValueReference"}},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"expiryDateType":{"type":"string","description":"Expiry date type for serial articles.","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"]},"warrantyInMonths":{"type":"integer","format":"int32","description":"Shelf life (in months)."},"serialNumberLabelingType":{"type":"string","description":"Serial number labeling type.","enum":["MANUAL","AUTOMATIC_ON_SUPPLIER_ORDER","AUTOMATIC_ON_SUPPLIER_DELIVERY"]}},"required":["priceUnit"]},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]},"common-variant-VariantValueReference":{"description":"Variant values.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"Label.","readOnly":true},"description":{"type":"string","description":"Description.","readOnly":true},"variantAttributeRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"erp-product-Article":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"active":{"type":"boolean","default":true,"description":"active","readOnly":true},"baseArticle":{"type":"boolean","default":true,"description":"Is this the product's base article?","readOnly":true},"productType":{"type":"string","description":"Article types.","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Price base.","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Expiry date type for serial articles.","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"minimumRemainingDaysBeforeExpiryDateOnGoodsReceipt":{"type":"integer","format":"int32","description":"Minimum remaining shelf life incoming (days): minimum remaining shelf life in days an article must still have when booked into a sales storage.","readOnly":true},"minimumRemainingDaysBeforeExpiryDateForGoodsIssued":{"type":"integer","format":"int32","description":"Minimum remaining shelf life outgoing (days): minimum remaining shelf life in days an article must still have when sold.","readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Warranty in months.","readOnly":true},"lotOnlyRequiredWhenBookedToSalesStorage":{"type":"boolean","default":false,"description":"A lot must be assigned when booking into a sales storage (for serial types LOT and BEST_BEFORE).","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Serial number labeling type.","enum":["MANUAL","AUTOMATIC_ON_SUPPLIER_ORDER","AUTOMATIC_ON_SUPPLIER_DELIVERY"],"readOnly":true},"number":{"type":"string","description":"unique product number","maxLength":255,"minLength":0},"sellable":{"type":"boolean","default":true,"description":"is this product sellable"},"purchasable":{"type":"boolean","default":true,"description":"is this product purchasable"},"solvable":{"type":"boolean","default":false,"description":"is this product solvable to another package-variant"},"mergeable":{"type":"boolean","default":false,"description":"is this product mergeable to another package-variant"},"salesUnit":{"type":"number","description":"Sales unit."},"grossMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"netMetric":{"$ref":"#/components/schemas/erp-product-Article.Metric"},"grossVolumeInCubicMeters":{"type":"number","description":"gross Volume in cubic meters"},"productUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"capacity":{"type":"number","description":"capacity"},"capacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"baseCapacity":{"type":"number","description":"base capacity"},"baseCapacityUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"productRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"productGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"netSalesPrice":{"type":"number","description":"net sales prices"},"grossSalesPrice":{"type":"number","description":"gross sales prices"},"taxSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliveryMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"basePriceUnit":{"type":"number","description":"Base price unit."},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Is the article still deliverable?"},"customsTariffNumber":{"type":"string","description":"Customs tariff number.","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Product tags.","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"Listing identifier."},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Is the tax liability reversed under §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"type":"array","description":"all (external) product numbers (SKU, EAN, ...)","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"name":{"type":"string","description":"name of this product"},"alternativeName":{"type":"string","description":"alternative name of this product"},"description":{"type":"string","description":"description of this product"},"listingDescriptionCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"availabilityDetermination":{"$ref":"#/components/schemas/erp-product-ArticleAvailabilityDetermination"},"listingCustom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"targetTradingMargin":{"type":"number","description":"Target trading margin."},"languageCode":{"type":"string","description":"Restriction to a country."},"dangerousGoodInformation":{"$ref":"#/components/schemas/erp-product-DangerousGoodInformation"},"dangerousGoods":{"type":"boolean","default":false,"description":"The article is dangerous goods."},"availableAlone":{"type":"boolean","default":true,"description":"Is the article deliverable on its own?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Defines how an article may be picked.","enum":["ACCORDING_TO_TEMPLATE","PICKING_ALLOWED","PICKING_NOT_ALLOWED","ONLY_SINGLE_ORDER_PICKING_ALLOWED","ONLY_COLLECTIVE_ORDER_PICKING_ALLOWED"]},"workUnitInMinutes":{"type":"integer","format":"int32","description":"Work unit in minutes.","minimum":0},"initialLastPurchasePrice":{"type":"number","description":"Last purchase price (initial value)."},"initialAvgPurchasePrice":{"type":"number","description":"Average purchase price (initial value)."},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"Should the average purchase price be calculated?"},"commissionable":{"type":"boolean","default":true,"description":"Is this article eligible for commission?"},"cashDiscountable":{"type":"boolean","default":true,"description":"Is this article eligible for the payment discount?"},"discountable":{"type":"boolean","default":true,"description":"Is this article eligible for discount?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Only for quota articles: should the billing print a note that no quota is available?"},"freelyPickable":{"type":"boolean","default":false,"description":"Freely pickable."},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Shipping label printing."},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"Eligible for inclusion in order proposals."},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Defines whether and how an article may be sold by drop shipping.","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Fabrication."},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Manual fabrication only."},"fabricationOfComponents":{"type":"string","description":"Component fabrication.","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"defaultFabricationCost":{"type":"number","description":"Predefined production costs."},"printLabelSettings":{"$ref":"#/components/schemas/erp-product-ArticlePrintLabelSettings"},"manufacturerRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"responsibleUserRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"manufacturerArticleNumber":{"type":"string","description":"Article number."},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Demand determination based on reservations only."},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Special remark."},"note":{"type":"string","description":"Note."},"forcedRecommendedRetailPrice":{"type":"boolean","description":"Is the recommended retail price mandatory?"},"articleAssetInformation":{"$ref":"#/components/schemas/erp-product-ArticleAssetInformation"},"returnable":{"type":"boolean","default":true,"description":"Is this returnable?"},"storageInfo":{"type":"string","description":"Kommissionierungshinweis","maxLength":2147483647,"minLength":0},"priceLookUpCode":{"type":"string","description":"Price look-up code (PLU)."}},"required":["deliverable","dropShippingPolicy","productGroupRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-Article.Metric":{"description":"weight and size w.o. packaging","properties":{"weight":{"type":"number","description":"weight"},"weightUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeUnit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"sizeX":{"type":"number","description":"size"},"sizeY":{"type":"number","description":"size"},"sizeZ":{"type":"number","description":"size"}}},"common-masterdata-CountryReference":{"description":"Country of origin.","properties":{"id":{"type":"integer","format":"int64","description":"Country identifier."},"isoAlpha2":{"type":"string","description":"Country ISO Alpha-2 code."},"isoAlpha3":{"type":"string","description":"Country ISO Alpha-3 code."},"label":{"type":"string","description":"Country label.","readOnly":true}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag types.","enum":["COMMON","ACCOUNT","PRODUCT","ASSET","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Tag label."},"color":{"type":"string","description":"Color for displaying the tag."},"editColor":{"type":"string","description":"Color in the management UI."},"searchColor":{"type":"string","description":"Color in the search UI."},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Availability determination for the article master data and the stock view.","properties":{"inStock":{"type":"string","description":"How the stock is handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"How reserved quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"How ordered quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"How quantities in picking are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"How reorder levels are handled.","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-DangerousGoodInformation":{"description":"Dangerous goods information.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"description":{"type":"string","description":"description"},"shippingName":{"type":"string","description":"shipping name"},"technicalName":{"type":"string","description":"technical name"},"adrNumber":{"type":"string","description":"adr identification number"},"unNumber":{"type":"string","description":"united nations number (un number)"},"identificationClass":{"type":"string","description":"identification class"},"classificationCode":{"type":"string","description":"classification code"},"packingGroup":{"type":"string","description":"packing group (I, II, III or blank)"},"packingCode":{"type":"string","description":"packing code"},"transportCategory":{"type":"string","description":"transportation category"},"regulationCode":{"type":"string","description":"regulation code","enum":["FR","LQ","EQ","LR"]},"regulationSet":{"type":"string","description":"regulation Set, e.g. ADR","enum":["ADR","IATA"]},"hazardousWeight":{"type":"number","description":"weight of the hazardous part"},"subsidiaryRisk":{"type":"boolean","default":false,"description":"secundary risk of the dangerous good"},"tunnelRestrictionCode":{"type":"string","description":"tunnel restriction classes","enum":["A","B","C","D","E"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Label printing settings.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"report":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"incomingCalculationMode":{"type":"string","description":"Incoming goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Incoming goods: print quantity."},"outgoingCalculationMode":{"type":"string","description":"Outgoing goods: print quantity determination.","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Outgoing goods: print quantity."}}},"erp-product-ArticleAssetInformation":{"description":"Information about the connection between the asset and the Article.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"createAssetOnStorageEntry":{"type":"boolean","default":false,"description":"Create assets automatically on stock receipt."},"createAssetOnSale":{"type":"boolean","default":false,"description":"Create the asset automatically on sale."},"createAssetOnDocumentCategory":{"type":"string","description":"Create the asset for this document category.","enum":["CUSTOMER_DELIVERY","CUSTOMER_INVOICE"]},"createWithAssetType":{"$ref":"#/components/schemas/erp-asset-AssetType"}}},"erp-asset-AssetType":{"description":"Asset.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"label":{"type":"string","description":"Label."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}}}}}}
```

## GET /erp/articles/{id}/taxes

> Find all existing article-taxes

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/taxes":{"get":{"tags":["Article"],"summary":"Find all existing article-taxes","operationId":"getTaxes","parameters":[{"name":"id","in":"path","description":"ID of Article","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/erp-product-ArticleTax"}}}}},"404":{"description":"Resource with given ID was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-ArticleTax":{"description":"Article tax assignment.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"typeRef":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"},"countryCode":{"type":"string","description":"the country, this entry is valid for","minLength":1},"validFrom":{"type":"string","format":"date","description":"the date, this entry is valid from"},"articleId":{"type":"integer","format":"int64","description":"the date, this entry is valid from","readOnly":true}},"required":["countryCode","typeRef","validFrom"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

## POST /erp/articles/{id}/taxes

> Create new ProductTax

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/taxes":{"post":{"tags":["Article"],"summary":"Create new ProductTax","operationId":"createTax","parameters":[{"name":"id","in":"path","description":"ID of Article","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleTax"}}},"required":true},"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleTax"}}}},"422":{"description":"Resource was not valid to process","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-ArticleTax":{"description":"Article tax assignment.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"typeRef":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"},"countryCode":{"type":"string","description":"the country, this entry is valid for","minLength":1},"validFrom":{"type":"string","format":"date","description":"the date, this entry is valid from"},"articleId":{"type":"integer","format":"int64","description":"the date, this entry is valid from","readOnly":true}},"required":["countryCode","typeRef","validFrom"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

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

> Check whether a resource is locked

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/leasable-lock":{"get":{"tags":["Article"],"summary":"Check whether a resource is locked","operationId":"getLeasableLock_1","parameters":[{"name":"id","in":"path","description":"Resource identifier.","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-unknownmodule-LeasableLock"}}}}}}}},"components":{"schemas":{"core-unknownmodule-LeasableLock":{"properties":{"key":{"type":"string","minLength":1},"token":{"type":"integer","format":"int64"},"userId":{"type":"integer","format":"int64"},"lockedBySystem":{"type":"boolean"},"validUntil":{"type":"string","format":"date-time"},"id":{"type":"string","description":"Unique identifier of the Object","readOnly":true}},"required":["key","token"]}}}}
```

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

> Create a new lock, optionally with a validity period

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/leasable-lock":{"post":{"tags":["Article"],"summary":"Create a new lock, optionally with a validity period","operationId":"createLeasableLock_1","parameters":[{"name":"id","in":"path","description":"Identifier of the resource to lock.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"leasePeriod","in":"query","description":"Optional lease duration in seconds.","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-unknownmodule-LeasableLock"}}}}}}}},"components":{"schemas":{"core-unknownmodule-LeasableLock":{"properties":{"key":{"type":"string","minLength":1},"token":{"type":"integer","format":"int64"},"userId":{"type":"integer","format":"int64"},"lockedBySystem":{"type":"boolean"},"validUntil":{"type":"string","format":"date-time"},"id":{"type":"string","description":"Unique identifier of the Object","readOnly":true}},"required":["key","token"]}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/fabrication-components":{"get":{"tags":["Article"],"operationId":"getFabricationComponents","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/erp-product-ArticleFabricationComponent"}}}}}}}}},"components":{"schemas":{"erp-product-ArticleFabricationComponent":{"description":"Fabrication article component.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"fabricationArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"componentArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"sourceBundleArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"quantity":{"type":"number","description":"Quantity."},"deviatingUnitRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"deviatingUnitPrice":{"type":"number","description":"Deviating production costs."},"name":{"type":"string","description":"Label.","maxLength":255,"minLength":0},"description":{"type":"string","description":"Description.","maxLength":2147483647,"minLength":0},"forSerialInheritance":{"type":"boolean","default":false,"description":"Basis for inheriting the serial number."},"sortOrder":{"type":"integer","format":"int32","description":"Sort order."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}},"required":["componentArticleRef","fabricationArticleRef","quantity"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ProductArticleRef":{"description":"All articles belonging to this product.","properties":{"id":{"type":"integer","format":"int64","description":"Article identifier."},"number":{"type":"string","description":"Article number"},"name":{"type":"string","description":"Label."},"description":{"type":"string","description":"Description."},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"]},"unit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"}},"required":["unit"]},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/fabrication-components":{"post":{"tags":["Article"],"operationId":"createFabricationComponent","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleFabricationComponent"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleFabricationComponent"}}}}}}}},"components":{"schemas":{"erp-product-ArticleFabricationComponent":{"description":"Fabrication article component.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"fabricationArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"componentArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"sourceBundleArticleRef":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"quantity":{"type":"number","description":"Quantity."},"deviatingUnitRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"deviatingUnitPrice":{"type":"number","description":"Deviating production costs."},"name":{"type":"string","description":"Label.","maxLength":255,"minLength":0},"description":{"type":"string","description":"Description.","maxLength":2147483647,"minLength":0},"forSerialInheritance":{"type":"boolean","default":false,"description":"Basis for inheriting the serial number."},"sortOrder":{"type":"integer","format":"int32","description":"Sort order."},"active":{"type":"boolean","default":true,"description":"Is this active?","readOnly":true}},"required":["componentArticleRef","fabricationArticleRef","quantity"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ProductArticleRef":{"description":"All articles belonging to this product.","properties":{"id":{"type":"integer","format":"int64","description":"Article identifier."},"number":{"type":"string","description":"Article number"},"name":{"type":"string","description":"Label."},"description":{"type":"string","description":"Description."},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"]},"unit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"}},"required":["unit"]},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]}}}}
```

## GET /erp/articles/{id}/components

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/components":{"get":{"tags":["Article"],"operationId":"getComponents","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleComponentCollection"}}}}}}}},"components":{"schemas":{"erp-product-ArticleComponentCollection":{"description":"Assembly or jumbo article components with totals.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"components":{"type":"array","description":"All components belonging to this product.","items":{"$ref":"#/components/schemas/erp-product-ArticleComponent"}},"totalSalesPrice":{"type":"number","description":"Total of the component sales prices."},"totalPurchasePrice":{"type":"number","description":"Total of the component purchase prices."},"totalNetWeight":{"type":"number","description":"Total of the component net weights."},"totalGrossWeight":{"type":"number","description":"Total of the component gross weights."}},"required":["components"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ArticleComponent":{"description":"Assembly or jumbo article components.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"containerArticleId":{"type":"integer","format":"int64","description":"Assembly or jumbo article."},"componentArticleId":{"type":"integer","format":"int64","description":"Component article."},"number":{"type":"string","description":"Component article number."},"name":{"type":"string","description":"Component name."},"description":{"type":"string","description":"Component description."},"quantity":{"type":"number","description":"Component quantity."},"position":{"type":"integer","format":"int32","description":"Component position within the container."},"salesPrice":{"type":"number","description":"Component sales price."},"purchasePrice":{"type":"number","description":"Component purchase price (average)."},"grossWeight":{"type":"number","description":"Component gross weight."},"netWeight":{"type":"number","description":"Component net weight."},"stockAmount":{"type":"number","description":"Component stock."},"stockAvailable":{"type":"number","description":"Available component quantity."}},"required":["componentArticleId","containerArticleId"]}}}}
```

## POST /erp/articles/{id}/components

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/components":{"post":{"tags":["Article"],"operationId":"createComponent","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleComponent"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleComponent"}}}}}}}},"components":{"schemas":{"erp-product-ArticleComponent":{"description":"Assembly or jumbo article components.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"containerArticleId":{"type":"integer","format":"int64","description":"Assembly or jumbo article."},"componentArticleId":{"type":"integer","format":"int64","description":"Component article."},"number":{"type":"string","description":"Component article number."},"name":{"type":"string","description":"Component name."},"description":{"type":"string","description":"Component description."},"quantity":{"type":"number","description":"Component quantity."},"position":{"type":"integer","format":"int32","description":"Component position within the container."},"salesPrice":{"type":"number","description":"Component sales price."},"purchasePrice":{"type":"number","description":"Component purchase price (average)."},"grossWeight":{"type":"number","description":"Component gross weight."},"netWeight":{"type":"number","description":"Component net weight."},"stockAmount":{"type":"number","description":"Component stock."},"stockAvailable":{"type":"number","description":"Available component quantity."}},"required":["componentArticleId","containerArticleId"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}}}}}
```

## GET /erp/articles/{articleId}/listings

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{articleId}/listings":{"get":{"tags":["Article"],"operationId":"getAllListings","parameters":[{"name":"articleId","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","required":false,"style":"form","schema":{"type":"string"}},{"name":"allSalesChannels","in":"query","description":"Should all SalesChannels be read, including those without a listing?","required":false,"style":"form","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/erp-product-ArticleListing"}}}}}}}}},"components":{"schemas":{"erp-product-ArticleListing":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsListArticleIdentifier"},"name":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"alternativeName":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"description":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"salesChannelRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"descriptionCustom":{"$ref":"#/components/schemas/erp-product-ArticleListing.CustomFieldWithDefaults"},"proposedLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (determined by the system).","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (determined by the system).","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (user-defined input)."},"customLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (user-defined input)."},"categoryRefs":{"type":"array","description":"Categories this listing is assigned to.","items":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}}},"required":["salesChannelRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ArticleListing.WithDefaultsListArticleIdentifier":{"description":"all (external) article numbers (SKU, EAN, ...)","properties":{"value":{"type":"array","description":"Sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Default sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"},"readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Sales channel value."},"defaultValue":{"type":"string","description":"Default sales channel value.","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"erp-product-ArticleListing.CustomFieldWithDefaults":{"description":"description custom data","properties":{"value":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"defaultValue":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}}}}}
```

## POST /erp/articles/{articleId}/listings

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{articleId}/listings":{"post":{"tags":["Article"],"operationId":"createListing","parameters":[{"name":"articleId","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","required":false,"style":"form","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleListing"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ArticleListing"}}}}}}}},"components":{"schemas":{"erp-product-ArticleListing":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"Should the article be listed?"},"listingState":{"type":"string","description":"Listing synchronization status.","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"Last listingState update.","readOnly":true},"identifiers":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsListArticleIdentifier"},"name":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"alternativeName":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"description":{"$ref":"#/components/schemas/erp-product-ArticleListing.WithDefaultsString"},"salesChannelRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"custom":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"descriptionCustom":{"$ref":"#/components/schemas/erp-product-ArticleListing.CustomFieldWithDefaults"},"proposedLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (determined by the system).","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (determined by the system).","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Lowest net price of the last 30 days (user-defined input)."},"customLowestPriceGross":{"type":"number","description":"Lowest gross price of the last 30 days (user-defined input)."},"categoryRefs":{"type":"array","description":"Categories this listing is assigned to.","items":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}}},"required":["salesChannelRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-product-ArticleListing.WithDefaultsListArticleIdentifier":{"description":"all (external) article numbers (SKU, EAN, ...)","properties":{"value":{"type":"array","description":"Sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Default sales channel value.","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"},"readOnly":true}}},"erp-product-ArticleIdentifier":{"description":"all (external) product numbers (SKU, EAN, ...)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"value":{"type":"string","description":"identifier","maxLength":255,"minLength":0},"name":{"type":"string","description":"identifier type","maxLength":255,"minLength":0},"defaultArticleIdentifier":{"type":"boolean","default":false,"description":"Is this the default article identifier?"}},"required":["defaultArticleIdentifier","name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Sales channel value."},"defaultValue":{"type":"string","description":"Default sales channel value.","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"erp-product-ArticleListing.CustomFieldWithDefaults":{"description":"description custom data","properties":{"value":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"defaultValue":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}}}}}
```

## POST /erp/articles/print-labels

> Create a label printing batch

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/print-labels":{"post":{"tags":["Article"],"summary":"Create a label printing batch","operationId":"createPrintOrder","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/erp-product-ArticlePrintLabelOrderRequest"}}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string","format":"uuid"}}}}}}}},"components":{"schemas":{"erp-product-ArticlePrintLabelOrderRequest":{"description":"Request specifying which articles are printed how often.","properties":{"position":{"type":"integer","format":"int32","description":"Print order."},"article":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"report":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"serialNumber":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"documentLine":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"documentLineComponent":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"picklistLine":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"picklistLineComponent":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"print":{"type":"boolean","default":false,"description":"Label printing."},"quantity":{"type":"integer","format":"int32","default":1,"description":"Quantity."},"languageCode":{"type":"string","description":"Language (ISO Alpha-2)."}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]}}}}
```

## POST /erp/article-accessories/

> Create new Resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/article-accessories/":{"post":{"tags":["Article"],"summary":"Create new Resource","operationId":"create_77","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-Accessory"}}},"required":true},"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Accessory"}}}},"422":{"description":"Resource was not valid to process","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-product-Accessory":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"mainArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accessoryArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"insertQuantity":{"type":"number","description":"Insert quantity."},"insertTerm":{"type":"string","description":"Accessory insert term.","enum":["MANUAL","AUTOMATIC_QUANTITY_IF_ACCESSORY_INSERTED","AUTOMATIC_PROPORTIONAL_QUANTITY","AUTOMATIC_FIXED_QUANTITY"]},"sortOrder":{"type":"integer","format":"int32","description":"Sort order."}},"required":["accessoryArticleRef","insertQuantity","insertTerm","mainArticleRef"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

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

> Return the current workflow instance state for the given reference

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{refId}/workflow-state":{"get":{"tags":["Article"],"summary":"Return the current workflow instance state for the given reference","operationId":"getWorkflowState_3","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow instance found.","content":{"*/*":{"schema":{"type":"string","description":"Workflow instance status.","enum":["CREATED","IN_PROCESS","COMPLETED_SUCCESSFULLY","COMPLETED_WITH_FAILURE","ERRONEOUS","ABORTED_CRASHED","ABORTED_MANUALLY","CRASHED","WAITING","INTERRUPTED"]}}}},"404":{"description":"No workflow instance exists yet.","content":{"*/*":{"schema":{"type":"string","description":"Workflow instance status.","enum":["CREATED","IN_PROCESS","COMPLETED_SUCCESSFULLY","COMPLETED_WITH_FAILURE","ERRONEOUS","ABORTED_CRASHED","ABORTED_MANUALLY","CRASHED","WAITING","INTERRUPTED"]}}}}}}}}}
```

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

> Return a query preset for selecting all workflow instances for the given reference

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{refId}/workflow-instances-preset":{"get":{"tags":["Article"],"summary":"Return a query preset for selecting all workflow instances for the given reference","operationId":"getWorkflowInstancesPreset_3","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow instance found.","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-cunit-QueryPreset"}}}}}}}},"components":{"schemas":{"common-cunit-QueryPreset":{"description":"Adhoc Preset","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"mode":{"type":"string","default":"QUERY","description":"What this preset can represent, QUERY or STATEMENT.","enum":["QUERY","STATEMENT"]},"templateId":{"type":"string","description":"Template this filter was assigned to.","minLength":1},"templateGroupKey":{"type":"string","description":"The templateGroupKey this filter was assigned to.","minLength":1},"label":{"type":"string","description":"Filter label.","minLength":1},"uiPayload":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"variables":{"type":"array","description":"Variables for this preset.","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetVariable"}},"queryStatement":{"type":"string","description":"When mode == STATEMENT, the VQL query."},"queryPredicate":{"$ref":"#/components/schemas/common-cunit-QueryPresetPredicate"},"results":{"type":"array","description":"Results.","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"}},"sortAndOrders":{"type":"array","description":"Sort order.","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetSortOrder"}},"pageable":{"$ref":"#/components/schemas/common-cunit-QueryPresetPageable"},"option":{"$ref":"#/components/schemas/common-cunit-QueryPresetOption"},"transformations":{"type":"array","description":"Additional configurations.","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetTransformation"}},"arithmeticQueryTerms":{"type":"array","description":"Arithmetic terms - this is where the actual calculation goes.","items":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTerm"}},"definition":{"type":"array","description":"Cell column description (when nested).","items":{"$ref":"#/components/schemas/core-cunit-MetaContent"},"readOnly":true},"permissionAggregation":{"$ref":"#/components/schemas/common-user-ObjectSpecificPermissionAggregation"},"forWorkflow":{"type":"boolean","default":false,"description":"Intended for workflows."},"outputReportGroupIdentifier":{"type":"string","description":"Identifier of an OutputReportGroup (moduleKey=cunit) used as the print template for this preset."},"userOptions":{"$ref":"#/components/schemas/common-cunit-QueryPresetUserOptions"}},"required":["forWorkflow","label","mode","permissionAggregation","templateGroupKey","templateId"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"common-cunit-QueryPresetVariable":{"description":"Variable to replace.","properties":{"path":{"type":"string","description":"Path that uniquely describes this attribute."},"definition":{"$ref":"#/components/schemas/core-cunit-MetaContent"},"mandatory":{"type":"boolean","description":"Whether the variable is mandatory or not."},"variableName":{"type":"string","description":"Variable name."},"visible":{"type":"boolean","default":true,"description":"Is this a visible variable?"},"alignX":{"type":"integer","format":"int32","description":"Layout in the UI - x coordinate."},"alignY":{"type":"integer","format":"int32","description":"Layout in the UI - y coordinate."},"alignWidth":{"type":"integer","format":"int32","description":"Layout in the UI - width."},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"allowDialogMultipleChoice":{"type":"boolean","default":false,"description":"Is a multiple selection allowed?"}}},"core-cunit-MetaContent":{"description":"Variable definition.","discriminator":{"propertyName":"_type"},"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuMeta"},{"$ref":"#/components/schemas/core-cunit-CuAttribute"}],"properties":{"_type":{"type":"string"}},"required":["_type"]},"core-cunit-CuMeta":{"allOf":[{"$ref":"#/components/schemas/core-cunit-MetaContent"},{"type":"object","properties":{"definition":{"$ref":"#/components/schemas/core-cunit-CuAttribute"},"value":{"type":"array","description":"Cell column description (when nested).","items":{"$ref":"#/components/schemas/core-cunit-MetaContent"}}}}]},"core-cunit-CuAttribute":{"allOf":[{"$ref":"#/components/schemas/core-cunit-MetaContent"},{"type":"object","properties":{"key":{"type":"string","description":"Unique key identifying the attribute."},"attribute":{"type":"string","description":"Name of the attribute containing the result."},"path":{"type":"string","description":"Path that uniquely describes this attribute."},"displayName":{"type":"string","description":"Field name."},"displayNameOverride":{"type":"boolean","default":false,"description":"The field name was overridden (alias or function)."},"groupDisplayName":{"type":"string","description":"Field group name."},"parentDisplayName":{"type":"string","description":"Referencing field name."},"resultable":{"type":"boolean","default":true,"description":"Can this field be a result field?"},"filterable":{"type":"boolean","default":true,"description":"Can this field be filtered by?"},"sortable":{"type":"boolean","default":true,"description":"Is this field sortable?"},"visible":{"type":"boolean","default":true,"description":"Should this field be shown?"},"functions":{"type":"array","description":"Applied functions (when this is used as result metadata).","items":{"type":"string","description":"Applied functions (when this is used as result metadata)."}},"sortDirection":{"type":"string","description":"Information on how this column was sorted."},"constraint":{"$ref":"#/components/schemas/core-cunit-CuAttributeConstraint"},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"Attribute data type identifier (when dataType is empty).","readOnly":true},"modelType":{"type":"string","description":"The attribute belongs to the model type 'static' or 'dynamic'.","enum":["STATIC","DYNAMIC"],"readOnly":true},"entityIdentifier":{"type":"string","description":"Identifier of the entity this attribute belongs to (e.g. 'AccountEntity').","readOnly":true},"referencedEntityIdentifier":{"type":"string","description":"For relation attributes: fully qualified class name of the target entity (e.g. 'ag.vario.erp.account.AccountEntity').","readOnly":true},"headers":{"type":"array","description":"For a grouped header (e.g. a cross table) the individual groups are described here.","items":{"$ref":"#/components/schemas/core-cunit-CuAttribute.HeaderGroup"},"readOnly":true}}}]},"core-cunit-CuAttributeConstraint":{"description":"Attribute constraints.","properties":{"minLength":{"type":"integer","format":"int32","description":"Minimum length (of strings or arrays).","readOnly":true},"maxLength":{"type":"integer","format":"int32","description":"Maximum length (of strings or arrays).","readOnly":true},"minValue":{"type":"integer","format":"int64","description":"Minimum value.","readOnly":true},"includeMinValue":{"type":"boolean","description":"Is the minimum value inclusive?","readOnly":true},"maxValue":{"type":"integer","format":"int64","description":"Maximum value.","readOnly":true},"includeMaxValue":{"type":"boolean","description":"Is the maximum value inclusive?","readOnly":true},"notNull":{"type":"boolean","default":false,"description":"Is the value 'null' forbidden?","readOnly":true},"notBlank":{"type":"boolean","description":"For strings: is a string consisting only of whitespace forbidden?","readOnly":true},"digitsFraction":{"type":"integer","format":"int32","description":"Maximum number of decimal places.","readOnly":true}}},"core-cunit-CuAttributeDataType":{"description":"Attribute data type (when dataTypeIdentifier is empty).","properties":{"identifier":{"type":"string","description":"Datentyp-identifier","readOnly":true},"jsType":{"type":"string","description":"Which type it is.","readOnly":true},"objectRefIdentifier":{"type":"string","description":"For Object_Ref: which type exactly it is.","readOnly":true},"filterOptions":{"$ref":"#/components/schemas/core-cunit-CuAttributeFilterOptions"},"functions":{"type":"array","description":"Which functions are allowed?","items":{"type":"string","description":"Which functions are allowed?"},"readOnly":true},"predicateOperations":{"type":"array","description":"Which operations are allowed?","items":{"type":"string","description":"Which operations are allowed?","enum":["AND","OR","EQUALS","NOT_EQUALS","LIKE","NOT_LIKE","STARTS_WITH","ENDS_WITH","CONTAINS","NOT_CONTAINS","GREATER_THAN","GREATER_THAN_EQUALS","LESS_THAN","LESS_THAN_EQUALS","IN","NOT_IN","RANGE","NOT_RANGE","IS_NULL","IS_NOT_NULL","IS_NULL_OR_EQUALS","EXISTS","NOT_EXISTS"]},"readOnly":true}}},"core-cunit-CuAttributeFilterOptions":{"description":"CUnit attribute filter options.","properties":{"filterValues":{"type":"array","description":"Possible filter values.","items":{"type":"string","description":"Possible filter values."}},"filterDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"multipleChoice":{"type":"boolean","default":false,"description":"Is a multiple selection allowed?"}}},"core-cunit-CuAttribute.HeaderGroup":{"description":"For a grouped header (e.g. a cross table) the individual groups are described here.","properties":{"displayName":{"type":"string","description":"Field name."},"displayNameOverride":{"type":"boolean","default":false,"description":"The field name was overridden (alias or function)."},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"Attribute data type identifier (when dataType is empty).","readOnly":true},"groupDisplayName":{"type":"string","description":"Field group name."},"data":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}},"common-cunit-QueryPresetPredicate":{"description":"Conditions for selecting storage bins.","properties":{"type":{"type":"string","description":"Filter operation.","enum":["JUNCTION","FILTER"]},"operator":{"type":"string","description":"operator","enum":["AND","OR","EQUALS","NOT_EQUALS","LIKE","NOT_LIKE","STARTS_WITH","ENDS_WITH","CONTAINS","NOT_CONTAINS","GREATER_THAN","GREATER_THAN_EQUALS","LESS_THAN","LESS_THAN_EQUALS","IN","NOT_IN","RANGE","NOT_RANGE","IS_NULL","IS_NOT_NULL","IS_NULL_OR_EQUALS","EXISTS","NOT_EXISTS"]},"children":{"type":"array","description":"Child definitions (for a junction).","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetPredicate"}},"property":{"type":"string","description":"filter property"},"values":{"type":"array","description":"Filter values.","items":{"type":"string","description":"Filter values."}},"visible":{"type":"boolean","default":true,"description":"Visibility for variables."},"functions":{"type":"array","description":"SQL function applied in the predicate.","items":{"type":"string","description":"SQL function applied in the predicate."}}},"required":["operator","type"]},"common-cunit-QueryPresetResult":{"description":"Results.","properties":{"property":{"type":"string","description":"property","minLength":1},"displayName":{"type":"string","description":"Column title."},"functions":{"type":"array","description":"Functions.","items":{"type":"string","description":"Functions."}},"visible":{"type":"boolean","default":true,"description":"Visible result column."}},"required":["property"]},"common-cunit-QueryPresetSortOrder":{"description":"Sort and order instructions.","properties":{"property":{"type":"string","description":"property","minLength":1},"functions":{"type":"array","description":"Functions","items":{"type":"string","description":"Functions"}},"direction":{"type":"string","description":"sort order","enum":["ASC","DESC"]}},"required":["direction","property"]},"common-cunit-QueryPresetPageable":{"description":"pageable","properties":{"limit":{"type":"integer","format":"int64","description":"Query limit (MaxRecordCount)."}}},"common-cunit-QueryPresetOption":{"description":"options","properties":{"distinctResult":{"type":"boolean","description":"Should the query be executed with a DISTINCT?"}}},"common-cunit-QueryPresetTransformation":{"description":"Additional configurations.","properties":{"crossTable":{"$ref":"#/components/schemas/common-cunit-QueryPresetCrossTableTransformation"}}},"common-cunit-QueryPresetCrossTableTransformation":{"description":"Contains the fields responsible for forming the rows in a cross table (essentially the group key).","properties":{"rowSpecs":{"type":"array","description":"Contains the fields responsible for forming the rows in a cross table (essentially the group key).","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"},"minItems":1},"columnSpecs":{"type":"array","description":"Contains the fields that are created as dynamic columns in the cross table.","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"},"minItems":1},"results":{"type":"array","description":"Contains the fields that are determined per rowSpec combination depending on the column value.","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetCrossTableTransformation.QueryPresetCrossTableCell"},"minItems":1}},"required":["columnSpecs","results","rowSpecs"]},"common-cunit-QueryPresetCrossTableTransformation.QueryPresetCrossTableCell":{"description":"Contains the fields that are determined per rowSpec combination depending on the column value.","properties":{"result":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"},"cellView":{"type":"string","description":"Value representation.","enum":["AS_IS","PERCENT_COL"]},"sumColumn":{"type":"boolean","default":false,"description":"Should a column total be created?"},"rowMode":{"type":"string","description":"Should a row total be created?","enum":["DATA","DATA_AND_TOTAL","TOTAL"]},"aggregateFunction":{"type":"string","description":"Function the cell values are aggregated with."}}},"common-cunit-ArithmeticQueryTerm":{"description":"Arithmetic terms - this is where the actual calculation goes.","properties":{"termName":{"type":"string","description":"Term name for processing and display."},"terms":{"type":"array","description":"Inner terms - either references to attributes or further nestings of the calculation.","items":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTermInner"}},"operations":{"type":"array","description":"Operations to be performed on the terms.","items":{"type":"string","description":"Operations to be performed on the terms.","enum":["PLUS","MINUS","MULTIPLY","DIVIDE"]}}}},"common-cunit-ArithmeticQueryTermInner":{"description":"Inner terms - either references to attributes or further nestings of the calculation.","properties":{"fragment":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTermFragment"},"attribute":{"type":"string","description":"Actual attribute from the template."},"fixedValue":{"type":"number","description":"Fixed value."}}},"common-cunit-ArithmeticQueryTermFragment":{"description":"Term fragment - a further nesting with its own operations.","properties":{"terms":{"type":"array","description":"Inner terms - either references to attributes or further nestings of the calculation.","items":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTermInner"}},"operations":{"type":"array","description":"Operations to be performed on the terms.","items":{"type":"string","description":"Operations to be performed on the terms.","enum":["PLUS","MINUS","MULTIPLY","DIVIDE"]}}}},"common-user-ObjectSpecificPermissionAggregation":{"description":"All user and group permissions.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"userPermissions":{"type":"array","description":"User permissions.","items":{"$ref":"#/components/schemas/common-user-ObjectSpecificUserPermission"}},"groupPermissions":{"type":"array","description":"Group permissions.","items":{"$ref":"#/components/schemas/common-user-ObjectSpecificGroupPermission"}},"operationForAllUsers":{"type":"string","description":"Access rights for all users.","enum":["READ_ONLY","READ_AND_EDIT"]}}},"common-user-ObjectSpecificUserPermission":{"description":"User permissions.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"userRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"operation":{"type":"string","description":"Permission.","enum":["READ_ONLY","READ_AND_EDIT"]}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"common-user-ObjectSpecificGroupPermission":{"description":"Group permissions.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"groupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"operation":{"type":"string","description":"Permission.","enum":["READ_ONLY","READ_AND_EDIT"]}}},"common-cunit-QueryPresetUserOptions":{"description":"User-related settings.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"pinned":{"type":"boolean","default":false,"description":"Is this pinned?"}},"required":["pinned"]}}}}
```

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

> Return the latest workflow instance for the given reference

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{refId}/latest-workflow-instance":{"get":{"tags":["Article"],"summary":"Return the latest workflow instance for the given reference","operationId":"getLatestWorkflowInstance_3","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow instance found.","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-workflow-WorkflowInstance"}}}},"404":{"description":"No workflow instance exists yet.","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-workflow-WorkflowInstance"}}}}}}}},"components":{"schemas":{"common-workflow-WorkflowInstance":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"state":{"type":"string","description":"Workflow instance status.","enum":["CREATED","IN_PROCESS","COMPLETED_SUCCESSFULLY","COMPLETED_WITH_FAILURE","ERRONEOUS","ABORTED_CRASHED","ABORTED_MANUALLY","CRASHED","WAITING","INTERRUPTED"]},"workflowRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"workItems":{"type":"array","description":"Workflow steps.","items":{"$ref":"#/components/schemas/common-workflow-WorkItem"}},"logEntries":{"type":"array","description":"Log entries sorted chronologically.","items":{"$ref":"#/components/schemas/common-workflow-WorkflowInstanceLogLine"}}}},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"common-workflow-WorkItem":{"description":"Workflow steps.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"state":{"type":"string","description":"Work item processing state.","enum":["OPEN","IN_PROCESS","COMPLETED","ERRONEOUS","ABORTED","ABORTED_BY_SUB_WORKFLOW"]},"workflowElementRef":{"type":"integer","format":"int64","description":"Workflow element that is represented."},"parentWorkItemRef":{"type":"integer","format":"int64","description":"Work item in the parent workflow when this is a sub workflow."},"responsibleUserRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"logEntries":{"type":"array","description":"Log entries sorted chronologically.","items":{"$ref":"#/components/schemas/common-workflow-WorkflowInstanceLogLine"}},"splitResult":{"type":"string","description":"For split gateways: with which result this work item was executed."}}},"common-workflow-WorkflowInstanceLogLine":{"description":"Log entries sorted chronologically.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"workflowInstanceId":{"type":"integer","format":"int64","description":"Workflow instance identifier."},"workItemId":{"type":"integer","format":"int64","description":"Work item identifier."},"logTime":{"type":"string","format":"date-time","description":"Timestamp."},"origin":{"type":"string","description":"What triggered this entry?","enum":["DEBUG","INFO","WARNING","ERROR","CONSOLE","STACKTRACE"]},"message":{"type":"string","description":"Message."},"messageKey":{"type":"string","description":"The i18n key."},"propertyPath":{"type":"string","description":"Path."},"messageParameter":{"type":"object","additionalProperties":{"type":"object","description":"Parameters for the i18n message."},"description":"Parameters for the i18n message."}}}}}}
```

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

> find all active ui hints of one article

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/ui-hints":{"get":{"tags":["Article"],"summary":"find all active ui hints of one article","operationId":"queryUiHints","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"type":"array","items":{"type":"string"}}}}},"404":{"description":"Resource with given ID was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Search dialogs to use.","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Search dialogs to use.","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Key for the search dialog result.","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}}}}}
```

## GET /erp/articles/{id}/products

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/products":{"get":{"tags":["Article"],"operationId":"getProductByArticleId","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-Product"}}}}}}}},"components":{"schemas":{"erp-product-Product":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"bundle":{"type":"boolean","default":false,"description":"Is this a container?"},"bundleSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"type":{"type":"string","description":"Article types.","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"]},"articleRefs":{"type":"array","description":"All articles belonging to this product.","items":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"readOnly":true},"availabilityDetermination":{"$ref":"#/components/schemas/erp-product-ArticleAvailabilityDetermination"},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"]},"expiryDateType":{"type":"string","description":"Expiry date type for serial articles.","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"]},"minimumRemainingDaysBeforeExpiryDateOnGoodsReceipt":{"type":"integer","format":"int32","description":"Minimum remaining shelf life incoming (days): minimum remaining shelf life in days an article must still have when booked into a sales storage."},"minimumRemainingDaysBeforeExpiryDateForGoodsIssued":{"type":"integer","format":"int32","description":"Minimum remaining shelf life outgoing (days): minimum remaining shelf life in days an article must still have when sold."},"warrantyInMonths":{"type":"integer","format":"int32","description":"Warranty in months."},"lotOnlyRequiredWhenBookedToSalesStorage":{"type":"boolean","default":false,"description":"A lot must be assigned when booking into a sales storage (for serial types LOT and BEST_BEFORE)."},"serialNumberLabelingType":{"type":"string","description":"Serial number labeling type.","enum":["MANUAL","AUTOMATIC_ON_SUPPLIER_ORDER","AUTOMATIC_ON_SUPPLIER_DELIVERY"]},"fabricationSerialNumberLabelingType":{"type":"string","description":"Fabrication serial number labeling type.","enum":["QUERY_ON_START","QUERY_ON_FINISH","INHERITANCE","AUTOMATICALLY_ON_START","AUTOMATICALLY_ON_FINISH"]},"customsTariffNumber":{"type":"string","description":"Customs tariff number.","maxLength":15,"minLength":0},"countryOfOrigin":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"regionOfOrigin":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"useSerialSequencerConfiguration":{"type":"boolean","description":"Should an own number range be used for the serial numbers?"},"serialSequencerConfiguration":{"$ref":"#/components/schemas/common-sequencer-SequencerConfiguration"},"variantValues":{"type":"array","description":"Variant values.","items":{"$ref":"#/components/schemas/common-variant-VariantValueReference"}},"variantSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"mainVariantProductRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}}},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]},"erp-product-ProductArticleRef":{"description":"All articles belonging to this product.","properties":{"id":{"type":"integer","format":"int64","description":"Article identifier."},"number":{"type":"string","description":"Article number"},"name":{"type":"string","description":"Label."},"description":{"type":"string","description":"Description."},"serialType":{"type":"string","description":"Article serial type.","enum":["NONE","SERIAL_NUMBER","LOT","BEST_BEFORE","DOUBLE_SERIAL_NUMBER"]},"unit":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"}},"required":["unit"]},"common-masterdata-UnitTypeReference":{"description":"net weight unit","properties":{"id":{"type":"integer","format":"int64","description":"unit type id"},"name":{"type":"string","description":"descriptive name","maxLength":255,"minLength":0},"abbreviation":{"type":"string","description":"unique abbreviation","maxLength":255,"minLength":0}},"required":["abbreviation"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Availability determination for the article master data and the stock view.","properties":{"inStock":{"type":"string","description":"How the stock is handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"How reserved quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"How ordered quantities are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"How quantities in picking are handled.","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"How reorder levels are handled.","enum":["IGNORE","ADD","SUBTRACT"]}}},"common-masterdata-CountryReference":{"description":"Country of origin.","properties":{"id":{"type":"integer","format":"int64","description":"Country identifier."},"isoAlpha2":{"type":"string","description":"Country ISO Alpha-2 code."},"isoAlpha3":{"type":"string","description":"Country ISO Alpha-3 code."},"label":{"type":"string","description":"Country label.","readOnly":true}}},"common-sequencer-SequencerConfiguration":{"description":"Own number range for serial numbers.","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"key":{"type":"string","description":"Unique key to identify the sequencer configuration","readOnly":true},"configurationGroup":{"type":"string","description":"Group of the sequencer configuration (e.g. Document, Account, ...)","readOnly":true},"configurationDetail":{"$ref":"#/components/schemas/common-sequencer-SequencerConfigurationDetail"},"alternativeConfiguration":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"active":{"type":"boolean","default":true,"description":"Is the sequencer active?"}},"required":["configurationDetail"]},"common-sequencer-SequencerConfigurationDetail":{"description":"Contains details about the sequencer configuration","properties":{"type":{"type":"string","description":"Sequence type.","enum":["NON_POOLED_SEQUENCES","POOLED_SEQUENCES","PREFETCHED_SEQUENCES"]},"assignmentMode":{"type":"string","description":"Assignment procedure.","enum":["MANUAL","AUTOMATIC","SEMI_AUTOMATIC","FREE"]},"length":{"type":"integer","format":"int32","description":"Length.","minimum":0},"padChar":{"type":"string","description":"Padding character.","maxLength":1,"minLength":1,"pattern":"^[0-9]*$"},"expression":{"type":"string","description":"Prefix expression."},"postExpression":{"type":"string","description":"Postfix expression."},"initialValue":{"type":"integer","format":"int64","description":"Initial value."},"numberUnique":{"type":"boolean","default":true,"description":"Uniqueness check."}},"required":["assignmentMode","initialValue","length","padChar","type"]},"common-variant-VariantValueReference":{"description":"Variant values.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"Label.","readOnly":true},"description":{"type":"string","description":"Description.","readOnly":true},"variantAttributeRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}},"required":["id"]}}}}
```

## GET /erp/articles/{id}/languages-available-for-article

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/languages-available-for-article":{"get":{"tags":["Article"],"operationId":"getLanguagesBySalesChannel","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"salesChannelId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"type":"string"}}}}}}}}}}
```

## GET /erp/articles/{id}/instore-code

> Create the in-store barcode (EAN-13) of an article from its PLU code

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/instore-code":{"get":{"tags":["Article"],"summary":"Create the in-store barcode (EAN-13) of an article from its PLU code","operationId":"generateInstoreCode","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"prefix","in":"query","description":"Prefix that defines the meaning of the value","required":true,"schema":{"type":"string","description":"Prefix of an in-store code (EAN-13) that defines the meaning of the encoded value.","enum":["PRICE","QUANTITY","WEIGHT"]}},{"name":"value","in":"query","description":"depending on the prefix either a weight, currency or quantity value","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}}}}}}}
```

## GET /erp/articles/variables

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/variables":{"get":{"tags":["Article"],"operationId":"queryVariables_1","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/core-cunit-CuAttribute"}}}}}}}}},"components":{"schemas":{"core-cunit-CuAttribute":{"allOf":[{"$ref":"#/components/schemas/core-cunit-MetaContent"},{"type":"object","properties":{"key":{"type":"string","description":"Unique key identifying the attribute."},"attribute":{"type":"string","description":"Name of the attribute containing the result."},"path":{"type":"string","description":"Path that uniquely describes this attribute."},"displayName":{"type":"string","description":"Field name."},"displayNameOverride":{"type":"boolean","default":false,"description":"The field name was overridden (alias or function)."},"groupDisplayName":{"type":"string","description":"Field group name."},"parentDisplayName":{"type":"string","description":"Referencing field name."},"resultable":{"type":"boolean","default":true,"description":"Can this field be a result field?"},"filterable":{"type":"boolean","default":true,"description":"Can this field be filtered by?"},"sortable":{"type":"boolean","default":true,"description":"Is this field sortable?"},"visible":{"type":"boolean","default":true,"description":"Should this field be shown?"},"functions":{"type":"array","description":"Applied functions (when this is used as result metadata).","items":{"type":"string","description":"Applied functions (when this is used as result metadata)."}},"sortDirection":{"type":"string","description":"Information on how this column was sorted."},"constraint":{"$ref":"#/components/schemas/core-cunit-CuAttributeConstraint"},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"Attribute data type identifier (when dataType is empty).","readOnly":true},"modelType":{"type":"string","description":"The attribute belongs to the model type 'static' or 'dynamic'.","enum":["STATIC","DYNAMIC"],"readOnly":true},"entityIdentifier":{"type":"string","description":"Identifier of the entity this attribute belongs to (e.g. 'AccountEntity').","readOnly":true},"referencedEntityIdentifier":{"type":"string","description":"For relation attributes: fully qualified class name of the target entity (e.g. 'ag.vario.erp.account.AccountEntity').","readOnly":true},"headers":{"type":"array","description":"For a grouped header (e.g. a cross table) the individual groups are described here.","items":{"$ref":"#/components/schemas/core-cunit-CuAttribute.HeaderGroup"},"readOnly":true}}}]},"core-cunit-MetaContent":{"description":"Variable definition.","discriminator":{"propertyName":"_type"},"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuMeta"},{"$ref":"#/components/schemas/core-cunit-CuAttribute"}],"properties":{"_type":{"type":"string"}},"required":["_type"]},"core-cunit-CuMeta":{"allOf":[{"$ref":"#/components/schemas/core-cunit-MetaContent"},{"type":"object","properties":{"definition":{"$ref":"#/components/schemas/core-cunit-CuAttribute"},"value":{"type":"array","description":"Cell column description (when nested).","items":{"$ref":"#/components/schemas/core-cunit-MetaContent"}}}}]},"core-cunit-CuAttributeConstraint":{"description":"Attribute constraints.","properties":{"minLength":{"type":"integer","format":"int32","description":"Minimum length (of strings or arrays).","readOnly":true},"maxLength":{"type":"integer","format":"int32","description":"Maximum length (of strings or arrays).","readOnly":true},"minValue":{"type":"integer","format":"int64","description":"Minimum value.","readOnly":true},"includeMinValue":{"type":"boolean","description":"Is the minimum value inclusive?","readOnly":true},"maxValue":{"type":"integer","format":"int64","description":"Maximum value.","readOnly":true},"includeMaxValue":{"type":"boolean","description":"Is the maximum value inclusive?","readOnly":true},"notNull":{"type":"boolean","default":false,"description":"Is the value 'null' forbidden?","readOnly":true},"notBlank":{"type":"boolean","description":"For strings: is a string consisting only of whitespace forbidden?","readOnly":true},"digitsFraction":{"type":"integer","format":"int32","description":"Maximum number of decimal places.","readOnly":true}}},"core-cunit-CuAttributeDataType":{"description":"Attribute data type (when dataTypeIdentifier is empty).","properties":{"identifier":{"type":"string","description":"Datentyp-identifier","readOnly":true},"jsType":{"type":"string","description":"Which type it is.","readOnly":true},"objectRefIdentifier":{"type":"string","description":"For Object_Ref: which type exactly it is.","readOnly":true},"filterOptions":{"$ref":"#/components/schemas/core-cunit-CuAttributeFilterOptions"},"functions":{"type":"array","description":"Which functions are allowed?","items":{"type":"string","description":"Which functions are allowed?"},"readOnly":true},"predicateOperations":{"type":"array","description":"Which operations are allowed?","items":{"type":"string","description":"Which operations are allowed?","enum":["AND","OR","EQUALS","NOT_EQUALS","LIKE","NOT_LIKE","STARTS_WITH","ENDS_WITH","CONTAINS","NOT_CONTAINS","GREATER_THAN","GREATER_THAN_EQUALS","LESS_THAN","LESS_THAN_EQUALS","IN","NOT_IN","RANGE","NOT_RANGE","IS_NULL","IS_NOT_NULL","IS_NULL_OR_EQUALS","EXISTS","NOT_EXISTS"]},"readOnly":true}}},"core-cunit-CuAttributeFilterOptions":{"description":"CUnit attribute filter options.","properties":{"filterValues":{"type":"array","description":"Possible filter values.","items":{"type":"string","description":"Possible filter values."}},"filterDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"multipleChoice":{"type":"boolean","default":false,"description":"Is a multiple selection allowed?"}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search dialog.","properties":{"empty":{"type":"boolean"},"array":{"type":"boolean"},"null":{"type":"boolean"},"object":{"type":"boolean"},"float":{"type":"boolean"},"missingNode":{"type":"boolean"},"valueNode":{"type":"boolean"},"container":{"type":"boolean"},"integralNumber":{"type":"boolean"},"binary":{"type":"boolean"},"nodeType":{"type":"string","enum":["ARRAY","BINARY","BOOLEAN","MISSING","NULL","NUMBER","OBJECT","POJO","STRING"]},"string":{"type":"boolean"},"pojo":{"type":"boolean"},"short":{"type":"boolean"},"int":{"type":"boolean"},"long":{"type":"boolean"},"double":{"type":"boolean"},"bigDecimal":{"type":"boolean"},"bigInteger":{"type":"boolean"},"textual":{"type":"boolean","deprecated":true},"boolean":{"type":"boolean"},"floatingPointNumber":{"type":"boolean"},"number":{"type":"boolean"},"embeddedValue":{"type":"boolean"}}},"core-cunit-CuAttribute.HeaderGroup":{"description":"For a grouped header (e.g. a cross table) the individual groups are described here.","properties":{"displayName":{"type":"string","description":"Field name."},"displayNameOverride":{"type":"boolean","default":false,"description":"The field name was overridden (alias or function)."},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"Attribute data type identifier (when dataType is empty).","readOnly":true},"groupDisplayName":{"type":"string","description":"Field group name."},"data":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}}}}}
```

## GET /erp/articles/print-labels/candidates

> Create a label printing preview for a document, a picklist or an article

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/print-labels/candidates":{"get":{"tags":["Article"],"summary":"Create a label printing preview for a document, a picklist or an article","operationId":"createPrintOrderPreview","parameters":[{"name":"documentId","in":"query","description":"Document.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"articleId","in":"query","description":"Article.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"picklistId","in":"query","description":"Picklist.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"locale","in":"query","description":"Language (ISO Alpha-2).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/erp-product-ArticlePrintLabelOrderResponse"}}}}}}}}},"components":{"schemas":{"erp-product-ArticlePrintLabelOrderResponse":{"description":"Response specifying which articles are printed how often.","properties":{"position":{"type":"integer","format":"int32","description":"Position.","readOnly":true},"article":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"report":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"serialArticle":{"type":"boolean","description":"Is a serial number mandatory?","readOnly":true},"serialNumber":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"documentLine":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"documentLineComponent":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"picklistLine":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"picklistLineComponent":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"print":{"type":"boolean","description":"Label printing."},"quantity":{"type":"integer","format":"int32","description":"Quantity."},"languageCode":{"type":"string","description":"Language (ISO Alpha-2)."},"description":{"type":"string","description":"Product description.","maxLength":2147483647,"minLength":0}}},"core-api-ApiObjectReference":{"description":"Parent category.","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Active.","readOnly":true}},"required":["id"]}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.42.0"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"api.example.com"}],"paths":{"/erp/articles/{id}/listings/{listingId}":{"delete":{"tags":["Article"],"operationId":"deleteListing","parameters":[{"name":"id","in":"path","description":"Article identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"Listing identifier.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Requested language (e.g. de).","style":"form","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developer.vario-software.de/api-reference/article.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
