Kezdőoldal

Orczy Termék Feed API Dokumentáció

Optimalizálja a termékkezelést az Orczy Termék Feed API-val! Ez a hatékony eszköz lehetővé teszi, hogy elektronikusan lekérdezze széleskörű termékkatalógusunkat, biztosítva, hogy mindig a legfrissebb információk álljanak rendelkezésére. Egyszerűsítse műveleteit és növelje e-kereskedelmi képességeit a termékadatainkhoz való közvetlen integrációval.

Áttekintés

•Protokoll: HTTPS
•Architektúra: REST
•Metódus: GET
•Hitelesítés: Basic Auth

Hitelesítés

A kérések hitelesítéséhez adja meg az Authorization fejlécet egy Base64 kódolású felhasználó:jelszó sztringgel.

•Fejléc: Accept: application/json
•Fejléc: Authorization: Basic {felhasználó:jelszó base64 kódolva}

Teszt Belépési Adatok

•Felhasználónév: testuser
•Jelszó: testuser

A teszt belépési adatok használatakor **kiskereskedelmi árakat** és maximum 1000 terméket fog látni. Szerződéskötés után hozzáférhet a **nagykereskedelmi árakhoz** és az összes elérhető termékhez.

Alap URL

Teszt Környezet: https://orczyapi.hu/productapi/v2/

Végpontok

•GET /getproduct-byid/{id}: Egyetlen termék lekérdezése egyedi termékazonosító alapján. Ez az azonosító a /getproducts-all végpontokról szerezhető be.
•GET /getproduct-bysku/{sku}: Egyetlen termék lekérdezése SKU (cikkszám) alapján. Az SKU értéke a /getproducts-all végpontokról szerezhető be.
•GET /getproducts-all: Az összes rendelhető termék visszaadása JSON formátumban.
•GET /getproducts-all-csv: Az összes rendelhető termék visszaadása **pontosvesszővel elválasztott CSV formátumban**.

URL Paraméterek

Ezek a paraméterek a getproducts-all végpontokhoz fűzhetők. Ha egy paraméter nincs elküldve, vagy érvénytelen értékkel van elküldve, figyelmen kívül lesz hagyva.

Paraméter	Leírás
onstockonly=1	Az eredmények szűrése, hogy csak azokat a termékeket tartalmazza, amelyek jelenleg raktáron vannak a fő- vagy külső raktárban.
lazy=1	A termékmezők egyszerűsített készletét adja vissza a gyorsabb kérésekhez: `id`, `sku`, `mainStock`, `outerStock`, `netWholesalerPrice`.

Példa URL Paraméterekkel

URL

https://orczyapi.hu/productapi/v2/getproducts-all?lazy=1&onstockonly=1

Példa Kérés és Eredmény

Kérés: GET /getproduct-byid/11911

Fejlécek

Authentication

Eredmény

JSON Válasz

{
 "response-time": "0 ms",
 "result-size": 1,
 "results": [
   {
     "originalCodes": [],
     "outerStock": 20,
     "nameHU": " 25W Izzó mikrohullámú sütő sarus CL823 /RENDELÉSRE",
     "id": "1",
     "sku": "UVI067",
     "netWholesalerPriceHUF": 400,
     "mainStock": 110,
     "quality": "original",
     "images": [
       "https://orczy.com/Image.axd?G=orczy-cikkek&CIKKID=1"
     ]
   }
 ],
 "user": "testuser",
 "status": "success"
}

A termék(ek) adatai a results tömbben találhatók.

A tesztkörnyezetben kiskereskedelmi árakat fog látni.

Mezők

Mező	Leírás
`status`	A kérés állapotát jelzi (pl. `siker`, `sku-nem-található`, `hitelesítési hiba`).
`result-size`	A talált termékek száma. A `getproduct-byid` végpont esetében ez mindig 1 lesz.
`id`	A termék egyedi azonosítója. Ezt javasoljuk a termék azonosítására.
`sku`	Az Orczy belső referencia kódja a termékhez.
`netWholesalerPriceHUF`	Az Önnek számlázandó nagykereskedelmi ár EUR-ban, már alkalmazott kedvezményekkel.
`mainStock`	Elérhető raktárkészlet központi raktárunkban. A 15:00 óra előtt leadott rendeléseket még aznap feladjuk.
`outerStock`	Elérhető raktárkészlet puffertárolónkban, ami 1 munkanapos szállítási késedelmet okozhat.
`nameHU`	A termék neve magyarul.
`quality`	A termék minősége. Lehetséges értékek: `original`, `OEM`, `alternative`, `multicompatible`, `n/a`.
`images`	A termékhez tartozó képek URL-jeinek listája.
`originalCodes`	A termék eredeti márkakódjainak listája.

Amennyiben érdekli az API használata, kérjük, küldjön nekünk egy e-mailt. Kattintson az alábbi gombra az e-mail cím megjelenítéséhez.

Összes elem törlése

Figyelem!