Product

Artikel kopieren

Update existing Resource

put

Path parameters

idinteger · int64Required

an identifier

Body

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

bundlebooleanOptional

Handelt es sich um ein Gebinde?

Default: false

typestring · enumOptional

Artikelarten

Possible values:

serialTypestring · enumOptional

Serientyp eines Artikels

Possible values:

expiryDateTypestring · enumOptional

Art des Haltbarkeitsdatums bei Serienartikeln

Possible values:

warrantyInMonthsinteger · int32Optional

Garantie in Monaten

serialNumberLabelingTypestring · enumOptional

Seriennummer Auszeichnungsart

Possible values:

fabricationSerialNumberLabelingTypestring · enumOptional

Produktions-S/N-Auszeichnungsart

Possible values:

customsTariffNumberstring · max: 15Optional

Zolltarifnummer

useSerialSequencerConfigurationbooleanOptional

Soll ein eigener Zählerkreis für Seriennummern verwendet werden?

Responses

200

successful operation

*/*

404

Resource was not found

*/*

422

Resource was not valid to process

*/*

put

/erp/products/{id}

HTTPcURLJavaScriptPython

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

{
  "version": "text",
  "info": {},
  "id": "text",
  "bundle": false,
  "bundleSchemaRef": {
    "id": "text"
  },
  "type": "WITH_STOCK",
  "availabilityDetermination": {
    "inStock": "IGNORE",
    "reserved": "IGNORE",
    "ordered": "IGNORE",
    "inPicking": "IGNORE",
    "reporting": "IGNORE"
  },
  "serialType": "NONE",
  "expiryDateType": "NONE",
  "warrantyInMonths": 1,
  "serialNumberLabelingType": "MANUAL",
  "fabricationSerialNumberLabelingType": "QUERY_ON_START",
  "customsTariffNumber": "text",
  "countryOfOrigin": {
    "id": 1,
    "isoAlpha2": "text"
  },
  "regionOfOrigin": {
    "id": "text"
  },
  "useSerialSequencerConfiguration": true,
  "serialSequencerConfiguration": {
    "version": "text",
    "info": {},
    "id": "text",
    "configurationDetail": {
      "type": "NON_POOLED_SEQUENCES",
      "assignmentMode": "MANUAL",
      "length": 1,
      "padChar": "text",
      "expression": "text",
      "postExpression": "text",
      "initialValue": 1,
      "numberUnique": true
    },
    "alternativeConfiguration": {
      "id": "text"
    },
    "active": true
  },
  "variantValues": [
    {
      "id": "text",
      "productVariantAttributeRefs": {
        "id": "text"
      }
    }
  ],
  "productVariantRef": {
    "id": "text"
  },
  "mainVariantProductRef": {
    "id": "text"
  }
}

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

post

Path parameters

idinteger · int64Required

a product id

Body

application/json

Responses

200

OK

*/*

post

/erp/products/{id}/copy

HTTPcURLJavaScriptPython

POST /api/erp/products/{id}/copy HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "modules": [
    "CUSTOM"
  ],
  "copyEntries": [
    {
      "originalArticleId": "text",
      "newNumber": "text"
    }
  ]
}

200

OK

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

Für Gebinde: Alle Lieferanten zu Artikeln des Gebindes

get

Path parameters

idinteger · int64Required

a product id

Responses

200

OK

*/*

get

/erp/products/{id}/suppliers

HTTPcURLJavaScriptPython

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

200

OK

[
  {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T14:20:24.097Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T14:20:24.097Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "articleId": "text",
    "articleName": "text",
    "accountId": "text",
    "articleNumber": "text",
    "accountDisplayName": "text",
    "active": true,
    "supplierArticleNumber": "text",
    "supplierArticleName": "text",
    "supplierArticleDescription": "text",
    "supplierArticleIdentifier": "text",
    "useSupplierArticleNumber": false,
    "useSupplierArticleName": false,
    "useSupplierArticleDescription": false,
    "useSupplierArticleIdentifier": false,
    "purchaseUnit": 1,
    "packagingUnit": 1,
    "productUnit": {
      "id": 1,
      "name": "text",
      "abbreviation": "text"
    },
    "deliveryTime": 1,
    "minimumOrderQuantity": 1,
    "supplierReportingStock": 1,
    "mainSupplier": false,
    "discountGroupRef": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    },
    "defaultNetPrice": 1,
    "defaultGrossPrice": 1,
    "productPrices": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T14:20:24.097Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T14:20:24.097Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "netPrice": 1,
        "grossPrice": 1,
        "priceBase": "NET_PRICE",
        "priceUnit": 1,
        "usedTaxRate": {
          "version": "text",
          "info": {
            "createdAt": "2026-02-10T14:20:24.097Z",
            "createdFrom": "text",
            "updatedAt": "2026-02-10T14:20:24.097Z",
            "updatedFrom": "text"
          },
          "id": "text",
          "typeRef": {
            "id": "text",
            "label": "text",
            "description": "text"
          },
          "active": true,
          "countryCode": "text",
          "rate": 19,
          "validFrom": "2026-02-10"
        },
        "qualifier": "SALES",
        "accountRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "articleRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "productGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "priceGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "manufacturerRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "discountGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "currencyRef": {
          "id": 1,
          "isoAlpha3": "text",
          "label": "text",
          "symbol": "text"
        },
        "fromQuantity": 1,
        "validFrom": "2026-02-10",
        "validUntil": "2026-02-10",
        "specialOfferPrice": false,
        "salesChannelRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "customerGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "supplierGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        }
      }
    ],
    "orderOnComponentBase": true,
    "dropShippingAllowed": true,
    "supplierPrintLabelSettings": {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T14:20:24.097Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T14:20:24.097Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "report": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "incomingCalculationMode": "NO_LABEL",
      "incomingPrintQuantity": 1,
      "outgoingCalculationMode": "NO_LABEL",
      "outgoingPrintQuantity": 1
    }
  }
]

Für Gebinde: Alle Kunden zu Artikeln des Gebindes

get

Path parameters

idinteger · int64Required

a product id

Responses

200

OK

*/*

get

/erp/products/{id}/customers

HTTPcURLJavaScriptPython

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

200

OK

[
  {
    "version": "text",
    "info": {
      "createdAt": "2026-02-10T14:20:24.097Z",
      "createdFrom": "text",
      "updatedAt": "2026-02-10T14:20:24.097Z",
      "updatedFrom": "text"
    },
    "id": "text",
    "articleId": 1,
    "articleName": "text",
    "accountId": 1,
    "articleNumber": "text",
    "accountDisplayName": "text",
    "active": true,
    "deviatingArticleNumber": "text",
    "deviatingArticleName": "text",
    "deviatingArticleDescription": "text",
    "deviatingArticleIdentifier": "text",
    "useDeviatingArticleNumber": true,
    "useDeviatingArticleName": true,
    "useDeviatingArticleDescription": true,
    "useDeviatingArticleIdentifier": true,
    "lockedForCustomer": true,
    "defaultNetPrice": 1,
    "defaultGrossPrice": 1,
    "productPrices": [
      {
        "version": "text",
        "info": {
          "createdAt": "2026-02-10T14:20:24.097Z",
          "createdFrom": "text",
          "updatedAt": "2026-02-10T14:20:24.097Z",
          "updatedFrom": "text"
        },
        "id": "text",
        "netPrice": 1,
        "grossPrice": 1,
        "priceBase": "NET_PRICE",
        "priceUnit": 1,
        "usedTaxRate": {
          "version": "text",
          "info": {
            "createdAt": "2026-02-10T14:20:24.097Z",
            "createdFrom": "text",
            "updatedAt": "2026-02-10T14:20:24.097Z",
            "updatedFrom": "text"
          },
          "id": "text",
          "typeRef": {
            "id": "text",
            "label": "text",
            "description": "text"
          },
          "active": true,
          "countryCode": "text",
          "rate": 19,
          "validFrom": "2026-02-10"
        },
        "qualifier": "SALES",
        "accountRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "articleRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "productGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "priceGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "manufacturerRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "discountGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "currencyRef": {
          "id": 1,
          "isoAlpha3": "text",
          "label": "text",
          "symbol": "text"
        },
        "fromQuantity": 1,
        "validFrom": "2026-02-10",
        "validUntil": "2026-02-10",
        "specialOfferPrice": false,
        "salesChannelRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "customerGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        },
        "supplierGroupRef": {
          "id": "text",
          "label": "text",
          "description": "text",
          "active": true
        }
      }
    ],
    "customerPrintLabelSettings": {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T14:20:24.097Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T14:20:24.097Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "report": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "incomingCalculationMode": "NO_LABEL",
      "incomingPrintQuantity": 1,
      "outgoingCalculationMode": "NO_LABEL",
      "outgoingPrintQuantity": 1
    }
  }
]

get

Path parameters

idinteger · int64Required

ID des Produkts

Query parameters

priceUnitTypeIdstringRequired

Id der Mengeneinheit für den der Preis gilt

convertToUnitTypeIdstringRequired

Id der Mengeneinheit für den der Preis umgerechnet werden soll

pricestringRequired

Preis

Responses

200

OK

*/*

Responsenumber

get

/erp/products/{id}/convertPriceForGivenUnitTypeForAnotherUnitType

HTTPcURLJavaScriptPython

GET /api/erp/products/{id}/convertPriceForGivenUnitTypeForAnotherUnitType?priceUnitTypeId=text&convertToUnitTypeId=text&price=text HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

1