Glovo Integration

Source code

⚠️ This app is no longer maintained by VTEX. This means support and maintenance are no longer provided.

The Glovo Integration enables European stores to connect to the Glovo Marketplace.

• Possibility to add multiple stores with independent catalogs.
• Product catalog update for stores - Updates to the store's catalogs can be scheduled to keep prices and product availability up to date.
• Order Integration - The orders received from Glovo are integrated into VTEX.

Latin American stores are not supported.

Before you start

Before proceeding to the following steps, you should have already reached out to Glovo to create the Catalog for the stores you will have available on Glovo. You should upload a single catalog that includes all the products you want to offer on the independent Glovo Stores. The App will manage each store's availability.

Configuration

To configure the Glovo Integration, you can follow these steps:

1. Run the following command in your store's CLI: vtex install vtex.glovo-integration@3.x
2. Make sure you have at least one (1) pick-up-point configured for each of the salesChannel where you want to offer the integration.
3. In your store's admin dashboard, on the side menu, browse to Apps -> Glovo Integration and then click on it to open the application settings.\
4. Add the stores that will integrate with Glovo:

Field	Description
Store name	Display name associated with the store
Seller ID	Seller ID associated with the store (the dropdown displays the seller's name)
Affiliate ID	Three-letter ID associated with the affiliate (you can find this ID by going to Store settings -> Orders' settings -> Affiliates)
Sales channel	The sales channel associated with the store
Postal code	The postal code for the store in charge of fulfilling the orders from Glovo
Country	The country where the store is located
Glovo Store ID	Glovo store ID assigned to the store by Glovo

5. Fill in the integration settings and client information:

Field	Description	Default value
Glovo Token	Glovo token (app key) provided by Glovo to connect to their APIs
Minimum stock	Minimum stock for a product to be marked as available on the Glovo store	1
Marketplace	Toggle to use a marketplace configuration	false
Production Environment	Toggle between Glovo's Test environment and production environment	false
Client information	All orders will be created using this information for the customer fields

6. Using the example shown below, upload the catalog of your store's products that will be available on Glovo (include all the products from every store) by making a POST request to the following endpoint.

curl --request POST \
     --url https://app.io.vtex.com/vtex.glovo-integration/v2/{{account}}/{{workspace}}/_v/glovo/glovo-menu/ \
     --header 'VtexIdClientAutCookie: {authToken}' \
     --data '
        [
            "productId",
            "productId",
            "productId",
            .
            .
            .
            "productId",
        ]
     '

7. The catalog of products offered on Glovo can be updated completely or partially by using the following endpoints:

• Complete update - This endpoint will send a bulk update to every store for all the products in the menu.

curl --request POST \
     --url https://{{account}}.myvtex.com/_v/glovo/menu/update-all \
     --header 'VtexIdClientAutCookie: {authToken}' \

• Partial update - This endpoint will send a bulk update to every store only for products that have changed since the last update. The partial update requires the affiliate configuration described on step 5

curl --request POST \
     --url https://{{account}}.myvtex.com/_v/glovo/menu/update-partial \
     --header 'VtexIdClientAutCookie: {authToken}' \

8. Inside your store's admin dashboard, on the side menu, go to Orders Management > Settings > Affiliate and configure a new affiliate as follows:

   • Name: Give the affiliate a name
   • ID: a three (3) letter key for the affiliate (not compatible with numbers or vocals)
   • Trade Policy: number of the trade policy (sales channel) that will be linked to the Glovo Store
   • e-mail: email for notifications
   • Search Enpoint: https://{{account}}.myvtex.com/_v/glovo/products/update

Store Menu

It is possible to view the current catalog offered on Glovo for any stores added to the configuration. The following endpoint returns the store's current catalog and generates a new, updated record.

curl --request GET \
     --url https://app.io.vtex.com/vtex.glovo-integration/v3/{{account}}/{{workspace}}/_v/glovo/get-menu/{{affiliateId}}' \
     --header 'VtexIdClientAutCookie: {authToken} \

The response has a property called lastUpdated that shows you the last date at which the record was generated.