Install the Marketplace Merchant Glue API

Edit on GitHub

This document describes how to integrate the Marketplace Merchant Glue API feature into a Spryker project.

Install feature core

Follow the steps below to install the Marketplace Merchant Glue API feature core.

Prerequisites

Install the required features:

NAME VERSION INTEGRATION GUIDE
Spryker Core 202307.0 Glue API: Spryker Core Feature Integration
Marketplace Merchant 202307.0 Marketplace Merchant feature integration

1) Install the required modules using Composer

Install the required modules:

composer require spryker/merchants-rest-api:"^1.0.0" --update-with-dependencies
Verification

Make sure that the following modules have been installed:

MODULE EXPECTED DIRECTORY
MerchantsRestApi vendor/spryker/merchants-rest-api

2) Set up transfer objects

Generate transfer changes:

console transfer:generate
Verification

Make sure that the following changes have been applied in transfer objects:

TRANSFER TYPE EVENT PATH
RestMerchantsAttributesTransfer class Created src/Generated/Shared/Transfer/RestMerchantsAttributesTransfer
RestMerchantAddressesAttributesTransfer class Created src/Generated/Shared/Transfer/RestMerchantAddressesAttributesTransfer
RestMerchantAddressTransfer class Created src/Generated/Shared/Transfer/RestMerchantAddressTransfer
RestLegalInformationTransfer class Created src/Generated/Shared/Transfer/RestLegalInformationTransfer
RestOrdersAttributesTransfer.merchantReferences property Created src/Generated/Shared/Transfer/RestOrdersAttributesTransfer
RestOrderDetailsAttributesTransfer.merchantReferences property Created src/Generated/Shared/Transfer/RestOrderDetailsAttributesTransfer
RestOrderItemsAttributesTransfer.merchantReference property Created src/Generated/Shared/Transfer/RestOrderItemsAttributesTransfer
MerchantStorageProfileTransfer.description property Created src/Generated/Shared/Transfer/MerchantStorageProfileTransfer
MerchantStorageProfileTransfer.bannerUrl property Created src/Generated/Shared/Transfer/MerchantStorageProfileTransfer
MerchantStorageProfileTransfer.deliveryTime property Created src/Generated/Shared/Transfer/MerchantStorageProfileTransfer
MerchantStorageProfileTransfer.termsConditions property Created src/Generated/Shared/Transfer/MerchantStorageProfileTransfer
MerchantStorageProfileTransfer.cancellationPolicy property Created src/Generated/Shared/Transfer/MerchantStorageProfileTransfer
MerchantStorageProfileTransfer.imprint property Created src/Generated/Shared/Transfer/MerchantStorageProfileTransfer
MerchantStorageProfileTransfer.dataPrivacy property Created src/Generated/Shared/Transfer/MerchantStorageProfileTransfer

3) Set up behavior

Enable the following behaviors by registering the plugins:

PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
MerchantsResourceRoutePlugin Registers the merchants resource. Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication
MerchantAddressesResourceRoutePlugin Registers the merchant-addresses resource. Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication
MerchantAddressByMerchantReferenceResourceRelationshipPlugin Adds the merchant-addresses resource as a relationship of the merchants resource. Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication
MerchantByMerchantReferenceResourceRelationshipPlugin Adds merchants resource as a relationship by merchant reference provided in the attributes. Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication
MerchantRestUrlResolverAttributesTransferProviderPlugin Adds functionality for merchant url resolving to UrlRestApi. Spryker\Glue\MerchantsRestApi\Plugin\UrlsRestApi
MerchantsByOrderResourceRelationshipPlugin Adds merchants resources as relationship by order merchant references. Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication

src/Pyz/Glue/GlueApplication/GlueApplicationDependencyProvider.php

<?php

namespace Pyz\Glue\GlueApplication;

use Spryker\Glue\GlueApplication\GlueApplicationDependencyProvider as SprykerGlueApplicationDependencyProvider;
use Spryker\Glue\GlueApplicationExtension\Dependency\Plugin\ResourceRelationshipCollectionInterface;
use Spryker\Glue\MerchantsRestApi\MerchantsRestApiConfig;
use Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication\MerchantAddressByMerchantReferenceResourceRelationshipPlugin;
use Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication\MerchantAddressesResourceRoutePlugin;
use Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication\MerchantByMerchantReferenceResourceRelationshipPlugin;
use Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication\MerchantsByOrderResourceRelationshipPlugin;
use Spryker\Glue\MerchantsRestApi\Plugin\GlueApplication\MerchantsResourceRoutePlugin;

class GlueApplicationDependencyProvider extends SprykerGlueApplicationDependencyProvider
{
    /**
     * @return array<\Spryker\Glue\GlueApplicationExtension\Dependency\Plugin\ResourceRoutePluginInterface>
     */
    protected function getResourceRoutePlugins(): array
    {
        return [
            new MerchantsResourceRoutePlugin(),
            new MerchantAddressesResourceRoutePlugin(),
        ];
    }

    /**
     * @param \Spryker\Glue\GlueApplicationExtension\Dependency\Plugin\ResourceRelationshipCollectionInterface $resourceRelationshipCollection
     *
     * @return \Spryker\Glue\GlueApplicationExtension\Dependency\Plugin\ResourceRelationshipCollectionInterface
     */
    protected function getResourceRelationshipPlugins(
        ResourceRelationshipCollectionInterface $resourceRelationshipCollection
    ): ResourceRelationshipCollectionInterface {
        $resourceRelationshipCollection->addRelationship(
            MerchantsRestApiConfig::RESOURCE_MERCHANTS,
            new MerchantAddressByMerchantReferenceResourceRelationshipPlugin()
        );

        $resourceRelationshipCollection->addRelationship(
            OrdersRestApiConfig::RESOURCE_ORDERS,
            new MerchantsByOrderResourceRelationshipPlugin()
        );

        return $resourceRelationshipCollection;
    }
}

src/Pyz/Glue/UrlsRestApi/UrlsRestApiDependencyProvider.php

<?php

namespace Pyz\Glue\UrlsRestApi;

use Spryker\Glue\MerchantsRestApi\Plugin\UrlsRestApi\MerchantRestUrlResolverAttributesTransferProviderPlugin;

class UrlsRestApiDependencyProvider extends SprykerUrlsRestApiDependencyProvider
{
    /**
     * @return array<\Spryker\Glue\UrlsRestApiExtension\Dependency\Plugin\RestUrlResolverAttributesTransferProviderPluginInterface>
     */
    protected function getRestUrlResolverAttributesTransferProviderPlugins(): array
    {
        return [
            new MerchantRestUrlResolverAttributesTransferProviderPlugin(),
        ];
    }
}
Verification

Make sure that the MerchantsResourceRoutePlugin plugin is set up by sending the request GET https://glue.mysprykershop.com/merchants/{{merchantReference}}, https://glue.mysprykershop.com/merchants.

Make sure that the pagination is working by sending the request GET https://glue.mysprykershop.com/merchants?offset=1&limit=1.

Make sure that the MerchantAddressesResourceRoutePlugin plugin is set up by sending the request GET https://glue.mysprykershop.com/merchants/{{merchantReference}}/merchant-addresses.

Make sure that the MerchantAddressByMerchantReferenceResourceRelationshipPlugin plugin is set up by sending the request GET https://glue.mysprykershop.com/merchants/{{merchantReference}}?include=merchant-addresses. The response should include the merchant-addresses resource along with the merchants.

Make sure that after sending the request GET https://glue.mysprykershop.com/url-resolver?url={{merchantUrl}, the merchant entity type and ID is returned in response.