Entregas

Balcões de Retirada

Balcões de Retirada Cadastre e gerencie os pontos onde clientes retiram pedidos, garantindo prazos, custos e comunicação consistentes. Por que usar este módulo? Quando sua operação oferece retirada em loja, é importante manter um catálogo claro de pontos com endereço, horário e regras de frete. Isso evita confusão no checkout e permite informar corretamente o cliente sobre onde e quando retirar o pedido. Nota: O módulo lista todos os balcões e oferece filtros por cidade/UF. Cada pedido mantém a referência ao balcão escolhido. 1 - Atenção e Regras - Exclusão Protegida: Não exclua um balcão sem verificar pedidos vinculados. Pedidos ativos impedirão a remoção até que sejam reatribuídos ou finalizados. - Precificação: Confirme se o valor do frete e as condições de pedido mínimo refletem a política comercial, pois impactam diretamente o cálculo no checkout. - Pagamento na Retirada: Se ativado, verifique se sua equipe tem processos claros para confirmar o recebimento antes de entregar o produto. 2 - Passo a Passo Rápido 1. Criar: Na listagem de balcões, clique em Novo Balcão. 2. Identificação e Local: Informe o Nome (ex: Loja Centro) e use o CEP para preencher o endereço automaticamente. 3. Regras: Configure o preço do frete (ou deixe grátis) e o prazo de disponibilidade em dias úteis. 4. Contato: Preencha telefone e e-mail do local para que o cliente saiba como entrar em contato se necessário. 5. Configurações: Marque se aceita "Pagamento na Retirada" e se o balcão está "Ativo". Clique em Salvar. 3 - Seções do Formulário - Identificação Nome do balcão. Use um padrão que facilite a identificação pelo cliente (ex: Cidade + Bairro). - Endereço e CEP Localização física. O CEP preenche automaticamente logradouro, bairro, cidade e UF. - Precificação Frete fixo e condições de valor mínimo (ex: Frete grátis acima de R$ 100,00). - Configurações Controles para ativar/desativar o balcão e permitir pagamento no local (parcial ou total). Dica: Para mudanças que afetam muitos pedidos (como desativar um ponto), avise a equipe de atendimento e revise o fluxo de checkout para evitar impacto aos clientes.

Frete Personalizado

Frete Personalizado Crie regras de entrega específicas para locais, faixas de CEP ou produtos quando as opções padrão não atendem sua estratégia. Para que serve este módulo? O frete personalizado permite criar tabelas manuais para cobrir áreas especiais (ex: Entrega Local via Motoboy), definir prazos diferenciados ou aplicar taxas extras para produtos específicos. É a ferramenta ideal para flexibilizar sua logística além dos Correios/Transportadoras. Nota: Novas regras influenciam apenas pedidos futuros e o cálculo no checkout. Pedidos já realizados mantêm o frete original. 1 - Atenção e Regras - Sobreposição: Defina claramente o alcance (Localidade vs CEP). Regras conflitantes podem gerar opções duplicadas no checkout para o cliente. - Pedido Mínimo: Configure este campo apenas se for uma exigência comercial. Deixar em branco ou zerado aplica a regra a qualquer valor de pedido. - Restrição de Produto: Use com cuidado. Se você limitar uma regra a "Produto X", essa opção de frete não aparecerá se o cliente tiver "Produto Y" no carrinho junto. 2 - Passo a Passo Rápido 1. Criar Regra: Na tela de Frete Personalizado, clique em Novo Frete. 2. Dados Básicos: Informe o Nome (ex: "Entrega Expressa") e, se necessário, uma Observação para o cliente. 3. Custo e Prazo: Defina a Taxa de entrega, o Prazo em dias e, se houver, valor por Kg adicional ou Pedido Mínimo. 4. Abrangência: Escolha se a regra vale por Localidade (Cidade/Bairro) ou Faixa de CEP. Adicione as linhas correspondentes. 5. Ativar: Marque a regra como "Ativa" e clique em Salvar. 3 - Seções do Formulário - Informações Básicas Nome da regra e observação. O nome aparece no checkout para o cliente selecionar. - Regras de Entrega O coração do cálculo: Prazo, Taxa Fixa, Taxa por Kg excedente e Valor Mínimo para ativar a opção. - Área de Abrangência Define onde a regra funciona. Pode ser por lista de Cidades/Bairros ou intervalos de CEP (Início/Fim). - Restrições e Produtos Filtros avançados: limitar por peso/dimensões máximas ou restringir a regra apenas para certos SKU. Dica: Sempre teste novas regras no checkout com um endereço de exemplo antes de divulgar para garantir que o cálculo está correto.

Melhor Envio

Melhor Envio Conecte sua loja ao Melhor Envio para oferecer cotações de frete de diferentes transportadoras, emitir etiquetas de postagem e gerenciar seus envios diretamente pela Nortgraf. Para que serve a integração? A integração permite consultar preços e prazos de entrega das transportadoras disponíveis no Melhor Envio, oferecendo opções de frete aos clientes durante a finalização dos pedidos. Além disso, você pode emitir etiquetas de postagem e acompanhar operações de envio pelo painel administrativo da sua loja. 1 - Atenção e Regras Antes de iniciar a configuração, observe algumas informações importantes: - Conta no Melhor Envio: É necessário possuir uma conta cadastrada na plataforma para utilizar a integração. - Credenciais: O Client ID e o Client Secret são necessários para identificar e autenticar o aplicativo integrado. - Saldo na carteira: Para pagar e emitir etiquetas, é necessário possuir saldo suficiente ou utilizar uma forma de pagamento aceita pelo Melhor Envio. - Ambientes: O Sandbox é destinado exclusivamente a testes. Para realizar envios reais, utilize o ambiente de Produção. - Conexão: Ao desconectar sua conta ou revogar a autorização, as funcionalidades que dependem da integração poderão deixar de funcionar. - Produtos: Os produtos devem possuir peso e dimensões corretamente cadastrados para permitir o cálculo de frete. 2 - Criando sua conta no Melhor Envio Caso ainda não tenha uma conta, realize o cadastro antes de configurar a integração. 1. Acesse www.melhorenvio.com.br. 2. Clique em Cadastrar. 3. Informe seus dados pessoais e de contato. 4. Preencha as informações solicitadas pela plataforma. 5. Confirme seu e-mail e conclua as verificações necessárias. 6. Após a ativação da conta, acesse o painel do Melhor Envio. Se você já possui uma conta ativa, pode avançar para a próxima etapa. 3 - Cadastrando um aplicativo no Melhor Envio Para obter as credenciais necessárias à integração, você deverá cadastrar um aplicativo na Área de Desenvolvedores do Melhor Envio. Passo 1 - Acessar a Área Dev. 1. Entre na sua conta do Melhor Envio. 2. No menu lateral, localize Integrações. 3. Clique em Área Dev.. 4. Na página exibida, clique em Cadastrar Aplicativo. ### Passo 2 - Preencher os dados do aplicativo Na janela Cadastrar novo aplicativo, preencha os campos solicitados. Campo O que informar Nome da plataforma Nortgraf ou o nome escolhido para identificar a integração Site da plataforma Endereço público da sua loja E-mail de contato Seu e-mail comercial E-mail do suporte técnico E-mail utilizado para suporte à integração URL do ambiente para testes Endereço de testes, quando disponível URL de redirecionamento após autorização URL de callback informada no painel da Nortgraf Descrição do aplicativo Identificação e finalidade da integração Importante: A URL de redirecionamento deve ser copiada exatamente como aparece nas configurações do Melhor Envio na Nortgraf. Não substitua esse endereço pelo domínio da sua loja. Uma URL incorreta pode impedir a autorização da integração. No campo Descrição do aplicativo, você pode informar: "Integração da loja com o Melhor Envio através da plataforma Nortgraf para cotação de fretes, emissão de etiquetas e gerenciamento de envios." A opção Permitir que o usuário, ao instalar o aplicativo, altere as configurações de transportadora e serviços pode ser habilitada quando você desejar permitir essas personalizações. Após preencher os campos, clique em Salvar Alterações ou na opção equivalente apresentada pelo Melhor Envio. ### Passo 3 - Obter o Client ID e Client Secret Após salvar o aplicativo: 1. Acesse novamente Integrações > Área Dev.. 2. Localize o aplicativo criado em Seus aplicativos. 3. Consulte as credenciais geradas pelo Melhor Envio. 4. Copie o Client ID e o Client Secret. 5. Guarde essas informações para configurar a integração na Nortgraf. Client ID: Identifica o aplicativo cadastrado. Client Secret: É a chave secreta utilizada na autenticação do aplicativo. Atenção: Não compartilhe seu Client Secret publicamente. Utilize essa credencial somente nos campos destinados à configuração da integração. 4 - Configurando o Webhook O webhook permite que o Melhor Envio envie notificações ao sistema quando ocorrerem atualizações relacionadas às etiquetas de postagem. Passo 1 - Criar um webhook 1. No painel do Melhor Envio, acesse Integrações > Área Dev.. 2. Localize o aplicativo cadastrado. 3. Na coluna Webhooks, clique em Novo Webhook. ### Passo 2 - Informar a URL Na janela Novo webhook, preencha: - Nome da aplicação: Será preenchido com o aplicativo selecionado. - URL: Informe o endereço de webhook disponibilizado nas configurações da integração na Nortgraf. - Eventos disponíveis: Selecione o evento de atualização de etiquetas, quando disponível. A URL do webhook é diferente da URL de redirecionamento utilizada na autorização do aplicativo. Importante: Copie o endereço fornecido pela Nortgraf. Não utilize o endereço de exemplo apresentado na documentação do Melhor Envio. Clique em Salvar para concluir. Após o cadastro, o webhook ficará vinculado ao seu aplicativo e poderá ser utilizado para receber os eventos disponibilizados pelo Melhor Envio. 5 - Conectando o Melhor Envio à Nortgraf Depois de cadastrar o aplicativo e obter suas credenciais, retorne ao painel administrativo da sua loja na Nortgraf. Passo 1 - Informar as credenciais 1. Acesse a configuração da integração Melhor Envio. 2. Informe o Client ID fornecido pelo Melhor Envio. 3. Informe o Client Secret correspondente. 4. Salve as configurações. As credenciais devem pertencer ao mesmo ambiente selecionado. Passo 2 - Autorizar a conexão 1. Clique em Conectar com Melhor Envio. 2. Você será direcionado à página de autorização do Melhor Envio. 3. Faça login, caso seja solicitado. 4. Confira as permissões solicitadas pelo aplicativo. 5. Autorize o acesso. 6. Aguarde o retorno ao painel administrativo da Nortgraf. Após a autorização bem-sucedida, a integração deverá apresentar o status de conectada. 6 - Configurando o Remetente e as Transportadoras Com a conexão estabelecida, configure as informações utilizadas nos cálculos de frete. Dados do Remetente Informe os dados de origem dos seus envios, incluindo: - CEP de origem; - Endereço e número; - Cidade e estado; - Demais informações solicitadas no cadastro. O CEP de origem é utilizado em conjunto com o destino do cliente para calcular as opções de entrega. Serviços Ativos Selecione os serviços das transportadoras que deseja disponibilizar na sua loja. A disponibilidade dos serviços depende das condições comerciais, da cobertura e das características de cada envio. Após selecionar os serviços desejados, salve as configurações. Taxa de Manuseio Caso utilize uma taxa adicional de manuseio, configure o valor conforme as opções disponíveis no painel. Essa taxa pode ser utilizada para incluir custos operacionais relacionados ao preparo e à expedição dos pedidos. 7 - Testando a Integração Antes de disponibilizar o cálculo de frete aos clientes, recomendamos realizar um teste. 1. Verifique se a integração apresenta o status Conectado. 2. Confirme que o CEP de origem está correto. 3. Verifique se os produtos possuem peso e dimensões cadastrados. 4. Confirme que existem serviços de transporte habilitados. 5. Adicione um produto ao carrinho da sua loja. 6. Informe um CEP de destino válido. 7. Consulte as opções de frete disponíveis. Se tudo estiver configurado corretamente e houver serviços elegíveis para o envio, as opções de entrega deverão ser apresentadas ao cliente. 8 - Seções de Referência Status e Credenciais Permite consultar o estado da conexão, selecionar o ambiente e configurar as credenciais Client ID e Client Secret. Dados do Remetente Reúne os dados de origem utilizados para calcular o frete e identificar o remetente nas operações de postagem. Serviços Ativos Permite habilitar os serviços de entrega que serão disponibilizados aos clientes durante a compra. Saldo e Taxas Permite consultar informações financeiras disponibilizadas pela integração e configurar custos adicionais de manuseio, quando aplicável. Webhooks Permitem receber notificações do Melhor Envio relacionadas aos eventos de etiquetas disponibilizados pela API. 9 - Problemas Comuns Não consigo conectar minha conta. Verifique se o Client ID e o Client Secret estão corretos, se pertencem ao ambiente selecionado e se a URL de redirecionamento cadastrada no aplicativo corresponde exatamente à URL informada pela Nortgraf. Nenhuma transportadora aparece no checkout. Confira o CEP de origem, o CEP de destino, os serviços habilitados e o peso e as dimensões dos produtos. Também verifique se existe algum serviço disponível para o trajeto informado. Não consigo emitir etiquetas. Verifique se a autorização continua válida, se há saldo ou uma forma de pagamento disponível no Melhor Envio e se os dados necessários para a postagem estão completos. O webhook não está funcionando. Confira se o webhook foi criado no aplicativo correto, se a URL informada corresponde à disponibilizada pela Nortgraf e se os eventos necessários estão habilitados. A integração funciona no Sandbox, mas não em Produção. O Sandbox e a Produção são ambientes independentes. Cadastre o aplicativo e obtenha as credenciais correspondentes ao ambiente de Produção. Dica: Antes de começar a operar com pedidos reais, faça uma cotação de teste e confira os serviços disponíveis, os prazos e os valores apresentados. Isso ajuda a identificar possíveis erros na configuração do remetente, dos produtos e das transportadoras.

Frenet

Frenet Conecte sua loja à Frenet para obter cotações de frete e suportar a emissão de etiquetas com base em serviços habilitados na sua conta. Para que serve a integração? Se sua operação depende de cotação automática e geração de etiquetas de envio para múltiplos transportadores, integrar com a Frenet agiliza o processo e reduz erros de cálculo manual. A integração garante que o checkout e a gestão de pedidos tenham acesso a opções reais de transporte. 1 - Atenção e Regras - Token Obrigatório: É necessário ter um token válido da Frenet. Sem ele, o módulo não conecta e as cotações não funcionarão. - Serviços Habilitados: Verifique na sua conta Frenet se os serviços de entrega desejados estão ativos. Serviços desabilitados lá não aparecerão na loja. - Dados do Remetente: Confirme o CEP de origem. Valores e prazos dependem desses dados, e inconsistências podem gerar cotações incorretas. 2 - Passo a Passo de Configuração 1. Obter Token: Acesse seu painel na Frenet, copie o token de acesso e cole no campo Token de Acesso no módulo da loja. 2. Remetente: Informe o CEP de origem, endereço, cidade, UF e documento. O sistema usa o CEP para autocompletar o endereço quando disponível. 3. Taxas Extras: Se desejar, configure uma Taxa de Manuseio (valor fixo ou percentual) para cobrir custos de embalagem. 4. Salvar e Ativar: Salve o formulário. Se o token for válido, o status mudará para "Integrado" e o botão de desconectar aparecerá. 5. Testar: Execute uma cotação de teste no checkout ou simule um pedido para confirmar que os serviços e preços estão aparecendo corretamente. 3 - Seções de Referência - Token de Acesso Campo principal para conectar sua conta Frenet. É a chave que autoriza a comunicação entre os sistemas. - Dados do Remetente CEP de origem e endereço. Essenciais para o cálculo preciso do frete e para a emissão da etiqueta de postagem. - Taxa de Manuseio Permite adicionar um valor extra (fixo ou %) ao custo do frete, útil para cobrir despesas operacionais ou de embalagem. - Status da Integração Informa se a conexão está ativa e válida, além de exibir mensagens sobre saldo ou problemas de credenciais. Dica: Antes de operar em produção, valide o token e faça testes com pedidos reais (se possível em modo de homologação) para evitar surpresas.

Solicitações de Entrega — Expedição, instalação e comprovantes

Solicitações de Entrega — Expedição, instalação e comprovantes Controle expedição, retirada, entrega e instalação com responsáveis, comprovantes e acompanhamento individual dos itens. Para que serve este módulo? Solicitações de Entrega é a área operacional para acompanhar pedidos que chegaram à expedição, retirada, entrega ou instalação. Ela complementa a tela de Pedidos e permite controlar responsável, saída, recebimento, rastreio, comprovantes e observações. 1 - Como um pedido entra na fila A entrada é determinada pelos status configurados para o fluxo de entrega. Quando o pedido ou um de seus itens atinge um status marcado como entrada da fila, a solicitação é criada e passa a aparecer na tela. Isso pode acontecer por alteração manual no pedido ou pelo avanço de uma ordem no Kanban de Produção. 2 - Onde acessar No painel administrativo, abra Entregas > Solicitações de Entrega. A opção depende do plano e das permissões do usuário. 3 - Configuração dos status Antes de utilizar a fila, configure os papéis dos status usados pela operação: - Entrada da fila: inclui o pedido na operação de entrega. - Saída para rota: indica que o item saiu para entrega ou expedição. - Concluído: indica entrega ou retirada finalizada. - Problema: registra situações como recusa, extravio ou endereço incorreto. Os nomes dos status podem variar em cada loja. O importante é configurar corretamente o papel de cada um. 4 - Trabalhando com a solicitação 1. Abra a solicitação na fila. 2. Confira pedido, cliente, endereço, tipo de entrega e itens. 3. Defina o responsável pela operação. 4. Confirme transportadora e dados de rastreio, quando aplicável. 5. Atualize os itens conforme avançarem para saída, conclusão ou problema. 6. Registre observações e documentos da entrega. 5 - Controle por item Um pedido pode conter itens em momentos diferentes. Por isso, o andamento pode ser registrado por item. Não marque o pedido inteiro como concluído se ainda houver algum item pendente. Quando todos os itens elegíveis forem concluídos, o sistema poderá atualizar o pedido para o status final configurado. 6 - Entrega, retirada e instalação Use as informações operacionais adequadas ao serviço realizado. Em entregas, registre saída, transportadora e recebimento. Em retiradas, confirme quem recebeu. Em instalações, preencha os dados e o relatório solicitados pela operação. 7 - Comprovante e recebedor Ao concluir, registre nome e documento do recebedor quando necessário. Anexe o comprovante correto e evite arquivos que contenham dados pessoais além do necessário para comprovar a entrega. 8 - Impressões Conforme o tipo de operação, a tela pode disponibilizar checklist, protocolo de entrega e relatório de instalação. Confira os dados antes de imprimir e entregar o documento à equipe externa. 9 - Integração com Pedidos e Produção Pedidos continua sendo a origem das informações comerciais e dos itens. Produção pode alimentar a fila ao avançar para um status configurado. Evite corrigir divergências criando registros duplicados; ajuste o pedido, o item ou o mapeamento de status. 10 - Boas práticas - Confira endereço e contato antes da saída. - Atualize o status no momento em que a operação ocorrer. - Registre problemas com uma observação objetiva. - Anexe comprovantes legíveis. - Use filtros para separar pendências, saídas e conclusões. 11 - Problemas comuns O pedido não entrou na fila Confira se o status atingido possui o papel de entrada da fila e se o pedido ou item realmente foi atualizado para esse status. A solicitação não conclui Verifique se todos os itens aplicáveis estão em um status com papel de concluído. Os dados de entrega estão incorretos Corrija os dados no pedido e atualize a solicitação. Se o erro estiver no fluxo, revise a configuração dos papéis de status. Atenção: A fila depende dos papéis configurados para os status. Se um pedido não aparecer ou não concluir, revise primeiro o status do pedido e de seus itens.

Transportadoras — Cadastro e gerenciamento

Transportadoras — Cadastro e gerenciamento Ative integrações de frete, informe credenciais e configure remetente, serviços e taxas. ● Para que serve este módulo? A área de Transportadoras reúne os módulos de frete disponíveis, como Correios, Braspress, Frenet e Melhor Envio. Cada integração possui credenciais e opções próprias. 1 - Escolhendo a integração Abra Entregas > Transportadoras e escolha o módulo. Considere cobertura, contrato, serviços, geração de etiquetas e forma de cobrança. ## 2 - Credenciais e ambiente Informe as credenciais exigidas, como token, Client ID e Client Secret. Quando houver ambiente Sandbox e Produção, faça testes no Sandbox e use Produção apenas com a conta real. Nunca compartilhe tokens em mensagens ou capturas públicas. ## 3 - Dados do remetente Cadastre nome ou razão social, CPF/CNPJ, CEP, endereço, número, bairro, cidade e UF da origem. Esses dados influenciam cotações e documentos de transporte. ## 4 - Serviços e taxas Ative somente os serviços que deseja oferecer. Quando disponível, configure ajuste percentual e valor fixo de manuseio. Teste o efeito no preço final antes de publicar. ## 5 - Salvar, ativar e desativar 1. Revise credenciais e origem. 2. Selecione os serviços. 3. Salve e ative. 4. Faça cotações com CEPs diferentes. 5. Para interromper ofertas, use desativar. 6 - Problemas comuns Não retorna frete Confira token, ambiente, CEPs, peso, dimensões e serviços ativos. Preço incorreto Revise taxas e dados do pacote. Integração desconectada Refaça a autorização ou atualize a credencial. 7Boas práticas - Teste capital e interior. - Mantenha endereço de origem atualizado. - Revise contratos e limites. - Não ative serviços indisponíveis. - Monitore cotações após mudanças. Atenção: Credenciais e cotações vêm de serviços externos. Valide preço, prazo e cobertura antes de disponibilizar a transportadora aos clientes.