# Article

the Article API

## GET /erp/articles/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}":{"get":{"tags":["Article"],"operationId":"getArticleById","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. 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":"Ist das der Basis-Artikel des Produkts?","readOnly":true},"productType":{"type":"string","description":"Artikelarten","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Preisbasis","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Serientyp eines Artikels","enum":["NONE","SERIAL_NUMBER","LOT","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Art des Haltbarkeitsdatums bei Serienartikeln","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Garantie in Monaten","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Seriennummer Auszeichnungsart","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":"Verkaufseinheit"},"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":"Basispreiseinheit"},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Ist der Artikel noch lieferbar?"},"customsTariffNumber":{"type":"string","description":"Zolltarifnummer","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Tags zum Produkt","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"die id des Listings"},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Umkehrung der Steuerschuld nach §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte Aktualisierung des listingStates","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":"Soll-Handelsspanne"},"languageCode":{"type":"string","description":"Einschränkung auf Land"},"dangerousGoodInformationRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"isDangerousGood":{"type":"boolean","default":false,"description":"Artikel ist Gefahrgut"},"availableAlone":{"type":"boolean","default":true,"description":"alleine lieferbarer Artikel?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Definiert die Art, wie ein Artikel kommissioniert werden darf","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":"Arbeitseinheit in Minuten"},"initialLastPurchasePrice":{"type":"number","description":"Letzter EKP (Startwert)"},"initialAvgPurchasePrice":{"type":"number","description":"Durchschnittl. EKP (Startwert)"},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"dEK berechnen?"},"commissionable":{"type":"boolean","default":true,"description":"provisionsberechtiger Artikel?"},"cashDiscountable":{"type":"boolean","default":true,"description":"skontierbarer Artikel?"},"discountable":{"type":"boolean","default":true,"description":"rabattierbarer Artikel?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Nur für Kontingentartikel: soll bei der Abrechnung angedruckt werden, dass kein Kontingent vorhanden ist?"},"freelyPickable":{"type":"boolean","default":false,"description":"Frei kommissionierbar"},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Versandlabeldruck"},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"zulässig für Aufnahme in Bestellvorschläge"},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Definiert, ob und wie ein Artikel per Streckengeschäft verkauft werden darf","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Produktion"},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Nur manuelle Produktion"},"fabricationOfComponents":{"type":"string","description":"Produktion von Komponenten","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"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":"Artikelnummer"},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Bedarfsermittlung nur über Reservierungen"},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Sonderbemerkung"},"note":{"type":"string","description":"Notiz"}},"required":["deliverable","dropShippingPolicy","number","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":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"common-masterdata-CountryReference":{"description":"Country code","properties":{"id":{"type":"integer","format":"int64","description":"ID des Landes"},"isoAlpha2":{"type":"string","description":"IsoAlpha2-Code des Landes"},"label":{"type":"string","description":"Bezeichnung des Landes","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-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"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}},"required":["name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Verfügbarkeitsermittlung für die Artikelstammdaten/Bestandsansicht","properties":{"inStock":{"type":"string","description":"wie wird der Bestand behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"wie werden Reserviert-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"wie werden Bestellt-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"wie werden Mengen in Kommissionierung behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"wie werden Meldebestände behandelt","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Etikettdruck-Einstellungen","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":"Wareneingang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Wareneingang: Druckmenge"},"outgoingCalculationMode":{"type":"string","description":"Warenausgang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Warenausgang: Druckmenge"}}}}}}
```

## PUT /erp/articles/{id}

> Update existing article

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}":{"put":{"tags":["Article"],"summary":"Update existing article","operationId":"update_70","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. 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":"Ist das der Basis-Artikel des Produkts?","readOnly":true},"productType":{"type":"string","description":"Artikelarten","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Preisbasis","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Serientyp eines Artikels","enum":["NONE","SERIAL_NUMBER","LOT","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Art des Haltbarkeitsdatums bei Serienartikeln","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Garantie in Monaten","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Seriennummer Auszeichnungsart","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":"Verkaufseinheit"},"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":"Basispreiseinheit"},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Ist der Artikel noch lieferbar?"},"customsTariffNumber":{"type":"string","description":"Zolltarifnummer","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Tags zum Produkt","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"die id des Listings"},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Umkehrung der Steuerschuld nach §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte Aktualisierung des listingStates","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":"Soll-Handelsspanne"},"languageCode":{"type":"string","description":"Einschränkung auf Land"},"dangerousGoodInformationRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"isDangerousGood":{"type":"boolean","default":false,"description":"Artikel ist Gefahrgut"},"availableAlone":{"type":"boolean","default":true,"description":"alleine lieferbarer Artikel?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Definiert die Art, wie ein Artikel kommissioniert werden darf","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":"Arbeitseinheit in Minuten"},"initialLastPurchasePrice":{"type":"number","description":"Letzter EKP (Startwert)"},"initialAvgPurchasePrice":{"type":"number","description":"Durchschnittl. EKP (Startwert)"},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"dEK berechnen?"},"commissionable":{"type":"boolean","default":true,"description":"provisionsberechtiger Artikel?"},"cashDiscountable":{"type":"boolean","default":true,"description":"skontierbarer Artikel?"},"discountable":{"type":"boolean","default":true,"description":"rabattierbarer Artikel?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Nur für Kontingentartikel: soll bei der Abrechnung angedruckt werden, dass kein Kontingent vorhanden ist?"},"freelyPickable":{"type":"boolean","default":false,"description":"Frei kommissionierbar"},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Versandlabeldruck"},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"zulässig für Aufnahme in Bestellvorschläge"},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Definiert, ob und wie ein Artikel per Streckengeschäft verkauft werden darf","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Produktion"},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Nur manuelle Produktion"},"fabricationOfComponents":{"type":"string","description":"Produktion von Komponenten","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"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":"Artikelnummer"},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Bedarfsermittlung nur über Reservierungen"},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Sonderbemerkung"},"note":{"type":"string","description":"Notiz"}},"required":["deliverable","dropShippingPolicy","number","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":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"common-masterdata-CountryReference":{"description":"Country code","properties":{"id":{"type":"integer","format":"int64","description":"ID des Landes"},"isoAlpha2":{"type":"string","description":"IsoAlpha2-Code des Landes"},"label":{"type":"string","description":"Bezeichnung des Landes","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-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"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}},"required":["name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Verfügbarkeitsermittlung für die Artikelstammdaten/Bestandsansicht","properties":{"inStock":{"type":"string","description":"wie wird der Bestand behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"wie werden Reserviert-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"wie werden Bestellt-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"wie werden Mengen in Kommissionierung behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"wie werden Meldebestände behandelt","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Etikettdruck-Einstellungen","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":"Wareneingang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Wareneingang: Druckmenge"},"outgoingCalculationMode":{"type":"string","description":"Warenausgang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Warenausgang: Druckmenge"}}},"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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}}}}}
```

## DELETE /erp/articles/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}":{"delete":{"tags":["Article"],"operationId":"deleteById","parameters":[{"name":"id","in":"path","description":"an article id","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 

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"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":"steuerzuordnung eines artikels","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"},"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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

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

> Delete an existing Resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

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

> Verlängert eine Sperre

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/leasable-lock/{lockToken}":{"put":{"tags":["Article"],"summary":"Verlängert eine Sperre","operationId":"refreshLeasableLock_1","parameters":[{"name":"id","in":"path","description":"ID der gesperrten Resource","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"lockToken","in":"path","description":"Token der zu verlängernden Sperre","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"leasePeriod","in":"query","description":"Optionale Lease-Dauer in Sekunden","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"},"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}

> Gibt ein Sperre frei

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/leasable-lock/{lockToken}":{"delete":{"tags":["Article"],"summary":"Gibt ein Sperre frei","operationId":"releaseLeasableLock_1","parameters":[{"name":"id","in":"path","description":"ID der gesperrten Resource","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"lockToken","in":"path","description":"Token der freizugebenden Sperre","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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/fabrication-components/{componentId}":{"get":{"tags":["Article"],"operationId":"getFabricationComponent","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"an component id","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":"Komponente eines Produktionsartikels","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"},"quantity":{"type":"number","description":"Menge"},"deviatingUnitRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"deviatingUnitPrice":{"type":"number","description":"Abweichende Herstellungskosten"},"name":{"type":"string","description":"Bezeichnung","maxLength":255,"minLength":0},"description":{"type":"string","description":"Beschreibung","maxLength":2147483647,"minLength":0},"forSerialInheritance":{"type":"boolean","default":false,"description":"Basis für die Vererbung der Seriennummer"},"sortOrder":{"type":"integer","format":"int32","description":"Sortierreihenfolge"},"active":{"type":"boolean","default":true,"description":"Aktiv?","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":"alle artikel, die zu diesem Produkt gehören","properties":{"id":{"type":"integer","format":"int64","description":"Article ID"},"number":{"type":"string","description":"Article 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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/fabrication-components/{componentId}":{"put":{"tags":["Article"],"operationId":"updateFabricationComponent","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"an component id","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":"Komponente eines Produktionsartikels","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"},"quantity":{"type":"number","description":"Menge"},"deviatingUnitRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"deviatingUnitPrice":{"type":"number","description":"Abweichende Herstellungskosten"},"name":{"type":"string","description":"Bezeichnung","maxLength":255,"minLength":0},"description":{"type":"string","description":"Beschreibung","maxLength":2147483647,"minLength":0},"forSerialInheritance":{"type":"boolean","default":false,"description":"Basis für die Vererbung der Seriennummer"},"sortOrder":{"type":"integer","format":"int32","description":"Sortierreihenfolge"},"active":{"type":"boolean","default":true,"description":"Aktiv?","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":"alle artikel, die zu diesem Produkt gehören","properties":{"id":{"type":"integer","format":"int64","description":"Article ID"},"number":{"type":"string","description":"Article 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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/fabrication-components/{componentId}":{"delete":{"tags":["Article"],"operationId":"deleteFabricationComponent","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"an component id","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

> deaktiviert eine bestehende Resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/deactivate":{"put":{"tags":["Article"],"summary":"deaktiviert eine bestehende Resource","operationId":"deactivate_32","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":"Ist das der Basis-Artikel des Produkts?","readOnly":true},"productType":{"type":"string","description":"Artikelarten","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Preisbasis","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Serientyp eines Artikels","enum":["NONE","SERIAL_NUMBER","LOT","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Art des Haltbarkeitsdatums bei Serienartikeln","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Garantie in Monaten","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Seriennummer Auszeichnungsart","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":"Verkaufseinheit"},"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":"Basispreiseinheit"},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Ist der Artikel noch lieferbar?"},"customsTariffNumber":{"type":"string","description":"Zolltarifnummer","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Tags zum Produkt","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"die id des Listings"},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Umkehrung der Steuerschuld nach §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte Aktualisierung des listingStates","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":"Soll-Handelsspanne"},"languageCode":{"type":"string","description":"Einschränkung auf Land"},"dangerousGoodInformationRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"isDangerousGood":{"type":"boolean","default":false,"description":"Artikel ist Gefahrgut"},"availableAlone":{"type":"boolean","default":true,"description":"alleine lieferbarer Artikel?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Definiert die Art, wie ein Artikel kommissioniert werden darf","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":"Arbeitseinheit in Minuten"},"initialLastPurchasePrice":{"type":"number","description":"Letzter EKP (Startwert)"},"initialAvgPurchasePrice":{"type":"number","description":"Durchschnittl. EKP (Startwert)"},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"dEK berechnen?"},"commissionable":{"type":"boolean","default":true,"description":"provisionsberechtiger Artikel?"},"cashDiscountable":{"type":"boolean","default":true,"description":"skontierbarer Artikel?"},"discountable":{"type":"boolean","default":true,"description":"rabattierbarer Artikel?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Nur für Kontingentartikel: soll bei der Abrechnung angedruckt werden, dass kein Kontingent vorhanden ist?"},"freelyPickable":{"type":"boolean","default":false,"description":"Frei kommissionierbar"},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Versandlabeldruck"},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"zulässig für Aufnahme in Bestellvorschläge"},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Definiert, ob und wie ein Artikel per Streckengeschäft verkauft werden darf","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Produktion"},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Nur manuelle Produktion"},"fabricationOfComponents":{"type":"string","description":"Produktion von Komponenten","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"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":"Artikelnummer"},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Bedarfsermittlung nur über Reservierungen"},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Sonderbemerkung"},"note":{"type":"string","description":"Notiz"}},"required":["deliverable","dropShippingPolicy","number","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":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"common-masterdata-CountryReference":{"description":"Country code","properties":{"id":{"type":"integer","format":"int64","description":"ID des Landes"},"isoAlpha2":{"type":"string","description":"IsoAlpha2-Code des Landes"},"label":{"type":"string","description":"Bezeichnung des Landes","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-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"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}},"required":["name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Verfügbarkeitsermittlung für die Artikelstammdaten/Bestandsansicht","properties":{"inStock":{"type":"string","description":"wie wird der Bestand behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"wie werden Reserviert-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"wie werden Bestellt-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"wie werden Mengen in Kommissionierung behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"wie werden Meldebestände behandelt","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Etikettdruck-Einstellungen","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":"Wareneingang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Wareneingang: Druckmenge"},"outgoingCalculationMode":{"type":"string","description":"Warenausgang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Warenausgang: Druckmenge"}}},"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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/components/{componentId}":{"get":{"tags":["Article"],"operationId":"getComponent","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"an component id","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":"Komponenten eines Baugruppen- oder Jumbo-Artikels","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":"Baugruppen- oder Jumbo-Artikel"},"componentArticleId":{"type":"integer","format":"int64","description":"Artikel dieser Komponente"},"number":{"type":"string","description":"Artikelnummer der Komponente"},"name":{"type":"string","description":"Name der Komponente"},"description":{"type":"string","description":"Beschreibung der Komponente"},"quantity":{"type":"number","description":"Menge der Komponente"},"position":{"type":"integer","format":"int32","description":"Position der Komponente innerhalb des Containers"},"salesPrice":{"type":"number","description":"Verkaufspreis der Komponente"},"purchasePrice":{"type":"number","description":"Einkaufspreis (DEK) der Komponente"},"grossWeight":{"type":"number","description":"Brutto-Gewicht der Komponente"},"netWeight":{"type":"number","description":"Netto-Gewicht der Komponente"},"stockAmount":{"type":"number","description":"Bestand der Komponente"},"stockAvailable":{"type":"number","description":"verfügbare Menge der Komponente"}},"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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/components/{componentId}":{"put":{"tags":["Article"],"operationId":"updateComponent","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"an component id","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":"Komponenten eines Baugruppen- oder Jumbo-Artikels","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":"Baugruppen- oder Jumbo-Artikel"},"componentArticleId":{"type":"integer","format":"int64","description":"Artikel dieser Komponente"},"number":{"type":"string","description":"Artikelnummer der Komponente"},"name":{"type":"string","description":"Name der Komponente"},"description":{"type":"string","description":"Beschreibung der Komponente"},"quantity":{"type":"number","description":"Menge der Komponente"},"position":{"type":"integer","format":"int32","description":"Position der Komponente innerhalb des Containers"},"salesPrice":{"type":"number","description":"Verkaufspreis der Komponente"},"purchasePrice":{"type":"number","description":"Einkaufspreis (DEK) der Komponente"},"grossWeight":{"type":"number","description":"Brutto-Gewicht der Komponente"},"netWeight":{"type":"number","description":"Netto-Gewicht der Komponente"},"stockAmount":{"type":"number","description":"Bestand der Komponente"},"stockAvailable":{"type":"number","description":"verfügbare Menge der Komponente"}},"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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/components/{componentId}":{"delete":{"tags":["Article"],"operationId":"deleteComponent","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"componentId","in":"path","description":"an component id","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

> aktiviert eine bestehende Resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/activate":{"put":{"tags":["Article"],"summary":"aktiviert eine bestehende Resource","operationId":"activate_32","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":"Ist das der Basis-Artikel des Produkts?","readOnly":true},"productType":{"type":"string","description":"Artikelarten","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Preisbasis","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Serientyp eines Artikels","enum":["NONE","SERIAL_NUMBER","LOT","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Art des Haltbarkeitsdatums bei Serienartikeln","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Garantie in Monaten","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Seriennummer Auszeichnungsart","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":"Verkaufseinheit"},"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":"Basispreiseinheit"},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Ist der Artikel noch lieferbar?"},"customsTariffNumber":{"type":"string","description":"Zolltarifnummer","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Tags zum Produkt","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"die id des Listings"},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Umkehrung der Steuerschuld nach §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte Aktualisierung des listingStates","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":"Soll-Handelsspanne"},"languageCode":{"type":"string","description":"Einschränkung auf Land"},"dangerousGoodInformationRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"isDangerousGood":{"type":"boolean","default":false,"description":"Artikel ist Gefahrgut"},"availableAlone":{"type":"boolean","default":true,"description":"alleine lieferbarer Artikel?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Definiert die Art, wie ein Artikel kommissioniert werden darf","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":"Arbeitseinheit in Minuten"},"initialLastPurchasePrice":{"type":"number","description":"Letzter EKP (Startwert)"},"initialAvgPurchasePrice":{"type":"number","description":"Durchschnittl. EKP (Startwert)"},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"dEK berechnen?"},"commissionable":{"type":"boolean","default":true,"description":"provisionsberechtiger Artikel?"},"cashDiscountable":{"type":"boolean","default":true,"description":"skontierbarer Artikel?"},"discountable":{"type":"boolean","default":true,"description":"rabattierbarer Artikel?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Nur für Kontingentartikel: soll bei der Abrechnung angedruckt werden, dass kein Kontingent vorhanden ist?"},"freelyPickable":{"type":"boolean","default":false,"description":"Frei kommissionierbar"},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Versandlabeldruck"},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"zulässig für Aufnahme in Bestellvorschläge"},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Definiert, ob und wie ein Artikel per Streckengeschäft verkauft werden darf","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Produktion"},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Nur manuelle Produktion"},"fabricationOfComponents":{"type":"string","description":"Produktion von Komponenten","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"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":"Artikelnummer"},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Bedarfsermittlung nur über Reservierungen"},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Sonderbemerkung"},"note":{"type":"string","description":"Notiz"}},"required":["deliverable","dropShippingPolicy","number","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":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"common-masterdata-CountryReference":{"description":"Country code","properties":{"id":{"type":"integer","format":"int64","description":"ID des Landes"},"isoAlpha2":{"type":"string","description":"IsoAlpha2-Code des Landes"},"label":{"type":"string","description":"Bezeichnung des Landes","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-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"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}},"required":["name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Verfügbarkeitsermittlung für die Artikelstammdaten/Bestandsansicht","properties":{"inStock":{"type":"string","description":"wie wird der Bestand behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"wie werden Reserviert-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"wie werden Bestellt-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"wie werden Mengen in Kommissionierung behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"wie werden Meldebestände behandelt","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Etikettdruck-Einstellungen","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":"Wareneingang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Wareneingang: Druckmenge"},"outgoingCalculationMode":{"type":"string","description":"Warenausgang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Warenausgang: Druckmenge"}}},"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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{articleId}/listings/{listingId}":{"get":{"tags":["Article"],"operationId":"getListing","parameters":[{"name":"articleId","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"a listing id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. 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":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte aktualisierung des listingStates","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":"Niedrigster Netto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Niedrigster Netto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"customLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"categoryRefs":{"type":"array","description":"Kategorien, denen dieses Listing zugeordnet ist","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":"Wert dieses Sales-Channel","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Wert des Default-Sales-Channel","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}},"required":["name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Wert dieses Sales-Channel"},"defaultValue":{"type":"string","description":"Wert des Default-Sales-Channel","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{articleId}/listings/{listingId}":{"put":{"tags":["Article"],"operationId":"updateListing","parameters":[{"name":"articleId","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"an sales-channel id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. 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":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte aktualisierung des listingStates","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":"Niedrigster Netto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Niedrigster Netto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"customLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"categoryRefs":{"type":"array","description":"Kategorien, denen dieses Listing zugeordnet ist","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":"Wert dieses Sales-Channel","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Wert des Default-Sales-Channel","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}},"required":["name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Wert dieses Sales-Channel"},"defaultValue":{"type":"string","description":"Wert des Default-Sales-Channel","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{articleId}/listings/{listingId}":{"patch":{"tags":["Article"],"operationId":"partialUpdateListing_2","parameters":[{"name":"articleId","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"an listingId id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. 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"},"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":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte aktualisierung des listingStates","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":"Niedrigster Netto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Niedrigster Netto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"customLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"categoryRefs":{"type":"array","description":"Kategorien, denen dieses Listing zugeordnet ist","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":"Wert dieses Sales-Channel","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Wert des Default-Sales-Channel","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}},"required":["name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Wert dieses Sales-Channel"},"defaultValue":{"type":"string","description":"Wert des Default-Sales-Channel","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{articleId}/listings/{listingId}/state":{"put":{"tags":["Article"],"operationId":"updateListingState","parameters":[{"name":"articleId","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"an listing id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"]}}],"responses":{"200":{"description":"OK"}}}}}}
```

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

> Führt den Druck eines Etikettendruck-Stapels durch

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/print-labels/{batchId}":{"put":{"tags":["Article"],"summary":"Führt den Druck eines Etikettendruck-Stapels durch","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":{}}}}}}}},"components":{"schemas":{"common-output-OutputRequest":{"properties":{"exportFormat":{"type":"string","description":"output-format für mail/file-export","enum":["PDF","XLSX","XLSX_RAW","JSON_RAW","REPORT_TEMPLATE"]},"exportFilename":{"type":"string","description":"filename (ohne extension) bei einem file-export"},"mailRecipients":{"type":"array","description":"Empfänger","items":{"$ref":"#/components/schemas/common-output-OutputRecipient.MailRecipient"}},"outputType":{"type":"string","description":"outputType"},"groupIdentifier":{"type":"string","description":"OutputReportGroup Identifier (optional), sonst Default-Group des Moduls"},"published":{"type":"boolean","default":false,"description":"sollen nur bereits veröffentlichte Dokumente beachtet werden?"}}},"common-output-OutputRecipient.MailRecipient":{"description":"Empfänger","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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/article-accessories/{id}":{"get":{"tags":["Article"],"summary":"Find an existing Resource by identifier","operationId":"getById_80","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":"Einfügmenge"},"insertTerm":{"type":"string","description":"Zubehör Einfügeart","enum":["MANUAL","AUTOMATIC_QUANTITY_IF_ACCESSORY_INSERTED","AUTOMATIC_PROPORTIONAL_QUANTITY","AUTOMATIC_FIXED_QUANTITY"]},"sortOrder":{"type":"integer","format":"int32","description":"Sortiereihenfolge"}},"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":"Related account","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":"Activ","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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

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

> Update existing Resource 

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/article-accessories/{id}":{"put":{"tags":["Article"],"summary":"Update existing Resource ","operationId":"update_74","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":"Einfügmenge"},"insertTerm":{"type":"string","description":"Zubehör Einfügeart","enum":["MANUAL","AUTOMATIC_QUANTITY_IF_ACCESSORY_INSERTED","AUTOMATIC_PROPORTIONAL_QUANTITY","AUTOMATIC_FIXED_QUANTITY"]},"sortOrder":{"type":"integer","format":"int32","description":"Sortiereihenfolge"}},"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":"Related account","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":"Activ","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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

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

> Delete an existing Resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/article-accessories/{id}":{"delete":{"tags":["Article"],"summary":"Delete an existing Resource","operationId":"delete_69","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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

## POST /erp/articles

> Neuen Artikel (ggf. mit Produkt) erzeugen

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles":{"post":{"tags":["Article"],"summary":"Neuen Artikel (ggf. mit Produkt) erzeugen","operationId":"create_66","parameters":[{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. 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":"Artikelarten","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"]},"serialType":{"type":"string","description":"Serientyp eines Artikels","enum":["NONE","SERIAL_NUMBER","LOT","DOUBLE_SERIAL_NUMBER"]},"createArticlesOrBundles":{"type":"boolean","default":false,"description":"Direkt Artikel/Gebinde anlegen"},"bundle":{"type":"boolean","default":false,"description":"Nur wenn productRef leer ist: Handelt es sich um ein Gebinde?"},"number":{"type":"string","description":"Artikel-Nummer (nicht, wenn es ein Gebinde ist und ein Produkt angegeben ist"},"name":{"type":"string","description":"Bezeichnung"},"unitTypeRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"productGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"priceUnit":{"type":"number","description":"Preiseinheit"},"taxSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"priceBase":{"type":"string","description":"Preisbasis","enum":["NET_PRICE","GROSS_PRICE"]},"dropShippingPolicy":{"type":"string","description":"Definiert, ob und wie ein Artikel per Streckengeschäft verkauft werden darf","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"bundleSchemaId":{"type":"integer","format":"int64","description":"Vorlage zum Erstellen mehrerer Artikel"},"createTemplateId":{"type":"integer","format":"int64","description":"Vorlage zum Erstellen eines Artikel"},"variantSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"values":{"type":"array","description":"Variantenwerte","items":{"$ref":"#/components/schemas/common-variant-VariantValueReference"}}},"required":["priceUnit"]},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","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":"Variantenwerte","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"Bezeichnung","readOnly":true},"description":{"type":"string","description":"Beschreibung","readOnly":true},"variantAttributeRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}},"required":["id"]},"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":"Ist das der Basis-Artikel des Produkts?","readOnly":true},"productType":{"type":"string","description":"Artikelarten","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"],"readOnly":true},"priceBase":{"type":"string","description":"Preisbasis","enum":["NET_PRICE","GROSS_PRICE"]},"serialType":{"type":"string","description":"Serientyp eines Artikels","enum":["NONE","SERIAL_NUMBER","LOT","DOUBLE_SERIAL_NUMBER"],"readOnly":true},"expiryDateType":{"type":"string","description":"Art des Haltbarkeitsdatums bei Serienartikeln","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"],"readOnly":true},"warrantyInMonths":{"type":"integer","format":"int32","description":"Garantie in Monaten","readOnly":true},"serialNumberLabelingType":{"type":"string","description":"Seriennummer Auszeichnungsart","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":"Verkaufseinheit"},"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":"Basispreiseinheit"},"discountGroupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"deliverable":{"type":"boolean","default":true,"description":"Ist der Artikel noch lieferbar?"},"customsTariffNumber":{"type":"string","description":"Zolltarifnummer","maxLength":15,"minLength":0,"readOnly":true},"countryOfOriginRef":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"tags":{"type":"array","description":"Tags zum Produkt","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"listingId":{"type":"string","description":"die id des Listings"},"taxLiabilityReversed":{"type":"boolean","default":false,"description":"Umkehrung der Steuerschuld nach §13b UStG?"},"sellableWithoutStock":{"type":"boolean","default":false,"description":"is this product sellable without any quantity at the stock"},"listed":{"type":"boolean","default":true,"description":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte Aktualisierung des listingStates","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":"Soll-Handelsspanne"},"languageCode":{"type":"string","description":"Einschränkung auf Land"},"dangerousGoodInformationRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"isDangerousGood":{"type":"boolean","default":false,"description":"Artikel ist Gefahrgut"},"availableAlone":{"type":"boolean","default":true,"description":"alleine lieferbarer Artikel?"},"pickingType":{"type":"string","default":"ACCORDING_TO_TEMPLATE","description":"Definiert die Art, wie ein Artikel kommissioniert werden darf","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":"Arbeitseinheit in Minuten"},"initialLastPurchasePrice":{"type":"number","description":"Letzter EKP (Startwert)"},"initialAvgPurchasePrice":{"type":"number","description":"Durchschnittl. EKP (Startwert)"},"determineAvgPurchasePrice":{"type":"boolean","default":true,"description":"dEK berechnen?"},"commissionable":{"type":"boolean","default":true,"description":"provisionsberechtiger Artikel?"},"cashDiscountable":{"type":"boolean","default":true,"description":"skontierbarer Artikel?"},"discountable":{"type":"boolean","default":true,"description":"rabattierbarer Artikel?"},"contingentArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"printWarningIfNoContingentAvailable":{"type":"boolean","default":true,"description":"Nur für Kontingentartikel: soll bei der Abrechnung angedruckt werden, dass kein Kontingent vorhanden ist?"},"freelyPickable":{"type":"boolean","default":false,"description":"Frei kommissionierbar"},"shippingLabelPrinting":{"type":"boolean","default":false,"description":"Versandlabeldruck"},"permissibleForOrderProposal":{"type":"boolean","default":true,"description":"zulässig für Aufnahme in Bestellvorschläge"},"dropShippingPolicy":{"type":"string","default":"STORAGE","description":"Definiert, ob und wie ein Artikel per Streckengeschäft verkauft werden darf","enum":["ANY","DROP_SHIPPING","STORAGE","STORAGE_WITH_FALLBACK_TO_DROP_SHIPPING"]},"fabrication":{"type":"boolean","default":false,"description":"Produktion"},"onlyManualFabrication":{"type":"boolean","default":false,"description":"Nur manuelle Produktion"},"fabricationOfComponents":{"type":"string","description":"Produktion von Komponenten","enum":["NEVER","COMPLETELY_IF_NECESSARY","REQUIRED_QUANTITY_IF_NECESSARY","ALWAYS"]},"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":"Artikelnummer"},"needsAssessmentOnlyOnReservationBasis":{"type":"boolean","default":false,"description":"Bedarfsermittlung nur über Reservierungen"},"onGoodsArrivalConvertIntoBundleArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"remark":{"type":"string","description":"Sonderbemerkung"},"note":{"type":"string","description":"Notiz"}},"required":["deliverable","dropShippingPolicy","number","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"}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"common-masterdata-CountryReference":{"description":"Country code","properties":{"id":{"type":"integer","format":"int64","description":"ID des Landes"},"isoAlpha2":{"type":"string","description":"IsoAlpha2-Code des Landes"},"label":{"type":"string","description":"Bezeichnung des Landes","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-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"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}},"required":["name","value"]},"erp-product-ArticleAvailabilityDetermination":{"description":"Verfügbarkeitsermittlung für die Artikelstammdaten/Bestandsansicht","properties":{"inStock":{"type":"string","description":"wie wird der Bestand behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"wie werden Reserviert-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"wie werden Bestellt-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"wie werden Mengen in Kommissionierung behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"wie werden Meldebestände behandelt","enum":["IGNORE","ADD","SUBTRACT"]}}},"erp-product-ArticlePrintLabelSettings":{"description":"Etikettdruck-Einstellungen","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":"Wareneingang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"incomingPrintQuantity":{"type":"integer","format":"int32","description":"Wareneingang: Druckmenge"},"outgoingCalculationMode":{"type":"string","description":"Warenausgang: Bestimmung der Druckmenge","enum":["NO_LABEL","FIXED_AMOUNT","QUANTITY_TIMES_AMOUNT","QUANTITY_PER_PACKAGING_UNIT","QUANTITY_TIMES_AMOUNT_AND_PACKAGING_QUANTITY"]},"outgoingPrintQuantity":{"type":"integer","format":"int32","description":"Warenausgang: Druckmenge"}}}}}}
```

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

> Find all existing article-taxes

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"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":"steuerzuordnung eines artikels","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"},"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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

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

> Create new ProductTax

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"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":"steuerzuordnung eines artikels","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"},"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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

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

> Prüft, ob eine Resource gesperrt ist

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/leasable-lock":{"get":{"tags":["Article"],"summary":"Prüft, ob eine Resource gesperrt ist","operationId":"getLeasableLock_1","parameters":[{"name":"id","in":"path","description":"ID einer Resource","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"},"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

> Erstellt eine neue Sperre, optional mit einer Gültigkeitsdauer

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/leasable-lock":{"post":{"tags":["Article"],"summary":"Erstellt eine neue Sperre, optional mit einer Gültigkeitsdauer","operationId":"createLeasableLock_1","parameters":[{"name":"id","in":"path","description":"ID der zu sperrenden Resource","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"leasePeriod","in":"query","description":"Optionale Lease-Dauer in Sekunden","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"},"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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/fabrication-components":{"get":{"tags":["Article"],"operationId":"getFabricationComponents","parameters":[{"name":"id","in":"path","description":"an article id","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":"Komponente eines Produktionsartikels","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"},"quantity":{"type":"number","description":"Menge"},"deviatingUnitRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"deviatingUnitPrice":{"type":"number","description":"Abweichende Herstellungskosten"},"name":{"type":"string","description":"Bezeichnung","maxLength":255,"minLength":0},"description":{"type":"string","description":"Beschreibung","maxLength":2147483647,"minLength":0},"forSerialInheritance":{"type":"boolean","default":false,"description":"Basis für die Vererbung der Seriennummer"},"sortOrder":{"type":"integer","format":"int32","description":"Sortierreihenfolge"},"active":{"type":"boolean","default":true,"description":"Aktiv?","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":"alle artikel, die zu diesem Produkt gehören","properties":{"id":{"type":"integer","format":"int64","description":"Article ID"},"number":{"type":"string","description":"Article 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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/fabrication-components":{"post":{"tags":["Article"],"operationId":"createFabricationComponent","parameters":[{"name":"id","in":"path","description":"an article id","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":"Komponente eines Produktionsartikels","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"},"quantity":{"type":"number","description":"Menge"},"deviatingUnitRef":{"$ref":"#/components/schemas/common-masterdata-UnitTypeReference"},"deviatingUnitPrice":{"type":"number","description":"Abweichende Herstellungskosten"},"name":{"type":"string","description":"Bezeichnung","maxLength":255,"minLength":0},"description":{"type":"string","description":"Beschreibung","maxLength":2147483647,"minLength":0},"forSerialInheritance":{"type":"boolean","default":false,"description":"Basis für die Vererbung der Seriennummer"},"sortOrder":{"type":"integer","format":"int32","description":"Sortierreihenfolge"},"active":{"type":"boolean","default":true,"description":"Aktiv?","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":"alle artikel, die zu diesem Produkt gehören","properties":{"id":{"type":"integer","format":"int64","description":"Article ID"},"number":{"type":"string","description":"Article 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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/components":{"get":{"tags":["Article"],"operationId":"getComponents","parameters":[{"name":"id","in":"path","description":"an article id","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":"Komponenten eines Baugruppen- oder Jumbo-Artikels mit Summen","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":"Alle Komponenten, die zu diesem Produkt gehören","items":{"$ref":"#/components/schemas/erp-product-ArticleComponent"}},"totalSalesPrice":{"type":"number","description":"Summe der Verkaufspreise der Komponenten"},"totalPurchasePrice":{"type":"number","description":"Summe der Einkaufspreise der Komponenten"},"totalNetWeight":{"type":"number","description":"Summe der Netto-Gewichte der Komponenten"},"totalGrossWeight":{"type":"number","description":"Summe der Brutto-Gewichte der Komponenten"}},"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":"Komponenten eines Baugruppen- oder Jumbo-Artikels","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":"Baugruppen- oder Jumbo-Artikel"},"componentArticleId":{"type":"integer","format":"int64","description":"Artikel dieser Komponente"},"number":{"type":"string","description":"Artikelnummer der Komponente"},"name":{"type":"string","description":"Name der Komponente"},"description":{"type":"string","description":"Beschreibung der Komponente"},"quantity":{"type":"number","description":"Menge der Komponente"},"position":{"type":"integer","format":"int32","description":"Position der Komponente innerhalb des Containers"},"salesPrice":{"type":"number","description":"Verkaufspreis der Komponente"},"purchasePrice":{"type":"number","description":"Einkaufspreis (DEK) der Komponente"},"grossWeight":{"type":"number","description":"Brutto-Gewicht der Komponente"},"netWeight":{"type":"number","description":"Netto-Gewicht der Komponente"},"stockAmount":{"type":"number","description":"Bestand der Komponente"},"stockAvailable":{"type":"number","description":"verfügbare Menge der Komponente"}},"required":["componentArticleId","containerArticleId"]}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/components":{"post":{"tags":["Article"],"operationId":"createComponent","parameters":[{"name":"id","in":"path","description":"an article id","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":"Komponenten eines Baugruppen- oder Jumbo-Artikels","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":"Baugruppen- oder Jumbo-Artikel"},"componentArticleId":{"type":"integer","format":"int64","description":"Artikel dieser Komponente"},"number":{"type":"string","description":"Artikelnummer der Komponente"},"name":{"type":"string","description":"Name der Komponente"},"description":{"type":"string","description":"Beschreibung der Komponente"},"quantity":{"type":"number","description":"Menge der Komponente"},"position":{"type":"integer","format":"int32","description":"Position der Komponente innerhalb des Containers"},"salesPrice":{"type":"number","description":"Verkaufspreis der Komponente"},"purchasePrice":{"type":"number","description":"Einkaufspreis (DEK) der Komponente"},"grossWeight":{"type":"number","description":"Brutto-Gewicht der Komponente"},"netWeight":{"type":"number","description":"Netto-Gewicht der Komponente"},"stockAmount":{"type":"number","description":"Bestand der Komponente"},"stockAvailable":{"type":"number","description":"verfügbare Menge der Komponente"}},"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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{articleId}/listings":{"get":{"tags":["Article"],"operationId":"getAllListings","parameters":[{"name":"articleId","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. de)","required":false,"style":"form","schema":{"type":"string"}},{"name":"allSalesChannels","in":"query","description":"sollen alle SalesChannel gelesen werden, auch die die kein listing haben","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":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte aktualisierung des listingStates","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":"Niedrigster Netto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Niedrigster Netto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"customLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"categoryRefs":{"type":"array","description":"Kategorien, denen dieses Listing zugeordnet ist","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":"Wert dieses Sales-Channel","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Wert des Default-Sales-Channel","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}},"required":["name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Wert dieses Sales-Channel"},"defaultValue":{"type":"string","description":"Wert des Default-Sales-Channel","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{articleId}/listings":{"post":{"tags":["Article"],"operationId":"createListing","parameters":[{"name":"articleId","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. 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":"soll der Artikel gelistet werden"},"listingState":{"type":"string","description":"Synchronisationsstatus eines Listings","enum":["DISABLED","NEED_SYNCHRONIZE","QUEUED_FOR_SYNCHRONIZE","SYNCHRONIZED","ERRONEOUS","NEED_DELETION","QUEUED_FOR_DELETION"],"readOnly":true},"listingStateChangeTime":{"type":"string","format":"date-time","description":"die letzte aktualisierung des listingStates","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":"Niedrigster Netto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"proposedLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (vom System ermittelt)","readOnly":true},"customLowestPriceNet":{"type":"number","description":"Niedrigster Netto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"customLowestPriceGross":{"type":"number","description":"Niedrigster Brutto-Preis der letzten 30 Tage (benutzerdefinierte Eingabe)"},"categoryRefs":{"type":"array","description":"Kategorien, denen dieses Listing zugeordnet ist","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":"Wert dieses Sales-Channel","items":{"$ref":"#/components/schemas/erp-product-ArticleIdentifier"}},"defaultValue":{"type":"array","description":"Wert des Default-Sales-Channel","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}},"required":["name","value"]},"erp-product-ArticleListing.WithDefaultsString":{"description":"description of this article","properties":{"value":{"type":"string","description":"Wert dieses Sales-Channel"},"defaultValue":{"type":"string","description":"Wert des Default-Sales-Channel","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"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

> Erstellt einen Etikettendruck-Stapel

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/print-labels":{"post":{"tags":["Article"],"summary":"Erstellt einen Etikettendruck-Stapel","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":"Anfrage Welche Artikel wie oft gedruckt werden soll","properties":{"article":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"report":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"serialNumber":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"print":{"type":"boolean","default":false,"description":"Etikettendruck"},"quantity":{"type":"integer","format":"int32","default":1,"description":"Menge"}}},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","readOnly":true}},"required":["id"]}}}}
```

## POST /erp/article-accessories/

> Create new Resource

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/article-accessories/":{"post":{"tags":["Article"],"summary":"Create new Resource","operationId":"create_70","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":"Einfügmenge"},"insertTerm":{"type":"string","description":"Zubehör Einfügeart","enum":["MANUAL","AUTOMATIC_QUANTITY_IF_ACCESSORY_INSERTED","AUTOMATIC_PROPORTIONAL_QUANTITY","AUTOMATIC_FIXED_QUANTITY"]},"sortOrder":{"type":"integer","format":"int32","description":"Sortiereihenfolge"}},"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":"Related account","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":"Activ","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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

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

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

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{refId}/workflow-state":{"get":{"tags":["Article"],"summary":"Liefert den Status der aktuellen Workflow-Instanz zu der gegebenen Referenz","operationId":"getWorkflowState_3","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow-Instanz gefunden","content":{"*/*":{"schema":{"type":"string","description":"Status einer Workflow-Instanz","enum":["CREATED","IN_PROCESS","COMPLETED_SUCCESSFULLY","COMPLETED_WITH_FAILURE","ERRONEOUS","ABORTED_CRASHED","ABORTED_MANUALLY","CRASHED","WAITING","INTERRUPTED"]}}}},"404":{"description":"Es existiert noch keine Workflow-Instanz","content":{"*/*":{"schema":{"type":"string","description":"Status einer Workflow-Instanz","enum":["CREATED","IN_PROCESS","COMPLETED_SUCCESSFULLY","COMPLETED_WITH_FAILURE","ERRONEOUS","ABORTED_CRASHED","ABORTED_MANUALLY","CRASHED","WAITING","INTERRUPTED"]}}}}}}}}}
```

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

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

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{refId}/workflow-instances-preset":{"get":{"tags":["Article"],"summary":"Liefert ein Query-Preset zur Selektion aller Workflow-Instanzen zu der gegebenen Referenz","operationId":"getWorkflowInstancesPreset_3","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow-Instanz gefunden","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":"Was kann mit diesem Preset abgebildet werden QUERY oder STATEMENT","enum":["QUERY","STATEMENT"]},"templateId":{"type":"string","description":"template dem dieser filter zugeordnet worden ist."},"templateGroupKey":{"type":"string","description":"templateGroupKey dem dieser filter zugeordnet worden ist."},"label":{"type":"string","description":"label für diesen filter"},"uiPayload":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"variables":{"type":"array","description":"Variablen für dieses Preset","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetVariable"}},"queryStatement":{"type":"string","description":"bei mode == STATEMENT, das vql-query"},"queryPredicate":{"$ref":"#/components/schemas/common-cunit-QueryPresetPredicate"},"results":{"type":"array","description":"ergebnisse","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"}},"sortAndOrders":{"type":"array","description":"sortierung","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":"zusätzliche konfigurationen","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetTransformation"}},"arithmeticQueryTerms":{"type":"array","description":"Arithmetische Terme - hier kommt die tatsächliche Berechnung rein","items":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTerm"}},"definition":{"type":"array","description":"spaltenbeschreibung dieser zelle (bei verschachtelung)","items":{"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuAttribute"},{"$ref":"#/components/schemas/core-cunit-CuMeta"}]},"readOnly":true},"permissionAggregation":{"$ref":"#/components/schemas/common-user-ObjectSpecificPermissionAggregation"},"forWorkflow":{"type":"boolean","default":false,"description":"für Workflows vorgesehen"},"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"},"common-cunit-QueryPresetVariable":{"description":"Die zu ersetzende Variable","properties":{"path":{"type":"string","description":"Der pfad, der dieses Attribut eindeutig beschreibt"},"definition":{"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuAttribute"},{"$ref":"#/components/schemas/core-cunit-CuMeta"}],"readOnly":true},"mandatory":{"type":"boolean","description":"Ob die Variable ein Pflichtfeld ist oder nicht"},"variableName":{"type":"string","description":"Name der Variablen"},"visible":{"type":"boolean","default":true,"description":"Handelt es sich um eine sichtbare Variable?"},"alignX":{"type":"integer","format":"int32","description":"Anordnung im UI - X-Koordinate"},"alignY":{"type":"integer","format":"int32","description":"Anordnung im UI - Y-Koordinate"},"alignWidth":{"type":"integer","format":"int32","description":"Anordnung im UI - Breite"},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"allowDialogMultipleChoice":{"type":"boolean","default":false,"description":"Kann eine Mehrfachauswahl erfolgen?"}}},"core-cunit-CuAttribute":{"allOf":[{"$ref":"#/components/schemas/core-cunit-MetaContent"},{"type":"object","properties":{"attribute":{"type":"string","description":"name des attributes der das ergebnis enthält"},"path":{"type":"string","description":"der pfad, der dieses attribut eindeutig beschreibt"},"displayName":{"type":"string","description":"der Name dieses Feldes"},"displayNameOverride":{"type":"boolean","default":false,"description":"der Name dieses Feldes wurde überschrieben (alias oder funktion)"},"groupDisplayName":{"type":"string","description":"der Name der Gruppe, dieses Feldes"},"parentDisplayName":{"type":"string","description":"der Name des Referenzierenden Feldes"},"resultable":{"type":"boolean","default":true,"description":"kann dieses Feld ein Ergebnisfeld sein"},"filterable":{"type":"boolean","default":true,"description":"kann nach diesem feld gefiltert werden"},"sortable":{"type":"boolean","default":true,"description":"ist dieses Feld sortierbar"},"visible":{"type":"boolean","default":true,"description":"soll dieses Feld angezeigt werden"},"functions":{"type":"array","description":"angewendete funktionen (wenn das als Result MetaData verwendet wird)","items":{"type":"string","description":"angewendete funktionen (wenn das als Result MetaData verwendet wird)"}},"sortDirection":{"type":"string","description":"Info, wie diese spalte sortiert worden ist"},"constraint":{"$ref":"#/components/schemas/core-cunit-CuAttributeConstraint"},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"data-type-identifier für dieses Attribut (falls dataType leer ist)","readOnly":true},"modelType":{"type":"string","description":"Attribut gehört zum Modelltyp 'statisch' oder 'dynamisch'","enum":["STATIC","DYNAMIC"],"readOnly":true},"headers":{"type":"array","description":"bei einem gruppierten Header (e.g. CrossTable) werden hier die einzelnen gruppen beschrieben","items":{"$ref":"#/components/schemas/core-cunit-CuAttribute.HeaderGroup"},"readOnly":true}}}]},"core-cunit-MetaContent":{"description":"Definition dieser Variable","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":"spaltenbeschreibung dieser zelle (bei verschachtelung)","items":{"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuAttribute"},{"$ref":"#/components/schemas/core-cunit-CuMeta"}]}}}},{"type":"object","properties":{"definition":{"$ref":"#/components/schemas/core-cunit-CuAttribute"}}}]},"core-cunit-CuAttributeConstraint":{"description":"constraints für dieses Attribut","properties":{"minLength":{"type":"integer","format":"int32","description":"Minimal-Länge (von Zeichenketten oder Arrays)","readOnly":true},"maxLength":{"type":"integer","format":"int32","description":"Maximal-Länge (von Zeichenketten oder Arrays)","readOnly":true},"minValue":{"type":"integer","format":"int64","description":"minimaler Wert","readOnly":true},"includeMinValue":{"type":"boolean","description":"ist der minimale Wert inklusive?","readOnly":true},"maxValue":{"type":"integer","format":"int64","description":"maximaler Wert","readOnly":true},"includeMaxValue":{"type":"boolean","description":"ist der maximale Wert inklusive?","readOnly":true},"notNull":{"type":"boolean","default":false,"description":"ist der Wert 'null' verboten?","readOnly":true},"notBlank":{"type":"boolean","description":"Bei Strings: ist ein String nur aus Whitespace verboten?","readOnly":true}}},"core-cunit-CuAttributeDataType":{"description":"data-type für dieses Attribut (falls dataTypeIdentifier leer ist)","properties":{"identifier":{"type":"string","description":"Datentyp-identifier","readOnly":true},"jsType":{"type":"string","description":"welcher Typ ist es","readOnly":true},"objectRefIdentifier":{"type":"string","description":"bei Object_Ref: welcher Typ ist es genau","readOnly":true},"filterOptions":{"$ref":"#/components/schemas/core-cunit-CuAttributeFilterOptions"},"functions":{"type":"array","description":"welche Funktionen sind erlaubt?","items":{"type":"string","description":"welche Funktionen sind erlaubt?"},"readOnly":true},"predicateOperations":{"type":"array","description":"welche Operations sind erlaubt?","items":{"type":"string","description":"welche Operations sind erlaubt?","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 Attribut Filter Optionen","properties":{"filterValues":{"type":"array","description":"Mögliche Filterwerte","items":{"type":"string","description":"Mögliche Filterwerte"}},"filterDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"multipleChoice":{"type":"boolean","default":false,"description":"Kann eine Mehrfachauswahl erfolgen?"}}},"core-cunit-CuAttribute.HeaderGroup":{"description":"bei einem gruppierten Header (e.g. CrossTable) werden hier die einzelnen gruppen beschrieben","properties":{"displayName":{"type":"string","description":"der Name dieses Feldes"},"displayNameOverride":{"type":"boolean","default":false,"description":"der Name dieses Feldes wurde überschrieben (alias oder funktion)"},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"data-type-identifier für dieses Attribut (falls dataType leer ist)","readOnly":true},"groupDisplayName":{"type":"string","description":"der Name der Gruppe, dieses Feldes"},"data":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}},"common-cunit-QueryPresetPredicate":{"description":"Bedingungen zur Selektion von Lagerplätzen","properties":{"type":{"type":"string","description":"die Operation für diesen Filter","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":"(bei junction) child-definitionen","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetPredicate"}},"property":{"type":"string","description":"filter property"},"values":{"type":"array","description":"filter werte","items":{"type":"string","description":"filter werte"}},"visible":{"type":"boolean","default":true,"description":"Sichtbarkeit bei Variablen"},"functions":{"type":"array","description":"Eine SQL-Funktion, die im Predicate angewendet wird","items":{"type":"string","description":"Eine SQL-Funktion, die im Predicate angewendet wird"}}},"required":["operator","type"]},"common-cunit-QueryPresetResult":{"description":"Ergebnisse","properties":{"property":{"type":"string","description":"property"},"displayName":{"type":"string","description":"title dieser spalte"},"functions":{"type":"array","description":"funktionen","items":{"type":"string","description":"funktionen"}},"visible":{"type":"boolean","default":true,"description":"sichtbare Ergebnisspalte"}},"required":["property"]},"common-cunit-QueryPresetSortOrder":{"description":"sort and order anweisungen","properties":{"property":{"type":"string","description":"property"},"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":"das Limit (MaxRecordCount) für diesen Query"}}},"common-cunit-QueryPresetOption":{"description":"options","properties":{"distinctResult":{"type":"boolean","description":"soll der Query mit einem Distinct durchgeführt werden"}}},"common-cunit-QueryPresetTransformation":{"description":"zusätzliche konfigurationen","properties":{"crossTable":{"$ref":"#/components/schemas/common-cunit-QueryPresetCrossTableTransformation"}}},"common-cunit-QueryPresetCrossTableTransformation":{"description":"enthält die felder, die in einer cross-table für die reihenbildung verantwortlich sind (im grunde -> der group-key)","properties":{"rowSpecs":{"type":"array","description":"enthält die felder, die in einer cross-table für die reihenbildung verantwortlich sind (im grunde -> der group-key)","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"}},"columnSpecs":{"type":"array","description":"enthält die felder, die in der cross-table als dynamische spalten erstellt werden sollen","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"}},"results":{"type":"array","description":"enthält die felder, die pro rowSpec-Kombination je nach Spaltenausprägung ermittelt werden sollen","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetCrossTableTransformation.QueryPresetCrossTableCell"}}},"required":["columnSpecs","results","rowSpecs"]},"common-cunit-QueryPresetCrossTableTransformation.QueryPresetCrossTableCell":{"description":"enthält die felder, die pro rowSpec-Kombination je nach Spaltenausprägung ermittelt werden sollen","properties":{"result":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"},"cellView":{"type":"string","description":"darstellung der werte","enum":["AS_IS","PERCENT_COL"]},"sumColumn":{"type":"boolean","default":false,"description":"soll eine spaltensumme erzeugt werden"},"rowMode":{"type":"string","description":"soll eine zeilensumme erzeugt werden","enum":["DATA","DATA_AND_TOTAL","TOTAL"]},"aggregateFunction":{"type":"string","description":"die funktion mit der die werte der Zelle aggregiert werden"}}},"common-cunit-ArithmeticQueryTerm":{"description":"Arithmetische Terme - hier kommt die tatsächliche Berechnung rein","properties":{"termName":{"type":"string","description":"Der Name des Terms für die Verarbeitung und Darstellung"},"terms":{"type":"array","description":"Die inneren Terme - entweder Verweise auf Attribute oder weitere Verschachtelungen der Berechnung","items":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTermInner"}},"operations":{"type":"array","description":"Die Operationen, die ausgeführt werden sollen mit den Termen","items":{"type":"string","description":"Die Operationen, die ausgeführt werden sollen mit den Termen","enum":["PLUS","MINUS","MULTIPLY","DIVIDE"]}}}},"common-cunit-ArithmeticQueryTermInner":{"description":"Die inneren Terme - entweder Verweise auf Attribute oder weitere Verschachtelungen der Berechnung","properties":{"fragment":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTermFragment"},"attribute":{"type":"string","description":"Ein echtes Attribut aus dem Template"},"fixedValue":{"type":"number","description":"Ein Fixwert"}}},"common-cunit-ArithmeticQueryTermFragment":{"description":"Das Termfragment - eine weitere Verschachtelung mit eigenen Operationen","properties":{"operations":{"type":"array","description":"Die Operationen, die ausgeführt werden sollen mit den Termen","items":{"type":"string","description":"Die Operationen, die ausgeführt werden sollen mit den Termen","enum":["PLUS","MINUS","MULTIPLY","DIVIDE"]}}}},"common-user-ObjectSpecificPermissionAggregation":{"description":"alle Nutzer-/Gruppen-Berechtigungen","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":"Nutzer-Berechtigungen","items":{"$ref":"#/components/schemas/common-user-ObjectSpecificUserPermission"}},"groupPermissions":{"type":"array","description":"Gruppen-Berechtigungen","items":{"$ref":"#/components/schemas/common-user-ObjectSpecificGroupPermission"}},"operationForAllUsers":{"type":"string","description":"Zugriffsrechte für alle Nutzer","enum":["READ_ONLY","READ_AND_EDIT"]}}},"common-user-ObjectSpecificUserPermission":{"description":"Nutzer-Berechtigungen","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":"Berechtigung","enum":["READ_ONLY","READ_AND_EDIT"]}}},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"common-user-ObjectSpecificGroupPermission":{"description":"Gruppen-Berechtigungen","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":"Berechtigung","enum":["READ_ONLY","READ_AND_EDIT"]}}},"common-cunit-QueryPresetUserOptions":{"description":"nutzerbezogene Einstellungen","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":"angepinnt?"}},"required":["pinned"]}}}}
```

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

> Liefert die neuste Workflow-Instanz zu der gegebenen Referenz

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{refId}/latest-workflow-instance":{"get":{"tags":["Article"],"summary":"Liefert die neuste Workflow-Instanz zu der gegebenen Referenz","operationId":"getLatestWorkflowInstance_3","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow-Instanz gefunden","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-workflow-WorkflowInstance"}}}},"404":{"description":"Es existiert noch keine Workflow-Instanz","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":"Status einer Workflow-Instanz","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":"Schritte des Workflows","items":{"$ref":"#/components/schemas/common-workflow-WorkItem"}},"logEntries":{"type":"array","description":"Logging-Einträge chronologisch sortiert","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":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"common-workflow-WorkItem":{"description":"Schritte des Workflows","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":"Bearbeitungszustand eines Work-Items","enum":["OPEN","IN_PROCESS","COMPLETED","ERRONEOUS","ABORTED"]},"workflowElementRef":{"type":"integer","format":"int64","description":"Workflow-Element, das abgebildet wird"},"parentWorkItemRef":{"type":"integer","format":"int64","description":"Work-Item im übergeordneten Workflow, wenn es sich um einen Unter-Workflow handelt"},"responsibleUserRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"logEntries":{"type":"array","description":"Logging-Einträge chronologisch sortiert","items":{"$ref":"#/components/schemas/common-workflow-WorkflowInstanceLogLine"}},"splitResult":{"type":"string","description":"Für Split-Gateways: mit welchem Ergebnis wurde dieses Work-Item ausgeführt"}}},"common-workflow-WorkflowInstanceLogLine":{"description":"Logging-Einträge chronologisch sortiert","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":"ID der Workflow-Instanz"},"workItemId":{"type":"integer","format":"int64","description":"ID des Work-Items"},"logTime":{"type":"string","format":"date-time","description":"Zeitstempel"},"origin":{"type":"string","description":"Wodurch wurde dieser Eintrag ausgelöst","enum":["DEBUG","INFO","WARNING","ERROR","CONSOLE","STACKTRACE"]},"message":{"type":"string","description":"Nachricht"},"messageKey":{"type":"string","description":"I18n-Key"},"propertyPath":{"type":"string","description":"Pfad"},"messageParameter":{"type":"object","additionalProperties":{"type":"object","description":"Parameter für die I18n-Nachricht"},"description":"Parameter für die I18n-Nachricht"}}}}}}
```

## 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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"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":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/products":{"get":{"tags":["Article"],"operationId":"getProductByArticleId","parameters":[{"name":"id","in":"path","description":"an article id","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":"Handelt es sich um ein Gebinde?"},"bundleSchemaRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"type":{"type":"string","description":"Artikelarten","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"]},"articleRefs":{"type":"array","description":"alle artikel, die zu diesem Produkt gehören","items":{"$ref":"#/components/schemas/erp-product-ProductArticleRef"},"readOnly":true},"availabilityDetermination":{"$ref":"#/components/schemas/erp-product-ArticleAvailabilityDetermination"},"serialType":{"type":"string","description":"Serientyp eines Artikels","enum":["NONE","SERIAL_NUMBER","LOT","DOUBLE_SERIAL_NUMBER"]},"expiryDateType":{"type":"string","description":"Art des Haltbarkeitsdatums bei Serienartikeln","enum":["NONE","BEST_BEFORE_DATE","EXPIRATION_DATE"]},"warrantyInMonths":{"type":"integer","format":"int32","description":"Garantie in Monaten"},"serialNumberLabelingType":{"type":"string","description":"Seriennummer Auszeichnungsart","enum":["MANUAL","AUTOMATIC_ON_SUPPLIER_ORDER","AUTOMATIC_ON_SUPPLIER_DELIVERY"]},"fabricationSerialNumberLabelingType":{"type":"string","description":"Produktions-S/N-Auszeichnungsart","enum":["QUERY_ON_START","QUERY_ON_FINISH","INHERITANCE","AUTOMATICALLY_ON_START","AUTOMATICALLY_ON_FINISH"]},"customsTariffNumber":{"type":"string","description":"Zolltarifnummer","maxLength":15,"minLength":0},"countryOfOrigin":{"$ref":"#/components/schemas/common-masterdata-CountryReference"},"regionOfOrigin":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"useSerialSequencerConfiguration":{"type":"boolean","description":"Soll ein eigener Zählerkreis für Seriennummern verwendet werden?"},"serialSequencerConfiguration":{"$ref":"#/components/schemas/common-sequencer-SequencerConfiguration"},"variantValues":{"type":"array","description":"Variantenwerte","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":"Related account","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":"Activ","readOnly":true}},"required":["id"]},"erp-product-ProductArticleRef":{"description":"alle artikel, die zu diesem Produkt gehören","properties":{"id":{"type":"integer","format":"int64","description":"Article ID"},"number":{"type":"string","description":"Article 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":"Verfügbarkeitsermittlung für die Artikelstammdaten/Bestandsansicht","properties":{"inStock":{"type":"string","description":"wie wird der Bestand behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reserved":{"type":"string","description":"wie werden Reserviert-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"ordered":{"type":"string","description":"wie werden Bestellt-Mengen behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"inPicking":{"type":"string","description":"wie werden Mengen in Kommissionierung behandelt","enum":["IGNORE","ADD","SUBTRACT"]},"reporting":{"type":"string","description":"wie werden Meldebestände behandelt","enum":["IGNORE","ADD","SUBTRACT"]}}},"common-masterdata-CountryReference":{"description":"Country code","properties":{"id":{"type":"integer","format":"int64","description":"ID des Landes"},"isoAlpha2":{"type":"string","description":"IsoAlpha2-Code des Landes"},"label":{"type":"string","description":"Bezeichnung des Landes","readOnly":true}}},"common-sequencer-SequencerConfiguration":{"description":"Eigener Zählerkreis für Seriennummern","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":"Sequencer aktiv?"}},"required":["configurationDetail"]},"common-sequencer-SequencerConfigurationDetail":{"description":"Contains details about the sequencer configuration","properties":{"type":{"type":"string","description":"Typ der Sequenz","enum":["NON_POOLED_SEQUENCES","POOLED_SEQUENCES","PREFETCHED_SEQUENCES"]},"assignmentMode":{"type":"string","description":"Vergabeverfahren","enum":["MANUAL","AUTOMATIC","SEMI_AUTOMATIC","FREE"]},"length":{"type":"integer","format":"int32","description":"Länge"},"padChar":{"type":"string","description":"Auffüllzeichen","maxLength":1,"minLength":1,"pattern":"^[0-9]*$"},"expression":{"type":"string","description":"Präfix-Ausdruck"},"postExpression":{"type":"string","description":"Postfix-Ausdruck"},"initialValue":{"type":"integer","format":"int64","description":"Initialer Wert"},"numberUnique":{"type":"boolean","default":true,"description":"Eindeutigkeitsprüfung"}},"required":["assignmentMode","initialValue","length","padChar","type"]},"common-variant-VariantValueReference":{"description":"Variantenwerte","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"Bezeichnung","readOnly":true},"description":{"type":"string","description":"Beschreibung","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.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"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/variables

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"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":{"attribute":{"type":"string","description":"name des attributes der das ergebnis enthält"},"path":{"type":"string","description":"der pfad, der dieses attribut eindeutig beschreibt"},"displayName":{"type":"string","description":"der Name dieses Feldes"},"displayNameOverride":{"type":"boolean","default":false,"description":"der Name dieses Feldes wurde überschrieben (alias oder funktion)"},"groupDisplayName":{"type":"string","description":"der Name der Gruppe, dieses Feldes"},"parentDisplayName":{"type":"string","description":"der Name des Referenzierenden Feldes"},"resultable":{"type":"boolean","default":true,"description":"kann dieses Feld ein Ergebnisfeld sein"},"filterable":{"type":"boolean","default":true,"description":"kann nach diesem feld gefiltert werden"},"sortable":{"type":"boolean","default":true,"description":"ist dieses Feld sortierbar"},"visible":{"type":"boolean","default":true,"description":"soll dieses Feld angezeigt werden"},"functions":{"type":"array","description":"angewendete funktionen (wenn das als Result MetaData verwendet wird)","items":{"type":"string","description":"angewendete funktionen (wenn das als Result MetaData verwendet wird)"}},"sortDirection":{"type":"string","description":"Info, wie diese spalte sortiert worden ist"},"constraint":{"$ref":"#/components/schemas/core-cunit-CuAttributeConstraint"},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"data-type-identifier für dieses Attribut (falls dataType leer ist)","readOnly":true},"modelType":{"type":"string","description":"Attribut gehört zum Modelltyp 'statisch' oder 'dynamisch'","enum":["STATIC","DYNAMIC"],"readOnly":true},"headers":{"type":"array","description":"bei einem gruppierten Header (e.g. CrossTable) werden hier die einzelnen gruppen beschrieben","items":{"$ref":"#/components/schemas/core-cunit-CuAttribute.HeaderGroup"},"readOnly":true}}}]},"core-cunit-MetaContent":{"description":"Definition dieser Variable","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":"spaltenbeschreibung dieser zelle (bei verschachtelung)","items":{"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuAttribute"},{"$ref":"#/components/schemas/core-cunit-CuMeta"}]}}}},{"type":"object","properties":{"definition":{"$ref":"#/components/schemas/core-cunit-CuAttribute"}}}]},"core-cunit-CuAttributeConstraint":{"description":"constraints für dieses Attribut","properties":{"minLength":{"type":"integer","format":"int32","description":"Minimal-Länge (von Zeichenketten oder Arrays)","readOnly":true},"maxLength":{"type":"integer","format":"int32","description":"Maximal-Länge (von Zeichenketten oder Arrays)","readOnly":true},"minValue":{"type":"integer","format":"int64","description":"minimaler Wert","readOnly":true},"includeMinValue":{"type":"boolean","description":"ist der minimale Wert inklusive?","readOnly":true},"maxValue":{"type":"integer","format":"int64","description":"maximaler Wert","readOnly":true},"includeMaxValue":{"type":"boolean","description":"ist der maximale Wert inklusive?","readOnly":true},"notNull":{"type":"boolean","default":false,"description":"ist der Wert 'null' verboten?","readOnly":true},"notBlank":{"type":"boolean","description":"Bei Strings: ist ein String nur aus Whitespace verboten?","readOnly":true}}},"core-cunit-CuAttributeDataType":{"description":"data-type für dieses Attribut (falls dataTypeIdentifier leer ist)","properties":{"identifier":{"type":"string","description":"Datentyp-identifier","readOnly":true},"jsType":{"type":"string","description":"welcher Typ ist es","readOnly":true},"objectRefIdentifier":{"type":"string","description":"bei Object_Ref: welcher Typ ist es genau","readOnly":true},"filterOptions":{"$ref":"#/components/schemas/core-cunit-CuAttributeFilterOptions"},"functions":{"type":"array","description":"welche Funktionen sind erlaubt?","items":{"type":"string","description":"welche Funktionen sind erlaubt?"},"readOnly":true},"predicateOperations":{"type":"array","description":"welche Operations sind erlaubt?","items":{"type":"string","description":"welche Operations sind erlaubt?","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 Attribut Filter Optionen","properties":{"filterValues":{"type":"array","description":"Mögliche Filterwerte","items":{"type":"string","description":"Mögliche Filterwerte"}},"filterDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"multipleChoice":{"type":"boolean","default":false,"description":"Kann eine Mehrfachauswahl erfolgen?"}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"core-cunit-CuAttribute.HeaderGroup":{"description":"bei einem gruppierten Header (e.g. CrossTable) werden hier die einzelnen gruppen beschrieben","properties":{"displayName":{"type":"string","description":"der Name dieses Feldes"},"displayNameOverride":{"type":"boolean","default":false,"description":"der Name dieses Feldes wurde überschrieben (alias oder funktion)"},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"data-type-identifier für dieses Attribut (falls dataType leer ist)","readOnly":true},"groupDisplayName":{"type":"string","description":"der Name der Gruppe, dieses Feldes"},"data":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}}}}}
```

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

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

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/print-labels/candidates":{"get":{"tags":["Article"],"summary":"Erstellt entweder eine Etikettendruck-Vorschau zu einem Beleg oder einem Artikel","operationId":"createPrintOrderPreview","parameters":[{"name":"documentId","in":"query","description":"Beleg","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"articleId","in":"query","description":"Artikel","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/erp-product-ArticlePrintLabelOrderResponse"}}}}}}}}},"components":{"schemas":{"erp-product-ArticlePrintLabelOrderResponse":{"description":"Antwort Welche Artikel wie oft gedruckt werden soll","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":"Seriennummernpflichtig?","readOnly":true},"serialNumber":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"print":{"type":"boolean","description":"Etikettendruck"},"quantity":{"type":"integer","format":"int32","description":"Menge"}}},"core-api-ApiObjectReference":{"description":"Related account","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":"Activ","readOnly":true}},"required":["id"]}}}}
```

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

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"Article","description":"the Article API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/articles/{id}/listings/{listingId}":{"delete":{"tags":["Article"],"operationId":"deleteListing","parameters":[{"name":"id","in":"path","description":"an article id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"listingId","in":"path","description":"a listing id","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"languageCode","in":"query","description":"Gewünschte Sprache (z.B. de)","style":"form","schema":{}}],"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: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.