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

De CIGAM WIKI
Revisão de 19h07min de 21 de março de 2025 por Israel.petry (discussão | contribs)
(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 Betha


Nesta FAQ iremos destacar parametrizações básica para integração da NFSe com o provedor Betha. 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.

NFSeBethaEnvio.png

TAGs

Tag Código /Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/tcMensagemRetorno/Codigo
Tag Mensagem /Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/tcMensagemRetorno/Mensagem
Tag Correção /Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/tcMensagemRetorno/Correcao
Tag Protocolo /Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/Protocolo

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.

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

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

NFSeBethaEnvioBotaoServiços.png

Guia Retorno

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

NFSeBethaRetorno.png

TAGs

Tag Código /Retorno/ConsultarLoteRpsEnvioResponse/consultarNotaResp/tcCompNfse/tcNfse/tcInfNfse/CodigoVerificacao
Tag Mensagem /Retorno/ConsultarLoteRpsEnvioResponse/consultarNotaResp/tcMensagemRetorno/Mensagem
Tag Correção /Retorno/ConsultarLoteRpsEnvioResponse/consultarNotaResp/tcMensagemRetorno/Correcao
Tag Número NF /Retorno/ConsultarLoteRpsEnvioResponse/consultarNotaResp/tcCompNfse/tcNfse/tcInfNfse/Numero
Tag Cód Verificação /Retorno/ConsultarLoteRpsEnvioResponse/consultarNotaResp/tcCompNfse/tcNfse/tcInfNfse/CodigoVerificacao
Tag Série /Retorno/ConsultarLoteRpsEnvioResponse/consultarNotaResp/tcCompNfse/tcNfse/tcInfNfse/tcIdentificacaoRps/Serie
Tag Número RPS /Retorno/ConsultarLoteRpsEnvioResponse/consultarNotaResp/tcCompNfse/tcNfse/tcInfNfse/tcIdentificacaoRps/Numero
Tag Protocolo /Retorno/EnviarLoteRpsEnvioResponse/enviarLoteRpsResposta/Protocolo

Botão Assinatura

Este provedor não requer assinatura do método de Cancelamento.

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.

NFSeBethaRetornoBotaoServiços.png

Guia Cancelamento

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

NFSeBethaCancelamento.png

TAGs

Tag Código /Retorno/CancelarNfseEnvioResponse/cancelarNfseResposta/tcCancelamentoNfse/tcConfirmacaoCancelamento/
tcPedidoCancelamento/tcInfPedidoCancelamento/CodigoCancelamento
Tag Mensagem
Tag Correção
Tag Número NF /Retorno/CancelarNfseEnvioResponse/cancelarNfseResposta/tcCancelamentoNfse/tcConfirmacaoCancelamento/
tcPedidoCancelamento/tcInfPedidoCancelamento/tcIdentificacaoNfse/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.

NFSeBethaCancelamentoBotaoMotivos.png

Botão Assinatura

Este provedor não requer assinatura do método de Cancelamento.

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.

NFSeBethaCancelamentoBotaoServiços.png


Modelos

Cabecalho

Envio

O modelo XML de envio do provedor Betha (Última atualização 26/02/2014).

Código Fonte do modelo XML de Envio 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<RecepcionarLoteRpsService Method="EnviarLoteRpsEnvio" SignatureTags="InfRps;LoteRps" SignatureIndex="0">
  <ServiceParameters>
    <Certificado>
      <Subject Type="System.String"><!$MG_certificado_subject></Subject>
      <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
    </Certificado>
  </ServiceParameters>
  <EnviarLoteRpsEnvio1 Type="EnviarLoteRpsEnvio" Complex="True">
    <LoteRps Type="tcLoteRps" Complex="True">
      <NumeroLote Type="System.Int64"><!$MG_lot_numero_lote></NumeroLote>
      <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>

Retorno

O modelo XML de Retorno do provedor Betha (Última atualização 26/02/2014).

Código Fonte do modelo XML de Retorno 
<?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>

Cancelamento

O modelo XML de Cancelamento do provedor Betha (Última atualização 26/02/2014).

Código Fonte do modelo XML de Cancelamento 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<CancelarNEV01Service Method="CancelarNfseEnvio" SignatureTags="InfPedidoCancelamento" SignatureIndex="0">>
  <ServiceParameters>
    <Certificado>
      <Subject Type="System.String"><!$MG_certificado_subject></Subject>
      <CNPJ Type="System.String"><!$MG_certificado_cnpj></CNPJ>
    </Certificado>
    <Proxy>
      <Endereco Type="System.String">10.104.8.221:3128</Endereco>
      <Usuario Type="System.String"><!$MG_proxy_usuario></Usuario>
      <Senha Type="System.String"><!$MG_proxy_senha></Senha>
    </Proxy>
  </ServiceParameters>
  <CancelarNfseEnvio1 Type="CancelarNfseEnvio" Complex="True">
    <Pedido Type="tcPedidoCancelamento" Complex="True">
      <InfPedidoCancelamento Type="tcInfPedidoCancelamento" Complex="True">
        <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>
Disponível em "https://www.cigam.com.br/wiki/index.php?title=Configurações_básicas_para_Implementação_provedor_Betha&oldid=142465"