Online-Druck.biz (ODB) – Druckprodukte / Print products
Druckprodukte suchen, konfigurieren, bepreisen / Search, configure, price print products
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"druckprodukte": {
"url": "https://mcp.online-druck.biz"
}
}
}Remote endpoints
https://mcp.online-druck.bizstreamable-httpWhat it can do
Tool inventory
Tools (8)
🟢search_catalog(query, category_id, min_price_cents, max_price_cents, language, ...)
Sucht Druckprodukte im Katalog von Online-Druck.biz (online-druck.biz, Online-Druck, ODB): Bücher, Broschüren, Flyer, Faltblätter und mehr. Der Katalog ist deutsch: Anfragen auf Deutsch liefern die besten Treffer; `language` "en" (wenn angeboten) stellt die Stoppwörter auf Englisch um. Typische Anfragen: „Buch drucken“, „Flyer bestellen“, „Hardcover Buch A4 244 Seiten“. Liefert je Aufruf 5 Treffer mit SKU, Titel, Beschreibung, Produktlink, Bild und Ab-Preis (netto, inkl. Versand); weitere Treffer über den cursor. Die SKU eines Treffers ist die Eingabe von get_product. Searches the catalog of Online-Druck.biz (online-druck.biz, Online-Druck, ODB), a German online print shop: books, brochures, flyers, folded leaflets and more. The catalog is German: German queries give the best hits; `language` "en" (if offered) switches the stop words to English. Typical queries: "print a book", "order flyers". Returns 5 hits per call with SKU, title, description, product link, image and from-price (net, including shipping); more hits via cursor. The SKU of a hit is the input of get_product.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Suchanfrage auf Deutsch, z. B. \"Hardcover Buch A4 244 Seiten\" / Search query in German",
"maxLength": 300,
"type": "string"
},
"category_id": {
"description": "Optional: nur Produkte dieser Kategorie (Magento-Kategorie-ID) / Optional category ID filter",
"type": "integer"
},
"min_price_cents": {
"description": "Optional: Ab-Preis mindestens, in Cent netto / Optional minimum from-price in cents",
"type": "integer"
},
"max_price_cents": {
"description": "Optional: Ab-Preis höchstens, in Cent netto / Optional maximum from-price in cents",
"type": "integer"
},
"language": {
"description": "Optional: Sprache der Anfrage, Standard \"de\" (wählt die Stoppwortlisten). Der Katalog ist deutsch; deutsche Anfragen geben die besten Treffer / Optional language of the query, default \"de\" (selects the stop word lists). The catalog is German; German queries give the best hits",
"enum": [
"de",
"en"
],
"type": "string"
},
"cursor": {
"description": "Optional: next_cursor der vorherigen Antwort für weitere Treffer / next_cursor of the previous answer",
"type": "string"
}
},
"required": [
"query"
]
}Output Schema
{
"type": "object",
"properties": {
"products": {
"description": "Treffer, bester zuerst / hits, best first",
"items": {
"properties": {
"id": {
"description": "SKU (Text) / SKU as string",
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"images": {
"items": {
"properties": {
"url": {
"type": "string"
}
},
"type": "object",
"required": [
"url"
]
},
"type": "array"
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"highlights": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"anyOf": [
{
"properties": {
"amount": {
"description": "Cent, netto / cents, net",
"type": "integer"
},
"is_from_price": {
"type": "boolean"
},
"vat_rate_percent": {
"type": "number"
},
"currency": {
"type": "string"
},
"tax_included": {
"type": "boolean"
},
"shipping_included": {
"type": "boolean"
}
},
"type": "object",
"required": [
"amount",
"is_from_price",
"vat_rate_percent"
]
},
{
"type": "null"
}
]
},
"seller": {
"type": "string"
},
"similarity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"recognized_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"id",
"title",
"url",
"seller"
]
},
"type": "array"
},
"next_cursor": {
"description": "Für weitere Treffer als cursor senden / send as cursor for more hits",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price_note": {
"type": "string"
},
"degraded": {
"description": "true: nur Stichwortsuche, weil der Embedding-Dienst nicht erreichbar ist / true: keyword search only, the embedding service is not available",
"type": "boolean"
},
"notice": {
"description": "Hinweis zur eingeschränkten Suche / notice about the reduced search",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"did_you_mean": {
"description": "Nur bei schwachen Treffern: die Anfrage mit korrigierten Wörtern / only for weak hits: the query with corrected words",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"suggested_categories": {
"description": "Nur bei schwachen Treffern: Warengruppen der besten Treffer, id als category_id für search_catalog / only for weak hits: categories of the best hits, id is the category_id of search_catalog",
"items": {
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"product_count": {
"type": "integer"
}
},
"type": "object",
"required": [
"id",
"name",
"product_count"
]
},
"type": "array"
}
},
"required": [
"products",
"price_note",
"degraded",
"suggested_categories"
]
}🟢lookup_catalog(skus, shop_product_ids, urls)
Löst bekannte Kennungen bei Online-Druck.biz (online-druck.biz, Online-Druck, ODB) zu Produkten auf: SKUs (Text, auch Klartext-SKUs), Shop-Produkt-IDs (liefert alle zugehörigen Produktseiten, günstigste zuerst) oder Produkt-URLs von www.online-druck.biz (auch mit Konfigurations-Parametern, die dann in Klartext zurückkommen). Unbekannte oder nicht mehr angebotene Eingaben stehen in not_found. Gedacht für bekannte Kennungen (Link, Artikelnummer); eine Suche per Beschreibung leistet search_catalog. Resolves known identifiers of Online-Druck.biz (online-druck.biz, Online-Druck, ODB) to products: SKUs (strings, plain-text SKUs are valid), shop product IDs (returns all product pages, cheapest first) or product URLs of www.online-druck.biz (also with configuration parameters, returned in plain text). Unknown or no longer offered inputs are listed in not_found. Meant for known identifiers (link, article number); searching by description is done by search_catalog.
Input Schema
{
"type": "object",
"properties": {
"skus": {
"description": "SKUs als Text, z. B. [\"1061\", \"Faltblatt Altarfalz gestalten\"] / SKUs as strings",
"maxItems": 20,
"items": {
"type": "string"
},
"type": "array"
},
"shop_product_ids": {
"description": "Shop-Produkt-IDs, z. B. [864] / shop product IDs",
"maxItems": 20,
"items": {
"type": "integer"
},
"type": "array"
},
"urls": {
"description": "Produkt-URLs von www.online-druck.biz, auch mit Konfigurations-Parametern / product URLs",
"maxItems": 20,
"items": {
"type": "string"
},
"type": "array"
}
}
}Output Schema
{
"type": "object",
"properties": {
"products": {
"items": {
"properties": {
"product": {
"properties": {
"id": {
"description": "SKU (Text) / SKU as string",
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"images": {
"items": {
"properties": {
"url": {
"type": "string"
}
},
"type": "object",
"required": [
"url"
]
},
"type": "array"
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"highlights": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"anyOf": [
{
"properties": {
"amount": {
"description": "Cent, netto / cents, net",
"type": "integer"
},
"is_from_price": {
"type": "boolean"
},
"vat_rate_percent": {
"type": "number"
},
"currency": {
"type": "string"
},
"tax_included": {
"type": "boolean"
},
"shipping_included": {
"type": "boolean"
}
},
"type": "object",
"required": [
"amount",
"is_from_price",
"vat_rate_percent"
]
},
{
"type": "null"
}
]
},
"seller": {
"type": "string"
},
"similarity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"recognized_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"id",
"title",
"url",
"seller"
]
},
"matched_by": {
"description": "sku, shop_product_id oder url / sku, shop_product_id or url",
"type": "string"
},
"url_configuration": {
"description": "Aus einer Produkt-URL gelesene Parameter / parameters read from a product URL",
"items": {
"type": "object"
},
"type": "array"
}
},
"type": "object",
"required": [
"product",
"matched_by"
]
},
"type": "array"
},
"not_found": {
"description": "Nicht gefundene Eingaben / inputs that were not found",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"products",
"not_found"
]
}🟢list_categories(query, limit)
Listet die Warengruppen (Kategorien) von Online-Druck.biz (online-druck.biz, Online-Druck, ODB) mit der Zahl der Produkte, die meisten zuerst, z. B. „Bücher“, „Hefte“, „Klappkarten“, „Kalender“. Mit query lässt sich nach einem Teil des Namens filtern. Die id einer Warengruppe ist die category_id für search_catalog: So lässt sich eine Suche auf eine Warengruppe begrenzen oder ein Überblick über das Angebot geben. Lists the categories of Online-Druck.biz (online-druck.biz, Online-Druck, ODB) with the number of products, best filled first, e.g. books, booklets, folded cards, calendars. query filters by part of the name. The id of a category is the category_id of search_catalog: use it to narrow a search to one category or to give an overview of the range.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Optional: Teil des Namens, z. B. \"Buch\" / Optional part of the name",
"maxLength": 100,
"type": "string"
},
"limit": {
"description": "Optional: höchstens so viele Warengruppen, Standard 50 / Optional maximum number, default 50",
"minimum": 1,
"maximum": 150,
"type": "integer"
}
}
}Output Schema
{
"type": "object",
"properties": {
"categories": {
"description": "Warengruppen, die meisten Produkte zuerst / categories, best filled first",
"items": {
"properties": {
"id": {
"description": "category_id für search_catalog / category_id for search_catalog",
"type": "integer"
},
"name": {
"type": "string"
},
"product_count": {
"description": "Produkte im Katalog / products in the catalog",
"type": "integer"
}
},
"type": "object",
"required": [
"id",
"name",
"product_count"
]
},
"type": "array"
},
"total": {
"description": "Passende Warengruppen vor dem Kürzen / matching categories before the cut",
"type": "integer"
}
},
"required": [
"categories",
"total"
]
}🟢get_product(sku, id, options, quantity, production_time, ...)
Öffnet ein Druckprodukt von Online-Druck.biz (online-druck.biz, Online-Druck, ODB) anhand der SKU aus search_catalog und zeigt alle Optionsgruppen mit Klartext und Erklärung (Format, Papier, Seitenanzahl, Bindung, Veredelung …) mit den zulässigen Werten, die Standardkonfiguration, Produktionszeiten, Datencheck-Varianten mit Aufpreis, Auflagengrenzen, Freiformat und Bild. Bei sehr vielen Werten (z. B. Seitenzahlen) stehen nur Anzahl, kleinster und größter Wert. Preise sind netto inkl. Versand. Die SKU ist immer ein Text (auch Klartext-SKUs sind gültig). Optional setzen options (Optionsname oder -ID -> Wert in Klartext, Wert-ID oder Zahl, z. B. {"Seitenanzahl": 200}), quantity, production_time, print_file_check_method, width und height die Startauswahl der Konfigurator-App; ohne diese Angaben startet die App mit der Standardkonfiguration. Die App prüft die Startauswahl gegen den Konfigurator. Opens a print product of Online-Druck.biz (online-druck.biz, Online-Druck, ODB) by the SKU from search_catalog and shows all option groups in plain text with explanation (format, paper, page count, binding, finishing …) with the allowed values, the default configuration, production times, data check variants with surcharge, quantity limits, free format and image. Groups with very many values (e.g. page counts) list only count, smallest and largest value. Prices are net, including shipping. The SKU is always a string (plain-text SKUs are valid). Optionally options (option name or ID -> value as plain text, value ID or number, e.g. {"Seitenanzahl": 200}), quantity, production_time, print_file_check_method, width and height set the start selection of the configurator app; without them the app starts with the default configuration. The app checks the start selection against the configurator.
Input Schema
{
"type": "object",
"properties": {
"sku": {
"description": "SKU des Produkts aus search_catalog (Text, z. B. \"1061\" oder \"Faltblatt Altarfalz gestalten\"); alternativ id / SKU as text; alternatively id",
"maxLength": 200,
"type": "string"
},
"id": {
"description": "Alias für sku: die id des Produkts aus search_catalog / Alias of sku: the product id from search_catalog",
"maxLength": 200,
"type": "string"
},
"options": {
"description": "Startauswahl der App: Optionsname oder -ID -> Wert in Klartext, Wert-ID oder Zahl (z. B. Seitenanzahl) / start selection of the app: option name or ID -> value as plain text, value ID or number",
"type": "object"
},
"quantity": {
"description": "Startauswahl der App: Auflage (Stück) / start selection: quantity",
"type": "integer"
},
"production_time": {
"description": "Startauswahl der App: Produktionszeit / start selection: production time",
"type": "string"
},
"print_file_check_method": {
"description": "Startauswahl der App: Datencheck, Name oder ID / start selection: data check name or ID",
"type": "string"
},
"width": {
"description": "Startauswahl der App, nur bei Freiformat: Breite in mm / start selection, free format only: width in mm",
"type": "integer"
},
"height": {
"description": "Startauswahl der App, nur bei Freiformat: Höhe in mm / start selection, free format only: height in mm",
"type": "integer"
}
},
"anyOf": [
{
"required": [
"sku"
]
},
{
"required": [
"id"
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"product": {
"properties": {
"id": {
"description": "SKU (Text) / SKU as string",
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"images": {
"items": {
"properties": {
"url": {
"type": "string"
}
},
"type": "object",
"required": [
"url"
]
},
"type": "array"
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"highlights": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"anyOf": [
{
"properties": {
"amount": {
"description": "Cent, netto / cents, net",
"type": "integer"
},
"is_from_price": {
"type": "boolean"
},
"vat_rate_percent": {
"type": "number"
},
"currency": {
"type": "string"
},
"tax_included": {
"type": "boolean"
},
"shipping_included": {
"type": "boolean"
}
},
"type": "object",
"required": [
"amount",
"is_from_price",
"vat_rate_percent"
]
},
{
"type": "null"
}
]
},
"seller": {
"type": "string"
},
"similarity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"recognized_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"id",
"title",
"url",
"seller"
]
},
"print": {
"properties": {
"shop_product_id": {
"type": "integer"
},
"option_groups": {
"description": "Optionsgruppen mit zulässigen Werten / option groups with allowed values",
"items": {
"type": "object"
},
"type": "array"
},
"production_times": {
"items": {
"type": "object"
},
"type": "array"
},
"data_checks": {
"items": {
"type": "object"
},
"type": "array"
},
"quantity": {
"description": "Auflagengrenzen / quantity limits",
"type": "object"
},
"free_format": {
"description": "Nur bei Freiformat / only for free format",
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
},
"delivery_country": {
"type": "string"
},
"allowed_values_verified": {
"type": "boolean"
},
"dictionary_version": {
"type": "integer"
},
"initial_configuration": {
"description": "Startauswahl der App aus den Eingaben von get_product / start selection of the app from the input of get_product",
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"shop_product_id",
"option_groups",
"production_times",
"data_checks",
"quantity",
"delivery_country",
"allowed_values_verified",
"dictionary_version"
]
}
},
"required": [
"product",
"print"
]
}🟢configure_product(sku, id, options, text, quantity, ...)
Konfiguriert ein Druckprodukt von Online-Druck.biz (online-druck.biz, Online-Druck, ODB), prüft die Kombination gegen den Konfigurator und liefert Preis und einen vorkonfigurierten Produktlink. Übergib die SKU und nur die Änderungen gegenüber der Standardkonfiguration: options (Optionsname -> Wert in Klartext oder Zahl, z. B. {"Format": "DIN A4 hoch", "Seitenanzahl": "244"}) und/oder text (Freitext, z. B. "Hardcover A4 244 Seiten beidseitig farbig, 100 Stück"). Unzulässige Kombinationen kommen mit zulässigen Alternativen zurück, unsichere Zuordnungen mit Kandidaten (status needs_clarification). Preis: netto in Cent, zzgl. MwSt., inkl. Versand, nur Produktionszeit Standard; weitere Produktionszeiten nur auf ausdrückliche Anfrage über extra_production_times. Der Link nennt die vollständige Konfiguration; der Server erzeugt ihn, er wird nie aus Eingaben übernommen. Ist der Preis nicht rechtzeitig da, kommen Link und Ab-Preis; ein erneuter Aufruf liefert den Preis dann meist sofort. Lieferung nur nach Deutschland. Configures a print product of Online-Druck.biz (online-druck.biz, Online-Druck, ODB), checks the combination against the configurator and returns price and a pre-configured product link. Pass the SKU and only the changes against the default configuration: options (option name -> value as plain text or number) and/or text (free text). Invalid combinations come back with allowed alternatives, uncertain assignments with candidates (status needs_clarification). Price: net in cents, excluding VAT, including shipping, production time Standard only; further production times only on explicit request via extra_production_times. The link carries the complete configuration; the server generates it and never takes it from input. If the price is not ready in time you get the link and the from-price; calling again usually returns the price at once. Delivery to Germany only.
Input Schema
{
"type": "object",
"properties": {
"sku": {
"description": "SKU des Produkts aus search_catalog (Text, z. B. \"1061\" oder \"Faltblatt Altarfalz gestalten\"); alternativ id / SKU as text; alternatively id",
"maxLength": 200,
"type": "string"
},
"id": {
"description": "Alias für sku: die id des Produkts aus search_catalog / Alias of sku: the product id from search_catalog",
"maxLength": 200,
"type": "string"
},
"options": {
"description": "Änderungen: Optionsname oder -ID -> Wert in Klartext, Wert-ID oder Zahl. Namen und zulässige Werte stehen in get_product / Changes: option name or ID -> value",
"type": "object"
},
"text": {
"description": "Optional: Freitext mit Wünschen, z. B. \"A4 hoch, 244 Seiten, 100 Stück\" / free text",
"maxLength": 500,
"type": "string"
},
"quantity": {
"description": "Auflage (Stück); Standard laut Produkt / quantity",
"type": "integer"
},
"production_time": {
"description": "Produktionszeit, Standard \"Standard\" / production time",
"type": "string"
},
"print_file_check_method": {
"description": "Datencheck: Name oder ID aus get_product / data check name or ID",
"type": "string"
},
"width": {
"description": "Nur bei Freiformat: Breite in mm / free format width in mm",
"type": "integer"
},
"height": {
"description": "Nur bei Freiformat: Höhe in mm / free format height in mm",
"type": "integer"
},
"extra_production_times": {
"description": "Nur auf ausdrückliche Anfrage: weitere Produktionszeiten mitbepreisen / further production times to price",
"maxItems": 3,
"items": {
"type": "string"
},
"type": "array"
},
"dictionary_version": {
"description": "dictionary_version aus get_product; weicht sie ab, wird die Konfiguration neu geprüft und das gemeldet / version seen in get_product",
"type": "integer"
}
},
"anyOf": [
{
"required": [
"sku"
]
},
{
"required": [
"id"
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"status": {
"description": "Ergebnis der Prüfung / result of the check",
"type": "string"
},
"product": {
"properties": {
"id": {
"description": "SKU (Text) / SKU as string",
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"images": {
"items": {
"properties": {
"url": {
"type": "string"
}
},
"type": "object",
"required": [
"url"
]
},
"type": "array"
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"highlights": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"anyOf": [
{
"properties": {
"amount": {
"description": "Cent, netto / cents, net",
"type": "integer"
},
"is_from_price": {
"type": "boolean"
},
"vat_rate_percent": {
"type": "number"
},
"currency": {
"type": "string"
},
"tax_included": {
"type": "boolean"
},
"shipping_included": {
"type": "boolean"
}
},
"type": "object",
"required": [
"amount",
"is_from_price",
"vat_rate_percent"
]
},
{
"type": "null"
}
]
},
"seller": {
"type": "string"
},
"similarity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"recognized_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"id",
"title",
"url",
"seller"
]
},
"configuration": {
"description": "Vollständige Konfiguration / complete configuration",
"items": {
"properties": {
"property_id": {
"type": "integer"
},
"property_name": {
"type": "string"
},
"value_id": {
"type": "integer"
},
"value_name": {
"type": "string"
},
"changed": {
"type": "boolean"
}
},
"type": "object",
"required": [
"property_id",
"property_name",
"value_id",
"value_name",
"changed"
]
},
"type": "array"
},
"issues": {
"items": {
"type": "string"
},
"type": "array"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"conflicts": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"unknown_options": {
"items": {
"type": "string"
},
"type": "array"
},
"dictionary_version": {
"type": "integer"
},
"dictionary_changed": {
"type": "boolean"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
},
"price": {
"description": "Preis oder Ab-Preis, netto inkl. Versand / price or from-price, net including shipping",
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
},
"price_note": {
"type": "string"
},
"link": {
"description": "Vorkonfigurierter Produktlink / preconfigured product link",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"product",
"configuration",
"issues",
"notes",
"conflicts",
"uncertain_parameters",
"unknown_options",
"dictionary_version",
"dictionary_changed"
]
}🟢price_scale(sku, id, quantities, options, text, ...)
Stellt die Nettopreise einer Konfiguration bei Online-Druck.biz (online-druck.biz, Online-Druck, ODB) für mehrere Auflagen nebeneinander, z. B. 100, 250, 500 Stück. Die Konfiguration wird einmal geprüft (wie bei configure_product: options oder text mit den Änderungen, sonst Standardkonfiguration); je Auflage kommen Nettopreis, Bruttopreis, Preis je Stück, Lieferzeit und der fertige Produktlink mit genau dieser Auflage. Höchstens 5 Auflagen je Aufruf. Preise sind netto zzgl. MwSt., inkl. Versand. Auflagen außerhalb der Grenzen des Produkts werden genannt, nicht bepreist. Fehlt quantities, kommt kein Preis: die Antwort hat den Status quantities_missing und nennt die Standardauflage und die Grenzen des Produkts (quantity.default, min, max). Ist die Konfiguration ungültig oder unklar, kommt kein Preis, sondern der Status invalid mit den Gründen. Shows the net prices of one configuration of Online-Druck.biz (online-druck.biz, Online-Druck, ODB) for several quantities side by side, e.g. 100, 250, 500 pieces. The configuration is checked once (as in configure_product: options or text with the changes, otherwise the default configuration); per quantity you get net price, gross price, unit price, delivery time and the finished product link with exactly this quantity. At most 5 quantities per call. Prices are net, excluding VAT, including shipping. Quantities outside the limits of the product are named, not priced. If quantities is missing there is no price: the answer has the status quantities_missing and names the standard quantity and the limits of the product (quantity.default, min, max). If the configuration is invalid or unclear there is no price, but the status invalid with the reasons.
Input Schema
{
"type": "object",
"properties": {
"sku": {
"description": "SKU des Produkts aus search_catalog (Text, z. B. \"1061\" oder \"Faltblatt Altarfalz gestalten\"); alternativ id / SKU as text; alternatively id",
"maxLength": 200,
"type": "string"
},
"id": {
"description": "Alias für sku: die id des Produkts aus search_catalog / Alias of sku: the product id from search_catalog",
"maxLength": 200,
"type": "string"
},
"quantities": {
"description": "Auflagen (Stück), 1 bis 5, z. B. [100, 250, 500]. Fehlt sie, kommt kein Preis, sondern die Standardauflage und die Grenzen des Produkts / quantities; if missing there is no price, the answer names the standard quantity and the limits of the product",
"minItems": 1,
"maxItems": 5,
"items": {
"minimum": 1,
"type": "integer"
},
"type": "array"
},
"options": {
"description": "Änderungen: Optionsname oder -ID -> Wert in Klartext, Wert-ID oder Zahl. Namen und zulässige Werte stehen in get_product / Changes: option name or ID -> value",
"type": "object"
},
"text": {
"description": "Optional: Freitext mit Wünschen, z. B. \"A4 hoch, 244 Seiten\" (ohne Auflage) / free text",
"maxLength": 500,
"type": "string"
},
"production_time": {
"description": "Produktionszeit, Standard \"Standard\" / production time",
"type": "string"
},
"width": {
"description": "Nur bei Freiformat: Breite in mm / free format width in mm",
"type": "integer"
},
"height": {
"description": "Nur bei Freiformat: Höhe in mm / free format height in mm",
"type": "integer"
}
},
"anyOf": [
{
"required": [
"sku"
]
},
{
"required": [
"id"
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"status": {
"description": "ok, invalid (Konfiguration ungültig oder unklar), unavailable (kein Preis) oder quantities_missing (keine Auflagen angegeben, siehe quantity) / ok, invalid, unavailable or quantities_missing (no quantities given, see quantity)",
"type": "string"
},
"product": {
"properties": {
"id": {
"description": "SKU (Text) / SKU as string",
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"images": {
"items": {
"properties": {
"url": {
"type": "string"
}
},
"type": "object",
"required": [
"url"
]
},
"type": "array"
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"highlights": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"anyOf": [
{
"properties": {
"amount": {
"description": "Cent, netto / cents, net",
"type": "integer"
},
"is_from_price": {
"type": "boolean"
},
"vat_rate_percent": {
"type": "number"
},
"currency": {
"type": "string"
},
"tax_included": {
"type": "boolean"
},
"shipping_included": {
"type": "boolean"
}
},
"type": "object",
"required": [
"amount",
"is_from_price",
"vat_rate_percent"
]
},
{
"type": "null"
}
]
},
"seller": {
"type": "string"
},
"similarity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"recognized_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"id",
"title",
"url",
"seller"
]
},
"production_time": {
"type": "string"
},
"currency": {
"type": "string"
},
"tax_included": {
"type": "boolean"
},
"shipping_included": {
"type": "boolean"
},
"quantity": {
"description": "Nur bei quantities_missing: Standardauflage und Grenzen des Produkts / only for quantities_missing: standard quantity and limits of the product",
"anyOf": [
{
"properties": {
"min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"default": {
"type": "integer"
}
},
"type": "object",
"required": [
"default"
]
},
{
"type": "null"
}
]
},
"scale": {
"description": "Eine Zeile je bepreister Auflage, aufsteigend / one row per priced quantity, ascending",
"items": {
"properties": {
"quantity": {
"type": "integer"
},
"net_cents": {
"type": "integer"
},
"gross_cents": {
"type": "integer"
},
"unit_net_cents": {
"type": "integer"
},
"days_from": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"days_to": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"link": {
"description": "Produktlink mit genau dieser Auflage / product link with exactly this quantity",
"type": "string"
},
"source": {
"description": "price, tier oder extra / price, tier or extra",
"type": "string"
}
},
"type": "object",
"required": [
"quantity",
"net_cents",
"gross_cents",
"unit_net_cents",
"link",
"source"
]
},
"type": "array"
},
"issues": {
"items": {
"type": "string"
},
"type": "array"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"status",
"product",
"production_time",
"currency",
"tax_included",
"shipping_included",
"scale",
"issues",
"notes"
]
}🟢get_print_specifications(sku, id, options, text, quantity, ...)
Liefert die Maßvorgaben für die Druckdaten einer Konfiguration eines Druckprodukts von Online-Druck.biz (online-druck.biz, Online-Druck, ODB): je Teilprodukt (z. B. Umschlag, Inhalt) Seitenzahl, Endformat und Datenformat mit Beschnitt und Zugaben in mm, Beschnitt in mm und einen Download-Link der Maßvorgabe, dazu die Rückenbreite in mm. Die Eingaben sind wie bei configure_product: SKU und nur die Änderungen gegenüber der Standardkonfiguration als options und/oder text, dazu quantity. Die Konfiguration wird gegen den Konfigurator geprüft; ist sie ungültig oder unklar, kommen keine Maßvorgaben, sondern der Status invalid oder needs_clarification mit Alternativen bzw. Kandidaten. Status configurator_unavailable: der Konfigurator hat nicht rechtzeitig geantwortet. Status no_specifications: das Produkt hat keine Maßvorgaben. Kein Preis und kein Produktlink. Returns the print file specifications of one configuration of a print product of Online-Druck.biz (online-druck.biz, Online-Druck, ODB): per part (e.g. cover, content) page count, trimmed size and document size with bleed and extras in mm, bleed in mm and a download link of the specification file, plus the spine width in mm. Input as in configure_product: SKU and only the changes against the default configuration as options and/or text, plus quantity. The configuration is checked against the configurator; if it is invalid or unclear there are no specifications but the status invalid or needs_clarification with alternatives or candidates. Status configurator_unavailable: the configurator did not answer in time. Status no_specifications: the product has no specifications. No price and no product link.
Input Schema
{
"type": "object",
"properties": {
"sku": {
"description": "SKU des Produkts aus search_catalog (Text, z. B. \"1061\" oder \"Faltblatt Altarfalz gestalten\"); alternativ id / SKU as text; alternatively id",
"maxLength": 200,
"type": "string"
},
"id": {
"description": "Alias für sku: die id des Produkts aus search_catalog / Alias of sku: the product id from search_catalog",
"maxLength": 200,
"type": "string"
},
"options": {
"description": "Änderungen: Optionsname oder -ID -> Wert in Klartext, Wert-ID oder Zahl. Namen und zulässige Werte stehen in get_product / Changes: option name or ID -> value",
"type": "object"
},
"text": {
"description": "Optional: Freitext mit Wünschen, z. B. \"A4 hoch, 48 Seiten\" / free text",
"maxLength": 500,
"type": "string"
},
"quantity": {
"description": "Auflage (Stück); Standard laut Produkt / quantity",
"type": "integer"
},
"production_time": {
"description": "Produktionszeit, Standard \"Standard\" / production time",
"type": "string"
},
"print_file_check_method": {
"description": "Datencheck: Name oder ID aus get_product / data check name or ID",
"type": "string"
},
"width": {
"description": "Nur bei Freiformat: Breite in mm / free format width in mm",
"type": "integer"
},
"height": {
"description": "Nur bei Freiformat: Höhe in mm / free format height in mm",
"type": "integer"
}
},
"anyOf": [
{
"required": [
"sku"
]
},
{
"required": [
"id"
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"status": {
"description": "ok, no_specifications (Produkt ohne Maßvorgaben), configurator_unavailable (Konfigurator hat nicht rechtzeitig geantwortet), invalid, needs_clarification oder unavailable / ok, no_specifications, configurator_unavailable, invalid, needs_clarification or unavailable",
"type": "string"
},
"product": {
"properties": {
"id": {
"description": "SKU (Text) / SKU as string",
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"images": {
"items": {
"properties": {
"url": {
"type": "string"
}
},
"type": "object",
"required": [
"url"
]
},
"type": "array"
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"highlights": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"anyOf": [
{
"properties": {
"amount": {
"description": "Cent, netto / cents, net",
"type": "integer"
},
"is_from_price": {
"type": "boolean"
},
"vat_rate_percent": {
"type": "number"
},
"currency": {
"type": "string"
},
"tax_included": {
"type": "boolean"
},
"shipping_included": {
"type": "boolean"
}
},
"type": "object",
"required": [
"amount",
"is_from_price",
"vat_rate_percent"
]
},
{
"type": "null"
}
]
},
"seller": {
"type": "string"
},
"similarity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"recognized_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"id",
"title",
"url",
"seller"
]
},
"configuration": {
"description": "Vollständige Konfiguration / complete configuration",
"items": {
"properties": {
"property_id": {
"type": "integer"
},
"property_name": {
"type": "string"
},
"value_id": {
"type": "integer"
},
"value_name": {
"type": "string"
},
"changed": {
"type": "boolean"
}
},
"type": "object",
"required": [
"property_id",
"property_name",
"value_id",
"value_name",
"changed"
]
},
"type": "array"
},
"quantity": {
"type": "integer"
},
"issues": {
"items": {
"type": "string"
},
"type": "array"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"conflicts": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"unknown_options": {
"items": {
"type": "string"
},
"type": "array"
},
"dictionary_version": {
"type": "integer"
},
"spine_width_mm": {
"description": "Rückenbreite in mm / spine width in mm",
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"specifications": {
"description": "Maßvorgaben je Teilprodukt / specifications per part",
"items": {
"properties": {
"part": {
"description": "Teilprodukt, z. B. cover, content / part, e.g. cover, content",
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"description": "Download der Maßvorgabe / download of the specification file",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pages": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"width_mm": {
"description": "Endformat / trimmed size",
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"height_mm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"width_with_extras_mm": {
"description": "Datenformat mit Beschnitt und Zugaben / document size with bleed and extras",
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"height_with_extras_mm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"bleed_mm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"part",
"name"
]
},
"type": "array"
}
},
"required": [
"status",
"product",
"configuration",
"quantity",
"issues",
"notes",
"conflicts",
"uncertain_parameters",
"unknown_options",
"dictionary_version",
"specifications"
]
}🟢configure_product_app(sku, id, options, quantity, production_time, ...)
Aufruf der Konfigurator-App (sichtbar nur für die App): prüft die Auswahl der App gegen den Konfigurator, liefert Preis (netto, inkl. Versand), die weiterhin erlaubten Werte je Option und den Produktlink. Das Gegenstück im Modellkontext ist configure_product. Called by the configurator app (visible to the app only): checks the selection of the app against the configurator and returns price (net, including shipping), the values still allowed per option and the product link. The counterpart in the model context is configure_product.
Input Schema
{
"type": "object",
"properties": {
"sku": {
"description": "SKU des Produkts aus search_catalog (Text, z. B. \"1061\" oder \"Faltblatt Altarfalz gestalten\"); alternativ id / SKU as text; alternatively id",
"maxLength": 200,
"type": "string"
},
"id": {
"description": "Alias für sku: die id des Produkts aus search_catalog / Alias of sku: the product id from search_catalog",
"maxLength": 200,
"type": "string"
},
"options": {
"description": "Property ID or name -> value ID or number",
"type": "object"
},
"quantity": {
"type": "integer"
},
"production_time": {
"type": "string"
},
"print_file_check_method": {
"type": "integer"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"dictionary_version": {
"type": "integer"
}
},
"anyOf": [
{
"required": [
"sku"
]
},
{
"required": [
"id"
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"status": {
"description": "Ergebnis der Prüfung / result of the check",
"type": "string"
},
"product": {
"properties": {
"id": {
"description": "SKU (Text) / SKU as string",
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"images": {
"items": {
"properties": {
"url": {
"type": "string"
}
},
"type": "object",
"required": [
"url"
]
},
"type": "array"
},
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"highlights": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"anyOf": [
{
"properties": {
"amount": {
"description": "Cent, netto / cents, net",
"type": "integer"
},
"is_from_price": {
"type": "boolean"
},
"vat_rate_percent": {
"type": "number"
},
"currency": {
"type": "string"
},
"tax_included": {
"type": "boolean"
},
"shipping_included": {
"type": "boolean"
}
},
"type": "object",
"required": [
"amount",
"is_from_price",
"vat_rate_percent"
]
},
{
"type": "null"
}
]
},
"seller": {
"type": "string"
},
"similarity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"recognized_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"id",
"title",
"url",
"seller"
]
},
"configuration": {
"description": "Vollständige Konfiguration / complete configuration",
"items": {
"properties": {
"property_id": {
"type": "integer"
},
"property_name": {
"type": "string"
},
"value_id": {
"type": "integer"
},
"value_name": {
"type": "string"
},
"changed": {
"type": "boolean"
}
},
"type": "object",
"required": [
"property_id",
"property_name",
"value_id",
"value_name",
"changed"
]
},
"type": "array"
},
"issues": {
"items": {
"type": "string"
},
"type": "array"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"conflicts": {
"items": {
"type": "object"
},
"type": "array"
},
"uncertain_parameters": {
"items": {
"type": "object"
},
"type": "array"
},
"unknown_options": {
"items": {
"type": "string"
},
"type": "array"
},
"dictionary_version": {
"type": "integer"
},
"dictionary_changed": {
"type": "boolean"
},
"variant": {
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
},
"price": {
"description": "Preis oder Ab-Preis, netto inkl. Versand / price or from-price, net including shipping",
"anyOf": [
{
"type": "object"
},
{
"type": "null"
}
]
},
"price_note": {
"type": "string"
},
"link": {
"description": "Vorkonfigurierter Produktlink / preconfigured product link",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"product",
"configuration",
"issues",
"notes",
"conflicts",
"uncertain_parameters",
"unknown_options",
"dictionary_version",
"dictionary_changed"
]
}Community
Evidence