DEVDOCS-6477 - OP Docs for Migration Customers #1085
Conversation
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
docs/start/migration/overview.mdx
Outdated
| # Catalog data migration: Best practices and process overview | ||
|
|
||
| Migrating product data is a foundational part of launching or replatforming an ecommerce store. This section provides practical guidance and best practices for migrating your product catalog into BigCommerce, focusing on accuracy, efficiency, and minimizing common migration errors. | ||
| Now that you've made the decision to move your store to BigCommerce, it's time to start the logistics of transferring your catalog. Recognizing that there is no single solution that will fit every business, we support several ways to migrate your data, ranging from our data migration apps to completely managed transfers through BigCommerce's Data Migration Services team. |
There was a problem hiding this comment.
Hard to read sentence (confidence: 5/7) retext-readability retext-readability
docs/start/migration/overview.mdx
Outdated
| | Categories | ✔ | ✔ | ✔ | N/A | | ||
| | Customers** | ✔ | ✔ | ✔ | N/A | | ||
| | Orders | ✔ | X | ✔ | N/A | | ||
| | Reviews | X | X | X | [Product Review Importer & Exporter app (free)](https://www.bigcommerce.com/apps/product-review-importer/) | |
There was a problem hiding this comment.
Hard to read sentence (confidence: 5/7) retext-readability retext-readability
docs/start/migration/overview.mdx
Outdated
| <Callout type="info"> | ||
| Data migration is complex and impacts your entire store setup. You should plan for it early in your project timeline to prevent setbacks. | ||
| </Callout> | ||
| Our data migration apps allow you to migrate your catalog data resources (products, categories, customers, orders) into your new BigCommerce store from the following platforms: |
There was a problem hiding this comment.
Hard to read sentence (confidence: 5/7) retext-readability retext-readability
docs/start/migration/overview.mdx
Outdated
| Our data migration apps allow you to migrate your catalog data resources (products, categories, customers, orders) into your new BigCommerce store from the following platforms: | ||
|
|
||
| ### Recommended preparatory tasks | ||
| - [Shopify](https://www.bigcommerce.com/apps/data-migration-services-shopify/) |
There was a problem hiding this comment.
Shopify is misspelt; did you mean Showily? retext-spell retext-spell
docs/start/migration/overview.mdx
Outdated
|
|
||
| ### Recommended preparatory tasks | ||
| - [Shopify](https://www.bigcommerce.com/apps/data-migration-services-shopify/) | ||
| - [Volusion](https://www.bigcommerce.com/apps/data-migration-volusion/) |
There was a problem hiding this comment.
Volusion is misspelt; did you mean Collusion? retext-spell retext-spell
docs/start/migration/overview.mdx
Outdated
| - [API rate limits](/docs/start/best-practices/api-rate-limits) | ||
| - [WebDAV file access](https://support.bigcommerce.com/s/article/File-Access-WebDAV) | ||
| - [Data migration services](https://www.bigcommerce.com/services/launch/#data-migration-services) | ||
| If you don't feel comfortable migrating your store's data using the app or CSV file, consider using a managed data transfer through BigCommerce's [Data Migration Services](https://www.bigcommerce.com/services/launch/) team. They will work directly with you to ensure that your data is securely migrated to your satisfaction, tailoring their services to match your business needs. The team is highly experienced in working with large catalogs with SKUs on more than 50 ecommerce platforms. |
There was a problem hiding this comment.
Hard to read sentence (confidence: 4/7) retext-readability retext-readability
docs/start/migration/overview.mdx
Outdated
| Developers can use our Catalog, Orders, and Customers API to add and modify products, orders, and customer data directly. See our [API Documentation](https://developer.bigcommerce.com/api-docs) on the Dev Center for more detailed information and examples. | ||
|
|
||
| <Callout> | ||
| **How do I ensure that imported historical orders aren't counted as new orders or GMV?**<br/> |
There was a problem hiding this comment.
GMV is misspelt; did you mean EMV, GM, GMO, GMT, GOV, GUV? retext-spell retext-spell
docs/start/migration/overview.mdx
Outdated
| <Callout> | ||
| **How do I ensure that imported historical orders aren't counted as new orders or GMV?**<br/> | ||
| When migrating orders from a previous platform, which involves [creating new orders via API](https://developer.bigcommerce.com/docs/rest-management/orders#create-an-order), | ||
| use M-MIG in the external_source field to exclude these orders from affecting your store's [trailing 12-month sales volume](https://support.bigcommerce.com/s/article/Pricing). |
There was a problem hiding this comment.
Hard to read sentence (confidence: 4/7) retext-readability retext-readability
docs/start/migration/overview.mdx
Outdated
| <Callout> | ||
| **How do I ensure that imported historical orders aren't counted as new orders or GMV?**<br/> | ||
| When migrating orders from a previous platform, which involves [creating new orders via API](https://developer.bigcommerce.com/docs/rest-management/orders#create-an-order), | ||
| use M-MIG in the external_source field to exclude these orders from affecting your store's [trailing 12-month sales volume](https://support.bigcommerce.com/s/article/Pricing). |
There was a problem hiding this comment.
M-MIG is misspelt; did you mean MiG, MiMIc, MiMInG? retext-spell retext-spell
|
|
||
| # Product data migration: Best practices and process overview | ||
|
|
||
| Migrating product data is a foundational part of launching or replatforming an ecommerce store. This section provides practical guidance and best practices for migrating your product catalog into BigCommerce, focusing on accuracy, efficiency, and minimizing common migration errors. |
There was a problem hiding this comment.
replatforming is misspelt retext-spell retext-spell
| # Catalog data migration: Best practices and process overview | ||
|
|
||
| Migrating product data is a foundational part of launching or replatforming an ecommerce store. This section provides practical guidance and best practices for migrating your product catalog into BigCommerce, focusing on accuracy, efficiency, and minimizing common migration errors. | ||
| Migrating catalog data is a foundational part of launching or replatforming an ecommerce store. This section provides practical guidance and best practices for migrating your catalog into BigCommerce, focusing on accuracy, efficiency, and minimizing common migration errors. |
There was a problem hiding this comment.
replatforming is misspelt retext-spell retext-spell
|
|
||
| #### Custom form fields | ||
|
|
||
| If your store uses custom form fields (at signup or for addresses), make sure they are created in the destination store **before migration**. Then, you can map values to those fields when creating or updating customers. |
There was a problem hiding this comment.
signup is misspelt; did you mean signer, signet, signor, signed, sunup? retext-spell retext-spell
| #### Rate limits | ||
|
|
||
| <Callout type='info'> | ||
| Create up to 10 customers per `POST /v3/customers` call; implement backoff |
There was a problem hiding this comment.
backoff is misspelt; did you mean kickoff? retext-spell retext-spell
| BigCommerce APIs are subject to rate limits. Always design your migration to: | ||
|
|
||
| - Batch requests where possible | ||
| - Implement retries with exponential backoff |
There was a problem hiding this comment.
backoff is misspelt; did you mean kickoff? retext-spell retext-spell
| Category and brand IDs are not accessible by name, so create and cache a mapping schema to guarantee your catalog is properly configured. | ||
| </Callout> | ||
| You can create and manage API tokens in your BigCommerce control panel under **Settings** > **API** > **Store-level API accounts**. | ||
| Once there, select the "Create API account" button in the upper right hand corner. |
There was a problem hiding this comment.
might be helpful to include an image here
DEVDOCS-6477
What changed?
Release notes draft
Anything else?
ping {names}