יצירת חשבונית מס

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

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

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

Action: Create

Method: POST

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

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

שדות חשבונית

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

לקוח - accountid

שם החברה - companyname

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

ILS = 4

USD = 1

GBP = 2

JPY = 31

EUR = 27

AUD = 18

CAD = 6

DKK = 12

NOK = 28

SEK = 3

CHF = 5

BRL = 32
‍

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

טלפון - 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,
}