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

De CIGAM WIKI

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

[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/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

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

TAGs

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

[editar]

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

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 Cancelamento

[editar]

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

TAGs

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

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

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

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]

Cabecalho

[editar]

Envio

[editar]

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

[editar]

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

[editar]

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”