skills/data-analytics/marketplace-fee-reconciliation/SKILL.md
Reconcile and analyze seller fees from Amazon, eBay, Walmart, and Etsy with net revenue calculation, fee categorization, and optimization recommendations
npx skillsauth add finsilabs/awesome-ecommerce-skills marketplace-fee-reconciliationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Selling on marketplaces like Amazon, eBay, Walmart, and Etsy introduces a complex layer of fees that significantly impact net profitability. Amazon alone has over a dozen distinct fee types: referral fees, FBA fulfillment fees, storage fees, advertising fees, return processing fees, and more. These fees are deducted before disbursement, making it easy to lose track of how much of your gross revenue actually reaches your bank account.
Fee reconciliation is the practice of matching marketplace settlement data against your expected fee schedule, verifying that you have been charged correctly, and computing true net revenue by SKU and category.
This skill guides you through downloading settlement reports from each major marketplace, reconciling fees against expectations, and using dedicated tools to automate this process.
Amazon (Seller Central):
/finances/v0/financialEventGroups endpoint for automated downloadseBay:
Walmart Marketplace:
/payments/filepayments endpointEtsy:
Before building custom tooling, check if an existing tool handles your marketplace:
| Tool | Marketplaces Supported | Key Feature | |------|----------------------|-------------| | A2X | Amazon, Shopify, eBay, Etsy, Walmart | Reconciles marketplace settlements to QuickBooks/Xero with GAAP journal entries; fee categorization built-in | | Link My Books | Amazon, eBay, Etsy, Shopify | Automatically maps settlement data to accounting chart of accounts; fee overcharge alerts | | Getida | Amazon FBA | Specializes in Amazon reimbursement auditing; works on contingency (takes % of recovered fees) | | Seller Ledger | Amazon, eBay, Etsy, Walmart | Bookkeeping designed for marketplace sellers; fee reconciliation + tax tracking | | InventoryLab | Amazon FBA | COGS tracking, fee analysis, and profit calculation per ASIN |
A2X setup (most comprehensive):
Amazon fee categories to track separately:
| Fee Type | Amazon Label | Typical Rate |
|----------|-------------|-------------|
| Referral fee | Commission | 6–45% of selling price (varies by category) |
| FBA per-unit fulfillment | FBAPerUnitFulfillmentFee | $3–$8+ per unit (based on size/weight) |
| FBA storage fee | FBAStorageFee | $0.75–$2.40/cubic foot/month |
| Long-term storage fee | FBALongTermStorageFee | $6.90/cubic foot on inventory >365 days old |
| Return processing fee | RefundCommission | 20% of referral fee on returned items |
| Advertising (Sponsored Products) | Listed separately in Advertising reports | Varies by ACOS target |
Build a fee summary by SKU (using a spreadsheet or A2X):
For each SKU and period, calculate:
Gross Revenue
- Returns & Refunds
= Net Sales
- Referral Fees
- FBA Fulfillment Fees
- Storage Fees
- Long-term Storage Fees
- Advertising Fees
- Return Processing Fees
= Net Marketplace Proceeds
Total Fee Rate % = Total Fees / Net Sales × 100
Net Margin % = Net Proceeds / Net Sales × 100
Typical Amazon total take rate by category:
If your actual fee rate is 5%+ above these ranges, investigate for potential overcharges.
Amazon FBA fees are based on product dimensions and weight stored in their system. If Amazon has incorrect measurements for your product, you may be paying systematically higher fees on every unit shipped.
How to check for FBA measurement errors:
How to dispute an FBA measurement:
Using Getida for systematic reimbursement recovery:
Amazon charges long-term storage fees on inventory held more than 365 days, assessed on February 15 and August 15 each year. These fees can be significant — $6.90 per cubic foot.
Proactive monitoring:
Once you have fee data from multiple marketplaces, compare net margin per SKU across channels:
Example comparison for one SKU at $39.99 selling price:
| Channel | Gross Revenue | Fees | Net Proceeds | Net Margin | |---------|-------------|------|-------------|-----------| | Own Website (Shopify + Stripe) | $39.99 | $1.46 (Stripe: 2.9% + $0.30) + $5 shipping | $33.53 | 83.8% of revenue | | Amazon FBA | $39.99 | $5.99 referral (15%) + $4.50 FBA + $0.82 storage | $28.68 | 71.7% of revenue | | eBay | $39.99 | $5.20 final value (13%) + $0.30 payment + $5 shipping | $29.49 | 73.7% of revenue | | Etsy | $39.99 | $2.60 transaction (6.5%) + $0.90 payment + $0.20 listing | $36.29 | 90.7% of revenue |
This comparison shows which channel generates the most net proceeds per unit sold.
| Problem | Solution | |---------|----------| | Using marketplace payout amount as revenue | The amount deposited by Amazon is net of all fees; record gross sales as revenue and fees as cost of revenue separately | | Missing FBA inventory reimbursements | Amazon loses or damages FBA inventory and is obligated to reimburse; reconcile expected inventory against FBA inventory reports monthly; use Getida or SELLERBOARD for systematic auditing | | Not tracking fee changes in Amazon's annual fee schedule update | Amazon updates FBA fees annually (typically in January/February); update your expected fee model or reconciliation will show unexplained variances throughout the year | | Currency conversion fees ignored for international marketplaces | If selling on Amazon UK/DE/JP, currency conversion fees reduce disbursements; track separately and include in international channel profitability analysis | | Long-term storage fees as a surprise | Pull the FBA Inventory Age report 60 days before Feb 15 and Aug 15 assessment dates; take action before fees are assessed |
tools
Let shoppers save products to a wishlist, share it with friends, and get notified when saved items come back in stock or drop in price
development
Build a themeable storefront with design tokens and CSS custom properties that supports white-labeling, multi-brand variants, and dark mode
development
Speed up product discovery with instant search suggestions, fuzzy typo matching, and category-aware results powered by Algolia or Elasticsearch
development
Build a mobile-first storefront with thumb-friendly navigation, sticky add-to-cart buttons, and touch-optimized components for high mobile conversion