update_listing – Angebot ändern

Ändert Preis, Bestand, Lieferzeit, Rückgabe, Garantie oder Status. expected_version verhindert, dass parallele Änderungen überschrieben werden.

HTTP

PATCH /api/listings/{offer_id}

Zugang

Rolle merchant (Shop)

Bereich

Verkaufen

Nur lesend

nein

Du bist nicht angemeldet. Anmelden

Formular

Eingabeschema (JSON Schema)

{
    "type": "object",
    "properties": {
        "offer_id": {
            "type": "string",
            "description": "Angebots-ID, z. B. off_1a2b3c4d5e6f"
        },
        "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)"
        },
        "status": {
            "type": "string",
            "enum": [
                "active",
                "inactive"
            ]
        },
        "expected_version": {
            "type": "integer"
        }
    },
    "required": [
        "offer_id"
    ]
}

REST

curl -X PATCH https://anltx.com/api/listings/<offer_id> \
  -H "Authorization: Bearer $ANLTX_KEY" \
  -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

MCP

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "update_listing",
        "arguments": {
            "offer_id": "<offer_id>"
        }
    }
}

Alle Werkzeuge