VTEX
Passo a passo de configuração
1. Novo perfil de acesso
- Acesse "CONFIGURAÇÕES DA CONTA" na plataforma VTEX.
- Vá para "Gerenciamento da conta" e clique em "Perfis de acesso".
- Clique em "Novo perfil" (botão verde).
- Selecione a opção "Custom" na caixa de seleção.
- Insira o nome do perfil como "SmartEnvios API".
- Selecione o tipo de perfil "OMS" na caixa de seleção.
- Marque todas as permissões em "Recursos OMS access".
- Clique em "Salvar" (botão azul).
2. Caso não exista o perfil "IntegrationProfile - Fulfillment"
- Acesse "CONFIGURAÇÕES DA CONTA" na plataforma VTEX.
- Vá para "Gerenciamento da conta" e clique em "Perfis de acesso".
- Clique em "Novo perfil" (botão verde).
- Selecione a opção "IntegrationProfile - Fulfillment" na caixa de seleção.
- Clique em "Salvar" (botão azul).
3. Nova Chave de Aplicação
- Acesse "CONFIGURAÇÕES DA CONTA" na plataforma VTEX.
- Vá para "Gerenciamento da conta" e clique em "Chaves de aplicação".
- Clique em "GERENCIAR MINHAS CHAVES" (botão azul).
- Clique em "+ GERAR CHAVE" (botão azul).
- Insira o nome "SmartEnvios API" no campo rótulo.
- Selecione os perfis "IntegrationProfile - Fulfillment" e "SmartEnvios API" (previamente criados em "Perfis de acesso").
- Copie a chave de aplicação gerada e salve-a em um local seguro.
4. Estratégia de envio
- Acesse "PEDIDOS" na plataforma VTEX.
- Vá para "Estoque e entrega" e clique em "Estratégia de envio".
- Clique em "+CRIAR POLÍTICA DE ENVIO" (botão azul).
- O "Nome*" é uma visualização interna do lojista, insira o nome da transportadora + via SmartEnvios.
- O "Método de envio*" é uma visualização externa para o cliente final, insira apenas o nome da transportadora.
- Deixe o campo ID zerado.
- Preencha os demais campos conforme as tabelas da SmartEnvios.
- Após preencher as configurações desejadas, clique em "SALVAR ALTERAÇÕES" (botão azul).
Obs.: Se as dimensões configuradas da Vtex estiverem em centímetros, o fator de peso mínimo deverá ser multiplicado por 1000. Exemplo um fator de peso mínimo de 5, deverá ser 5000
JadLog via SmartEnvios
- Soma das dimensões: 240
- Fator de peso cúbico: 0,167
- Maior aresta: 170
- Fator de peso mínimo: 5
Loggi via SmartEnvios
- Soma das dimensões: 200
- Fator de peso cúbico: 0,167
- Maior aresta: 100
- Fator de peso mínimo: 5
Total Express via SmartEnvios
- Soma das dimensões: 200
- Fator de peso cúbico: 0,167
- Maior aresta: 105
- Fator de peso mínimo: 0
GolLog via SmartEnvios
- Soma das dimensões: 250
- Fator de peso cúbico: 0,167
- Maior aresta: 120
- Fator de peso mínimo: 0
Rede Sul via SmartEnvios
- Soma das dimensões: 0
- Fator de peso cúbico: 0,167
- Maior aresta: 60
- Fator de peso mínimo: 10
Carriers via SmartEnvios
- Soma das dimensões: 250
- Fator de peso cúbico: 0,167
- Maior aresta: 105
- Fator de peso mínimo: 5
Sedex via SmartEnvios
- Soma das dimensões: 200
- Fator de peso cúbico: 0,167
- Maior aresta: 70
- Fator de peso mínimo: 5
PAC via SmartEnvios
- Soma das dimensões: 200
- Fator de peso cúbico: 0,167
- Maior aresta: 70
- Fator de peso mínimo: 5
GFL via SmartEnvios
- Soma das dimensões: 200
- Fator de peso cúbico: 0,167
- Maior aresta: 100
- Fator de peso mínimo: 5
J&T Express via SmartEnvios
- Soma das dimensões: 360
- Fator de peso cúbico: 0,167
- Maior aresta: 120
- Fator de peso mínimo: 12
Buslog via SmartEnvios
- Soma das dimensões: Vazio
- Fator de peso cúbico: 0,200
- Maior aresta: 60
- Fator de peso mínimo: vazio
Transwells via SmartEnvios
- Soma das dimensões: Vazio
- Fator de peso cúbico: 0,300
- Maior aresta: vazio
- Fator de peso mínimo: vazio
Trans Express via SmartEnvios
- Soma das dimensões: Vazio
- Fator de peso cúbico: vazio
- Maior aresta: vazio
- Fator de peso mínimo: vazio
5. Configuração SmartEnvios
- Com a chave de aplicação gerada, acesse a plataforma da SmartEnvios.
- Vá para "Configurações
- Em "Configurações", clique em "Integrações".
- Preencha os seguintes campos:
"Nome da conta": Insira o nome da conta VTEX em letras minúsculas, sem espaços.
"X-VTEX-API-AppKey": Insira a chave de aplicação gerada anteriormente em "Chaves de aplicação".
"X-VTEX-API-AppToken": Insira o token de aplicação gerado anteriormente em "Chaves de aplicação". - Após preencher os campos corretamente, teste a configuração e clique em "Confirmar".
6. Validação da Integração
- Para validar a integração de pedidos, crie um pedido de teste na VTEX, preenchendo todas as informações necessárias, como produtos, endereço de entrega, etc.
- Aprova o pagamento desse pedido de teste na VTEX.
- Aguarde um período de 10 a 20 minutos para permitir que o pedido seja importado para o portal da SmartEnvios.
- No portal da SmartEnvios, acesse a seção de "Pedidos de Frete" para verificar se o pedido foi importado corretamente.
- Assim que o pedido estiver disponível no portal da SmartEnvios, você poderá imprimir a etiqueta de envio necessária para o processo de despacho.
Certifique-se de seguir cada etapa com atenção e fornecer todas as informações solicitadas nos campos correspondentes. Este guia detalhado fornecerá um passo a passo completo para configurar corretamente a integração.