הסבר על ה API במערכת המירקל:
יצירת מוצרים במירקל דרך ה-API (seller mode)
מקור:
כדי לייבא מוצרים למירקל, יש להוריד קובץ תבנית לפי הקטגוריות הרצויות, למלא את שדות החובה שלו (רצוי למלא גם את האופציונליים), להעלות למירקל באמצעות הממשק או הAPI, במידה ויש שגיאות - ניתן להוריד קובץ שגיאות, במידה ואין - סטטוס הקובץ יהפוך ל"בתהלכי עבודה" עד לאישור האופרטור וסיום תהליך הDDP.
במידה והמוצר לא קיים בקטלוג ואין שגיאות בקובץ והאופרטור מאשר את הוספת המוצר - המוצר יתווסף לקטלוג.
בדיקה אם המוצרים להוספה כבר קיימים בקטלוג:
במידה והמוצר לא קיים בקטלוג ואין שגיאות בקובץ והאופרטור מאשר את הוספת המוצר - המוצר יתווסף לקטלוג.
בדיקה אם המוצרים להוספה כבר קיימים בקטלוג:
P31 Endpoint url: {{URL}}/api/products
Request:
Type: GET
Headers:
Authorization: {{shop_key}} // מפתח API
Quary Parameter: product_references// רשימת המוצרים בפורמט productIdType|productId
product_references= רשימת המוצרים בפורמט productIdType|productId,productIdType|productId
productIdType - ערכים אפשריים : EAN,SKU,SHOP_SKU
SKU - The offer’s unique identifier in the store.
final url:
{{URL}}/api/products?product_references=EAN|66D2KAC6IS,EAN|1068260
Json תשובה:
{
"products": [
{
"category_code": "C-PCDesktop",
"category_label": "מחשבים נייחים",
"product_id": "66D2KAC6IS",
"product_id_type": "EAN",
"product_sku": "2142_112",
"product_title": "מסך LENOVO 66D2KAC6IS"
}
],
"total_count": 1
}
יצירת מוצרים במירקל מתבצעת ע"י העלאת קובץ csv / excel דרך API של מירקל
את תבנית הקובץ ניתן להוריד בלינק: (seller mode)
בתפריט "בחר קובץ להורדה" יש לבחור מוצרים או מוצרים והצעות יחד.
בחר את רמת הדרישה - לפי נוחות המשתמש
בחר/י את הקטגוריות - יש לבחור את הקטגוריות הרצויות
יש לבחור את השפה הרצויה וללחוץ על צור תבנית
יש לגלול לראש העמוד, שם ניתן לראות את הקובץ להורדה ברגע שיהיה מוכן.
בפתיחת האקסל, יש לאפשר עריכה.
בלחיצה על התא מתחת לקטגוריה - יש לבחור את הקטגוריה הרצויה מתוך הרשימה
לאחר הבחירה יצבעו התאים: אדום - שדה חובה, צהוב - שדה רשות.
בלחיצה על כל תא יופיע הסבר של מירקל:
במידה ונבחרה תבנית עבור מוצרים והצעות יחד, שורת הכותרת תחולק ל2 צבעים: ירוק - מאפייני המוצר, כחול - מאפייני ההצעה
העלאת הקובץ דרך הAPI:
P41 Endpoint url : {{URL}}/api/products/import
Mirakl documentation: {{URL}}/help/help/api-doc/seller/mmp.html?#P41
יש לקחת Api Key מהאיזור אישי של המוכר כדי להשתמש בAPI.
יש ללחוץ על שם המשתמש בצד ימין למעלה של המסך, יפתח האזור האישי, יש ללחות על הטאב מפתח API, ובתוכו יש ללחוץ על העתק ללוח, אם לא קיים מפתח - יש ללחוץ על צור/י:
Request:
Type: POST
Headers:
Authorization: {{shop_key}} // מפתח API
Content-Type: multipart/form-data
Body:
file // במשתנה זה יש לשים את הקובץ המלא
במידה והבקשה הצליחה, יתקבל חזרה ממירקל מס' סידורי כדי לעקוב אחר ייבוא הקובץ: "import_id": 2178
במידה ויש שגיאה בקובץ, ניתן להוריד בממשק מירקל קובץ עם הסבר על השגיאות:
יש ללחוץ על המלאי שלי -> ייבא מקובץ -> עקוב אחר ייבואי מוצרים, בשורת הקובץ לחץ יש ללחוץ על הכפתור הורד דוח שגיאת המרה:
במידה והקובץ תקין - הסטטוס יהיה בתהליכי עבודה, עד לאישור האופרטור (ZAP)
אפשר לעקוב אחרי העלאת הקובץ בממשק מירקל, ודרך הAPI.
מעקב קובץ ייבוא בממשק מירקל:
יש ללחוץ על המלאי שלי -> ייבא מקובץ -> עקוב אחר ייבואי מוצרים:
מעקב קובץ ייבוא ע"י הAPI:
Mirakl documentation: https://zapgroupil-dev.mirakl.net/help/help/api-doc/seller/mmp.html?#P42
P42 Endpoint url: {{URL}}/api/products/imports/:import
Request:
Type: GET
Headers:
Authorization: {{shop_key}} // מפתח API
Quary Parameter: import_id // המס’ הסידורי שהתקבל בP41
final url:
{{URL}}/api/products/imports/2178
הJSON שיתקבל:
}
"date_created": "2022-10-27T06:06:56Z",
"has_error_report": false,
"has_new_product_report": false,
"has_transformation_error_report": false,
"has_transformed_file": true,
"import_id": 2178,
"import_status": "SENT",
"shop_id": 2142,
"transform_lines_in_error": 0,
"transform_lines_in_success": 1,
"transform_lines_read": 1,
"transform_lines_with_warning": 0
{
הורדת קובץ שגיאות עבור קובץ ייבוא מוצרים שנכשל:
אפשר לגשת לפנק' זו רק עבור מס' יבוא שבP42 השדה has_transformation_error_report = true.
P44 Endpoint url: {{URL}}/api/products/imports/:import_id/error_report
Mirakl documentation: https://zapgroupil-dev.mirakl.net/help/api-doc/seller/mmp.html#P44
Request:
Type: GET
Headers:
Authorization: {{shop_key}} // מפתח API
Quary Parameter: import_id // המס’ הסידורי שהתקבל בP41
final url:
{{URL}}/api/products/imports/2179/error_report