שילוב TokenTax לדיווח מס קריפטו מורכב

שילוב TokenTax לדיווח מס קריפטו מורכב

אתה סוחר ב-DeFi, מספק נזילות, משתתף בבריכות AMM כמו Uniswap V2/V3, Curve, Balancer, ומקבל טוקנים ברשתות L2 מרובות (Arbitrum, Optimism, Base). בסוף השנה, ניתוח ידני של מאות אלפי עסקאות הוא בלתי אפשרי. TokenTax הוא אחד השירותים הבודדים שמטפל בקיבוץ בריכות נזילות, פורקס רכים, ופעולות DeFi מורכבות. אבל ההתקנה שלו דורשת מיפוי נתונים מדויק והבנה של קטגוריות מס (Trade, Income וכו'). אנחנו עוזרים להקים ייצוא מותאם אישית מהתשתית שלך לפלטפורמה, כך שהדיווח מתבצע בכמה קליקים.

למהנדסים שלנו יש שנים של ניסיון בחיבורי שירותי מס קריפטו והם עבדו עם מאות פרוטוקולי DeFi. עלות אינטגרציה טיפוסית נעה בין $1,500 ל-$5,000 בהתאם למורכבות, ולקוחות בדרך כלל חוסכים עד 80% בעמלות הנהלת חשבונות. לדוגמה, לקוח אחד עם 50,000 עסקאות חסך $12,000 בעמלות הנהלת חשבונות בשנה הראשונה.

TokenTax תומך במספר פורמטי ייבוא. לחיבורים מותאמים אישית, Generic CSV או JSON API הם הנפוצים ביותר. לכל פורמט יש את הנישה שלו. Generic CSV מתאים להתחלה מהירה וייבוא חד-פעמי, אך אינו מאפשר סנכרון אוטומטי. JSON API דורש הגדרת מפתח ומגבלות בקשות, אך יכול לעבד מיליוני עסקאות ללא התערבות ידנית. הפתרון שלנו מהיר פי 10 מחיבורים טיפוסיים בזכות ממירים מוכנים. למידע נוסף על הפורמטים, ראה תיעוד TokenTax הרשמי.

Generic CSV הוא האפשרות הגמישה ביותר. הכנו תבנית עם סט מלא של שדות. ממשק ה-TokenTaxRow מאפשר מיפוי מדויק של סוגי עסקאות.

interface TokenTaxRow {
  type: "Trade" | "Income" | "Mining" | "Gift" | "Expense" | "Transfer";
  buyAmount: string;
  buyCurrency: string;
  sellAmount: string;
  sellCurrency: string;
  feeAmount: string;
  feeCurrency: string;
  exchange: string;
  group: string; // для группировки связанных транзакций
  comment: string;
  date: string; // "YYYY-MM-DD HH:mm:ss"
}

function exportToTokenTaxCSV(transactions: InternalTransaction[]): string {
  const headers = [
    "Type",
    "BuyAmount",
    "BuyCurrency",
    "SellAmount",
    "SellCurrency",
    "FeeAmount",
    "FeeCurrency",
    "Exchange",
    "Group",
    "Comment",
    "Date"
  ];

  const rows = transactions.map(tx => [
    mapToTokenTaxType(tx.taxCategory),
    tx.amountIn?.toString() ?? "",
    tx.assetIn ?? "",
    tx.amountOut?.toString() ?? "",
    tx.assetOut ?? "",
    tx.feeAmount?.toString() ?? "",
    tx.feeCurrency ?? "",
    tx.source ?? "",
    tx.groupId ?? "", // объединять LP операции в группы
    tx.notes ?? "",
    format(tx.timestamp, "yyyy-MM-dd HH:mm:ss"),
  ].join(","));

  return [headers.join(","), ...rows].join("\n");
}

function mapToTokenTaxType(category: TaxCategory): string {
  const typeMap: Record<TaxCategory, string> = {
    [TaxCategory.SWAP]: "Trade",
    [TaxCategory.BUY]: "Trade",
    [TaxCategory.SELL]: "Trade",
    [TaxCategory.STAKING_REWARD]: "Income",
    [TaxCategory.AIRDROP]: "Income",
    [TaxCategory.MINING_REWARD]: "Mining",
    [TaxCategory.TRANSFER]: "Transfer",
    [TaxCategory.GAS_FEE]: "Expense",
  };
  return typeMap[category] || "Trade";
}

איך TokenTax מטפל בעסקאות LP?

כשמוסיפים נזילות ל-Uniswap V3, אתה נותן שני טוקנים ומקבל טוקן LP אחד. ללא קיבוץ, TokenTax רואה שתי מכירות (token0 ו-token1) ורכישה אחת של טוקן ה-LP — זה יוצר רווחים ריאליים פיקטיביים. הפתרון הוא לשלב שורות קשורות באמצעות שדה ה-Group. יישמנו את פונקציית ה-interface TokenTaxRow { type: "Trade" | "Income" | "Mining" | "Gift" | "Expense" | "Transfer"; buyAmount: string; buyCurrency: string; sellAmount: string; sellCurrency: string; feeAmount: string; feeCurrency: string; exchange: string; group: string; // для группировки связанных транзакций comment: string; date: string; // "YYYY-MM-DD HH:mm:ss" } function exportToTokenTaxCSV(transactions: InternalTransaction[]): string { const headers = [ "Type", "BuyAmount", "BuyCurrency", "SellAmount", "SellCurrency", "FeeAmount", "FeeCurrency", "Exchange", "Group", "Comment", "Date" ]; const rows = transactions.map(tx => [ mapToTokenTaxType(tx.taxCategory), tx.amountIn?.toString() ?? "", tx.assetIn ?? "", tx.amountOut?.toString() ?? "", tx.assetOut ?? "", tx.feeAmount?.toString() ?? "", tx.feeCurrency ?? "", tx.source ?? "", tx.groupId ?? "", // объединять LP операции в группы tx.notes ?? "", format(tx.timestamp, "yyyy-MM-dd HH:mm:ss"), ].join(",")); return [headers.join(","), ...rows].join("\n"); } function mapToTokenTaxType(category: TaxCategory): string { const typeMap: Record<TaxCategory, string> = { [TaxCategory.SWAP]: "Trade", [TaxCategory.BUY]: "Trade", [TaxCategory.SELL]: "Trade", [TaxCategory.STAKING_REWARD]: "Income", [TaxCategory.AIRDROP]: "Income", [TaxCategory.MINING_REWARD]: "Mining", [TaxCategory.TRANSFER]: "Transfer", [TaxCategory.GAS_FEE]: "Expense", }; return typeMap[category] || "Trade"; } שיוצרת שתי רשומות עם אותו Group ID.

function exportLPOperationAsGroup(
    lpDeposit: LiquidityDepositEvent,
    groupId: string
): TokenTaxRow[] {
    // Два токена отдали → LP токен получили
    return [
        {
            type: "Trade",
            buyAmount: lpDeposit.lpTokenAmount.toString(),
            buyCurrency: `${lpDeposit.token0}-${lpDeposit.token1}-LP`,
            sellAmount: lpDeposit.token0Amount.toString(),
            sellCurrency: lpDeposit.token0,
            feeAmount: "",
            feeCurrency: "",
            exchange: "Uniswap",
            group: groupId,
            comment: "LP deposit token0",
            date: format(lpDeposit.timestamp, "yyyy-MM-dd HH:mm:ss"),
        },
        {
            type: "Trade",
            buyAmount: "",
            buyCurrency: "",
            sellAmount: lpDeposit.token1Amount.toString(),
            sellCurrency: lpDeposit.token1,
            feeAmount: lpDeposit.gasUSD?.toString() ?? "",
            feeCurrency: "USD",
            exchange: "Uniswap",
            group: groupId,
            comment: "LP deposit token1",
            date: format(lpDeposit.timestamp, "yyyy-MM-dd HH:mm:ss"),
        },
    ];
}

מהירות דיווח עם שילוב TokenTax

דיווח אוטומטי דרך API מקצר את זמן ההפקה פי 5 בהשוואה לייבוא CSV ידני. עבור תיק של 100,000 עסקאות, עיבוד ידני לוקח עד שבוע, בעוד שעיבוד אוטומטי לוקח פחות מיום.

מה העלות של שילוב TokenTax?

אינטגרציה סטנדרטית (ייצוא CSV, עד 10 סוגי עסקאות) עולה בין $1,500 ל-$3,000. פרויקטים מורכבים (REST API, רשתות מרובות, מיליוני רשומות) נעים בין $3,000 ל-$5,000. אנו מספקים הערכה מדויקת לאחר ביקורת על הנתונים שלך. צור קשר לקבלת ייעוץ. לקוחות טיפוסיים מחזירים את ההשקעה תוך חודשים באמצעות הפחתת עמלות הנהלת חשבונות.

תוצרי שילוב TokenTax

אנו מספקים פתרון מלא ומפתח-ביד עם התוצרים הבאים:

• ניתוח נתוני מקור: אנו חוקרים את סכמת העסקאות שלך, חוזים מותאמים אישית, ופעולות DeFi טיפוסיות.
• פיתוח ממיר ל-Generic CSV או JSON API ב-TypeScript או Python (בחירת המחסנית שלך).
• יישום קיבוץ: עבור עסקאות בריכות נזילות, חקלאות יבולים, וסוואפים מרובי-קפיצות.
• טיפול במקרי קצה: איירפדרופים, פורקס רכים, החזרי גז.
• תיעוד מפורט להפעלת החיבור.
• בדיקות על נתונים היסטוריים ל-12 החודשים האחרונים (עד 100,000 עסקאות).
• הדרכת רואה החשבון שלך על טעינה ואימות דוחות.
• חודש תמיכה לאחר הפריסה, כולל גישה לצוות שלנו לשאלות.

תהליך העבודה

1. אנליטיקה (יום אחד): אתה מספק דגימת עסקאות (JSON/CSV), ואנחנו מזהים דפוסים לא סטנדרטיים.
2. עיצוב (יום אחד): בניית מיפוי קטגוריות, פורמט ייצוא, ותוכנית קיבוץ.
3. יישום (2-4 ימים): כתיבת הממיר שמכסה 100% מסוגי הפעולות שלך.
4. בדיקות (יום אחד): הרצה על היסטוריה מלאה, השוואת דוח TokenTax עם חישוב ידני.
5. פריסה (כמה שעות): הגדרת ריצות חודשיות אוטומטיות (באמצעות cron או API).

לוח זמנים

חיבור סטנדרטי (ייצוא CSV, עד 10 סוגי עסקאות) — בין 2 ל-4 ימי עסקים. פרויקטים מורכבים (REST API, רשתות מרובות, מיליוני רשומות) — עד שבועיים. אנו נותנים הערכה מדויקת לאחר ביקורת על הנתונים שלך. צור קשר לקבלת ייעוץ. אנו מבטיחים תמיכה מלאה במהלך היישום ו-30 ימים של סיוע חינם לאחר סיום. הזמן עכשיו כדי לקבל ממיר מוכן ל-TokenTax.

למה לבחור בנו

למהנדסים שלנו יש מעל 5 שנות ניסיון בפיתוח בלוקצ'יין ובאינטגרציות עם שירותי מס קריפטו. סיפקנו בהצלחה התקנות לפרוטוקולי DeFi, שווקי NFT, וחברות מסחר פרופ. כל חיבור מגיע עם תיעוד והדרכת צוות לקוח. הפתרון שלנו מהיר פי 10 מאינטגרציות טיפוסיות. קבל ייעוץ על ההתקנה שלך.