Sobre o NFSe4305108 Caxias do Sul / NFSe4307906 · Trata-se de um arquivo executável (somente para...

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

1/13

Índice

Sobre o NFSe4305108 – Caxias do Sul / NFSe4307906 – Farroupilha ........................................................ 1

Instalação ..................................................................................................................................................... 1

Versão atual 0.18 ......................................................................................................................................... 1

Arquivo de Configuração .............................................................................................................................. 1

Comandos .................................................................................................................................................... 2

Formato do arquivo de saída ........................................................................................................................ 4

Licença de uso ............................................................................................................................................. 4

Layouts dos Arquivos de Importação ............................................................................................................ 5

Exemplo XML para Caxias do Sul ................................................................................................................ 5

Exemplo XML para Farroupilha .................................................................................................................... 9

Controle de Versões ................................................................................................................................... 12

Sobre o NFSe4305108 – Caxias do Sul / NFSe4307906 – Farroupilha

O NFSe4305108/NFSe4307906 são DLLs utilizadas pelo ACNFe. O ACNFe é um aplicativo desenvolvido

pela Agregare Consultoria que permite trabalhar de forma muito eficiente com a nota fiscal eletrônica e

nota fiscal de serviço eletrônica. Trata-se de um arquivo executável (somente para sistemas operacionais

Microsoft Windows) que, através de parâmetros, é possível executar diversas operações.

Esta biblioteca sofre constantes atualizações, devendo sempre ser atualizada pelo site

www.agregareconsultoria.com.br/ti/acnfe

Instalação

O arquivo DLL deve estar armazenado numa pasta abaixo da pasta de onde o aplicativo acnfe.exe estiver.

O nome da pasta deverá chamar-se NFSe. Exemplo: se o acnfe.exe estiver na pasta C:\ACNFe5, a DLL

deve estar salva dentro da pasta C:\ACNFe5\NFSe. Se esta pasta não existir, ela deve ser criada.

Esta DLL somente funciona com o ACNFe a partir da versão 500_000003.

Versão atual 0.18

É a versão que este manual se referencia.

Arquivo de Configuração

O arquivo de configuração é o mesmo utilizado pelo ACNFe. Veja o manual do ACNFe para mais

informações.

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

2/13

Comandos

/NFSE /VERSAO

Este comando não possui parâmetros.

Imprime a versão da biblioteca.

/NFSE /EMITIRNFS <arq_nfe> [<-as arq_saida>] [<-email email@xyz.com >]

<arq_nfe> Nome do arquivo de entrada para a importação da nfe. Atualmente somente no formato

XML

[<-email email@xyz.com>] Parâmetro opcional. É (São) o (s) e-mail (s) para quais serão destinados os

arquivos de distribuição e DANFe. Deve ser separado por ponto-e-vírgula.

[<-as arq_saida>] Arquivo de saída alternativo ao do ini

Exemplos:

acnfe /nfse /emitirnfs c:\t\nfe_001.xml

acnfe /nfse /emitirnfs c:\t\nfe_003.xml –email fulano@xyz.com.br

acnfe /nfse /emitirnfs c:\t\nfe_004.txt –email fulano@xyz.com.br –as c:\t\nfe_004.ret

/NFSE /INUTILIZARNFS <serie> <nro_inicial> <nro_final>

<serie> Série da numeração que se pretende inutilizar

<nro_incial> Numeração inicial que se pretende inutilizar

<nro_final> Numeração final que se pretende inutilizar

[<-email email@xyz.com>] Parâmetro opcional. É (São) o (s) e-mail (s) para quais serão destinados o

arquivo XML de distribuição. Deve ser separado por ponto-e-vírgula.

[<-as arq_saida>] Arquivo de saída alternativo ao do ini

Exemplos:

acnfe /nfse /inutilizarnfs S 96 96

acnfe /nfse /inutilizarnfs S 96 96 –as c:\retorno\inut_96.txt

/NFSE /CONSULTARNFS <chvAcessoNFSe>

<chvAcessoNFSe> Chave de acesso da NFS-e

[<-email email@xyz.com>] Parâmetro opcional. É (São) o (s) e-mail (s) para quais serão destinados os

arquivos de distribuição e DANFe. Deve ser separado por ponto-e-vírgula.

[<-as arq_saida>] Arquivo de saída alternativo ao do ini

Exemplos:

acnfe /nfse /CONSULTARNFS 43102338050001399800S000001506561245413

acnfe /nfse /CONSULTARNFS 43102338050001399800S000001506561245413–as c:\retorno\cons1506.txt

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

3/13

/NFSE /GERARDANFE <chvAcessoNFSe>

<chvAcessoNFSe> Chave de acesso da NFS-e

[<-email email@xyz.com>] Parâmetro opcional. É (São) o (s) e-mail (s) para quais serão destinados os

arquivos de distribuição e DANFe. Deve ser separado por ponto-e-vírgula.

[<-as arq_saida>] Arquivo de saída alternativo ao do ini

Exemplos:

acnfe /nfse /GERARDANFE 43102338050001399800S000001506561245413

acnfe /nfse /GERARDANFE 43102338050001399800S000001506561245413–as c:\retorno\danfe.txt

/NFSE /OBTERNFS <chvAcessoNFSe>

<chvAcessoNFSe> Chave de acesso da NFS-e

[<-email email@xyz.com>] Parâmetro opcional. É (São) o (s) e-mail (s) para quais serão destinados os

arquivos de distribuição e DANFe. Deve ser separado por ponto-e-vírgula.

[<-as arq_saida>] Arquivo de saída alternativo ao do ini

Este comando faz o download do XML da NFS-e e salva na pasta PathSalvarXML do acnfe.ini

Exemplos:

acnfe /nfse /OBTERNFS 43102338050001399800S000001506561245413

acnfe /nfse /OBTERNFS 43102338050001399800S000001506561245413–as c:\retorno\obt.txt

/NFSE /OBTERXMLPDF <chvAcessoNFSe>

<chvAcessoNFSe> Chave de acesso da NFS-e

[<-email email@xyz.com>] Parâmetro opcional. É (São) o (s) e-mail (s) para quais serão destinados os

arquivos de distribuição e DANFe. Deve ser separado por ponto-e-vírgula.

[<-as arq_saida>] Arquivo de saída alternativo ao do ini

Este comando faz o download do XML e do PDF DANFe da NFS-e e salva, respectivamente, nas pastas

PathSalvarXML e PathSalvarPDF do acnfe.ini

Exemplos:

acnfe /nfse /OBTERXMLPDF 43102338050001399800S000001506561245413

acnfe /nfse /OBTERXMLPDF 43102338050001399800S000001506561245413–as c:\retorno\obt.txt

/NFSE /CANCELARNFS <chvAcessoNFSe> <motivo>

<chvAcessoNFSe> Chave de acesso da NFS-e

<motivo> Motivo do cancelamento. Podem ser: “1”, que representa “Serviço não foi prestado”

ou "2” que representa "NFS-e emitida com dados incorretos”.

[<-email email@xyz.com>] Parâmetro opcional. É (São) o (s) e-mail (s) para quais serão destinados os

arquivos de distribuição e DANFe. Deve ser separado por ponto-e-vírgula.

[<-as arq_saida>] Arquivo de saída alternativo ao do ini

Exemplos:

acnfe /nfse /CANCELARNFS 43102338050001399800S000001506561245413

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

4/13

acnfe /nfse /CANCELARNFS 43102338050001399800S000001506561245413–as c:\retorno\canc.txt

Formato do arquivo de saída

As respostas destas operações podem ser geradas em tela ou direcionadas para um arquivo. É gerado

automaticamente em arquivo de log, onde fica armazenado o histórico das operações, incluindo a

mensagem de retorno das operações, número de protocolos, etc.

Em tela:

[dd/mm/yyyy hh:nn:ss] comando chave codmsg-msg nroRecibo nroProtocolo

Exemplo:

[23/06/2014 11:23:47] EMITIRNF 43090789822183000215550000000003190000000267 100-Autorizado o uso da NF-e

No arquivo de saída:

Campo Descrição Formato

Comando Comando executado 15 caracteres fixos

chave Chave 44 caracteres fixos

codmsg Código da mensagem de retorno 03 caracteres fixos

msg Descrição da mensagem de retorno 96 caracteres fixos

nroRecibo Número do recibo 18 caracteres fixos

nroProtocolo Número do protocolo 18 caracteres fixos

Licença de uso

O aplicativo funciona em versão de demonstração, enquanto não registrado. Neste tipo de versão, o

aplicativo permite somente ser utilizado no ambiente de homologação. Isto significa que todas as

operações poderão ser feitas normalmente, para finalidade de teste do aplicativo, porém as operações

realizadas através dele não têm nenhuma validade perante SEFAZ.

Após o registro do aplicativo, ele funcionará nos dois ambientes disponíveis: homologação e produção.

Para registrar o aplicativo, é necessário contatar a Agregare Consultoria e solicitar o registro. O registro

não é gratuito. Entre em contato conosco para saber mais sobre como registrar este aplicativo:

Agregare Consultoria Ltda

Telefone (54) 8148-0879 / 9911-8525 c/ Rodrigo

http://www.agregareconsultoria.com.br/ti/accte

agregare@agregareconsultoria.com.br

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

5/13

Layouts dos Arquivos de Importação

O layout do arquivo XML deve ser o mesmo apresentado nos manuais do usuário no site

https://nfse.caxias.rs.gov.br/site/ e https://dmse.farroupilha.rs.gov.br/site/

Exemplo XML para Caxias do Sul

<NFS-e>

<infNFSe versao="1.1">

<Id>

<cNFS-e>002321654</cNFS-e>

<mod>98</mod>

<serie>S</serie>

<nNFS-e>13</nNFS-e>

<dEmi>2014-11-17</dEmi>

<hEmi>11:00</hEmi>

<tpNF>1</tpNF>

<refNF>43106339320001259800S000000013002321654</refNF>

<tpImp>1</tpImp>

<tpEmis>N</tpEmis>

<canhoto>1</canhoto>

<ambienteEmi>2</ambienteEmi>

<formaEmi>2</formaEmi>

<empreitadaGlobal>2</empreitadaGlobal>

</Id>

<prest>

<CNPJ>10633932000125</CNPJ>

<xNome>VALORARE GESTAO E TI LTDA</xNome>

<xFant>AGREGARE CONSULTORIA</xFant>

<IM>105566</IM>

<xEmail>agregare@agregareconsultoria.com.br</xEmail>

<xSite>www.agregareconsultoria.com.br</xSite>

<end>

<xLgr>RUA PEDRO ZUGNO</xLgr>

<nro>100</nro>

<xCpl>SL 12</xCpl>

<xBairro>PIO X</xBairro>

<cMun>4305108</cMun>

<xMun>CAXIAS DO SUL</xMun>

<UF>RS</UF>

<CEP>95034480</CEP>

<cPais>01058</cPais>

<xPais>BRASIL</xPais>

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

6/13

</end>

<fone>5430214061</fone>

<fone2>5499118525</fone2>

<regimeTrib>1</regimeTrib>

</prest>

<TomS>

<CPF>95056033049</CPF>

<xNome>RODRIGO EUZEBIO NUNES</xNome>

<ender>

<xLgr>RUA PEDRO ZUGNO</xLgr>

<nro>100</nro>

<xCpl>AP 12</xCpl>

<xBairro>PIO X</xBairro>

<cMun>4305108</cMun>

<xMun>CAXIAS DO SUL</xMun>

<UF>RS</UF>

<CEP>95034480</CEP>

<cPais>01058</cPais>

<xPais>BRASIL</xPais>

</ender>

<xEmail>rodrigoenunes@gmail.com</xEmail>

<fone>5481480879</fone>

</TomS>

<det>

<nItem>1</nItem>

<serv>

<cServ>246</cServ>

<cLCServ>0802</cLCServ>

<xServ>TREINAMENTO EM SISTEMA DE GESTAO</xServ>

<localTributacao>4305108</localTributacao>

<localVerifResServ>1</localVerifResServ>

<uTrib>H</uTrib>

<qTrib>7</qTrib>

<vUnit>100</vUnit>

<vServ>700</vServ>

<vDesc>0</vDesc>

<vBCISS>0</vBCISS>

<pISS>0</pISS>

<vISS>0</vISS>

<vBCINSS>0</vBCINSS>

<pRetINSS>0</pRetINSS>

<vRetINSS>0</vRetINSS>

<vRed>0</vRed>

<vBCRetIR>0</vBCRetIR>

<pRetIR>0</pRetIR>

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

7/13

<vRetIR>0</vRetIR>

<vBCCOFINS>0</vBCCOFINS>

<pRetCOFINS>0</pRetCOFINS>

<vRetCOFINS>0</vRetCOFINS>

<vBCCSLL>0</vBCCSLL>

<pRetCSLL>0</pRetCSLL>

<vRetCSLL>0</vRetCSLL>

<vBCPISPASEP>0</vBCPISPASEP>

<pRetPISPASEP>0</pRetPISPASEP>

<vRetPISPASEP>0</vRetPISPASEP>

</serv>

</det>

<total>

<vServ>700</vServ>

<vRedBCCivil>0</vRedBCCivil>

<vDesc>0</vDesc>

<vtNF>700</vtNF>

<vtLiq>700</vtLiq>

<Ret>

<vRetIR>0</vRetIR>

<vRetPISPASEP>0</vRetPISPASEP>

<vRetCOFINS>0</vRetCOFINS>

<vRetCSLL>0</vRetCSLL>

<vRetINSS>0</vRetINSS>

</Ret>

<vtLiqFaturas>700</vtLiqFaturas>

<ISS>

<vBCISS>0</vBCISS>

<vISS>0</vISS>

<vBCSTISS>0</vBCSTISS>

<vSTISS>0</vSTISS>

</ISS>

</total>

<faturas>

<fat>

<nItem>1</nItem>

<nFat>1</nFat>

<dVenc>2014-11-25</dVenc>

<vFat>700</vFat>

<tipoVencFat>1</tipoVencFat>

</fat>

</faturas>

<infAdicLT>4305108</infAdicLT>

<infAdicES>N</infAdicES>

<infAdic>NOTA DE EXEMPLO PARA TESTE EM AMBIENTE DE HOMOLOGACAO</infAdic>

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

8/13

<infAdic>DOCUMENTOS EMITIDO POR ME/EPP OPTANTE PELO SIMPLES NACIONAL</infAdic>

</infNFSe>

</NFS-e>

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

9/13

Exemplo XML para Farroupilha

<NFS-e>

<infNFSe versao="1.00">

<Id>

<cNFS-e>819827646</cNFS-e>

<natOp>PRESTACAO DE SERVICO</natOp>

<mod>55</mod>

<serie>N1</serie>

<nNFS-e>3</nNFS-e>

<dEmi>2016-09-05</dEmi>

<hEmi>16:43</hEmi>

<tpNF>1</tpNF>

<cMunFG>0</cMunFG>

<refNF>0010708886000186550N1000000003819827646</refNF>

<tpImp>1</tpImp>

<tpEmis>N</tpEmis>

<anulada>N</anulada>

<notadebito>N</notadebito>

</Id>

<emit>

<CNPJ>10708886000186</CNPJ>

<xNome>TOP SEGUR MONITORAMENTO DE ALARMES LTDA - ME</xNome>

<xFant>TOP SEGUR</xFant>

<IM>13311</IM>

<xEmail>contato@topsegur.com.br</xEmail>

<xSite>www.topsegur.com.br</xSite>

<end>

<xLgr>R CARLOS MAGGIONI</xLgr>

<nro>73</nro>

<xCpl>SALA A</xCpl>

<xBairro>SAO LUIZ</xBairro>

<cMun>4307906</cMun>

<xMun>FARROUPILHA</xMun>

<UF>RS</UF>

<CEP>95180000</CEP>

<cPais>1058</cPais>

<xPais>BRASIL</xPais>

<fone>5432231251</fone>

</end>

</emit>

<TomS>

<CNPJ>88893474000150</CNPJ>

<xNome>SERRARIA RECH LTDA</xNome>

<ender>

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

10/13

<xLgr>JOAO ANTONIO BOFF</xLgr>

<nro>118</nro>

<xBairro>SAO LEOPOLDO</xBairro>

<cMun>4307906</cMun>

<xMun>FARROUPILHA</xMun>

<UF>RS</UF>

<CEP>95180000</CEP>

<cPais>1058</cPais>

<xPais>BRASIL</xPais>

<fone>5432132486</fone>

</ender>

<xEmail>qualidade@xxx.com.br</xEmail>

<Praca>Farroupilha-RS</Praca>

</TomS>

<det>

<nItem>1</nItem>

<serv>

<cServ>09010105</cServ>

<xServ>MONITORAMENTO SET2016</xServ>

<uTrib>UN</uTrib>

<qTrib>1</qTrib>

<vUnit>650.00</vUnit>

<vServ>650.00</vServ>

<vDesc>0</vDesc>

<vBCISS>0</vBCISS>

<pISS>0</pISS>

<vISS>0</vISS>

<pRetINSS>0</pRetINSS>

<vRetINSS>0</vRetINSS>

<vRed>0</vRed>

<pRetIRF>0</pRetIRF>

<vRetIRF>0</vRetIRF>

<vRetLei10833-COFINS>0</vRetLei10833-COFINS>

<vRetLei10833-CSLL>0</vRetLei10833-CSLL>

<vRetLei10833-PIS-PASEP>0</vRetLei10833-PIS-PASEP>

</serv>

</det>

<total>

<vServ>650.00</vServ>

<vDesc>0</vDesc>

<vtNF>650.00</vtNF>

<vtLiq>650.00</vtLiq>

<totalAproxTrib>39.00</totalAproxTrib>

<Ret>

<vRetIRF>0</vRetIRF>

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

11/13

<vRetLei10833-PIS-PASEP>0</vRetLei10833-PIS-PASEP>

<vRetLei10833-COFINS>0</vRetLei10833-COFINS>

<vRetLei10833-CSLL>0</vRetLei10833-CSLL>

<vRetINSS>0</vRetINSS>

</Ret>

<fat>

<nFat>35</nFat>

<vOrig>650.00</vOrig>

<vLiq>650.00</vLiq>

</fat>

<ISS>

<vBCISS>0</vBCISS>

<vISS>0</vISS>

<vBCSTISS>0</vBCSTISS>

<vSTISS>0</vSTISS>

</ISS>

</total>

<cobr>

<dup>

<nDup>35/01</nDup>

<dVenc>2016-09-27</dVenc>

<vDup>650.00</vDup>

</dup>

</cobr>

<infAdic>DOCUMENTOS EMITIDO POR ME/EPP OPTANTE PELO SIMPLES NACIONAL</infAdic>

<infAdic>VALOR APROXIMADO DOS TRIBUTOS (LEI 12741/12) R$ 39,00</infAdic>

</infNFSe>

</NFS-e>

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

12/13

Controle de Versões

******************************************************************************

Data: 04/01/2018 Versao: 0.17

(*) Alterado o /OBTERXMLPDF para buscar o PDF e nao mais o PNG e dps converter

para PDF

******************************************************************************

Data: 06/02/2016 Versao: 0.16

(*) Melhorado a pesquisa do certificado.

Em algumas situacoes, acusava erro de Access Violation

******************************************************************************

Data: 10/10/2016 Versao: 0.15

(*) Ajustado a chamada da URL pro cancelamento da NFSe

tanto para Caxias qto para Farroupilha

******************************************************************************

Data: 23/09/2016 Versao: 0.14

(*) Adaptacao para NFSe Farroupilha

******************************************************************************

Data: 16/05/2016 Versao: 0.13

(*) Criado validacoes de tipo na importacao das tags

******************************************************************************

Data: 18/04/2016 Versao: 0.12

(*) Implementado o tratamento do parametro FormatoArquivoSaida

******************************************************************************

Data: 01/04/2016 Versao: 0.11

(*) Feito tratamento do erro de conexão com o servidor da prefeitura

qdo o mesmo não estiver respondendo ao método de EnviarLoteNotas

******************************************************************************

Data: 11/03/2016 Versao: 0.10

(*) Ampliado o tempo de espera do retorno dos webservices da prefeitura

de 2,5 para 7,5 segundos

******************************************************************************

Data: 02/10/2015 Versao: 0.9

(*) Ajustado o carregamento da tag infAdicES

******************************************************************************

Data: 14/09/2015 Versao: 0.8

(*) Ajustado a emissao da NFS para compreender o retorno 217

NFS-e(s) já recebida(s) e não processada(s) e tambem ajustado

www.agregareconsultoria.com.br/ti/acnfe https://nfse.caxias.rs.gov.br/site/ https://dmse.farroupilha.rs.gov.br/site/

13/13

a leitura de algumas tags de retorno que tiverem renomeacoes de

chvAcessoNFS-e para chvAcessoNFSe

******************************************************************************

Data: 11/09/2015 Versao: 0.7

(*) Alterado o comando INUTILIZARNFS para compreender intervalos

de inutilizacao

******************************************************************************

Data: 11/08/2015 Versao: 0.6

(*) Criado mais opcoes de comando

CONSULTARNFS, GERARDANFE, OBTERNFS, OBTERXMLPDF e CANCELARNFS

******************************************************************************

Data: 01/04/2015 Versao: 0.5

(*) Ampliado o setParametros para interpretar o logotipo

******************************************************************************

Data: 01/03/2015 Versao: 0.4

(*) Criado a opcao de inutilizacao

******************************************************************************

Data: 03/11/2014 Versao: 0.3

(*) Ajustado function Tend.CarregarEnderecoXML para desconsiderar erro

se o Bairro nao for informado

(*) Criado loop de execucoes do NFSePedidoStatusLote.Executar, ja que

pode ser retornado XML sem situacao

(*) Ajustado function getTomS para desconsiderar erro se o xEmail nao

for informado

******************************************************************************

Data: 03/11/2014 Versao: 0.2

(*) Ajustado function Tend.CarregarEnderecoXML para desconsiderar erro

se o Bairro nao for informado

******************************************************************************

Data: 28/11/2014 Versao: 0.1

(*) Ajustado function Tend.CarregarEnderecoXML para buscar o nome real

da tag de endereco do pai desta tag

******************************************************************************

Data: 28/11/2014 Versao: 0.0

(*) Versao inicial da DLL

******************************************************************************