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

De CIGAM WIKI
Revisão de 18h33min de 3 de abril de 2025 por Israel.petry (discussão | contribs) (→TAGs)
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)

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

[editar]
  • Canela - Rio Grande do Sul
  • Erechim - Rio Grande do Sul

Parametrizações Básicas

[editar]

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

Guia Envio

[editar]

Abaixo seguem informações de parametrização dos campos.

TAGs

[editar]
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

[editar]

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 Natureza

[editar]

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

[editar]

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

[editar]

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.

Guia Retorno

[editar]

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

[editar]

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

TAGs

[editar]
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

[editar]

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

[editar]

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

[editar]

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.

Modelos

[editar]

Envio

[editar]

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

[editar]
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

[editar]

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

[editar]
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”