Integração ERPFlex x Frete Rápido

A integração entre o ERPflex e a Frete Rápido permite gerenciar cotações, contratações de transportadoras, rastreamento de envios e emissão de etiquetas diretamente pelo ERP, seja no módulo de Orçamentos ou no de Faturamento/Vendas.

Para viabilizar as cotações, a empresa pode sincronizar os cadastros de produtos (SKUs) e suas especificações de volumetria em lote ou automaticamente a cada alteração. Além disso, o sistema recebe notificações e atualiza ocorrências de transporte em tempo real via Webhook.

Configuração Inicial da Integração

Acesse o menu Integrações, selecione a opção Configurador de Integrações.
Clique no card Frete Rápido.
Na aba Geral, informe:
- Token de Integração: Chave de acesso fornecida pelo portal do Frete Rápido.
- CPF / CNPJ: Documento da empresa cadastrado na plataforma do Frete Rápido.
Clique no botão Verificar Credenciais.
- Resultado esperado: O sistema apresentará uma mensagem confirmando que as credenciais são válidas e exibindo o saldo disponível da conta.
Marque/ajuste as opções de acordo com a regra de negócio da empresa:
- Incluir/Atualizar/Deletar SKU no Frete Rápido ao salvar SKU no ERPFlex: Mantém o cadastro de SKUs sincronizado em tempo real à medida que são cadastrados ou alterados no ERP.
- Valor do frete destacado no valor total (Não faturar e não incidir no produto): Garante que o valor do frete fique apenas para análise no pedido, sem ratear ao faturar.
- Habilitar contratação antecipada de oferta de frete no Orçamento: Permite que a contratação ocorra logo na aprovação do orçamento. Se estiver desmarcado, a contratação ocorrerá por padrão na emissão da NFe.
- Notificação de ocorrência por e-mail: Envia e-mails automáticos com atualizações de rastreamento (ex.: coletado, em trânsito, entregue).
- URL Webhook Ocorrências: Copie a URL gerada pelo ERPFlex e cadastre no painel do Frete Rápido para habilitar o envio automático de status de entrega.
Para evitar digitação manual dos códigos da plataforma parceira, clique na aba Ocorrências e pressione o botão Carregar Padrões. O ERPFlex carregará a lista de códigos de status de transporte e mapeará quais são Finalizadoras (ex.: Entregue, Devolvido).
Clique na aba Tipos de Volumes e pressione Carregar Padrões. Os tipos de volumes podem ser associados ao SKU e sugeridos no momento da cotação.
- Atenção: Como não existe uma API do Frete Rápido para atualização automática e contínua dos tipos de volume, estas tabelas funcionam por pré-carga. Caso seja necessário cadastrar um novo código de volume, utilize o botão Adicionar Tipo de Volume e insira o código/descrição manualmente.
Clique em Salvar.

Parametrização de Produtos (SKU)

Para calcular o frete corretamente, cada produto precisa de informações volumétricas exigidas pelas transportadoras.

Cadastrando Informações do Frete no SKU

Acesse Produtos e Serviços > SKU e abra o produto desejado.
Com a integração ativa, a seção/aba Frete Rápido – Mais informações estará disponível. Preencha:
- Tipo de Volume: Categoria do produto (ex.: 18 – Eletrônicos).
- Pode consolidar?: Sim/Não (Indica se o produto pode ser colocado na mesma caixa com outros itens).
- Pode sobrepor?: Sim/Não (Indica se outras caixas podem ser empilhadas sobre ele).
- Pode rotacionar?: Sim/Não (Indica se o pacote pode ser virado no transporte).
- Tamanho/Peso: Certifique-se de que Comprimento, Altura, Largura, Peso Líquido e Peso Bruto estejam preenchidos.
Clique em Salvar.

Sincronização em Lote de SKUs

Para puxar ou enviar múltiplos produtos de uma só vez, acesse a grid de SKUs, selecione os itens desejados e clique no botão Mais:

- Frete Rápido -> ERPFlex: Atualiza os SKUs no ERP com base no cadastro existente no Frete Rápido.
- ERPFlex -> Frete Rápido: Envia os cadastros e atualizações do ERP Flex para a plataforma do Frete Rápido.

Cotação e Contratação de Frete em Orçamentos

Acesse o menu Lançamentos, Vendas e selecione a opção Orçamentos.
Clique em Incluir Geral para criar novo orçamento ou abra um existente,
Selecione o cliente e insira os produtos desejados.
Quando a integração Frete Rápido está ativa, o botão exclusivo do Frete Rápido estará visível no painel. Clique nele para abrir a janela de cotação.

Aba 1 – Endereços:

Destino: Preenchido automaticamente com base nos dados do cliente ou endereço de entrega cadastrado. É possível alterar manualmente caso a entrega seja em outro local.
Origem: Define o local de saída dos produtos (endereço da matriz, filial ou CD/Centro de Distribuição).
Clique em Próximo.

Aba 2 – Volumes & Origens:

Exibe a lista de produtos, quantidades e o Tipo de Volume atribuído no SKU.
Se algum produto não possuir Tipo de Volume cadastrado, o sistema exigirá a seleção do volume nesta tela antes de prosseguir.
Clique em Cotar.

Aba 3 – Ofertas:

O ERPFlex consulta a API do Frete Rápido e exibe as transportadoras e as ofertas de frete disponíveis com seus respectivos valores e prazos estipulados (Preço, Prazo de Entrega e Modal).
Clique em Ver Detalhes para conferir a cubagem estimada e data limite de expiração da oferta (geralmente 30 dias).
Cada cotação possui uma data de expiração (ex: válida até determinado dia/horário). Caso o orçamento seja salvo e aprovado após a expiração, o sistema exigirá uma nova cotação.
Selecione a oferta desejada e clique em Confirmar e Avançar.

Aba 4 – Resultado / Resumo:

Apresenta a volumetria calculada (Peso cubado, quantidade de volumes e detalhamento da carga).
Clique em Concluir.
Se desejar trocar a transportadora sem gastar nova chamada de cotação na API, reabra o Frete Rápido e clique em Rever e alterar ofertas.

Frete Cotado

De volta à tela de edição do orçamento, o campo Valor do Frete e a Transportadora serão preenchidos automaticamente.
O status no ERPFlex exibirá “Cotada – Aguardando Salvar”.
- Regra de Invalidação de Cotação: Se após realizar a cotação você editar o pedido para alterar quantidades, incluir novos produtos ou alterar preços unitários, o ERPFlex desvalidará a cotação anterior e exibirá um alerta. Será necessário recalcular o frete para cobrir a nova volumetria/valor.
Ao salvar o orçamento e aprovar (Aprovação do Cliente), o frete muda seu status para Contratado.

Cancelamento da Cotação / Contratação

Caso o cliente desista ou seja necessário refazer o processo de frete:

Clique no botão do Frete Rápido no orçamento contratado.
Clique no botão Cancelar ou Remover Oferta.
O Frete Rápido solicitará a inserção do motivo do cancelamento (ex: “Desistência do cliente”, “Erro de digitação”).
Clique em Confirmar.
Importante – Regra do Botão Salvar: O cancelamento só é efetivado de fato junto ao servidor da Frete Rápido após clicar no botão Salvar do orçamento no ERPflex. Isso evita cancelamentos acidentais.

Emissão de Notas Fiscais e Acompanhamento

Na tela do Faturamento, ao faturar o orçamento, o botão do Frete Rápido permanece disponível na nota de venda.

Efetivação de Contratação

Quando o frete é vinculado diretamente à venda, a contratação oficial é disparada no momento da transmissão e autorização da Nota Fiscal Eletrônica (NFe).

Rastreamento

Após a contratação, é gerado um código de rastreio que pode ser consultado via modal de rastreamento no ERPflex ou diretamente pelo portal externo da Frete Rápido (ondestameupedido.com.br).

Módulo de Expedição, Geração e Impressão de Etiquetas

A gestão de expedição e impressão de etiquetas ocorre de forma individualizada ou em lote:

Acesse o menu Lançamento, Estoque, opção Expedição.
As vendas/notas fiscais transmitidas integradas ao Frete Rápido exibirão o ícone indicativo do serviço de transporte (ícone de caminhão/etiqueta).
- Os formatos das etiquetas são fornecidos dinamicamente pela própria API do Frete Rápido (ex: PDF A4, PDF Térmica Zebra, ZPL, DANFE Simplificado, etc.).
Selecione o formato compatível com sua impressora.

Impressão em Lote

Para otimizar a rotina operacional, a expedição permite selecionar múltiplos pedidos simultaneamente através da funcionalidade Etiquetas em Lote – Frete Rápido.

Atenção ao Cálculo de Volumes: As etiquetas são geradas estritamente por volume/caixa consolidado. Caso os produtos não estejam consolidados adequadamente nas caixas cadastradas, o sistema pode emitir um número excessivo ou incorreto de etiquetas (um volume avulso para cada item).

Certifique-se de que os produtos possuem dimensões corretas e estejam devidamente consolidados no cálculo da carga.

Visualizador de Ocorrências

A transportadora realizará a coleta e atualizará o status na plataforma do Frete Rápido. A Frete Rápido notifica o ERPFlex sobre cada mudança de status, via Webhook.

O ERPflex disponibiliza o Visualizador de Ocorrências do Frete Rápido, onde é possível consultar todas as atualizações de status de entrega (Webhooks/Rastreio) ocorridas dentro de um intervalo selecionável (ex: últimas 4 horas ou intervalo personalizado).

O ERPFlex registra o histórico e envia um e-mail de notificação com o código de rastreamento para o destinatário/empresa.

O ciclo se encerra quando uma ocorrência do tipo Finalizadora (ex.: Entregue) é registrada.