{
  "package": "arradar-partner-api",
  "version": "2.0",
  "compatibility": {
    "import_api": "A jelenlegi /api/v1/import végpontok és payloadok változatlanul támogatottak.",
    "authentication": "Authorization: Bearer <api-key> vagy X-Arradar-Api-Key: <api-key>"
  },
  "inventory": {
    "fields": {
      "identifier": "A webshop stabil, egyedi cikkszáma.",
      "google_product_category_id": "Opcionális numerikus Google Product Taxonomy ID. Megadásakor elsődleges kategorizálási jel; hiányában az automatikus besorolás működik tovább.",
      "stock_qty": "Egész darabszám vagy null. Hiányzó/null érték in_stock=true mellett effektív 1.",
      "in_stock": "Hamis értéknél nem rendelhető, stock_qty értékétől függetlenül.",
      "item_group_id": "Változatos terméknél a változatok közös csoportazonosítója; minden változat külön identifier.",
      "color": "Változat színe.",
      "size": "Változat mérete.",
      "material": "Opcionális: anyag.",
      "pattern": "Opcionális: minta.",
      "attributes": "Opcionális egyéb megkülönböztető tulajdonságok: [{\"name\":\"Kiszerelés\",\"value\":\"500 ml\"}], max. 10."
    },
    "stock_only_example": {
      "mode": "stock_only",
      "products": [
        {
          "identifier": "SKU-100",
          "stock_qty": 7,
          "in_stock": true
        }
      ]
    },
    "reservation_rule": "Az aktív ÁrRadar foglalások levonódnak az elérhető készletből. Sikeres rendelés véglegesít, meghiúsult fizetés felszabadít.",
    "partner_responsibility": "A partner felel a gyors készletszinkronért és az ÁrRadar-rendelések saját rendszerbe történő visszavezetéséért."
  },
  "endpoints": [
    {
      "method": "POST",
      "path": "/api/v1/import/products/batch",
      "purpose": "upsert, patch, stock_only vagy delete termékbatch"
    },
    {
      "method": "GET",
      "path": "/api/v1/import/batches/{batch_id}",
      "purpose": "import feldolgozási állapot"
    },
    {
      "method": "GET",
      "path": "/api/v1/orders",
      "purpose": "saját webshop rendelései, cursor alapú lapozással"
    },
    {
      "method": "GET",
      "path": "/api/v1/orders?order_id={id}",
      "purpose": "saját webshop egy rendelése"
    },
    {
      "method": "PATCH",
      "path": "/api/v1/orders/fulfillment/{id}",
      "headers": {
        "Idempotency-Key": "kötelező, stabil kérésazonosító"
      },
      "purpose": "teljesítési állapot és csomagazonosító"
    }
  ],
  "webhooks": {
    "events": [
      "order.created",
      "order.payment_updated",
      "order.fulfillment_updated",
      "order.cancelled"
    ],
    "required_url_scheme": "https",
    "headers": [
      "X-Arradar-Event",
      "X-Arradar-Event-Id",
      "X-Arradar-Timestamp",
      "X-Arradar-Signature"
    ],
    "signature": "sha256=HMAC_SHA256(secret, timestamp + '.' + raw_body)",
    "success": "Bármely 2xx válasz siker. Más válasz exponenciális újrapróbálást indít."
  }
}