NEVINI Wines
Search the wines of NEVINI, a Dutch wine importer, and build Shopify carts with a checkout link.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~7,421Tokens (Tool-Definitionen)
~9.4 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (5.80% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"shop": {
"url": "https://nevini.wine/api/mcp/"
}
}
}Remote-Endpunkte
https://nevini.wine/api/mcp/streamable-httpWas es kann
Tool-Inventar
Tools (8)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢search_wines(query, type, country, region, grape, ...)
Searches the NEVINI wine catalog by free text and filters (type, country, region, grape, verified price range, availability). query matches name, winery, grape, region, country, type and vintage; use type, country, region, grape, min_price_eur, max_price_eur and sort for style and budget, and food for dishes. Returns compact wine summaries with live Shopify price and availability, the first four taste notes and food_pairing (a sentence quoted from the wine description, or null). default_variant_id is the standard bottle of the wine (0.75 L for most wines) and is null unless that bottle is purchasable; default_size is its size, e.g. "0.75L" or "1.5L" for a magnum. type "sparkling" includes Champagne. Use get_wine for other bottle sizes, all taste notes and the full description, get_catalog_overview for what the range covers and get_store_info for delivery, pickup or contact.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"description": "Free text in Dutch or English, matched against wine name, winery, grape, region, country, type and vintage, e.g. \"amarone\" or \"red wine tuscany\". Taste, food and budget words are not matched; use the filters, food and sort for those.",
"type": "string",
"maxLength": 200
},
"type": {
"description": "Wine type. \"sparkling\" includes Champagne.",
"type": "string",
"enum": [
"red",
"white",
"rose",
"sparkling",
"champagne",
"dessert"
]
},
"country": {
"description": "Country name in Dutch or English, or ISO code, e.g. \"IT\".",
"type": "string",
"maxLength": 60
},
"region": {
"description": "Region, e.g. \"Toscane\", \"Tuscany\" or \"Bordeaux\".",
"type": "string",
"maxLength": 100
},
"grape": {
"description": "Grape variety, e.g. \"Nebbiolo\".",
"type": "string",
"maxLength": 60
},
"food": {
"description": "Dish or food in Dutch or English, e.g. \"seafood\", \"oysters\", \"lamb\", \"cheese\", \"pasta\" or \"aperitif\". Matches whole words and word prefixes in food_pairing, the pairing sentence quoted from each wine description, with a few synonyms (fish/vis, seafood/zeevruchten, meat/vlees, cheese/kaas). Wines whose description names no dish are left out.",
"type": "string",
"maxLength": 100
},
"min_price_eur": {
"description": "Lowest verified bottle price in EUR. Wines without a verified current price are left out when a price filter is set.",
"type": "number",
"minimum": 0,
"maximum": 100000
},
"max_price_eur": {
"description": "Highest verified bottle price in EUR. Wines without a verified current price are left out when a price filter is set.",
"type": "number",
"minimum": 0,
"maximum": 100000
},
"available_only": {
"description": "Only wines that can be ordered online now. Default false.",
"type": "boolean"
},
"sort": {
"description": "Sort order. Default \"relevance\"; without a query, editorial picks come first.",
"type": "string",
"enum": [
"relevance",
"price_asc",
"price_desc",
"rating"
]
},
"limit": {
"description": "Maximum number of results, 1-20. Default 8.",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"language": {
"description": "Response language: \"nl\" (Dutch, default) or \"en\" (English).",
"type": "string",
"enum": [
"nl",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": [
"string",
"null"
]
},
"filters": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"country": {
"type": "string"
},
"region": {
"type": "string"
},
"grape": {
"type": "string"
},
"food": {
"type": "string"
},
"min_price_eur": {
"type": "number"
},
"max_price_eur": {
"type": "number"
},
"available_only": {
"type": "boolean"
},
"sort": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"language": {
"type": "string"
}
},
"required": [
"sort",
"limit",
"language"
],
"additionalProperties": {}
},
"total_matches": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"winery": {
"type": "string"
},
"vintage": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
},
"country": {
"type": [
"string",
"null"
]
},
"region": {
"type": "string"
},
"grapes": {
"type": "array",
"items": {
"type": "string"
}
},
"taste": {
"type": "array",
"items": {
"type": "string"
}
},
"food_pairing": {
"type": [
"string",
"null"
]
},
"alcohol": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
},
"image_url": {
"type": [
"string",
"null"
]
},
"rating": {
"anyOf": [
{
"type": "object",
"properties": {
"score_out_of_5": {
"type": "number"
},
"source_count": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"score_out_of_5",
"source_count"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"badges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"additionalProperties": {}
}
},
"price_from_eur": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"backorder",
"out_of_stock",
"unknown"
]
},
"purchasable": {
"type": "boolean"
},
"default_variant_id": {
"type": [
"string",
"null"
]
},
"default_size": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name",
"winery",
"vintage",
"type",
"country",
"region",
"grapes",
"taste",
"food_pairing",
"alcohol",
"url",
"image_url",
"rating",
"badges",
"price_from_eur",
"availability",
"purchasable",
"default_variant_id",
"default_size"
],
"additionalProperties": {}
}
},
"commerce": {
"type": "object",
"properties": {
"verified": {
"type": "boolean"
},
"as_of": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"verified",
"as_of",
"source"
],
"additionalProperties": {}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"query",
"filters",
"total_matches",
"returned",
"results",
"commerce",
"notes"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_wine(wine, language)
Returns one wine by slug, numeric id, name or wine URL: description, grapes, taste notes, serving temperature, rating, every bottle size with its variant_id, live price and availability, and related wines. taste lists every taste note; food_pairing is the pairing sentence quoted from the description, or null when it names no dish. default_variant_id is the standard bottle of the wine (0.75 L for most wines) and is null unless that bottle is purchasable; default_size is its size. Sizes marked on_request cannot be ordered online. Use search_wines first when the user describes a wine rather than naming it.
Eingabe-Schema
{
"type": "object",
"properties": {
"wine": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Wine slug (e.g. \"guerriero-della-terra\"), numeric id, wine name or nevini.wine wine URL."
},
"language": {
"description": "Response language: \"nl\" (Dutch, default) or \"en\" (English).",
"type": "string",
"enum": [
"nl",
"en"
]
}
},
"required": [
"wine"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"wine": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"winery": {
"type": "string"
},
"vintage": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
},
"country": {
"type": [
"string",
"null"
]
},
"region": {
"type": "string"
},
"grapes": {
"type": "array",
"items": {
"type": "string"
}
},
"taste": {
"type": "array",
"items": {
"type": "string"
}
},
"food_pairing": {
"type": [
"string",
"null"
]
},
"alcohol": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
},
"image_url": {
"type": [
"string",
"null"
]
},
"rating": {
"anyOf": [
{
"type": "object",
"properties": {
"score_out_of_5": {
"type": "number"
},
"source_count": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"score_out_of_5",
"source_count"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"badges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"additionalProperties": {}
}
},
"price_from_eur": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"backorder",
"out_of_stock",
"unknown"
]
},
"purchasable": {
"type": "boolean"
},
"default_variant_id": {
"type": [
"string",
"null"
]
},
"default_size": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
},
"serving_temperature": {
"type": [
"string",
"null"
]
},
"variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"variant_id": {
"type": [
"string",
"null"
]
},
"size": {
"type": [
"string",
"null"
]
},
"label": {
"type": "string"
},
"price_eur": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"backorder",
"out_of_stock",
"unknown"
]
},
"purchasable": {
"type": "boolean"
},
"on_request": {
"type": "boolean"
},
"gift_box": {
"type": "boolean"
}
},
"required": [
"variant_id",
"size",
"label",
"price_eur",
"availability",
"purchasable",
"on_request",
"gift_box"
],
"additionalProperties": {}
}
},
"related": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"winery": {
"type": "string"
},
"vintage": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
},
"url": {
"type": "string"
},
"price_from_eur": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"backorder",
"out_of_stock",
"unknown"
]
},
"purchasable": {
"type": "boolean"
}
},
"required": [
"id",
"slug",
"name",
"winery",
"vintage",
"type",
"url",
"price_from_eur",
"availability",
"purchasable"
],
"additionalProperties": {}
}
},
"order_hint": {
"type": "string"
}
},
"required": [
"id",
"slug",
"name",
"winery",
"vintage",
"type",
"country",
"region",
"grapes",
"taste",
"food_pairing",
"alcohol",
"url",
"image_url",
"rating",
"badges",
"price_from_eur",
"availability",
"purchasable",
"default_variant_id",
"default_size",
"description",
"serving_temperature",
"variants",
"related",
"order_hint"
],
"additionalProperties": {}
},
"commerce": {
"type": "object",
"properties": {
"verified": {
"type": "boolean"
},
"as_of": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"verified",
"as_of",
"source"
],
"additionalProperties": {}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"wine",
"commerce"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_catalog_overview(language)
Returns an overview of the NEVINI range: wine counts per type, country and category page, the most common grapes, the top selection and the verified price range. Use it to see what the range covers; use search_wines to find wines and get_wine for one wine.
Eingabe-Schema
{
"type": "object",
"properties": {
"language": {
"description": "Response language: \"nl\" (Dutch, default) or \"en\" (English).",
"type": "string",
"enum": [
"nl",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"language": {
"type": "string"
},
"total_wines": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"purchasable_wines": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
{
"type": "null"
}
]
},
"types": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"key",
"label",
"count"
],
"additionalProperties": {}
}
},
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"code",
"name",
"count"
],
"additionalProperties": {}
}
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"count",
"url"
],
"additionalProperties": {}
}
},
"top_grapes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"grape": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"grape",
"count"
],
"additionalProperties": {}
}
},
"top_selection": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"winery": {
"type": "string"
},
"vintage": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
},
"url": {
"type": "string"
},
"price_from_eur": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"backorder",
"out_of_stock",
"unknown"
]
},
"purchasable": {
"type": "boolean"
}
},
"required": [
"id",
"slug",
"name",
"winery",
"vintage",
"type",
"url",
"price_from_eur",
"availability",
"purchasable"
],
"additionalProperties": {}
}
},
"price_range_eur": {
"anyOf": [
{
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"commerce": {
"type": "object",
"properties": {
"verified": {
"type": "boolean"
},
"as_of": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"verified",
"as_of",
"source"
],
"additionalProperties": {}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"language",
"total_wines",
"purchasable_wines",
"types",
"countries",
"categories",
"top_grapes",
"top_selection",
"price_range_eur",
"commerce",
"notes"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_store_info(language)
Returns NEVINI store facts: company and contact details, contact availability, pickup in Maastricht, shipping rates, countries and delivery times, returns, age policy, payment, hospitality services, policy URLs and how ordering through this server works. Use it for questions about delivery, pickup, returns, payment or contact; for wines use search_wines.
Eingabe-Schema
{
"type": "object",
"properties": {
"language": {
"description": "Response language: \"nl\" (Dutch, default) or \"en\" (English).",
"type": "string",
"enum": [
"nl",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"language": {
"type": "string"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"address": {
"type": "object",
"properties": {
"street": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"city": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"street",
"postal_code",
"city",
"country"
],
"additionalProperties": {}
},
"kvk": {
"type": "string"
},
"email": {
"type": "string"
},
"order_email": {
"type": "string"
},
"phone": {
"type": "string"
},
"whatsapp": {
"type": "string"
},
"website": {
"type": "string"
}
},
"required": [
"name",
"address",
"kvk",
"email",
"order_email",
"phone",
"whatsapp",
"website"
],
"additionalProperties": {}
},
"contact_availability": {
"type": "object",
"properties": {
"note": {
"type": "string"
},
"hours": {
"type": "array",
"items": {
"type": "object",
"properties": {
"days": {
"type": "string"
},
"hours": {
"type": "string"
}
},
"required": [
"days",
"hours"
],
"additionalProperties": {}
}
}
},
"required": [
"note",
"hours"
],
"additionalProperties": {}
},
"pickup": {
"type": "object",
"properties": {
"available": {
"type": "boolean"
},
"cost_eur": {
"type": "number"
},
"city": {
"type": "string"
},
"address": {
"type": "string"
},
"by_appointment": {
"type": "boolean"
},
"details": {
"type": "string"
}
},
"required": [
"available",
"cost_eur",
"city",
"address",
"by_appointment",
"details"
],
"additionalProperties": {}
},
"shipping": {
"type": "object",
"properties": {
"summary": {
"type": "string"
},
"ships_from": {
"type": "string"
},
"currency": {
"type": "string"
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"country_names_en": {
"type": "array",
"items": {
"type": "string"
}
},
"other_countries": {
"type": "string"
},
"zones": {
"type": "array",
"items": {
"type": "object",
"properties": {
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"rate_eur": {
"type": "number"
},
"delivery_business_days": {
"type": "object",
"properties": {
"min": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"max": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"min",
"max"
],
"additionalProperties": {}
},
"delivery_time": {
"type": "string"
},
"free_standard_shipping_from_eur": {
"type": "number"
},
"import_duties": {
"type": "string"
}
},
"required": [
"countries",
"rate_eur",
"delivery_business_days",
"delivery_time"
],
"additionalProperties": {}
}
},
"free_standard_shipping": {
"type": "object",
"properties": {
"threshold_eur": {
"type": "number"
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"basis": {
"type": "string"
}
},
"required": [
"threshold_eur",
"countries",
"basis"
],
"additionalProperties": {}
},
"delivery_note": {
"type": "string"
},
"policy_url": {
"type": "string"
}
},
"required": [
"summary",
"ships_from",
"currency",
"countries",
"country_names_en",
"other_countries",
"zones",
"free_standard_shipping",
"delivery_note",
"policy_url"
],
"additionalProperties": {}
},
"returns": {
"type": "object",
"properties": {
"window_days": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"conditions": {
"type": "string"
},
"return_shipping_paid_by": {
"type": "string"
},
"how_to_request": {
"type": "string"
},
"quality_complaints": {
"type": "string"
},
"policy_url": {
"type": "string"
}
},
"required": [
"window_days",
"conditions",
"return_shipping_paid_by",
"how_to_request",
"quality_complaints",
"policy_url"
],
"additionalProperties": {}
},
"age_policy": {
"type": "object",
"properties": {
"minimum_age": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"notice": {
"type": "string"
}
},
"required": [
"minimum_age",
"notice"
],
"additionalProperties": {}
},
"payment": {
"type": "object",
"properties": {
"methods": {
"type": "string"
},
"currency": {
"type": "string"
},
"prices_include_vat": {
"type": "boolean"
},
"prices_include_delivery": {
"type": "boolean"
}
},
"required": [
"methods",
"currency",
"prices_include_vat",
"prices_include_delivery"
],
"additionalProperties": {}
},
"horeca": {
"type": "object",
"properties": {
"services": {
"type": "array",
"items": {
"type": "string"
}
},
"url": {
"type": "string"
}
},
"required": [
"services",
"url"
],
"additionalProperties": {}
},
"assistant": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"name",
"url",
"description"
],
"additionalProperties": {}
},
"policies": {
"type": "object",
"properties": {
"shipping": {
"type": "string"
},
"returns": {
"type": "string"
},
"terms": {
"type": "string"
},
"privacy": {
"type": "string"
},
"contact": {
"type": "string"
},
"horeca": {
"type": "string"
}
},
"required": [
"shipping",
"returns",
"terms",
"privacy",
"contact",
"horeca"
],
"additionalProperties": {}
},
"ordering": {
"type": "object",
"properties": {
"order_placed_by_mcp": {
"type": "boolean"
},
"payment_taken_by_mcp": {
"type": "boolean"
},
"steps": {
"type": "array",
"items": {
"type": "string"
}
},
"checkout_host": {
"type": "string"
},
"limits": {
"type": "object",
"properties": {
"max_lines_per_cart": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"max_quantity_per_line": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"max_lines_per_cart",
"max_quantity_per_line"
],
"additionalProperties": {}
},
"price_authority": {
"type": "string"
}
},
"required": [
"order_placed_by_mcp",
"payment_taken_by_mcp",
"steps",
"checkout_host",
"limits",
"price_authority"
],
"additionalProperties": {}
}
},
"required": [
"language",
"company",
"contact_availability",
"pickup",
"shipping",
"returns",
"age_policy",
"payment",
"horeca",
"assistant",
"policies",
"ordering"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟡create_cart(items, language, buyer_is_18_or_older)
Creates a new Shopify cart with wine variants (variant_id from search_wines or get_wine) and returns cart_id, the items with live prices, the subtotal and checkout_url. No order is placed and no payment is taken here; checkout_url opens the checkout on shop.nevini.wine. Requires buyer_is_18_or_older: true, set only after the user has confirmed being 18 or older. To add wines to a cart the user already has, use add_to_cart instead.
Eingabe-Schema
{
"type": "object",
"properties": {
"items": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"variant_id": {
"type": "string",
"maxLength": 80,
"pattern": "^gid:\\/\\/shopify\\/ProductVariant\\/\\d+$",
"description": "Shopify variant id from search_wines (default_variant_id) or get_wine (variants[].variant_id)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 24,
"description": "Number of bottles, 1-24."
}
},
"required": [
"variant_id",
"quantity"
],
"additionalProperties": false
},
"description": "Wines to add. Duplicate variant ids are merged; a cart holds at most 25 different variants."
},
"language": {
"description": "Language of item names and of the checkout: \"nl\" (default) or \"en\".",
"type": "string",
"enum": [
"nl",
"en"
]
},
"buyer_is_18_or_older": {
"type": "boolean",
"description": "Confirms that the buyer is 18 or older and that the order is not for anyone under 18. Set it to true only after the user has said so in this conversation; if they have not, ask them first. The cart is only created when this is true."
}
},
"required": [
"items",
"buyer_is_18_or_older"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"cart_id": {
"type": "string"
},
"order_placed": {
"type": "boolean",
"const": false
},
"currency": {
"type": "string",
"const": "EUR"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"line_id": {
"type": "string"
},
"variant_id": {
"type": [
"string",
"null"
]
},
"wine_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"vintage": {
"type": [
"string",
"null"
]
},
"size": {
"type": [
"string",
"null"
]
},
"size_label": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"unit_price_eur": {
"type": "number"
},
"line_subtotal_eur": {
"type": "number"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"line_id",
"variant_id",
"wine_id",
"name",
"vintage",
"size",
"size_label",
"quantity",
"unit_price_eur",
"line_subtotal_eur",
"url"
],
"additionalProperties": {}
}
},
"total_quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"subtotal_eur": {
"type": "number"
},
"checkout_url": {
"type": "string"
},
"next_step": {
"type": "string"
},
"shipping_note": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
}
},
"required": [
"cart_id",
"order_placed",
"currency",
"items",
"total_quantity",
"subtotal_eur",
"checkout_url",
"next_step",
"shipping_note",
"warnings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🔴add_to_cart(cart_id, items, language)
Adds wine variants to an existing cart; quantities add up with lines already in the cart. Returns the updated cart and checkout_url. No order is placed and no payment is taken here; checkout_url opens the checkout on shop.nevini.wine. Use create_cart when there is no cart yet and update_cart to change or remove lines already in the cart.
Eingabe-Schema
{
"type": "object",
"properties": {
"cart_id": {
"type": "string",
"minLength": 1,
"maxLength": 1024,
"description": "cart_id exactly as returned by create_cart, including its ?key= part."
},
"items": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"variant_id": {
"type": "string",
"maxLength": 80,
"pattern": "^gid:\\/\\/shopify\\/ProductVariant\\/\\d+$",
"description": "Shopify variant id from search_wines (default_variant_id) or get_wine (variants[].variant_id)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 24,
"description": "Number of bottles, 1-24."
}
},
"required": [
"variant_id",
"quantity"
],
"additionalProperties": false
},
"description": "Wines to add. Duplicate variant ids are merged; a cart holds at most 25 different variants."
},
"language": {
"description": "Language of item names and of the checkout: \"nl\" (default) or \"en\".",
"type": "string",
"enum": [
"nl",
"en"
]
}
},
"required": [
"cart_id",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"cart_id": {
"type": "string"
},
"order_placed": {
"type": "boolean",
"const": false
},
"currency": {
"type": "string",
"const": "EUR"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"line_id": {
"type": "string"
},
"variant_id": {
"type": [
"string",
"null"
]
},
"wine_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"vintage": {
"type": [
"string",
"null"
]
},
"size": {
"type": [
"string",
"null"
]
},
"size_label": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"unit_price_eur": {
"type": "number"
},
"line_subtotal_eur": {
"type": "number"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"line_id",
"variant_id",
"wine_id",
"name",
"vintage",
"size",
"size_label",
"quantity",
"unit_price_eur",
"line_subtotal_eur",
"url"
],
"additionalProperties": {}
}
},
"total_quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"subtotal_eur": {
"type": "number"
},
"checkout_url": {
"type": "string"
},
"next_step": {
"type": "string"
},
"shipping_note": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
}
},
"required": [
"cart_id",
"order_placed",
"currency",
"items",
"total_quantity",
"subtotal_eur",
"checkout_url",
"next_step",
"shipping_note",
"warnings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🔴update_cart(cart_id, lines, language)
Sets the quantity of existing cart lines by line_id; quantity 0 removes a line. Returns the updated cart and checkout_url. No order is placed and no payment is taken here; checkout_url opens the checkout on shop.nevini.wine. line_id comes from create_cart, add_to_cart or get_cart; use add_to_cart for wines that are not in the cart yet.
Eingabe-Schema
{
"type": "object",
"properties": {
"cart_id": {
"type": "string",
"minLength": 1,
"maxLength": 1024,
"description": "cart_id exactly as returned by create_cart, including its ?key= part."
},
"lines": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"line_id": {
"type": "string",
"minLength": 1,
"maxLength": 512,
"description": "line_id of an item in the latest cart result."
},
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 24,
"description": "New number of bottles, 0-24; 0 removes the line."
}
},
"required": [
"line_id",
"quantity"
],
"additionalProperties": false
}
},
"language": {
"description": "Language of item names and of the checkout: \"nl\" (default) or \"en\".",
"type": "string",
"enum": [
"nl",
"en"
]
}
},
"required": [
"cart_id",
"lines"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"cart_id": {
"type": "string"
},
"order_placed": {
"type": "boolean",
"const": false
},
"currency": {
"type": "string",
"const": "EUR"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"line_id": {
"type": "string"
},
"variant_id": {
"type": [
"string",
"null"
]
},
"wine_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"vintage": {
"type": [
"string",
"null"
]
},
"size": {
"type": [
"string",
"null"
]
},
"size_label": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"unit_price_eur": {
"type": "number"
},
"line_subtotal_eur": {
"type": "number"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"line_id",
"variant_id",
"wine_id",
"name",
"vintage",
"size",
"size_label",
"quantity",
"unit_price_eur",
"line_subtotal_eur",
"url"
],
"additionalProperties": {}
}
},
"total_quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"subtotal_eur": {
"type": "number"
},
"checkout_url": {
"type": "string"
},
"next_step": {
"type": "string"
},
"shipping_note": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
}
},
"required": [
"cart_id",
"order_placed",
"currency",
"items",
"total_quantity",
"subtotal_eur",
"checkout_url",
"next_step",
"shipping_note",
"warnings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_cart(cart_id, language)
Returns the current lines, live prices, subtotal and checkout_url of a cart. No order is placed and no payment is taken here; checkout_url opens the checkout on shop.nevini.wine. It changes nothing; use it to show the cart again or to look up line_id for update_cart.
Eingabe-Schema
{
"type": "object",
"properties": {
"cart_id": {
"type": "string",
"minLength": 1,
"maxLength": 1024,
"description": "cart_id exactly as returned by create_cart, including its ?key= part."
},
"language": {
"description": "Language of item names and of the checkout: \"nl\" (default) or \"en\".",
"type": "string",
"enum": [
"nl",
"en"
]
}
},
"required": [
"cart_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"cart_id": {
"type": "string"
},
"order_placed": {
"type": "boolean",
"const": false
},
"currency": {
"type": "string",
"const": "EUR"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"line_id": {
"type": "string"
},
"variant_id": {
"type": [
"string",
"null"
]
},
"wine_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"vintage": {
"type": [
"string",
"null"
]
},
"size": {
"type": [
"string",
"null"
]
},
"size_label": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"unit_price_eur": {
"type": "number"
},
"line_subtotal_eur": {
"type": "number"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"line_id",
"variant_id",
"wine_id",
"name",
"vintage",
"size",
"size_label",
"quantity",
"unit_price_eur",
"line_subtotal_eur",
"url"
],
"additionalProperties": {}
}
},
"total_quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000
},
"subtotal_eur": {
"type": "number"
},
"checkout_url": {
"type": "string"
},
"next_step": {
"type": "string"
},
"shipping_note": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
}
},
"required": [
"cart_id",
"order_placed",
"currency",
"items",
"total_quantity",
"subtotal_eur",
"checkout_url",
"next_step",
"shipping_note",
"warnings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet8 Tools