دریافت قیمت و موجودی کالاها
پاتریس یار تغییرات کالاهای پاتریس را با POST /patris-yar/products به سایت میفرستد. سایت این ردیفها را ذخیره میکند و قیمت و موجودی محصولاتی را که به کد پاتریس متصلاند بهروز میکند.
این endpoint کی صدا زده میشود؟
- وقتی گزینهی «بهروزرسانی قیمت و موجودی» برای این سایت در پاتریس یار روشن باشد.
- در هر دور همگامسازی، فقط ردیفهایی که از ارسال قبلی تغییر کردهاند.
- در دستههایی به اندازهی «تعداد در هر ارسال» (پیشفرض ۱۰۰ و حداکثر ۵۰۰۰ ردیف)، تا ۵۰ دسته در هر دور.
پیشنیازها
- مسیرها و احراز هویت
- هر محصول سایت که باید از پاتریس بهروز شود، کد کالای پاتریس را داشته باشد (همان
pipدر قالب سفارش).
Endpoint
POST /patris-yar/products
هدرها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
X-Payava-Key | string | بله | کلید API حساب پاتریس. |
Content-Type | string | بله | application/json; charset=utf-8 |
پارامترها
بدنه یک شیء با آرایهی products است. هر عضو یک ردیف «کالا در یک انبار» است:
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
code | integer | بله | کد کالا در پاتریس. |
anbar | integer | بله | کد انبار. -1 یعنی جمع موجودی همهی انبارها. |
action | string | بله | UpdateProduct برای افزودن یا بهروزرسانی، DeleteProduct برای حذف کالا در پاتریس. |
name | string | خیر | نام کالا در پاتریس. |
unit | string | خیر | واحد کالا، مثل «عدد». |
price | number | بله | قیمت اصلی، به واحد پاتریس. |
price1 | number | بله | قیمت سطح ۱، به واحد پاتریس. |
price2 | number | بله | قیمت سطح ۲، به واحد پاتریس. |
price3 | number | بله | قیمت سطح ۳، به واحد پاتریس. |
price_wg | number | بله | قیمت عمده، به واحد پاتریس. |
inventory | number | بله | موجودی این انبار. |
سایت با هر ردیف چه کند؟
- ردیف را با کلید
codeوanbarذخیره یا جایگزین کند.DeleteProductرا فقط علامت «حذفشده» بزنید. - محصولات سایت با همین
codeرا پیدا کند. - قیمت را از سطح قیمت انتخابی (مثلاً
price) بخواند، بر ضریب واحد تقسیم کند و اگر بزرگتر از صفر بود، روی محصول بگذارد. - موجودی را از انبار انتخابی بگذارد. اگر انبار خاصی انتخاب نشده، ردیف
anbarبرابر-1را به کار ببرد.
نمونه درخواست و پیادهسازی
- curl
- C#
- Python
- PHP
- Node.js
- Go
ارسال کالاها
curl -X POST https://shop.example.com/patris-yar/products \
-H "X-Payava-Key: YOUR_API_KEY" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{"products":[{"code":101009001,"anbar":-1,"action":"UpdateProduct","name":"لنت ترمز جلو","unit":"عدد","price":1200000,"price1":1150000,"price2":0,"price3":0,"price_wg":1000000,"inventory":42}]}'
POST /products
patris.MapPost("/products", async (ProductsRequest body, IShopStore store, IConfiguration config) =>
{
var factor = config.GetValue("Patris:PriceFactor", 1m); // e.g. 10 when the site is in Toman and Patris in Rial
int stored = 0, updated = 0, notFound = 0;
foreach (var row in body.Products.Where(p => p.Code > 0))
{
await store.UpsertPatrisRowAsync(row); // key: Code + Anbar; DeleteProduct = mark deleted
stored++;
}
foreach (var code in body.Products.Where(p => p.Code > 0).Select(p => p.Code).Distinct())
{
var changed = await store.ApplyPatrisRowsToProductsAsync(code, factor); // price / factor, stock; 0 = no linked product
if (changed == 0) notFound++;
updated += changed;
}
return Results.Json(new { stored, updated, not_found = notFound, skipped = 0 });
});
public sealed class ProductsRequest
{
public List<PatrisProductRow> Products { get; set; } = new();
}
public sealed class PatrisProductRow
{
public long Code { get; set; }
public int Anbar { get; set; }
public string? Action { get; set; }
public string? Name { get; set; }
public string? Unit { get; set; }
public decimal Price { get; set; }
public decimal Price1 { get; set; }
public decimal Price2 { get; set; }
public decimal Price3 { get; set; }
[System.Text.Json.Serialization.JsonPropertyName("price_wg")] public decimal PriceWg { get; set; }
public double Inventory { get; set; }
}
POST /products
from decimal import Decimal
PRICE_FACTOR = Decimal(os.environ.get("PATRIS_PRICE_FACTOR", "1")) # e.g. 10: site in Toman, Patris in Rial
class PatrisProductRow(BaseModel):
code: int
anbar: int = 0
action: str = "UpdateProduct"
name: str | None = None
unit: str | None = None
price: Decimal = Decimal(0)
price1: Decimal = Decimal(0)
price2: Decimal = Decimal(0)
price3: Decimal = Decimal(0)
price_wg: Decimal = Decimal(0)
inventory: float = 0
class ProductsRequest(BaseModel):
products: list[PatrisProductRow] = []
@router.post("/products")
def products(body: ProductsRequest):
rows = [p for p in body.products if p.code > 0]
for row in rows:
store.upsert_patris_row(row) # key: code + anbar; DeleteProduct = mark deleted
updated = not_found = 0
for code in {p.code for p in rows}:
changed = store.apply_patris_rows_to_products(code, PRICE_FACTOR) # 0 = no linked product
not_found += changed == 0
updated += changed
return {"stored": len(rows), "updated": updated, "not_found": not_found, "skipped": 0}
POST /products
if ($method === 'POST' && $route === '/products') {
$factor = (float) (getenv('PATRIS_PRICE_FACTOR') ?: 1); // e.g. 10: site in Toman, Patris in Rial
$rows = array_filter((array) (json_body()['products'] ?? []), fn ($r) => (int) ($r['code'] ?? 0) > 0);
foreach ($rows as $row) {
$store->upsertPatrisRow($row); // key: code + anbar; DeleteProduct = mark deleted
}
$updated = 0;
$notFound = 0;
foreach (array_unique(array_map(fn ($r) => (int) $r['code'], $rows)) as $code) {
$changed = $store->applyPatrisRowsToProducts($code, $factor); // 0 = no linked product
if ($changed === 0) {
$notFound++;
}
$updated += $changed;
}
respond(200, ['stored' => count($rows), 'updated' => $updated, 'not_found' => $notFound, 'skipped' => 0]);
}
POST /products
const PRICE_FACTOR = Number(process.env.PATRIS_PRICE_FACTOR || 1); // e.g. 10: site in Toman, Patris in Rial
router.post('/products', async (req, res, next) => {
try {
const rows = (req.body.products || []).filter((r) => Number(r.code) > 0);
for (const row of rows) {
await store.upsertPatrisRow(row); // key: code + anbar; DeleteProduct = mark deleted
}
let updated = 0;
let notFound = 0;
for (const code of new Set(rows.map((r) => Number(r.code)))) {
const changed = await store.applyPatrisRowsToProducts(code, PRICE_FACTOR); // 0 = no linked product
if (changed === 0) notFound++;
updated += changed;
}
res.json({ stored: rows.length, updated, not_found: notFound, skipped: 0 });
} catch (err) {
next(err);
}
});
POST /products
type PatrisProductRow struct {
Code int64 `json:"code"`
Anbar int `json:"anbar"`
Action string `json:"action"`
Name string `json:"name"`
Unit string `json:"unit"`
Price float64 `json:"price"`
Price1 float64 `json:"price1"`
Price2 float64 `json:"price2"`
Price3 float64 `json:"price3"`
PriceWg float64 `json:"price_wg"`
Inventory float64 `json:"inventory"`
}
func products(w http.ResponseWriter, r *http.Request) {
var body struct {
Products []PatrisProductRow `json:"products"`
}
if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
writeJSON(w, http.StatusBadRequest, map[string]string{"code": "invalid_json", "message": err.Error()})
return
}
factor := priceFactor() // e.g. 10: site in Toman, Patris in Rial
stored, updated, notFound := 0, 0, 0
codes := map[int64]bool{}
for _, row := range body.Products {
if row.Code <= 0 {
continue
}
store.UpsertPatrisRow(r.Context(), row) // key: code + anbar; DeleteProduct = mark deleted
stored++
codes[row.Code] = true
}
for code := range codes {
changed := store.ApplyPatrisRowsToProducts(r.Context(), code, factor) // 0 = no linked product
if changed == 0 {
notFound++
}
updated += changed
}
writeJSON(w, http.StatusOK, map[string]int{"stored": stored, "updated": updated, "not_found": notFound, "skipped": 0})
}
// patris.HandleFunc("POST "+base+"/products", products)
نمونه پاسخ موفق
200 OK
{ "stored": 1, "updated": 1, "not_found": 0, "skipped": 0 }
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
stored | integer | خیر | تعداد ردیفهای ذخیرهشده. |
updated | integer | خیر | تعداد محصولات سایت که تغییر کردند. پاتریس یار این عدد را در log خود ثبت میکند. |
not_found | integer | خیر | تعداد کدهایی که محصول متصل در سایت نداشتند. |
skipped | integer | خیر | تعداد کدهای ردشده. |
کدهای خطا
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
401 | payava_patris_unauthorized | — | کلید نادرست است. |
400 | invalid_json | — | بدنهی درخواست JSON معتبر نیست. |
413 | — | — | بدنه از حد مجاز سرور بزرگتر است. حد سرور را بالا ببرید یا «تعداد در هر ارسال» را در پاتریس یار کم کنید. |
نکتهها
ردیفها فقط پس از پاسخ موفق ارسالشده حساب میشوند
اگر پاسخ موفق نباشد، پاتریس یار همان ردیفها را در دور بعد دوباره میفرستد. پس ذخیره را با کلید code و anbar و به صورت جایگزینی بنویسید تا تکرار مشکلی ایجاد نکند.
- محصولی را که در پاتریس حذف شده (
DeleteProduct)، در سایت حذف نکنید. ردیف را علامت بزنید و تصمیم دربارهی محصول را به مدیر سایت بسپارید. - قیمت
0یعنی پاتریس برای آن سطح قیمت ندارد. قیمت محصول سایت را با0بازنویسی نکنید. - دستهی ۵۰۰۰ ردیفی چند مگابایت حجم دارد. حد اندازهی بدنه را در وبسرور و framework بررسی کنید (مثلاً
express.jsonبهطور پیشفرض فقط ۱۰۰ کیلوبایت میپذیرد).