Integrações
- Integrações
- Configurar Plataformas
- Integração - Mercado Livre
- Integração - Loja Integrada
- Integração - Bling
- Integração - AdSomos
- Integração - NuvemShop
- Integração - Plugg.To
- Integração - Shopify
- Integração - Tiny
- Integração - AnyMarket
- Integração - FreteRápido
- Integração - TrayCommerce
- Integração - TrayCorp
- Integração - SkyHub
- Integração - ToutBox
- Integração - Yampi
- Integração - Frenet
- Importar pedidos
- Plugins
- Plugin - OpenCart - V2
- Plugin - OpenCart - V3
- Plugin - WooCommerce
- Plugin - Zendesk (Atendimento ao Cliente)
- Plugin - Magento
Integrações
Configurar Plataformas
As configurações para integrações terão especificidades para cada plataforma.
No portal Boxlink, o procedimento será, em geral, o mesmo, conforme abaixo:
Clique no ícone no canto superior direito
Selecione a plataforma que deseja realizar a integração (Bling, NuvemShop, etc.), defina o nome da loja (Ex.: Bling LOJA) e clique em "Próximo"
Insira o Token gerado no portal da plataforma a integrar e clique em "Salvar"
Integração - Mercado Livre
Essa integração oferece suporte à importação de pedidos
Integração - Loja Integrada
Essa integração oferece suporte à importação de pedidos
Roteiro de ativação da API Boxlink na Loja Integrada
Olá usuário Boxlink e Loja Integrada, neste material apresentaremos as etapas para conectar via API Personalizada o seu sistema Loja Integrada ao portal de serviços da Boxlink.
Com esta integração você poderá acessar no portal de serviços da Boxlink os seus Pedidos de Venda que foram marcados para envio através da logística da Boxlink. No portal da Boxlink você poderá realizar a impressão de sua etiqueta de postagem.
Vamos iniciar o cadastramento da API:
1ª etapa: Acessar painel da Loja Integrada:
https://app.lojaintegrada.com.br/painel/login
2ª etapa: Cadastrar uma nova Chave API
- Clique em "Cadastrar Nova Chave"
- Preencha o campo "Identificação da Chave" e clique em "Cadastrar"
- Copie a chave cadastrada (no campo destacado em vermelho)
Roteiro de ativação da Integração Loja Integrada no Portal Boxlink
1ª etapa: Com a chave da loja integrada copiada, acessar o painel do cliente (seller)
- Informe os campos abaixo da seguinte forma:
Nome da Loja: Informar o nome do Seller;
Token de Acesso: Colocar a chave API copiada na loja integrada;
Usuário: Informar o e-mail de acesso da loja integrada (principal);
Senha: Digitar a senha do usuário informado (OBS: não utilize senhas salvas. Se o campo for preenchido automaticamente, apague a senha e digite novamente).
- Salvar cadastro.
Integração - Bling
Essa integração oferece suporte à importação de pedidos
Roteiro de ativação da API Boxlink no Bling
Olá usuário Boxlink e Bling, neste material apresentaremos as etapas para conectar via API Personalizada o seu sistema Bling ao portal de serviços da Boxlink.
Após este procedimento você terá a opção de selecionar o envio do seu Pedido de Venda através do serviço de logística Boxlink no momento de inclusão da sua venda no Bling.
Com esta integração você poderá acessar no portal de serviços da Boxlink os seus Pedidos de Venda que foram marcados para envio através da logística da Boxlink. No portal da Boxlink você poderá realizar a impressão de sua etiqueta de postagem e integrar automaticamente o rastreio de objetos. Assim que você Gerar Etiqueta Envio (ato de emissão das etiquetas de postagem) no portal da Boxlink, a integração via API Personalizado alimentará seu pedido no Bling com a URL de rastreio da encomenda.
Vamos iniciar o cadastramento da API:
1ª etapa: Acessar painel do Bling:
https://www.bling.com.br/login
2ª etapa: CADASTRO FORNECEDOR - TRANSPORTADORA
- Preencha os dados cadastrais conforme abaixo
- Preencha os dados adicionais
- Clique em "Salvar", no canto superior direito da tela
3ª etapa: CADASTRO USUÁRIO DE CHAVE API
- "+ Incluir usuário" (canto superior direito)
- Selecionar USUÁRIO DE API
- Preencher Nome: Boxlink API
- Preencher E-mail: integracoes@boxlink.com.br
- Gerar API Key
Clique no ícone para copiar a chave API, pois será utilizada nos próximos procedimentos (ativação da Integração Bling no Portal Boxlink)
Em "Permissões" selecionar a aba "Vendas", preencher conforme abaixo e clicar em "Salvar" no canto superior direito da tela
Outras dúvidas sobre as permissões, consulte a ajuda do Bling pelo link abaixo
https://ajuda.bling.com.br/hc/pt-br/articles/360035558634-Usu%25C3%25A1rio-e-Usu%25C3%25A1rio-API
4ª etapa: Cadastro Logística
Em "Logísticas disponíveis" desça a tela até localizar a opção "Bling". Clique no ícone
- Preencha conforme abaixo:
Em "Autenticação" preencha o "Nome da Integração" e clique em "Salvar"
Em "Configuração" preencha conforme abaixo e clique em "Salvar"
Em "Rastreamento" preencha conforme segue:
- No campo "URL de rastreamento personalizada" preencha no lugar de ******* o domínio de seu intermediador logístico, por exemplo: https://rastreamento.*******.com.br/rastreamento
- Nos campos de mensagens poderão ser criadas mensagens personalizadas ou deixe em branco para utilizar a mensagem padrão do Bling.
- Clique novamente em "Salvar"
Em "Serviços de entrega" clique em "Incluir serviço"
Abrirá uma tela lateral, preencha conforme orientações:
- Os serviços deverão ser preenchidos exatamente com o mesmo nome dos serviços cadastrados em seu portal "Cliente" Boxlink
- Em "Transportadora" localize seu intermediador logístico
- A informação de “ID Serviço” e demais campos serão preenchidos automaticamente pelo API de integração
A tela com a relação dos serviços de entrega ficará assim:
- Salvar configurações!
Roteiro de ativação da Integração Bling no Portal Boxlink
1ª etapa: Acessar painel Bling:
Usar a Chave de Integração de API conforme a etapa manual de integração do Bling (Roteiro de ativação da API Boxlink no Bling)
2ª etapa: Acessar painel do Cliente
- Selecionar Integração > Bling e clicar no ícone
- Adicionar nome da Loja > Bling NOME CLIENTE
- Filtrar serviços que serão integrado
- Inserir Token Bling (token gerado no portal de acesso do Bling)
- Salvar cadastro.
Integração - AdSomos
Essa integração oferece suporte à importação de pedidos
Integração - NuvemShop
Essa integração oferece suporte à cotação de frete
Para realizar a integração nas cotações NuvemShop siga o passo a passo abaixo:
OBSERVAÇÃO 1: Cliente deve PREENCHER peso e medidas em TODOS os produtos para funcionar corretamente a integração ou consultar seu canal para contratar o serviço "Experiência Pós Checkout"
OBSERVAÇÃO 2: AS CONFIRGURAÇÕES PARA INTEGRAÇÃO COM NUVEMSHOP DEVEM SER FEITAS OBRIGATORIAMENTE EM "JANELA ANÔNIMA" PELO BROWSER "GOOGLE CHROME"
Acesse o Google Chrome. Clique no ícone e escolha a opção "Nova janela anônima" para acessar o portal do cliente.
Localize a opção "Nuvemshop"
Clique no ícone (Configurar) e escolha um nome para sua loja, por exemplo: "Sua Loja - Nuvemshop". Clique em "Serviços" e o sistema te direcionará para a NuvemShop
Faça seu login no portal "Nuvemshop"
Siga os passos clicando sempre em "Seguinte"
Depois em "Aceitar"
Após aceitar você será redirecionado ao portal Boxlink e a integração estará habilitada.
Agora é preciso determinar os Serviços que estarão disponíveis nas cotações, para isso acesse novamente o menu da barra lateral esquerda, clique em "Integrações", localize a "Nuvemshop", clique no ícone (Configurar) e em "Detalhes"
Adicione um novo Pacote de Serviços clicando em "Adicionar"
Dê o nome de sua transportadora ao nome do pacote e clique em "Criar"
Por fim, escolha os serviços deste pacote, clicando no ícone (Gerenciar serviços do pacote) em "Ações"
Escolha o serviço disponível e clique em "integrar"
Pronto já pode ter as cotações Boxlink diretamente na sua loja NuvemShop
Caso queira adicionar outros serviços às suas cotações, repita a escolha dos serviços deste pacote, clicando no ícone , em "Ações"
Para conferir se a ativação foi concluída com sucesso, retorne ao portal Nuvemshop e, no menu inicial clique em "Configurações"
Clique em "Formas de entrega e verifique se a "Sua Transportadora" aparece na relação de entregas "Ativas"
Para verificar ou configurar cada serviço disponível de sua transportadora clique em "Editar" e abrirá a tela a seguir: Mantenha a opção "Permitir" ativada e, caso deseje oferecer frete grátis para determinado serviço, acione a opção "Eu quero oferecer...... para produtos com frete grátis"
Salve as alterações!
OBERVAÇÃO 1: Cliente deve PREENCHER peso e medidas em TODAS as peças para funcionar corretamente a integração ou consultar seu canal para contratar o serviço "Experiência Pós Checkout"
OBSERVAÇÃO 2: AS CONFIRGURAÇÕES PARA INTEGRAÇÃO COM NUVEMSHOP DEVEM SER FEITAS OBRIGATORIAMENTE EM "JANELA ANÔNIMA" PELO BROWSER "GOOGLE CHROME"
--------------------------------------------------------------------------------------------------------------------------------------------
COMO EXPORTAR SUAS VENDAS DA NUVEMSHOP PARA IMPORTAR NA BOXLINK?
Para exportar a lista de vendas registrada na Nuvemshop, acesse o portal da própria Nuvemshop e, no menu principal, clique em "Vendas"
Utilize os filtros que desejar para facilitar a busca dos envios que deseja exportar, como status do pedido ou data, por exemplo; Selecione a sua transportadora integrada no campo "Meio de Envio" e clique em "Filtrar"
Aparecerá a relação dos pedidos encontrados, clique em "Exportar Resultados"
IMPORTANTE: A Exportação só funcionará nesta integração se o sistema operacional utilizado for o "Windows".
Clique em "Exportar"
Será gerada uma planilha com o layout conforme modelo abaixo:
Esse layout deverá estar previamente cadastrado na plataforma Boxlink, pelo portal do Canal Logístico, conforme manual disponível no link: https://wiki.boxlink.com.br/link/43#bkmrk-page-title
Para importar seus pedidos para gerar as etiquetas na plataforma Boxlink e dar continuidade ao seu envio, siga o manual disponível no link: https://wiki.boxlink.com.br/link/34#bkmrk-page-title
ou
Caso utilize outra plataforma integrada para importação de pedidos, siga o passo a passo disponível no link: https://wiki.boxlink.com.br/link/40#bkmrk-page-title
Integração - Plugg.To
Essa integração oferece suporte à cotação de frete e a importação de pedidos
Integração - Shopify
Essa integração oferece suporte à cotação de frete e a importação de pedidos
Como posso adicionar uma transportadora personalizada usando minhas próprias credenciais? Você poderá adicionar contas de transportadoras se a loja estiver no plano Advanced Shopify, Shopify Plus ou tiver o recurso de frete calculado pela transportadora. |
Para ter acesso a integração é necessário que a loja tenha esta funcionalidade no plano da assinatura Shopify.
A assinatura anual, além de habilitar este recurso (CCS = Carrier Calculated Shipping) gratuitamente por 1 ano, oferece 10% de desconto no custo da assinatura. O plano bianual também habilita o recurso CCS gratuitamente e tem 20% de desconto em relação ao plano mensal.
A alteração para o plano anual deverá ser feita no portal Shopify.
Assim que o plano for alterado é preciso abrir um chamado no chat de suporte da Shopify (somente inglês), acessando com "admin" e senha da Shopify ou na página de suporte, deverá ser aberto um ticket solicitando que o cálculo de frete para terceiros (CCS) seja habilitado de forma gratuita. O prazo de resposta da Shopify é em até D+1.
Após este procedimento basta seguir o passo a passo abaixo, para configurar a integração da Shopify com a Boxlink:
1 - Criando o aplicativo e recuperando a chave e senha da API do App Shopify.
Faça seu login no portal da Shopify https://accounts.shopify.com/store-login
Clique em "Desenvolver app", na tela de "Apps", conforme abaixo
Abrirá a tela de "Desenvolvimento de apps". Clique em "Criar um app"
Abrirá a tela "Criar um app"
Em "Nome do app" preencha com "boxlink-app"
Em "Desenvolvedor do app", selecione o usuário responsável por este cadastro (aparecerá previamente preenchido com o login usado para acessar o sistema"
Para concluir clique em "Criar app"
Na aba "Configuração" (Configuration), em "Admin API Integration" clique em "Configurar" (Configure)
Ative TODAS as permissões "Read" and "Write" ou "Ler" e Gravar", conforme exemplo:
Role o cursor até o final da página, localizando "Assinaturas do webhook" e selecione a opção "2022-04"
Clique em retornando ao canto superior direito da tela
Na aba "Visão geral" aparecerá a mensagem "Faça a instalação para receber o token de acesso", clique em "Instalar"
Aparecendo a tela de confirmação, clique novamente em "Instalar"
Na aba "Credenciais da API" copie o "Token" (clicando em "Revelar token uma vez") para cadastrar a integração na plataforma Boxlink
Na aba "Confirgurações do app", preencha o campo "Descrição" com a palavra "Frete" e clique em "Salvar"
Acessar painel do Cliente da plataforma Boxlink
Clique no ícone para "Configurar"
- Definir nome da Loja - Por exemplo: Shopify NOME LOJA
- Definir URL da Loja - Por exemplo: NOME_LOJA
- Inserir Token copiado do portal Shopify
- Clicar em "Salvar"
Após configurar a integração, clique no ícone no canto direito
Abrirá a tela "Integração de Pacote Transportadoras Shopify", clique em para "Criar Novo Pacote de Serviços"
Escolha o nome para seu "Pacote de Serviços" e clique em "Criar"
Retornando ao portal Shopify:
Configurando o frete na loja.
Em seguida clique em "Frete e entrega" ou "Shipping and delivery"
Em "Frete", clique em "Gerenciar taxas"
Selecione "Brasil" e clique em "Adicionar taxa"
Selecione a opção "Utilizar taxas da transportadora e do app", selecione o Pacote de Serviços que cadastrou no Portal Boxlink e selecione os Serviços que deverão aparecer na finalização da compra na loja virtual
Clique em "Pronto"
Sua Integração está pronta!!
Integração - Tiny
Essa integração oferece suporte à importação de pedidos
Para configurar a integração com o Tiny siga o passo a passo abaixo:
1ª etapa: Painel Tiny
No menu geral -> Clique em "Token API":
O token gerado será exibido no campo "Token" e deverá ser copiado para colar no portal Boxlink.
Vamos agora para a segunda etapa
2ª etapa: Painel Boxlink
- Adicionar nome da Loja > Tiny NOME CLIENTE
- Inserir Token Tiny (token gerado no portal de acesso do Tiny)
- Salvar cadastro.
3ª etapa: Painel Tiny - Cadastrando o canal (transportador) no Tiny
- Em seguida, clicar em Incluir cadastro
- Informar os dados conforme deverá aparecer no campo "Transportador" da nota fiscal:
-
- Nome: Neste campo, informar o nome do transportador
- Tipo de Pessoa: Selecionar "Pessoa Jurídica"
- CNPJ: Informar CNPJ válido e não cadastrado no Tiny ERP
- Inscrição Estadual: Informar IE
- Tipo de Contrato: Escolher "Transportador"
- Endereço: Informar o CEP e clicar em
para preencher automaticamente o endereço, devendo ser incluído apenas número e complemento. Caso não atualize automaticamente, informar os campos endereço e bairro manualmente.
- Contato: Informar telefone e e-mail do transportador
- Clicar em "Salvar" para finalizar o cadastro.
4ª etapa: Painel Tiny - Configurando Formas de Envio
- Em seguida, clicar em "Incluir Forma de Envio"
- Informar os dados da "Forma de Envio":
- Tipo de Logística: Selecionar "Customizado"
- Descrição da forma de envio: Informar o nome da forma de envio.
- URL de rastreamento padrão: Neste campo, informar a url utilizada para rastreamento de envio.
- Cadastrar cada forma de frete contemplada na forma de envio:
Descrição: Neste campo, informar o nome da estratégia de frete, em caixa alta (letra maiúscula)
Código do serviço: Informar código de serviço de sua preferência.
Tipo de entrega: Não é necessário o preenchimento
Transportador: Selecionar a transportadora cadastrada na 3ª etapa.
- Clicar em Salvar
- Repetir o processo de cadastro até que todas as estratégias de frete tenham sido cadastradas
- Clicar em Salvar para finalizar a integração e configuração.
Integração - AnyMarket
Essa integração oferece suporte à cotação de frete
Integração - FreteRápido
Essa integração oferece suporte à cotação de frete
Integração - TrayCommerce
Essa integração oferece suporte à cotação de frete.
Integração da Boxlink nas cotações da Tray Commerce
Passo 1
- Acesse seu painel administrativo (Tray) e no menu da barra lateral esquerda clique em "Configurações"
- Localize o quadro "Frete e Envio" e clique em "Geral"
- No canto superior direito clique em “Integração Externa”
Para que seja possível integrar a Boxlink você deve antes habilitar o Gateway de Frete em sua loja virtual Tray.
-
Em “Habilitada” você somente conseguirá marcar a opção "SIM" após fazer a configuração das demais informações desta aba e também as configurações da aba Configurações, ou seja, faça as configurações normalmente como você verá abaixo e depois volta à aba Principal e marque a opção como SIM.;
-
Nome da integração: Boxlink;
-
URL de Rastreio: https://rastreamento.{seu-dominio}.com.br/rastreamento (Ex: Domínio sendo boxlink.com.br, a URL seria: https://rastreamento.boxlink.com.br/rastreamento )
- Prazo de Entrega: Escolha se deseja considerar "Dias corridos" ou "Dias úteis"
-
Taxa sobre o valor dos produtos: Caso deseje que seja incluído um terceiro valor a ser somado, além do preço do pedido mais preço do frete (acréscimo em %);
-
Taxa adicional no pedido: Adicional de um terceiro valor à compra, ou seja, será somado o valor do pedido mais o valor do frete mais a taxa que configurar neste campo (acréscimo em R$);
-
Taxa sobre o valor do frete em (%): Tem a mesma funcionalidade das opções anteriores, a % inserida neste campo será calculada sobre o valor do frete e será acrescida no valor final da compra;
-
Tipo: deixar em branco
-
Informações aos clientes: Preencha conforme exemplo: "Prazo de entrega: [prazo_entrega] dias úteis"
Após as configurações acima, deverá salvar e ir para a aba “Configuração”
Em "Configuração" preencha a URL e o Token (próximo passo demonstra como gerar o Token na plataforma Boxlink)
- URL de WebService: https://boxtray.boxlink.com.br/tray
-
Token - colar aqui o Token gerado na Boxlink
Passo 2
Para gerar o Token Boxlink, acesse o menu da barra lateral esquerda, no portal da Boxlink e clique em "Cadastros" > “Dados Empresa”
Clique em "Gerar Token" e copie o "Token para Integração com API" clicando em "Copiar Token"
Pronto!
Integração - TrayCorp
Essa integração oferece suporte à cotação de frete
Para cadastrar o "Frete Custom" no Admin confira o link: https://traycorp.desk360.com.br/ajuda/article/cadastrando-o-frete-custom-no-admin
Ou siga o passo a passo abaixo:
Clique em "Salvar"
Selecione: Ativo
URL : **https://boxtray.boxlink.com.br/traycorp**
Tipo de chave: "token"
Valor: Copie e cole o token gerado no portal Boxlink***
Clique em: "+ Adicionar"
Clique em: "Salvar"
***Para gerar o Token Boxlink, acesse o menu da barra lateral esquerda, no portal da Boxlink e clique em "Cadastros" > “Dados Empresa”
Clique em "Gerar Token" e copie o "Token para Integração com API" clicando em "Copiar Token"
Pronto sua integração já está configurada!
Integração - SkyHub
Essa integração oferece suporte à cotação de frete
O marketplace B2W é administrado pela SkyHub.
Para integrar as cotações ao SkyHub, será necessário criar uma URL em nosso portal e entrar em contato com a Skyhub, para homologá-la.
Mais informações sobre esse procedimento no link: https://desenvolvedores.skyhub.com.br/integracao-frete/como_homol_frete
Gerando sua URL:
URL será composta por:
- O prefixo:
https://boxtray.boxlink.com.br/skyhub/
- *O Cep do seu cadastro na Boxlink (SOMENTE NÚMEROS)
- Seu id de usuário na Boxlink
- *O id da matriz = 1 (sempre 1)
- O id do canal Boxlink que te atende na primeira milha
- Seu id de Seller/Cliente na Boxlink
- O e-mail associado ao id de usuário
Da seguinte forma:
https://boxtray.boxlink.com.br/skyhub/{cepOrigem}/{userId}/{matrizId}/{canalId}/{clienteId}/{userEmail}
ex.: https://boxtray.boxlink.com.br/skyhub/88015010/430/1/1/16/skyhub@boxlink.com.br
Integração - ToutBox
Integração - Yampi
Essa integração oferece suporte à cotação de frete
Para realizar a integração da plataforma Boxlink com a Yampi, siga o passo a passo a seguir:
Inicialmente será necessário acessar seu portal do Cliente na plataforma Boxlink para gerar a URL de cotação.
Localize a "Yampi" e clique no ícone no canto inferior direito para abrir as opções de configuração
Escolha um nome para sua loja e clique em "Salvar"
Essa integração passará para a parte superior da tela, clique novamente no ícone e verifique a URL gerada
Clique no ícone para copiar a URL de cotação e guarde esse link pois será utilizado a seguir no Portal Yampi
Clique no ícone "Gerar Token" e em seguida "Copiar Token". Guarde também esta informação pois será utilizada no portal Yampi
Agora será necessário criar uma API de frete pelo painel da Yampi, acessando o menu "Configurações > "Logística" > "API de Frete"
Clique em "Novo Frete"
Clique em "API"
Preencher o Nome com o mesmo nome escolhido no portal Boxlink
Em URL cole a URL copiada no portal Boxlink
Clique em "Adicionar um header"
Em "Headers"
Preencha o campo "CHAVE" com: "X-Blk-token"
Em "VALOR": Cole o Token gerado no portal Boxlink
Clique em "Salvar"
Pronto! Sua integração entre Boxlink e Yampi está concluída para cotação de frete!
Integração - Frenet
Para realizar a integração da plataforma Boxlink com a Frenet, siga o passo a passo a seguir:
Inicialmente será necessário acessar seu portal do Cliente na plataforma Boxlink para gerar a Chave API, no menu da barra lateral esquerda clique em "Cadastros" > "Dados Empresa"
Clique no ícone "Gerar Token" e em seguida "Copiar Token". Guarde esta informação pois será utilizada no portal Frenet
Agora faça seu login no portal FRENET e clique no menu "Transportadoras". Role a página para baixo até encontrar a opção "Todas as Transportadoras" e busque seu Canal Logísitico, por exemplo: Envioo.
Habilite os serviços desejados, por exemplo: Base, Qualy, CARGO SP, etc.
Clicando no ícone preencha as informações abaixo
- Chave API = Token copiado no portal Boxlink
- Cubagem = 167
- Limite de isenção = 5
Feito isso a integração já irá funcionar e as formas de entrega da irão aparecer nas cotações de frete no site do cliente.
Importar pedidos
Importar pedidos utilizando a integração de plataformas no portal Boxlink
Neste manual utilizaremos a plataforma "Bling" como exemplo para o passo a passo da ferramenta "Integrações / Importar Pedidos"
No campo "Integração", selecionar a plataforma (previamente configurada) que deseja importar, por exemplo: Bling - NOME CLIENTE
Selecionar o período de pedidos, escolhendo data inicial e final e clicar em "Pesquisar"
É possível filtrar também pela situação do pedido ou pela situação interna do envio, conforme exemplos:
Selecionar quais pedidos deseja gerar as etiquetas de postagem e clique em "Gerar Etiquetas"
Aparecerá a seguinte tela:
Selecione a melhor opção referentes ao Valor Declarado para Seguro (se tiver preenchido os dados da nota fiscal e/ou da declaração de conteúdo em seu arquivo, basta selecionar a primeira opção). Clique em "Confirma"
Será aberta a confirmação da importação dos dados e impressões das etiquetas
Neste momento poderá somente sair sem imprimir as etiquetas ou já realizar a impressão. Também é possível já gerar a Lista de Envios que será utilizada na Ordem de Coleta.
Plugins
A configuração genérica a ser feita na plataforma Boxlink segue o passo a baixo abaixo:
Aparecerão os "Plugins Disponíveis", como no exemplo abaixo:
Clicando no ícone do Plugin aparecerão as configurações:
Preencha os campos acima com as seguintes informações:
URL: Site da loja
ConsumerKey: Chave
ConsumerSecret: Senha
Situação: Status do envio na plataforma Boxlink
Valor da situação: Status do envio correspondente ao anterior, na plataforma do Plugin (WooComerce, OpenCart, etc.)
Exemplo de "Situação"
Exemplos de "Valor da Situação"
Plugin - OpenCart - V2
A integração entre a Boxlink e o OpenCart disponibiliza o simulador de frete, envio de pedidos para Boxlink e impressão de etiquetas. Siga o passo a passo abaixo para instalação e configuração do plugin.
- INSTALAÇÃO
Acesse o módulo administrativo do portal OpenCart e, no menu da barra lateral esquerda, acesse "Extensões" > "Instalador" e clique em "Envio"
Localize o arquivo ".zip" que recebeu da Boxlink para fazer upload e clique em "Abrir"
Após a instalação, acesse "Extensões" > "Extensões", no menu da barra lateral esquerda. Na Lista de Extensão, selecione a opção “Módulos”. Na tela de módulos encontre “Boxlink” e clique em ícone verde “Instalar”
- CONFIGURAÇÕES
Para configurar seu plugin é necessário obter o token no portal da Boxlink, para isso acesse o menu da barra lateral esquerda e clique em "Cadastros" > “Dados Empresa”
Clique em "Gerar Token" e copie o "Token para Integração com API" clicando em "Copiar Token"
Retornando ao portal OpenCart, no menu da barra lateral esquerda agora terá também o item "Boxlink". Clique em "Boxlink" > "Configurações Boxlink", preencha seu token gerado e o CEP cadastrado na Boxlink.
- LIBERANDO PERMISSÕES NAS TELAS
O Plugin é composto pelas telas de configurações: “Vendas disponíveis para enviar para Boxlink” e “Etiquetas para impressão”. Para ter acessos à elas é necessário cadastrar os perfis de usuário que podem visualizar essas telas.
Para isso, no portal OpenCart acesse o menu "Configurações" > "Gerenciar Usuários" > "Grupos de Usuários"
Selecione o "Grupo de Usuário" que deseja incluir a permissão de acesso às telas e clique no ícone “Editar”
Agora é necessário dar as “Permissões de Acesso” e “Permissões de modificação” para todos os itens que tiver “box_link”. (Para facilitar este processo, utilize "CTRL+F" e busque por “box_link ou clique na opção “marcar todos”)
Pronto! As telas estarão disponíveis no menu "Boxlink"
- SIMULANDO FRETE
Após adicionar produtos em seu carrinho, acesse "carrinho" > "simular frete", selecione um dos serviços e finalize a venda
- ENVIANDO VENDA PARA BOXLINK
Na tela "Boxlink" > "Enviar para Boxlink" aparecerão todas as vendas com envio pela Boxlink. Selecione as vendas que deseja enviar e clique em “Enviar para Boxlink”.
- IMPRIMIR ETIQUETAS
Após envio das vendas para Boxlink, estes itens ficarão disponíveis na tela “Visualizar Pré-Venda”. Selecione as Pré-Vendas que deseja imprimir, escolha o formato da etiqueta e clique em “Imprimir”.
IMPORTANTE: Para que a integração funcione corretamente, TODOS os produtos devem estar com PESOS E DIMENSÕES preenchidos corretamente
Plugin - OpenCart - V3
A integração entre a Boxlink e o OpenCart disponibiliza o simulador de frete, envio de pedidos para Boxlink e impressão de etiquetas. Siga o passo a passo abaixo para instalação e configuração do plugin.
- INSTALAÇÃO
Acesse o módulo administrativo do portal OpenCart e, no menu da barra lateral esquerda, acesse "Extensões" > "Instalador" e clique em "Envio"
Localize o arquivo ".zip" que recebeu da Boxlink para fazer upload e clique em "Abrir"
Após a instalação, acesse "Extensões" > "Extensões", no menu da barra lateral esquerda. Na Lista de Extensão, selecione a opção “Módulos”. Na tela de módulos encontre “Boxlink” e clique em ícone verde “Instalar”
- CONFIGURAÇÕES
Para configurar seu plugin é necessário obter o token no portal da Boxlink, para isso acesse o menu da barra lateral esquerda e clique em "Cadastros" > “Dados Empresa”
Clique em "Gerar Token" e copie o "Token para Integração com API" clicando em "Copiar Token"
Retornando ao portal OpenCart, no menu da barra lateral esquerda agora terá também o item "Boxlink". Clique em "Boxlink" > "Configurações Boxlink", preencha seu token gerado e o CEP cadastrado na Boxlink.
- LIBERANDO PERMISSÕES NAS TELAS
O Plugin é composto pelas telas de configurações: “Vendas disponíveis para enviar para Boxlink” e “Etiquetas para impressão”. Para ter acessos à elas é necessário cadastrar os perfis de usuário que podem visualizar essas telas.
Para isso, no portal OpenCart acesse o menu "Configurações" > "Gerenciar Usuários" > "Grupos de Usuários"
Selecione o "Grupo de Usuário" que deseja incluir a permissão de acesso às telas e clique no ícone “Editar”
Agora é necessário dar as “Permissões de Acesso” e “Permissões de modificação” para todos os itens que tiver “box_link”. (Para facilitar este processo, utilize "CTRL+F" e busque por “box_link ou clique na opção “marcar todos”)
Pronto! As telas estarão disponíveis no menu "Boxlink"
- SIMULANDO FRETE
Após adicionar produtos em seu carrinho, acesse "carrinho" > "simular frete", selecione um dos serviços e finalize a venda
- ENVIANDO VENDA PARA BOXLINK
Na tela "Boxlink" > "Enviar para Boxlink" aparecerão todas as vendas com envio pela Boxlink. Selecione as vendas que deseja enviar e clique em “Enviar para Boxlink”.
- IMPRIMIR ETIQUETAS
Após envio das vendas para Boxlink, estes itens ficarão disponíveis na tela “Visualizar Pré-Venda”. Selecione as Pré-Vendas que deseja imprimir, escolha o formato da etiqueta e clique em “Imprimir”.
IMPORTANTE: Para que a integração funcione corretamente, TODOS os produtos devem estar com PESOS E DIMENSÕES preenchidos corretamente
Plugin - WooCommerce
Para realizar a integração entre a Boxlink e o WooCommerce siga o passo a passo abaixo
- INSTALAÇÃO
Para instalar o plugin, no portal WooCommerce, acesse o painel de plugins e clique em "Adicionar novo"
Clique em “Enviar plugin”
Selecione o arquivo “.zip”, que você poderá baixar no menu plugins conforme imagem abaixo:
Clique em “Instalar agora”
Feito isso o ícone para as telas da integração com a Boxlink aparecerão no seu menu administrativo. Além disso, também aparecerá a nova opção "Importar dados para o plugin boxlink" no combo da tela de pedidos do WooCommerce
- CONFIGURAÇÃO
Para configurar seu plugin é necessário obter o token no portal da Boxlink, para isso acesse o menu da barra lateral esquerda e clique em "Cadastros" > “Dados Empresa”
Clique em "Gerar Token" e copie o "Token para Integração com API" clicando em "Copiar Token"
Retornando ao portal WooCommerce, acesse o menu da barra lateral esquerda e clique em "Configurações Boxlink". Aparecerá a tela de "Configurações de Integração" com o campo "Acess Token da BoxLink" em branco. Cole neste campo o token que copiou e clique em "Salvar alterações"
Para que o plugin funcione corretamente é necessário acessar o menu da barra lateral esquerda do portal WooCommerce e clicar em "Settings" (Configurações) > "Shipping" (Envio) > "Shipping options" (Opções de envio) e ativar a primeira opção das configurações: "Enable the shipping calculator on the cart page" (habilitar a calculadora de frete na página do carrinho)
Feito isso, ainda em WooCommerce > Configurações, clique na aba "Entrega" e em seguida clique em "Adicionar área de entrega"
Passando o mouse por cima da área de entrega adicionada aparecerá as opções "Editar I Excluir", clique em "Editar"
Habilite as opções "Envioo Qualy", "Envioo Base", "Envioo Cargo".
Agora acesse "Produtos" > "Todos os produtos". Passando o mouse por cima do nome do produto aparecerão as opções "Editar I Edição rápida I Lixeira I Ver I Duplicar", clique em "Editar"
Role o mouse para baixo até o campo "Dados do produto" e clique em "Entrega". Preencha as informações de "Peso" e "Dimensões"
Role o mouse para cima até visualizar no canto direito da página o quadro "Publicar" e clique em "Atualizar"
Repita esse procedimento para todos os produtos cadastrados, garantindo assim que o frete seja cotado corretamente.
- USABILIDADE
Após configurar o plugin, quando seus clientes forem para o carrinho de compras, aparecerá a tela de precificação do envio, logo abaixo do carrinho. Então, é só o cliente digitar as informações requeridas, escolher o serviço desejado e prosseguir para o checkout
O valor do frete já será somado ao valor da compra e aparecerá na tela de visualizar o pedido do WooCommerce, assim como o prazo de acordo com o serviço escolhido
Para gerar as pré-postagens no portal da Boxlink, primeiramente temos que importar os dados das vendas para o plugin. Para isso, basta ir na tela de pedidos do WooCommerce, selecionar a venda, escolher no combo a opção “Importar dados para o plugin box link” e clicar em aplicar
Após o sistema importar as vendas, aparecerá uma mensagem de sucesso na parte superior da tela. Com isso, as vendas foram importadas.
Para gerar as pré-postagens, acesse o menu da barra lateral esquerda do portal WooCommerce e clique em "Configurações Boxlink" > "Pré vendas". Aparecerão as vendas importadas para o plugin, escolha as vendas e clique em "Visualizar".
Preencha o número e a chave da Nota Fiscal (para gerar envio com NF) ou o número do documento do destinatário (se o envio for com Declaração de Conteúdo) e clique em "Salvar"
Pronto! A venda está pronta para ser enviada para a Boxlink. Repita essa operação para todas as vendas que deseja gerar pré-postagem.
Selecione as vendas que já estão com a NF-e ou documento do destinatário preenchido e clique em “Gerar Pré-Postagens”. Será gerado um rastreio que ficará salvo nos dados da venda importada. Para imprimir as etiquetas basta selecionar novamente as vendas que já possuem rastreio e clicar em "Imprimir"
Nota 1 - Após gerar a pré-postagem, as etiquetas também ficam disponíveis para impressão no portal Boxlink em "Etiquetas"
Nota 2 - Na tela "Pré Vendas" do portal WooCommerce aparecerão sempre as vendas criadas dos últimos 5 dias, porém, é possível pesquisar vendas anteriores, selecionando o intervalo de datas e clicando em "Pesquisar"
Exemplo de etiqueta gerada:
Plugin - Zendesk (Atendimento ao Cliente)
Para realizar a integração entre a Boxlink e a Zendesk siga o passo a passo abaixo
- INSTALAÇÃO
Para instalar o plugin, no portal Zendesk, acesse o menu da barra lateral esquerda, clique no ícone e em seguida, clique no botão "Carregar aplicativo privado"
No campo "Nome do aplicativo" escreva "boxlink" e clique em "Selecionar arquivo". Selecione o arquivo "boxlink-zendesk.zip" e clique em "Abrir"
Abrirá a tela de "Criação de novo aplicativo", clique em "Carregar"
Abrirá a tela "Marketplace da Zendesk". Clique em "Instalar"
Pronto! Sua instalação está concluída!
- USABILIDADE
Ao abrir um ticket, o App aparecerá ao lado direito da tela.
Primeiro faça login com suas credencias de acesso a plataforma Boxlink para habilitar o App. Uma vez logado, os envios referentes ao cliente que abriu o chamado serão exibidos no App Boxlink.
Você pode ainda pesquisar por e-mail, CPF ou número do pedido na caixa de pesquisa.
Ao clicar em um objeto encontrado será possível consultar os detalhes deste objeto
Plugin - Magento
Para realizar a integração entre a Boxlink e a Magento siga o passo a passo abaixo
- GUIA DE INSTALAÇÃO
Para instalar o plugin, obtenha gratuitamente a “plataforma de envio Boxlink” em: https://marketplace.magento.com/boxlinkshippingmethod.html
Use o login do cliente
Obtenha a chave de acesso no link: https://marketplace.magento.com/customer/accessKeys/
Editar: /var/www/html/magento2/auth.json
Módulo de Instalação: composer require boxlink/shippingmethod
Habilitar módulo Boxlink: bin/magento module:enable Boxlink_Shippingmethod
Definir configurações em: Stores > Configuration > Boxlink > Configuration Boxlink
- CONFIGURAÇÕES
A extensão Boxlink adquirida do Magento Marketplace pode ser instalada através do Magento Component Manager integrado da ferramenta Web Setup Wizard.
Para obter um guia completo, vá para https://devdocs.magento.com/extensions/install/
Configure em: "SALES > Configuration > Boxlink > Boxlink Configuration" ou "VENDAS > Configuração > Boxlink > Configuração da Boxlink"
Os valores de frete estarão disponíveis no carrinho e na finalização da compra:
Em "SALES > Orders" ou "VENDAS > Pedidos" envie dados para o sistema Boxlink selecionando os itens na lista de pedidos para enviar ao sistema Boxlink:
Clique em "OK"
Após enviar os dados para o sistema Boxlink, baixe a etiqueta de envio (selecione na lista de pedidos para enviar para o sistema Boxlink):
Clique em "Ok"
- GUIA DE DESINSTALAÇÃO
Execute o comando: bin/magento module:disable Boxlink_Shippingmethod
Execute o comando: composer remove boxlink/shippingmethod