טרינג למפתחים English

ה-API של טרינג

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

js
import { Tring } from 'tring-sdk';

const tring = new Tring(); // TRING_API_KEY=kbl_test_...
const { draft } = await tring.prepareDraft(issuerId, receipt, { idempotencyKey: 'order-1001-receipt' });
const { document } = await tring.confirmDraft(draft.id);

מאיפה מתחילים

עמודמה יש בו
התחלה מהירהמפתח ניסוי, התקנה, קבלה ראשונה ב-curl, ב-JavaScript או בפייתון
הפקת מסמכיםהכנה ואישור, מפתח אידמפוטנטיות, מה עושים כשהתוצאה לא ידועה, חמשת סוגי המסמכים, תיקונים
Webhooks ואירועיםהודעות חתומות כשמסמך מופק או מורד, איך בודקים אותן, קריאת אירועים אחרי הפסקה
ספריות SDKהגדרות, שליחה חוזרת, שגיאות, דפדוף, פונקציות עזר, אימות חתימת webhook
סוכני AI ו-MCPחיבור Claude Code או Cursor, ואיך הפקה נשארת מאחורי אישור של אדם
מדריך ה-APIכל פעולה, המתודה שלה בספריות וקודי השגיאה שלה

חמישה כללים

  1. הפקה היא שתי קריאות: הכנה מחשבת טיוטה ולא מפיקה כלום, אישור מפיק אותה.
  2. מפתח Idempotency-Key אחד לכל מסמך, שבנוי ממספר ההזמנה ונשמר לפני הקריאה הראשונה.
  3. כשאישור לא קיבל תשובה, שולחים את אותו אישור שוב. אף פעם לא מכינים מחדש עם מפתח חדש.
  4. סכומים נשלחים כטקסט עם שתי ספרות אחרי הנקודה ("118.00"), כמויות עם ארבע ("1.0000").
  5. בונים מול סביבת הניסוי: המפתחות שלה מתחילים ב-kbl_test_. מעבר לייצור הוא כתובת אחרת ומפתח kbl_live_.

החבילות

חבילההתקנה
ספרייה ל-TypeScript ו-JavaScript (Node 18 ומעלה)npm install tring-sdk
ספרייה לפייתון (3.9 ומעלה)pip install tring-sdk
שרת MCP לסוכני AInpx -y tring-mcp
שרת דמה מקומי של ה-APInpx tring-mock-server

ארבעתן נבנות מאותו מפרט OpenAPI. לכלי AI יש llms.txt ו-llms-full.txt.