A integração Cartpanda traz os pedidos pagos para o Veolog e devolve o rastreamento à loja. Você também pode oferecer preços e prazos Veolog na finalização da compra.
A conexão já permite preparar a importação dos pedidos. Para mostrar o frete ao comprador, existe uma etapa adicional: o Veolog prepara o cadastro e você solicita a liberação à Cartpanda. Abaixo estão os dois caminhos.
1. Separe os dados antes de conectar
- Acesso de administrador no Veolog e acesso ao painel da loja Cartpanda.
- Slug e token de API da mesma loja. O slug é o identificador que aparece antes de .mycartpanda.com. Por exemplo, em minhaloja.mycartpanda.com, o slug é minhaloja.
- Remetente e transportadoras configurados no Veolog. Confira endereço de origem, serviços e contratos que você pretende usar.
- Produtos físicos com peso e dimensões corretos. Revise também as variantes, como tamanhos ou modelos com medidas diferentes.
A integração atende pedidos em reais, com entrega no Brasil. A conta Veolog conecta uma loja Cartpanda por vez.
2. Conecte a Cartpanda ao Veolog
- Entre na loja correta no painel Cartpanda. Abra o perfil no canto superior direito e copie o slug e o token de API.
- No Veolog, acesse Configurações > Integrações > Cartpanda.
- Preencha Slug da loja apenas com o identificador, como minhaloja, e cole a credencial em Token de API.
- Clique em Conectar loja. Confira se a tela mostra Conectada e o endereço da loja esperada.
O token funciona como uma chave de acesso à loja. Cole-o somente no campo indicado. O Veolog valida o acesso e tenta cadastrar automaticamente as notificações de novos pedidos, pagamentos e alterações.
Se o slug ou o token não estiverem disponíveis para seu usuário, peça ao responsável pela loja para obter os dados no perfil. A Central de Ajuda da Cartpanda também reúne as orientações do painel.
3. Escolha o histórico e os padrões dos pedidos
Na primeira configuração, escolha se deseja trazer pedidos antigos. Informe de 1 a 30 dias e clique em Importar pedidos. Se não quiser o histórico anterior à conexão, escolha Não importar.
Depois, mantenha Sincronização automática em Ativa para receber pedidos e devolver rastreios. A tela salva essa alteração automaticamente; se o botão Salvar sincronização estiver visível, use-o. Para buscar pedidos manualmente, clique em Atualizar agora.
Abra Configurações adicionais > Padrões para pedidos importados se quiser definir:
- Serviço padrão: usado quando a Cartpanda não informa uma modalidade. O serviço precisa atender à encomenda. Se o pedido informar uma modalidade que não puder ser identificada, revise a escolha no Veolog.
- Embalagem padrão: usada quando o pedido vem com peso ou dimensões incompletos. Ela deve representar a embalagem que você usa de verdade.
Clique em Salvar. Esses padrões ajudam a preparar os pedidos que entram no Veolog. A embalagem usada no frete do checkout é configurada separadamente, na próxima etapa.
4. Ative o frete na finalização da compra
- Na integração Cartpanda, encontre Frete no checkout e clique em Ativar frete no checkout.
- Enquanto aparecer Preparando o frete…, o Veolog busca o catálogo e prepara o cadastro do serviço. Você pode sair da página; o trabalho continua automaticamente.
- Se aparecer Produtos precisam de atenção, confira os itens indicados. Na Cartpanda, abra Produtos > Listar produtos, edite o produto e revise comprimento, largura, altura e suas variantes. Salve as correções.
- Se a tela oferecer Embalagem para produtos sem medidas, você pode escolher uma embalagem compatível para complementar dimensões ausentes. Use Continuar preparação ou Salvar embalagem, conforme o botão mostrado.
- Ao chegar a Aguardando liberação da Cartpanda, clique em Copiar solicitação de ativação. Envie o texto ao atendimento da Cartpanda ou ao endereço indicado na própria tela. O botão copia a mensagem; o envio é feito por você.
- Após a Cartpanda confirmar a liberação, abra sua loja como comprador e teste o frete com produtos físicos e CEPs atendidos.
- Se os preços e prazos aparecerem, volte ao Veolog, marque Já testei e o frete Veolog apareceu no checkout da minha loja e clique em Confirmar teste.
Frete ativo registra que você confirmou o teste. Estar com a loja conectada ou com o serviço cadastrado não confirma, sozinho, que a Cartpanda já liberou a exibição.
O caminho para o cadastro de produtos também está no guia de produtos físicos da Cartpanda. Se as opções do seu painel forem diferentes, peça ao suporte da plataforma orientação para editar as medidas das variantes.
5. Entenda peso, medidas e embalagem
O frete precisa do peso e das três dimensões de cada item físico, além da quantidade comprada. Por exemplo, se você vende duas unidades do mesmo produto, cadastre as medidas de uma unidade e mantenha a quantidade correta no pedido.
O Veolog consulta as dimensões do catálogo sincronizado da Cartpanda. Alterações nos produtos são buscadas automaticamente; elas podem levar algum tempo para chegar. Depois de corrigir uma variante, aguarde a atualização e teste novamente.
- Embalagem para produtos sem medidas: complementa dimensões ausentes no cálculo do checkout. Não fornece o peso do produto e não corrige valores inválidos cadastrados na Cartpanda.
- Embalagem padrão de pedidos: fica em Configurações adicionais e ajuda quando a importação traz peso ou medidas incompletos. Ela não ativa o checkout.
- Produtos digitais sem entrega: não entram no pacote físico.
- Item físico incompleto: pode impedir o frete do carrinho inteiro. O cálculo não ignora o item para apresentar um preço menor.
Antes da etiqueta, confira a encomenda pronta, incluindo caixa e proteção. Se precisar, veja como medir, pesar e salvar uma embalagem.
6. Confira quais pedidos serão importados
Entram pedidos com pagamento confirmado, em BRL, para entrega no Brasil e com itens físicos ainda a enviar. Pedidos pendentes de pagamento, cancelados, reembolsados, com contestação de pagamento ou já totalmente enviados não geram uma nova expedição.
Em pedidos com envio parcial, o Veolog considera as quantidades ainda disponíveis para envio informadas pela Cartpanda. Revise essas quantidades antes de separar os produtos. Repetir a importação reconhece os pedidos já importados e evita uma nova cópia.
A importação e o frete no checkout são independentes: você pode importar pedidos antes de concluir a liberação do frete na Cartpanda.
7. Passe do pedido para a etiqueta
- Procure o pedido no Carrinho ou em Envios. Pedidos com contrato Veolog vão para o Carrinho; com contrato próprio identificado, podem aparecer em Envios, inclusive com pendências.
- Se aparecer Edição necessária, use Editar e corrigir no registro. No Carrinho, essa ação aparece no ícone de lápis. Confira endereço completo, número, bairro, CEP, CPF/CNPJ, itens, quantidades, peso, medidas e serviço.
- Confira o remetente e preencha o documento exigido para o envio. A integração não emite a nota fiscal por você.
- Com contrato Veolog, selecione o pedido e use Finalizar pagamento. Com contrato próprio, siga a solicitação de geração em Envios > Etiquetas.
- Quando a etiqueta estiver pronta, clique em Imprimir, fixe-a na embalagem e faça a postagem conforme o serviço escolhido.
Consulte também como corrigir pendências e como gerar e imprimir etiquetas.
8. Acompanhe o rastreamento
Com a sincronização automática ativa, a integração registra o envio e seu rastreamento na Cartpanda quando a encomenda passa para em trânsito ou entregue. Ela envia código, link e transportadora junto dos itens e quantidades vinculados ao envio.
Gerar uma etiqueta não dispara esse retorno imediatamente. Confira a movimentação em Envios no Veolog e depois no pedido da Cartpanda. As ocorrências detalhadas da transportadora continuam disponíveis no Veolog.
Se algo não funcionar
Não consigo conectar
Confira se o slug pertence à mesma loja do token, se copiou o token inteiro e se ele continua válido. Use apenas o slug no campo da loja, sem o domínio completo. Se o painel permitir apenas consulta, peça a um administrador Veolog para fazer a conexão.
O pedido pago não apareceu
Confira o período inicial, o pagamento, a moeda e se ainda há itens a enviar. Procure em Envios e no Carrinho e use Atualizar agora. Se funcionar manualmente, mas os próximos pedidos não chegarem, confira a Sincronização automática e informe o problema ao suporte Veolog.
O frete continua em preparação
Catálogos maiores podem precisar de mais tempo. Se aparecer Produtos precisam de atenção, corrija os produtos listados. Em Preparação interrompida, confira a mensagem e use Tentar novamente depois de resolver a causa. Se aparecer Configuração do Veolog pendente, contate o suporte Veolog; a importação de pedidos pode continuar normalmente.
A loja está conectada, mas o comprador não vê frete
Confira se a Cartpanda liberou o serviço. Se a liberação já foi confirmada, teste um produto físico com peso e medidas válidos, em reais, para um CEP brasileiro atendido. Confira também as transportadoras e regras no Veolog. Teste uma variante e depois duas unidades para verificar se os dados estão completos.
Preciso trocar o token ou parar de usar a integração
Para trocar o token, use Desvincular e depois Conectar loja com o mesmo slug e o novo token. A sincronização e as cotações ficam interrompidas durante esse intervalo. Ao reconectar a última loja na mesma conta Veolog, os vínculos dos pedidos e configurações são recuperados; confira a preparação do frete e confirme o teste do checkout novamente.
Se quiser parar somente as tarifas, use Desativar frete, mantendo a importação e o rastreamento. Ao encerrar o uso, confira também o serviço no painel Cartpanda: o cadastro pode continuar aparecendo lá mesmo após desvincular no Veolog.
Para o suporte, separe o slug da loja, o número do pedido, o horário e a mensagem exibida. Não é necessário enviar o token para explicar o problema.