What are Vendor Codes in DataDoe?
Vendor codes are assigned by Amazon but are not exposed on SP API. DataDoe does not fetch vendor codes from Amazon. You upload them as a CSV file. Uploaded vendor codes are added to vendor views that contain SKU or ASIN, such as Vendor Sales, Traffic & Inventory.
Where do I upload Vendor Codes?
- Open Sellers & Vendors (opens in a new tab).
- Select a vendor. Vendor Codes upload is available for vendors only.
- Go to Upload Vendor Codes and choose your file.
What is the file format?
You can download a sample CSV (opens in a new tab).
| Column | Required | Description |
|---|---|---|
child_asin | See note | Product ASIN (10 characters). |
sku | See note | SKU this vendor code applies to. |
vendor_code | Yes | The vendor code assigned by Amazon. |
Each row must contain exactly one of child_asin or sku — never both, and never neither. Rows that don't follow this rule are rejected.
Upload vendor codes by child_asin whenever you can. Vendor sales tables, such as Vendor Sales, Traffic & Inventory, match vendor codes by ASIN only. A code uploaded only for a SKU appears in tables that have a SKU, such as Vendor Listings, but not in vendor sales tables.
Re-uploading Vendor Codes
When you upload a Vendor Codes CSV, DataDoe matches each row on the seller or vendor account, plus whichever of ASIN or SKU is present in that row.
- Matching row → the vendor code is overwritten with what is in the file.
- No match → a new row is added.
Which tables use uploaded Vendor Codes?
Look for tables that contain the vendor_code column in the Data Scheme.
How does DataDoe find missing Vendor Codes?
DataDoe compares the ASINs a vendor ordered or shipped in the last 30 days with the vendor codes you uploaded. Vendor tables show an empty vendor_code for ASINs without one.
- Upload Vendor Codes page: a warning shows how many ASINs sold in the last 30 days have no vendor code. Select Download CSV to get the list with SKU, ASIN, product name, units sold, last sale date, and reason. Add the codes and upload them.
- Email: every 5 days, DataDoe checks each vendor that has at least one vendor code row. When ASINs are missing, organization owners get one summary email for all sellers and vendors. Owners can turn it off in Settings → Account → E-Mail Notifications (Missing COGS or vendor codes).
- AI agents and apps: the MCP tool
vendor_codes_missing_listand the API endpointGET /api/v1/vendor-codes/missingreturn the same list. Export source responses includecatalogCoverageNoticewhen the latest check found missing vendor codes.
An ASIN is listed with one of these reasons:
| Reason | Meaning |
|---|---|
| No vendor code | No vendor code row matches the ASIN. |
| Vendor code mapped by SKU only | A vendor code exists for a SKU of this ASIN, but vendor sales tables match by ASIN. Upload it by ASIN. |
Need help?
If you have questions about uploading Vendor Codes or your data, contact us (opens in a new tab).