Sei sulla pagina 1di 50

TOTVS Colaboração 2.

00
Manual para Implantação – Linha RM
19/02/2015
TOTVS Colaboração 2.00

Título do documento
Sumário
1. Objetivo......................................................................................................................................................................... 4
2. Introdução .................................................................................................................................................................... 4
3. Parametrizações TOTVS Colaboração 2.00............................................................................................................... 6
3.1 Parametrização Global para Coligada ................................................................................................. 6
3.2 Parametrização por Filial ..................................................................................................................... 7
4. Jobs............................................................................................................................................................................... 8
4.1 Agendamento de Jobs ....................................................................................................................... 10
4.2 Gerenciamento de Jobs ..................................................................................................................... 10
5. Acompanhamento de arquivos recebidos ................................................................................................................ 11
6. Serviços TOTVS Colaboração 2.0 .............................................................................................................................. 13
6.1 NF-e ................................................................................................................................................... 13
6.1.1 Parametrizações Específicas............................................................................................................................................................... 13
6.1.2 Recebimento de NF-e .......................................................................................................................................................................... 13
6.1.2 Envio de NF-e ...................................................................................................................................................................................... 15
6.1.3 Carta de Correção NF-e ..................................................................................................................................................................... 16
6.1.4 Cancelamento de NF-e ....................................................................................................................................................................... 17

6.2 CT-e ................................................................................................................................................... 19


6.2.1 Parametrizações Específicas............................................................................................................................................................... 19
6.2.2 Recebimento de CT-e .......................................................................................................................................................................... 20
6.2.3 Envio de CT-e ...................................................................................................................................................................................... 21
6.2.4 Envio de CT-e em contingência ........................................................................................................................................................... 23
6.2.5 Carta de Correção CT-e ...................................................................................................................................................................... 24
6.2.6 Cancelamento de CT-e ....................................................................................................................................................................... 26
6.2.7 Inutilização de numeração CT-e .......................................................................................................................................................... 26

6.3 MD-e .................................................................................................................................................. 28


6.3.1 Parametrizações Específicas............................................................................................................................................................... 28
6.3.2 Envio de MD-e ................................................................................................................................................................................ 29

6.4 MDF-e ................................................................................................................................................ 33


6.4.1 Parametrizações Específicas.............................................................................................................................................................. 33
6.4.2 Envio de MDF-e .............................................................................................................................................................................. 34
6.4.3 Envio de MDF-e em contingência ........................................................................................................................................................ 35
6.4.4 Encerramento de MDF-e ................................................................................................................................................................... 36
6.4.5 Cancelamento de MDF-e .................................................................................................................................................................... 38
6.4.6 Inclusão de condutor ............................................................................................................................................................................ 39

6.5 NFS-e................................................................................................................................................. 41
6.5.1 Parametrizações Específicas............................................................................................................................................................... 41
6.5.2 Recebimento de NFS-e ....................................................................................................................................................................... 42
6.5.3 Envio de NFS-e .................................................................................................................................................................................... 44
6.5.4 Cancelamento de NFS-e .................................................................................................................................................................... 46
6.5.5 Substituição de NFS-e ........................................................................................................................................................................ 47
7. Informações Técnicas ................................................................................................................................................. 49
7.1 Alterações Estruturais no Banco de Dados........................................................................................ 49
7.2 Tabelas Envolvidas ............................................................................................................................ 49

2 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Especificação de Requisitos

Projeto/Versão: TOTVS Colaboração 2.0 /12.1 Requisito/Módulo: TOTVS Colaboração


Sub-Requisito/Função: Tarefa/Chamado:
País: Brasil Data Especificação: 19/02/2015

Estratégia de Desenvolvimento e Liberação

Produto TOTVS Colaboração 2.0


Release que está sendo desenvolvido 12.1
Possui Réplica? ( )Sim ( X )Não
Qual a versão?

Versão 1.0 3
TOTVS Colaboração 2.00

Título do documento
1. Objetivo
Este documento tem por objetivo fornecer as parametrizações e informações necessárias para funcionamento do
TOTVS Colaboração 2.0, englobando todos os serviços disponibilizados pelo mesmo:
 NF-e (Envio, Recebimento, Cancelamento, Consulta)
 NFS-e (Envio, Recebimento, Cancelamento, Substituição, Consulta)
 CT-e (Envio, Recebimento, Cancelamento, Consulta)
 MDF-e (Envio, Cancelamento)
 MD-e (Envio, Cancelamento )

Ele pode ser utilizado para implantação do TOTVS Colaboração em um novo cliente ou para auxiliar a configuração
de um serviço específico, para aqueles que já utilizam a solução.

O documento possui um visão geral, e logo após, a parametrização padrão necessária para funcionamento de
todos os serviços. As especificidades de cada serviço são detalhadas em tópicos logo a seguir.

2. Introdução
A solução TOTVS Colaboração 2.0 é composta basicamente pela integração entre o ERP e a Neogrid. Diferente do
TC 1.0, não existe o intermédio do TSS, o que trouxe uma arquitetura mais enxuta. Para o cliente, a nova
arquitetura resulta em uma melhor performance, mais simples e com automatismo maior.

A integração entre a NeoGrid e os ERPs TOTVS deve seguir uma padronização, com premissas que reafirmam os
benefícios citados:
a) Solução de integração simples e padronizada para todos os tipos de documentos e ERPs, com foco na
performance da solução para o cliente final e na agilidade de atendimento para as equipes de suporte;
b) O padrão de comunicação entre os ERPs TOTVS e a NeoGrid é realizado de forma assíncrona com troca de
documentos no formato XML em diretórios;
c) Existem dois tipos de integração do ponto de vista dos ERPs: envio de documentos e recebimento de
documentos;
d) A NeoGrid deve instalar um aplicativo client denominado “Client NeoGrid” no ambiente de cada cliente;

4 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

e) Para cada tipo de documento todos os ERPs TOTVS devem utilizar o mesmo layout de integração com a
NeoGrid.

Figura 1 – TOTVS Colaboração 2.0 – Integração Neogrid utilizando arquivos XML

Os processos de envio/recebimento são estruturados em arquivos XML e disponibilizados em diretórios definidos.


A solução NeoGrid processa a leitura dos arquivos XML, faz a comunicação com os webservices da SEFAZ e retorna
as consultas destes documentos. Estes, por sua vez, deverão ser lidos e interpretados através da execução de JOBs
específicos pelo ERP TOTVS Linha RM para a devida atualização dos dados no sistema.

No diretório parametrizado para o ClientEDI Neogrid teremos a seguinte estrutura para manipulação de arquivos
XML:

Subpasta Descrição
\IN Arquivos retornados pelo ClientEDI a serem processados
\OUT Arquivos disponibilizados pelo ERP a serem enviados
\SENT Arquivos enviados com sucesso pelo ClientEDI à SEFAZ
\TMP Arquivos em manipulação pelo ClientEDI
\ERROR Arquivos processados com erro pelo ClientEDI
\RM\TMP Arquivos em manipulação pelo JOB ERP
\RM\ERRO Arquivos processados com erro pelo JOB ERP
\RM\RECEBIDAS Arquivos processados com sucesso pelo JOB ERP – são excluídos se houver sucesso

A nomenclatura dos arquivos XML nos diretórios, tanto para envio como retorno, deve seguir a padronização:
[Tipo do Documento]_[Timestamp]_[Coligada]_[IdMov]_[Número sequencial].xml
Onde:
 [Tipo de Documento] é o código do tipo de documento
 [Timestamp] é a data e hora no formato “yyyyMMddHHmmssSSS”
 [Coligada] é o código da Coligada do documento
 [IdMov] é o código Identificador do Movimento

Versão 1.0 5
TOTVS Colaboração 2.00

Título do documento
 [Número sequencial] é um número sequencial de quatro dígitos (opcional)

3. Parametrizações TOTVS Colaboração 2.00

3.1 Parametrização Global para Coligada

A configuração principal deve ser feita através do módulo BackOffice “Gestão de Estoque, Compras e Faturamento
(RM Nucleus) ” , através do menu “ Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >>
Integrações >> Fiscal >> Dados Fiscais ”, tópico “TOTVS Colaboração”.

É necessário informar a versão da integração TOTVS Colaboração ( neste caso, 2.0) e o diretório raiz do ClientEDI
NeoGrid, onde estão as pastas responsáveis para compartilhamento dos arquivos XML ( IN, OUT, SENT, etc).

Figura 2 – Parametrização Global

Observação: O diretório parametrizado poderá ser o mesmo para várias Coligadas.

6 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

3.2 Parametrização por Filial

É necessário parametrizar as filiais que irão trabalhar com o TOTVS Colaboração. Através dos parâmetros da Filial
(menu “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Integrações >> Fiscal >>
Dados Fiscais >> Parâmetros por Filial ”, acesse o item “Informações TOTVS Colaboração” e selecione quais Tipos
de Documentos terão a integração TOTVS Colaboração 2.00.

Observações:
 Ao marcar a opção “Todos” não é necessário selecionar outras opções de tipo de documentos.
 Caso desmarque todas as opções de tipo de documentos a integração será desativada.

Além dessa informação, os seguintes campos devem ser informados:


 Usuário/Senha TOTVS Colaboração: estes dados inicialmente seriam necessários somente para o TOTVS
Colaboração 1.0. Entretanto, com a migração do TOTVS Colabração 2.0, a obrigatoriedade não foi retirada.
Dessa forma, é necessário o preenchimento, mas não há validação das informações preenchidas.
 Ambiente TOTVS Colaboração – Recebimento.
 Número máximo de documentos para Retorno.

Figura 3 – Parametrização por Filial

Versão 1.0 7
TOTVS Colaboração 2.00

Título do documento
4. Jobs
Os Jobs são necessários para uma verificação contínua do arquivos recebidos pelo Neogrid. Para execução dos
Jobs, é necessário que o ambiente esteja configurado em três camadas e o Host esteja funcionando corretamente.
Desta forma, ao executar o sistema, os Jobs já estarão prontos.

Para o TOTVS Colaboração 2.0, é possível realizar o agendamento dos Jobs ou excecutá-los manualmente. Para
ambas as situações, é necessário acessar o ‘Monitor de Arquivos TOTVS Colaboração’ , em “Utilitários”.

Figura 4 – Monitor de arquivos TOTVS Colaboração

Existem dois Jobs a serem executados para que os arquivos .XML enviados pela Neogrid sejam importados.

1) Importação de Arquivos – Totvs Colaboração: esse Job é um Job Global, responsável por buscar os
documentos enviados pela ClientEDI Neogrid e distribuí-los por Coligada. Neste momento, nenhuma
validação é feita. Após a execução desse Job, os documentos lidos são exibidos no ‘Monitor de arquivos
Totvs Colaboração’ com o status ‘Pendente’, aguardando a ação do segundo Job. Serão exibidos apenas
os documentos destinados à Coligada do usuário logado. Para executar esse Job, deve- se ir em “Processos
>> Importação de arquivos - TOTVS Colaboração”.

Figura 5 – Menu para execução de Jobs

8 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

2) Serviço Totvs Colaboração Consulta: esse Job é responsável por validar o arquivo .XML do documento
enviado, de acordo com o tipo de documento em questão ( CT-e, NF-e, NFS-e, etc), através da chamada
do serviço especifico para cada um deles. Serão verificados todos os documentos lidos pelo 1º Job. Caso o
documento esteja válido, o registro do arquivo é excluído do monitor, e passa a ser exibido na tela
“Compras -> TOTVS Colaboração – Cadastro XML”, indicando que ele foi incluído no sistema com sucesso
( vide item 5 – Acompanhamento de arquivos recebidos).
Caso seja encontrado algum problema no arquivo importado, o status do registro é alterado para
‘Inconsistente’. Para verificar o erro, basta um duplo clique no registro para exibição do Log.
Quando o arquivo está Incosistente, é necessário corrigir a causa do erro para tentar incluí-lo no sistema.
Neste caso, o registro pode ser excluído, ou seu status pode ser alterado manualmente para ‘Pendente’
através do processo “Alterar status do arquivo TOTVS Colaboração”.

Figura 6 – Detalhe de registro no Monitor

Este Job é responsável também por realizar os serviços de consultas disponíveis dos serviços do TOTVS
Colaboração, atualizando os status dos documentos fiscais. Dessa forma, ele substitui os processsos de
consulta hoje disponíveis para cada documento fiscal individualmente.

Versão 1.0 9
TOTVS Colaboração 2.00

Título do documento
4.1 Agendamento de Jobs

Conforme citado, os dois Jobs podem ser executados imediatamente, ou agendados para funcionarem
periodicamente. Para que não seja necessário uma constante intervenção manual do usuário, é indicado que o
agendamento seja realizado.
Ao acessar os menus de acesso ao Jobs (vide Figura 5) , será exibida a tela abaixo, onde o usuário terá como escolha
as opções ‘Agora’ e ‘Executar em’. Ao escolher o segundo item, o usuário poderá agendar um execução única
(marcando o item ‘Não repetir’), ou periódica , configurando os dias , horários e frequência de execução. À partir
daí, a ação manual do usuário não será mais necessária.

Obs: Caso a tela de agendamento seja acessada novamente, não será possível visualizar a configuração do
agendamento realizada, pois ela sempre traz à configuração original quando aberta ( Horas de execução = Agora).
Isso não quer dizer , entretanto, que o agendamento foi perdido. Será possível verificar a programação de
execução dos Jobs na tela “Gerenciamento de Jobs” .

Figura 7 – Agendamento de Jobs

4.2 Gerenciamento de Jobs

A tela de Gerenciamento de Jobs ( em “Ambiente >> Gerenciamento de Jobs” ) controla todos os Jobs em execução,
executados e que estão por executar. Para os executados, é possível verificar se houve sucesso ou não na execução,

10 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

identificar a causa da falha em caso de erro, e a quantidade de arquivos verificados em caso de sucesso. Para os
não executados, é possível verificar o dia/hora das próximas execuções.

Figura 8 – Menu Gerenciamento de Jobs

Figura 9 – Gerenciamento de Jobs

5. Acompanhamento de arquivos recebidos


Para acompanhar os arquivos recebidos, o usuário deverá acessar em “Compras -> TOTVS Colaboração – Cadastro
XML”. Os arquivos são exibidos nesta tela automaticamente após passarem pela validação inicial, através da
importação via Monitor TOTVS Colaboração ( ver item 4 – Jobs).

Para importação via TOTVS Colaboração 2.0, dois status são considerados:
 Incosistente: o arquivo .XML não foi incluído devido a alguma inconsistência encontrada. Por ex.: “Filial
não encontrada”. Neste caso, o sistema permite o preenchimento manual da Filial, através de um duplo
clique no registro.
 Válido: o arquivo foi incluído corretamente.

Os registros podem assumir outros status (Pendente, Enviado para validação, ect), mas eles são utilizados
quando há a inclusão manual de um arquivo .XML . Essa importação não será abordada aqui, e poderá ser vista
em maiores detalhes no WikiHelp

Versão 1.0 11
TOTVS Colaboração 2.00

Título do documento
(http://wikihelp.TOTVS.com.br:11800/WikiHelp/EST/EST.Inclus%C3%A3oDocumentosFiscaisViaImporta%C3%A7
%C3%A3oXML.aspx)
Todos os arquivos recebido via importação do TOTVS Colaboração 2.0 já foram validados junto à SEFAZ pela
Neogrid.

Para cada registro, é informado o tipo de serviço o qual ele se refere (CT-e, NF-e, etc) através da coluna ‘Tipo do
XML’. O check “Importado TOTVS Colaboração” diferencia os registros importados daqueles incluídos
manualmente, e o campo “Ident. Movimento” indica se já foi criado um movimento para aquele arquivo .XML

Figura 10 – Tela TOTVS Colaboração – Cadastro XML

12 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

6. Serviços TOTVS Colaboração 2.0


6.1 NF-e

6.1.1 Parametrizações Específicas

Para receber ou enviar um arquivo .XML de uma NF-e, é necessário realizar as seguintes parametrizações por Filial
(menu “ Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Integrações >> Fiscal >>
Dados Fiscais >> Parâmetros por Filial ”)
 Marcar o item ‘Todos’ ou ‘Recebimento NF-e’ e/ou ‘Envio NF-e’ na aba ‘Informações TOTVS Colaboração’
(ver item 3.2 – Parametrização por Filial );
 Preencher corretamente as abas ‘Conexão NF-e’ e ‘Ambiente NF-e’

Figura 11 – Tela Parâmetros por Filial – NF-e

6.1.2 Recebimento de NF-e

O processamento de recebimento de NF-e é realizado através das seguintes etapas:

Versão 1.0 13
TOTVS Colaboração 2.00

Título do documento
1. Importação dos arquivos XML disponibilizados pelo ClientEDI NeoGrid, através do processo “Importação
de arquivos – TOTVS Colaboração “ (ver item 4 – Jobs);
2. Inclusão do arquivo .XML nas tabelas do sistema, através do processo “Serviço TOTVS Colaboração
Consulta” (ver item 4 – Jobs);
3. Inclusão do movimento específico referenciando o XML cadastrado, através do processo “Inclusão de
movimento com arquivo XML”, no menu “ Compras >> Recebimento de Materiais ” .

Figura 12 – Inclusão de NF-e através de importação do .XML

Atenção: Para que que a opção “Inclusão de movimento com arquivo XML” seja habilitada, é necessário que o
tipo de movimento selecionado esteja parametrizado para ‘Recebimento NF-e’. A parametrização deve ser
realizada em “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Gestão de compras >>
Recebimento de Materiais >> TOTVS Colaboração ”.
Além desta informação , é necessário informar através do campo ‘Busca PIS/COFINS em‘ se o cálculo de PIS/COFINS
deve ser carregado arquivo XML ou se será calculado de acordo com a parametrização do tipo de movimento

14 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Figura 13 – Parametrização do movimento para Recebimento CT-e

Os arquivos .XMl de Nota fiscal Eletrônica (NF-e) recebidos são iniciados pela numeração 109.

6.1.2 Envio de NF-e

O envio de NF-e é realizado através da seguinte etapa:

1. Executar o processo ‘Enviar NF-e’ através do menu “Vendas >> Faturamento >> SPED NF-e (Estadual)”.

Após o envio, o registro irá assumir o status ‘Pendente’, caso não ocorra nenhum erro de validação. Neste
momento, arquivo .XML será criado e disponibilizado para envio pelo ClientEDI NeoGrid. Este, por sua vez,
se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação junto à SEFAZ.

Caso ocorra algum problema ao enviar a NF-e devido à alguma informação incorreta/inválida, o registro
receberá o status de ’Inconsistente’. Neste caso, o movimento deve ser corrigido, e o processo de envio deve
ser realizado novamente.

Após o envio, os sistema irá aguardar o retorno da SEFAZ, realizado por intermédio da Neogrid. Através do
retorno, os status das notas serão atualizados. A NF-e poderá assumir os seguintes status, que irão indicar a
aprovação ou não da mesma pela SEFAZ:
 Autorizada: indica que a NF-e foi aprovada pela SEFAZ;
 Rejeitada: indica que a NF-e não foi autorizada pela SEFAZ. Neste caso, o movimento criado pode ser
corrigido e reenviado;
 Denegada: indica que o destinatário da NF-e possui alguma pendência junto ao Fisco. Neste caso, a
nota não pode ser corrigida e reenviada, e a caso seja necessário , outra nota deve ser criada.

Versão 1.0 15
TOTVS Colaboração 2.00

Título do documento
Todos os status acima são atualizados pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo
ClientEDI da Neogrid.
O processo de consulta exibido no menu ‘Processos’ deixa de funcionar.

Atenção: Para o envio , é necessário que o tipo de movimento selecionado esteja parametrizado para ‘Envio
de NF-e’. A parametrização deve ser realizada em “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e
Faturamento” >> Vendas >> Faturamento >> TOTVS Colaboração ”.

Figura 14 – Parametrização do movimento para Envio de NF-e

Os arquivos de Nota fiscal Eletrônica (NF-e) criados para envio são iniciados pela numeração 170.

6.1.3 Carta de Correção NF-e


A carta de correção é um evento da NF-e, e deve ser utilizado quando ocorrer algum erro na emissão da nota
e que, de acordo com a legislação, possa ser corrigido através de uma CC-e.

Para emitir uma CC-e é necessário acessar a opção ‘Envio de Evento NF-e‘ através do menu “Vendas >>
Faturamento >> SPED NF-e (Estadual) >> Processos >> Envio de Evento NF-e”. Ao entrar na tela, deve-se
escolher o tipo de evento ‘Carta de Correção Eletrônica’, e informar no campo texto a correção desejada. Após
o preenchimento , basta clicar em ‘Executar’.

16 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Enquanto aguarda o retorno da SEFAZ, realizado por intermédio da Neogrid, o registro de evento da NF-e
recebe o status ‘Pendente’. Após o retorno , o evento volta ao status ‘Autorizado’.

Para verificar o resultado do processamento do evento enviado/recebido, é necessário verificar em “Anexos


>> Historico ”.

Para verificar a situação do evento, é necessário acessar o menu “Anexos >> Eventos da NF-e”. O histórico
do evento poderá ser consultado através do menu “Anexos >> Historico da NF-e ” ou na tela de edição
do evento através do menu “Anexos >> Historico do Evento ”.

A atualização dos registros será realizada pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo
ClientEDI da Neogrid.

Somente para as NF-e’s que já tenham sido autorizadas pela SEFAZ ( status = ‘Autorizada’) podem ser enviadas
CC-e’s.

Os arquivos de Carta de Correção da NF-e (CC-e) criados para envio são iniciados pela numeração 301.

6.1.4 Cancelamento de NF-e

O cancelamento de NF-e é utilizado quando existe alguma informação incorreta que não pode ser corrigida
pela CC-e. Os passos para o cancelamento são os mesmos percorridos para envio da CC-e: acessar a opção
‘Envio de Evento NF-e‘ através do menu “Vendas >> Faturamento >> SPED NF-e (Estadual) >> Processos >>
Envio de Evento NF-e”. Ao entrar na tela, deve-se escolher o tipo de evento ‘Cancelamento da NF-e’, e
informar no campo texto o motivo do cancelamento. Após o preenchimento , basta clicar em ‘Executar’.

Após o envio da solicitação de cancelamento, a NF-e irá receber temporariamente o status ‘Cancelamento
Pendente’. Após o retorno da SEFAZ, realizado por intermédio da Neogrid, a NF-e poderá receber dois status:
 Cancelada: indica que a solicitação de cancelamento foi aceita, e que a NF-e foi cancelada;
 Autorizada: indica que a solitação de cancelamento foi rejeitada. Neste caso, a NF-e volta ao status
original e nada acontecerá com o movimento que a originou.

Todos os status acima são atualizados pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo
ClientEDI da Neogrid.

Atenção: O cancelamento só pode ser feito dentro de um determinado tempo. A SEFAZ deve ser consultada
para saber qual o correto período no qual este tipo de evento pode ser enviado.

Somente NF-e’s que já tenham sido autorizadas pela SEFAZ ( status = ‘Autorizada’) podem ser canceladas.

Versão 1.0 17
TOTVS Colaboração 2.00

Título do documento

Figura 15 – Tela de envio de evento de NF-e

Os arquivos de cancelamento da NF-e criados para envio são iniciados pela numeração 171.

18 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

6.2 CT-e

Conforme o manual de integração do contribuinte, o CT-e é um documento de existência apenas digital, emitido
e armazenado eletronicamente, com o intuito de documentar, para fins fiscais, uma prestação de serviço de
transporte de cargas realizada por qualquer modal (Rodoviário, Aéreo, Ferroviário, Aquaviário e Dutoviário). Sua
validade jurídica é garantida pela assinatura digital do emitente (garantia de autoria e de integridade) e pela
recepção e autorização de uso, pelo Fisco (SEFAZ).

6.2.1 Parametrizações Específicas

Para receber ou enviar um arquivo .XML de um CT-e, é necessário realizar as seguintes parametrizações por Filial
(menu “ Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Integrações >> Fiscal >>
Dados Fiscais >> Parâmetros por Filial ”)
 Marcar o item ‘Todos’ ou ‘Recebimento CT-e’ e/ou ‘Envio CT-e’ na aba ‘Informações TOTVS Colaboração’
(ver item 3.2 – Parametrização por Filial );
 Preencher corretamente a aba ‘CT-e’

Figura 16 – Tela Parâmetros por Filial – CT-e

Versão 1.0 19
TOTVS Colaboração 2.00

Título do documento
6.2.2 Recebimento de CT-e

O processamento de recebimento de CT-e é realizado através das seguintes etapas:

1. Importação dos arquivos XML disponibilizados pelo ClientEDI NeoGrid, através do processo “Importação
de arquivos – TOTVS Colaboração “ (ver item 4 – Jobs);
2. Inclusão do arquivo .XML nas tabelas do sistema, através do processo “Serviço TOTVS Colaboração
Consulta” (ver item 4 – Jobs);
3. Inclusão do movimento específico referenciando o XML cadastrado, através do processo “Inclusão de
movimento com arquivo XML”, no menu “ Compras >> Recebimento de Materiais ” .

Figura 17 – Inclusão de CT-e através de importação do .XML

Atenção: Para que que a opção “Inclusão de movimento com arquivo XML” seja habilitada, é necessário que o
tipo de movimento selecionado esteja parametrizado para ‘Recebimento CT-e’. A parametrização deve ser
realizada em “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Gestão de compras >>
Recebimento de Materiais >> TOTVS Colaboração ”.
Além desta informação , é necessário informar o Produto/Serviço Default que será considerado no momento da
criação do movimento.

20 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Figura 18 – Parametrização do movimento para Recebimento CT-e

Os arquivos .XMl do Conhecimento de Transporte Eletrôncio (CT-e) recebidos são iniciados pela numeração 214.

6.2.3 Envio de CT-e

O envio de CT-e é realizado através da seguinte etapa:

1. Executar o processo ‘Enviar CT-e’ através do menu “Vendas >> Faturamento >> Conhecimento de
Transporte Eletrônico (CT-e)”.

Para realizar o envio, deve-se selecionar o movimentos criado, à partir do filtro da tela a ser exibida:

Versão 1.0 21
TOTVS Colaboração 2.00

Título do documento

Figura 19 – Seleção de movimentos CT-e para envio

Após o envio, o registro irá assumir o status ‘Pendente’, caso não ocorra nenhum erro de validação. Neste
momento, o arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid. Este, por sua
vez, se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação junto à
SEFAZ.

Caso ocorra algum problema ao enviar o CT-e devido à alguma informação incorreta/inválida, o registro
receberá o status de ’Inconsistente’. Neste caso, o movimento deve ser corrigido, e o processo de envio deve
ser realizado novamente.

O sistema irá aguardar o retorno da SEFAZ, realizado por intermédio da Neogrid. Através do retorno, os status
dos CT-e serão atualizados. O CT-e poderá assumir os seguintes status:
 Autorizado: indica que o CT-e foi aprovado pela SEFAZ;
 Rejeitado: indica que o CT-e não foi autorizado pela SEFAZ. Neste caso, o movimento criado pode ser
corrigido, conforme problema apontado, e reenviado;
 Denegado: indica que o destinatário do CT-e possui alguma pendência junto ao Fisco. Neste caso, o
CT-e não pode ser corrigido e reenviado, e a caso seja necessário , outro Conhecimento de Transporte
deve ser emitido.

Todos os status acima são atualizados pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo
ClientEDI da Neogrid.

Os arquivos .XMl do Conhecimento de Transporte Eletrôncio (CT-e) enviados são iniciados pela numeração
199.

22 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

6.2.4 Envio de CT-e em contingência

A emissão de CT-e em modo de contingência deve ser utilizada quando existe algum problema (webservice
inoperante, falha de comunicação com a web, etc) que impeça o envio do documento à SEFAZ. Após a emissão em
contingência, impressão do “DACTE – Documento Auxiliar do Conhecimento de Transporte” pode ser realizado
para que seja liberado o transporte das mercadorias enquanto a comunicação com a SEFAZ não é restabelecida.

Para utilizar o modo de contingência é necessário parametrizar o ambiente de CT-e da Filial ( menu “ Ambiente >>
Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Integrações >> Fiscal >> Dados Fiscais >>
Parâmetros por Filial ”) para a “Modalidade de Operação” igual a “Contingência Offline FS-DA” e enviar o
documento pelo processo “Gerar DACTE em Contingência”.

Figura 20 – Tela Parâmetros por Filial – CT-e em contingência

Versão 1.0 23
TOTVS Colaboração 2.00

Título do documento

Figura 21 – Envio de CT-e em contingência

Importante: Após a regularização da falha deve-se voltar a parametrização da “Modalidade de Operação” do


ambiente do CT-e da Filial para “Normal” .Na visão de CT-es emitidos (em “Vendas >> Faturamento >>
Conhecimento de Transporte Eletrônico” ), selecionar o registro do CT-e emitido em contingência e efetivar o envio
do documento à SEFAZ através do processo “Enviar CT-e”, com a justificativa da emissão em modo de contingência
preenchida.

6.2.5 Carta de Correção CT-e


A carta de correção é um evento do CT-e, e deve ser utilizado quando o conhecimento de transporte foi enviado
com alguma informação errada. É permitida a correção somente para erros relativos à prestação de serviço de
transporte, desde que o erro não esteja relacionado com valores de impostos, dados cadastrais (emitente,
tomador, remetente ou destinatário) ou datas de emissão ou saída.

Para emitir uma CC-e é necessário acessa a opção ‘Enviar Evento ‘ através do menu “Vendas >> Faturamento >>
Conhecimento de Transporte Eletrônico” . Ao entrar na tela, deve-se escolher o tipo de evento ‘Carta de Correção
(CC-e) Eletrônica’, e incluir as alterações necessárias. Podem ser incluídas várias alterações, e para cada uma
delas, é necessário informar o “Grupo da Alteração”, “Campo” e “Valor Alteração”.

Após o preenchimento, basta clicar em ‘Executar’ para que a CC-e seja enviada.

24 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Figura 22 – Tela de Carta de Correção – CT-e

Neste momento, o arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid. Este,
por sua vez, se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para
validação junto à SEFAZ.

Enquanto aguarda o retorno da SEFAZ, realizado por intermédio da Neogrid, o registro do CT-e recebe o
status ‘Evento Pendente’. Após o retorno , o movimento volta ao status ‘Autorizado’.

Figura 23 – Acompanhamento de CT-e – Evento pendente

Versão 1.0 25
TOTVS Colaboração 2.00

Título do documento
Para verificar o resultado do processamento enviado, é necessário acessar o anexo.

Somente para os CT-e’s que já tenham sido autorizadas pela SEFAZ ( status = ‘Autorizado’) podem ser enviadas
CC-e’s

O arquivo XML de envio/retorno da Carta de Correção do CT-e possui o tipo de documento 385.

6.2.6 Cancelamento de CT-e

O cancelamento de CT-e é utilizado quando existe alguma informação incorreta que não pode ser corrigida
pela CC-e. Os passos para o cancelamento são os mesmos percorridos para envio da CC-e: acessar a opção
‘Enviar Evento ‘ através do menu “Vendas >> Faturamento >> Conhecimento de Transporte Eletrônico”.
Ao entrar na tela, deve-se escolher o tipo de evento ‘Cancelamento’, e informar no campo texto
o motivo do cancelamento. Após o preenchimento , basta clicar em ‘Executar’.

Atenção: Caso tenha a seleção de mais de um registro na visão e seja executado o envio de evento, a
informação será replicada de forma idêntica a todos os documentos selecionados.

Neste momento, o arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid. Este,
por sua vez, se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para
validação junto à SEFAZ.

Enquanto aguarda o retorno o retorno da SEFAZ, realizado por intermédio da Neogrid, o registro do CT-e
recebe o status ‘Evento Pendente’. Após o retorno , o movimento volta ao status ‘Autorizado’ ( Ver figura 22).

Para verificar o resultado do processamento do evento enviado/recebido, é necessário verificar em “Anexos


>> Historico ”.

Os arquivos .XMl de Cancelamento de CT-e enviados são iniciados pela numeração 200.

6.2.7 Inutilização de numeração CT-e

A inutilização de numeração CT-e é realizada quando o registro está com status de “Inconsistente” ou “Rejeitado”
e não foi transmitido à SEFAZ. Para a inutilização , deve-se acessar em “Vendas >> Faturamento >> Conhecimento
de Transporte Eletrônico >> Processos >> Inutilizar CT-e”.
Selecione o o registro e execute o processo de inutilização e, neste caso, o sistema apenas solicitará a confirmação
da execução.

26 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Neste momento, o arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid. Este, por
sua vez, se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação junto à
SEFAZ.

Enquanto aguarda o retorno da SEFAZ, realizado por intermédio da Neogrid, o registro do CT-e recebe o status
‘Evento Pendente’. Após o retorno , o movimento volta ao status ‘Autorizado’ .

Para verificar o resultado do processamento enviado/recebido, é necessário verificar em “Anexos >> Historico de
Conhecimento de Transporte ”

Os arquivos .XMl de Inutilização de CT-e enviados são iniciados pela numeração 201.

Versão 1.0 27
TOTVS Colaboração 2.00

Título do documento
6.3 MD-e

A finalidade da Manifestação do Destinatário (MD-e) é e garantir que operações fiscais sejam realizadas sem
fraudes pelo uso indevido de dados cadastrais das empresas, dando maior segurança jurídica para as mesmas. O
MD-e permite que o destinatário da NF-e negue ou confirme a sua participação na operação acobertada pela NF-
e emitido para o seu CNPJ , manifestando sobre as informações prestadas na mesma.

6.3.1 Parametrizações Específicas

Para enviar um arquivo .XML de um MD-e, é necessário realizar as seguintes parametrizações por Filial (menu “
Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Integrações >> Fiscal >> Dados Fiscais
>> Parâmetros por Filial ”)
 Marcar o item ‘Todos’ ou ‘MD-e’ na aba ‘Informações TOTVS Colaboração’ (ver item 3.2 – Parametrização
por Filial );
 Preencher corretamente a aba ‘Manifesto de Destinatário’

Figura 24 – Tela Parâmetros por Filial – MD-e

28 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

6.3.2 Envio de MD-e

A tela para realização do manifesto encontra-se em “Compras >> Manifestação de Destinatário (MD-e)”.

Para realizar o envio do MD-e, é necessário visualizar e selecionar as Notas Fiscais endereçadas ao cliente.
Diferente do CT-e e MDF-e, não é necessário criar um movimento. Para resgate das notas, deve-se executar
processo “Sincroniza documento” , responsável pela solicitação das NF-es endereçadas junto à SEFAZ, por
intermédio do Neogrid.

Para o sincronismos deverão ser informados os seguintes itens:


 Filial – caso não seja informada, serão consideradas todas;
 Indicador da Nota Fiscal
0 – Todas as NF’es
1 – Somente as NF’es que ainda não tiveram Manifestação do Destinatário: Desconhecimento da
Operação, Operação não Realizada ou Confirmação da Operação.
2 – Somente as NF’es que ainda não tiveram Manifestação do Destinatário e não tiveram Ciência da
Emissão.
 Indicador do Emissor da Nota Fiscal:
0 – Todos os Emitentes / Remetentes
1 – Somente as NF’es emitidas por emissores / remetentes que não tenham a mesma raiz do CNPJ do
destinatário: essa opção exclui os documentos de transferência entre Filiais.

Figura 25 – Tela de Sincronização

Assim que o sincronismo é executado, é criada uma solicitação ao Neogrid. Através desta solicitação , o Neogrid
irá solicitar a listagem juntamente à SEFAZ, e após o retorno , disponibilizar as informações solicitadas por meio
do arquivo .XML.
Esse retorno não ocorre imediatamente, e é necessário que os Jobs de importação e consulta atuem sobre o
arquivo para que a listagem de notas para o manifesto seja exibida ( ver item 4 – Jobs).

Versão 1.0 29
TOTVS Colaboração 2.00

Título do documento
Dessa forma, os registro das Nf-es a serem manisfestadas não serão exibidos logo após a execução do processo,
é necessário o retorno da solicitação realizada.

Atenção: o processo ‘Sincroniza documentos por Chave de acesso’ não se aplica ao TOTVS Colaboração 2.0,

6.3.2.1 Manifestação

Após as notas serem carregadas e exibidas na tela, o cliente deve realizar o manifesto para declarar junto à SEFAZ
a confirmação da sua participação nas operações acobertadas pelos documentos.

Inicialmente, todos os registros serão exibidos com o status de evento ‘Consultar Evento’. Para cada registro
exibido, o usuário deverá executar o processo “Manifesta Evento do Documento” e escolher o tipo de manisfesto
a ser realizado:
 Confirmação da Operação – confirma a ocorrência da operação e o recebimento da mercadoria (para as
operações com circulação de mercadoria);
 Desconhecimento da Operação – declara o desconhecimento da operação;
 Operação não Realizada – declara que a Operação não foi realizada (com recusa do recebimento da
mercadoria e outros) e a justificativa porque a operação não se realizou;
 Ciência da Emissão – declara ter ciência da operação destinada ao CNPJ, mas ainda não possui elementos
suficientes para apresentar uma manifestação conclusiva, como as citadas acima.

Após o envio, o arquivo .XML do manisfesto será criado e disponibilizado para envio pelo ClientEDI da NeoGrid.
Este, por sua vez, se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação
junto à SEFAZ.

Enquanto aguarda o retorno da SEFAZ, realizado por intermédio da Neogrid, o registro irá receber o status de
evento ‘Enviado’, e o status do MD-e será ‘Pendente’, indicando o aguardo do retorno.

A atualização dos registros será realizado pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo ClientEDI
da Neogrid.

Atenção: Existe o processo ‘Consultar Evento’, que era utilizado para verificar o retorno das solicitações, mas não
é aplicável ao TOTVS Colaboração 2.0. Toda a consulta deve ser realizada pelo Job específico, conforme citado
acima. Caso o processo de consulta da tela seja utilizado, não ocorrerá erros, mas o sistema irá emitir a mensagem
abaixo informando sua invalidade:

30 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Figura 26 – Tela de mensagem de alerta do processo de consulta

Após o retorno, os registros selecionados terão seu status de evento alterado (Confirmado, Rejeitado ou
Inconsistente), e o status o MD-e atualizado conforme tipo de manifesto enviado (Ciência da Operação,
Confirmação da Operação, Desconhecida, Operação não realizada).

Algumas regras específicas do MD-e:


 O sistema não permite novo envio caso exista um retorno pendente;
 No envio do evento de manifesto devem ser verificadas as seguintes regras, se o tipo do evento for:
a) Ciência da Operação: após confirmado pode ser reenviado um evento de qualquer outro tipo;
b) Operação Não Realizada: após confirmado não pode ser reenviado nenhum outro evento;
c) Confirmação da Operação: após confirmado só pode ser reenviado uma única vez e pelo tipo
“Desconhecimento da Operação”;
d) Desconhecimento da Operação: após confirmado só pode ser reenviado uma única vez e pelo tipo
“Confirmação da Operação”.
 O Identificador do Movimento só será preenchido no manifesto caso seja utilizado o processo
“Confirmação da Operação – Manifestação Automática”.
 O código do Fornecedor só será preenchido caso exista na base um Cli/For utilizando o mesmo CPF/CNPJ
do emissor da nota.

Versão 1.0 31
TOTVS Colaboração 2.00

Título do documento

Figura 27 – Tela Parâmetros por Filial – MD-e

O sistema disponibiliza ainda o processo chamado ‘Confirmação da Operação – Manisfetação Automática’. Este
processo verifica se existe pelo menos um movimento de compra com a chave de acesso da(s) nota(s)
selecionada(s) em questão e reliza o envio um evento do tipo “Confirmação da Operação”.

Os arquivos .XMl de Manisfesto do Destinatátio (MD-e) enviados são iniciados pela numeração 320.

32 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

6.4 MDF-e

Conforme o manual de orientação do contribuinte, MDF-e é o documento emitido e armazenado eletronicamente,


de existência apenas digital, para vincular os documentos fiscais utilizados na operação e/ou prestação, à unidade
de carga utilizada no transporte, cuja validade jurídica é garantida pela assinatura digital do emitente e autorização
de uso pela administração tributária da unidade federada do contribuinte.
O MDF-e deverá ser emitido por empresas prestadoras de serviço de transporte para prestações com mais de um
conhecimento de transporte ou pelas demais empresas nas operações, cujo transporte seja realizado em veículos
próprios, arrendados, ou mediante contratação de transportador autônomo de cargas, com mais de uma nota
fiscal. A finalidade do MDF-e é agilizar o registro em lote de documentos fiscais em trânsito e identificar a unidade
de carga utilizada e demais características do transporte. Autorização de uso do MDF-e implicará em registro
posterior dos eventos, nos documentos fiscais eletrônicos nele relacionados”.

6.4.1 Parametrizações Específicas

Para enviar um arquivo .XML de um MDF-e, é necessário realizar as seguintes parametrizações por Filial (menu “
Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Integrações >> Fiscal >> Dados Fiscais
>> Parâmetros por Filial ”)
 Marcar o item ‘Todos’ ou ‘Envio MDF-e’ na aba ‘Informações TOTVS Colaboração’ (ver item 3.2 –
Parametrização por Filial );
 Preencher corretamente a aba ‘Ambiente MDF-e’

Figura 28 – Tela Parâmetros por Filial – MDF-e

Versão 1.0 33
TOTVS Colaboração 2.00

Título do documento
6.4.2 Envio de MDF-e

O envio do MDF-e é realizado através da seguintes etapa:

2. Executar o processo ‘Enviar MDF-e’ através do menu “Vendas >> Faturamento >> Manisfesto Eletrônico
Documentos Fiscais (MDF-e)”.

Para realizar o envio, deve-se selecionar o movimentos criado, à partir do filtro da tela a ser exibida:

Figura 29 – Seleção de movimento de MDF-e para envio

Após o envio, o registro irá assumir o status ‘Pendente’, caso não ocorra nenhum erro de validação. Neste
momento, arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid. Este, por sua vez,
se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação junto à SEFAZ.

Caso ocorra algum problema ao enviar o MDF-e devido à alguma informação incorreta/inválida, o registro
receberá o status de ’Inconsistente’. Neste caso, o movimento deve ser corrigido, e o processo de envio deve
ser realizado novamente.

Após o envio, os sistema irá aguardar o retorno da SEFAZ, realizado por intermédio da Neogrid. Através do
retorno, os status do MDF-e serão atualizados. A MDF-e poderá assumir os seguintes status, que irão indicar a
aprovação ou não do mesmo pela SEFAZ:
 Autorizado: indica queoa MDF-e foi aprovada pela SEFAZ;
 Rejeitado: indica que o MDF-e não foi autorizado pela SEFAZ. Neste caso, o movimento criado pode
ser corrigido e reenviado

34 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Todos os status acima são atualizados pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo
ClientEDI da Neogrid.

Os arquivos .XMl MDF-e enviados são iniciados pela numeração 360.

6.4.3 Envio de MDF-e em contingência

A emissão do MDF-e em modo de contingência deve ser utilizada quando existe algum problema (webservice
inoperante, falha de comunicação com a web, etc) que impeça o envio do documento à SEFAZ. Após a emissão em
contingência, impressão do “DAMDFE – Documento Auxiliar de Manifesto Eletrônico de Documentos Fiscais” pode
ser realizado para que seja liberado o transporte das mercadorias enquanto a comunicação com a SEFAZ não é
restabelecida.

Para utilizar o modo de contingência é necessário parametrizar o ambiente de MDF-e da Filial ( menu “ Ambiente
>> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Integrações >> Fiscal >> Dados Fiscais >>
Parâmetros por Filial ”) para a “Modalidade de Operação” igual a “Contingência Offline” e enviar o documento
pelo processo “Gerar DAMDFE em Contingência”.

Figura 30 – Tela Parâmetros por Filial – CT-e em contingência

Versão 1.0 35
TOTVS Colaboração 2.00

Título do documento

Figura 31 – Envio de MDF-e em contingência

Importante: Após a regularização da falha deve-se voltar a parametrização da “Modalidade de Operação” do


ambiente do MDF-e da Filial para “Normal”. Na visão de MDF-es emitidos (em “Vendas >> Faturamento >>
Manisfesto Eletrônico Documentos Fiscais (MDF-e)“ ), selecionar o registro do MDF-e emitido em contingência e
efetivar o envio do documento à SEFAZ através do processo “Enviar MDF-e”, com a justificativa da emissão em
modo de contingência preenchida.

6.4.4 Encerramento de MDF-e

Um MDF-e deve ser encerrado quando o percurso do transporte chegar ao final, ou quando houver qualquer
alteração nas informações do MDF-e (veículo, carga, documentação ,etc) no decorrer do transporte.

Enquanto houver MDF-e pendente de encerramento não será possível autorizar um novo MDF-e para o mesmo
UF de carregamento e UF de descarregamento, e para o mesmo veículo.

Para realizar o encerramento , deve-se acessar o processo ‘Enviar Evento MDF-e’, opção ‘Encerramento’, em
“Vendas >> Faturamento >> Manisfesto Eletrônico Documentos Fiscais (MDF-e)“, informando no campo texto o
motivo do encerramento. Após o preenchimento , basta clicar em ‘Executar’.

36 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Figura 32 – Tela de Envio de Evento do MDF-e

Após o envio do evento, o arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid.
Este,por sua vez, se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação
junto à SEFAZ.

Enquanto aguarda o retorno o retorno da SEFAZ, realizado por intermédio da Neogrid, o registro do MDF-e recebe
o status ‘Evento Pendente’. Após o retorno , o movimento recebe o status ‘Encerrado’ se o encerramento for
aceito. Caso contrário, o movimento volta ao status ‘Autorizado’.

A atualização dos registros será realizado pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo ClientEDI
da Neogrid.

Para verificar o resultado do processamento enviado/recebido, é necessário verificar em “Anexos >> Historico de
MDF-e ”

Os arquivos .XML de Encerrameto de MDF-e enviados são iniciados pela numeração 361.

Versão 1.0 37
TOTVS Colaboração 2.00

Título do documento

Figura 33 – Tela de Acompanhamento de MDF-e

Importante: Todo MDF-e deve ser encerrado dentro de 30 (trinta) dias após ser autorizado.

6.4.5 Cancelamento de MDF-e

Um MDF-e pode ser cancelado somente se já houver sido autorizado previamente pela SEFAZ, e para o qual ainda
não tenha ocorrido o início do transporte.

Para realizar o cancelamento, deve-se acessar o processo ‘Enviar Evento MDF-e’, opção ‘Cancelamento’, em
“Vendas >> Faturamento >> Manisfesto Eletrônico Documentos Fiscais (MDF-e)“, informando no campo texto o
motivo do cancelamento. Após o preenchimento , basta clicar em ‘Executar’ .

Após o envio do evento, o arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid.
Este,por sua vez, se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação
junto à SEFAZ.

Enquanto aguarda o retorno o retorno da SEFAZ, realizado por intermédio da Neogrid, o registro do MDF-e recebe
o status ‘Evento Pendente’. Após o retorno , o movimento recebe o status ‘Cancelado’, se o cancelamento for
aceito. Caso contrário, o movimento volta ao status ‘Autorizado’.

A atualização dos registros será realizada pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo ClientEDI
da Neogrid.

Para verificar o resultado do processamento enviado/recebido, é necessário verificar em “Anexos >> Historico de
MDF-e ”

Atenção: o prazo para cancelamento do MDF-e é 24 hrs após sua emissão.

38 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Os arquivos .XML de cancelamento de MDF-e enviados são iniciados pela numeração 362.

6.4.6 Inclusão de condutor

A inclusão de condutor do veículo do MDF-e rodoviário é a única alteração que pode ser realizada no mesmo sem
que seja necessário o cancelamento .

Para incluir um condutor, deve-se acessar o processo ‘Enviar Evento MDF-e’, opção ‘Inclusão de Condutor’, em
“Vendas >> Faturamento >> Manisfesto Eletrônico Documentos Fiscais (MDF-e)“, informando o nome e o CPF.
Após o preenchimento , basta clicar em ‘Executar’.

Figura 34 – Tela de Envio de Evento do MDF-e

Após o envio do evento, o arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid.
Este,por sua vez, se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação
junto à SEFAZ.

Enquanto aguarda o retorno o retorno da SEFAZ, realizado por intermédio da Neogrid, o registro do MDF-e recebe
o status ‘Evento Pendente’. Após o retorno , o movimento recebe o status ‘Autorizado’.

A atualização dos registros será realizada pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo ClientEDI
da Neogrid.

Versão 1.0 39
TOTVS Colaboração 2.00

Título do documento
Para verificar o resultado do processamento enviado/recebido, é necessário verificar em “Anexos >> Historico de
MDF-e ”

40 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

6.5 NFS-e

A Nota Fiscal Eletrônica NFS-e é um documento de existência exclusivamente digital , gerado e armazenado
eletronicamente pela prefeitura ou por outra entidade conveniada, para documentar as operações de prestação
de Serviços.
A geração da NFS-e será feita, automaticamente por meio de serviços informatizados, disponibilizados aos
contribuintes pelas prefeituras. Para que sua geração seja efetuada, dados que compõem serão informados,
analisados, processados , validados e, se corretos, gerarão o documento.
A responsabilidade pelo cumprimento da obrigação acessória de emissão da NFS-e e pelo correto fornecimento
dos dados à secretaria, para a geração da mesma, é do contribuinte.

6.5.1 Parametrizações Específicas

Para receber ou enviar um arquivo .XML de uma NFS-e, é necessário realizar as seguintes parametrizações:
 Classificação de Município e País em “ Ambiente >> Parâmetros >> Gestão de Estoque, Compras e
Faturamento” >> Integrações >> Fiscal >> Dados Fiscais”:
o Aba ‘Classificação IBGE Município’: esse parâmetro será utilizado para gerar o código do município
do Prestador, Tomador e quaisquer outros códigos de municípios constantes no XML/TXT da NFS-
e. Esta tabela é proveniente do IBGE, e deve ser criada, preenchida e associada manualmente no
cadastro de municípios. A incorreta classificação dos municípios acarretará a rejeição da NFS-e.
o Aba ‘Classificação Pais Bacen’: este parâmetro será utilizado para gerar do país envolvido no
processo de NFS-e. Esta tabela é proveniente do Banco Central do Brasil (BACEN), e deve ser
criada, preenchida e associada manualmente no cadastro de municípios. A incorreta classificação
dos municípios acarretará a rejeição da NFS-e.

Figura 35 – Tela de parâmetros fiscais - NFS-e

Versão 1.0 41
TOTVS Colaboração 2.00

Título do documento
 Parametrização por Filial (menu “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento”
>> Integrações >> Fiscal >> Dados Fiscais >> Parâmetros por Filial ”).
o Marcar o item ‘Todos’ ou ‘Recebimento de NFS-e’ e/ou ‘Envio NFS-e’ na aba ‘Informações TOTVS
Colaboração’ (ver item 3.2 – Parametrização por Filial );
o Preencher corretamente o quadro NFS-e Municipal (Modelo Nacional) nas abas ‘Conexão NF-e’ e
‘Ambiente NF-e’.

Figura 36 – Tela de parâmetros por filial - NFS-e

6.5.2 Recebimento de NFS-e

O processamento de recebimento de NFS-e é realizado através das seguintes etapas:

4. Importação dos arquivos XML disponibilizados pelo ClientEDI NeoGrid, através do processo “Importação
de arquivos – TOTVS Colaboração “ (ver item 4 – Jobs);
5. Inclusão do arquivo .XML nas tabelas do sistema, através do processo “Serviço TOTVS Colaboração
Consulta” (ver item 4 – Jobs);
6. Inclusão do movimento específico referenciando o XML cadastrado, através do processo “Inclusão de
movimento com arquivo XML”, no menu “ Compras >> Recebimento de Materiais ” .

42 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Figura 37 – Inclusão de NFS-e através de importação do .XML

Atenção: Para que que a opção “Inclusão de movimento com arquivo XML” seja habilitada, é necessário que o
tipo de movimento selecionado esteja parametrizado para ‘Recebimento NFS-e’. A parametrização deve ser
realizada em “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Gestão de compras >>
Recebimento de Materiais >> TOTVS Colaboração ”.

Figura 38 – Parametrização do movimento para Recebimento NFS-e

Os arquivos .XMl de Nota fiscal de Serviço (NFS-e) recebidos são iniciados pela numeração 319.

Versão 1.0 43
TOTVS Colaboração 2.00

Título do documento

6.5.3 Envio de NFS-e

Para obter a permissão para envio de uma NFS-e , é necessário criar um RPS (Recibo Provisório de Serviços). Deverá
ser criado um movimento de RPS, que irá conter todas as informações exigidas pela prefeitura.

O tipo de movimento de RPS deve ser 2.1.XX ( Pedido) , e parametrizado com a opção ‘Gera Movimento de Venda’
habilitado ( menu “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento” >> Vendas >> Pedidos
de venda >> Compra/Venda - Características “)

Figura 39 – Parametrização do tipo de movimento RPS

Após a criação do movimento, o envio de NFS-e é realizado através das seguintes etapas:

3. Executar o processo ‘Enviar NF-e’ através do menu “Vendas >> Faturamento >> SPED NF-e (Municipal)”,
4. Selecionar o(s) movimento(s) criados(s) através do filtro da tela exibida, e clicar em ‘Executar’.

Após o envio, o registro irá assumir o status ‘Pendente’, caso não ocorra nenhum erro de validação. Neste
momento, arquivo .XML será criado e disponibilizado para envio pelo ClientEDI da NeoGrid. Este, por sua vez,
se encarregará de resgatar o arquivo criado automaticamente, e realizar o envio para validação junto à
Prefeitura parametrizada para a Filial.

44 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

Caso ocorra algum problema ao enviar o RPS devido à alguma informação incorreta/inválida, o registro
receberá o status de ’Inconsistente’. Neste caso, o movimento deve ser corrigido, e o processo de envio deve
ser realizado novamente.

Após o envio, os sistema irá aguardar o retorno da Prefeitura, realizado por intermédio da Neogrid. Através
do retorno, o status de envio do RPS será atualizado. O registro poderá assumir os seguintes status, que
irão indicar a aprovação ou não do mesmo pela SEFAZ:
 Autorizada: indicar que o RPS enviado para a Prefeitura foi autorizado com sucesso e convertido em
NFS-e. O movimento será atualizado com o Número da NFS-e (gerado pela prefeitura), Código de
Verificação (para consulta da nota no Site) e XML da NFS-e assinado;
 Rejeitada: indica que o RPS enviado não foi autorizado e não foi convertido em NFS-e pela Prefeitura;

Todos os status acima são atualizados pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo
ClientEDI da Neogrid.

Atenção: Para o envio , é necessário que o tipo de movimento selecionado esteja parametrizado para ‘Envio
de NF-e’. A parametrização deve ser realizada em “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e
Faturamento” >> Vendas >> Pedidos de venda >> TOTVS Colaboração ”.

Figura 40 – Parametrização do movimento para Envio de NFS-e

Os arquivos de Nota fiscal de Serviço (NFS-e) criados para envio são inciados pela numeração 203.

Versão 1.0 45
TOTVS Colaboração 2.00

Título do documento
Quando o sistema recebe o retorno informado que o RPS enviado foi autorizado, os sistema realiza as
seguintes ações:
 O registro de envio do RPS é atualizado com o número da NFS-e e o código de verificação. O XML da NFS-
e também passa a ser exibido:

Figura 41 – Dados da NFS-e enviados pela prefeitura

 O pedido gerado ( movimento 2.1.XX) recebe o status de ‘Faturado’


 É gerado automaticamente um movimento de NFS-e ( do tipo 2.2.XX) que irá receber o número da nota
enviada pela prefeitura.

Atenção: caso o cliente não deseje que sejam criados dois movimentos (2.1.XX – RPS e 2.2.XX – NFS-e ) ,basta
criar diretamente a NFS-e e enviá-la pelo mesmo processo. Não será necessário, nesta situação, a
parametrização ‘Gera movimento de Venda’ citada acima. Vale ressaltar, entretanto, que a nota gerada irá
conter a numeração criada pelo próprio sistema, e não o número gerado pela Prefeitura.

6.5.4 Cancelamento de NFS-e

O cancelamento é permitido apenas para NFs-e’s com o status ‘Autorizada’. Para realizar o cancelamento,
deve-se acessar o processo ‘Cancelar NFS-e’, em “Vendas >> Faturamento >> SPED NF-e (Municipal) >>
Processos >> Cancelar NFS-e”.

Após o cancelamento , a NFS-e irá receber temporariamente o status ‘Cancelamento Pendente’. Após o
retorno da prefeitura, realizado por intermédio da Neogrid, ele poderá receber dois status:

46 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

 Cancelada: indica que a solicitação de cancelamento foi aceita, e que a NFS-e foi cancelada. O registro
é atualizado com o .XML de cancelamento assinado pela prefeitura.
 Autorizada: indica que a solitação de cancelamento foi rejeitada. Neste caso, a NFS-e volta ao status
original e nada acontecerá com o movimento que a originou.

Todos os status acima são atualizados pelo Job de consulta do TOTVS Colaboração (processo “Serviço TOTVS
Colaboração Consulta” – ver item 4 – Jobs), que é responsável por resgatar o retorno disponibilizado pelo
ClientEDI da Neogrid.

Os arquivos .XML de Cancelamento de NFS-e enviados são iniciados pela numeração 204.

6.5.5 Substituição de NFS-e

Há casos em que o cliente necessita simplesmente trocar a NFS-e ainda que válida, mas emitida com
algum dado incorreto. Nesses casos, a NFS-e emitida com erros pode ser simplesmente substituída
por outra NFS-e. A original será cancelada pela Prefeitura e a nova NFS-e tomará o seu lugar, registrando
um vínculo entre a NFS-e substituta e a NFS-e substituída.

Atenção: estes procedimentos não se aplicam a NFS-e Belo Horizonte. Para saber os procedimentos
específicos para substituição em Belo Horizonte, veja em
http://www.tdn.TOTVS.com/pages/releaseview.action?pageId=65209914

Para realizar a substituição, o tipo de movimento do RPS ( tipo 2.1.XX) deve ser parametrizado para ‘Edita
Movimento Relacionado’ em “Ambiente >> Parâmetros >> Gestão de Estoque, Compras e Faturamento”
>> Vendas >> Pedidos de venda >> Mov – Outros dados ”.

Figura 42 – Parametrização do movimento para substituição de NFS-e

Versão 1.0 47
TOTVS Colaboração 2.00

Título do documento
Após a parametrização, é necessário gerar um novo movimento do tipo 2.1.XX para substituição do anterior.
Ao criar o novo movimento, será aberto um campo, na aba ‘Identificação’ no quadro ‘Numeração’, para que
seja informado o número do movimento (RPS) a ser substituído. Antes de salvar, devem ser realizadas no
movimento as correções necessárias que levaram a substituição da NFS-e.

Figura 43 – Criação de movimento para substituição de NFS-e

Após a criação do novo movimento, deve-se realizar o envio do mesmo ( ver o item 6.5.3 - Envio de NFS-e).
Enquanto o sistema aguarda o retorno da aprovação da substituição pela prefeitura, o registro criado recebe o
status ‘Pendente’, e a NFS-e a ser substituída recebe o status ‘Cancelamento pendente’. Após a aprovação, a nova
NFS-e recebe o status ‘Autorizada’ e a NFS-e substituída (assim com o movimento de RPS que a originou) recebem
o status ‘Cancelada’. Caso a substituição não seja aprovada, a nova NFS-e recebe o status ‘Rejeitada’ e a NFS-e
que seria substituída volta para o status ‘Autorizada’.

Os arquivos de Nota fiscal de Serviço (NFS-e) criados para envio são inciados pela numeração 203.

48 Versão 1.0
TOTVS Colaboração 2.00 – CT-e

7. Informações Técnicas

7.1 Alterações Estruturais no Banco de Dados

Para que o ERP TOTVS Linha RM utilize a integração “TOTVS Colaboração 2.00” foi necessário incluir campos no
banco de dados na tabela “TPAR”:

Novos Campos TPAR Descrição / Conteúdo Tipo Tamanho


DIRETORIOTOTVSCOLAB Diretório de XML - TOTVS Colaboração versão 2.00 Varchar 255
VERSAOTOTVSCOLAB Versão TOTVS Colaboração Varchar 10

Foi criada a tabela “TXMLCOLAB – Xml de Integração com o NeoGrid Client” para armazenamento provisório dos
XMLs lidos pelo ERP através da execução de JOB de modo a serem processados e atualizados os respectivos dados
no ERP, objetivando melhor performance para o processamento dos documentos.

Campos TXMLCOLAB Descrição / Conteúdo Tipo Tamanho Chave


IDXMLCOLAB Identificador Int 4 Sim
CODCOLIGADA Código da Coligada Int 4 Sim
NOMEARQUIVO Nome do arquivo retornado pela NeoGrid Varchar 100
MODELOARQUIVO Modelo do arquivo Int 4
SEQUENCIAL Sequencial do arquivo retornado pela NeoGrid Int 4
XML XML retornado pela NeoGrid Varchar -1
LOG Log de Erro do XML Varchar 2000
STATUS Status do XML Varchar 1

Houve adequação também na tabela “TPARFILIAL” para informar Versão de Evento de documentos CT-e e MD-e:

Novos Campos TPARFILIAL Descrição / Conteúdo Tipo Tamanho


VERSAOEVENTOCTE Versão do Evento do CT-e Varchar 10
VERSAOEVENTOMDE Versão do Evento do MD-e Varchar 10

7.2 Tabelas Envolvidas

 GCOLIGADA – Coligadas
 GFILIAL – Filiais
 TPAR – Parâmetros Gerais
 TPARFILIAL – Parâmetros por Filial
 FCFO – Clientes/Fornecedores
 TTMV – Tipos de Movimento
 TCTEMOV – Tabela Base do CT-e
Observação: Coluna Tipo: “C” = CT-e; “M” = MDF-e
 TMOV – Movimentos
 TCTE – Conhecimento de Transporte Eletrônico CT-e

Versão 1.0 49
TOTVS Colaboração 2.00

Título do documento
 TCTEHISTORICO – Histórico de CT-e
 TCTRC – Notas Fiscais Conhec.Transporte
 TCTESEGURO – Dados do Seguro do CT-e
 TCTEEMISSOR – Dados do Emissor de Docs Anteriores CT-e
 TCTEDOC – Dados dos Documentos Anteriores CT-e
 TVEICULOS – Veículos
 TXMLCOLAB – Xml de Integração com o NeoGrid Client
 TMOVTRANSP – Dados de Transporte
 TVAGAO – Cadastro de Vagões
 TCTEINUT – Inutilização do CT-e
 DNATUREZA – Naturezas Fiscais
 TNFEESTADUAL – Nota fiscal eletrônica
 TNFEESTADUALHIST – Histórico da NF-e
 TNFEMUNICIPAL – Nota Fiscal de Serviço eletrônica
 TNFEMUNICIPALHIST – Histórico da NFS-e
 TNFEESTADUALEVENT – Eventos da NF-e
 TNFEESTADUALEVENTHIST – Histórico de Eventos da NF-e

50 Versão 1.0

Potrebbero piacerti anche