Configurações básicas para Implementação provedor System (SAPI): mudanças entre as edições

De CIGAM WIKI
Israel.petry (discussão | contribs)
Administradores da interface, Administradores
12 626 edições
 
 
(13 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 5: Linha 5:
<p align="justify">
<p align="justify">
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 [[EM_Gestão_Municipal|Gestão Fiscal Municipal]].</p>
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 [[EM_Gestão_Municipal|Gestão Fiscal Municipal]].</p>
=Municípios atendidos=
* Canela - Rio Grande do Sul
* Erechim - Rio Grande do Sul


=Parametrizações Básicas=
=Parametrizações Básicas=
Linha 10: Linha 14:
As parametrizações devem ser realizadas através do menu [[Fiscal]] > [[EM_Gestão_Municipal|Gestão Fiscal Municipal]] > [[EM_Parâmetros|Parâmetros]] > [[EM_Cadastro NFS-e Configurável|Cadastro NFS-e Configurável]].</p>
As parametrizações devem ser realizadas através do menu [[Fiscal]] > [[EM_Gestão_Municipal|Gestão Fiscal Municipal]] > [[EM_Parâmetros|Parâmetros]] > [[EM_Cadastro NFS-e Configurável|Cadastro NFS-e Configurável]].</p>


<!--
==Guia Envio==
==Guia Envio==
<p align="justify">
<p align="justify">
Abaixo seguem informações de parametrização dos campos.</p>
Abaixo seguem informações de parametrização dos campos.</p>


<p>[[Image:NFSeBethaEnvio.png|550px|center]]</p>
<p>[[Image:NFSeSystemSAPIEnvio.png|550px|center]]</p>


==== TAGs ====
==== TAGs ====
{| class="wikitable" style="margin:auto;width:100%"
{| class="wikitable" style="margin:auto;width:100%"
|-
|-
| <font size="2">Tag Código </font>|| <font size="2">/Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/tcMensagemRetorno/Codigo</font>
| <font size="2">Tag Código </font>|| <font size="2">/Retorno/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Codigo</font>
|-
| <font size="2">Tag Mensagem</font> || <font size="2">/Retorno/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Mensagem</font>
|-
|-
| <font size="2">Tag Mensagem</font> || <font size="2">/Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/tcMensagemRetorno/Mensagem</font>
| <font size="2">Tag Correção</font> || <font size="2">/Retorno/EnviarLoteRpsSincronoResposta/ListaMensagemRetorno/MensagemRetorno/Correcao</font>
|-
|-
| <font size="2">Tag Correção</font> || <font size="2">/Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/tcMensagemRetorno/Correcao</font>
| <font size="2">Tag Protocolo</font> || <font size="2">/Retorno/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/CodigoVerificacao</font>
|-
|-
| <font size="2">Tag Protocolo</font> || <font size="2">/Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/Protocolo</font>
| colspan="2"|<font size="2"> '''Envio Síncrono'''</font>
|-
| <font size="2">Tag Número</font> || <font size="2">/Retorno/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/Numero</font>
|-
| <font size="2">Tag Número NF</font> || <font size="2">/Retorno/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/Numero</font>
|-
| <font size="2">Tag Cód Verificação</font> || <font size="2">/Retorno/EnviarLoteRpsSincronoResposta/ListaNfse/CompNfse/Nfse/InfNfse/CodigoVerificacao</font>
|}
|}
===Botão Configurações===
<p align="justify">
<font color="red">'''Importante:'''</font> 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.</p>
<p>[[Image:NFSeSystemSAPIEnvioBotaoConfiguracoes.png|450px|center]]</p>


===Botão Natureza===
===Botão Natureza===
Linha 36: Linha 53:
<font color="red">'''Importante:'''</font> 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.</p>
<font color="red">'''Importante:'''</font> 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.</p>


<p>[[Image:NFSeBethaEnvioBotaoNatureza.png|750px|center]]</p>
<p>[[Image:NFSeSystemSAPIEnvioBotaoNatureza.png|750px|center]]</p>


===Botão Assinatura===
===Botão Assinatura===
Linha 42: Linha 59:
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.</p>
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.</p>


<p>[[Image:NFSeBethaEnvioBotaoAssinatura.png|550px|center]]</p>
<p>[[Image:NFSeSystemSAPIEnvioBotaoAssinatura.png|550px|center]]</p>


===Botão Serviços===
===Botão Serviços===
Linha 48: Linha 65:
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.</p>
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.</p>


<p>[[Image:NFSeBethaEnvioBotaoServiços.png|550px|center]]</p>
<p>[[Image:NFSeSystemSAPIEnvioBotaoServiços.png|550px|center]]</p>


==Guia Retorno==
==Guia Retorno==
<p align="justify">
<p align="justify">
Nesta guia devem ser parametrizadas os modelos e parâmetros do retorno.</p>
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.</p>


<!--
<p>[[Image:NFSeBethaRetorno.png|550px|center]]</p>
<p>[[Image:NFSeBethaRetorno.png|550px|center]]</p>


Linha 78: Linha 96:
===Botão Assinatura===
===Botão Assinatura===
<p align="justify">
<p align="justify">
Este provedor não requer assinatura do método de Cancelamento.
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.</p>
 
<p>[[Image:NFSeSystemSAPIRetornoBotaoAssinatura.png|550px|center]]</p>


===Botão Serviços===
===Botão Serviços===
Linha 84: Linha 104:
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.</p>
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.</p>


<p>[[Image:NFSeBethaRetornoBotaoServiços.png|550px|center]]</p>
<p>[[Image:NFSeSystemSAPIRetornoBotaoServiços.png|550px|center]]</p>
 
-->
==Guia Cancelamento==
==Guia Cancelamento==
<p align="justify">
<p align="justify">
Nesta guia devemos parametrizar os modelos de envio do Cancelamento e as respectivas TAGs.</p>
Nesta guia devemos parametrizar os modelos de envio do Cancelamento e as respectivas TAGs.</p>


<p>[[Image:NFSeBethaCancelamento.png|550px|center]]</p>
<p>[[Image:NFSeSystemSAPICancelamento.png|550px|center]]</p>


==== TAGs ====
==== TAGs ====
{| class="wikitable" style="margin:auto;width:100%"
{| class="wikitable" style="margin:auto;width:100%"
|-
|-
| <font size="2">Tag Código </font>|| <font size="2">/Retorno/CancelarNfseEnvioResponse/cancelarNfseResposta/tcCancelamentoNfse/tcConfirmacaoCancelamento/<br/>tcPedidoCancelamento/tcInfPedidoCancelamento/CodigoCancelamento</font>
| <font size="2">Tag Código </font>|| <font size="2">/Retorno/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Codigo</font>
|-
|-
| <font size="2">Tag Mensagem</font> || <font size="1"></font>
| <font size="2">Tag Mensagem</font> || <font size="2">/Retorno/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Mensagem</font>
|-
|-
| <font size="2">Tag Correção</font> || <font size="1"></font>
| <font size="2">Tag Correção</font> || <font size="2">/Retorno/CancelarNfseResposta/ListaMensagemRetorno/MensagemRetorno/Correcao</font>
|-
|-
| <font size="2">Tag Número NF</font> || <font size="2">/Retorno/CancelarNfseEnvioResponse/cancelarNfseResposta/tcCancelamentoNfse/tcConfirmacaoCancelamento/<br/>tcPedidoCancelamento/tcInfPedidoCancelamento/tcIdentificacaoNfse/Numero</font>
| <font size="2">Tag Número NF</font> || <font size="2">/Retorno/CancelarNfseResposta/RetCancelamento/NfseCancelamento/Confirmacao/Pedido/InfPedidoCancelamento<br/>/IdentificacaoNfse/Numero</font>
|}
|}


Linha 108: Linha 128:
Neste botão devemos informar os respectivos códigos assim com a descrição (motivo) do cancelamento, conforme detalhado no manual de Integração.</p>
Neste botão devemos informar os respectivos códigos assim com a descrição (motivo) do cancelamento, conforme detalhado no manual de Integração.</p>


<p>[[Image:NFSeBethaCancelamentoBotaoMotivos.png|550px|center]]</p>
<p>[[Image:NFSeSystemSAPICancelamentoBotaoMotivos.png|550px|center]]</p>


===Botão Assinatura===
===Botão Assinatura===
<p align="justify">
<p align="justify">
Este provedor não requer assinatura do método de Cancelamento.
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.</p>
 
<p>[[Image:NFSeSystemSAPICancelamentoBotaoAssinatura.png|550px|center]]</p>


===Botão Serviços===
===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.</p>
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.</p>


<p>[[Image:NFSeBethaCancelamentoBotaoServiços.png|550px|center]]</p>
<p>[[Image:NFSeSystemSAPICancelamentoBotaoServiços.png|550px|center]]</p>
 


==Modelos==
==Modelos==
===Cabecalho===
<p align="justify">
===Envio===
===Envio===
<p align="justify">
<p align="justify">
O modelo XML de envio do provedor Betha (Última atualização '''26/02/2014''').</p>
O modelo XML de envio do provedor System sistema SAPI (Última atualização '''04/02/2025''').</p>


<table class="mw-collapsible mw-collapsed wikitable" width="100%">
<table class="mw-collapsible mw-collapsed wikitable" width="100%">
     <tr>
     <tr>
         <td bgcolor="#3D4E68" align="center"><font color="#FFFFFF"><b>Código Fonte do modelo XML de Envio</b></font></td>
         <td bgcolor="#3D4E68" align="center"><font color="#FFFFFF"><b>Código Fonte do modelo XML de Envio</b></font></td>
    </tr>
    <tr>
        <td>
<pre>
<?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>
</pre>
        </td>
    </tr>
</table>
====Complexo====
<table class="mw-collapsible mw-collapsed wikitable" width="100%">
    <tr>
        <td bgcolor="#3D4E68" align="center"><font color="#FFFFFF"><b>Código Fonte do modelo XML de Envio Complexo</b></font></td>
     </tr>
     </tr>
     <tr>
     <tr>
Linha 136: Linha 242:
<pre>
<pre>
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<RecepcionarLoteRpsService Method="EnviarLoteRpsEnvio" SignatureTags="InfRps;LoteRps" SignatureIndex="0">
<NfseService Method="EnviarLoteRpsSincrono">
   <ServiceParameters>
   <ServiceParameters>
     <Certificado>
     <Certificado>
Linha 142: Linha 248:
       <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
       <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
     </Certificado>
     </Certificado>
    <Proxy>
      <Endereco Type="System.String">null</Endereco>
      <Usuario Type="System.String">null</Usuario>
      <Senha Type="System.String">null</Senha>
    </Proxy>
   </ServiceParameters>
   </ServiceParameters>
  <EnviarLoteRpsEnvio1 Type="EnviarLoteRpsEnvio" Complex="True">
     <nfseCabecMsg Type="System.String">null</nfseCabecMsg>
     <LoteRps Type="tcLoteRps" Complex="True">
<nfseDadosMsg Type="System.String"><!$MG_caminho_arquivo></nfseDadosMsg>
      <NumeroLote Type="System.Int64"><!$MG_lot_numero_lote></NumeroLote>
</NfseService>
      <Cnpj Type="System.String"><!$MG_lot_cnpj></Cnpj>
      <InscricaoMunicipal Type="System.String"><!$MG_prestador_ins_municipal></InscricaoMunicipal>
      <QuantidadeRps Type="System.Int32"><!$MG_lot_quantidade_rps></QuantidadeRps>
      <ListaRps Type="tcRps" Complex="True" Array="True" Index="0">
        <InfRps Type="tcInfRps" Complex="True">
          <IdentificacaoRps Type="tcIdentificacaoRps" Complex="True">
            <Numero Type="System.String"><!$MG_nf></Numero>
            <Serie Type="System.String"><!$MG_serie></Serie>
            <Tipo Type="System.Int32"><!$MG_tipo_serv_merc></Tipo>
          </IdentificacaoRps>
          <DataEmissao Type="System.DateTime"><!$MG_emissao>T07:00:00</DataEmissao>
          <NaturezaOperacao Type="System.Int32">1</NaturezaOperacao>
          <RegimeEspecialTributacao Type="System.Int32">1</RegimeEspecialTributacao>
          <RegimeEspecialTributacaoSpecified Type="System.Boolean">true</RegimeEspecialTributacaoSpecified>
          <OptanteSimplesNacional Type="System.Int32"><!$MG_optante_simples></OptanteSimplesNacional>
          <IncentivadorCultural Type="System.Int32">2</IncentivadorCultural>
          <Status Type="System.Int32"><!$MG_status></Status>
          <RpsSubstituido Type="tcIdentificacaoRps" Complex="True">
            <Numero Type="System.String">null</Numero>
            <Serie Type="System.String">null</Serie>
            <Tipo Type="System.Int32">null</Tipo>
          </RpsSubstituido>
          <Servico Type="tcDadosServico" Complex="True">
            <Valores Type="tcValores" Complex="True">
              <ValorServicos Type="System.Decimal"><!$MG_ag_val_servico></ValorServicos>
              <ValorDeducoes Type="System.Decimal">null</ValorDeducoes>
              <ValorDeducoesSpecified Type="System.Boolean">null</ValorDeducoesSpecified>
              <ValorPis Type="System.Decimal"><!$MG_ag_val_pis></ValorPis>
              <ValorPisSpecified Type="System.Boolean">true</ValorPisSpecified>
              <ValorCofins Type="System.Decimal"><!$MG_ag_val_cofins></ValorCofins>
              <ValorCofinsSpecified Type="System.Boolean">true</ValorCofinsSpecified>
              <ValorInss Type="System.Decimal"><!$MG_ag_val_inss></ValorInss>
              <ValorInssSpecified Type="System.Boolean">true</ValorInssSpecified>
              <ValorIr Type="System.Decimal"><!$MG_ag_val_irrf></ValorIr>
              <ValorIrSpecified Type="System.Boolean">true</ValorIrSpecified>
              <ValorCsll Type="System.Decimal"><!$MG_ag_val_csll></ValorCsll>
              <ValorCsllSpecified Type="System.Boolean">true</ValorCsllSpecified>
              <IssRetido Type="System.Int32"><!$MGIF_ag_iss_retido>1<!$MGELSE>2<!$MGENDIF></IssRetido>
              <IssRetidoSpecified Type="System.Boolean">true</IssRetidoSpecified>
              <ValorIss Type="System.Decimal"><!$MG_ag_val_iss></ValorIss>
              <ValorIssSpecified Type="System.Boolean">true</ValorIssSpecified>
              <OutrasRetencoes Type="System.Decimal">null</OutrasRetencoes>
              <OutrasRetencoesSpecified Type="System.Boolean">null</OutrasRetencoesSpecified>
              <BaseCalculo Type="System.Decimal"><!$MG_ag_val_base_calc></BaseCalculo>
              <Aliquota Type="System.Decimal"><!$MG_ag_aliquota_100></Aliquota>
              <AliquotaSpecified Type="System.Boolean">true</AliquotaSpecified>
              <ValorLiquidoNfse Type="System.Decimal"><!$MG_ag_val_liquido_2></ValorLiquidoNfse>
              <ValorLiquidoNfseSpecified Type="System.Boolean">true</ValorLiquidoNfseSpecified>
              <ValorIssRetido Type="System.Decimal">0.00</ValorIssRetido>
              <ValorIssRetidoSpecified Type="System.Boolean">true</ValorIssRetidoSpecified>
              <DescontoCondicionado Type="System.Decimal">0.00</DescontoCondicionado>
              <DescontoCondicionadoSpecified Type="System.Boolean">true</DescontoCondicionadoSpecified>
              <DescontoIncondicionado Type="System.Decimal"><!$MG_ag_val_desc_incondicional></DescontoIncondicionado>
              <DescontoIncondicionadoSpecified Type="System.Boolean">true</DescontoIncondicionadoSpecified>
            </Valores>
            <ItemListaServico Type="System.String">0701</ItemListaServico>
            <CodigoCnae Type="System.Int32">null</CodigoCnae>
            <CodigoCnaeSpecified Type="System.Boolean">false</CodigoCnaeSpecified>
            <CodigoTributacaoMunicipio Type="System.String">422190401</CodigoTributacaoMunicipio>
            <Discriminacao Type="System.String"><!$MGREPEAT><!$MG_mov_material_descricao> <!$MG_mov_descricao> <!$MG_mov_mat_aplicacao> <!$MG_i_total_imposto_aproximado> <!$MGENDREPEAT></Discriminacao>
            <CodigoMunicipio Type="System.Int32"><!$MG_tomador_municipio></CodigoMunicipio>
          </Servico>
          <Prestador Type="tcIdentificacaoPrestador" Complex="True">
            <Cnpj Type="System.String"><!$MG_prestador_cnpj></Cnpj>
            <InscricaoMunicipal Type="System.String"><!$MG_prestador_ins_municipal></InscricaoMunicipal>
          </Prestador>
          <Tomador Type="tcDadosTomador" Complex="True">
            <IdentificacaoTomador Type="tcIdentificacaoTomador" Complex="True">
              <CpfCnpj Type="tcCpfCnpj" Complex="True">
<!$MGIF_tomador_if_pess>
                <Cpf Type="System.String"><!$MG_tomador_cpf></Cpf>
<!$MGELSE>
                <Cnpj Type="System.String"><!$MG_tomador_cnpj></Cnpj>
<!$MGENDIF>
              </CpfCnpj>
              <InscricaoMunicipal Type="System.String">null</InscricaoMunicipal>
            </IdentificacaoTomador>
            <RazaoSocial Type="System.String"><!$MG_tomador_razao_social></RazaoSocial>
            <Endereco Type="tcEndereco" Complex="True">
              <Endereco Type="System.String"><!$MG_tomador_endereco></Endereco>
              <Numero Type="System.String"><!$MG_tomador_endereco_n></Numero>
              <Complemento Type="System.String"><!$MGIF_tomador_compl_infor><!$MG_tomador_complemento><!$MGELSE>null<!$MGENDIF></Complemento>
              <Bairro Type="System.String"><!$MG_tomador_bairro></Bairro>
              <CodigoMunicipio Type="System.Int32"><!$MG_tomador_municipio></CodigoMunicipio>
              <CodigoMunicipioSpecified Type="System.Boolean">true</CodigoMunicipioSpecified>
              <Uf Type="System.String"><!$MG_tomador_uf></Uf>
              <Cep Type="System.Int32"><!$MG_tomador_cep></Cep>
              <CepSpecified Type="System.Boolean">true</CepSpecified>
            </Endereco>
            <Contato Type="tcContato" Complex="True">
              <Telefone Type="System.String">null</Telefone>
              <Email Type="System.String">null</Email>
            </Contato>
          </Tomador>
          <OutrasInformacoes Type="System.String">null</OutrasInformacoes>
          <CondicaoPagamento Type="tcCondicoesPagamentos" Complex="True">
            <Condicao Type="Condicao">null</Condicao>
            <QtdParcela Type="System.Int32">null</QtdParcela>
            <QtdParcelaSpecified Type="System.Boolean">null</QtdParcelaSpecified>
            <Parcelas Type="tcParcelas" Complex="True" Array="True" Index="0">
              <Parcela Type="System.Int32">null</Parcela>
              <DataVencimento Type="System.String">null</DataVencimento>
              <Valor Type="System.Decimal">null</Valor>
              <ValorSpecified Type="System.Boolean">null</ValorSpecified>
            </Parcelas>
          </CondicaoPagamento>
          <Id Type="System.String">rps_<!$MG_lot_numero_lote></Id>
        </InfRps>
        </ListaRps>
</LoteRps>
  </EnviarLoteRpsEnvio1>
</RecepcionarLoteRpsService>
</pre>
</pre>
         </td>
         </td>
     </tr>
     </tr>
</table>
</table>
 
<!--
===Retorno===
===Retorno===
<p align="justify">
<p align="justify">
Linha 274: Linha 273:
         <td>
         <td>
<pre>
<pre>
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
 
<ConsultarLoteRpsService Method="ConsultarLoteRpsEnvio">
  <ServiceParameters>
    <Certificado>
      <Subject Type="System.String"><!$MG_certificado_subject></Subject>
      <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
    </Certificado>
    <Proxy>
      <Endereco Type="System.String"><!$MG_proxy_endereco></Endereco>
      <Usuario Type="System.String"><!$MG_proxy_usuario></Usuario>
      <Senha Type="System.String"><!$MG_proxy_senha></Senha>
    </Proxy>
  </ServiceParameters>
  <ConsultarLoteRpsEnvio1 Type="ConsultarLoteRpsEnvio" Complex="True">
    <Prestador Type="tcIdentificacaoPrestador" Complex="True">
      <Cnpj Type="System.String"><!$MG_lot_cnpj></Cnpj>
      <InscricaoMunicipal Type="System.String"><!$MG_prestador_ins_municipal></InscricaoMunicipal>
    </Prestador>
    <Protocolo Type="System.Int64"><!$MG_lot_protocolo></Protocolo>
    <ProtocoloSpecified Type="System.Boolean">true</ProtocoloSpecified>
  </ConsultarLoteRpsEnvio1>
</ConsultarLoteRpsService>
</pre>
</pre>
         </td>
         </td>
     </tr>
     </tr>
</table>
</table>
-->


===Cancelamento===
===Cancelamento===
O modelo XML de Cancelamento do provedor Betha (Última atualização '''26/02/2014''').</p>
O modelo XML de Cancelamento do provedor System sistema SAPI (Última atualização '''04/02/2025''').</p>


<table class="mw-collapsible mw-collapsed wikitable" width="100%">
<table class="mw-collapsible mw-collapsed wikitable" width="100%">
     <tr>
     <tr>
         <td bgcolor="#3D4E68" align="center"><font color="#FFFFFF"><b>Código Fonte do modelo XML de Cancelamento</b></font></td>
         <td bgcolor="#3D4E68" align="center"><font color="#FFFFFF"><b>Código Fonte do modelo XML de Cancelamento</b></font></td>
    </tr>
    <tr>
        <td>
<pre>
<?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>
</pre>
        </td>
    </tr>
</table>
====Complexo====
<table class="mw-collapsible mw-collapsed wikitable" width="100%">
    <tr>
        <td bgcolor="#3D4E68" align="center"><font color="#FFFFFF"><b>Código Fonte do modelo XML de Cancelamento Complexo</b></font></td>
     </tr>
     </tr>
     <tr>
     <tr>
Linha 312: Linha 320:
<pre>
<pre>
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<CancelarNEV01Service Method="CancelarNfseEnvio" SignatureTags="InfPedidoCancelamento" SignatureIndex="0">>
<NfseService Method="CancelarNfse">
   <ServiceParameters>
   <ServiceParameters>
     <Certificado>
     <Certificado>
Linha 319: Linha 327:
     </Certificado>
     </Certificado>
     <Proxy>
     <Proxy>
       <Endereco Type="System.String">10.104.8.221:3128</Endereco>
       <Endereco Type="System.String">null</Endereco>
       <Usuario Type="System.String"><!$MG_proxy_usuario></Usuario>
       <Usuario Type="System.String">null</Usuario>
       <Senha Type="System.String"><!$MG_proxy_senha></Senha>
       <Senha Type="System.String">null</Senha>
     </Proxy>
     </Proxy>
   </ServiceParameters>
   </ServiceParameters>
  <CancelarNfseEnvio1 Type="CancelarNfseEnvio" Complex="True">
     <nfseCabecMsg Type="System.String">null</nfseCabecMsg>
     <Pedido Type="tcPedidoCancelamento" Complex="True">
<nfseDadosMsg Type="System.String"><!$MG_caminho_arquivo></nfseDadosMsg>
      <InfPedidoCancelamento Type="tcInfPedidoCancelamento" Complex="True">
</NfseService>
        <IdentificacaoNfse Type="tcIdentificacaoNfse" Complex="True">
          <Numero Type="System.String"><!$MG_nf_referencia></Numero>
          <Cnpj Type="System.String"><!$MG_lot_cnpj></Cnpj>
          <InscricaoMunicipal Type="System.String"><!$MG_prestador_ins_municipal></InscricaoMunicipal>
          <CodigoMunicipio Type="System.String"><!$MG_prestador_cod_munic></CodigoMunicipio>
        </IdentificacaoNfse>
        <CodigoCancelamento Type="System.String"><!$MG_cod_cancelamento></CodigoCancelamento>
        <Id Type="System.String">Cancelamento_<!$MG_lot_cnpj></Id>
      </InfPedidoCancelamento>   
    </Pedido>
  </CancelarNfseEnvio1>
</CancelarNEV01Service>
</pre>
</pre>
         </td>
         </td>
     </tr>
     </tr>
</table>
</table>

Edição atual tal como às 18h33min de 3 de abril de 2025

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.

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.

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.

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.

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.

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.

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”