ConnectCloud Developers

Get an article with its sales price and suppliers (tenant:masterdata:read)

GET /api/masterdata/products/{id}

Module: Master data · operationId: getProduct · Tag: Articles · Auth: access token (Authorization: Bearer <accessToken>)

Parameters

Name In Type Required Description
id path string (uuid) yes

Responses

  • 200 The article (application/json)
  • 401 Missing, invalid or expired token (empty body)
  • 403 The token lacks the permission or carries no tenant (application/json)
  • 404 Not found in the caller's tenant (or merged, see code) (application/json)

Fields of the 200 answer:

  • shortName (string, required): Kurzbezeichnung: required, one line (no line breaks); the name in lists, pickers and trade records (max length 80)
  • accounting (object, read-only): Resolved revenue account and cost center (only on the single article, not in lists)
  • articleNumber (string): Unique per tenant; assigned from the PRODUCT range when empty (max length 64)
  • articleType (string): Article type; decides the required fields (one of GOODS, SERVICE, SUBSCRIPTION, TEXT, FEE; default "GOODS")
  • basePriceUnit (string): Unit of the base price
  • blockReason (string): Reason of the block (max length 255)
  • blockedFrom (string (date), nullable): First day of the block (YYYY-MM-DD)
  • blockedUntil (string (date), nullable): After blockedFrom
  • commissionRate (number, nullable): Commission in percent
  • contentQuantity (number, nullable): Content quantity (for the base price)
  • contentUnit (string): Unit of the content quantity
  • createdAt (string (date-time), read-only): Creation time
  • createdBy (string, read-only): Who created the article (subject of the token)
  • customerNo (string, read-only): Tenant customer number (from the token)
  • customsTariffNo (string): Customs tariff number
  • defaultSupplierId (string (uuid), read-only): Id of the default supplier link
  • defaultWarehouseCode (string): Default warehouse
  • description (string): Beschreibung: long text without limit
  • dimensionUnit (string): Unit of length, width and height (one of MM, CM, M)
  • ean (string): EAN/GTIN with 8, 12, 13 or 14 digits and check digit
  • height (number, nullable): Height in dimensionUnit
  • id (string (uuid), read-only): Id of the article
  • isBatchTracked (boolean): Only for GOODS
  • isBlocked (boolean): Blocked article
  • isCommissionEligible (boolean): Commission is paid
  • isDiscountEligible (boolean): Discounts may be granted
  • isSerialTracked (boolean): Only for GOODS
  • isSkontoEligible (boolean): Cash discount (Skonto) may be granted
  • isStockItem (boolean): Only for GOODS
  • length (number, nullable): Length in dimensionUnit
  • manufacturerAddressId (string (uuid), nullable): Manufacturer address
  • manufacturerName (string): Manufacturer name (max length 255)
  • manufacturerPartNumber (string): Manufacturer part number (MPN) (max length 64)
  • memo (string): Internal memo
  • minPrice (number, nullable): Lowest net price the article may be sold for; not above salesPrice
  • name (string): Bezeichnung: optional, may span several lines; documents use shortName when empty (max length 2000)
  • originCountryCode (string): Country of origin (ISO 3166-1 alpha-2)
  • priceQuantity (number): Quantity the sales price refers to (default 1)
  • productGroupId (string (uuid), nullable): Required except for TEXT (cleared there)
  • productGroupName (string, read-only): Name of the product group
  • purchasePrice (number, read-only): Purchase price of the default supplier
  • salesPrice (number, nullable): Net sales price per priceQuantity; required (0 is allowed) except for TEXT (cleared there)
  • searchTerm (string): Upper-cased short name (first 255 characters) when empty (max length 255)
  • specialPrice (number, nullable): Net special price; not below minPrice and not above salesPrice
  • specialValidFrom (string (date), nullable): First day of the special price (dropped without specialPrice)
  • specialValidTo (string (date), nullable): Last day of the special price; not before specialValidFrom
  • suppliers (array of ProductSupplier): Suppliers with one purchase price each
    • purchasePrice (number, required): Net purchase price
    • supplierAddressId (string (uuid), required): Supplier address; once per article
    • currencyCode (string): Currency of the purchase price (ISO 4217)
    • deliveryDays (integer, nullable): Delivery time in days
    • id (string (uuid)): Id of the supplier link
    • isDefault (boolean): At most one; the first supplier is the default when none is set
    • lastPurchaseAt (string (date), nullable): Date of the last purchase (YYYY-MM-DD)
    • minOrderQty (number, nullable): Minimum order quantity
    • orderUnitCode (string): Order unit (code of units)
    • supplierArticleNumber (string): The supplier's article number (max length 64)
    • supplierName (string, read-only): Display name of the supplier address
  • svcAutoRenew (boolean): Subscription renews automatically
  • svcBilling (string): Must not be NONE for SUBSCRIPTION (one of NONE, ADVANCE, ARREARS; default "NONE")
  • svcBillingCycleMonths (integer, nullable): Billing cycle; required for SUBSCRIPTION (max 120)
  • svcNoticePeriodMonths (integer, nullable): Notice period of the subscription in months
  • svcTermMonths (integer, nullable): Subscription term; required for SUBSCRIPTION
  • syncStatus (string, read-only): Reserved for an ERP synchronisation; STANDALONE for records of this API (one of STANDALONE, PENDING_CREATION, PENDING_UPDATE, SYNCED, CONFLICT, ERROR)
  • taxKeyCode (string): Code of tax-keys; empty takes the product group's default tax key; required except for TEXT (cleared there)
  • tenantName (string, read-only): Tenant name (from the token)
  • unitCode (string): Code of units; empty takes the product group's default unit; required except for TEXT
  • updatedAt (string (date-time), read-only): Time of the last change
  • updatedBy (string, read-only): Who changed the article last (subject of the token)
  • version (integer): Optimistic locking version (ignored on create)
  • weightKg (number, nullable): Weight in kg
  • width (number, nullable): Width in dimensionUnit

Example 200 answer:

{
  "accounting": {
    "costCenter": "4200",
    "costCenterSource": "GROUP",
    "revenueAccount": "4400",
    "source": "GROUP",
    "sourceGroupCode": "HARDWARE",
    "taxKeyCode": "STANDARD"
  },
  "articleNumber": "HW-1004",
  "articleType": "GOODS",
  "createdAt": "2026-01-02T08:00:00Z",
  "createdBy": "laura.kaestner@muster-it.example",
  "customerNo": "99999",
  "defaultSupplierId": "7a9c1e3a-5b7d-4f9a-8c1e-3a5b7d9f1a3c",
  "ean": "4061234500045",
  "id": "6e8a0c2e-4f6a-4b8c-8d0e-2f4a6c8e0a2c",
  "isBatchTracked": false,
  "isBlocked": false,
  "isCommissionEligible": false,
  "isDiscountEligible": true,
  "isSerialTracked": false,
  "isSkontoEligible": true,
  "isStockItem": true,
  "manufacturerName": "Nordlicht IT-Distribution",
  "manufacturerPartNumber": "NL-DOCKC100",
  "name": "USB-C Dockingstation 100 W\n2 × DisplayPort, HDMI, 4 × USB-A, Gigabit-LAN",
  "priceQuantity": 1,
  "productGroupId": "8d0b6f3e-2c4a-4e7b-9a1d-5f3c2e1b0a97",
  "productGroupName": "Hardware",
  "purchasePrice": 139,
  "salesPrice": 189,
  "searchTerm": "DOCKINGSTATION USB-C",
  "shortName": "USB-C Dockingstation 100 W",
  "suppliers": [
    {
      "currencyCode": "EUR",
      "deliveryDays": 2,
      "id": "9c1e3a5c-7d9f-4b1c-8e3a-5c7d9f1b3c5e",
      "isDefault": true,
      "lastPurchaseAt": "2026-09-23",
      "minOrderQty": 1,
      "orderUnitCode": "STK",
      "purchasePrice": 139,
      "supplierAddressId": "7a9c1e3a-5b7d-4f9a-8c1e-3a5b7d9f1a3c",
      "supplierArticleNumber": "NL-DOCKC100",
      "supplierName": "Nordlicht IT-Distribution GmbH"
    }
  ],
  "svcBilling": "NONE",
  "syncStatus": "STANDALONE",
  "taxKeyCode": "STANDARD",
  "tenantName": "DEMO",
  "unitCode": "STK",
  "updatedAt": "2026-10-07T13:12:00Z",
  "updatedBy": "laura.kaestner@muster-it.example",
  "version": 4,
  "weightKg": 0.48
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/masterdata/products/3f6c1a52-7b1e-4d2a-9c8e-2b5f0d6a91e4' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI