O Fiscal Sync é um aplicativo que envia os arquivos de XML para a plataforma de Totvs Processos Fiscais e consulta a manifestação e os documentos fiscais no Fisco.
Para realizar o envio do XML é necessário que no Properties do Fiscal Sync esteja configurado com os diretórios de entrada, saída, processado e impressão (Manual de Instalação - Fiscal Sync):
- Diretório de Entrada: Arquivos que baixam do Totvs Processos Fiscais (TPF) ou do fisco.
- Diretório de Saída: Arquivos que o ERP envia para a plataforma Totvs Processos Fiscais.
- Diretório de Processado: Arquivos que a aplicação realiza a leitura do diretório de saída para enviar há plataforma totvs Processos Fiscais e move para o diretório processado.
- Diretório de Impressão: Caso utilize o Servidor de Impressão Local (SIL), são os arquivos do fluxo 170 (Emissão) são enviados para ser impresso no SIL. Se não utilizar o SIL apenas deixe o diretório em branco.
E o usuário deve ser do Tipo: Usuário de grupo.
Necessário também que no registro do estabelecimento no Totvs Processos Fiscais esteja cadastrado o certificado digital (Importar Certificado Digital).
Para realizar o envio da emissão da nota fiscal eletrônica é necessário adicionar a XML da NF-e que deseja autorizar no diretório de saída:
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 170: Arquivo de mensageria da NF-e para a SEFAZ.
- zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos)
- yyyy: Número aleatório ou o código da impressora cadastrado no Totvs Processos Fiscais (Caso utilize o SIL)- 7 dígitos
Ex. DataHora: 170_2020122155530305_905.xml
Ex. Chave de Acesso.: 170_35210282373077000265652480000032081352517279_SILPDF123.XML
Após validar a NF-e na SEFAZ é retornado a situação do documento, caso apresente erro a XML com a rejeição é apresentada no diretório de entrada:
Se a nota fiscal for autorizada, XML é apresentada com a assinatura e custodiada no Totvs Processos Fiscais:
A nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo 4 dígitos):
Para realizar o envio de cancelamento da NF-e é necessário adicionar a XML no diretório de saída com as seguintes informações:
<evento xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.00">
**<infEvento Id="ID110111XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX01">
<cOrgao>Código do órgão de recepção do Evento.</cOrgao>
<tpAmb>Identificação do Ambiente(1=Produção; 2=Homologação).</tpAmb
<CNPJ>CNPJ do Emitente</CNPJ>
<chNFe>Chave de acesso da NF-e</chNFe>
<dhEvento>Data e hora do evento no formato AAAA-MM-DDThh:mm:ssTZD (UTC - Universal Coordinated Time)</dhEvento>
<tpEvento>Código do evento: 110111 - “Cancelamento”; 110112 - “Cancelamento por substituição”</tpEvento>
<nSeqEvento>Sequencial do evento para o mesmo tipo de evento. Informar o valor “1” para este evento.</nSeqEvento>
<verEvento>Versão do evento</verEvento>
<detEvento versao="1.00">
<descEvento>Descrição do evento sem pontuação: Cancelamento</descEvento>
<nProt>Informar o número do Protocolo de Autorização da NF-e a ser cancelada.</nProt>
<xJust>Informar a justificativa do cancelamento</xJust>
</detEvento>
</infEvento>
</evento>
Campos | Detalhes | ||||||||
---|---|---|---|---|---|---|---|---|---|
**Id | ID + tpEvento + chNFe + nSeqEvento
|
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 171: Arquivo de cancelamento da NF-e
- zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex. Data/Hora: 171_2020122311295318_7443.xml
Ex. Chave de Acesso: 171_42210453113791000555552480000032061352515949_1234.xml
Após envio do arquivo para o Totvs Processos Fiscais, o retorno do XML com o cancelamento da NF-e é disponibilizado no diretório de entrada, a nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Para realizar a inutilização da numeração é necessário adicionar o XML no Diretório de saída com as seguintes informações:
<?xml version="1.0" encoding="UTF-8" ?><inutNFe versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe">
**<infInut Id="ID4220XXXXXXXXXXXXXX55008000001523000001530">
<tpAmb>Identificação do Ambiente (1=Produção; 2=Homologação)</tpAmb>
<xServ>Serviço solicitado: ‘INUTILIZAR’</xServ>
<cUF>Código da UF do solicitante</cUF>
<ano>Ano de inutilização da numeração</ano>
<CNPJ>CNPJ do Emitente</CNPJ>
<mod>Modelo do documento (55)</mod>
<serie>Série da NF-e</serie>
<nNFIni>Número da NF-e inicial a ser inutilizada</nNFIni>
<nNFFin>Número da NF-e final a ser inutilizada</nNFFin>
<xJust>Informar a justificativa do pedido de inutilização</xJust>
</infInut>
</inutNFe>
Campos | Detalhes | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
**Id | ID + cUF+ ano+ CNPJ + mod + serie + nNFIni + nNFFin
|
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 172: Arquivo de inutilização
- zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex.: 172_20201223145645289_7270.xml
Após envio do arquivo para o Totvs Processos Fiscais, o retorno do XML é disponibilizado no diretório de entrada, a nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Para realizar a consulta da chave de acesso da NF-e é necessário adicionar o XML no diretório de saída com as seguintes informações:
<?xml version="1.0" encoding="UTF-8"?>
<consSitNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">
<tpAmb>Identificação do Ambiente(1=Produção; 2=Homologação)</tpAmb>
<xServ>CONSULTAR</xServ>
<chNFe>Chave de Acesso da NF-e</chNFe>
</consSitNFe>
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 206: Arquivo de consulta por chave de acesso
- zzz: Chave de Acesso ou DataHora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex. DataHora: 206_20201015194716243_5070.xml
Ex. Chave de Acesso: 206_42210453113791000123552480000032061352515948_1569.xml
Após envio do arquivo para o Totvs Processos Fiscais, o retorno do XML com a situação da NF-e é disponibilizado no diretório de entrada, a nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Para consultar a situação da NF-e por chave de acesso, é necessário que o CNPJ associado cadastrado no grupo esteja cadastrado com o certificado digital no Totvs Processos Fiscais.
Para realizar o envio da carta de correção é necessário adicionar o XML no diretório de saída com as seguintes informações:
<infEvento Id="ID110110XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXYY">
<cOrgao>Código do órgão de recepção do Evento</cOrgao>
<tpAmb>Identificação do Ambiente: 1 - Produção ou 2 – Homologação</tpAmb>
<CNPJ>Informar o CNPJ do autor do Evento</CNPJ>
<chNFe>Chave de Acesso da NF-e vinculada ao Evento</chNFe>
<dhEvento>Data e hora do evento no formato AAAA-MMDDThh</dhEvento>
<tpEvento>110110</tpEvento>
<nSeqEvento>Sequencial do evento para o mesmo tipo de evento.</nSeqEvento>
<verEvento>Versão do evento</verEvento>
<detEvento versao="1.00">
<descEvento>Carta de Correcao</descEvento>
<xCorrecao>Correção a ser considerada, texto livre. A correção mais recente substitui as anteriores.</xCorrecao>
<xCondUso>Condições de uso da Carta de Correção, informar a literal : “A Carta de Correção é disciplinada pelo § 1º-A do art. 7º do Convênio S/N, de 15 de dezembro de 1970 e pode ser utilizada para regularização de erro ocorrido na emissão de documento fiscal, desde que o erro não esteja relacionado com: I - as variáveis que determinam o valor do imposto tais como: base de cálculo, alíquota, diferença de preço, quantidade, valor da operação ou da prestação; II - a correção de dados cadastrais que implique mudança do remetente ou do destinatário; III - a data de emissão ou de saída.” (texto com acentuação) ou “A Carta de Correcao e disciplinada pelo paragrafo 1o-A do art. 7o do Convenio S/N, de 15 de dezembro de 1970 e pode ser utilizada para regularizacao de erro ocorrido na emissao de documento fiscal, desde que o erro nao esteja relacionado com: I - as variaveis que determinam o valor do imposto tais como: base de calculo, aliquota, diferenca de preco, quantidade, valor da operacao ou da prestacao; II - a correcao de dados cadastrais que implique mudanca do remetente ou do destinatario; III - a data de emissao ou de saida.” (texto sem acentuação)</xCondUso>]
</detEvento>
</infEvento>
Campos | Detalhes | ||||||||
---|---|---|---|---|---|---|---|---|---|
**Id | ID + tpEvento + chNFe + nSeqEvento
|
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 301: Arquivo de solicitação para carta de correção
- zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex. DataHora: 301_20200506134620596_1230.xml
Ex. Chave de Acesso: 301_3521058237307700033355247000005248135251727108_1242.xml
O retorno do fisco é disponibilizado no Totvs Processos Fiscais, onde o Fiscal Sync disponibiliza o consumo do XML para os sistemas externos dentro do diretório de entrada configurado no properties. A nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Para realizar o envio da manifestação do destinatário é necessário adicionar o XML no diretório de saída com as seguintes informações:
Campos | Detalhes | ||||||||
---|---|---|---|---|---|---|---|---|---|
Id | ID + tpEvento + chNFe + nSeqEvento
| ||||||||
cOrgao | Código do órgão de recepção do Evento. O código 91 para identificar o Ambiente Nacional. | ||||||||
tpAmb | Identificação do Ambiente: 1=Produção; 2=Homologação. | ||||||||
CNPJ | CNPJ do Destinatário | ||||||||
chNFe | Chave de acesso da NF-e | ||||||||
dhEvento | Data e hora do evento no formato AAAA-MM-DDThh:mm:ssTZD (UTC - Universal Coordinated Time) | ||||||||
tpEvento | Código do evento: - 210200 – Confirmação da Operação; - 210210 – Ciência da Operação; - 210220 – Desconhecimento da Operação; - 210240 – Operação não Realizada. | ||||||||
nSeqEvento | Sequencial do evento para o mesmo tipo de evento. Informar o valor “1” para este evento. | ||||||||
verEvento | Versão do evento | ||||||||
descEvento | Descrição da manifestação SEM PONTUAÇÃO. Ex.: Confirmacao da Operacao |
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 320: Arquivo de solicitação para manifestação do documento
- zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex. Data/Hora: 320_20200914134620596_8170.xml
Ex. Chave de Acesso: 320_35210482373077000333552480000032131352517271_2021
O retorno do fisco é disponibilizado no Totvs Processos Fiscais, onde o Fiscal Sync disponibiliza o consumo do XML para os sistemas externos dentro do diretório de entrada configurado no properties. A nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Se a nomenclatura do arquivo não constar como informado no documento, arquivo é ignorado no fiscal sync.
IMPORTANTE!
Para realizar o envio da emissão do Manifesto Eletrônico de Documentos Fiscais, é necessário adicionar o XML da MDF-e que deseja autorizar no diretório de saída:
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 360: Arquivo de mensageria da MFD-e para o SEFAZ.
- zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos)
- yyyy: Número aleatório ou o código da impressora cadastrado no Totvs Processos Fiscais (Caso utilize o SIL)- 7 dígitos
Ex. DataHora: 360_2021092155530305_905.xml
Ex. Chave de Acesso.: 360_35210912345678912345580550000701261780093193_1234.xml
Após validar a NF-e na SEFAZ é retornado a situação da nota, caso apresente erro o XML com a rejeição é apresentada no diretório de entrada:
Se a nota fiscal for autorizada, XML é apresentado com a assinatura e custodiada no Totvs Processos Fiscais
A nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Para realizar o envio do encerramento do MDF-e é necessário adicionar o XML no diretório de saída com as seguintes informações:
<eventoMDFe versao="3.00" xmlns="http://www.portalfiscal.inf.br/mdfe">
<infEvento Id="ID110112XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXYY">
<cOrgao>Código do órgão de recepção do Evento</cOrgao>
<tpAmb>Identificação do Ambiente: 1 - Produção ou 2 – Homologação</tpAmb>
<CNPJ>Informar o CNPJ do autor do Evento</CNPJ>
<chMDFe>Chave de Acesso do MDF-e vinculada ao Evento</chMDFe>
<dhEvento>Data e hora do evento no formato AAAA-MMDDThh</dhEvento>
<tpEvento>110112</tpEvento>
<nSeqEvento>Sequencial do evento para o mesmo tipo de evento</nSeqEvento>
<detEvento versaoEvento="3.00">
<evEncMDFe>
<descEvento>Encerramento</descEvento>
<nProt>Informar o número do Protocolo de Autorização do MDF-e a ser cancelada</nProt>
<dtEnc>Data do encerramento</dtEnc>
<cUF>Código da UF do emitente do Documento Fiscal</cUF>
<cMun>Código do Município de Ocorrência do Fato Gerador</cMun>
</evEncMDFe>
</detEvento>
</infEvento>
</eventoMDFe>
Campos | Detalhes | ||||||||
---|---|---|---|---|---|---|---|---|---|
**Id | ID + tpEvento + chNFe + nSeqEvento
|
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 361: Arquivo de solicitação de encerramento
- zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex. Data/Hora: 361_20200506134620596_1230.xml
Ex. Chave de Acesso: 361_35211058237307700033580330000000311780093199_1242.xml
O retorno do fisco é disponibilizado no Totvs Processos Fiscais, onde o Fiscal Sync disponibiliza o consumo do XML para os sistemas externos dentro do diretório de entrada configurado no properties. A nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Para realizar o envio de cancelamento do Manifesto Eletrônico de Documentos Fiscais é necessário adicionar o XML no diretório de saída com as seguintes informações:
Campos | Detalhes | ||||||||
---|---|---|---|---|---|---|---|---|---|
**Id | ID + tpEvento + chNFe + nSeqEvento
|
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 362: Arquivo de cancelamento da MDF-e
- zzz: Chave de Acesso ou DataHora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex. Data/Hora: 362_2020122311295318_7443.xml
Ex. Chave de Acesso: 362_35211052314852070001580330000000501780093194_0001.xml
Após envio do arquivo para o TPF, o retorno do XML com o cancelamento do MDF-e é disponibilizado no diretório de entrada, a nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Para realizar o envio da inclusão do condutor do MDF-e é necessário adicionar o arquivo XML no diretório de saída com as seguintes informações:
<eventoMDFe versao="3.00" xmlns="http://www.portalfiscal.inf.br/mdfe">
<infEvento Id="ID110114XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXYY">
<cOrgao>Código do órgão de recepção do Evento</cOrgao>
<tpAmb>Identificação do Ambiente: 1 - Produção ou 2 – Homologação</tpAmb>
<CNPJ>Informar o CNPJ do autor do Evento</CNPJ>
<chMDFe>Chave de Acesso do MDF-e vinculado ao Evento</chMDFe>
<dhEvento>Data e hora do evento no formato AAAA-MMDDThh</dhEvento>
<tpEvento>110114</tpEvento>
<nSeqEvento>Sequencial do evento para o mesmo tipo de evento</nSeqEvento>
<detEvento versaoEvento="3.00">
<evIncCondutorMDFe>
<descEvento>Inclusao Condutor</descEvento>
<condutor>
<xNome>Nome do condutor</xNome>
<CPF>CPF do condutor</CPF>
</condutor>
</evIncCondutorMDFe>
</detEvento>
</infEvento>
</eventoMDFe>
Campos | Detalhes | ||||||||
---|---|---|---|---|---|---|---|---|---|
**Id | ID + tpEvento + chNFe + nSeqEvento
|
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 420: Arquivo de solicitação para inclusão do condutor
- zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex. Data/Hora: 420_20200506134620596_1230.xml
Ex. Chave de Acesso: 420_35211058237307700033580330000000611780093198_0257.xml
O retorno do fisco é disponibilizado na plataforma do Totvs Processos Fiscais, onde o Fiscal Sync disponibiliza o consumo do XML para os sistemas externos dentro do diretório de entrada configurado no properties. A nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):
Para realizar a consulta da chave de acesso do CT-e é necessário adicionar o XML no diretório de saída com as seguintes informações:
<?xml version="1.0" encoding="UTF-8"?>
<consSitCTe xmlns="http://www.portalfiscal.inf.br/cte" versao="3.00">
<tpAmb>Identificação do Ambiente(1=Produção; 2=Homologação)</tpAmb>
<xServ>CONSULTAR</xServ>
<chCTe>Chave de Acesso da CT-e</chCTe>
</consSitCTe>
E com a nomenclatura:
xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy
- xxx: Identificação do tipo do arquivo - 3 dígitos.
Valores válidos:
** 208: Arquivo de consulta por chave de acesso
- zzz: Chave de Acesso ou DataHora da operação (com milissegundos)
- yyyy: Número aleatório- 4 dígitos
Ex. DataHora: 208_20201015194716243_5070.xml
Ex. Chave de Acesso: 208_42210453113791000123552480000032061352515948_1569.xml
Após envio do arquivo para o Totvs Processos Fiscais, o retorno do XML com a situação do CT-e é disponibilizado no diretório de entrada, a nomenclatura apresenta da mesma forma que foi enviada, acrescentando apenas a quarta "casa" com números aleatórios (sendo quatro dígitos):