شروع
API توسعه دهندگان انار ۳۶۰
API توسعه دهندگان بازار یک وب‌سرویس مبتنی بر REST است و به شما این امکان را می‌دهد تا محصولات انار را با جزییات کامل در وب سایت خود وارد کنید و خریدار مستقیما کالاهای انار را در وب سایت شما ببیند.
شما می توانید محصولات انار را در کنار محصولات دیگر خود مدیریت کنید.
API توسعه دهندگان انار این امکان را به شما می دهد که موجودی و قیمت کلیه محصولات خود را دائما بروز کنید و با سرور انار هماهنگ نگه دارید.
هر کدام از امکانات API، با کمک یک درخواست HTTP قابل دسترسی است. پاسخ هر یک از این درخواست‌ها، اطلاعات، نتایج درخواستی و خطاهای احتمالی از سمت سرور انار، در قالب JSON به شما برگردانده می‌شود. برای اطلاع بیشتر از امکانات و پاسخ‌های آن‌ها، به مرجع API در ادامه این مستندات مراجعه کنید.
ثبت نام
در ابتدا لازم است در پنل فروشندگان انار به آدرس https://anar360.com/register ثبت نام کنید تا پس از بررسی و تایید به عنوان دراپ شیپر پذیرفته شوید.
خرید اشتراک
برای استفاده از API لازم است پلن اشتراک حرفه ایی را خریداری کنید.
دریافت توکن
پس از ورود به پنل انار خود از بخش اشتراک های خود می توانید کلید احراز هویت (توکن) را دریافت کنید.
برای استفاده از API به این کلید نیاز دارید.
ساختار درخواست
همه APIهای انار از شیوه احراز هویت Bearer Token استفاده می کنند.
به عنوان مثال API دریافت لیست محصولات به صورت زیر فراخوانی می شود:
curl –location ‘https://api.anar360.com/api/360/products’ \ –header ‘Authorization: Bearer <YOUR_TOKEN>’
خطاهای اعتبارسنجی
در صورت بروز خطای اعتبار سنجی پاسخی به صورت زیر دریافت خواهید کرد
{
"statusCode": 403,
"success": false,
"error": 10012 // کدهای خطا را در جدول زیر ببینید
}
لیست خطاها
| 10000 | خطای نامعلوم |
| 10010 | توکن وارد نشده است یا در دیتابیس وجود ندارد(اشتباه وارد شده است) |
| 10011 | نوع اشتراک باید پلن حرفه ای باشد. |
| 10012 | اعتبار اشتراک به پایان رسیده است. |
اعتبارسنجی
اعتبارسنجی
برای بررسی وضعیت معتبر/غیرمعتبر بودن حساب کاربری خود در انار باید API زیر را با متد GET فراخوانی کنید:
[GET] https://api.anar360.com/api/360/auth/validate
این متد هیچ پارامتر ورودی ندارد. فقط کافیست توکن خود را در header به شیوه ایی که جلوتر در ساختار درخواست توضیح داده شد ارسال کنید.
نمونه فراخوانی API اعتبار سنجی
curl --location 'https://api.anar360.com/api/360/auth/validate' \ --header 'Authorization: Bearer YOUR_TOKEN'
پاسخ های API اعتبار سنجی
| 200 | توکن معتبر است |
| 403 | توکن نامعتبر است |
در صورتی که توکن معتبر باشد پاسخ زیر را با کد 200 دریافت خواهید کرد:
{
"success": true,
"shopUrl": "https://YOUR_ACCOUNT_SLUG.myanar360.com",
"subscriptionPlan": "pro",
"subscriptionRemaining": 72828896504
}
در صورتی که توکن معتبر نباشد پاسخ زیر را با کد 403 دریافت می کنید:
{
"statusCode": 403,
"success": false,
"error": 10010 // کدهای خطا را در جدول زیر ببینید
}
لیست خطاها
| 10000 | خطای نامعلوم |
| 10010 | توکن وارد نشده است یا در دیتابیس وجود ندارد(اشتباه وارد شده است) |
| 10011 | نوع اشتراک باید پلن حرفه ای باشد. |
| 10012 | اعتبار اشتراک به پایان رسیده است. |
محصولات
لیست محصولات
این api برای فراخوانی اطلاعات محصولاتی است که کاربر در اکانت انار خود به فروشگاه‌اش اضافه کرده و برای نمایش محصولات و اطلاعاتشان در وبسایت شما است. !در انار وریشن‌ها(متغیرها) به فروش می‌رسند. برای همین هر variation آیدی مختص به خود را دارد که ثبت سفارش هم با آيدی variation محصول انجام می‌شود.
API با متد GET فراخوانی می شود.
https://api.anar360.com/api/360/products
پارامترهای ورودی
| page | شماره صفحه |
| limit | تعداد محصول در هر صفحه |
| since | مدت زمان گذشته (بر حسب میلی ثانیه) از آخرین تغییرات موجودی و قیمت محصول |
پارامترهای page و limit برای پیجینیشن لیست دریافتی محصولات استفاده می شوند و هر دو پارامتر اختیاری هستند ولی توصیه می شود مقدار limit حداکثر روی عدد 25 تنظیم شود.
پارامتر since یک پارامتی اختیاری است که برای دریافت محصولاتی که اخیرا تغییر موجودی و قیمت داشته اند کاربرد دارد، به این صورت که مثلا برای دریافت لیست محصولاتی که ۲ دقیقه پیش آپدیت شده اند عدد ۲ دقیقه بر حسب میلی ثانیه برای این پارامتر تنظیم می شود.
توجه : مقداری که برای since پاس داده می شود باید یک عدد منفی باشد.
since=-120000
نمونه فراخوانی با cURL
curl --location 'https://api.anar360.com/api/360/products?page=1&limit=1' \ --header 'Authorization: Bearer YOUR_TOKEN'
اطلاعات یک محصول
برای دریافت اطلاعات یک محصول کافیست id محصول را در انتهای API پای دهید.
curl --location 'https://api.anar360.com/api/360/products/678e2cdbadb8bc5dabae0dc4' \ --header 'Authorization: Bearer YOUR_TOKEN'
پاسخ برگشتی
درصورتی که محصولاتی در پنل انار اضافه کرده باشید و توکن معتبر را در header بفرستید پاسخی مشابه زیر با وضعیت 200 دریافت می‌کنید :
{
{
"total": 521,
"skip": 0,
"limit": 1,
"items": [
{
"id": "66f809ced44631957f13d86f",
"title": "شامپو پاک کننده و ضد شوره دمودکسیلین",
"description": "\"کمک به بهبود شوره سر\n \n تعدیل چربی پوست سر\n \n ضد خارش پوست سر\n مناسب برای انواع مو\n جلوگیری از نازکی و ریزش مو\n دارای ترکیبات گیاهی ضد میکروبی (ضد انگل، ضد باکتری، ضد قارچ)\"",
"mainImage": "https://s3.c22.wtf/anar360.com/6ea1460b-0a62-4aca-961d-26cd881a84ff.jpg",
"images": [
{
"src": "https://s3.c22.wtf/anar360.com/6ea1460b-0a62-4aca-961d-26cd881a84ff.jpg",
"thumbnail": "",
"_type": "image",
"main": false,
"_id": "66fa570ca37e2c3599e4b9cd"
}
],
"isReseller": false,
"attributes": [],
"brands": [],
"categories": [
{
"_id": "66b22b05924f1297d90f356e",
"name": "شامپو",
"attributeIds": [],
"type": "retail",
"order": 0,
"level": "last",
"parent": "66b22b05924f1297d90f356b",
"route": [
"زیبایی و سلامت",
"لوازم بهداشتی",
"شامپو و مراقبت مو",
"شامپو"
],
"createdAt": "2024-08-06T13:54:13.219Z",
"updatedAt": "2024-10-05T15:28:12.659Z",
"__v": 0
}
],
"createdAt": "2024-09-28T13:51:10.213Z",
"updatedAt": "2024-10-20T08:02:13.843Z",
"status": "active",
"type": "retail",
"resellStatus": "accepted",
"shipmentsReferenceId": "66be764e1341a55421ac2efc",
"shipmentsReferenceState": "تهران",
"shipmentsReferenceCity": "تهران",
"shipments": [
{
"type": "insideShopCity",
"delivery": [
{
"deliveryType": "bike",
"price": 95000,
"estimatedTime": "ارسال ۱ روزه (سفارشاتی که تا قبل از ساعت ۱۷ ثبت شوند روز کاری بعد ارسال میشوند)",
"freeCondition": {
"purchasesPrice": 5000000
},
"active": true,
"_id": "66be76761341a55421ac3149"
},
{
"deliveryType": "post",
"price": 45000,
"estimatedTime": "سفارشاتی که قبل از ساعت 15:15 هر روز ثبت شوند ساعت 14:00 روز کاری بعدی جهت ارسال تحویل پست و بین 1 الی 3 روز بعد تحویل مشتری می شوند",
"freeCondition": {
"purchasesPrice": 0
},
"active": true,
"_id": "66be76761341a55421ac314a"
},
{
"deliveryType": "express",
"price": 75000,
"estimatedTime": "تحویل تمام ایران دو روز پس از ثبت سفارش",
"freeCondition": {
"purchasesPrice": 0
},
"active": true,
"_id": "66be76761341a55421ac314b"
},
{
"deliveryType": "tipax",
"price": 50000,
"estimatedTime": "یک روز کاری",
"freeCondition": {
"purchasesPrice": 0
},
"active": false,
"_id": "66be76761341a55421ac314c"
},
{
"deliveryType": "chapar",
"price": 50000,
"estimatedTime": "یک روز کاری",
"freeCondition": {
"purchasesPrice": 0
},
"active": false,
"_id": "66be76761341a55421ac314d"
}
],
"active": true,
"_id": "66be76761341a55421ac3148"
},
{
"type": "insideShopState",
"delivery": [
{
"deliveryType": "post",
"price": 45000,
"estimatedTime": "سفارشاتی که قبل از ساعت 15:15 هر روز ثبت شوند ساعت 14:00 روز کاری بعدی جهت ارسال تحویل پست و بین 1 الی 3 روز بعد تحویل مشتری می شوند",
"freeCondition": {
"purchasesPrice": 0
},
"active": true,
"_id": "66be76761341a55421ac314f"
},
{
"deliveryType": "express",
"price": 75000,
"estimatedTime": "تحویل تمام ایران دو روز پس از ثبت سفارش",
"freeCondition": {
"purchasesPrice": 0
},
"active": true,
"_id": "66be76761341a55421ac3150"
},
{
"deliveryType": "tipax",
"price": 70000,
"estimatedTime": "بین 2 الی 3 روز کاری",
"freeCondition": {
"purchasesPrice": 0
},
"active": false,
"_id": "66be76761341a55421ac3151"
},
{
"deliveryType": "chapar",
"price": 70000,
"estimatedTime": "بین 2 الی 3 روز کاری",
"freeCondition": {
"purchasesPrice": 0
},
"active": false,
"_id": "66be76761341a55421ac3152"
},
{
"deliveryType": "bike",
"price": 95000,
"estimatedTime": "ارسال ۱ روزه (سفارشاتی که تا قبل از ساعت ۱۷ ثبت شوند روز کاری بعد ارسال میشوند)",
"freeCondition": {
"purchasesPrice": 5000000
},
"active": true,
"_id": "6703ad810e08eb1efc885dec"
}
],
"active": true,
"_id": "66be76761341a55421ac314e"
},
{
"type": "otherStates",
"delivery": [
{
"deliveryType": "post",
"price": 45000,
"estimatedTime": "سفارشاتی که قبل از ساعت 15:15 هر روز ثبت شوند ساعت 14:00 روز کاری بعدی جهت ارسال تحویل پست و بین 2 الی 4 روز بعد تحویل مشتری می شوند",
"freeCondition": {
"purchasesPrice": 0
},
"active": true,
"_id": "66be76761341a55421ac3154"
},
{
"deliveryType": "express",
"price": 75000,
"estimatedTime": "تحویل تمام ایران دو روز پس از ثبت سفارش",
"freeCondition": {
"purchasesPrice": 0
},
"active": true,
"_id": "66be76761341a55421ac3155"
},
{
"deliveryType": "tipax",
"price": 80000,
"estimatedTime": "بین 3 الی 4 روز کاری",
"freeCondition": {
"purchasesPrice": 0
},
"active": false,
"_id": "66be76761341a55421ac3156"
},
{
"deliveryType": "chapar",
"price": 80000,
"estimatedTime": "بین 3 الی 4 روز کاری",
"freeCondition": {
"purchasesPrice": 0
},
"active": false,
"_id": "66be76761341a55421ac3157"
},
{
"deliveryType": "bike",
"price": 95000,
"estimatedTime": "ارسال ۱ روزه مخصوص کرج (سفارشاتی که تا قبل از ساعت ۱۷ ثبت شوند روز کاری بعد ارسال میشوند)",
"freeCondition": {
"purchasesPrice": 5000000
},
"active": true,
"_id": "6703ad810e08eb1efc885df2"
}
],
"active": true,
"_id": "66be76761341a55421ac3153"
}
],
"variants": [
{
"_id": "670a17154069dbabe2cb9f04",
"attributes": {},
"stock": 4,
"price": 237300,
"priceForResell": 237300,
"isReseller": true,
"resellCreatedAt": "2024-09-28T13:53:34.103Z",
"resellUpdatedAt": "2024-10-20T08:02:14.072Z",
"resellStatus": "accepted",
"resellerProfit": 0,
"sellerDiscount": 0,
"type": "retail"
}
]
}
]
}
| total | کل محصولاتی که در پنل انار اضافه کرده اید | |
| skip | تعداد محصول در صفحه قبل | |
| limit | تعداد محصول در یک صفحه | |
| items | لیست محصولات | |
| id | شناسه محصول | |
| title | عنوان محصول | |
| description | توضیحات محصول(حاوی کاراکترهای html) | |
| mainImage | تصویر اصلی محصول | |
| images | آرایه ایی از تصاویر گالری محصول | |
| attributes | لیست ویژگی های محصول | |
| categories | لیست دسته بندی های محصول | |
| variants | ورینت های محصول |
- در انار ورینت های محصول به فروش می رسند. لازم است به ازای هر ورینت در آرایه variants یک محصول مجزا داشته باشید یا محصول متغیر بر اساس این ورینت ها بسازید.
- پارامترهای shipment اطلاعات حمل و نقل محصول است که در بخش ثبت سفارش به این اطلاعات نیاز خواهید داشت.
- تصاویری که در انار بارگزاری شده اند با پیشوند https://s3.c22.wtf/ برگردادنده میشوند. در صورتی که سرور شما با این دامنه مشکل داشته باشد تصاویر دریافت نمی‌شوند که می توانید به
https://s3.anar360.com/_img/width_1024/https://s3.anar360.com/
تغییر دهید
دسته بندی محصولات
محصولات در انار، دسته‌بندی مختص به خود را دارا هستند. لازم است که این دسته‌بندی‌ها با دسته‌بندی‌های داخل وبسایت شما مپ شوند. از این جهت، تمام دسته‌بندی‌های محصولاتی که در پنل انار شما افزوده شده است در یک api جداگانه به شما داده شده است.
API با متد GET فراخوانی می شود.
https://api.anar360.com/api/360/categories
پارامترهای ورودی
| page | شماره صفحه |
| limit | تعداد دسته بندی در هر صفحه |
پارامترهای page و limit مشابه API محصولات عمل می کند.
نمونه فراخوانی با cURL
curl --location 'https://api.anar360.com/api/360/categories?page=1&limit=25' \ --header 'Authorization: Bearer YOUR_TOKEN'
نمونه پاسخ برگشتی
{
"total": 68,
"skip": 0,
"limit": 2,
"items": [
{
"_id": "64ac6b76878e92615233f03b",
"name": "کفش زنانه و مردانه",
"attributeIds": [
"64008cca64332f981a2908a4",
"64008cca64332f981a2908a7",
"64008cca64332f981a2908aa",
"64008cca64332f981a2908ad",
"64008cca64332f981a2908a4"
],
"type": "retail",
"level": "hasChildren",
"parent": "64ac6b76878e92615233f036",
"route": [
"مد و پوشاک",
"زنانه و مردانه",
"کفش زنانه و مردانه"
],
"createdAt": "2023-07-10T20:35:02.131Z",
"updatedAt": "2024-10-05T15:28:12.659Z",
"__v": 0,
"order": 0,
"key": "Women's and men's shoes"
},
{
"_id": "655e8abcb595023e89a09422",
"name": "سایر لوازم جانبی موبایل و تبلت",
"attributeIds": [
"64008cca64332f981a2908a4",
"64008cca64332f981a2908a7",
"64008cca64332f981a2908aa",
"64008cca64332f981a2908ad",
"64008cca64332f981a2908a4"
],
"type": "retail",
"order": 0,
"key": "Other mobile and tablet accessories",
"level": "hasChildren",
"parent": "65537d17e5689abc14616b7e",
"route": [
"کالای دیجیتال",
"لوازم جانبی موبایل",
"سایر لوازم جانبی موبایل و تبلت"
],
"createdAt": "2023-11-22T23:11:56.678Z",
"updatedAt": "2024-10-05T15:28:12.659Z",
"__v": 0
}
]
}
ویژگی های محصولات
محصولات در انار، ویژگی های مختص به خود را دارا هستند و محصولات متغییر بر اساس این ویژگی ها ساخته می شوند. لازم است که این ویژگی ها با ویژگی های داخل وبسایت شما مپ شوند. از این جهت، تمام ویژگی های محصولاتی که در پنل انار شما افزوده شده است در یک api جداگانه به شما داده شده است.
API با متد GET فراخوانی می شود.
https://api.anar360.com/api/360/attributes
پارامترهای ورودی
| page | شماره صفحه |
| limit | تعداد ویژگی در هر صفحه |
پارامترهای page و limit مشابه API محصولات عمل می کند.
نمونه فراخوانی با cURL
curl --location 'https://api.anar360.com/api/360/attributes?page=1&limit=25' \ --header 'Authorization: Bearer YOUR_TOKEN'
نمونه پاسخ برگشتی
{
"total": 4,
"skip": 0,
"limit": 2,
"items": [
{
"key": "جنس",
"name": "جنس",
"values": [],
"count": 0
},
{
"key": "رنگ",
"name": "رنگ",
"values": [
"وودو",
"کرم سبز قرمز",
"کرم آبی سفید",
"ونوم",
"موینگ بلک",
"سفید سبز کرم",
"پی آر ام شتری",
"اشبالت کرم",
"سفید",
"مشکی"
],
"count": 0
}
]
}
سفارشات
ساخت سفارش
API با متد POST فراخوانی می شود.
https://api.anar360.com/api/360/orders
پارامترهای ورودی
پارامترهای ورودی با فرمت استاندارد json در body ریکوئست ارسال می شود.
{
"type": "retail", // این پارامتر را تغییر ندهید
"items": [
{
"variation": "67bf1113116619971be3405b",
"amount": 1,
"info": {} // خالی بگذارید
},
{
"variation": "67bf1113116619971be3405a",
"amount": 2,
"info": {}
}
],
"address": {
"postalCode": "9891600111",
"detail": "خیابان اول کوچه دوم پلاک ۱",
"transFeree": "علی محمدی",
"transFereeMobile": "+98111111111"
"city":"تهران",
"province":"تهران"
},
"shipments": [
{
"shipmentId": "66be76761341a55421ac314e",
"deliveryId": "66be76761341a55421ac3150",
"shipmentsReferenceId": "66be764e1341a55421ac2efc",
"description": ""
},
{
"shipmentId": "66be76761341a55421ac314f",
"deliveryId": "66be76761341a55421ac3151",
"shipmentsReferenceId": "66be764e1341a55421ac2efd",
"description": ""
}
]
}
| items | در انار ورینت ها به عنوان محصول فروخته می شوند. بعضی محصولات یک ورینت دارند (محصول ساده) و بعضی بیشتر (محصول متغیر). اطلاعات ورینت ها زیر کلید variants در رسپانس محصولات قرار گرفته است. | |
| | | variation | مقدار _id برای هر تنوع محصول زیر کلید variants در اطلاعات محصولات وجود دارد. |
| | | amount | تعداد |
| address | اطلاعات آدرس خریدار را بطور کامل ارسال کنید. کلیه فیلدها ضروری است. | |
| | | postalCode | کد پستی خریدار |
| | | detail | آدرس خریدار |
| | | transFeree | نام کامل خریدار |
| | | transFereeMobile | شماره موبایل خریدار |
| | | city | نام شهر |
| | | state | نام استان |
| shipments | اطلاعات حمل و نقل آرایه ایی از اطلاعات مرسوله هاست. اگر بیشتر از ۱ نوع محصول در سبد دارید باید بررسی کنید که این محصولات توسط چه تامین کننده هایی قرار است ارسال شود. | |
| | | shipmentId | شناسه ناحیه حمل و نقل. این مقدار در اطلاعات هر محصول وجود دارد |
| | | deliveryId | شناسه متد حمل و نقل. این مقدار در اطلاعات هر محصول وجود دارد |
| | | shipmentsReferenceId | شناسه تامین کننده. این مقدار در اطلاعات هر محصول وجود دارد |
| | | description | توضیحات خریدار |
نکته در مورد حمل و نقل:
1️⃣ هر محصول یک تامین کننده دارد که شناسه تامین کننده با کلید یکتای shipmentsReferenceId در اطلاعات هر محصول قرار گرفته است و بر اساس این کلید می توانید آیتم های سفارش را بررسی کنید و تعداد مرسوله ها را محاسبه کنید.
2️⃣ هر تامین کننده چند ناحیه حمل و نقل تعریف کرده است که هر ناحیه (مثلا داخل شهر تامین کننده، داخل استان تامین کننده) با شناسه shipmentId تفکیک می شود.
3️⃣ هر ناحیه حمل و نقل تعدادی متد حمل و نقل دارد که با شناسه deliveryId تفکیک می شوند.
4️⃣ بعضی متدها ممکن است موقتا توسط تامین کننده غیر فعال شده باشند. باید کلید active را برای هر متد حمل و نقل چک کنید و اگر true بود نمایش دهید.
پاسخ برگشتی
✅ در صورتی که ثبت سفارش موفقیت آمیز باشد اطلاعات مرسوله ها (سفارش ها) را با رسپانس کد 200 دریافت می کنید
❗ در صورتی که مشکلی در اطلاعات ارسالی وجود داشته باشد کد خطای 400 را با توضیح خطا دریافت می کنید.
اطلاعات همه سفارش ها
هر سفارش در واقع یک مرسوله می باشد. با ثبت سفارش در مرحله قبل ممکن است چند سفارش ایجاد شود که هر سفارش مربوط به یک مرسوله می باشد.
API با متد GET فراخوانی می شود.
https://api.anar360.com/api/360/orders
اطلاعات یک سفارش
در صورتی که میخواهید اطلاعات یک سفارش را دریافت کنید کافیست _id سفارش مورد نظر را در انتهای API پاس دهید.
https://api.anar360.com/api/360/orders:_id
راهکارها
همگام سازی اطلاعات قیمت و موجودی
یکی از مهمترین فرآیندهایی که لازم است مورد توجه قرار بگیرید همگام سازی اطلاعات قیمت و موجودی محصولات است.
سینک قیمتقیمت محصولات به دلایل مختلفی (مثلا تغییر توسط تامین کننده، تغییر سیاست های قیمت گذاری) ممکن است تغییر کند. پس لازم است در لحظه ایی که سفارش ثبت می شود حتما قیمت محصول با انار یکسان باشد.
سینک موجودیبا توجه به ماهیت دراپ شیپینگ و وجود تخفیف ها و کمپین ها احتمال اتمام موجودی در لحظه ایی که خریدار قصد ثبت سفارش را دارد محتمل است. پس لازم است حتما علاوه بر قیمت موجودی نیز در لحظه ثبت سفارش چک شود.
یکی از موثر ترین راهکارها برای بروزرسانی قیمت و موجودی، سینک کردن اطلاعات محصول در لحظه ای که صفحه محصول بازدید می شود یا در هنگام افزودن به سبد خرید می باشد.
استراتژی های همگام سازی قیمت و موجودی با توجه به منابع و پلتفرم شما کاملا به خودتان بستگی دارد و اجبار به استفاده از راهکار ثابتی وجود ندارد.
مپ کردن دسته بندی ها (categories)
همه محصولات انار دارای دسته بندی مختص به خود هستند ولی با توجه به اینکه ممکن است بعضی از دسته بندی ها عنوان یکسان نداشته باشند ولی از دید شما یک می توانند یک دسته در نظر گرفته شوند و یا دسته بندی هایی از انار وجود داشته باشند که دسته بندی مشابه آن از قبل در فروشگاه شما موجود باشد لازم است عمل مپ کردن یا انتخاب دسته بندی های متناظر توسط شما انجام شود. به عنوان مثال ممکن است یک دسته بندی با نام کالای دیجیتال در دسته بندی های انار موجود باشد ولی در وب سایت شما همین دسته بندی با نام دیجیتال از قبل وجود داشته باشد. در این صورت لازم است قبل از ساخت محصولات این دو دسته را به نحوی به همدیگر مپ کنید و در هنگام ساختن محصولات هر گاه محصولی با دسته بندی کالای دیجیتال داشتیم در دسته بندی دیجیتال از فروشگاه خود قرار دهید. برای این منظور می توانید از API دسته بندی محصولات استفاده کنید که لیست کل دسته بندی محصولاتی که در پنل انار خود اضافه کرده اید را بر می گرداند.مپ کردن ویژگی‌ها (attributes)
در صورتی که در فروشگاه خود مفهومی مشابه ویژگی محصول در انار دارید می توانید از API ویژگی محصولات استفاده کنید و لیست ویژگی های محصولاتی که در پنل انار خود اضافه کرده اید را دریافت کنید. بیشتر محصولات انار متغیر هستند، یعنی چند ویژگی دارند و قیمت و موجودی محصول بر اساس این ویژگی ها تغییر می کند. ترکیب این ویژگی ها یک متغیر یا Variant می سازد. اگر رسپانس API محصولات انار را چک کنید خواهید دید هر محصول شامل چند variant است که هر variant یک id منحصر به فرد دارد و در واقع ما variant ها را در انار می فروشیم. مثال : محصول x دو ویژگی سایز و رنگ دارد. برای ویژگی سایز ۲ مقدار بزرگ و متوسط داریم و برای ویژگی رنگ ۲ مقدار سبز و قرمز داریم. پس در واقع محصول ما ۴ متغیر یا variant زیر را دارد:- بزرگ - سبز
- بزرگ - قرمز
- متوسط - سبز
- متوسط - قرمز