In order to integrate your VTEX site with the Picker Platform, it is necessary to first create your app keys to be able to synchronize and authorize any request that will be made with VTEX. For this you must go to Account Settings> Application Keys.

Subsequently, you must click on “Manage Keys”.
‍

Here you must click on the “Generate New” option. In the next window, you will be able to add a name to your new key.
‍

In order for the credentials to be created to have the necessary access, you must add a role to it. As Picker will consult the orders created and the pickup points, you must add roles that have access to these instances (in the case of the demo, they will be given administrative access).

Once the key data has been saved, a screen will be presented where you will be presented with the credentials. It is very important that at this time you copy both the Application Key and its Application Token, since, after this screen, you will not be able to consult them again.
‍

Keep in mind that these set of keys will be used for any API request that you want to make with VTEX (some of the steps that you will see below will require them).

Picker in VTEX is considered a Carrier, which must have a Shipping Policy assigned. Before creating Picker as a Shipping Policy, you must first have the following requirements:

1) Activate Geolocation Shipping https://help.vtex.com/en/tutorial/registering-geolocation--tutorials_138

2) Create Pickup Points:
‍
https://help.vtex.com/en/tutorial/o-que-e-uma-transportadora-7u9duMD5UQa2QQwukAWMcE

a) When creating a pickup point (which for Picker represents a place in your workspace), you must create it with the same data with which you created it in your Picker platform.

b) In order to identify your Picker locations in VTEX, you must enter the API Key of your location as the Pickup Point ID.

To create a shipping policy, you can do it in 2 different ways:

1) Via Web Portal https://help.vtex.com/en/tutorial/shipping-policy--tutorials_140


IMPORTANT: When manually creating a shipping policy that you want to integrate with Picker, you must enter the word “PICK” as the ID.

2) Via API with Postman https://developers.vtex.com/vtex-rest-api/reference/post_logistics-pvt-shipping-policies

In the same way as in its version through the Web Portal, it is necessary that for this shipping policy, the word "PICK" must be entered as ID.




In addition to this, it must be taken into account that once this policy is created, they must enter the price rules for this delivery method (These prices are those that the customer will be charged and are totally independent from the prices that Picker charges for each delivery)

Once you have all the previous steps, we are going to execute the order hook registry via Postman. This step is the most important, since once this step is entered, all orders that have the Picker shipping method will be entered into the platform.

To create the hook needed to create the order in Picker, you must run the following endpoint with your credentials https://developers.vtex.com/vtex-rest-api/reference/hookconfiguration


For this particular case, we will execute the endpoint with the following body:

Before running this endpoint you should consider the following:
‍
1) We want the order to be created in Picker once it is accepted, that's why in the status field, we use “order-accepted”.

2) It is mandatory that in the status field (even though it is an array), you only enter a single type of status, to avoid duplicating orders in Picker.

3) In url, you must enter the endpoint of the environment you want to use:

a) For test environment: https://dev-api.pickerexpress.com/api/pushVtexOrder


b) For production environment: https://api.pickerexpress.com/api/pushVtexOrders

‍If you need more information about hooks, you can see it herehttps://developers.vtex.com/vtex-rest-api/docs/orders-feed#hook-notifications

To start integrating Picker into Shopify, you need to start by creating an app for your store. You can do this through the Applications > Develop applications for your store option.

Next, it allows the development of custom applications (Remember to read the terms and conditions).

Once the development of custom applications is approved, this screen will appear. Click create an app.
‍

We create the application (in this case we are going to put Picker on it), and we proceed to click on Configure dashboard API scopes.
‍

On this screen it is very important to have selected the following permissions that the Picker API will have. The following must be selected:

• read_payment_terms

• read_shipping

• read_orders

• read_locales

• read_fulfillments

• read_locations

• read_assigned_fulfillment_orders

• read_third_party_fulfillment_orders

• read_merchant_managed_fulfillment_orders

Likewise, make sure that the API and Webhooks version is 2022-04

Once this is done, we proceed to click on Install application to be able to request the access token for the Shopify API services.

Please note that this token can only be revealed once. Copy it and save it in a safe place.

In order to set up Shopify credentials in Picker, you'll first need to create a Workspace. Once the workspace is created, go to the Settings -> Integrations section.

Click on Change, to be able to enter your credentials. In this section you will need to add both the Access Token that you got from Shopify and the url of your site. Once added, an attempt will be made to verify the credentials in order to proceed to the next step (to verify if you entered the credentials correctly, the failed label will disappear).

When creating an order in Shopify, it's important to know which Picker location the order ships from. For this consideration, a relationship is made between the Shopify branches of your site with the Picker location in your Workspace. To be able to relate the Shopify branches in Picker, on the same Shopify Configuration screen, click Change. If you already have the credentials configured correctly, the Shopify branches and Picker stores will appear when you enter the Manage Stores option.

Next, you will see a list of all the branches that you have active in Shopify. If any of these branches is related to a Picker location, the name of the location to which it is related will appear at the bottom of the branch name.

To proceed to associate a Shopify branch with a Picker location, you must click on the Edit button that is next to the Shopify branch. By clicking here, a new window will appear where you can select the Picker location that you want to be related to your selected Shopify location.

By selecting the location and clicking OK, this configuration will be saved.

In this way, if a Shopify order originates from a branch, the Picker platform will know which store is mentioned and will save it when the order is created.