Parsys بازار

دسترسی برنامه‌ای (API)

همه قیمت‌های بازار پارسیس با کد ثابت هر ماده از نشانی‌های زیر خوانده می‌شوند. مبلغ‌ها به ریال و تاریخ‌ها میلادی (ISO) هستند. پاسخ JSON است و نیازی به ورود ندارد.

فهرست دسته‌ها و انواع

GET /api/v1/categories

همه مواد یک دسته یا یک نوع، با آخرین قیمت

GET /api/v1/materials?category=PAPER
GET /api/v1/materials?category=PAPER&type=GLS

جستجوی مواد

با کد یا نام (با هر نوع نوشتن ی و ک)، اختیاری در یک دسته یا نوع؛ صفحه‌ها از صفر شمرده می‌شوند.

GET /api/v1/materials/search?q=گلاسه&category=PAPER&type=GLS&page=0&size=20

یک ماده و تاریخچه قیمتش

GET /api/v1/materials/ps_1030_10229
GET /api/v1/materials/ps_1030_10229/prices?from=2026-09-01&to=2026-10-04

قیمت چند کد در یک روز (برای ERP)

برای هر کد آخرین قیمتِ ثبت‌شده تا آن روز برمی‌گردد. کدی که هنوز قیمت ندارد "price": null می‌گیرد و کدی که وجود ندارد "found": false.

GET /api/v1/prices?codes=ps_1030_10229,ps_1030_10228&date=2026-10-04

مشخصه‌های یک نوع

مشخصه‌هایی که هر ماده‌ی این نوع با آن‌ها توصیف می‌شود، مقادیر مجاز مشخصه‌های فهرستی و واحدهای قیمت. مشخصه‌هایی که "identity": true دارند با هم تعیین می‌کنند هر ماده کدام است.

GET /api/v1/types/PAPER/FBB

کد ثابت یک ماده از روی مشخصاتش

برای وصل کردن کالای سیستم خودتان به کد بازار: مقدار هر مشخصه را با کد همان مشخصه بفرستید. عددها و ابعاد هر طور نوشته شوند یکسان سنجیده می‌شوند (۲۷۰ = 270.0، ۱۰۰×۷۰ = 100*70). اگر ماده‌ای با این مشخصات نباشد "found": false برمی‌گردد؛ کد تازه را فقط پارسیس می‌سازد.

GET /api/v1/materials/match?category=PAPER&type=FBB&brand=نینگبو&grain=LG&gsm=270&size=100x70&sheetsPerBundle=100

سرویس‌ها

درخت سرویس‌ها با کد ثابت هر سرویس (SRV-PRN-0001)، کد گروه بالاتر و انواع کالایی که مصرف می‌کند.

GET /api/v1/services
GET /api/v1/services/SRV-PRN-0001

سیستم‌های متصل (ParsysERP، NODE، پنل تأمین‌کنندگان)

هر سیستم متصل کلید API خودش را از پارسیس می‌گیرد و آن را در سرآیند X-Api-Key می‌فرستد. با آن کدهای خودش را به کد بازار وصل می‌کند، قیمت روز را با کد و واحد خودش می‌خواند و فهرست تغییرات را دنبال می‌کند. unitRatio یعنی هر واحد شما چند برابر واحد بازار است (بند ۱۸٫۹ کیلویی وقتی بازار قیمت هر کیلو را می‌دهد: 18.9).

GET    /api/v1/client/me
GET    /api/v1/client/mappings
PUT    /api/v1/client/mappings          {"localCode":"10023","code":"ps_1030_10229","localUnit":"بند","unitRatio":18.9}
POST   /api/v1/client/mappings          [ {...}, {...} ]   (تا ۲۰۰۰ مورد؛ هر مورد جدا نتیجه می‌گیرد)
DELETE /api/v1/client/mappings?localCode=10023
GET    /api/v1/client/prices?date=2026-11-09
GET    /api/v1/client/changes?since=0&limit=500

هر تغییر یک شماره نسخه دارد؛ پاسخ to را نگه دارید و دفعه بعد با since بفرستید. اگر نشانی‌ای دارید که بازار به آن دسترسی دارد، پارسیس می‌تواند همین پاسخ را هر دقیقه برایتان POST کند، امضاشده: X-Bazar-Signature: sha256=HMAC-SHA256(secret, X-Bazar-Timestamp + "." + body). یک تغییر ممکن است دو بار برسد؛ با شماره نسخه تکراری‌ها را کنار بگذارید.

معنای فیلدها

price
قیمت مرجع روز در واحد ماده (unit: KG، BUNDLE، ...).
pricePerKilo / pricePerBundle
قیمت هر کیلوگرم و هر بند، وقتی معلوم باشد.
minPrice / maxPrice / offers
کمترین و بیشترین پیشنهاد و تعداد پیشنهادهای آن روز.
method
LOWEST_CASH: کمترین پیشنهاد نقدیِ موجود؛ LOWEST: کمترین پیشنهاد وقتی پیشنهاد نقدی نبوده؛ MANUAL: ثبت‌شده توسط پارسیس.