FAQ_CIGAM > FAQ_Fiscal > Gestão Fiscal Municipal > Configurações básicas para Implementação provedor GINFES

Nesta FAQ iremos destacar parametrizações básica para integração da NFSe com o provedor GINFES. 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 Paulinia/SP. Porém o conteúdo das TAGs será o mesmo independente do município.

Botão Configurações

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

A opção "Utilizar o Modelo Complexo na DLL específica" marcar apenas se necessário.

^{[Versão230502 1]} Na opção "Provedor Produção" selecionar a opção Ginfes.

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.

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.

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.

Serviços de Produção

URL do Serviço	https://producao.ginfes.com.br/ServiceGinfesImpl?wsdl
Nome do Serviço	ServiceGinfesImplService
Endpoint	https://producao.ginfes.com.br/ServiceGinfesImpl?wsdl
Método	RecepcionarLoteRpsV3
Parâmetros	2

No campo "Modelo Complexo" através do botão "Alterar Modelo" deve ser informado o arquivo complexo do envio de acordo com o método utilizado.

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.

Invocando o método RecepcionarLoteRpsV3.

Guia Retorno

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

Botão RPS Não Proc.

Neste botão podemos preencher os respectivos códigos de rejeição referentes ao RPS ainda não Processado pela prefeitura. Estás informações não são obrigatórias. Se necessário consultar o manual de orientações para o preenchimento destas informações.

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.

Botão Serviços

Neste botão devem ser informados os dados do serviço de retorno dos XMLs da a prefeitura. Respectivas URL(s) assim com o Método utilizado.

Serviços de Produção

URL do Serviço	https://producao.ginfes.com.br/ServiceGinfesImpl?wsdl
Nome do Serviço	ServiceGinfesImplService
Endpoint	https://producao.ginfes.com.br/ServiceGinfesImpl?wsdl
Método	ConsultarLoteRpsV3
Parâmetros	2

No campo "Modelo Complexo" através do botão "Alterar Modelo" deve ser informado o arquivo complexo do retorno de acordo com o método utilizado.

Guia Cancelamento

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

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.

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.

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.

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.

No campo "Modelo Complexo" através do botão "Alterar Modelo" deve ser informado o arquivo complexo do retorno de acordo com o método utilizado.

Modelos

Os modelos XMLs listados possuem última atualização em 15/12/2020.

Cabecalho

Código Fonte do modelo XML de Cabealho

<?xml version="1.0" encoding="UTF-8"?>
<ns2:cabecalho versao="3" xmlns:ns2="http://www.ginfes.com.br/cabecalho_v03.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><versaoDados>3</versaoDados>
</ns2:cabecalho>

A estrutura do arquivo de cabeçalho poderá variar de acordo com os métodos selecionados para Envio, Retorno e Cancelamento. Neste exemplo estamos utilizando como base os métodos da Versão 3, para todos os eventos. Sendo assim o arquivo de cabeçalho será o mesmo para ambos.

Envio

Código Fonte do modelo XML de Envio

<?xml version="1.0" encoding="utf-8"?>
<EnviarLoteRpsEnvio xmlns="http://www.ginfes.com.br/servico_enviar_lote_rps_envio_v03.xsd" xmlns:tipos="http://www.ginfes.com.br/tipos_v03.xsd">
 <LoteRps>
  <tipos:NumeroLote><!$MG_lot_numero_lote></tipos:NumeroLote>
  <tipos:Cnpj><!$MG_lot_cnpj></tipos:Cnpj>
  <tipos:InscricaoMunicipal><!$MG_lot_inscricao_municipal></tipos:InscricaoMunicipal>
  <tipos:QuantidadeRps><!$MG_lot_quantidade_rps></tipos:QuantidadeRps>
  <tipos:ListaRps>
   <tipos:Rps>
    <tipos:InfRps>
     <tipos:IdentificacaoRps>
      <tipos:Numero><!$MG_nf></tipos:Numero>
      <tipos:Serie><!$MG_serie></tipos:Serie>
      <tipos:Tipo><!$MG_tipo_serv_merc></tipos:Tipo>
     </tipos:IdentificacaoRps>
     <tipos:DataEmissao><!$MG_emissao>T00:00:00</tipos:DataEmissao>
     <tipos:NaturezaOperacao><!$MG_natureza></tipos:NaturezaOperacao>
     <tipos:OptanteSimplesNacional>2</tipos:OptanteSimplesNacional>
     <tipos:IncentivadorCultural>2</tipos:IncentivadorCultural>
     <tipos:Status><!$MG_status></tipos:Status>
     <tipos:Servico>
      <tipos:Valores>
       <tipos:ValorServicos><!$MG_total_servico></tipos:ValorServicos>
       <tipos:ValorDeducoes>0.00</tipos:ValorDeducoes>
       <tipos:ValorPis><!$MG_ag_val_pis></tipos:ValorPis>
       <tipos:ValorCofins><!$MG_ag_val_cofins></tipos:ValorCofins>
       <tipos:ValorInss><!$MG_ag_val_inss></tipos:ValorInss>
       <tipos:ValorIr><!$MG_ag_val_irrf></tipos:ValorIr>
       <tipos:ValorCsll><!$MG_ag_val_csll></tipos:ValorCsll>
       <tipos:IssRetido><!$MGIF_ag_iss_retido>1<!$MGELSE>2<!$MGENDIF></tipos:IssRetido>
       <tipos:ValorIss><!$MGIF_ag_iss_retido><!$MG_ag_val_iss_livre_incidencia><!$MGELSE>0.00<!$MGENDIF></tipos:ValorIss>
       <tipos:ValorIssRetido><!$MG_ag_val_iss_ret></tipos:ValorIssRetido>
       <tipos:OutrasRetencoes>0.00</tipos:OutrasRetencoes>
       <tipos:BaseCalculo><!$MG_ag_val_base_calc></tipos:BaseCalculo>
       <tipos:Aliquota><!$MG_ag_aliquota_4_dec></tipos:Aliquota>
       <tipos:ValorLiquidoNfse><!$MG_ag_val_liquido></tipos:ValorLiquidoNfse>
      </tipos:Valores>
      <tipos:ItemListaServico><!$MGIF_possui_cod_servico><!$MG_ag_cod_servico><!$MGELSE>1401<!$MGENDIF></tipos:ItemListaServico>
      <tipos:CodigoTributacaoMunicipio><!$MG_ag_cnae_serv_un>00</tipos:CodigoTributacaoMunicipio>
      <tipos:Discriminacao><!$MG_descricao_rps><!$MGREPEAT><!$MG_mov_material_descricao> <!$MG_mov_descricao><!$MGENDREPEAT></tipos:Discriminacao>
      <tipos:CodigoMunicipio><!$MGIF_tributacao_fora_municipio><!$MG_tomador_municipio><!$MGELSE><!$MG_prestador_cod_munic><!$MGENDIF></tipos:CodigoMunicipio>
     </tipos:Servico>
     <tipos:Prestador>
      <tipos:Cnpj><!$MG_prestador_cnpj></tipos:Cnpj>
      <tipos:InscricaoMunicipal><!$MG_lot_inscricao_municipal></tipos:InscricaoMunicipal>
     </tipos:Prestador>
     <tipos:Tomador>
      <tipos:IdentificacaoTomador>
      <!$MGIF_tomador_if_uf_ext_cnpj><!$MGELSE>
       <tipos:CpfCnpj>
        <!$MGIF_tomador_if_pess><tipos:Cpf><!$MG_tomador_cpf></tipos:Cpf><!$MGELSE><tipos:Cnpj><!$MG_tomador_cnpj></tipos:Cnpj><!$MGENDIF>
       </tipos:CpfCnpj>
      <!$MGENDIF>
      </tipos:IdentificacaoTomador>
      <tipos:RazaoSocial><!$MG_tomador_razao_social></tipos:RazaoSocial>
      <tipos:Endereco>
       <tipos:Endereco><!$MG_tomador_endereco></tipos:Endereco>
       <tipos:Numero><!$MG_tomador_endereco_n></tipos:Numero>
       <tipos:Complemento><!$MG_tomador_complemento>.</tipos:Complemento>
       <tipos:Bairro><!$MG_tomador_bairro></tipos:Bairro>
       <tipos:CodigoMunicipio><!$MGIF_tomador_if_uf_ext_mun>99999<!$MGELSE><!$MG_tomador_municipio><!$MGENDIF></tipos:CodigoMunicipio>
       <tipos:Uf><!$MG_tomador_uf></tipos:Uf>
       <tipos:Cep><!$MG_tomador_cep></tipos:Cep>	   
      </tipos:Endereco>
	<tipos:Contato>
	<tipos:Email>teste@email.com</tipos:Email>
	</tipos:Contato>
    </tipos:Tomador>
    </tipos:InfRps>
   </tipos:Rps>
  </tipos:ListaRps>
 </LoteRps>
</EnviarLoteRpsEnvio>

Envio Complexo

Código Fonte do modelo XML de Envio Complexo

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ServiceGinfesImplService Method="RecepcionarLoteRpsV3">
  <ServiceParameters>
    <Certificado>
      <Subject Type="System.String"><!$MG_certificado_subject></Subject>
      <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
    </Certificado>
    </ServiceParameters>
  <arg0 Type="System.String">Informar o Caminho do arquivo de Cabeçalho.txt</arg0>
  <arg1 Type="System.String"><!$MG_caminho_arquivo></arg1>
</ServiceGinfesImplService>

Retorno

Código Fonte do modelo XML de Retorno

<?xml version="1.0" encoding="UTF-8"?>
<ConsultarLoteRpsEnvio xmlns="http://www.ginfes.com.br/servico_consultar_lote_rps_envio_v03.xsd" xmlns:tipos="http://www.ginfes.com.br/tipos_v03.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<Prestador>
		<tipos:Cnpj><!$MG_lot_cnpj></tipos:Cnpj>
		<tipos:InscricaoMunicipal><!$MG_lot_inscricao_municipal></tipos:InscricaoMunicipal>
	</Prestador>
	<Protocolo><!$MG_lot_protocolo></Protocolo>
</ConsultarLoteRpsEnvio>

Retorno Complexo

Código Fonte do modelo XML de Retorno Complexo

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ServiceGinfesImplService Method="ConsultarLoteRpsV3">
  <ServiceParameters>
    <Certificado>
      <Subject Type="System.String"><!$MG_certificado_subject></Subject>
      <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
    </Certificado>
  </ServiceParameters>
  <arg0 Type="System.String">Informar o Caminho do arquivo de Cabeçalho.txt</arg0>
  <arg1 Type="System.String"><!$MG_caminho_arquivo></arg1>
</ServiceGinfesImplService>

Cancelamento

Código Fonte do modelo XML de Cancelamento

<?xml version="1.0" encoding="utf-8"?>
<e:CancelarNfseEnvio xmlns:e="http://www.ginfes.com.br/servico_cancelar_nfse_envio_v03.xsd" xmlns:tipos="http://www.ginfes.com.br/tipos_v03.xsd">
  <Pedido>
    <tipos:InfPedidoCancelamento Id="<!$MG_lot_numero_lote>">
      <tipos:IdentificacaoNfse>
        <tipos:Numero><!$MG_nf_referencia></tipos:Numero>
        <tipos:Cnpj><!$MG_lot_cnpj></tipos:Cnpj>
        <tipos:InscricaoMunicipal><!$MG_lot_inscricao_municipal></tipos:InscricaoMunicipal>
        <tipos:CodigoMunicipio>Informar Código IBGE do Município do Prestador</tipos:CodigoMunicipio>
      </tipos:IdentificacaoNfse>
      <tipos:CodigoCancelamento>0001</tipos:CodigoCancelamento>
    </tipos:InfPedidoCancelamento>
  </Pedido>
</e:CancelarNfseEnvio>

Cancelamento Complexo

Código Fonte do modelo XML de Cancelamento Complexo

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ServiceGinfesImplService Method="CancelarNfseV3">
  <ServiceParameters>
    <Certificado>
      <Subject Type="System.String"><!$MG_certificado_subject></Subject>
      <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
    </Certificado>
  </ServiceParameters>
  <arg0 Type="System.String">Informar o Caminho do arquivo de Cabeçalho.txt</arg0>
  <arg1 Type="System.String"><!$MG_caminho_arquivo></arg1>
</ServiceGinfesImplService>

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.

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.

Versões

Versão 230502

↑ Versão 230502.a e superiores liberado na OS 755688/7.

[1] Versão 230502.a e superiores liberado na OS 755688/7.

[Versão230502 1]

Tag Código	/ns3:EnviarLoteRpsResposta/ListaMensagemRetorno/ns2:MensagemRetorno/ns2:Codigo
Tag Mensagem	/ns3:EnviarLoteRpsResposta/ListaMensagemRetorno/ns2:MensagemRetorno/ns2:Mensagem
Tag Correção	/ns3:EnviarLoteRpsResposta/ListaMensagemRetorno/ns2:MensagemRetorno/ns2:Correcao
Tag Protocolo	/ns3:EnviarLoteRpsResposta/ns3:Protocolo

Tag Código	/ns3:ConsultarLoteRpsResposta/ListaMensagemRetorno/ns4:MensagemRetorno/ns4:Codigo
Tag Mensagem	/ns3:ConsultarLoteRpsResposta/ListaMensagemRetorno/ns4:MensagemRetorno/ns4:Mensagem
Tag Correção	/ns3:ConsultarLoteRpsResposta/ListaMensagemRetorno/ns4:MensagemRetorno/ns4:Correcao
Tag Número NF	/ns3:ConsultarLoteRpsResposta/ns3:ListaNfse/ns3:CompNfse/ns4:Nfse/ns4:InfNfse/ns4:Numero
Tag Cód Verificação	/ns3:ConsultarLoteRpsResposta/ns3:ListaNfse/ns3:CompNfse/ns4:Nfse/ns4:InfNfse/ns4:CodigoVerificacao
Tag Número RPS	/ns3:ConsultarLoteRpsResposta/ns3:ListaNfse/ns3:CompNfse/ns4:Nfse/ns4:InfNfse/ns4:IdentificacaoRps/ns4:Numero

Anônimo

Pesquisa

Configurações básicas para Implementação provedor GINFES

Parametrizações Básicas

Guia Envio

TAGs

Botão Configurações

Botão Natureza

Botão Assinatura

Botão Serviços

Guia Retorno

TAGs

Botão RPS Não Proc.

Botão Assinatura

Botão Serviços

Guia Cancelamento

Botão Motivos

Botão Assinatura

Botão Serviços

Modelos

Cabecalho

Envio

Envio Complexo

Retorno

Retorno Complexo

Cancelamento

Cancelamento Complexo

Download Modelos

Versões

Versão 230502

Navegação

Ferramentas da wiki

Ferramentas de páginas