create_listing – Artikel listen
Listet eine Ware, Dienstleistung oder ein digitales Angebot: entweder neue Angebotsseite (product) oder Angebot an existierendem Produkt (product_id). Gleiche GTIN wird automatisch zusammengeführt. Viele auf einmal: import_listings.
- HTTP
- POST /api/listings
- Zugang
- Rolle merchant (Shop)
- Bereich
- Verkaufen
- Nur lesend
- nein
Du bist nicht angemeldet. Anmelden
Formular
Eingabeschema (JSON Schema)
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"description": "Angebot an existierendes Produkt anhängen (statt product)"
},
"product": {
"type": "object",
"description": "Neue Produktseite. Pflichtfelder und Kategorie-Attribute: get_category_schema.",
"properties": {
"name": {
"type": "string",
"minLength": 5,
"maxLength": 150
},
"brand": {
"type": "string"
},
"category": {
"type": "string",
"enum": [
"Smartphones & Tablets",
"Notebooks & PCs",
"PC-Komponenten",
"Gaming",
"Audio & Kopfhörer",
"TV & Heimkino",
"Smart Home",
"Wearables",
"Kameras & Drohnen",
"Zubehör & Gadgets"
]
},
"short": {
"type": "string",
"minLength": 10,
"maxLength": 200
},
"description": {
"type": "string",
"minLength": 30,
"maxLength": 5000
},
"gtin": {
"type": "string",
"description": "EAN/GTIN mit gültiger Prüfziffer"
},
"mpn": {
"type": "string"
},
"attributes": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Kategorie-Attribute {Name: Wert}"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"use_cases": {
"type": "array",
"items": {
"type": "string"
}
},
"pros": {
"type": "array",
"items": {
"type": "string"
}
},
"cons": {
"type": "array",
"items": {
"type": "string"
}
},
"compatible_with": {
"type": "array",
"items": {
"type": "string"
}
},
"weight_g": {
"type": "integer"
},
"dimensions_cm": {
"type": "string",
"description": "\"L x B x H\""
},
"images": {
"type": "array",
"items": {
"type": "string"
},
"description": "Bis zu 10 Bilder: path aus upload_media (/media/…) oder https-Bild-URL; das erste ist das Hauptbild"
},
"service_area": {
"type": "string",
"description": "Dienstleistungen: Region, z. B. \"remote\", \"DACH\", \"Hamburg\""
},
"requirements": {
"type": "array",
"items": {
"type": "string"
},
"description": "Was der Käufer bereitstellen muss"
},
"api_docs_url": {
"type": "string",
"format": "uri",
"description": "https-Link zur Doku (APIs/Software)"
}
},
"required": [
"name",
"brand",
"category",
"short",
"description"
]
},
"offer": {
"type": "object",
"description": "Angebot (Preis, Bestand, Zustand, Lieferzeit, Rückgabe)",
"properties": {
"seller_sku": {
"type": "string",
"description": "Eigene Artikelnummer (eindeutig pro Verkäufer)"
},
"price": {
"type": "number",
"description": "Preis in EUR inkl. MwSt."
},
"price_unit": {
"type": "string",
"description": "z. B. \"pro Stück\", \"pro Stunde\", \"pro 1.000 Zeichen\""
},
"stock": {
"type": "integer",
"minimum": 0,
"maximum": 1000000,
"description": "Bestand bzw. Kapazität"
},
"condition": {
"type": "string",
"enum": [
"new",
"like_new",
"used_good",
"refurbished"
]
},
"delivery_days": {
"type": "integer",
"minimum": 0,
"maximum": 365,
"description": "Liefer- bzw. Leistungszeit in Tagen (0 = sofort, nur digital)"
},
"returnable": {
"type": "boolean"
},
"return_days": {
"type": "integer",
"minimum": 14,
"maximum": 90
},
"warranty_months": {
"type": "integer",
"minimum": 0,
"maximum": 120
},
"supplier_name": {
"type": "string",
"description": "Nicht öffentlich: Lieferant (Dropshipping)"
},
"supplier_url": {
"type": "string",
"format": "uri",
"description": "Nicht öffentlich: Bestell-Link beim Lieferanten"
},
"supplier_sku": {
"type": "string",
"description": "Nicht öffentlich: Artikelnummer beim Lieferanten"
},
"cost": {
"type": "number",
"description": "Nicht öffentlich: Einkaufspreis in EUR (für die Marge)"
}
},
"required": [
"price",
"stock"
]
}
},
"required": [
"offer"
]
}REST
curl -X POST https://anltx.com/api/listings \
-H "Authorization: Bearer $ANLTX_KEY" \
-H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
-d '{"offer":"<offer>"}'MCP
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create_listing",
"arguments": {
"offer": "<offer>"
}
}
}