לאחרונה פנתה אלינו חנות מוצרי חשמל מאלמטי. היה להם קטלוג ב-1C-Bitrix עם מחירים בדולרים, אבל הם היו צריכים לרשום ב-Satu.kz בטנגה. ייצוא ידני של מחירון לקח חצי יום מדי יום, והזמנות אבדו. הקמנו אינטגרציה אוטומטית תוך שבועיים. עכשיו הפיד מתעדכן כל שעה, הזמנות זורמות ישירות ל-CRM, וההמרה עלתה ב-25%. במאמר זה נפרק את מרכיבי האינטגרציה וכיצד להימנע ממלכודות נפוצות.
פורמט הפיד של Satu.kz
Satu.kz מקבל פידים בפורמט YML (Yandex Market Language). המבנה הבסיסי זהה ל-YML הסטנדרטי, אבל המחירים חייבים להיות בקפדנות בטנגה קזחסטני (KZT). זה קריטי: גם אם הקטלוג שלכם שומר מחירים ב-USD, הפיד המוצא צריך המרה.
שדות חובה להצעות:
-
<url>— כתובת URL של דף המוצר באתר שלכם -
<price>— מחיר ב-KZT -
<currencyId>KZT</currencyId> -
<categoryId>— מזהה קטגוריה מהעץ שלכם (מצוין בבלוק<categories>) -
<name>— שם המוצר -
<available>— זמינות
פרמטרים נוספים <param> לקטגוריות ספציפיות מגבירים את הקליקיות של הצעות בתוצאות הסינון. יש למלא אותם עבור מוצרים עם מידות, צבעים או מאפיינים אחרים.
הגדרת המרת מטבע עבור פיד Satu.kz
אם החנות מנהלת מחירים בדולרים, הפיד צריך המרה ל-KZT. שער הבנק הלאומי של קזחסטן (NBK) מתפרסם דרך RSS פתוח: https://nationalbank.kz/rss/rates_all.xml. סוכן Bitrix מבקש את השער פעם ביום, שומר אותו ב-b_catalog_currency, ומשתמש בו בעת הפקת הפיד.
ב-b_catalog_currency, הוסיפו את מטבע KZT והגדירו עדכוני שער חליפין. בעת הפקת הפיד, קחו את המחיר מ-b_catalog_price והמירו באמצעות \Bitrix\Currency\CurrencyManager::convertCurrency(). עבור קטלוג של 10,000 מוצרים, ההפקה אורכת לא יותר מ-2 דקות.
API של Satu.kz להזמנות
פלטפורמת EVO מספקת REST API לניהול הזמנות. כתובת בסיס: https://satu.kz/api/v1/. אימות: טוקן חנות בכותרת token: {your_token}.
מתודות עיקריות:
-
GET /orders/— רשימת הזמנות (סינון לפי סטטוס, תאריך) -
GET /orders/{id}/— פרטי הזמנה -
POST /orders/{id}/update-shipping/— עדכון סטטוס משלוח
הזמנות שבוצעו דרך Satu.kz נוצרות ב-b_sale_order ב-Bitrix. נתוני לקוח מהזמנת Satu ממופים לשדות b_sale_order_props. מזהה הזמנת Satu נשמר בשדה הזמנה מותאם אישית למשוב בעת עדכון סטטוסים.
טעות אופיינית היא אי-טיפול באישור תשלום. אם הזמנה שולמה ב-Satu.kz, ה-API שולח סטטוס paid. בצד Bitrix, יש להגדיר את דגל התשלום ב-b_sale_order ואם צריך, להפעיל תהליך עסקי. אוטומציה חוסכת עד 40 שעות בחודש בעיבוד הזמנות.
למה מיפוי קטגוריות הוא קריטי
עץ הקטגוריות של Satu.kz שונה ממבנה הקטלוג באתר שלכם. ללא טבלת מיפוי (קטגוריית Bitrix שלכם → קטגוריית Satu.kz), מוצרים מגיעים לסעיפים לא מתאימים והולכים לאיבוד בסינונים. זה משפיע ישירות על נראות ומכירות. המיפוי מיושם דרך HL-block או טבלת מסד נתונים נפרדת.
השוו בין שתי גישות:
| גישה | זמן הגדרה | דיוק קטגוריות | תחזוקה |
|---|---|---|---|
| מיפוי ידני | 1-2 ימים עבור 5000 SKU | 80-90% | שגיאות תכופות עם קטגוריות חדשות |
| מיפוי אוטומטי דרך HL-block | 3-5 ימים | 95%+ | מתעדכן דרך CRM לפי בקשה |
מיפוי אוטומטי מספק 15% יותר ביקורים בדפי מוצר, לפי המדידות שלנו.
הפקת פיד ב-Bitrix
סוכן רץ כל שעה ומפיק את קובץ ה-XML:
// Получение товаров с остатком
$res = \Bitrix\Iblock\ElementTable::getList([
'filter' => ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y'],
'select' => ['ID', 'NAME', 'CODE', 'DETAIL_PAGE_URL'],
]);
// Для каждого товара получаем цену и остаток
// b_catalog_price JOIN b_catalog_product
// Конвертируем цену в KZT
// Формируем XML-оффер
הקובץ נשמר ב-// Получение товаров с остатком $res = \Bitrix\Iblock\ElementTable::getList([ 'filter' => ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y'], 'select' => ['ID', 'NAME', 'CODE', 'DETAIL_PAGE_URL'], ]); // Для каждого товара получаем цену и остаток // b_catalog_price JOIN b_catalog_product // Конвертируем цену в KZT // Формируем XML-оффер . כתובת הפיד נרשמת בחשבון האישי של Satu.kz. ניתן לאמת תקינות באמצעות הוולידטור המובנה של הפלטפורמה.
הערה מיוחדת: ביקורות ודירוגי מוצרים
Satu.kz מצרפת ביקורות לקוחות. דירוג החנות משפיע על מיקום ברשימות. אינטגרציה לא מנהלת ביקורות ישירות, אבל עיבוד הזמנות בזמן (מלאי מדויק, סטטוסים נכונים) מפחית משוב שלילי. ניסיון מראה שחנויות עם עיבוד הזמנות מהיר מקבלות בממוצע דירוג גבוה ב-15%.
מה כלול בעבודת האינטגרציה?
במסגרת הפרויקט, אנו מספקים:
- הגדרת פיד YML עם המרת KZT ומיפוי קטגוריות.
- אינטגרציית REST API לשליפת ועדכון הזמנות.
- בדיקות על נתונים אמיתיים: לפחות 100 הזמנות לאימות.
- תיעוד על סוכנים ונוהל עדכון שער חליפין.
- תמיכה ל-30 יום לאחר ההשקה.
תקציב האינטגרציה נע בין 100,000 ל-300,000 טנגה, תלוי בגודל הקטלוג ובמורכבות הלוגיקה. נחשב את העלות המדויקת לאחר ביקורת על הפרויקט שלכם.
הערכות זמנים
| משימה | משך |
|---|---|
| הגדרת פיד YML עם המרת KZT | 3–7 ימים |
| + אינטגרציית API לשליפת הזמנות | 1–2 שבועות |
| אינטגרציה מלאה עם מיפוי קטגוריות וניטור | 2–3 שבועות |
העלות מחושבת באופן אישי לאחר ניתוח מבנה הקטלוג ונפח ה-SKU. קבלו ייעוץ: צרו קשר כדי להעריך את הפרויקט שלכם.
אנו מבטיחים עיבוד נכון של פיד והזמנות. צרו קשר כדי לדון בפרטים.