Converting the Change Increment ID KB to devdocs

_data/toc/configuration-guide.yml

@@ -275,6 +275,9 @@ pages:
       url: /config-guide/multi-site/ms_over.html
       children:
 
+        - label: Change increment ID for a database entity on particular store
+          url: /config-guide/multi-site/change-increment-id.html
+
         - label: Set up multiple websites, stores, and store views in the Admin
           url: /config-guide/multi-site/ms_websites.html
 
@@ -423,4 +426,4 @@ pages:
           url:  /architecture/gdpr/magento-2x.html
 
         - label: Magento 1.x
-          url:  /architecture/gdpr/magento-1x.html
+          url:  /architecture/gdpr/magento-1x.html

guides/v2.2/config-guide/multi-site/change-increment-id.md

@@ -0,0 +1,84 @@
+---
+group: configuration-guide
+title: Change increment ID for a database entity on particular store
+functional_areas:
+  - Configuration
+  - System
+  - Setup
+---
+
+This article discusses how to change the increment ID for a Magento database (DB) entity (order, invoice, credit memo, etc.) on a particular Magento store using the `ALTER TABLE` SQL statement.
+
+## Affected versions
+
+-  Magento Commerce (on premise): 2.x.x
+-  Magento Commerce (Cloud): 2.x.x
+-  MySQL: any supported version
+
+## When would you need to change increment ID
+
+You might need to change the increment ID for new DB entities in these cases:
+
+-  After a hard backup restore on a Live site
+-  Some order records have been lost, but their IDs are already being used by payment gateways (like PayPal) for your current Merchant account. Such being the case, the payment  gateways stop processing new orders that have the same IDs, returning the "Duplicate invoice id" error
+
+{: .bs-callout-info}
+You may also fix the payment gateway issue for PayPal by allowing multiple payments per invoice ID in PayPal's Payment Receiving Preferences. See the Knowledge Base article: [PayPal gateway rejected request - duplicate invoice issue][] .
+
+## Prerequisite steps
+
+1. Find stores and entities for which the new increment ID should be changed.
+1. Connect to your MySQL DB.
+   For Magento Commerce (Cloud), at first, you need to SSH to your environment.
+1. Check the current auto_increment value for the entity sequence table using the following query:
+
+    ```sql
+    SHOW TABLE STATUS FROM `{database_name}` WHERE `name` LIKE 'sequence_{entity_type}_{store_id}';
+    ```
+
+## Example
+
+If you are checking an auto increment for an order on the store with ID=1, the table name would be 'sequence_order_1'.
+
+If the value of the `auto_increment` column is '1234', the next order placed at the store with `ID=1` will have the ID '#100001234'.
+
+## Update entity to change increment ID
+
+Update the entity using the following query:
+
+```sql
+ALTER TABLE sequence_{entity_type}_{store_id} AUTO_INCREMENT = {new_increment_value};
+```
+
+{: .bs-callout-info}
+Important: The new increment value must be greater than the current one, not less.
+
+## Example
+
+After executing the following query:
+
+```sql
+ALTER TABLE sequence_order_1 AUTO_INCREMENT = 2000;
+```
+
+The next order placed at the store with `ID=1` will have the ID '#100002000'.
+
+## Additional recommended steps on production environments (cloud)
+
+Before executing the `ALTER TABLE` query on a production environment of Magento Commerce (Cloud), we strongly recommend performing these steps:
+
+-  Test the entire procedure of changing the increment ID on your Staging environment
+-  [Create a DB backup][] to restore your Production DB in case of failure
+
+## Related documentation
+
+-  [Set up a remote MySQL database connection][]
+-  [Create database dump on Cloud][]
+-  [SSH to your environment][]
+
+<!-- Link Definitions -->
+[PayPal gateway rejected request - duplicate invoice issue]: https://support.magento.com/hc/en-us/articles/115002457473
+[Set up a remote MySQL database connection]: {{ page.baseurl }}/install-gde/prereq/mysql_remote.html
+[Create a DB backup]: https://support.magento.com/hc/en-us/articles/360003254334
+[Create database dump on Cloud]: https://support.magento.com/hc/en-us/articles/360003254334
+[SSH to your environment]: {{ page.baseurl }}/cloud/env/environments-ssh.html#ssh

guides/v2.3/config-guide/multi-site/change-increment-id.md

@@ -0,0 +1,84 @@
+---
+group: configuration-guide
+title: Change increment ID for a database entity on particular store
+functional_areas:
+  - Configuration
+  - System
+  - Setup
+---
+
+This article discusses how to change the increment ID for a Magento database (DB) entity (order, invoice, credit memo, etc.) on a particular Magento store using the `ALTER TABLE` SQL statement.
+
+## Affected versions
+
+-  Magento Commerce (on premise): 2.x.x
+-  Magento Commerce (Cloud): 2.x.x
+-  MySQL: any supported version
+
+## When would you need to change increment ID
+
+You might need to change the increment ID for new DB entities in these cases:
+
+-  After a hard backup restore on a Live site
+-  Some order records have been lost, but their IDs are already being used by payment gateways (like PayPal) for your current Merchant account. Such being the case, the payment  gateways stop processing new orders that have the same IDs, returning the "Duplicate invoice id" error
+
+{: .bs-callout-info}
+You may also fix the payment gateway issue for PayPal by allowing multiple payments per invoice ID in PayPal's Payment Receiving Preferences. See the Knowledge Base article: [PayPal gateway rejected request - duplicate invoice issue][] .
+
+## Prerequisite steps
+
+1. Find stores and entities for which the new increment ID should be changed.
+1. Connect to your MySQL DB.
+   For Magento Commerce (Cloud), at first, you need to SSH to your environment.
+1. Check the current auto_increment value for the entity sequence table using the following query:
+
+    ```sql
+    SHOW TABLE STATUS FROM `{database_name}` WHERE `name` LIKE 'sequence_{entity_type}_{store_id}';
+    ```
+
+## Example
+
+If you are checking an auto increment for an order on the store with ID=1, the table name would be 'sequence_order_1'.
+
+If the value of the `auto_increment` column is '1234', the next order placed at the store with `ID=1` will have the ID '#100001234'.
+
+## Update entity to change increment ID
+
+Update the entity using the following query:
+
+```sql
+ALTER TABLE sequence_{entity_type}_{store_id} AUTO_INCREMENT = {new_increment_value};
+```
+
+{: .bs-callout-info}
+Important: The new increment value must be greater than the current one, not less.
+
+## Example
+
+After executing the following query:
+
+```sql
+ALTER TABLE sequence_order_1 AUTO_INCREMENT = 2000;
+```
+
+The next order placed at the store with `ID=1` will have the ID '#100002000'.
+
+## Additional recommended steps on production environments (cloud)
+
+Before executing the `ALTER TABLE` query on a production environment of Magento Commerce (Cloud), we strongly recommend performing these steps:
+
+-  Test the entire procedure of changing the increment ID on your Staging environment
+-  [Create a DB backup][] to restore your Production DB in case of failure
+
+## Related documentation
+
+-  [Set up a remote MySQL database connection][]
+-  [Create database dump on Cloud][]
+-  [SSH to your environment][]
+
+<!-- Link Definitions -->
+[PayPal gateway rejected request - duplicate invoice issue]: https://support.magento.com/hc/en-us/articles/115002457473
+[Set up a remote MySQL database connection]: {{ page.baseurl }}/install-gde/prereq/mysql_remote.html
+[Create a DB backup]: https://support.magento.com/hc/en-us/articles/360003254334
+[Create database dump on Cloud]: https://support.magento.com/hc/en-us/articles/360003254334
+[SSH to your environment]: {{ page.baseurl }}/cloud/env/environments-ssh.html#ssh