Exporting Order Data
Export order information for accounting, analysis, reporting, and compliance purposes.
Export Overview
Section titled “Export Overview”Why export orders:
- 📊 Financial reporting and accounting
- 📈 Sales analysis and trends
- 📋 Customer data management
- 🧾 Tax documentation
- 🔍 Audit and compliance
- 📬 Email marketing lists
- 💼 Business intelligence
Quick Export from Orders Page
Section titled “Quick Export from Orders Page”Simple Export
Section titled “Simple Export”- Go to Orders page
- Apply filters (optional):
- Date range
- Status
- Product
- Customer
- Click Export button
-
Choose format:
- CSV (Excel/spreadsheet)
- JSON (developer/API)
- PDF (report/printing)
-
Download file
Export Formats
Section titled “Export Formats”CSV (Comma-Separated Values):
Best for: Excel, Google Sheets, accounting softwareOpens in: Microsoft Excel, Numbers, Google SheetsFile size: SmallEncoding: UTF-8JSON (JavaScript Object Notation):
Best for: Developers, API integrations, custom toolsOpens in: Code editors, API toolsFile size: MediumUse case: Technical analysis, automationPDF (Portable Document Format):
Best for: Reports, printing, sharingOpens in: Any PDF readerFile size: LargeUse case: Management reports, presentationsCSV Export Details
Section titled “CSV Export Details”CSV Structure
Section titled “CSV Structure”Example CSV export:
Order Number,Date,Customer Name,Customer Email,Product,Status,Downloads,Total,Files#1045,2024-01-15 15:42,John Smith,john@example.com,Course Bundle,Approved,2/5,$49.99,5#1046,2024-01-15 16:20,Jane Doe,jane@example.com,Template Pack,Approved,1/5,$29.99,3#1047,2024-01-16 09:15,Bob Johnson,bob@example.com,eBook,Pending,0/5,$19.99,1CSV Columns
Section titled “CSV Columns”Standard columns included:
Order Information:
- Order Number
- Order Date
- Order Time
- Order Total
- Currency
Customer Information:
- Customer Name
- Customer Email
- Customer ID (Shopify)
- Customer Since
- Total Customer Orders
Product Information:
- Product Name(s)
- Product SKU
- Variant
- Quantity
- Price
Download Information:
- Download Status
- Downloads Used/Limit
- Link Created Date
- Link Expiry Date
- Days Until Expiry
- Last Download Date
- Total Downloads
Files:
- Number of Files
- Total File Size
- File Names (comma-separated)
Status & Fraud:
- Order Status
- Fraud Risk Level
- Fraud Score
- Approval Date
- Approved By
Opening CSV Files
Section titled “Opening CSV Files”Microsoft Excel:
- Open Excel
- File → Open
- Select CSV file
- Data imports automatically
Google Sheets:
- File → Import
- Upload CSV
- Import data
Issues with special characters:
Ensure UTF-8 encoding selectedFixes: é, ñ, ü, etc.JSON Export Details
Section titled “JSON Export Details”JSON Structure
Section titled “JSON Structure”Example JSON export:
[ { "order_number": "1045", "date": "2024-01-15T15:42:00Z", "customer": { "name": "John Smith", "email": "john@example.com", "id": "123456789" }, "products": [ { "name": "Complete Course Bundle", "price": 49.99, "quantity": 1 } ], "download": { "status": "approved", "downloads_used": 2, "downloads_limit": 5, "link_expires": "2024-03-15T15:42:00Z" }, "files": [ { "name": "01-Introduction.pdf", "size": 15728640 } ] }]JSON Use Cases
Section titled “JSON Use Cases”API Integration:
Import into custom CRMFeed data to analytics platformAutomate reporting workflowsData Analysis:
Python/R scriptsData science workflowsMachine learningCustom Tools:
Build internal dashboardsCreate custom reportsAutomate tasksPDF Export Details
Section titled “PDF Export Details”PDF Report
Section titled “PDF Report”Professional PDF report includes:
Report sections:
- Cover page with date range
- Executive summary
- Order list table
- Charts and visualizations:
- Orders over time
- Status breakdown
- Top products
- Customer distribution
- Detailed order information
- Appendix (if needed)
PDF Customization
Section titled “PDF Customization”Report options:
Include:☑ Order summary table☑ Charts and graphs☑ Customer details☐ Download history per order☐ Fraud analysis details☑ Company logo/brandingPage layout:
Orientation: Portrait | LandscapePage size: Letter | A4Margins: Normal | Narrow | WideAdvanced Export Options
Section titled “Advanced Export Options”Custom Column Selection
Section titled “Custom Column Selection”Choose specific columns:
- Click Export Options
- Select columns to include:
Order Information:☑ Order Number☑ Date☐ Time☑ Total☐ Currency
Customer:☑ Name☑ Email☐ Phone☐ Address☐ Customer Since
Downloads:☑ Status☑ Download Count☐ IP Addresses☐ Device Information
Fraud:☐ Risk Level☐ Fraud Score☐ Indicators- Export with selected columns only
Date Range Options
Section titled “Date Range Options”Predefined ranges:
○ Today○ Yesterday○ Last 7 days○ Last 30 days● Last 90 days○ This month○ Last month○ This year○ Last year○ All time○ Custom range: [From] [To]Custom range:
From: January 1, 2024To: January 31, 2024
[Export]Filter-Based Export
Section titled “Filter-Based Export”Export matches current filters:
Example workflow:
- Filter by:
Status: Approved onlyProduct: Complete Course BundleDate: Last 30 days
- Click Export
- Export includes only filtered orders
- File name reflects filters:
orders-approved-course-bundle-2024-01.csv
Scheduled Exports
Section titled “Scheduled Exports”Automatic Exports
Section titled “Automatic Exports”Set up recurring exports:
- Go to Settings → Exports
- Click New Scheduled Export
- Configure:
Export Schedule:Frequency: ○ Daily ● Weekly ○ MonthlyDay: MondayTime: 9:00 AM (shop timezone)
Export Settings:Format: CSVInclude: All approved ordersDate Range: Previous 7 days
Delivery:Email to: accounting@shop.comAlso: Upload to Dropbox (optional)- Save schedule
Email Delivery
Section titled “Email Delivery”Automatic email with export:
To: accounting@shop.comSubject: Weekly Order Export - Jan 15-22, 2024Attachment: orders-2024-01-15-to-2024-01-22.csv
Body:Attached is your weekly order export for Jan 15-22, 2024.
Summary:- Total Orders: 143- Approved: 138- Pending: 5- Total Revenue: $6,842.00
View detailed report: [Link to Dashboard]Exporting for Specific Purposes
Section titled “Exporting for Specific Purposes”Accounting/Bookkeeping
Section titled “Accounting/Bookkeeping”Recommended export:
Format: CSVColumns:- Order Number- Date- Customer Name- Customer Email- Product Name- Order Total- Status- Payment Method (from Shopify)
Frequency: Weekly or MonthlyFilter: Approved orders onlyImport into:
- QuickBooks
- Xero
- FreshBooks
- Excel spreadsheets
Tax Reporting
Section titled “Tax Reporting”Tax export setup:
Columns needed:- Order Date- Order Number- Customer Name- Customer State/Province- Customer Country- Product Name- Order Subtotal- Tax Charged- Order Total- Status
Date Range: Tax year (Jan 1 - Dec 31)Filter: Approved orders onlyEmail Marketing
Section titled “Email Marketing”Customer list export:
Columns:- Customer Name- Customer Email- Order Count- Last Order Date- Total Spent
Purpose: Import into Mailchimp, Klaviyo, etc.Filter: Approved orders, last 90 daysSales Analysis
Section titled “Sales Analysis”Analysis export:
Columns:- Order Date- Product Name- Order Total- Downloads Used- Customer Email- Fraud Risk Level
Purpose: Excel pivot tables, BI toolsDate Range: Last 12 monthsLarge Exports
Section titled “Large Exports”Handling Many Orders
Section titled “Handling Many Orders”For 10,000+ orders:
Split exports:
Export 1: Jan 1 - Mar 31 (Q1)Export 2: Apr 1 - Jun 30 (Q2)Export 3: Jul 1 - Sep 30 (Q3)Export 4: Oct 1 - Dec 31 (Q4)Performance tips:
- Limit date range to 3 months
- Export during off-peak hours
- Use JSON for faster processing
- Consider database export for very large datasets
Export Limits
Section titled “Export Limits”System limits:
CSV: Up to 50,000 orders per exportJSON: Up to 50,000 orders per exportPDF: Up to 1,000 orders (performance reasons)
File size: Up to 100 MBProcessing time: Up to 5 minutesIf exceeding limits:
- Use date ranges to split
- Export via API (unlimited)
- Contact support for custom export
API Export (Advanced)
Section titled “API Export (Advanced)”Export via API
Section titled “Export via API”For developers:
API endpoint:
GET /api/orders/export
Parameters:- format: csv|json- start_date: YYYY-MM-DD- end_date: YYYY-MM-DD- status: approved|pending|rejected|all- limit: 1-50000- offset: 0Example request:
curl -X GET \ 'https://your-app.com/api/orders/export?format=json&start_date=2024-01-01&end_date=2024-01-31&status=approved' \ -H 'Authorization: Bearer YOUR_API_KEY'Data Privacy & Security
Section titled “Data Privacy & Security”GDPR Compliance
Section titled “GDPR Compliance”Customer data export:
When customer requests data:1. Export their specific orders2. Include all personal data3. Provide in machine-readable format (CSV/JSON)4. Deliver within 30 daysAnonymized exports:
For general analysis:☑ Remove customer names☑ Hash email addresses☑ Remove IP addresses☐ Keep order numbersSecure File Handling
Section titled “Secure File Handling”Best practices:
- Don’t email exports with sensitive data
- Use secure file sharing (encrypted)
- Delete exports after use
- Limit access to exports
- Password-protect sensitive exports
Excel password protection:
File → Info → Protect Workbook → Encrypt with PasswordTroubleshooting Exports
Section titled “Troubleshooting Exports”Issue: Export File Empty
Section titled “Issue: Export File Empty”Possible causes:
- No orders match filters
- Date range has no orders
- Export processing failed
Solution:
- Clear filters
- Expand date range
- Try different format
- Refresh and retry
Issue: Export Hangs/Doesn’t Complete
Section titled “Issue: Export Hangs/Doesn’t Complete”Possible causes:
- Too many orders (>50,000)
- Network timeout
- Server busy
Solution:
- Reduce date range
- Export during off-peak hours
- Try CSV instead of PDF
- Contact support
Issue: Special Characters Look Wrong
Section titled “Issue: Special Characters Look Wrong”Problem:
Expected: José GarcíaShows: José GarcÃaCause: Encoding issue
Solution:
- Ensure UTF-8 encoding when opening
- In Excel: Data → Get Data → From CSV → UTF-8
- Use Google Sheets (handles UTF-8 automatically)
Issue: Dates in Wrong Format
Section titled “Issue: Dates in Wrong Format”Excel auto-formatting dates:
CSV: 2024-01-15Excel shows: 1/15/2024 or 15/01/2024 (depends on locale)Solution:
- Format cells as “Text” before import
- OR accept Excel’s date formatting
- OR use JSON for consistent formatting
Best Practices
Section titled “Best Practices”1. Export Regularly
Section titled “1. Export Regularly”Establish routine:
- Weekly: Recent orders
- Monthly: All orders for accounting
- Quarterly: Analysis and reporting
- Yearly: Tax reporting
2. Name Files Clearly
Section titled “2. Name Files Clearly”Good file names:
✅ orders-2024-01-15-to-2024-01-31-approved.csv✅ customer-list-2024-Q1.csv✅ accounting-export-january-2024.csvBad file names:
❌ export.csv❌ orders(1).csv❌ data.csv3. Backup Exports
Section titled “3. Backup Exports”Keep copies of:
- Monthly exports (at least 1 year)
- Annual exports (7+ years for tax)
- Customer data exports (for compliance)
Storage:
- Cloud storage (Dropbox, Google Drive)
- Local backup
- Accounting software
4. Verify Data Accuracy
Section titled “4. Verify Data Accuracy”After export:
- Spot-check 5-10 random orders
- Verify totals match dashboard
- Check date ranges correct
- Ensure all columns populated
5. Document Export Purpose
Section titled “5. Document Export Purpose”Keep log:
Date: Jan 31, 2024Export: orders-2024-01.csvPurpose: January accounting reconciliationDelivered to: Accountant (email)Contains: 143 approved ordersNext Steps
Section titled “Next Steps”- Order Details - View individual order information
- Managing Customer Access - Control downloads
- Viewing Orders Overview - Back to orders