Keep each record tied to its source ID. Use the references below to choose field owners and preserve relationships between records.
Business process
Invoice / Orders
Order-to-invoice handoff: Shopify Orders provides context for Campfire Invoice. These are related records, not equivalent entities.
Use writable fields from the connected accounts. Read values from read-only fields without writing changes back to them, and define deletion handling separately.
- Campfire
- Documented record · Incremental: ✅; historical: ✅; delete detection: ✅
- Shopify
- Documented record · ✅ Supported
- Record identity
- Link order and line IDs to invoice and line IDs; allow partial invoicing and multiple invoices per order.
- Field ownership
- Finance owns invoice posting; the order system supplies the approved commercial context.
Fields to include
- Source record reference
- Destination record reference
- Approved handoff state
- Duplicate-detection key
- Record dependencies
- Create or locate the customer and products first; resolve taxes, currency, and fulfillment references.
- Validation
- Test a partially invoiced order, tax rounding, and a repeated handoff without generating another invoice.
- Recovery
- Check for an existing destination order before retrying a timed-out create; reconcile line IDs to avoid duplicate fulfillment.
References: Campfire: Invoice documentationShopify: Orders documentation
Record matching
Product / Products
Compare whether Campfire Product and Shopify Products describe the same product or catalog item in your business.
Use writable fields from the connected accounts. Read values from read-only fields without writing changes back to them, and define deletion handling separately.
- Campfire
- Documented record · Incremental: ✅; historical: ✅; delete detection: ✅
- Shopify
- Documented record · ✅ Supported
- Record identity
- Distinguish the product ID, variant ID, SKU, and price-list entry; they are not interchangeable keys.
- Field ownership
- Assign ownership for catalog content, price, and stock separately.
Fields to include
- Source product ID
- SKU or variant reference
- Description
- Unit of measure
- Price-list reference
- Record dependencies
- Resolve units, variants, categories, and applicable price lists before order lines.
- Validation
- Test two variants of one product, a changed SKU, and a price that applies to only one market or currency.
- Recovery
- Repair the variant or price-list reference before retrying affected order lines; preserve existing transaction prices.
References: Campfire: Product documentationShopify: Products documentation