מערכת Fireberry by Powerlink מאפשרת ליצור חשבונית מס דרך התממשקות ל API.

למאמר הדרכה על הגדרות שימוש ב HTTP REST API לחצו כאן.

יצירת חשבונית מס חדשה מתבצעת דרך :

Action: Create

Method: POST

URL: https://api.powerlink.co.il/api/record/81

בעת פתיחת חשבונית מס מבנה הפקודה נחלק לשני חלקים:
1) חשבונית
2) פרטי חשבונית

 

שדות חשבונית

הפרמטרים שחייבים לשלוח בחלק של החשבונית הם:

לקוח - accountid

שם החברה - companyname

סוג המטבע - currencycode (מקבל ערך מספרי):

שדות נוספים אפשריים לשליחה:

טלפון - telephone

פקס - fax

כתובת - address

אימייל - emailaddress

תיאור- description

שדות פרטי החשבונית

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

שם מוצר - productname
הערה: שם המוצר מקבל טקסט (String) באופן חופשי אך גם יכול לקבל מוצר מתוך רשימת המוצרים במערכת- יש לשלוח במקום productname את productid עם ה id של המוצר.

מחיר המוצר - itemprice

כמות - itemquantity

סכום סופי של הפריט (מכפלת מחיר מוצר בכמות) - itemtotalprice

סכום המוצרים - productstotal

הנחת עיגול - rounddiscountcode (יכלל עם ערך=1 רק עם רוצים להוסיף הנחה בעסקה)

מע"מ - taxincludecode (יכלל עם ערך=1 רק אם רוצים לחשב מע"מ בעסקה)

סכום הנחה - amountdiscount

סכום כולל (לאחר ההנחות והמע"מ) - totalamount

דוגמת קוד Json לפקודה מלאה של הוספת חשבונית מס עם 3 מוצרים:

{
  companyname:"ישראל כהן",
  idnumber:"123456789",
  telephone:"43606540",
  fax:"056045604",
  address:"דיזנגוף 121",
  emailaddress:"israel@israel.com",
  currencycode:4,
  Items:{
      Item:[
          {
            productname:"טלויזיה 55 אינצ",
            itemprice:100,
            itemquantity:1,
            itemtotalprice:100
          },
          {
            productname:"מצלמת וידיאו דיגיטלית",
            description:"מצלמה עם 64 גיגה זיכרון פנימי",
            itemprice:200,
            itemquantity:2,
            itemtotalprice:400 },
          {
            productname:"כבל טעינה לטלפון",
            description:"כבל טעינה לטלפון - איפון",
            itemprice:3,
            itemquantity:300,
            itemtotalprice:900
          }
      ]
  },  description:"זמן אספקה עד 14 יום עבודה",
  productstotal:1400,
  amountdiscount:0,
  rounddiscountcode:1,
  taxincludecode:1,
  totalamount:1638,
}

לחצו כאן לכניסה ל-GitHub להסברים נוספים.