Integrar com Farmácias App

Marketplace

Breno Barreto

Breno Barreto

Última atualização

O Farmácias App é um marketplace mobile certificado pela VTEX. Está disponível para iOS e Android.

Permissão de acesso

Para iniciar a integração, é preciso primeiro dar permissão à chave de integração do Farmácias App. Ela permite que o marketplace receba e envie as atualizações necessárias para o fluxo de vendas – relativas, por exemplo, a recebimento de catálogo, cálculo de frete e envio de pedidos.

Para configurar a chave, siga os passos abaixo:

  1. Acesse o módulo License Manager;
  2. Clique na aba Usuários;
  3. Clique no botão Novo usuário;
  4. Preencha os campos Email e Nome completo da seguinte forma:

Email: vtexappkey-farmaciasapp-ISBSVR Nome: farmaciasapp

Atenção: é preciso preencher estes campos exatamente como descrito acima.

O perfil de acesso será: IntegrationProfile-Fulfillment_Oms, IntegrationProfile-Fulfillment_Gateway

Por fim, clique no botão Salvar.

Depois, será necessário:

  1. Criar coleção (apenas se sua loja ainda não possuir uma coleção que deseja atribuir ao marketplace);
  2. Criar grupo por departamento, categoria ou subcategoria;
  3. Criar grupo por marca;
  4. Configurar a política comercial.

Configurando afiliado

Por fim, deve ser realizado o cadastro do afiliado, que serve como identificação única do marketplace em sua loja. Para fazer isso, siga os passos abaixo:

  1. Acesse o módulo OMS;
  2. Clique no botão Conigurações (ícone à direita);
  3. Clique na aba Afiliados;
  4. Clique no botão Novo afiliado;
  5. Preencha os campos da seguinte forma:

Nome: Farmácias APP; ID: FPP; Política comercial: preencha com o ID da política comercial. E-mail de follow up: e-mail da pessoa responsável pela integração; Endpoint de Search: https://integrador.farmaciasapp.com.br/Vtex/api/notification

Quando os pagamentos forem processados por meio do Farmácias App, a opção Usar meu meio de pagamento deve estar desmarcada. Marque essa opção apenas para pagamentos processados em ambientes diferentes, como pagamentos processados na plataforma VTEX.

Após realizar estes passos, você deve enviar os seguintes dados ao Farmácias App:

  • Store Id Sales;
  • Channel;
  • Afiliate Id;
  • E-mail do responsável pela integração;
  • Telefone do responsável pela integração.

Para pagamentos processados em ambientes externos ao Farmácias App, também é necessário enviar os seguintes dados:

  • Banco;
  • Código do banco;
  • Agência da conta do recebedor;
  • Dígito da agência;
  • Número da conta bancária do recebedor;
  • Dígito verificador da conta do recebedor;
  • CPF ou CNPJ do recebedor.

Após isso o Farmácias App fará as configurações e os testes necessários, publicando alguns produtos em seu catálogo para efetuar pedidos e testar o fluxo de ponta a ponta.