Pré-requisitos
- Disponível para os planos Iniciante, Começar, Básico, Crescer, Essencial, Evoluir, Potencializar e Grande.
O que é?
A Fibra Cirúrgica é um marketplace que utiliza da estrutura de VTEX marketplace, com foco no ramo de medicamentos e utensílios médicos, que está disponível para integração no Olist Tiny. Essa integração permite que o sistema se conecte diretamente ao marketplace, possibilitando o processamento dos pedidos através do Olist Tiny.
A integração permite que você importe os pedidos para o Olist Tiny, para que possa gerenciar os mesmos, e também que efetue o controle de estoque da plataforma através do sistema, entre outras funções que facilitam e otimizam sua rotina.
Recursos disponíveis na integração
Receber produtos | X |
Enviar produtos | ✔ |
Enviar e atualizar estoque | ✔ |
Enviar e atualizar preços | ✔ |
Efetuar cotações de fretes | ✔ |
Receber pedidos | ✔ |
Sincronizar situações dos pedidos da plataforma para o Tiny | ✔ |
Enviar dados das NF-es | ✔ |
Enviar rastreamentos | ✔ |
Enviar situação de Entregue para os pedidos | ✔ |
Como configurar a integração?
Para realizar as configurações, acesse menu → início → integrações, clique em adicionar integração, busque por Fibra Cirúrgica e clique em instalar.
Deverá seguir as etapas de configuração, efetuando o preenchimento dos campos conforme:
Observação!
Por padrão, o sistema irá seguir um fluxo em etapas para conclusão das configurações da integração, e a mesma ficará disponível para utilização somente após o fluxo ser finalizado. Mas, se desejar, poderá interromper o preenchimento das informações, clicando em continuar depois, na parte inferior da tela e retomar a configuração de onde parou, em outro momento.
Etapa 1 - Conectar Integração
Neste primeiro momento, irá inserir os dados para gerar as URLs para entre Olist Tiny e Fibra Cirúrgica:
- Nome da integração no Olist Tiny: Este campo deve ser preenchido com o nome o qual deseja identificar esta integração no Olist Tiny. Será através deste nome que esta integração será listada nos menus da sua conta Olist Tiny. Por padrão, o sistema já traz o campo preenchido, como sugestão, com o nome da plataforma.
-
Id do Seller no Marketplace: Este campo deve ser preenchido como "Olist Tiny", para que possa prosseguir com o processo da integração e obter as URLs necessárias para efetivação da integração junto a plataforma.
Observação!
Este preenchimento é temporário, após obter o ID definitivo você deverá voltar nesta etapa e ajustar a informação.
Após preencher os campos, clique no botão conectar com Fibra Cirúrgica, você será direcionado para a aba de configurações de Produtos, volte para a aba de Conexão e em URLs de notificação no Tiny, copie o link da URL para receber notificações e envie para a equipe responsável pela integração no marketplace.
Indicando esta URL para o time da Fibra Cirúrgica, os mesmos irão gerar e lhe fornecer o seu ID do Seller no Marketplace, então você poderá acessar as configurações desta integração e ajustar a informação preenchida neste campo, preenchendo o código correto.
Atenção!
É importante que o campo ID do Seller no Marketplace seja ajustado com o código correto, para que a integração funcione corretamente.Após ajustar o ID do Seller no Marketplace, poderá seguir para as próximas etapas da configuração.
Passo 2 - Preços:
Neste tópico, irá definir quais são as suas preferências quanto ao comportamento dos preços em relação a esta integração:
-
Regra de utilização de preços para o e-commerce:
Neste campo definimos a regra de preço considerada no envio
e recepção de anúncios a partir desta integração. Temos disponíveis
3 opções:
-
Preço fixo: Selecionando esta opção,
ao enviar um anúncio para a plataforma, o preço do
mesmo será
conforme o preço do produto cadastrado no Olist Tiny. O anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente
-
Conforme lista de preços: Selecionando
esta opção, ao enviar um anúncio para a plataforma,
o preço do mesmo será com base na
lista de preço
definida no campo
Lista de preços utilizada nos produtos, que é apresentado quando selecionada esta opção.
-
Conforme regras de preço: Selecionando
esta opção, você poderá definir uma regra de preço
personalizada para esta integração, que será considerada
no envio e recepção dos anúncios, com base no preenchimento
dos campos:
-
Percentual de acréscimo ou desconto: Neste campo deve ser informado o percentual de acréscimo ou desconto, que será aplicado no valor de cadastro do produto no Olist Tiny, para formar o preço a ser considerado para esta integração.
-
Adicional de frete: Neste campo, poderá adicionar regras, com base em faixas de peso ou valor fixo, para definir um valor adicional a ser aplicado ao preço do anúncio, correspondente ao frete.
-
Forma para aplicar os valores adicionais: Aqui, irá escolher a forma de consideração da base de cálculo para a aplicação dos valores adicionais, podendo escolher entre duas opções:
-
Base simples: Inclui
o percentual de acréscimo ou desconto
e o adicional de frete na base de
cálculo para a formação do preço
do anúncio, porém não
preserva o preço
de cadastro do produto.
- Base por dentro: Inclui o percentual de acréscimo ou desconto e o adicional de frete na base de cálculo para a formação do preço do anúncio, e preserva o preço de cadastro do produto.
-
Base simples: Inclui
o percentual de acréscimo ou desconto
e o adicional de frete na base de
cálculo para a formação do preço
do anúncio, porém não
preserva o preço
de cadastro do produto.
-
-
Preço fixo: Selecionando esta opção,
ao enviar um anúncio para a plataforma, o preço do
mesmo será
conforme o preço do produto cadastrado no Olist Tiny. O anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente
Para mais detalhes e informações sobre as configurações das regras de preço dos anúncios, poderá acessar nosso conteúdo: Configure os preços dos anúncios conforme as regras do e-commerce.
Após configurar as considerações de preço conforme sua necessidade, poderá clicar em > salvar e avançar, para seguir para o próximo passo.
Etapa 3 - Pedidos
Passo 1 - Fluxo de Pedidos:
Neste tópico, irá definir quais são as suas preferências quanto ao comportamento de sincronizações de informações dos pedidos em relação a esta integração:
-
Formatar nome dos contatos no recebimento dos pedidos: Com esse parâmetro habilitado, ao importar os pedidos, as primeiras letras do nome e sobrenome do cliente serão transformadas em maiúsculas.
-
Completar endereço do cliente a partir do CEP na importação de pedidos: Com esse parâmetro habilitado, o endereço do cliente será preenchido no Olist Tiny, ao importar os pedidos:
-
Não: Selecionando esta opção, quando o pedido for importado, o endereço do cliente permanecerá incompleto, caso esteja incompleto na plataforma.
-
Apenas se bairro não está informado: Selecionando esta opção, quando o pedido for importado, se o campo bairro do pedido de venda não estiver preenchido, o Olist Tiny irá completar o endereço do cliente, com base no CEP.
- Sempre: Selecionando esta opção, quando o pedido for importado, o CEP sempre será validado junto ao Correios para preenchimento do endereço do cliente. Os dados de endereço obtidos na plataforma de e-commerce serão ignorados.
-
Não: Selecionando esta opção, quando o pedido for importado, o endereço do cliente permanecerá incompleto, caso esteja incompleto na plataforma.
-
Enviar rastreamento ao alterar a situação no Tiny para enviado: Se habilitado este parâmetro, quando o pedido de venda no Tiny chegar na situação Enviado, o sistema irá enviar o código de rastreamento do mesmo para a plataforma automaticamente, se preenchido.
-
Marcar pedido como entregue ao alterar a situação no Tiny: Se habilitado este parâmetro, quando o pedido de venda no Tiny chegar na situação Entregue, o sistema irá enviar esta situação para o pedido na plataforma.
-
Intermediador: Neste campo, selecione o intermediador de suas operações, que deve já estar cadastrado em sua conta. Para mais detalhes, clique aqui.
A informação de intermediador da transação é obrigatória para emissão de NFe!
Por fim, após ajustar os campos conforme sua necessidade, clique em > salvar e avançar
Passo 2 - Dados Fiscais:
Neste tópico, irá definir quais são as suas preferências quanto ao comportamento dos dados fiscais dos pedidos em relação a esta integração:
-
Natureza de operação para venda: Neste campo deve ser selecionada a natureza de operação a ser considerada como padrão para os pedidos importados. Todos os pedidos de venda importados por esta integração serão incluídos com esta natureza por padrão.
- Definir natureza de operação diferente para destinatários contribuintes do ICMS: Se habilitado este parâmetro, ao serem importados os pedidos de venda onde o cliente é contribuinte, o mesmo será identificado e o pedido será salvo no Olist Tiny por padrão com a natureza de operação indicada no campo Natureza de operação de venda para destinatários contribuintes do ICMS, que é apresentado ao ser ativado este parâmetro.
Após selecionar as opções desejadas, poderá clicar em >salvar e avançar para seguir para a próxima etapa da configuração.
Etapa 4 - Mapeamentos
Passo 1 - Situações de Pedido:
Neste tópico, você irá efetuar o mapeamento das situações a serem consideradas para as sincronizações de situação dos pedidos de venda desta integração.
-
Adicionar situações padrão: Ao clicar neste botão, serão listadas automaticamente as situações padrões de pedidos de venda da plataforma, para que você possa efetuar o mapeamento com as situações correspondentes no Olist Tiny, conforme exemplo abaixo:
Na coluna Código da situação no E-commerce são identificadas as situações da plataforma, com seus códigos de identificação e ao lado direito na coluna Situação no Tiny poderão ser indicadas as situações correspondentes no Olist Tiny.
Se possuir alguma situação personalizada na plataforma e deseja mapear a mesma também, basta clicar em + adicionar mapeamento de situação que será adicionada mais uma linha, onde indicará manualmente o código de identificação desta situação na plataforma, e ao lado direito poderá indicar a situação do Olist Tiny.
Observações!
- A imagem demonstrada acima é apenas um exemplo, cada plataforma apresentará suas situações e códigos de forma diferente. É importante que o mapeamento seja feito conforme a sua necessidade.
- É importante que este mapeamento seja realizado, para que você consiga efetuar a sincronização de situações dos pedidos da plataforma para o Olist Tiny. E se você possui o módulo OMS instalado, esta sincronização irá ocorrer automaticamente.
- A sincronização de situação sempre será com base na situação da plataforma, ou seja, o pedido do Olist Tiny receberá a sincronização de situação com base na situação do pedido da plataforma. Atualmente, o Olist Tiny não envia sincronização de situação do sistema para a plataforma.
- Permite retroceder situação dos pedidos na sincronização de situações: Se ativado este parâmetro, ao realizar uma sincronização de situações com a plataforma, o Olist Tiny irá permitir que o pedido aqui no sistema volte para uma situação anterior a situação atual.
Após realizar os mapeamentos conforme sua necessidade, clique em > salvar e avançar.
Passo 2 - Formas de Recebimento:
Neste tópico, você irá definir se os pedidos serão importados, ou não, com a forma de recebimento identificada, e irá efetuar o mapeamento das formas de recebimento da plataforma com a suas correspondentes no Olist Tiny.
-
Importar forma de recebimento nos pedidos: Ao habilitar este parâmetro, os pedidos serão importados com as informações das parcelas.
Se desabilitado, os pedidos não trarão as informações de pagamento.
-
Forma de recebimento padrão: Este campo é apresentado somente se habilitado o parâmetro Importar forma de recebimento nos pedidos.
Ao selecionar uma forma de recebimento neste campo, todos os pedidos importados, que não possuírem a forma de recebimento mapeada, serão inclusos com esta forma de recebimento por padrão.
-
+ adicionar forma de recebimento: Este campo é apresentado somente se habilitado o parâmetro Importar forma de recebimento nos pedidos.
Ao clicar neste botão, será adicionada uma linha com os campos para que seja efetuado o mapeamento do identificador da forma de recebimento da plataforma com a forma de recebimento correspondente no Olist Tiny. O preenchimento é feito conforme exemplo abaixo:
No campo Forma de recebimento você seleciona a forma de recebimento do Olist Tiny, em Meio de recebimento você seleciona o Gateway ou Banco, se assim for necessário, conforme a forma de recebimento selecionada no primeiro campo, e em Código na integração você vai clicar no ícone em forma de "correntinha" 🔗, para buscar o identificador correspondente na plataforma.
- Se você já possui o identificador da forma de recebimento da plataforma, poderá clicar em informar código manualmente e inserir o mesmo.
- Se você ainda não sabe o identificador da forma de recebimento na plataforma, poderá por meio de um pedido já realizado, identificar o mesmo. Basta preencher o número de um pedido da plataforma, que seja desta forma de recebimento, no campo Identificador do pedido na integração e clicar em buscar.
- Se você já possui o identificador da forma de recebimento da plataforma, poderá clicar em informar código manualmente e inserir o mesmo.
-
Forma de recebimento padrão: Este campo é apresentado somente se habilitado o parâmetro Importar forma de recebimento nos pedidos.
Observação!
Não é possível mapear mais de uma forma de recebimento do Olist Tiny com um mesmo identificador, cada forma de recebimento deve possuir um identificador próprio para que o sistema possa fazer a identificação correta.
Após configurar as considerações de mapeamento das formas de recebimento conforme sua necessidade, poderá clicar em > salvar e avançar, para seguir para o próximo passo.
Passo 3 - Formas de Frete:
Neste tópico, você vai efetuar o mapeamento das formas de frete da plataforma com a suas correspondentes no Olist Tiny, para que os pedidos já sejam importados com a forma de envio e frete corretas.
-
+ adicionar: Ao clicar neste botão, será adicionada uma linha com os campos para que seja efetuado o mapeamento do identificador da forma de frete da plataforma com a forma de frete correspondente no Olist Tiny. O preenchimento é feito conforme exemplo abaixo:
No campo Forma de envio você seleciona a forma de envio do Olist Tiny, em Forme de frete você seleciona a forma de frete, se assim for necessário, conforme a forma de envio selecionada no primeiro campo, e em Código na integração você vai clicar no ícone em forma de "correntinha" 🔗, para buscar o identificador correspondente na plataforma.
- Se você já possui o identificador da forma de envio da plataforma, poderá clicar em informar código manualmente e inserir o mesmo.
- Se você ainda não sabe o identificador da forma de envio na plataforma, poderá por meio de um pedido já realizado, identificar o mesmo. Basta preencher o número de um pedido da plataforma, que seja desta forma de envio, no campo Identificador do pedido na integração e clicar em buscar.
- Se você já possui o identificador da forma de envio da plataforma, poderá clicar em informar código manualmente e inserir o mesmo.
Passo 4 - Cotação de fretes:
Neste tópico, você define as formas de envio preferenciais e alternativas de sua loja, para cotação de fretes, sendo possível cotar o valor do frete dos pedidos da plataforma com as formas de envio cadastradas no Olist Tiny.
Adicione as formas de envio clicando em adicionar formas de envio e na tela seguinte selecionando as opções desejadas. Após selecionar e salvar as formas de envio, poderá escolher a forma de envio preferencial clicando no ícone em formato de estrela ao lado direto da forma de envio desejada.
Em seguida, no campo Modo de cotação dos pedidos, irá escolher qual será a forma de cálculo da cotação que será retornada para a plataforma pela API:
-
Menor preço: Ao ser feita cotação de fretes, a forma de envio com o menor valor de frete será considerada.
-
Menor prazo: Ao ser feita cotação de fretes, a forma de envio com o menor prazo de entrega será considerada.
- Maior prazo: Ao ser feita cotação de fretes, a forma de envio com maior prazo de entrega será considerada.
Observação!
As formas de envio alternativas serão utilizadas somente quando não existir cotação para as formas preferenciais.
Por fim, após ajustar os campos conforme a sua necessidade, poderá clicar em finalizar instalação.
Para saber mais detalhes de como gerenciar a sua integração da Fibra Cirúrgica no Olist Tiny, acesse Fibra Cirúrgica - Utilização.