Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Integrations
Integration Settings
How to integrate with Farmácias App
How to integrate with Farmácias App

The Farmácias App is a mobile marketplace certified by VTEX. It is available for iOS and Android.

Access permission

To start the integration, it is first necessary to give permission to the Farmácias App integration key. It allows the marketplace to receive and send the updates needed for the &#8211 sales flow – regarding, for example, the receipt of catalogs, shipping calculations and sending of orders.

To configure the key, proceed as follows:

  1. Access the Account Management module;
  2. Click on the Users tab;
  3. Click on the New user button;
  4. Complete the E-mail and Full name fields as follows:

Email: vtexappkey-farmaciasapp-ISBSVR Name: farmaciasapp

Attention: these fields must be filled out exactly as described above.

The role will be: IntegrationProfile-Fulfillment_Oms, IntegrationProfile-Fulfillment_Gateway

{"base64":"  ","img":{"width":761,"height":463,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":78312,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Integrations/Integration%20Settings/integrating-with-farmacias-app_1.png"}}

Then, click on Save.

Afterwards, you will have to:

  1. Create collection (only if your store does not yet have a collection it wishes to allocate to the marketplace);
  2. Create a group by departament, category or sub-category;
  3. Create groups by brand;
  4. Sales policy setup.

Configuring afiliate

Lastly, the affiliate must be registered, as it is the unique identity of the marketplace in your store. To do this, follow the steps below:

  1. Access the Orders Managment module;
  2. Click on the Settings button;
    {"base64":"  ","img":{"width":775,"height":114,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":33085,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Integrations/Integration%20Settings/integrating-with-farmacias-app_2.png"}}
  3. Click on the Affiliates tab;
  4. Click on the New Affiliate button;
  5. Complete the fields as follows:

Name: Farmácias APP; ID: FPP; Trade Policy: inform the ID of the sales policy. E-mail for notifications: e-mail of the person responsible for the integration; Search Endpoint: https://integrador.farmaciasapp.com.br/Vtex/api/notification

{"base64":"  ","img":{"width":755,"height":433,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":88653,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Integrations/Integration%20Settings/integrating-with-farmacias-app_3.png"}}

When the payments are processed using Farmácias App, the Usar meu meio de pagamento option must be disabled. Check this option only for payments processed in different environments, such as payments processed on the VTEX platform.

Once these steps are completed, you must send the following data to the Farmácias App:

  • Store Id Sales;
  • Channel;
  • Affiliate Id;
  • E-mail of the person responsible for the integration;
  • Phone number of the person responsible for the integration.

In the case of payments processed in environments external to the Farmácias App, the following data must also be sent:

  • Bank;
  • Bank code;
  • Branch of recipient’s account;
  • Branch digit;
  • Bank account number of the recipient;
  • Check digit of the recipient’s account;
  • CPF or CNPJ of the recipient.

After this, the Farmácias App will do the necessary settings and tests, publishing several products in its catalog so as to place orders and test the end-to-end flow.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback