Let's talk
E-commerce and retail

Fairshop

Thirty small agents that check an online or multichannel store's back office from the files it already exports, payouts, marketplace fees, returns, sales tax, inventory, shipping and purchasing, and wait for one named person before anything is sent, filed or changed.

A shopping bag and a parcel beside a payout slip with a check

Engagements

$1,000 · One store

Payouts check

Every order matched to its payout, money held in processor reserves, and one journal entry per marketplace settlement (3 agents)

$2,000 · One Amazon seller

Marketplace money back

FBA reimbursements with claim-by dates, storage and aged-inventory fees, fees against your schedule, A-to-z and other claims (4 agents)

$2,000 · One store

Returns and promotions

Refunds against returns received, return reasons, discount codes, gift card liability, failed subscription payments, affiliate commissions (6 agents)

$1,500 · One store

Sales tax pack

Tax collected against the rates and rules you confirm by state, marketplace orders kept apart, and sales against the nexus thresholds you set (2 agents)

$2,500 · One store

Inventory and listings

Stock against channel listings, stockouts, product data, duplicate listings, MAP prices, SKU margins and ad spend (7 agents)

$2,500 · One business

Shipping and purchasing

Label cost against shipping charged, carrier adjustments, 3PL invoices, PO receiving, landed cost and retailer deductions (6 agents)

$1,000 · Up to 3 shops

Store cash and shrink

Register drawers and bank deposits, and shrink by store and category (2 agents)

$7,500 · One business

Whole shop

All 30 agents, mapped to your exports and set to the rules you confirm, one training session

$10,500 · 2 to 4 brands or stores

Multi-brand business

Whole shop for each brand, store or marketplace account, each one's exports mapped and settings confirmed separately

$15,000 · Up to 15 clients

Partner rollout

For e-commerce bookkeepers, Amazon agencies and operations consultants serving many sellers: all 30 agents, one shared setup, every client's exports mapped with its own settings

Support after setup: $200 a month for one pack, $450 a month for the whole shop, $250 a month per brand or per client for multi-brand businesses and partner rollouts. Includes export changes, settings updates when a marketplace or carrier changes its terms, new versions and a monthly check-in.

Reads the files you export; it does not log in to your store, a marketplace, a payment processor, a carrier, your 3PL or your bank.

Fee schedules, reserve terms, rate cards, MAP lists, claim and dispute windows are settings you confirm; the agents do not know a marketplace's or carrier's current terms.

Sales tax rates, marketplace facilitator rules and nexus thresholds are settings you confirm with your adviser; nothing here is tax advice and no agent files a return or registers with a state.

Export layouts for Shopify, WooCommerce, BigCommerce, Amazon Seller Central, eBay, Etsy, Walmart, Stripe, PayPal, Square, ShipStation, Shippo and the ad platforms were written from knowledge of those exports and not checked against live accounts. Shopify's current product export, its inventory export and WooCommerce's product export were also run on the vendors' own published sample files (19 Nov 2026). The first setup confirms every layout on your files.

Lost sales, reimbursement values and aged-inventory surcharges are estimates from your own files and are marked as such.

Not legal, tax or accounting advice.

Report pages come in nine languages, translated by Claude and not yet reviewed by native speakers.

Your files and reports stay on your computer. Shopper names, e-mails, phone numbers, addresses, staff names and affiliate names are masked in what the AI model sees; free-text notes and reasons are sent as typed. No agent refunds, charges, pays, reprices, changes a listing or a discount code, files a tax return, registers with a state, opens a marketplace case or messages anyone: drafts wait for one named person.

Thirty checks.

Payouts, fees and marketplace money
Payouts, fees and marketplace money

Payouts

Orders against payout lines by channel: never paid out, paid short, paid twice, refunds not yet deducted, fees above your rate.

Payouts, fees and marketplace money

Marketplace Fees

Every marketplace fee line against the fee schedule you confirm, and fee rates that moved month to month.

Payouts, fees and marketplace money

FBA Reimbursements

Lost and damaged FBA units, refunds with no return and low reimbursements, each with a claim-by date.

Payouts, fees and marketplace money

FBA Storage Fees

Storage fees against your rates, and inventory lots about to cross into the next aged-inventory bracket.

Payouts, fees and marketplace money

Processor Reserves

Stripe, PayPal and Shopify reserves: releases overdue, holds above your terms, releases coming up.

Payouts, fees and marketplace money

Settlement Journals

One balanced journal entry per marketplace settlement from your account map, matched to the bank deposit.

Payouts, fees and marketplace money

Marketplace Claims

A-to-z, eBay, Walmart and Etsy claims against your tracking: respond-by dates and what your records prove.

Returns, refunds and customers
Returns, refunds and customers

Refunds Returns

Refunds whose item never came back, returns never refunded, refunds paid twice or above the price.

Returns, refunds and customers

Return Reasons

Why things come back, by SKU, and customers who return most of what they buy (masked).

Returns, refunds and customers

Coupon Abuse

Discount codes used past their limit, out of date, under the minimum, or by returning shoppers.

Returns, refunds and customers

Gift Cards

Gift card and store credit liability by age, and cards whose balances do not add up.

Returns, refunds and customers

Subscriptions

Failed payments not retried, retries used up, cards about to expire, and churn by cause.

Returns, refunds and customers

Affiliate Commissions

Commissions on refunded or missing orders, above your rate, paid twice, or on own-link purchases.

Sales tax
Sales tax

Sales Tax

Tax collected on each order against the rates and rules you confirm, by state, with marketplace orders apart.

Sales tax

Nexus Thresholds

Sales and orders by state against the thresholds you confirm, with the date each was met.

Inventory, listings and pricing
Inventory, listings and pricing

Inventory Listings

Stock by location against what each channel lists: oversell risk, missed sales and stock listed nowhere.

Inventory, listings and pricing

Stockouts

Days out of stock, orders taken with nothing on hand, and SKUs to reorder before they run out.

Inventory, listings and pricing

Product Data

Missing GTINs, brands, weights and images, titles over your limits and GTINs with a wrong check digit.

Inventory, listings and pricing

Duplicate Listings

The same SKU listed twice, look-alike titles, shared GTINs and listings for SKUs you do not carry.

Inventory, listings and pricing

MAP Pricing

Advertised prices against your MAP list: your own listings first, then resellers and repeat ones.

Inventory, listings and pricing

SKU Margins

Contribution margin per SKU and channel after fees, labels and unit cost.

Inventory, listings and pricing

Ad Spend

Campaigns under your target return, spend with no sales, ads on out-of-stock SKUs, and over-attribution.

Shipping, fulfilment and purchasing
Shipping, fulfilment and purchasing

Shipping Costs

Shipping charged against labels bought: losses, free shipping under your threshold, duplicate and unrefunded labels.

Shipping, fulfilment and purchasing

Carrier Adjustments

Carrier adjustments your own label data disproves, and SKUs whose packaging data keeps causing them.

Shipping, fulfilment and purchasing

3PL Invoices

A 3PL invoice against your rate card and your own order, receipt and pallet counts.

Shipping, fulfilment and purchasing

PO Receiving

Purchase orders, receipts and supplier invoices matched: billed not received, billed twice, price above the PO.

Shipping, fulfilment and purchasing

Landed Cost

Freight, duty and broker costs spread over each shipment's SKUs, against the cost recorded in your store.

Shipping, fulfilment and purchasing

Retailer Deductions

Retailer deductions your proof of delivery or agreements disprove, with dispute dates.

Physical stores
Physical stores

Cash Over Short

Register drawers over or short, and deposits missing or different from the counted cash.

Physical stores

Store Shrink

Shrink by store and category against sales, unexplained losses and SKUs written off again and again.

Each one does one job, on your computer, from a file you export. Nothing is refunded, paid, repriced, filed or sent until a named person says so. Pairs with G6daddy's e-commerce AI agent for the shop front and 11:11 Websites' store package; these check the back office.

Measured in the final pass, 19 Nov 2026

Measured, not promised.

158 of 158planted problems found
0false alarms on 380 clean rows
82 of 82one-change tests caught
5public data sources run

On fictional test data, 19 Nov 2026. The clean set covers 28 of the 30 agents: marketplace claims and carrier adjustments give every open claim or adjustment a finding that says how to answer it, so a file of them never has zero findings. 64 planted near-misses (inside a window, under a threshold, exempt) gave no finding. This pass found and fixed one wrong finding on fictional data (an FBA unit lost in the warehouse was reported as damaged) and six kinds of wrong finding on the vendors' own sample files (product and inventory layouts). The test files and the checks were written by the same team, so these numbers show the rules do what they say. How often they are right on your own files is measured at your setup.

Run it yourself

git clone https://github.com/fpavia111-creator/fairshop-agents
cd fairshop-agents
npm install
node packages/fairshop-payouts/bin/fairshop-payouts.js demo

Open source, MIT licence, on GitHub: fpavia111-creator/fairshop-agents. Needs Node.js 20 or later. The demo runs on made-up files and needs no network and no setup.

Common problems it finds

  • Orders never paid out or paid short by a marketplace (an Amazon order paid 2.00 short in the demo week).
  • Fees above your schedule: a 20% referral charged on a home item, a fulfilment fee 0.88 above the fixed amount.
  • FBA units lost in the warehouse and never reimbursed, and refunds whose return never came back, each with a claim-by date.
  • Refunds paid twice or above the price, and items received back that were never refunded.
  • Affiliate commission paid on refunded orders, or at a rate above your terms.
  • Listings that can oversell what the warehouse can ship, and stock sitting on a shelf with no live listing.
  • Shipping labels costing more than the customer was charged, and voided labels never refunded.
  • Retailer deductions your signed proof of delivery disproves, and promo allowances above what was agreed.

Run on public data

SourceWhat ran and what it foundLicence
UCI Machine Learning Repository: Online Retail (a real UK online gift shop, Dec 2010 to Dec 2011)
2026-11-19
fairshop-return-reasons on all 541,909 published rows, read from the published Excel file in 20 seconds (cancellations stand in for returns): 127 stock codes returned at 15% or more and 183 customers who cancelled most of their orders; 0 disagreements with an independent re-count. Two of the 127 were not products (manual adjustments, bank charges), so an ignore_skus setting was added.CC BY 4.0
UCI Machine Learning Repository: Online Retail (same file, the shop's catalogue)
2026-11-19
fairshop-duplicate-listings on 3,812 real product titles: 32 listings whose title cannot be told apart from another stock code's; 0 disagreements with a brute-force comparison of all 7.3 million pairs. Read by hand, most look like colour or size variants whose titles leave the variant out.CC BY 4.0
Shopify product CSV template and inventory CSV template (Shopify's own sample files)
2026-11-19
fairshop-product-data and fairshop-inventory-listings. Found four problems, now fixed: the current product layout was not recognised, variant rows were reported as missing their title and brand (Shopify writes those on the first row only), digital products were asked for a weight, and a stock row with no SKU was reported as a SKU named "". After the fixes, every finding was checked by hand: 0 wrong.Published by Shopify as samples for its importer
WooCommerce sample_products.csv
2026-11-19
fairshop-product-data on 25 sample products. Every row had been reported as missing its price and weight (WooCommerce names them differently and keeps them on variations); a WooCommerce layout was added. Now the only findings are the barcode and brand columns this export does not have: 0 wrong.GPL-3.0
Open Food Facts product database (400 products through its public search API)
2026-11-19
fairshop-product-data on 400 real barcodes: 2 fail the GS1 check digit and 17 products lack a name or brand; 0 disagreements with an independent check-digit re-count. Support for 8-digit UPC-E codes was added on the way.ODbL 1.0 (database), DbCL 1.0 (contents)

Public, lawful files only; no private data was used. The files are not copied into the repository: a script there downloads them again.

What a person still decides

PackageWhat a person reviews and decides
Payouts checkA bookkeeper confirms each unpaid, short or doubled payout against the marketplace or processor statement and sends any inquiry; a person reviews and posts each settlement journal entry.
Marketplace money backA person checks each FBA claim, storage fee and fee dispute against Seller Central before filing it, and writes and submits every claim response; nothing is filed or answered by the agents.
Returns and promotionsCustomer service decides each refund, chase and reminder; a manager decides what to do about a discount code or a repeat returner; finance confirms gift card liability and every affiliate reversal before payout.
Sales tax packYour tax adviser confirms the rates, registrations and thresholds in the settings and decides every filing and registration; the agents only compare and draft a worksheet.
Inventory and listingsA merchandiser decides each listing, price, reorder and ad change in the channel itself; the agents never change a listing, price, budget or purchase order.
Shipping and purchasingSomeone in operations disputes carrier, 3PL and retailer charges in each portal, approves supplier invoices and updates product costs; drafts are sent only by a person.
Store cash and shrinkA store manager talks through each drawer shortage and missing deposit with the staff involved and decides on any recount; shrink figures are for the manager, not for staff records.
Whole shopEvery finding in every pack goes to a named person, who looks and acts; the agents only read files and write reports and drafts.
Multi-brand businessEach brand or account owner reviews their own findings, and settings (fees, tax, thresholds) are confirmed separately for each one.
Partner rolloutThe firm's staff review each client's findings and confirm each client's settings with that client before acting on anything.
Export formats (38): 3 tested on a real or public file, 35 not yet tested on a real export.
SystemReport or exportStatus
ShopifyInventory > Export (CSV), one row per variant and locationTested on a public sample
ShopifyProducts > Export (CSV), current layout ("URL handle", "Variant Barcodes")Tested on a public sample
WooCommerceProducts > Export (CSV), built-in product exporterTested on a public sample
3PL (generic)Invoice detail export, one row per chargeNot yet tested on a real export
Affiliate network (generic)Actions or transactions report (CSV)Not yet tested on a real export
Amazon AdsSponsored Products campaign reportNot yet tested on a real export
Amazon Seller CentralA-to-z Guarantee claims (Performance > A-to-z Guarantee claims, exported)Not yet tested on a real export
Amazon Seller CentralAll Listings reportNot yet tested on a real export
Amazon Seller CentralFBA Customer Returns reportNot yet tested on a real export
Amazon Seller CentralFBA Inventory Adjustments reportNot yet tested on a real export
Amazon Seller CentralFBA Reimbursements reportNot yet tested on a real export
Amazon Seller CentralInventory Ledger, detailed viewNot yet tested on a real export
Amazon Seller CentralMonthly Storage Fees reportNot yet tested on a real export
Amazon Seller CentralPayments > Date range report (transaction view)Not yet tested on a real export
Amazon Seller CentralSettlement report, flat file V2Not yet tested on a real export
BigCommerceOrders > Export (default template)Not yet tested on a real export
EtsyPayment account > Download CSVNot yet tested on a real export
Google AdsCampaigns report (CSV)Not yet tested on a real export
Meta Ads ManagerCampaigns export (CSV)Not yet tested on a real export
PayPalActivity > Download (CSV)Not yet tested on a real export
RechargeSubscriptions export (CSV)Not yet tested on a real export
ShipStationShipments > Export (CSV)Not yet tested on a real export
ShippoTransactions export (CSV)Not yet tested on a real export
Shopify POSCash tracking sessions export (CSV)Not yet tested on a real export
Shopify PaymentsPayouts > Export transactions (CSV)Not yet tested on a real export
ShopifyOrders > Export (CSV)Not yet tested on a real export
ShopifyOrders > Export (CSV), discount columnsNot yet tested on a real export
ShopifyProducts > Export (CSV), classic layout ("Handle", "Variant SKU")Not yet tested on a real export
SquareCash drawer report (CSV)Not yet tested on a real export
SquareInventory > History export (CSV)Not yet tested on a real export
Stripe BillingSubscriptions export (CSV)Not yet tested on a real export
StripeBalance > Balance transactions export (CSV)Not yet tested on a real export
UPS Billing CenterBilling data, adjustment lines (CSV with header row)Not yet tested on a real export
USPS (via your shipping platform)Automated Package Verification adjustments exportNot yet tested on a real export
Walmart Seller CenterPayments > Reconciliation reportNot yet tested on a real export
WooCommerceOrders export (CSV)Not yet tested on a real export
eBay Seller HubListings > Active > Download report (CSV)Not yet tested on a real export
eBay Seller HubPayments > Reports > Transaction report (CSV)Not yet tested on a real export

No layout has yet been tested on a customer's own export. Every setup starts by confirming the layout on your files, and any column can be mapped by hand.

Security

What reaches the AI model

When an assistant calls a tool, its model sees the result: totals, findings, amounts, quantities, dates, rates, SKUs, order, listing and tracking numbers and finding codes in clear, and text such as product titles, campaign names, seller names, and return and cancel reasons exactly as they were typed. Shopper names and e-mails become stable pseudonyms such as CUS-3f9a2c1b, staff names STAFF-…, affiliate names AFF-…, street addresses [ADDRESS], phone numbers [PHONE] and card numbers [CARD] (checked in the 9 agents that read personal data with 58 planted fictional values: 0 leaks). Free text is sent as typed unless it contains a name already read from a personal column. The report and draft files written on your computer keep the real values. Results go to whatever model your assistant uses; for shopper or staff data, use a model covered by your own agreements or a local model.

Support

Who keeps the rules current

Every rule that changes with a marketplace, carrier, processor or state is a setting, not code: fee schedules, FBA storage rates and aged-inventory brackets, sales tax rates and registrations, nexus thresholds, reserve terms, MAP lists, affiliate and 3PL rates, payout timing and claim windows. Most ship with no real value at all (the demo values are fictional); a few have a built-in default that mirrors a vendor rule as of November 2026 (FBA claim windows, the dimensional weight divisor, carrier dispute and label refund windows), listed with where each lives in docs/rules-2026-11-19.md. Your own values go in each agent's settings file, and every result names the settings files it used. You change the file yourself, or support updates it when a vendor or state announces a change.

How a setup runs.

1

You export the files

We send the list of reports by name. You export them from the systems you already use; nothing is connected.

2

Setup on your computer

Over a shared screen: the checks are installed, your columns are matched, and your own rules and dates are set.

3

The first report

The checks run on your files. We go through the worklist with you, and every flagged row is a person's call.

4

After that

You run them whenever you like. Support keeps the dated rules and the export layouts current.

A fixed scope and a fixed price, agreed before any work starts. Your files stay on your computer the whole time.

A sample report.

Written by the check itself on made-up files. Every person, business and number is invented.

Payouts against orders All samples

The first page of the Payouts against orders sample report