O que é e para que serve
A importação de MDF-e (Manifesto Eletrônico de Documentos Fiscais) no Deploy Agent traz para o Sankhya Om os manifestos rodoviários que o cliente já emitiu, junto com os eventos vinculados a eles. Cada manifesto vira uma viagem com motoristas, veículo e documentos transportados.
Use este artigo para importar os manifestos, conferir o resultado e tratar os alertas do log.
A importação não emite nem transmite MDF-e à SEFAZ (Secretaria da Fazenda). Ela também não importa:
- MDF-e de terceiros;
- arquivos do ambiente de homologação;
- manifestos dos modais aéreo, aquaviário e ferroviário.
Antes de começar
Peça ao cliente, junto com os XMLs de MDF-e, os XMLs de CT-e (Conhecimento de Transporte Eletrônico) e de NF-e (Nota Fiscal Eletrônica) referenciados pelos manifestos. O MDF-e depende desses documentos. Você pode enviar tudo no mesmo lote, porque o Deploy Agent define a ordem de processamento.
Peça também os XMLs de evento dos manifestos: cancelamento, encerramento, inclusão de condutor, inclusão de DF-e (Documento Fiscal Eletrônico) e pagamento da operação de transporte. Sem esses eventos, manifestos cancelados ou encerrados na SEFAZ ficam em aberto no Sankhya Om.
Importar os MDF-e
- Insira no repositório os XMLs de MDF-e, de CT-e e de NF-e, além dos XMLs de evento.
- Acesse o seu ambiente do Sankhya Om e siga o caminho Menu do sistema › Configurações › Rotinas › Assistente de Melhores Práticas.
- Clique no botão Deploy Agent, localizado no canto superior direito.
- Clique em Reprocessar.
- Marque os modelos MDF-e, CT-e e NF-e, e marque Buscar novos arquivos no repositório.
- Clique em Confirmar.
- Acompanhe o indicador de status até ficar Concluído. Para saber mais, confira o artigo Conheça o Deploy Agent.
Os eventos são aplicados no fim da busca de arquivos. Eles não são aplicados enquanto houver arquivo EFD (Escrituração Fiscal Digital) pendente.
ℹ️ Nota
Se um MDF-e parou porque faltava o CT-e ou uma NF-e, envie o documento que faltava e reprocesse só aquele arquivo na aba Arquivos processados, com o botão Reprocessar Registro. Esse reprocessamento não aplica eventos: se o MDF-e tiver eventos, faça uma nova busca de arquivos em seguida.
Conferir o resultado
- Na tela do Deploy Agent, abra a aba Detalhamento Doc. Fiscais.
- Clique no cartão Manifesto Eletrônico de Doc. Fiscais para abrir a tela Viagens de Transporte (MDF-e). A tela abre sem filtro.
- Abra algumas viagens e confira os motoristas, o veículo, os documentos vinculados, a situação do MDF-e (autorizado, cancelado ou encerrado) e os pagamentos do frete.
ℹ️ Nota
Para abrir a viagem de um arquivo específico, acesse a aba Arquivos processados, selecione o MDF-e e clique em Ver Notas.
Atenção: O campo Ambiente MDF-e fica como Produção. Se a empresa precisar emitir MDF-e em homologação antes de entrar em produção, altere o campo manualmente no cadastro da empresa.
Tratar alertas do log
- Abra a aba Arquivos processados.
- Filtre o Tipo de documento MDF-e e o Status Erro. Se o arquivo não aparecer na lista, filtre pelo nome do arquivo.
- Selecione o arquivo e clique em Ver Log.
- Localize a mensagem nas tabelas abaixo e siga a ação indicada. Os trechos entre colchetes, como [chave], são substituídos pelos dados do arquivo.
Manifesto e cadastros
| Mensagem no log | O que significa | O que fazer |
|---|---|---|
| "CT-e não encontrado na base. Chave do CT-e: [chave]" | O CT-e referenciado pelo MDF-e não está no Sankhya Om. O MDF-e não foi importado. | Envie o CT-e e reprocesse o MDF-e. |
| "Nenhum documento encontrado para este MDFe." | O MDF-e não é de carga própria e não referencia nenhum CT-e. | Confira o XML com o cliente. |
| "Tipo de Modal [código] não implementado para MDFe." | O MDF-e não é do modal rodoviário. | Nenhuma ação necessária: só o modal rodoviário é importado. |
| "Documento não é de emissão própria." | O emitente não corresponde a nenhuma empresa do Sankhya Om. | Confira o CNPJ (Cadastro Nacional da Pessoa Jurídica) do emitente com o cliente. |
| "Arquivo ignorado: o XML '[arquivo]' pertence ao ambiente de homologação e não será importado." | O arquivo é do ambiente de homologação. | Nenhuma ação necessária. Envie só arquivos de produção. |
| "CPF do motorista ausente no XML" | O XML não traz o CPF (Cadastro de Pessoas Físicas) do motorista, ou o CPF é inválido. O motorista não foi cadastrado. | Confira o XML com o cliente. Se precisar do motorista, cadastre-o como parceiro motorista. |
| "Placa do veículo ausente no XML" | O XML não traz a placa. O veículo não foi cadastrado. | Confira o XML com o cliente. Se precisar do veículo, cadastre-o. |
| "CNPJ do responsável ausente em infResp e infContratante" | O XML não identifica o responsável. O MDF-e foi importado sem ele. | Se precisar do responsável, cadastre-o como parceiro. |
Empresa emitente
| Mensagem no log | O que significa | O que fazer |
|---|---|---|
| "RNTRC do MDF-e [número/série] ([valor XML]) diverge do cadastro da empresa ([valor cadastro]). Cadastro mantido." | A empresa já tinha outro RNTRC. | Confirme com o cliente qual é o correto e, se for o do XML, atualize o cadastro da empresa. |
| "RNTRC inválido no MDF-e [número/série]: [valor]. Cadastro da empresa não atualizado." | O RNTRC do XML não tem 8 dígitos numéricos. | Confirme o RNTRC com o cliente e preencha no cadastro da empresa. |
Eventos
| Mensagem no log | O que significa | O que fazer |
|---|---|---|
| "Evento de [tipo] sem MDF-e correspondente: [chave]" | O MDF-e do evento não foi enviado nem está no Sankhya Om. | Peça o XML do MDF-e ao cliente, envie-o e faça uma nova busca de arquivos. |
| "Evento de [tipo] não homologado pela SEFAZ: [chave] [código - motivo do retorno]" | A SEFAZ não homologou o evento. O MDF-e não foi alterado. | Confira com o cliente se existe uma versão homologada do evento e envie esse arquivo. |
| "MDF-e [chave] cancelado. Evento de [tipo] desconsiderado" | O MDF-e está cancelado e o evento não foi aplicado. | Nenhuma ação necessária. |
| "MDF-e consta como cancelado: [chave]" | O MDF-e foi cancelado na SEFAZ e não foi importado. | Nenhuma ação necessária. |
| "MDF-e [chave] já encerrado. Evento de cancelamento desconsiderado" | A SEFAZ não aceita cancelar um MDF-e encerrado. | Nenhuma ação necessária. |
| "Município de encerramento [código] não encontrado no ERP para o MDF-e [chave]" | O MDF-e foi encerrado, mas o município ficou vazio. | Cadastre o município e preencha manualmente o município de encerramento do MDF-e. |
| "CPF do condutor inválido no evento do MDF-e [chave]: [CPF]" | O condutor não foi cadastrado nem vinculado. | Confira o arquivo com o cliente. |
| "NF-e [chave] do evento de inclusão de DF-e não encontrada no ERP. Importe a NF-e e reprocesse o evento" | A NF-e ainda não está no Sankhya Om. As demais NF-e do evento foram vinculadas. | Envie a NF-e e faça uma nova busca de arquivos. |
| "Chave de NF-e inválida no evento de inclusão de DF-e do MDF-e [chave MDF-e]: [chave NF-e]" | Só essa NF-e ficou de fora. | Confira o arquivo com o cliente. |
| "Inclusão de DF-e válida apenas para MDF-e com carregamento posterior: [chave]" | O MDF-e não foi emitido com carregamento posterior. | Nenhuma ação necessária. |
| "CPF/CNPJ do responsável pelo pagamento inválido no evento do MDF-e [chave]: [documento]" | Nenhum pagamento foi registrado. | Confira o arquivo com o cliente. |
| "Não foi possível registrar o pagamento da operação de transporte do MDF-e [chave]" | Nada do evento foi gravado. | Faça uma nova busca de arquivos. Se a mensagem se repetir, acione o suporte da Sankhya. |
Regras da importação
Motoristas e veículos
O que o Deploy Agent cadastra depende do tipo de base do ambiente:
| Tipo de base | Motorista | Veículo |
|---|---|---|
| Prospecção | Só com os dados do XML: nome e CPF completo. A cidade é a da empresa cadastrada no Sankhya Om. Se a empresa não tiver cidade, é usado o município do emitente no XML e, na falta dele, a cidade padrão. | Só com os dados do XML, incluindo a placa. A cidade segue a mesma regra do motorista. |
| Cliente | Com os dados do XML, completados pela consulta do CPF em serviços externos. | Com os dados do XML, completados pela consulta da placa em serviços externos. A cidade vem da consulta ou, na falta dela, da cidade padrão. Se a consulta falhar, o veículo é cadastrado só com os dados do XML. |
Em base de prospecção, o Deploy Agent não consulta nenhum serviço externo para o MDF-e. Se os cadastros vierem com menos dados do que numa base cliente, esse é o comportamento esperado.
Motoristas e veículos que já existem são reaproveitados, sem duplicar o cadastro: o motorista pelo CPF e o veículo pela placa.
Contratante e responsável pelo seguro
Contratante: quando o XML não informa o CPF ou CNPJ do contratante e o veículo de tração não tem proprietário informado (frota própria), o Deploy Agent usa o próprio emitente como contratante. Se o contratante não for informado e o veículo tiver proprietário, o MDF-e não é importado.
Responsável pelo seguro: quando o responsável é o próprio emitente, o Deploy Agent usa o CPF ou CNPJ do emitente. Quando o MDF-e não traz o CNPJ do responsável no lugar principal, o Deploy Agent usa o CNPJ do contratante informado no grupo da ANTT (Agência Nacional de Transportes Terrestres) do modal rodoviário. Com o CNPJ em mãos, o Deploy Agent consulta os dados em serviços externos e cadastra o parceiro, se ele ainda não existir. Em base de prospecção, essa consulta não é feita.
Perguntas frequentes
Por que um MDF-e não aparece no cartão Manifesto Eletrônico de Doc. Fiscais?
As causas mais comuns: o CT-e não foi enviado, o MDF-e foi cancelado na SEFAZ, não é do modal rodoviário ou não é de emissão própria. Filtre o arquivo pelo nome na aba Arquivos processados e consulte o log.
Por que um MDF-e encerrado na SEFAZ aparece em aberto no Sankhya Om?
O XML do evento de encerramento não foi enviado ou ainda não foi aplicado. Envie o arquivo e faça uma nova busca de arquivos. Se houver EFD pendente, os eventos só são aplicados depois que ela for processada.
Posso enviar o mesmo evento de novo?
Sim. O Deploy Agent ignora o que já foi aplicado. A exceção é o evento de pagamento sem protocolo da SEFAZ, que é gravado de novo a cada envio e duplica os pagamentos.
Saiba mais
- Conheça o Deploy Agent: visão geral, abas, indicadores e arquivos processados.
- Enviar e reprocessar documentos fiscais: envio de arquivos, reprocessamento e tratamento de erros.
- Limites e dúvidas frequentes: pontos de atenção e perguntas frequentes sobre o Deploy Agent.
Comentários
0 comentário
Escreva seu comentário aqui
Por favor, entre para comentar.