Commerce glossary

Import, supplier sync and export

Bringing products, customers and reviews into the store from files, other platforms and suppliers, keeping supplier stock and prices in step afterwards, and exporting the store's data back out.

41 parts and 14 phrases. Apps in this area include Matrixify, DSers, CJdropshipping, Syncee, Spocket, AutoDS, Shopify Store Importer.

Ongoing syncimport.syncShowWhat keeps the store and a supplier in step after the first import.
Stock and price syncimport.sync.catalogShowKeeping supplier stock and prices in step with the store after the first import.

How to extend

  • ProviderMany side by sidesupplier syncA supplier plugin pushes stock and price changes for the products linked to it.
  • EventMany side by sideevent.inventory.adjustedevent.product.updatedA sync plugin pushes the store's own changes back out when stock or a product changes.
PartLitestore todayHow to extend
Stock syncimport.sync.catalog.stockStock sync copies the supplier's stock count onto the linked variant when it changes.
Planned
Provider · manyEvent · many
Price syncimport.sync.catalog.pricePrice sync updates the linked variant's price when the supplier's cost changes, applying the markup rule.
Planned
Provider · manyEvent · many
Nightly checkimport.sync.catalog.nightly_reconcileA nightly check compares every linked product with the supplier and corrects any difference missed during the day.
Planned
Provider · manyEvent · many
Discontinued product handlingimport.sync.catalog.discontinuedThis rule hides or zeroes a store product when the supplier stops selling it.
Plugin
Provider · manyEvent · many
Supplier ordersimport.sync.ordersShowPassing paid orders to the supplier who ships them, and bringing tracking back.

How to extend

  • EventMany side by sideevent.order.paidA dropshipping plugin places the supplier order when a store order is paid.
  • ProviderMany side by sidesupplier syncThe same supplier plugin writes tracking numbers back to the store order.
PartLitestore todayHow to extend
Order forwardingimport.sync.orders.forwardOrder forwarding places an order with the supplier for the items in a paid store order, with the buyer's address.
Plugin
Event · manyProvider · many
Supplier paymentimport.sync.orders.auto_paySupplier payment pays the supplier for a forwarded order from a stored card or balance.
Plugin
Event · manyProvider · many
Tracking syncimport.sync.orders.trackingTracking sync copies the supplier's tracking number onto the store order's shipment.
Plugin
Event · manyProvider · many
Mark as shippedimport.sync.orders.auto_fulfilThis step marks the store order as shipped once the supplier's tracking number arrives.
Plugin
Event · manyProvider · many
Sourcesimport.sourceShowWhere the imported records come from.

How to extend

  • ProviderMany side by sideimporter sourceA plugin adds another source, such as a supplier catalogue or another shop platform, beside the built-in ones.
  • Assistant toolMany side by sideextractProductDataThe assistant reads a product page at a web address and drafts a product from it.
PartLitestore todayHow to extend
CSV fileimport.source.csvA CSV file import reads rows from a comma-separated file, one record per row, against a fixed column template.
Coremodules/products/admin/import-csv.ts
Provider · manyAssistant tool · many
Spreadsheet fileimport.source.spreadsheetA spreadsheet import reads records from an Excel or Google Sheets file with several sheets.
Plugin
Provider · manyAssistant tool · many
Another store platformimport.source.platform_apiA platform import signs in to a store on another commerce platform and reads its products and customers through that platform's API; Litestore reads Shopify stores today.
Coremodules/integrations/import/shopify/client.ts
Provider · manyAssistant tool · many
Product web addressimport.source.product_urlA product web address import reads one product page and drafts a product from its title, price, images and text.
Coremodules/assistant/extract-product.ts
Provider · manyAssistant tool · many
Supplier marketplaceimport.source.supplier_marketplaceA supplier marketplace source lists products from many suppliers that the store adds to its catalogue.
Plugin
Provider · manyAssistant tool · many
Supplier feedimport.source.supplier_feedA supplier feed is a file or API from one supplier that holds its current products, stock and prices.
Planned
Provider · manyAssistant tool · many
Review importimport.source.reviewsA review import reads past reviews from a file and attaches them to matching products.
Coremodules/integrations/import/reviews.ts
Provider · manyAssistant tool · many
Customer importimport.source.customersA customer import creates customer records with their addresses from another store's data.
Coremodules/integrations/import/runtime/import-customers.ts
Provider · manyAssistant tool · many
Creator importimport.source.creatorsA creator import reads a file of creators and sets them up as collaborators with their links.
Coremodules/integrations/import/collabs.ts
Provider · manyAssistant tool · many
Order history importimport.source.ordersAn order history import copies past orders from another store so customer histories stay complete.
Plugin
Provider · manyAssistant tool · many
Mappingimport.mappingShowHow each incoming record is matched to and turned into a store record.

How to extend

  • ProviderMany side by sideimporter sourceEach source plugin brings its own field mapping onto the store's product shape.
PartLitestore todayHow to extend
Column templateimport.mapping.column_templateA column template lists the columns an import file must have, with a sample file to download.
Coremodules/integrations/import/csv/schemas.ts
Provider · many
Field mappingimport.mapping.field_mappingField mapping pairs each column or field in the source with a store field, set by hand per import.
Plugin
Provider · many
SKU matchimport.mapping.sku_matchSKU matching links an incoming variant to an existing one when their SKUs are equal.
Coremodules/integrations/import/runtime/import-products.ts
Provider · many
Change checkimport.mapping.change_checkA change check stores a hash of each source record and skips records whose hash has not changed.
Coremodules/integrations/import/runtime/reconcile.ts
Provider · many
Image importimport.mapping.imagesImage import downloads each product's pictures from the source and attaches them to the new product.
Coremodules/integrations/import/runtime/import-products.ts
Provider · many
Variant groupingimport.mapping.variant_groupingVariant grouping keeps a source product's variants and their option values together under one store product.
Coremodules/integrations/import/shopify/mapper.ts
Provider · many
Create missing tagsimport.mapping.create_relationsThis setting creates tags and categories named in the source that do not exist in the store yet.
Coremodules/integrations/admin/shopify-import-actions.ts
Provider · many
Price markup ruleimport.mapping.price_markupA price markup rule sets the selling price from the supplier's cost, such as cost times two or cost plus a fixed amount.
Plugin
Provider · many
Running an importimport.runShowHow one import is started, checked and recorded.

How to extend

  • Core onlyRun records and per-row error reports stay in core so every source reports the same way.
PartLitestore todayHow to extend
Dry runimport.run.dry_runA dry run reads and checks the whole source and reports what would change without saving anything.
Coremodules/integrations/admin/shopify-import-actions.ts
Core only
Create or updateimport.run.create_or_updateThis setting picks whether matched records are updated or left as they are while new ones are created.
Coremodules/integrations/import/runtime/import-products.ts
Core only
Full or changes onlyimport.run.full_or_incrementalThis setting picks whether a run reads every record or only those changed since the last run.
Coremodules/integrations/import/types.ts
Core only
Error reportimport.run.error_reportAn error report lists each row that failed, with the reason, so it can be fixed and imported again.
Coremodules/integrations/import/runtime/errors.ts
Core only
Run recordimport.run.run_recordA run record stores each import's source, status, counts of created, updated and skipped records, and timing.
Coremodules/integrations/import/runtime/checkpoints.ts
Core only
Safe re-runimport.run.rerunA safe re-run imports the same source again and updates the linked records instead of making copies.
Coremodules/integrations/import/runtime/reconcile.ts
Core only
Resume from checkpointimport.run.resumeA resume restarts a stopped run from the last saved position instead of from the start.
Plugin
Core only
Scheduled importimport.run.scheduleA scheduled import runs the same import again at a set interval, such as every night.
Plugin
Core only
Exportimport.exportShowWriting the store's records out to a file.

How to extend

  • ProviderMany side by sideexporterA plugin adds another export format or destination.
PartLitestore todayHow to extend
Product exportimport.export.productsA product export writes products and their variants, prices and stock to a CSV file.
Coremodules/integrations/export/products.ts
Provider · many
Customer exportimport.export.customersA customer export writes customer records to a CSV file.
Coremodules/integrations/export/customers.ts
Provider · many
Order exportimport.export.ordersAn order export writes orders and their totals to a CSV file.
Coremodules/integrations/export/orders.ts
Provider · many
Export field choiceimport.export.field_choiceThe export field choice picks which columns go into the file.
Coremodules/integrations/export/product-export-fields.ts
Provider · many
Scheduled exportimport.export.scheduledA scheduled export writes the same file at a set interval and sends it to a storage address.
Plugin
Provider · many

What the phrases mean

The words apps use for a feature, and the plain parts the feature is made of, in the order they happen.

Phrases left out

These phrases mean different things at different apps, so the glossary doesn't map them.

  • syncVendors use it for a one-time import, a nightly stock update and a two-way live link alike.
  • auto-updateIt means stock-only updates at some vendors and full product rewrites at others.
  • print on demandIt covers product design tools and production partners as well as order forwarding, so it is not one part of importing.

Sources

The app documentation these parts were checked against.