ה-API של טרינג
הפקת מסמכי מס ישראליים מהקוד שלכם: קבלה, חשבונית מס, חשבונית מס / קבלה, חשבונית זיכוי וחשבונית עסקה. טרינג מחשבת את הסכומים והמע"מ, נותנת מספר, חותמת ושומרת. המערכת שלכם שולחת רק מה נמכר או מה התקבל.
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);from tring_sdk import Tring
tring = Tring() # TRING_API_KEY=kbl_test_...
draft = tring.prepare_draft(issuer_id, receipt, idempotency_key="order-1001-receipt")["draft"]
document = tring.confirm_draft(draft["id"])["document"]curl -sS -X POST "$TRING_BASE_URL/v1/issuers/$TRING_ISSUER_ID/drafts" \
-H "Authorization: Bearer $TRING_API_KEY" \
-H "Idempotency-Key: order-1001-receipt" \
-H "Content-Type: application/json" --data @receipt.jsonמאיפה מתחילים
| עמוד | מה יש בו |
|---|---|
| התחלה מהירה | מפתח ניסוי, התקנה, קבלה ראשונה ב-curl, ב-JavaScript או בפייתון |
| הפקת מסמכים | הכנה ואישור, מפתח אידמפוטנטיות, מה עושים כשהתוצאה לא ידועה, חמשת סוגי המסמכים, תיקונים |
| Webhooks ואירועים | הודעות חתומות כשמסמך מופק או מורד, איך בודקים אותן, קריאת אירועים אחרי הפסקה |
| ספריות SDK | הגדרות, שליחה חוזרת, שגיאות, דפדוף, פונקציות עזר, אימות חתימת webhook |
| סוכני AI ו-MCP | חיבור Claude Code או Cursor, ואיך הפקה נשארת מאחורי אישור של אדם |
| מדריך ה-API | כל פעולה, המתודה שלה בספריות וקודי השגיאה שלה |
חמישה כללים
- הפקה היא שתי קריאות: הכנה מחשבת טיוטה ולא מפיקה כלום, אישור מפיק אותה.
- מפתח
Idempotency-Keyאחד לכל מסמך, שבנוי ממספר ההזמנה ונשמר לפני הקריאה הראשונה. - כשאישור לא קיבל תשובה, שולחים את אותו אישור שוב. אף פעם לא מכינים מחדש עם מפתח חדש.
- סכומים נשלחים כטקסט עם שתי ספרות אחרי הנקודה (
"118.00"), כמויות עם ארבע ("1.0000"). - בונים מול סביבת הניסוי: המפתחות שלה מתחילים ב-
kbl_test_. מעבר לייצור הוא כתובת אחרת ומפתחkbl_live_.
החבילות
| חבילה | התקנה |
|---|---|
| ספרייה ל-TypeScript ו-JavaScript (Node 18 ומעלה) | npm install tring-sdk |
| ספרייה לפייתון (3.9 ומעלה) | pip install tring-sdk |
| שרת MCP לסוכני AI | npx -y tring-mcp |
| שרת דמה מקומי של ה-API | npx tring-mock-server |
ארבעתן נבנות מאותו מפרט OpenAPI. לכלי AI יש llms.txt ו-llms-full.txt.