A integração conecta sua loja Yampi ao Veolog para oferecer fretes na finalização da compra, importar pedidos e enviar atualizações de rastreamento. Você prepara os envios e emite as etiquetas no Veolog.
Antes de começar
- Entre no Veolog como proprietário ou administrador. Outros perfis podem consultar a integração, mas não conectar, salvar configurações ou sincronizar.
- Tenha acesso à loja Yampi que deseja conectar e permissão para autorizar o aplicativo.
- Confira o endereço do remetente no Veolog e mantenha os produtos da Yampi com peso e medidas corretos. Confira também os serviços de transporte disponíveis na sua conta.
- Decida se quer trazer pedidos anteriores à conexão e se sua operação vai importar somente pedidos faturados.
1. Conecte a loja
- No Veolog, abra Integrações > Yampi.
- Clique em Conectar loja. Você será direcionado à página de autorização da Yampi.
- Entre na conta da loja correta e autorize as permissões solicitadas pelo Veolog.
- Aguarde o retorno ao Veolog e confira se a loja aparece conectada. Se houver uma mensagem de falha ou pendência, leia-a antes de continuar.
A conexão segue o fluxo de autorização da Yampi: o acesso é concedido na própria plataforma. Nesse caminho, você não precisa copiar chaves de acesso para o Veolog.
2. Escolha quais pedidos importar
Por padrão, o Veolog importa pedidos com pagamento confirmado que estejam em um destes status na Yampi:
- Pagamento aprovado;
- Faturado;
- Produtos em separação.
Se sua operação só prepara o envio depois do faturamento, ative Importar apenas pedidos faturados. Com essa opção, o pedido precisa estar no status Faturado, além de ter pagamento confirmado. Ter uma nota cadastrada, sem o status correspondente, não basta para passar por esse filtro.
Pedidos com pagamento pendente, cancelados, reembolsados, já enviados ou entregues não entram na importação. Um pedido elegível com endereço, peso ou medidas incompletos pode entrar com Edição necessária, para você corrigir antes da emissão.
3. Defina o histórico inicial
- Em Deseja importar pedidos antigos?, preencha Importar pedidos dos últimos com um número de 1 a 30 dias. Exemplo: 7 busca os pedidos dos últimos sete dias que atendam aos filtros.
- Revise o serviço e a embalagem padrão, descritos abaixo.
- Clique em Importar pedidos e aguarde o resultado. A busca pode continuar em segundo plano.
- Se quiser começar sem o histórico anterior à conexão, clique em Não importar. Os pedidos criados desde a conexão continuam sendo considerados pela sincronização.
O período escolhido define a data inicial da integração. Depois, Atualizar agora busca atualizações dentro desse limite; o botão não amplia a busca para pedidos mais antigos. Um pedido que já estiver importado não é criado novamente.
4. Configure serviço e embalagem padrão
Em Padrões para pedidos importados, você pode preencher:
- Serviço padrão: usado quando o pedido não informa uma modalidade. Se houver um serviço informado que o Veolog não reconheça, o pedido precisa de revisão. O padrão é opcional; confira a disponibilidade do serviço para cada destino.
- Embalagem padrão: substitui peso e dimensões quando os dados do pedido estão incompletos. Se o pedido já traz esses dados completos, o padrão não os troca.
Para criar uma embalagem, escolha Criar nova embalagem. Informe um nome, altura, largura e comprimento em cm e o peso em kg. Use as medidas externas e o peso do pacote pronto, com produtos e proteção. Por exemplo, 300 g correspondem a 0,300 kg. Clique em Salvar embalagem, selecione-a e clique em Salvar na integração.
Para ser usada como padrão nesta integração, a embalagem precisa ter peso e as três medidas preenchidos. Se não houver dados suficientes nem uma embalagem válida, o pedido fica para revisão. Alterar os padrões vale para as próximas importações; confira separadamente os registros já importados.
5. Confira o frete na loja
Ao conectar a Yampi, o Veolog tenta configurar automaticamente o frete e os avisos de novos pedidos. Depois da conexão, faça uma simulação na sua loja: coloque um produto no carrinho, informe um CEP de entrega e confira as modalidades, valores e prazos apresentados.
Se nenhuma opção aparecer, confira o peso e as medidas do produto, o endereço de origem, os serviços disponíveis no Veolog e as regras de frete aplicadas às integrações em Configurações > Regras de frete. Repita o teste com outro CEP para identificar se a dificuldade é de cobertura. Uma embalagem padrão de importação não substitui o cadastro dos produtos usado pela loja para cotar.
Se a conexão mostrar falha na configuração do frete, envie a mensagem ao suporte Veolog. A Yampi também explica o recurso no artigo Como configurar o frete por API.
6. Encontre o pedido e emita a etiqueta
- Localize o registro. Envios pelo contrato Veolog vão para o Carrinho. Com contrato próprio identificado, procure em Envios > Etiquetas. Pedidos sem serviço ou contrato definido ficam no Carrinho para revisão.
- Revise os dados. Confira destinatário, endereço, produtos, documento fiscal, peso, medidas, modalidade e local de postagem. Se aparecer Edição necessária, use Editar e corrigir e complete os campos indicados.
- Confira o frete. Se for preciso cotar novamente, revise preço e prazo antes de escolher a modalidade.
- Conclua a emissão. No contrato Veolog, finalize o pagamento no Carrinho. No contrato próprio, siga a emissão em Envios > Etiquetas.
- Imprima e poste. Aguarde o arquivo da etiqueta ficar disponível e prepare a encomenda conforme as instruções da modalidade escolhida.
Importar um pedido não significa que a etiqueta já foi emitida. Confira a etiqueta antes de entregar a encomenda à transportadora.
7. Mantenha pedidos e rastreamento sincronizados
Depois da configuração inicial, mantenha Sincronização automática como Ativa e clique em Salvar. Para solicitar uma busca de pedidos, use Atualizar agora e aguarde o resultado antes de repetir.
O rastreio é enviado para pedidos que vieram da Yampi, continuam ligados à conexão de origem e já possuem código de rastreamento. As atualizações habilitadas são Em trânsito e Entregue. A emissão da etiqueta, sozinha, não confirma movimentação da encomenda. Confira as demais ocorrências de transporte no Veolog.
Alterações posteriores no pedido da Yampi não substituem automaticamente os dados do envio já importado. Se você corrigir o endereço ou os produtos na loja, revise também o registro no Veolog antes de emitir a etiqueta. Cancelar o pedido na loja também não substitui o cancelamento de uma etiqueta já contratada.
Se algo não funcionar
O pedido não apareceu
Confira a loja conectada, a data de criação, o pagamento e o status do pedido. Revise a opção Importar apenas pedidos faturados. Procure no Carrinho e em Envios > Etiquetas, inclusive nos registros com Edição necessária. Depois, use Atualizar agora e leia o resultado da busca.
A autorização expirou ou não pôde ser renovada
Clique em Conectar novamente, entre na mesma loja e aceite as permissões. Aguarde o retorno ao Veolog e confira a conexão antes de atualizar os pedidos. Se os botões estiverem desabilitados, confirme que seu perfil é proprietário ou administrador e leia o aviso da página.
O pedido ficou com Edição necessária
Use Editar e corrigir no registro e complete os campos informados no aviso. Revise peso, medidas, endereço e serviço. Corrija também o cadastro na Yampi ou escolha um padrão válido para reduzir pendências nas próximas importações.
O rastreio não voltou para a Yampi
Confira se a sincronização automática está ativa, se a loja continua conectada e se o envio já possui código e está Em trânsito ou Entregue. Verifique se o pedido na Yampi recebeu outro rastreio ou foi cancelado. Se os códigos forem diferentes, peça ao suporte para conferir o vínculo antes de substituir qualquer informação.
Excluí um pedido e quero importá-lo novamente
Confira os dados e a situação do pedido na Yampi e clique em Atualizar agora. A busca manual também verifica pedidos excluídos que ainda atendem às regras; a sincronização automática não os recupera sozinha. Revise os resultados, pois outros pedidos excluídos elegíveis podem retornar. Se já havia etiqueta, pagamento ou postagem, confira essa operação antes de gerar outro envio.
A busca está em andamento ou informou erro
Aguarde a busca atual terminar. Se a falha continuar, envie ao suporte Veolog o nome da loja, o número do pedido, a data e o horário da tentativa e a mensagem exibida. Não compartilhe senhas nem credenciais de acesso.