BillOS
התחילו עכשיו
BillOS/יכולות/CLI

הנהלת ספרים מהטרמינל

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

npm install -g billos
התקנה מ-npm ‹ תיעוד ‹
zsh

בנוי לאנשים.
בנוי לסוכנים.

לבד בטרמינל, הפלט קריא ובעברית. עם --json כל פקודה מחזירה את צורת ה-API הגולמית ל-stdout, המצב שמזרימים ל-jq, לסקריפט או לסוכן. BILLOS_API_KEY בסביבה, וזה רץ ב-CI.

  • הסכומים בשקלים, ההמרה לאגורות בקצה
  • מטבע זר עם --currency ו---rate, או שער בנק ישראל
  • אפס תלויות זמן ריצה: node 20 בלבד

כניסה כמו ב-stripe login

הדפדפן מאשר קוד, מפתח חדש נטבע מאחורי אימות ה-SMS של הקונסול, וה-CLI אוסף אותו דרך קוד מכשיר סודי. המפתח הגולמי לעולם לא עובר בדפדפן, ונשמר ב-~/.config/billos בהרשאות 0600.

billos login
$ billos login
  Open https://dash.billos.co.il/cli and enter  HXK-7Q2P
  waiting…
  ✓ signed in as studio-noa · key stored at ~/.config/billos/config.json

כל הפקודות

כל מה שה-API יודע, בפקודה. --json על כל אחת.

billos login [--key bk_…]זיווג דרך הקונסול, או הדבקת מפתח קיים
billos whoami · billos businesses · billos use <id>מי אני, אילו עסקים, ואיזה עסק ברירת מחדל
billos invoice --customer "שם" --amount 350 [--type]קבלה, חשבונית או חשבונית מס/קבלה, מופקת וחתומה
billos invoice … --currency USD --rate 3.005מסמך במט"ח, נרשם בשקלים לפי השער
billos cancel <documentId> [--reason]חשבונית זיכוי מקושרת, הביטול החוקי היחיד
billos docs [--status --from --to --take]רשימת מסמכים עם סינון
billos expense --supplier "שם" --amount 118 [--vat 18]רישום הוצאה
billos expenses · billos customers · billos usageהוצאות, לקוחות, וצריכת ה-API שלכם

רץ ב-CI

שני משתני סביבה, ואותה פקודה שרצה על המחשב שלכם רצה ב-GitHub Actions: מפיקים מסמך כשמנוי מתחדש, או מושכים את דוח המסמכים של החודש לתוך ה-pipeline.

.github/workflows/invoice.yml
env:
  BILLOS_API_KEY: ${{ secrets.BILLOS_API_KEY }}
  BILLOS_API_ORIGIN: https://api.billos.co.il
steps:
  - run: npm install -g billos
  - run: billos invoice --customer "${{ inputs.customer }}" --amount ${{ inputs.amount }} --type invoice-receipt --json > issued.json
  - run: jq -r '.document.docNumber' issued.json

חשבונית ראשונה
משורת הפקודה.

npm install -g billos ‹