Como cadastrar a J&T Express
Configure a transportadora J&T Express na sua loja virtual para disponibilizar essa opção de frete aos seus clientes.
Pré-requisito
Antes de iniciar, confirme que você possui contrato ativo com a J&T Express.
Criando o tipo de frete
Para iniciar a configuração:
- Acesse Configuração > Tipos de frete.
- Clique em Criar tipo de frete.
- Selecione a opção J&T Express.
Entendendo as abas de configuração
A configuração está dividida nas seguintes abas:
- Geral
- Canais
- Configurações do frete
- Expedição
- Regras de exibição
- Rastreamento
- Performance
Preenchendo a aba Geral
Na aba Geral, informe:
- Nome interno: usado apenas para identificação interna
- Nome: exibido ao cliente
- Ativo: define se o frete ficará disponível
- Descrição: campo interno para observações
Preenchendo a aba Canais
Na aba Canais, selecione os canais que utilizarão esse tipo de frete.
Preenchendo a aba Configurações do frete
Na aba Configurações do frete, configure os dados da integração e envio.
J&T Express
Preencha os campos abaixo com os dados fornecidos pela transportadora:
- Conta da API: valor do API Account
- Chave privada: valor da Private Key
- Senha: valor da Password
- Código do cliente: valor do Customer Code
- CEP origem: CEP de onde as mercadorias serão enviadas
Embalagem
No campo Tipo de item, selecione o tipo de mercadoria que será transportada pela J&T Express.
No campo Adicional de peso, informe uma margem de segurança para o cálculo do frete.
Recomendamos o valor 100, que corresponde a 100 g.
Prazo
No campo Adicional de prazo, informe uma margem de segurança para o prazo de entrega.
Exemplo: se a J&T Express calcular 3 dias e você adicionar 3 dias, o cliente verá o prazo total de 6 dias.
Valor
Você pode configurar margens de segurança no valor do frete.
Adicional fixo de preço
Use esse campo para somar um valor fixo ao frete calculado.
Exemplo: R$ 10,00 + R$ 5,00 = R$ 15,00.
Adicional percentual de preço
Use esse campo para aplicar um percentual sobre o valor do frete.
Exemplo: R$ 10,00 + 20% = R$ 12,00.
Frete grátis a partir de
Se desejar, informe um valor mínimo de carrinho para oferecer frete grátis.
Entendendo a soma de adicional fixo e percentual
Se você preencher os campos de adicional fixo e adicional percentual, o percentual será aplicado sobre a soma do valor retornado com o adicional fixo.
Exemplo:
- valor retornado pela J&T Express: R$ 10,00
- adicional fixo: R$ 10,00
- subtotal: R$ 20,00
- adicional percentual de 20%: R$ 4,00
- valor final: R$ 24,00
Preenchendo a aba expedição
Na aba Expedição, você encontra três campos.
Habilitar envio automático de pedidos
Ao ativar essa opção, a plataforma envia o pedido automaticamente para a transportadora assim que uma nota fiscal for vinculada ao pedido.
O comportamento varia conforme o tipo de integração:
- em transportadoras com integração direta, como Correios e J&T, o envio ocorre via API
- em transportadoras sem integração direta, a plataforma envia automaticamente um e-mail com o XML da NF-e
Nesse momento, a plataforma também pode gerar o link ou o código de rastreamento, quando a transportadora oferece esse recurso.
Contato para notificação
Esse campo é opcional.
Use essa opção para selecionar um contato já cadastrado que receberá, por e-mail, os XMLs das notas fiscais dos pedidos.
Esse recurso deve ser usado apenas quando a transportadora não possui integração logística via API. Quando a integração existe, a plataforma faz o envio automaticamente, sem necessidade de notificação manual.
Criar remessa automaticamente
Ao ativar essa opção, a plataforma adiciona automaticamente os pedidos a uma remessa de postagem da transportadora, desde que eles atendam aos critérios abaixo:
- pagamento confirmado
- sem nota fiscal vinculada
- criado há no máximo 7 dias
Depois de ativar esse campo, a plataforma exibe configurações adicionais da remessa, como nome da remessa, dias de criação e horário limite.
Preenchendo a aba Rastreamento
Na aba Rastreamento, informe o link de rastreio da J&T Express.
Use o seguinte padrão:
https://www.jtexpress.com.br/trajectoryQuery?waybillNo=[chaveNf]&type=0&cpf=[clienteCpfCnpj]
No campo Entregue se existirem as palavras, você pode informar palavras que indicam entrega concluída. Separe os termos com ponto e vírgula.
Preenchendo a aba Performance
Na aba Performance, configure regras para contingência em caso de falha ou lentidão da transportadora.
Tempo máximo de resposta
Informe o tempo limite, em segundos, para retorno do cálculo.
Exemplo: 20 segundos.
Tipo de frete de contingência
Selecione um frete alternativo para ser exibido caso a J&T Express não responda dentro do tempo definido.
Finalizando a configuração
Depois de preencher todos os campos:, clique em Criar.
Validando a integração
Após a configuração, faça um pedido de teste para verificar se o frete está calculando corretamente.
