מחברים
חיבור Priority
מה Synca קוראת מ-Priority, מה היא כותבת אליו, אילו פרטים צריך כדי להתחבר — ומה החיבור לא עושה.
Priority הוא ה-ERP שממנו הקטלוג של Synca מתחיל: הפריטים, המחירים והמלאי נכנסים ממנו לקטלוג, ומשם מתפרסמים לאתרים ולמרקטפלייסים. בכיוון ההפוך, הזמנות שנקלטו מהחנויות משודרות אליו כהזמנות לקוח — בלחיצה מדף ההזמנה.
מה צריך מכם
Synca מתחברת ל-REST API של Priority (OData) עם שם משתמש וסיסמה. בקשו ממנהל ה-Priority שלכם:
- משתמש ייעודי ל-Synca עם גישה ל-REST API. משתמש נפרד מאפשר לזהות בקלות מה Synca עשתה, ולבטל לה את הגישה בלי לפגוע באף אחד אחר.
- פרטי השרת: כתובת השרת, שם החברה, ושם קובץ ה-tabula.ini אם הוא שונה מברירת המחדל.
המשתמש צריך הרשאות לשני טפסים בלבד:
| טופס ב-Priority | הרשאה | בשביל מה |
|---|---|---|
LOGPART (פריטים), כולל תתי-הטפסים של היתרות והמחירונים | קריאה | ייבוא מוצרים, מחירים ומלאי |
ORDERS (הזמנות לקוח), כולל שורות ההזמנה וכתובת המשלוח | כתיבה | שידור הזמנות |
הזנת החיבור
את הפרטים אפשר למסור לצוות של Synca בזמן ההקמה, או להזין בעצמכם: חיבורים ← הוספת חיבור ← Priority ERP. השדות בטופס:
| שדה | מה למלא |
|---|---|
Server URL | כתובת שרת ה-Priority, לדוגמה https://priority.company.com |
Username, Password | המשתמש הייעודי של Synca |
Company Database | שם החברה ב-Priority |
Tabula.ini File | רשות — רק אם הקובץ אינו tabula.ini |
Language Code | רשות |
שמירת החיבור לא פונה ל-Priority, ולכן טעות בפרטים מתגלה רק בריצה הראשונה שמשתמשת בו. הכשל יופיע במסך פעילות סנכרון.
מה נכנס מ-Priority לקטלוג
ייבוא המוצרים קורא את טופס הפריטים ומעדכן את הקטלוג:
| בקטלוג של Synca | מ-Priority |
|---|---|
| מק״ט | PARTNAME |
| שם ותיאור | PARTDES |
| ברקוד | BARCODE |
| קטגוריה | FAMILYDES (משפחת הפריט) |
| סטטוס | STATDES — “פעיל” נכנס כפעיל, כל ערך אחר כלא פעיל |
| מחיר | VATPRICE — מחיר המחירון הבסיסי כולל מע״מ, במטבע שלו |
| מלאי | SELLBALANCE — היתרה הזמינה למכירה |
- מחירון אחר או מלאי לפי מחסנים. ברירת המחדל היא המחיר הבסיסי והיתרה הזמינה למכירה. אם המחיר לחנויות מגיע אצלכם ממחירון מסוים, או שהמלאי צריך להיות סכום של מחסנים — הצוות של Synca מגדיר זאת במיפוי של החיבור שלכם.
- מתי. הייבוא רץ לפי תזמון שהצוות של Synca קובע. כל ריצה קוראת את כל הפריטים, ומוצר שלא השתנה מאז הריצה הקודמת מדולג.
- פריט אחד, מוצר אחד. Priority מחזיר פריט ולא מטריצת וריאנטים, ולכן כל פריט נכנס כמוצר עם וריאנט אחד.
- בלי תמונות. תמונות לא מגיעות מ-Priority.
- מוצר ידני עם אותו מק״ט. אם יצרתם ב-Synca מוצר ידני עם מק״ט של פריט מ-Priority, הפריט לא ייכנס, והריצה תדווח עליו. מוחקים את המוצר הידני או משנים את המק״ט שלו, והריצה הבאה תכניס את הפריט.
שידור הזמנה ל-Priority
בדף ההזמנה לוחצים שדר ל-ERP, ובחלון שליחה ל-ERP — שליחה. Synca פותחת ב-Priority הזמנת לקוח אחת:
| בהזמנה ב-Priority | מה נכנס |
|---|---|
CUSTNAME | מספר לקוח קבוע שנקבע בהקמה — כל ההזמנות נפתחות עליו |
REFERENCE | מספר ההזמנה בחנות |
DETAILS | הערות המשלוח |
| שורות ההזמנה | מק״ט (PARTNAME), כמות (TQUANT) ומחיר ליחידה (PRICE) |
| כתובת המשלוח | שם הנמען, טלפון, מייל וכתובת |
שדות חובה אחרים של Priority, שאין להם מקור בהזמנה, מקבלים ערך קבוע שנקבע בהקמה. אפשר גם לוותר על שליחת המחיר, כך ש-Priority יתמחר את השורות לפי המחירון שלו.
כש-Priority מאשר, Synca שומרת את מספר ההזמנה שלו (ORDNAME) ומציגה אותו בדף ההזמנה תחת מספר הזמנה ב-ERP.
- בלחיצה בלבד. אין שידור אוטומטי או מתוזמן ל-ERP — כל הזמנה משודרת מהדף שלה. גם שידור של כמה הזמנות בבת אחת עדיין לא קיים.
- בלי כפילויות. Synca זוכרת כל הזמנה ששודרה, לכל חיבור ERP בנפרד, ולא תשדר אותה שוב לאותו חיבור. היא לא מחפשת את ההזמנה ב-Priority עצמו, אלא סומכת על מה שזכרה — ראו מה עושים כשהשידור נכשל.
- שורה שלא זוהתה עוצרת את השידור. כל שורה בהזמנה צריכה להיות מזוהה מול מוצר בקטלוג. כשיש שורה שלא זוהתה, הכפתור בראש הדף הוא שייך שורות, ושידור אפשרי רק אחרי שמטפלים בה.
- אין עדכון אחרי השידור. Synca פותחת הזמנות ב-Priority ואינה משנה הזמנה שכבר נמצאת שם, וגם לא קוראת ממנו סטטוס בחזרה.
כמה חיבורי Priority
אפשר לעבוד עם יותר מחיבור Priority אחד. כל חיבור מביא את הפריטים שלו לקטלוג, ובשידור כל שורה נשלחת לחיבור שממנו הגיע המוצר שלה — הזמנה אחת לכל חיבור.
אם אותו מק״ט מגיע משני חיבורים, Synca לא יודעת לאן לשלוח את השורה. היא מסמנת אותה כלא חד-משמעית, והשורה עוצרת את השידור עד שמטפלים בה.
מה החיבור לא עושה
- לא קורא ולא כותב לקוחות (
CUSTOMERS). - לא קורא ולא יוצר חשבוניות, ולא נוגע בכרטסת.
- לא כותב ל-Priority פריטים, מחירים או מלאי. המידע זורם מ-Priority אל הקטלוג, לא להפך.
- לא קורא הזמנות מ-Priority ולא מקבל ממנו Webhooks.
- לא עובד עם טפסים אחרים מלבד שני הטפסים שבטבלה למעלה.