שליפת חשבונית ספציפית ונתונים ממסך בן בעזרת REST API של פריוריטי

ההסברים באתר של פריוריטי טובים, אך בכמה דברים לא מספיק ברורים.

ההסבר בלינק מדבר על שליפת נתונים ממסך בן טקסט, אבל בדרך אגב מראה איך באמת לשלוף ישות שיש לה יותר ממפתח U אחד.

http://prioritysoftware.github.io/restapi/request/#Requesting_Text

על כן, על מנת לשלוף נתונים של תעודה אחת, צריך לציין את כל המפתחות.

צריך בעיקר לשים לב לחשבוניות, שלהן יש שלושה מפתחות U.

 

לכן, שליפת חשבונית מס תהייה לפי ה URL הבא:

 

GET serviceRoot/AINVOICES(IVNUM='T83',IVTYPE='A',DEBIT='D')/EXTFILES_SUBFORM

 

 

מפרט מוצר פלאגין פריוריטי ווקומרס גרסה 1.0.5

סנכרון פריוריטי לאתר:

מוצרים, מקט, תאור מוצר, תמונה ראשית(ניתן להגדיר דריסה או עדכון לריק), מחיר בסיס, משפחת מוצר

חדש – תמונות ממסך הבן נספחים

וריאציות על בסיס שדה לבחירה, כגון פריט מרכז או פרמטר

מלאי לפי מסך זמינות מלאי שדה מלאי זמין

אתרים ללקוח

מחירון לקוח ( מחירון אחד לכל משתמש באתר )

סטטוס הזמנות לקוח

סנכרון אתר לפריוריטי:

לקוחות

הזמנות לקוח – לקוח, לקוח מזדמן ותאור לקוח, פנקס

חשבונית מס – לקוח, לקוח מזדמן ותאור לקוח, פנקס

קבלה לקוח, לקוח מזדמן ותאור לקוח, פנקס

פירוט התעודות – מקט, כמות, מחיר כולל מעמ לשורה

פרטי תשלום, כרטיס אשראי תוקף טוקן (לסולקים הבאים: קרדיט גארד, פייפלוס בלבד, אחרים בתוספת תשלום).

פרטי משלוח

הגדרות באתר:

הצגת מחירים ללקוח לפי מחירון

חסימת מחירים למשתמש לא רשום

סטטוס מוצר בפתיחה

טבלת המרה לאמצעי תשלום

טבלת המרה לשיטת משלוח ( הגדרת מקט פריוריטי )

שיוך משתמש אתר למספר לקוח פריוריטי

  • * במידה ויש התאמות בפריוריטי או באתר, הפלאגין מצריך התאמה בתשלום

ספירת מלאי – הדרך הנכונה

אז כמו בכל שנה, יש צורך לבצע ספירות מלאי.

בפוסט הזה אני אפרט מספר צעדים שכדי לקחת בחשבון לקראת ספירת המלאי.

 

ארגון נכון של קובץ או קבצי האקסל.

  • יש לוודא שכל הפריטים בספירה קיימים בפריוריטי על ידי VLOOKUP
  • יש לוודא שכל המחסנים/איתורים קיימים בפריוריטי על ידי VLOOKUP
  • יש לוודא שהכמויות בספירה מעוצבות כמספר ללא מפריד אלפים, מפריד האלפים גורם לבעיות ושגיאות בטעינה

  • כשמפעילים את הפונקציה VLOOKUP, כדאי תמיד לעטוף את הערך שמחפשים בפונקציה TRIM, כדי לוודא שאין שדות בלתי נראים שיפריעו לחיפוש

 

 איך מפעילים פונקציות VLOOKUP ?

להלן הקוד שאני משתמש בו

:

הפונקציה TRIM מנקה את הערך שאותו אני מחפש בשדה E3

לאחר מכן מופיעה הטווח בו יש לחפש. חשוב לציין שהטווח יכול להיות יותר מעמודה אחת. והפונקציה תחפש בכל העמודות.

המספר 1, אומר שאם נמצא בשורה מסוימת הערך, יחזיר בחזרה לפונקציה את הערך מהעמודה הראשונה בטווח, אם היה רשום 3, היה מחזיר את הערך מהעמודה השלישית.

המספר 0, אומר מה יחזור במידה ולא ימצא ערך, ותמיד בעצם מחיר NA.

 

 

 

ספירת מלאי בעזרת הכנה חוזרת או ספירת מלאי איפוס ואז ספירה עיוורת?

  • ניתן לבצע ספירת מלאי על ידי הכנה חוזרת לספירת מלאי, מה הכוונה? מבצעים ספירה עיוורת של הפריטים לתעודה, ואז מריצים על התעודה הכנה חוזרת, שיוצרת תעודה חדשה, אבל לכל שורה יוצרת גם את הכמות המחושבת. הספירה הזו הרבה יותר נכונה, אבל יש לה מגבלות של ביצועים, בחברות גדולות עם הרבה פריטים ואיתורים, ההכנה הזו יכולה לרוץ יום שלם, וצריך לקחת בחשבון שבזמן ההטמעה המלאי לא נכון.
  • ניתן לבצע הכנה לספירת מלאי, שתיצור תעודה עם כל המלאי הקיים, ולאשר אותה ללא עדכון כמויות. הפעולה הזו מאפסת את המלאי. מיד לאחריה ניתן לבצע עוד ספירת מלאי עיוורת, כלומר ספירה שבה הכנסנו את הכמויות אך הכמות המחושבת הינה אפס, וזו תוסיף את הספירה שלנו למלאי. בשיטה זו נוקטים במידה ויש בעיות ביצועים לשיטה הראשונה.

 

אילו שדות מעדכנים בספירה?

השדות שמתעדכנים בספירה מתחלקים לכותרת התעודה ולפירוט.

בכותרת יש לעדכן תאריך ומחסן.

בפירוט יש לעדכן מקט, כמות שנספרה.

אם עובדים עם איתורים יש לעדכן גם איתור.

שדה עלות הינו אופציונאלי ונועד לעדכוני ערך מלאי.

כמובן שבמערכות יותר מורכבות יש לעדכן גם פקע/מנה, סטטוס וכד'.

לאחר עדכון השדות, יש ללחוץ אישור, או להריץ מהכותרת את ההפעלה אישור/הורדת אישור ספירה.

 

 

 

כדי לתרגל, אני ממליץ לבצע קבלת סחורה למוצר לתאריך הסטורי כדי ליצור מלאי.

לאחר מכן, לבצע את מגוון שתסריטים של ספירות המלאי, ולראות איך המלאי מתעדכן.

 

בצלחה.

 

שיפור ניהול השגיאות של PRIORITY REST API

לעיתים אני מנסה לשדר נתונים ל API של פריוריטי, ומתקבלת שגיאה 500, כמו בתמונה, זה ממש מעצבן, ונראה שאין מה לעשות כדי להבין מה בדיוק לא תקין.

אז יש מה לעשות, והפתרון אפילו די פשוט.

כל מה שצריך לעשות, זה להוסיף שורה בקובץ הקונפיגורציה של הסרוויס.

יש להוסיף את השורה <customErrors mode="Off"/> בתוך קובץ web.config שנמצא בתקיה C:\inetpub\wwwroot\odata

לאחר מכן, יש לאתחל את ה IIS

יש לחזור ל POST MAN ולנסות לשדר שוב, השגיאה עכשיו תהייה הרבה יותר ארוכה ועם הרבה יותר מידע.

לסיום, שימו לב, שבדרך כלל מדובר בבעיה של סינטקס

איך מאפיינים אתר סחר במתווה B2B ?

למערכת פריוריטי יש יכולות מצויינות בתחום ניהול הלקוחות, הספקים, האובליגו, מחירים ללקוחות וסוכנים.

כחלק מעבודה עם המערכת, נצבר המון מידע במערכת.

ניתן לנצל מידע זה, תוך שימוש במודול ה API והפלאגין לאתרי סחר.

אז כיצד מאפיינים אתר B2B ? להלן מספר שאלות מכווינות:

  1. מי יהיו המשתמשים באתר? הלקוחות שלי? סוכנים שלי? ספקים? הציבור הרחב ?
  2. מה הפעולות שאני רוצה לעשות באתר ואיך הן ישתקפו בפריוריטי ? הזמנות לקוח? הזמנות רכש ? חשבוניות ? קבלות ?
  3. אילו נתונים יש לסנכרן בין הפריוריטי לאתר על מנת לאפשר פעולה תקינה ? מלאי? מחירים? מחירונים? מוצרים? לקוחות?
  4. מה התהליך העסקי באתר, מומלץ לרשום תרשים זרימה.
  5. תהליכי ביטול, מה קורה אם משתמש ביצע באתר תהליך, אבל רוצה לבטל אותו? עד איזה שלב ניתן לבטל את התהליך דרך האתר, וממתי צריך לבטל בפריוריטי ?
  6. איזה מידע כללי שקיים בפריוריטי,  צריך להנגיש באתר עבור המשתמש ?
  7. האם האתר יהיה סגור רק למשתמשים רשומים ? או שחלק מהדפים יהיו ציבוריים ?
  8. האם יהיה תהליך הרשמה באתר או שההרשמה תתבצע על ידי מנהל האתר באופן יזום ?
  9. אילו דפים צריך באתר? דף בית? דף חנות? דף מוצר? דף צור קשר? דף עגלה? הרשמה? כניסה?

בכל מקרה, יש לשמור על ראש פתוח, וחשוב להקשיב ללקוח ולרשום את כל רצונותיו, גם אם הדרישות לא תמיד נראות סבירות…

אפיון וניהול תחזוקת אתר – דוגמא

בהצלחה!

יבוא וטיפול בקובץ אקסל על ידי שאילתת SQL תוך שימוש ב MMS

הרבה פעמים נופל לידי קובץ אקסל, ויש צורך לבצע השוואות בין נתונים בפריוריטי לבין נתונים בקובץ האקסל.

מה שרוב האנשים עושים במקרה כזה, הוא לפרוק מתוך הפריוריטי את הנתונים לאקסל, ואז להתחיל תהליך של השוואת נתונים אין סופית.

במידה ואתם שולטים ב Microsoft Mangement Studio, ניתן בקלות לייבא את קובץ האקסל כטבלה ב SQL , ואז לבצע שאילתות בצורה הרבה יותר גמישה ומהירה.

ראו את הקוד המצורף.

בהצלחה!

CREATE TABLE #orders3(

ord varchar(50) ,

partname varchar(50),

qty varchar(50)

PRIMARY KEY(ord,partname)

);

BULK INSERT #orders3

FROM 'C:\tmp\orders3.csv'

WITH

(

FIRSTROW = 1,

FIELDTERMINATOR = ',', –CSV field delimiter

ROWTERMINATOR = '\n', –Use to shift the control to next row

TABLOCK

)

אינטגרציה עם קופת פוזיטיב, הגדרות שיש לבצע בפריוריטי

על מנת לאפשר עבודה שוטפת בין מערכת פריוריטי לקופת פוזיטיב, יש לבצע מספר התאמות.

לקוחות מזדמנים:

יש לפתוח בפריוריטי לקוח מזדמן לכל חנות, כאשר מספר הלקוח זהה למספר החנות במערכת פוזיטיב.

אמצעי תשלום:

יש לעדכן את כל אמצעי התשלום במערכת לפי ההגדרות הבאות –

במידה ועובדים עם שוברי תשלום, יש להוסיף אמצעי תשלום 3 – שובר תשלום

תנאי תשלום:

יש להתאים את קודי תנאי התשלום למערכת פוזיטיב.

על כן, יש לפתוח תנאי תשלום כך שהקוד יהיה מספר התשלומים.

לקוחות:

יש לפתוח לקוח עם מספר זהה למספר החנות. בנוסף יש לפתוח סניף זהה וקופה. המספר של הלקוח, סניף קופה חייב להיות תואם למספר החנות!

מוצרים:

על מנת לסנכרן מוצרים מפריוריטי לקופה, יש לסמן לכל מוצר בכרטיס פריט את הצ'ק בוקס 'רכש אינטרנט'.

יש לוודא שהפריטים בפריוריטי מכילים רק את התוים מספרים, אותיות באנגלית או בעברית, רווח, קו תחתון ומקף. לפני האינטגרציה יש לוודא ולהחליף את כל התוים הלא תקינים

קופות וסניפים:

על מנת לבצע ניתוב נכון של תשלומים לקופות שונות, כאשר כל חנות היא קופה נפרדת, יש לפתוח קופה לכל חנות. כל מספר חנות על פי מערכת פוזיטיב, יהיה גם מספר קופה בפריוריטי בהתאמה. יש לשים לב שהניתוב מתבצע לקופות עבור מזומן וצקים אך אם רוצים לבצע ניתוב של אמצעי תשלום לקופה יש לבצע זאת בהגדרות אמצעי התשלום מסך בן 'קופה/בנק/אשראי לסניף.

לפיכך, נדרש גם לפתוח סניף עבור כל חנות. כאשר גם מספר הסניף תואם את מספר החנות במערכת פוזיטיב.

במידה ומדובר בלקוח פעיל שכבר יש לו קופות, ניתן לבצע הגדרת המרה ממספר הקופה בפוזיטיב למספר הקופה בפריוריטי, לשם כך יש לפנות לתמיכה של פוזיטיב.

מלאי:
על מנת שמלאי המחסנים יעודכן בהתאם לרכישות המוצרים בחן מס יש לבצע את השלבים הבאים:
הקמת מחסן לכל חנות במערכת פריוריטי – 
יש להיכנס למסך מחסנים בנתיב ניהול מלאי > ניהול מחסנים > מלאי נוכחי > מחסנים.
יש להקים מחסן עבור כל חנות מכירות .
הסבר שדות:
מחסן – קוד המחסן = מספר החנות
תאור מחסן – תאור קצר של המחסן (רצוי שיהיה כשם החנות)
טיפוס – D
איתור – 0 יופיע באופן דפולטיבי 
מחסן מכירות – יש לסמן את הצ'ק בוקס

הגדרות בחשבונית מס:

על מנת לוודא שפריטים שעברו לסטטוס לא פעיל לא יחזירו שגיאה, יש להוסיף את שדה סטטוס פריט מרמת כרטיס פריט לשורת החשבונית, דרך עיצוב מתקדם במסכים.

לאחר מכן, יש להוסיף מחולל נתונים, לאחר הקלדת כמות, קבע בשדה מקט ערך 000 אם שדה סטטוס פריט לא פעיל.

בנוסף, יש לוודא שלא מבצעים שינוי במקטים או ברקודים. מומלץ להפוך שדות אלה לשדות קריאה בלבד למי שלא חייב לפתוח מוצרים. יש להוסיף הודעת אזהרות כדי למנוע אפשרות שינוי.

בדיקות מסירה בסיום תהליך ההתקנה:

  • הפקת חשבונית במדפסת, בדיקת לוגו, שם, מספר חברה תקינים
  • בדיקת מעבר עסקה לפריוריטי
  • בדיקת סנכרון מוצרים מפריוריטי לקופה
  • בדיקת הצגת לקוחות בקופה

הגדרת משתמש API בשימוש ב API ייעודי

במידה ורכשתם API ייעודי מאיתנו, כחלק מחבילת פלאגין לווקומרס, מג'נטו או כל מוצר אחר, או במידה ורכשתם  מכל שותף ISV אחר, יתכן שתיתקלו בקשיים בהגדרת המשתמש.

ההגדרות קצת שונות מהגדרות רגילות של משתמש API.

להזכירכם, משתמש API רגיל, פשוט צריך להגדיר כמשתמש API ולתת שם משתמש API.

 

 

ההגדרות של משתמש בפלאגין ייעודי קצת שונות.

 

ראשית, יש להגדיר את העובד עם שם API כמו במשתמש API רגיל, אך לא לסמן רשיון API.

בנוסף, יש לציין שמדובר ברשיון אפליקציות בלבד.

ודבר אחרון, צריך להכניס את המשתמש לרשימת המורשים לאפליקציה.

יש להכנס למסך מנהל המערכת > תחזוקת מערכת > רשיונות > אפליקציות ברישיון

 

בהצלחה!

 

 

 

 

 

 

 

 

 

 

 

 

 

שימוש בפרמטרים בקוד של פרוצדורה/טריגר

כאשר משתמשים בפרמטרים בפרצדורות או טריגרים צריך להקפיד שהפרמטר יתחיל בנקודותיים וקו תחתון (לדוגמא ERR_:  ולא ERR:)
כיוון שיכול להיות שללא קו תחתון הפרמטר קיים בשימוש של המערכת בכל מיני מקומות.

דילוג לתוכן