ייצוא CSV של CoinTracker: הגדרת הנהלת חשבונות מס לקריפטו

השקת פרוטוקול DeFi או סוחרת באופן פעיל—ועכשיו רשות המס דורשת דוח לשנה האחרונה. CoinTracker הוא שירות מס קריפטו פופולרי בארה"ב (שותף רשמי של Coinbase). אבל פורמט ה-CSV שלו ספציפי: שגיאה בעמודת Tag הופכת סטייקינג להעברה רגילה, וחישוב המס יוצא מהפסים. נתקלנו במקרים כאלה פעמים רבות—יישמנו מעל 100 אינטגרציות עם שירותי מס ועיבדנו למעלה מ-1,000,000 עסקאות עם דיוק תגיות של 99.5%. בואו נבין איך לבצע את האינטגרציה נכון וללא הפתעות.

הצוות שלנו מבטיח שכל תגית מוגדרת כראוי והדוח יעמוד בבדיקות ה-IRS.

מה זה CoinTracker ואיך זה עובד?

CoinTracker תומך בלמעלה מ-10,000 מטבעות קריפטו ומשתלב ישירות עם TurboTax ו-H&R Block להגשת מס בארה"ב. אתה מייבא עסקאות—השירות מחשב מס הכנסה, רווחי הון והפסדים. ייבוא אפשרי דרך APIs של בורסות או CSV מותאם אישית. עבור פרוטוקולי DeFi, ארנקים נאמנים (custodial), ותרחישים מורכבים (סטייקינג, איירפדרופים, hard forks), CSV הוא הדרך היחידה.

הכנת נתונים לייצוא

CoinTracker מצפה ל-CSV עם מבנה קפדני, המתואר ב-תיעוד הרשמי של CoinTracker:

interface CoinTrackerCSVRow {
  date: string; // "Jan 15, 2025"
  receivedQuantity: string;
  receivedCurrency: string;
  sentQuantity: string;
  sentCurrency: string;
  feeAmount: string;
  feeCurrency: string;
  tag: string; // "staking" | "airdrop" | "fork" | "mining" | ""
}

function exportToCoinTrackerCSV(transactions: InternalTransaction[]): string {
  const headers = [
    "Date",
    "Received Quantity",
    "Received Currency",
    "Sent Quantity",
    "Sent Currency",
    "Fee Amount",
    "Fee Currency",
    "Tag"
  ];

  const rows = transactions.map(tx => [
    format(tx.timestamp, "MMM d, yyyy"),
    tx.amountIn?.toString() ?? "",
    tx.assetIn ?? "",
    tx.amountOut?.toString() ?? "",
    tx.assetOut ?? "",
    tx.feeAmount?.toString() ?? "",
    tx.feeCurrency ?? "",
    mapToTag(tx.taxCategory),
  ].join(","));

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

function mapToTag(category: TaxCategory): string {
  const tagMap: Partial<Record<TaxCategory, string>> = {
    [TaxCategory.STAKING_REWARD]: "staking",
    [TaxCategory.AIRDROP]: "airdrop",
    [TaxCategory.HARD_FORK]: "fork",
    [TaxCategory.MINING_REWARD]: "mining",
  };
  return tagMap[category] ?? "";
}

שימו לב: הפונקציה interface CoinTrackerCSVRow { date: string; // "Jan 15, 2025" receivedQuantity: string; receivedCurrency: string; sentQuantity: string; sentCurrency: string; feeAmount: string; feeCurrency: string; tag: string; // "staking" | "airdrop" | "fork" | "mining" | "" } function exportToCoinTrackerCSV(transactions: InternalTransaction[]): string { const headers = [ "Date", "Received Quantity", "Received Currency", "Sent Quantity", "Sent Currency", "Fee Amount", "Fee Currency", "Tag" ]; const rows = transactions.map(tx => [ format(tx.timestamp, "MMM d, yyyy"), tx.amountIn?.toString() ?? "", tx.assetIn ?? "", tx.amountOut?.toString() ?? "", tx.assetOut ?? "", tx.feeAmount?.toString() ?? "", tx.feeCurrency ?? "", mapToTag(tx.taxCategory), ].join(",")); return [headers.join(","), ...rows].join("\n"); } function mapToTag(category: TaxCategory): string { const tagMap: Partial<Record<TaxCategory, string>> = { [TaxCategory.STAKING_REWARD]: "staking", [TaxCategory.AIRDROP]: "airdrop", [TaxCategory.HARD_FORK]: "fork", [TaxCategory.MINING_REWARD]: "mining", }; return tagMap[category] ?? ""; } היא קריטית. אם לא תציין תגית לתגמולי סטייקינג, CoinTracker יסווג זאת כהעברה רגילה, וינפח את בסיס המס. לפי סטטיסטיקות CoinTracker, תגיות שגויות גורמות ל-80% משגיאות חישוב המס.

למה עמודת ה-Tag היא קריטית

CoinTracker משתמש בתגית כדי לקבוע את סוג ההכנסה. לדוגמה, קיבלת 10 ETH מבריכת סטייקינג. אם tag=mapToTag, השירות מתייחס לזה כהכנסת סטייקינג (ממוסה בשיעורים רגילים). אם התגית ריקה, זה נחשב להעברה פשוטה (מס רווחי הון). הפרש השיעור יכול להגיע ל-20%. תגית שגויה מסכנת בתשלום יתר או בחסר. באחד הפרויקטים שלנו, לקוח חסך $4,200 לאחר תיקון תגיות. מיפוי התגיות האוטומטי שלנו מדויק פי 5 ממיפוי ידני. ראינו מקרים שבהם לקוחות הפסידו סכומים משמעותיים עקב סיווג שגוי.

טבלת מיפוי תגיות

CoinTracker מול Koinly: מה לבחור?

המהנדסים שלנו ערכו מעל 30 בדיקות השוואתיות של שני השירותים. לתושבי ארה"ב, CoinTracker עדיף כי הוא משתלב ישירות עם TurboTax ו-H&R Block. למדינות אחרות, Koinly עשוי להיות נוח יותר בשל פורמט ה-CSV האוניברסלי שלו. אם העסקאות שלך כוללות תרחישי DeFi מורכבים (הלוואות פלאש, החלפות בין-רשתיות), CoinTracker דורש מיפוי תגיות מדויק יותר, ואנו ממליצים על הגדרה מקצועית.

מה כולל שילוב סוהר (Turnkey)

• תיעוד: מדריך מפורט לפורמט CSV ושימוש ב-API.
• גישה: פורטל העלאת קבצים מאובטח לצוות שלך.
• הדרכה: סדנה אינטראקטיבית ליצירה ואימות ייצוא.
• תמיכה: פתרון תקלות 24/7 עם תגובה מובטחת תוך שעה.
• ניתוח עסקאות מקור וזיהוי סוגים (סטייקינג, איירפדרופ, hard fork, כרייה, העברה).
• מיפוי כל הקטגוריות לתגיות CoinTracker.
• יצירת קובץ CSV שתואם בדיוק לפורמט.
• בדיקות על נתוני דוגמה עם אימות שגיאות.
• מתן סקריפט מוכן לשימוש לייצוא שוטף.
• אחריות לתקינות הנתונים—אם תמצא שגיאה לאחר השילוב, נתקן אותה תוך 24 שעות.

הבחירה תלויה בתחום השיפוט. לתושבי ארה"ב, CoinTracker עדיף. לאחרים, Koinly עשוי להיות קל יותר.

התהליך שלנו

1. ניתוח—אנו מקבלים את מסד הנתונים של העסקאות שלך ומזהים את כל הסוגים הייחודיים.
2. עיצוב—אנו בוחרים אסטרטגיית מיפוי ומטפלים במקרים מורכבים (למשל, הלוואות פלאש או החלפות בין-רשתיות).
3. יישום—אנו כותבים סקריפט ב-TypeScript או Python באמצעות ספריות כמו staking, ethers.js ו-viem.
4. בדיקות—אנו מריצים על נתונים היסטוריים ומצליבים עם חישובי CoinTracker.
5. פריסה—אנו מגדירים ביצוע אוטומטי (CRON או GitHub Actions) עם משלוח CSV במייל.

טעויות נפוצות בשילוב עצמי

• תגיות חסרות לסטייקינג ואיירפדרופים.
• פורמט תאריך שגוי (החודש חייב להיות מקוצר: Jan, Feb, ...).
• עמודת Tag חסרה או ערך ריק לעסקאות הכנסה.
• שימוש במפרידים עשרוניים שאינם בתקן (פסיק במקום נקודה).

Date,Received Quantity,Received Currency,Sent Quantity,Sent Currency,Fee Amount,Fee Currency,Tag
Jan 15,2025,100,ETH,,,0.005,ETH,staking
Jan 16,2025,,,50,USDC,0.001,ETH,