Liberação: 30/09/2026
#Integração

Objetivo da mudança:

Implementação da integração nativa com a plataforma EconoCARGO para cotação e escolha automatizada de fretes no faturamento e na expedição de vendas. A solução permite calcular prazos e valores de frete diretamente no fechamento do pedido de venda, realizar a cotação obrigatória de pedidos em separação e disparar automaticamente o XML da NF-e emitida para a EconoCARGO para agendamento de coleta.

Rotinas / Telas:

• Útil > Configuração do Sistema , tela : Configurações do Sistema (frmCfgSistema)
• Principal > Cadastros > Auxiliares > Transportadoras , tela : Cadastro de Transportadoras (frmCadTransportadoras)
• Principal > Faturamento > Emissão de Faturamento > Expedição – Impressão e Baixa da Separação , tela : Expedição – Impressão e Baixa da Separação (frmFatExpedicao)
• Principal > Faturamento > Emissão de Faturamento > Expedição , tela : Expedição (frmFatExpedicao)

Instruções sobre o que configurar:

• Acesse Útil > Configuração do Sistema e preencha as opções do novo grupo Integração de Sistemas – EconoCARGO:

  • CFG_ECGHAB: “ECONOCARGO – Utilizar integração?” = SIM (Padrão: NÃO);

  • CFG_ECGURL: “ECONOCARGO – URL:” = Informe a URL da API da EconoCARGO;

  • CFG_ECGTOK: “ECONOCARGO – Token:” = Informe o token de autenticação (Bearer);

  • CFG_ECGSEG: “ECONOCARGO – Código de Seguimento:” = Código do segmento atribuído à empresa;

  • CFG_ECGEML: “ECONOCARGO – E-mail para envio do XML:” = E-mail de destino do XML de coleta (ex: recxml@econocargo.net);

  • CFG_ECGCOT: “ECONOCARGO – Cotar frete antes da separação na Expedição?” = SIM ou NÃO (Padrão: NÃO);

• Acesse Útil > Configurações de E-mail (CFG_EMASAI) e, no grupo Faturamento NF-e, configure o modelo do e-mail “Envio de XML a EconoCARGO”;

• Acesse Principal > Manutenção de Cadastros > Auxiliares > Transportadoras, aba 2-Complementos, e configure o painel EconoCARGO:

  • Transp. EconoCARGO?: Defina SIM para as transportadoras homologadas que retornam nas cotações da EconoCARGO;

  • Realizar cotação?: Defina SIM apenas para transportadoras genéricas/temporárias que exigem obrigatoriamente a cotação de frete antes da expedição do pedido.

Instruções sobre como utilizar:

• Cotação no Fechamento do Pedido (Orçamento/Pedido):

  • Na tela de fechamento de venda, clique em Calcular Frete;

  • A tela de simulação exibe as opções de transporte retornadas pela API da EconoCARGO com prazos e valores;

  • Ao selecionar uma transportadora, o sistema localiza a empresa pelo CNPJ e vincula a transportadora cadastrada ao pedido.

• Cotação Obrigatória na Expedição / Separação:

  • Caso o pedido esteja associado a uma transportadora configurada com Realizar cotação? = SIM, a impressão da separação e a expedição ficarão bloqueadas;

  • Na tela de Expedição, selecione o pedido e pressione [CTRL + W] (ou clique no botão Cotação EconoCARGO);

  • Selecione a transportadora e o serviço desejado na tela de consulta. O sistema atualizará a transportadora final do pedido (FGO_CODTRA) e registrará o valor do frete sugerido (FGO_FRESUG), liberando o pedido para separação/faturamento;

• Envio do XML ao Faturar:

  • Ao faturar uma venda associada a uma transportadora EconoCARGO (Transp. EconoCARGO? = Sim), o sistema enviará automaticamente o XML da Nota Fiscal autorizada para o e-mail cadastrado na CFG_ECGEML.