Geração e Cancelamento do Documento Fiscal
A integração do Documento Fiscal é realizada na confirmação da autorização do mesmo (motor fiscal + SEFAZ). O documento é integrado no módulo Vendas, e fica disponível para geração dos Livros Fiscais, integração com a Contabilidade e com o Contas a Receber. A respeito do Contas a Receber, durante a integração é feita uma prévia das Duplicatas a serem geradas, baseando-se na Condição de Pagamento do Tomador do frete parametrizada no ERP Logix, no programa VDP0110.
A respeito da Natureza de Operação a ser utilizada na geração do Documento no ERP (fat_nf_mestre e afins).
- Em primeiro lugar, o sistema utilizará o parâmetro "natureza_operacao_ctes_suite". Ver Requisitos e Configurações.
- Caso não encontre, aproveitando a estrutura de tabelas do TMS Logix, será selecionada a Natureza de Operação parametrizada para o Tomador do CTe (tabela omc_emitente).
- Caso não encontre, então seleciona a Natureza de Operação padrão do TMS Logix (tabela omc_par_padrao, campo "natureza_operacao").
- Caso não encontre, rejeita a integração do CTe.
No momento da integração do Documento Fiscal, é validado se o hash armazenado no parâmetro “comp_frete_pedagio_tms_saas” é igual ao hash de algum dos componentes de frete utilizados no cálculo do frete do Documento Fiscal. Caso seja, o valor deste componente será armazenado em um item específico no ERP Logix, para que seja contabilizado e emitido nos Livros Fiscais de forma exclusiva.
A respeito do conceito de Área e Linha de Negócio:
- Durante a integração é verificado se a empresa Logix está parametrizada para uso de Área e Linha de Negócio, conforme parâmetro “contab_conhec_aen”, mantido no programa LOG00086.
- Se estiver, visando manter a regra para clientes já cadastrados, é feita a busca da Área e Linha de Negócio do atual cadastro do emitente tomador.
- Se este emitente não possuir Área e Linha de Negócio cadastrada, então são validados se os seguintes parâmetros estão preenchidos:
- “fat_aen_item_nf_classe_uso”
- “fat_aen_item_nf_linha_produto”
- “fat_aen_item_nf_linha_receita”
- “fat_aen_item_nf_segmto_mercado”
- Caso algum dos parâmetros mencionados acima não esteja preenchido, não serão alimentados os dados de Área e Linha de Negócio para os documentos fiscais integrados para o tomador de frete em questão.
No cancelamento do Documento Fiscal na suíte, após o retorno de confirmação do Motor Fiscal/SEFAZ, é acionada a integração enviando ao ERP os dados de cancelamento do documento. É incluído um registro de cancelamento do documento no Livro Fiscal, Contabilidade e Contas a Receber, cujas rotinas para efetivação do cancelamento podem ser acionadas automaticamente de acordo com parametrizações no ERP Logix, ou deverão ser executadas manualmente.
Durante a integração do Documento Fiscal, são armazenadas as Notas Fiscais transportadas para uso na emissão do arquivo a ser enviado para o SINTEGRA (OBF0317). Para este armazenamento, foi criada a tabela "fat_nf_conh_doc_carga".
DICA: Caso o cancelamento de um CTe não seja efetuado no ERP por alguma validação de regra de negócio, como título já baixado ou período contábil fechado:
- Efetue o processo para reverter a regra de negócio que causou o bloqueio do cancelamento.
- Acesse o programa LOG00086 e consulte o parâmetro "controla_modelo_canc_nfe", modificando seu valor para "S".
- Acesse o programa VDP0753, informe os dados do CTe e clique em "Cancela NF Logix".
- IMPORTANTE! Após feito o cancelamento, volte o parâmetro "controla_modelo_canc_nfe" para o valor anterior.
DICA: Caso o cancelamento de um CTe seja rejeitado pelo motivo "Duplicata já emitida para este documento, não pode ser cancelado" segue sugestão indicada pelo suporte do CRE Logix.
- No cre6710, o parâmetro 125 está igual a S, gravando o ies_impressao igual a S na docum_emis quando rodam o cre1610.
- 125 - Indicador para que, no cre1610, as duplicatas sejam gravadas no docum_emis como já impressas. A empresa que utilizar este parametro só vai listar duplicatas que forem solicitadas manualmente.
- S -> No cre1610, grava as duplicatas no docum_emis com o ies_impressao = "S".
- N ou nulo -> No cre1610, grava as duplicatas no docum_emis com o ies_impressao = "N".
- Artigo que orienta como "cancelar" uma remessa que ainda não foi enviada para o banco, mas esse processo de cancelamento não altera a tabela docum_emis, somente a tabela docum_escr: Cross Segmentos - Linha Logix - CRE - Como cancelar uma remessa que foi preparada pelo CRE1610/FIN10057.
Integrações online com CRE, CON e OBF
Estas integrações ocorrem em outra transação de dados, pois a prioridade é a integração do CTE. Caso estas integrações não ocorram de forma online por conta de alguma regra de negócio ou eventual erro, é possível efetuar a integração posteriormente de forma manual, ou no caso da integração com o Contas a Receber, via Título Financeiro emitido na Suíte Logística.
Para maiores detalhes de como ativar estas integrações, ver Requisitos e Configurações.
CTe de Substituição
A integração de um CTe de Substituição segue o mesmo fluxo dos demais CTes, porém, ao final e em uma transação de dados a parte, é efetuada a geração de uma Nota Fiscal de Entrada no Suprimentos (SUP3760), a fim de gerar uma contra-partida dos valores do CTe Original. Abaixo algumas particularidades deste processo:
- Esta Nota Fiscal é gerada com os dados do CTe Original, inclusive Número e Série.
- A Nota Fiscal é gerada com Espécie "NFD" e Tipo "1".
- A condição de pagamento deve estar informada no parâmetro "cond_pagto_nfd_sup_cte_subst" e deve estar cadastrada no programa FIN30008 como "Sem pagamento".
- A operação de estoque deve estar parametrizada no SUP7930 sem nenhum dos campos adicionais informados. Esta operação de estoque é informada no programa SUP7160, no campo "Operação estoque com custo médio" (campo "COD_OPERAC_DEV_CLI" da tabela "par_sup_compl").
- O modelo "57" deve estar cadastrado com o tipo de documento "1" no programa SUP1437.
- Com relação ao item utilizado a integração, será o mesmo item utilizado no registro de Saídas no VDP. É necessário verificar as seguintes característiacas no MAN10021:
- Na aba "Compras", precisa estar associado a um Comprador e um Programador válidos.
- Na aba "Fiscal" precisa ter uma conta contábil válida e de resultado/receita.
- Com relação ao CFOP utilizado é levado em consideração a UF da Empresa e a UF do Tomador, definindo:
- No Aviso de Recebimento (tabela aviso_rec) os valores 1.206 quando mesma UF ou 2.206 quando UFs diferentes.
- Na Nota Fiscal (tabela nf_sup) os valores 5.206 quando mesma UF ou 6.206 quando UFs diferentes.
- Estas CFOPs precisam estar cadastradas no programa SUP0600!
- Com relação ao CFOP armazenado na tabela "aviso_rec", atenção para:
- O parâmetro "considera_cfop_xml_totvs_colab" deve estar igual a "S", ou:
- Caso esteja como "N", o campo "Código Fiscal" da aba "Fiscal" no programa MAN10021 deve estar com os 3 últimos dígitos do CFOP correto (206) para o item usado no CTe original na integração no VDP.
Processos não efetuados na geração da Nota Fiscal de Entrada:
- O relacionamento com o CTe (Nota Fiscal de Saída) que está sendo substituído.
- Consistências da Nota Fiscal gerada.
Reforma Tributária
Na Suíte Logística deverão ser criados os novos impostos, bem como criadas as fórmulas para seus cálculos, conforme documentação disponível em https://tdn.totvs.com/pages/viewpage.action?pageId=990759834.
No ERP Logix, o path liberado em 08/12/2025 é pré-requisito para a integração dos CTes emitidos na Suíte Logística e recepcionados pelas APIs criadas. Acesse a documentação disponível a respeito da Reforma Tributária no ERP Logix em Reforma Tributária Logix.
Após aplicado, deve ser aplicado o patch que adapta as APIs para leitura dos novos impostos no JSON e envio para as funções do VDP. Este patch pode ser baixado em INFORMAR LINK AQUI!
Validações relacionadas a data de inicio da Reforma Tributária no ERP Logix:
- Se não estiver informada, ou estiver informada com data menor que a data corrente, os novos impostos não serão integrados.
- Se estiver informada com data igual ou superior a data corrente, a API irá validar se o JSON possui os blocos e chaves relacionados aos novos impostos. Caso não possua, a integração do CTe no ERP será rejeitada com a mensagem "A empresa está parametrizada para novos impostos da Reforma Tributária, porém, o CTe não possui o bloco fiscal/imp/IBSCBS/CST.".
Com relação ao Cte de Substituição, o grupo de despesa utilizado deve ter parametrizado os novos tributos, para que a entrada anule os novos impostos.
Caso não seja possível a aplicação dos patches no ERP Logix mencionados acima, sugerimos o seguinte, para ser usado de forma paleativa, e validada primeiramente em ambiente de homologação!
- Criar fórmula no VDP10065 conforme exemplo abaixo, e aplicá-la nos tributos CBS, IBS_UF e IBS_MUN:
- Base de cálculo: (fal_bc_cbs_ibs + val_is_item - val_icms_item - val_iss_rec_item - val_icms_uf_dest - val_fecomp_item)
- Valor final: (base_calc * ((aliquota-(aliquota *(taxa_reducao_pct/100)))/100))
- No programa VDP10068 incluir os novos tributos para a Natureza de Operação utilizada na integração de CTes oriundos da Suíte (mais detalhes a respeito deste parâmetro em Requisitos e Configurações).
- Desta forma, o XML enviado para a SEFAZ irá conter os novos impostos, e o ERP Logix irá efetuar o cálculo deles baseado na Natureza de Operação, assim como é feito para o PIS e COFINS.
Financeiro a Receber (Financeiro Logistico)
Na conclusão de um fechamento financeiro a receber é gerada a integração com o ERP Logix.
- O processo depende de documentos fiscais gerados para a geração de um fechamento com um ou mais documentos de mesmo ator devedor. É integrado com o ERP um único Título a Receber por fechamento com data(s) de pagamento(s) determinada(s) de acordo com a Condição de pagamento do Tomador do Frete no ERP Logix (ver programa VDP10078).
- Conforme mencionado anteriormente, neste momento serão efetivadas no Contas a Receber do Logix, as Duplicatas geradas na integração do Documento Fiscal.
- Ao clicar na opção “Reabrir” no fechamento financeiro a receber já finalizado, é efetuada a comunicação com o ERP Logix para Exclusão de todas as Duplicatas geradas.
- Se algum dos CTes já teve as duplicatas integradas no CRE de forma online, de acordo com o parâmetro "exportar_duplic_on_line_cre", a API irá retornar os dados da duplicata para o barramento.
Observações:
- Os Títulos a Receber no ERP Logix estão vinculados aos Documentos Fiscais.
- Por mais que os Documentos Fiscais venham agrupados no Título a Receber gerado na Suíte Logística, o agrupamento será feito seguindo as regras de agrupamento parametrizadas no ERP para o cliente Tomador (ver programa VDP2274).
Financeiro a Pagar (Financeiro Logistico)
Na conclusão de um fechamento financeiro é gerada a integração com o ERP Logix.
- O processo depende da geração do MDFe, de um CIOT e da confirmação da geração do pagamento pela IPEF (REPOM).
- É gerada AD e AP no Contas a Pagar do Logix com o valor total do contrato (CIOT) e com os valores dos tributos calculados pelo Motor Fiscal.
- Para a geração das ADs e APs é essencial que os parâmetros "tip_desp_pgto_cap_contr_frete" e "tip_desp_adto_cap_contr_frete" estejam preenchidos.
- Vale frisar que é necessária uma revisão do cadastro dos Tipos de Despesa com relação aos descontos dos impostos no FIN30056/CAP0070. O campo "Retém SEST/SENAT Ent Filantrópica" por exemplo, quando marcado, efetuará o desconto destes impostos na AD/AP.
- Durante a integração do título a pagar, é verificado se o parâmetro “tms_saas_cod_favorecido” está preenchido com um código de Fornecedor no ERP Logix, pois este será considerado com o Favorecido do título. Ver Requisitos e Configurações.
Observações:
- Os valores de impostos são calculados no Motor Fiscal da Suíte Logística e não pelo ERP Logix.
- Não há integração de alteração/estorno/cancelamento. Caso necessário pode ser feito o processo manualmente no ERP e na suite.
- Caso haja baixa de Adiantamento na AP de Pagamento, esta baixa deve ser excluída manualmente via programa FIN30057, modificando a AP, clicando no botão “Ajustar” e removendo a linha da baixa do adiantamento.
Observações Gerais
- O acompanhamento e histórico das integrações é feito pelo barramento Azure e pode ser consultado na suíte, conforme manual.
- A suíte garante a sequência do processo seguindo até sua conclusão, mesmo que ocorra algum problema de integração, garantindo assim o dia-a-dia do processo operacional. O histórico da integração, com problemas ou sucesso, pode ser verificado no monitor de integração na suíte.

