Configurações básicas para Implementação provedor Nota Control/ISSNet

De CIGAM WIKI

FAQ_CIGAM > FAQ_Fiscal > Gestão Fiscal Municipal > Configurações básicas para Implementação provedor Nota Control/ISSNet


Nesta FAQ iremos destacar parametrizações básica para integração da NFSe com o provedor Nota Control/ISSNet. Para que seja possível realizar a integração é necessário possuir o módulo Gestão Fiscal Municipal.

Parametrizações Básicas

As parametrizações devem ser realizadas através do menu Fiscal > Gestão Fiscal Municipal > Parâmetros > Cadastro NFS-e Configurável.

Guia Envio

Abaixo seguem informações de parametrização dos campos. Neste exemplo foi utilizada a prefeitura de Brasília/DF. Porém o conteúdo das TAGs será o mesmo independente do município.

NFSeNotaControleBrasiliaDFEnvio.png

TAGs

Tag Código /s:Envelope/s:Body/RecepcionarLoteRpsSincronoResponse/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Codigo
Tag Mensagem /s:Envelope/s:Body/RecepcionarLoteRpsSincronoResponse/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Mensagem
Tag Correção /s:Envelope/s:Body/RecepcionarLoteRpsSincronoResponse/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Correcao
Tag Protocolo /s:Envelope/s:Body/RecepcionarLoteRpsSincronoResponse/EnviarLoteRpsSincronoResposta/Protocolo
Envio Síncrono
Tag Número /s:Envelope/s:Body/RecepcionarLoteRpsSincronoResponse/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/DeclaracaoPrestacaoServico/
InfDeclaracaoPrestacaoServico/Rps/IdentificacaoRps/Numero
Tag Número NF /s:Envelope/s:Body/RecepcionarLoteRpsSincronoResponse/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/Numero
Tag Cód Verificação /s:Envelope/s:Body/RecepcionarLoteRpsSincronoResponse/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/CodigoVerificacao

Botão Configurações

Neste botão deve ser marcada a opção "Envio Síncrono" e "Realiza comunicação WebService via DLL específica".

NFSeNotaControleBrasiliaDFBotaoConfiguracoes.png

Botão Natureza

Neste botão devemos informar os respectivos códigos e seus tratamentos tributários.

Importante: Estas informações podem variar de acordo com o município a ser implementado, recomenda-se consultar o manual de orientações para o preenchimento das informações.

NFSeNotaControleBrasiliaDFEnvioBotaoNatureza.png

Botão Assinatura

Neste botão devemos informar a(s) respectivas TAGs em ordem que devem ser assinadas. Para identificar quais são as TAGs que necessitam deste tratamento, recomenda-se consultar o manual de Integração.

NFSeNotaControleBrasiliaDFEnvioBotaoAssinatura.png

Botão Serviços

Neste botão devem ser informados os dados do serviço de envio do XML para a prefeitura. Respectivas URL(s) assim com o Método utilizado. Para identificar a URL e o método a ser utilizado recomenda-se consultar o manual de Integração.

NFSeNotaControleBrasiliaDFEnvioBotaoServiços.png

Observação: Com a URL informada, clicando no botão Carregar será realizada a abertura do CIGAM Web Serviços Invoker, através desta aplicação será possível consultar os métodos disponíveis.

NFSeNotaControleBrasiliaDFInvoker.png

Invocando o método RecepcionarLoteRpsSincrono.

NFSeNotaControleBrasiliaDFInvokerInvocar.png

Embora liste para utilizar método complexo, para este provedor não será necessário, pois o tratamento será realizado diretamente na DLL específica.

Guia Retorno

Nesta guia devem ser parametrizadas os modelos e parâmetros do retorno.

NFSeNotaControleBrasiliaDFRetorno.png

Observação:

Quando utilizada a opção "Envio Síncrono", não se faz necessário parametrizar a aba de Retorno, pois o retorno irá ocorrer na mesma requisição do Envio.

Guia Cancelamento

Nesta guia devemos parametrizar os modelos de envio do Cancelamento e as respectivas TAGs.

NFSeNotaControleBrasiliaDFCancelamento.png

Observação:

Quando a opção "Este município não permite cancelamento via WebService", estiver marcada, todos os campos ficarão desabilitados e não será possível realizar o cancelamento de NFSe(s) através da integração, sendo necessário realizar o cancelamento diretamente no site da prefeitura.

TAGs

Tag Código /s:Envelope/s:Body/CancelarNfseResponse/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Codigo
Tag Mensagem /s:Envelope/s:Body/CancelarNfseResponse/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Mensagem
Tag Correção /s:Envelope/s:Body/CancelarNfseResponse/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Correcao
Tag Número NF /s:Envelope/s:Body/CancelarNfseResponse/CancelarNfseResposta/RetCancelamento/NfseCancelamento/Confirmacao/Pedido/InfPedidoCancelamento/
IdentificacaoNfse/Numero

Botão Motivos

Neste botão devemos informar os respectivos códigos assim com a descrição (motivo) do cancelamento, conforme detalhado no manual de Integração.

NFSeNotaControleBrasiliaDFCancelamentoBotaoMotivo.png

Botão Assinatura

Neste botão devemos informar a(s) respectivas TAGs em ordem que devem ser assinadas. Para identificar quais são as TAGs que necessitam deste tratamento, recomenda-se consultar o manual de integração.

NFSeNotaControleBrasiliaDFCancelamentoBotaoAssinatura.png

Botão Serviços

Neste botão devem ser informados os dados do serviço de envio do XML de Cancelamento para a prefeitura. Para identificar as respectivas URL(s) assim com o Método a ser utilizado, recomenda-se consultar o manual de Integração.

NFSeNotaControleBrasiliaDFCancelamentoBotaoServiços.png


Modelos

Cabecalho

Código Fonte do modelo XML de Cabeçalho
<cabecalho versao="1.00" xmlns="http://www.abrasf.org.br/nfse.xsd">
	<versaoDados>2.04</versaoDados>
</cabecalho>

NFSeNotaControleBrasiliaDFModeloCabecalho.png

Envio

O modelo XML de Envio (Última atualização 02/01/2023).

Código Fonte do modelo XML de Envio
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:nfse="http://nfse.abrasf.org.br">
	<soapenv:Header/>
	<soapenv:Body>
		<nfse:RecepcionarLoteRpsSincrono>
			<nfseCabecMsg>
				<cabecalho xmlns="http://www.abrasf.org.br/nfse.xsd" versao="1.00">
					<versaoDados>2.04</versaoDados>
				</cabecalho>
			</nfseCabecMsg>
			<nfseDadosMsg>
				<EnviarLoteRpsSincronoEnvio xmlns="http://www.abrasf.org.br/nfse.xsd">
					<LoteRps Id="<!$MG_lot_numero_lote>" versao="2.04">
						<NumeroLote><!$MG_lot_numero_lote></NumeroLote>
						<Prestador>
							<CpfCnpj>
								<Cnpj><!$MG_lot_cnpj></Cnpj>
							</CpfCnpj>
							<InscricaoMunicipal><!$MG_lot_inscricao_municipal></InscricaoMunicipal>
						</Prestador>
						<QuantidadeRps><!$MG_lot_quantidade_rps></QuantidadeRps>
						<ListaRps>
							<Rps>
								<InfDeclaracaoPrestacaoServico Id="<!$MG_lot_numero_lote>">
									<Rps>
										<IdentificacaoRps>
											<Numero><!$MG_nf></Numero>
											<Serie><!$MG_serie></Serie>
											<Tipo>1</Tipo>
										</IdentificacaoRps>
										<DataEmissao><!$MG_emissao></DataEmissao>
										<Status><!$MG_status></Status>
									</Rps>
									<Competencia><!$MG_emissao></Competencia>
									<Servico>
										<Valores>
											<ValorServicos><!$MG_ag_val_servico></ValorServicos>
											<ValorDeducoes><!$MG_ag_val_deducoes></ValorDeducoes>
											<ValorPis><!$MG_ag_val_pis></ValorPis>
											<ValorCofins><!$MG_ag_val_cofins></ValorCofins>
											<ValorInss><!$MG_ag_val_inss></ValorInss>
											<ValorIr><!$MG_ag_val_irrf></ValorIr>
											<ValorCsll><!$MG_ag_val_csll></ValorCsll>
											<OutrasRetencoes><!$MG_retencoes_federais></OutrasRetencoes>
											<DescontoIncondicionado><!$MG_ag_val_desc_incondicional></DescontoIncondicionado>
											<DescontoCondicionado><!$MG_mov_valor_desconto></DescontoCondicionado>
										</Valores>
										<IssRetido><!$MGIF_ag_iss_retido>1<!$MGELSE>2<!$MGENDIF></IssRetido>
										<!$MGIF_ag_iss_retido><ResponsavelRetencao>1</ResponsavelRetencao><!$MGENDIF>
										<ItemListaServico><!$MG_mov_desc_cod_serv_mun></ItemListaServico>
										<CodigoCnae><!$MG_ag_cnae_material></CodigoCnae>
										<CodigoTributacaoMunicipio><!$MG_ag_cod_contribuicao_muni></CodigoTributacaoMunicipio>
										<Discriminacao><!$MGREPEAT><!$MG_i_discriminacao><!$MGENDREPEAT></Discriminacao>
										<CodigoMunicipio><!$MG_municipio_prestacao_ibge></CodigoMunicipio>
										<ExigibilidadeISS><!$MG_natureza></ExigibilidadeISS>
										<MunicipioIncidencia><!$MG_prestador_cod_munic></MunicipioIncidencia>
									</Servico>
									<Prestador>
										<CpfCnpj>
											<Cnpj><!$MG_prestador_cnpj></Cnpj>
										</CpfCnpj>
										<InscricaoMunicipal><!$MG_prestador_ins_municipal></InscricaoMunicipal>
									</Prestador>
									<TomadorServico>
										<IdentificacaoTomador>
											<CpfCnpj>
												<!$MGIF_tomador_if_pess><Cpf><!$MG_tomador_cpf></Cpf><!$MGELSE><Cnpj><!$MG_tomador_cnpj></Cnpj><!$MGENDIF>
											</CpfCnpj>
										</IdentificacaoTomador>
										<RazaoSocial><!$MG_tomador_razao_social></RazaoSocial>
										<Endereco>
											<Endereco><!$MG_tomador_endereco></Endereco>
											<Numero><!$MG_tomador_endereco_n></Numero>
											<Bairro><!$MG_tomador_bairro></Bairro>
											<CodigoMunicipio><!$MG_tomador_municipio></CodigoMunicipio>
											<Uf><!$MG_tomador_uf></Uf>
											<Cep><!$MG_tomador_cep></Cep>
										</Endereco>
									</TomadorServico>
									<RegimeEspecialTributacao><!$MG_regime_especial></RegimeEspecialTributacao>
									<OptanteSimplesNacional><!$MG_optante_simples></OptanteSimplesNacional>
									<IncentivoFiscal><!$MG_i_incentivo_fiscal></IncentivoFiscal>
									<InformacoesComplementares><!$MG_descricao_rps></InformacoesComplementares>
								</InfDeclaracaoPrestacaoServico>
							</Rps>
						</ListaRps>
					</LoteRps>
				</EnviarLoteRpsSincronoEnvio>
			</nfseDadosMsg>
		</nfse:RecepcionarLoteRpsSincrono>
	</soapenv:Body>
</soapenv:Envelope>

Retorno

O modelo XML de Retorno (Última atualização 02/01/2023).

Código Fonte do modelo XML de Retorno
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:nfse="http://nfse.abrasf.org.br">
	<soapenv:Header/>
	<soapenv:Body>
		<nfse:ConsultarNfsePorRps>
			<nfseCabecMsg>
				<cabecalho xmlns="http://www.abrasf.org.br/nfse.xsd" versao="1.00">
					<versaoDados>2.04</versaoDados>
				</cabecalho>
			</nfseCabecMsg>
			<nfseDadosMsg>
				<ConsultarNfseRpsEnvio xmlns="http://www.abrasf.org.br/nfse.xsd">
					<Pedido>
						<IdentificacaoRps>
							<Numero><!$MG_nf></Numero>
							<Serie><!$MG_serie></Serie>
							<Tipo>1</Tipo>
						</IdentificacaoRps>
						<Prestador>
							<CpfCnpj>
								<Cnpj><!$MG_prestador_cnpj></Cnpj>
							</CpfCnpj>
							<InscricaoMunicipal><!$MG_prestador_ins_municipal></InscricaoMunicipal>
						</Prestador>
					</Pedido>
				</ConsultarNfseRpsEnvio>
			</nfseDadosMsg>
		</nfse:ConsultarNfsePorRps>
	</soapenv:Body>
</soapenv:Envelope>

Cancelamento

O modelo XML de Cancelamento (Última atualização 02/01/2023).

Código Fonte do modelo XML de Cancelamento
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:nfse="http://nfse.abrasf.org.br">
   <soapenv:Header/>
   <soapenv:Body>
      <nfse:CancelarNfse>
         <nfseCabecMsg><cabecalho versao="1.00" xmlns="http://www.abrasf.org.br/nfse.xsd">
					<versaoDados>2.04</versaoDados>
				</cabecalho></nfseCabecMsg>
         <nfseDadosMsg>
         <CancelarNfseEnvio xmlns="http://www.abrasf.org.br/nfse.xsd">
					<Pedido>
						<InfPedidoCancelamento Id="<!$MG_nf_referencia>">
							<IdentificacaoNfse>
								<Numero><!$MG_nf_referencia></Numero>
								<CpfCnpj>
									<Cnpj><!$MG_prestador_cnpj></Cnpj>
								</CpfCnpj>
								<InscricaoMunicipal><!$MG_prestador_ins_municipal></InscricaoMunicipal>
								<CodigoMunicipio>Informar Codigo IBGE do Municipio do Prestador</CodigoMunicipio>
							</IdentificacaoNfse>
							<CodigoCancelamento><!$MG_cod_cancelamento></CodigoCancelamento>
						</InfPedidoCancelamento>
					</Pedido>
				</CancelarNfseEnvio>
		</nfseDadosMsg>
      </nfse:CancelarNfse>
   </soapenv:Body>
</soapenv:Envelope>

Download Modelos

Os modelos disponíveis para download podem serem baixados através do Botão Importar Layout da rotina de Cadastro NFS-e Configurável.

Informe layout a importar

Através do Botão FTP o sistema realizará uma consulta no FTP CIGAM exibindo todos os layout que estão disponíveis para download.

Layouts disponíveis