FRW-5799 Added Install the Data Exchange API + Inventory Management feature

docs/scos/dev/feature-integration-guides/202307.0/glue-api/dynamic-data-api/install-the-data-exchange-api-inventory-management-feature.md

@@ -0,0 +1,106 @@
+---
+title: Data Exchange API + Inventory Management feature integration
+description: Install the Data Exchange API + Inventory Management features in your project.
+last_updated: Sep 06, 2023
+template: feature-integration-guide-template
+---
+
+This document describes how to integrate the Data Exchange API + Inventory Management feature into a Spryker project.
+
+## Install feature core
+
+Follow the steps below to install the Data Exchange API + Inventory Management feature core.
+
+### Prerequisites
+
+Install the required features:
+
+| NAME              | VERSION          | INTEGRATION GUIDE |
+|-------------------|------------------|------------------|
+| Data Exchange API | {{page.version}} | [Data Exchange API integration](/docs/scos/dev/feature-integration-guides/{{page.version}}/glue-api/dynamic-data-api/data-exchange-api-integration.html) |
+| Inventory Management  | {{page.version}} | [Install the Inventory Management feature](/docs/pbc/all/warehouse-management-system/{{page.version}}/unified-commerce/install-and-upgrade/install-the-inventory-management-feature.html) |
+
+### 1) Set up behavior
+
+Register the following plugins:
+
+| PLUGIN | SPECIFICATION | PREREQUISITES | NAMESPACE |
+|---|---|---|---|
+| AvailabilityDynamicEntityPostUpdatePlugin | Checks if `spy_stock_product` is updated and updates availability. | None | Spryker\Zed\Availability\Communication\Plugin\DynamicEntity |
+| AvailabilityDynamicEntityPostCreatePlugin | Checks if `spy_stock_product` is updated and updates availability. | None | Spryker\Zed\Availability\Communication\Plugin\DynamicEntity |
+
+**src/Pyz/Zed/DynamicEntity/DynamicEntityDependencyProvider.php**
+
+```php
+<?php
+
+namespace Pyz\Zed\DynamicEntity;
+
+use Spryker\Zed\Availability\Communication\Plugin\DynamicEntity\AvailabilityDynamicEntityPostCreatePlugin;
+use Spryker\Zed\Availability\Communication\Plugin\DynamicEntity\AvailabilityDynamicEntityPostUpdatePlugin;
+use Spryker\Zed\DynamicEntity\DynamicEntityDependencyProvider as SprykerDynamicEntityDependencyProvider;
+
+class DynamicEntityDependencyProvider extends SprykerDynamicEntityDependencyProvider
+{
+    /**
+     * @return array<\Spryker\Zed\DynamicEntityExtension\Dependency\Plugin\DynamicEntityPostUpdatePluginInterface>
+     */
+    protected function getDynamicEntityPostUpdatePlugins(): array
+    {
+        return [
+            new AvailabilityDynamicEntityPostUpdatePlugin(),
+        ];
+    }
+
+    /**
+     * @return array<\Spryker\Zed\DynamicEntityExtension\Dependency\Plugin\DynamicEntityPostCreatePluginInterface>
+     */
+    protected function getDynamicEntityPostCreatePlugins(): array
+    {
+        return [
+            new AvailabilityDynamicEntityPostCreatePlugin(),
+        ];
+    }
+}
+```
+
+{% info_block warningBox "Verification" %}
+
+Let’s say you have an endpoint `/dynamic-data/stock-products` to operate with data in `spy_stock_product` table in database.
+
+By default, all routes within the Data Exchange API are protected to ensure data security.
+To access the API, you need to obtain an access token by sending a POST request to the `/token/` endpoint with the appropriate credentials:
+
+```bash
+POST /token/ HTTP/1.1
+Host: glue-backend.mysprykershop.com
+Content-Type: application/x-www-form-urlencoded
+Accept: application/json
+Content-Length: 67
+
+grant_type=password&username={username}&password={password}
+```
+
+### Sending a `PATCH` request
+This request needs to include the necessary headers, such as Content-Type, Accept, and Authorization, with the access token provided.
+
+```bash
+PATCH /dynamic-entity/stock-products HTTP/1.1
+Host: glue-backend.mysprykershop.com
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {your_token}
+Content-Length: 174
+{
+    "data": [
+        {
+            "idStockProduct": 1,
+            "Quantity": 10
+        }
+    ]
+}
+```
+
+Make sure that after updating stock data - product availability is updated as well. For this go to the Storefront and check the availability of the product.
+
+{% endinfo_block %}