Migrations

Let your AI agent move your store over

Consignors, balances and inventory from a spreadsheet, ConsignCloud, SimpleConsign, Ricochet or Shopify. Your agent reads the export and brings it in over the RecircleOS API, asking you only what it can't work out.

Agent skill (SKILL.md)Agent quickstart

POST /v1/items
{
  "title": "Navy rib crew",
  "price_cents": 12800,
  "account_id": "acc_…",
  "split_bps": 6000
}

Start here

Paste one of these into your agent

Claude, ChatGPT, or any agent that can make web requests. Attach your export. It starts a RecircleOS sandbox if you don't have a store yet, and sends you a link to claim it when it's done.

From a spreadsheet

Move my consignment shop into RecircleOS. Read https://recircleos.com/skills/migrate/SKILL.md and follow it. My consignors and inventory are in the attached spreadsheet. Ask me before assuming anything about splits or balances, then send me the claim link.

From ConsignCloud

I'm switching from ConsignCloud to RecircleOS. Follow https://recircleos.com/skills/migrate/SKILL.md. Here are my accounts and items exports. Bring over every consignor with their balance, then the active inventory, and tell me what you couldn't map.

From Shopify

Set up my resale store on RecircleOS from my Shopify product export (attached), following https://recircleos.com/skills/migrate/SKILL.md. In my shop the Vendor column is the consignor.

Getting your data out

Where it comes from

Excel or Google Sheets

Share the workbook, or save each sheet (consignors, inventory) as CSV.

Hand-made sheets vary most. Item names are often in a “Description” column; consignors may be referenced by name, number, or email.

ConsignCloud

Export accounts and items to CSV from ConsignCloud. On a plan with API access, the agent can read them straight from the ConsignCloud API instead — RecircleOS uses the same shapes, so records map field for field.

“Split” is already the consignor’s share (0–1). Tag prices are in dollars in CSV exports, cents over their API.

SimpleConsign

Export the consignor list and the inventory report to CSV.

Items reference consignors by “Consignor ID” — import consignors first so those IDs resolve.

Ricochet

Export consignors and inventory from the reports area to CSV.

Check whether the percentage column is the consignor’s payout or the store’s commission.

Shopify

Products → Export → CSV (all products). Customers → Export if consignors are kept as customers.

One product can span several rows (variants and extra images); rows without a price are image rows. “Vendor” is the consignor in some shops and the brand in others — ask.

How it lands

Column mapping

Consignors go in first, then items that point at them. Prices become cents, and splits are the consignor's share. Records are matched by SKU and consignor number, so a migration can safely re-run.

RecordTheir columnRecircleOSNote
ConsignorAccount #, Consignor ID, Vendor IDnumber
ConsignorName, Full Namefirst_name + last_namesplit “Last, First” too
ConsignorEmail, Phone, Address, City, State, Zipemail, phone_number, address_line_1, city, state, postal_code
ConsignorSplit, Consignor %, Payout %default_split0–1, consignor’s share
ConsignorStore %, Commissiondefault_split = 1 − valueonly once the owner confirms it’s the store’s cut
ConsignorBalance, Amount OwedPOST /balance-entriesopening balance, cents
ItemSKU, Item #, Tag #, Barcode, Variant SKUskualso the re-run key
ItemTitle, Item Name, Description, Producttitle
ItemPrice, Tag Price, Retail, Variant Pricetag_pricecents: $45.00 → 4500
ItemCost, Cost per itemcost_percents
ItemQty, Quantity, On Hand, Variant Inventory Qtyquantityrequired; 1 if absent
ItemConsignor, Account, Consignor IDaccountthe consignor’s RecircleOS id
ItemBrand, Designer · Color · Size · Conditionbrand · color · size · details
ItemCategory, Type, Tagstags (or category via /item-categories)
ItemExpires, Expiration DateexpiresYYYY-MM-DD

What your agent asks you

Only the things that move money

Taxes, time zone, receipts and the rest are settings you can change later in the dashboard, or ask your agent to.

Moving a store with no agent?

Start a store and add records in the dashboard, or book a hand-held switch with our team.