Merge pull request #8125 from magento/em_prex-catsyncapi

Adding content about the catalog sync CLI

Author: erikmarr

src/_data/toc/configuration-guide.yml

@@ -115,6 +115,9 @@ pages:
         - label: Dependency reports
           url: /config-guide/cli/config-cli-subcommands-depen.html
 
+        - label: Catalog sync
+          url: /config-guide/cli/config-cli-subcommands-catalog-sync.html
+
         - label: Configuration management
           children:
 

src/guides/v2.3/config-guide/cli/config-cli-subcommands-catalog-sync.md

@@ -0,0 +1,28 @@
+---
+group: configuration-guide
+title: Catalog Sync
+---
+
+Magento compiles catalog data into tables using indexers. This process is automatically [triggered by several events](https://docs.magento.com/user-guide/system/index-management-events.html), such as changes to a product's price or inventory levels. To allow some Magento services to use that catalog data, a catalog sync process runs hourly. The catalog sync process exports product data from the Magento server to SaaS services on an ongoing basis. For example, the [Product Recommendations](https://docs.magento.com/user-guide/marketing/product-recommendations.html) feature needs up-to-date catalog information so that it can accurately return recommendations with correct names, pricing, and availability. Use the command-line interface to trigger the catalog sync and reindex product data for consumption by SaaS services.
+
+The commands used to sync catalog data are part of the `magento/saas-export` package. See [Install and configure Product Recommendations]({{ site.baseurl }}/recommendations/install-configure.html) for more information.
+
+{:.bs-callout-info}
+When you trigger a data resync from the command line, it can take up to an hour for the data to update.
+
+The following command reindexes the product data from the Magento catalog and resyncs it to Magento SaaS services:
+
+```bash
+bin/magento saascatalog:resync --feed products
+```
+
+If you do not want to run a full reindex of the products, you can instead sync the product data that has already been generated:
+
+```bash
+bin/magento saascatalog:resync --feed products --no-reindex
+```
+
+|Parameter|Description|
+|---|---|
+|`feed`|(Required) Specifies which entity to resync, such as `products`|
+|`no-reindex`|(Optional) Resubmits the existing catalog data to the SaaS service without reindexing. When this parameter is not specified, the command runs a full reindex before syncing data.|

src/guides/v2.4/config-guide/cli/config-cli-subcommands-catalog-sync.md

@@ -0,0 +1 @@
+../../../v2.3/config-guide/cli/config-cli-subcommands-catalog-sync.md