Configurações básicas para Implementação provedor System (SAPI)

De CIGAM WIKI

FAQ_CIGAM > FAQ_Fiscal > Gestão Fiscal Municipal > Configurações básicas para Implementação provedor System (SAPI)


Nesta FAQ iremos destacar parametrizações básica para integração da NFSe com o provedor System, sistema SAPI (Sistema para Gestão Municipal). Para que seja possível realizar a integração é necessário possuir o módulo Gestão Fiscal Municipal.

Municípios atendidos

  • Canela - Rio Grande do Sul
  • Erechim - Rio Grande do Sul

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.

NFSeSystemSAPIEnvio.png

TAGs

Tag Código /Retorno/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Codigo
Tag Mensagem /Retorno/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Mensagem
Tag Correção /Retorno/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Correcao
Tag Protocolo /Retorno/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/CodigoVerificacao
Envio Síncrono
Tag Número /Retorno/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/Numero
Tag Número NF /Retorno/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/Numero
Tag Cód Verificação /Retorno/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/CodigoVerificacao

Botão Configurações

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.

NFSeSystemSAPIEnvioBotaoConfiguracoes.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.

NFSeSystemSAPIEnvioBotaoNatureza.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.

NFSeSystemSAPIEnvioBotaoAssinatura.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.

NFSeSystemSAPIEnvioBotaoServiços.png

Guia Retorno

Nesta guia devem ser parametrizadas os modelos e parâmetros do retorno. Caso seja utilizar o método de Envio Síncrono, não é necessário o preenchimento desta Guia.

Guia Cancelamento

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

NFSeSystemSAPICancelamento.png

TAGs

Tag Código /Retorno/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Codigo
Tag Mensagem /Retorno/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Mensagem
Tag Correção /Retorno/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Correcao
Tag Número NF /Retorno/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.

NFSeSystemSAPICancelamentoBotaoMotivos.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.

NFSeSystemSAPICancelamentoBotaoAssinatura.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.

NFSeSystemSAPICancelamentoBotaoServiços.png

Modelos

Envio

O modelo XML de envio do provedor System sistema SAPI (Última atualização 04/02/2025).

Código Fonte do modelo XML de Envio 
<?xml version="1.0" encoding="UTF-8"?>
<EnviarLoteRpsSincronoEnvio xmlns="http://www.abrasf.org.br/nfse.xsd">
	<LoteRps Id="Lote_<!$MG_lot_numero_lote>">
	<NumeroLote><!$MG_lot_numero_lote></NumeroLote>
	  <CpfCnpj>
	    <Cnpj><!$MG_lot_cnpj></Cnpj>
	  </CpfCnpj>
	  <InscricaoMunicipal><!$MG_lot_inscricao_municipal></InscricaoMunicipal>
	  <QuantidadeRps><!$MG_lot_quantidade_rps></QuantidadeRps>
	  <ListaRps>
		<Rps>		
  	     <InfDeclaracaoPrestacaoServico Id="RPS_<!$MG_lot_numero_lote>" Type="tcInfDeclaracaoPrestacaoServico" Complex="True">
		  <Rps>
            <IdentificacaoRps>
              <Numero><!$MG_nf></Numero>
              <Serie><!$MG_serie></Serie>
              <Tipo><!$MG_tipo_serv_merc></Tipo>
            </IdentificacaoRps>
            <DataEmissao><!$MG_emissao></DataEmissao>
            <Status><!$MG_status></Status>
          </Rps>
        <Competencia><!$MG_emissao></Competencia>
        <Servico>
          <Valores>
            <ValorServicos><!$MG_ag_val_servico></ValorServicos>
	    <ValorIss><!$MG_ag_val_iss></ValorIss>
            <Aliquota><!$MG_ag_aliquota_100></Aliquota>
          </Valores>
		  <!$MGIF_ag_iss_retido>
		  <IssRetido>1</IssRetido>
		  <!$MGELSE>
		  <IssRetido>2</IssRetido>
		  <!$MGENDIF>
          <ItemListaServico><!$MG_mov_cod_servico_pontos></ItemListaServico>
          <Discriminacao><!$MG_mov_material_descricao> <!$MG_mov_descricao></Discriminacao>
          <CodigoMunicipio><!$MG_tomador_municipio></CodigoMunicipio>
          <ExigibilidadeISS>1</ExigibilidadeISS>
          <MunicipioIncidencia><!$MG_municipio_prestacao_ibge></MunicipioIncidencia>
        </Servico>
        <Prestador>
          <CpfCnpj>
            <Cnpj><!$MG_prestador_cnpj></Cnpj>
          </CpfCnpj>
          <InscricaoMunicipal><!$MG_prestador_ins_municipal></InscricaoMunicipal>
        </Prestador>
        <Tomador>
          <IdentificacaoTomador>
            <CpfCnpj>
	        <!$MGIF_tomador_if_pess><Cpf><!$MG_tomador_cpf></Cpf><!$MGELSE><Cnpj><!$MG_tomador_cnpj></Cnpj><!$MGENDIF>
            </CpfCnpj>
	    <InscricaoMunicipal><!$MG_tomador_insc_municipal></InscricaoMunicipal>
          </IdentificacaoTomador>
          <RazaoSocial><!$MG_tomador_razao_social></RazaoSocial>
          <Endereco>
            <Endereco><!$MG_tomador_endereco></Endereco>
            <Numero><!$MG_tomador_endereco_n></Numero>
	    <!$MGIF_tomador_compl_infor><Complemento><!$MG_tomador_complemento></Complemento><!$MGENDIF>						
            <Bairro><!$MG_tomador_bairro></Bairro>
            <CodigoMunicipio><!$MG_tomador_municipio></CodigoMunicipio>
            <Uf><!$MG_tomador_uf></Uf>
	    <CodigoPais>1058</CodigoPais>
            <Cep><!$MG_tomador_cep></Cep>
          </Endereco>
          <Contato>
		<!$MGIF_existe_fone_cliente><Telefone><!$MG_tomador_telefone></Telefone><!$MGENDIF>
		<!$MGIF_existe_email_cliente><Email><!$MG_tomador_email></Email><!$MGENDIF>
          </Contato>
        </Tomador>
        <OptanteSimplesNacional>2</OptanteSimplesNacional>
        <IncentivoFiscal>2</IncentivoFiscal>
      </InfDeclaracaoPrestacaoServico>
    </Rps>
  </ListaRps>
</LoteRps>
</EnviarLoteRpsSincronoEnvio>

Complexo

Código Fonte do modelo XML de Envio Complexo 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<NfseService Method="EnviarLoteRpsSincrono">
  <ServiceParameters>
    <Certificado>
      <Subject Type="System.String"><!$MG_certificado_subject></Subject>
      <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
    </Certificado>
    <Proxy>
      <Endereco Type="System.String">null</Endereco>
      <Usuario Type="System.String">null</Usuario>
      <Senha Type="System.String">null</Senha>
    </Proxy>
  </ServiceParameters>
    <nfseCabecMsg Type="System.String">null</nfseCabecMsg>
	<nfseDadosMsg Type="System.String"><!$MG_caminho_arquivo></nfseDadosMsg>
</NfseService>

Cancelamento

O modelo XML de Cancelamento do provedor System sistema SAPI (Última atualização 04/02/2025).

Código Fonte do modelo XML de Cancelamento 
<?xml version="1.0" encoding="UTF-8"?>
<CancelarNfseEnvio xmlns="http://www.abrasf.org.br/nfse.xsd">
	<Pedido>
		<InfPedidoCancelamento Id="pedidoCancelamento_908687870001096038247">
			<IdentificacaoNfse>
				<Numero><!$MG_nf_referencia></Numero>
				<CpfCnpj>
					<Cnpj><!$MG_prestador_cnpj></Cnpj>
				</CpfCnpj>
				<InscricaoMunicipal><!$MG_prestador_ins_municipal></InscricaoMunicipal>
				<CodigoMunicipio>4307005</CodigoMunicipio>
			</IdentificacaoNfse>
			<CodigoCancelamento><!$MG_cod_cancelamento></CodigoCancelamento>
		</InfPedidoCancelamento>
	</Pedido>
</CancelarNfseEnvio>

Complexo

Código Fonte do modelo XML de Cancelamento Complexo 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<NfseService Method="CancelarNfse">
  <ServiceParameters>
    <Certificado>
      <Subject Type="System.String"><!$MG_certificado_subject></Subject>
      <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
    </Certificado>
    <Proxy>
      <Endereco Type="System.String">null</Endereco>
      <Usuario Type="System.String">null</Usuario>
      <Senha Type="System.String">null</Senha>
    </Proxy>
  </ServiceParameters>
    <nfseCabecMsg Type="System.String">null</nfseCabecMsg>
	<nfseDadosMsg Type="System.String"><!$MG_caminho_arquivo></nfseDadosMsg>
</NfseService>
Disponível em "https://www.cigam.com.br/wiki/index.php?title=Configurações_básicas_para_Implementação_provedor_System_(SAPI)&oldid=142953"