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

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

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

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

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

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

 

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

 

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

 

 

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

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

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

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

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

אתרים ללקוח

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

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

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

לקוחות

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

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

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

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

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

פרטי משלוח

 

הגדרות באתר:

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

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

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

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

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

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

 

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

 

 

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

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

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

 

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

  • יש לוודא שכל הפריטים בספירה קיימים בפריוריטי על ידי 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

)

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

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

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

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

אמצעי תשלום:

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

יש להתקין את קובץ ההתקנה שקיבלתם ברכישת התוכנה.

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

קבוע בשם POST_ADMIN_URL, בתאור הקבוע יש להקיש את כתובת המשרד האחורי כפי שקיבלתם ממוקד השירות.

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

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

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

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

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

 

 

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

 

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

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

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

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

 

בהצלחה!

 

 

 

 

 

 

 

 

 

 

 

 

 

איך ניתן להנגיש את תקיית התמונות של פריוריטי?

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

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

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

צריך פשוט לגלוש לכתובת my_priority_url\primail ומשם לנתיב שבו רואים את התמונה דרך המערכת ללא ה ../../mail

תהנו.

הוספת עמודות למחולל דוחות.

הוספת עמודות למחולל דו"חות יש לעקוב אחר נתיב המחולל הנדרש וללחוץ ממנו F6 על מנת לעבור למחולל הפרוצדורות או לחלופין יש לחפש את שם המחולל המבוקש במחולל הפרוצדורות. במסך הבן שלבי הפרוצדורה יש לאתר את השלב מטיפוס R. בלחיצה על F6 מהשלב מטיפוס R נעבור למחולל הדו"חות. על מנת להוסיף שדה למחולל הדו"חות יש להוסיף שורה חדשה ולציין את עמודת הטבלה ושם הטבלה במסך הבן עמודות הדו"ח. חשוב מאוד – חובה לציין כותרת בשדה כותרת חדשה!!! – השם שאבחר הוא זה שיוצג במחולל הדו"חות. לדוגמא אם ברצוני להוסיף את השדה מס' חברה ממסך לקוחות אעשה זאת באופן המסומן בתמונה. יש להריץ את מחולל הדו"חות ולוודא שהשדה התווסף לדו"ח.