MEDIIO API-Initiative
Join the initiative

Use case · Specific price information

Customer-specific price – specific to the article

Retrieve the correct net price for a specific article – per order unit, with VAT rate and validity. For creation, maintenance, comparison and ordering.

GET /api/Price
Join the initiative Back to use cases
api.host · REST
GET /api/Price?CustomerNumber=12345&ArticleNumber=… 
[
  {
    "articleNumber": "08154711",
    "prices": [
      { "orderUnit": "PAK", "netPrice": 5.00, "currency": "EUR", "vatRate": 19 }
    ]
  }
]

User story

„As a buyer / master data manager, I want to query price information for a specific article, so I can create, maintain, compare and, if needed, order the article with the correct price in materials management."

Scope

General provisions

Quotation requests and price requests are distinct. No conditions are queried. This case returns the specific price for a concrete article.

Specific article

Price for a concrete article – identified via customer number/GLN and article.

Per order unit

Without an order unit → all orderable units (1..n); with OrderUnit → only that unit.

No conditions

Conditions are not part of this query – price data only.

Net · VAT · validity

Net price, currency, VAT rate and validity; list price and discount optional.

Other pricing cases (separate use cases)

  • Full price list – complete price export.
  • Unspecific price information (“scissors”) – response with article name & price.
  • Supply prices (sets) – possibly different VAT rates, often as PDF.
  • Framework agreement.
  • Comparison price – comparable article for a third-party price.

Request

Parameters

Customer identification and article are mandatory; the order unit is optional. Parameters are combinable.

Parameter Query Meaning
Customer number ?CustomerNumber=12345 Customer identification (mandatory – alternatively GLN).
GLN ?Gln=4012345000009 Alternative to the customer number.
Supplier article number ?ArticleNumber=08154711 Article (mandatory – alternatively barcode).
GTIN / PZN ?BarcodeType=Gtin&Barcode=… Article by barcode.
Order unit ?OrderUnit=PAK Only this unit (optional).
Allowed barcode types: GTINHIBCPZN

Examples

Typical queries

As a consumer I want to … – and call the following endpoint:

get the price of an article for all order units

GET
https://host_url/api/Price?CustomerNumber=12345&ArticleNumber=08154711

get the price of an article for a specific order unit

GET
https://host_url/api/Price?CustomerNumber=12345&ArticleNumber=08154711&OrderUnit=PAK

get the price for a GTIN

GET
https://host_url/api/Price?CustomerNumber=12345&BarcodeType=Gtin&Barcode=99999999999994

get the price for a PZN

GET
https://host_url/api/Price?CustomerNumber=12345&BarcodeType=Pzn&Barcode=01234567

get the price using GLN instead of a customer number

GET
https://host_url/api/Price?Gln=4012345000009&ArticleNumber=08154711

Response

Response (JSON)

One array entry per article. prices holds one entry per orderable order unit with net price, currency, VAT rate, content, minimum order quantity/lot size and validity (list price & discount optional).

Response · application/json 
[
  {
    "articleNumber": "string",
    "shortDescription": "string",
    "manufacturerArticleNumber": "string",
    "manufacturerName": "string",
    "prices": [
      {
        "barcodes": [
          {
            "type": "Gtin",
            "code": "string",
            "validFrom": "2026-05-20T11:26:43.829Z",
            "validTo": "2026-05-20T11:26:43.829Z"
          }
        ],
        "orderUnit": "string",
        "contentQuantity": 0,
        "baseUnit": "string",
        "netPrice": 0,
        "currency": "string",
        "vatRate": 0,
        "minOrderQuantity": 0,
        "lotSize": 0,
        "listPrice": 0,
        "discountRate": 0,
        "validUntil": "2026-05-20T11:26:43.829Z"
      }
    ]
  }
]

Key fields

articleNumber

Supplier article number (mandatory).

shortDescription

Short article description (mandatory).

manufacturerArticleNumber

Manufacturer article number (mandatory).

manufacturerName

Manufacturer name (optional).

prices[]

One entry per order unit (1..n).

barcodes[]

Identification: type (Gtin/Hibc/Pzn), code, validity.

orderUnit

Order unit, e.g. “PAK”.

contentQuantity / baseUnit

Content quantity and base unit, e.g. 50 “ST”.

netPrice / currency

Net price and currency (e.g. 5.00 EUR).

vatRate

VAT rate, e.g. 19.

minOrderQuantity / lotSize

Minimum order quantity and lot size in order units.

listPrice / discountRate

List/gross price and discount rate (optional).

validUntil

Price valid until (date).

Self-test

Validate response

Paste the JSON response of your /api/Price endpoint – its structure is validated instantly in the browser against this schema.

No validation yet – paste JSON and click “Validate”.

Want to use this use case in your system?

Become part of the API Initiative – we’ll support you through onboarding.

Join the initiative Back to use cases