PORTAL DE DOCUMENTAÇÃO
Gestão Empresarial | ERP - versão 5.10.3 (XTended)
Devido à descontinuação da versão 5.10.3, que ocorrerá em 30/09/2025, informamos que este manual não receberá atualizações a partir desta data. Para mais informações sobre a evolução do Gestão Empresarial | ERP, acesse a documentação sobre a PCVV - Política do Ciclo de Vida das Versões.

Informamos que as funcionalidades da Reforma Tributária estão disponíveis apenas a partir da versão 5.10.4 do Gestão Empresarial.
Acesse o Portal de Exigências Legais da Senior para saber como preparar o seu negócio!

Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.mct.imp.reinf.detalhamentoretencoes

Web service Com.senior.g5.co.mct.imp.reinf.detalhamentoretencoes

Este web service permite inserir e alterar os lançamentos.

Tipo de execução

Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.

Autenticação

Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificar o tipo no parâmetro <encryption>, conforme seus valores possíveis.

Campos numéricos

Orientação válida para qualquer campo de web service que possui objetivo de receber valores, independentemente do seu tipo ser Integer, Double e String. Estas orientações devem ser seguidas nas requisições efetuadas via SOAP e em execuções efetuadas através do SGI, relatórios e regras LSP.

ClosedCampos que representam valores monetários, quantidade e percentual e estão declarados como String
  • Envio no formato ZZZZ,ZZ
  • É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
  • Obrigatória a utilização do separador decimal com vírgula, e não com ponto
  • Obrigatória a utilização do zero a direita. Por exemplo, se o valor for 350,20, a requisição deve ser enviada com este exato valor. Se o valor enviado for enviado como 350,2, o sistema não irá interpretar a requisição adequadamente
ClosedExemplo:

number(005,2) = 350,20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;

number(015,2): 35000,20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;

number(008,4) = 3200,2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.

ClosedCampos que representam valores monetários, quantidade e percentual e não estão declarados como String
  • Envio no formato ZZZZ.ZZ
  • É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
  • Obrigatória a utilização do separador decimal com ponto, e não com vírgula
ClosedExemplo:
  • number(005,2) = 350.20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
  • number(015,2): 35000.20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
  • number(008,4) = 3200.2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.

WSDL

Porta

ClosedImportar
Importar

Necessita autenticação: Sim.

Situação da versão: Atual.

Versão: 1.

ClosedRequisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:Importar>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <ContribuicaoPrevidenciariaReceitaBruta>
          <codEmp>Integer</codEmp>
          <codFil>Integer</codFil>
          <datCpt>DateTime</datCpt>
          <codPgt>Integer</codPgt>
          <codFor>Integer</codFor>
          <nifBen>String</nifBen>
          <relPag>Integer</relPag>
          <indNif>Integer</indNif>
          <datLau>DateTime</datLau>
          <pagamentoPessoaJuridica>
            <codDfs>Integer</codDfs>
            <codSus>Double</codSus>
            <datPag>DateTime</datPag>
            <indOri>Integer</indOri>
            <vlrTri>Double</vlrTri>
            <vlrRet>Double</vlrRet>
            <cnpOri>String</cnpOri>
            <vlrCuj>Double</vlrCuj>
            <advogadosPJU>
              <codFor>Integer</codFor>
              <vlrDes>Double</vlrDes>
            </advogadosPJU>
          </pagamentoPessoaJuridica>
          <pagamentoPessoaFisica>
            <datPag>DateTime</datPag>
            <indSus>String</indSus>
            <indDec>String</indDec>
            <vlrRtr>Double</vlrRtr>
            <vlIRRF>Double</vlIRRF>
            <vlrDep>Double</vlrDep>
            <vlrAno>Double</vlrAno>
            <vlrAnt>Double</vlrAnt>
            <rendimentosRecebidosAcumuladamente>
              <codDfs>Integer</codDfs>
              <codSus>Double</codSus>
              <natRra>String</natRra>
              <qtdMes>Integer</qtdMes>
              <vlrCus>Double</vlrCus>
              <advogadosRRA>
                <codFor>Integer</codFor>
                <vlrDes>Double</vlrDes>
              </advogadosRRA>
            </rendimentosRecebidosAcumuladamente>
            <demaisRendimentosDecisaoJudicial>
              <codDfs>Integer</codDfs>
              <codSus>Double</codSus>
              <indOri>Integer</indOri>
              <cnpOri>String</cnpOri>
              <vlrCus>Double</vlrCus>
              <advogadosIPR>
                <codFor>Integer</codFor>
                <vlrDes>Double</vlrDes>
              </advogadosIPR>
            </demaisRendimentosDecisaoJudicial>
            <rendimentosIsentosNaoTributaveis>
              <tipIse>Integer</tipIse>
              <vlrIse>Double</vlrIse>
              <desRen>String</desRen>
            </rendimentosIsentosNaoTributaveis>
            <detalhamentoDeducoes>
              <tipDed>Integer</tipDed>
              <vlrDed>Double</vlrDed>
            </detalhamentoDeducoes>
            <detalhamentoCompetencias>
              <indPer>Integer</indPer>
              <vlrTri>Double</vlrTri>
              <perRef>DateTime</perRef>
            </detalhamentoCompetencias>
          </pagamentoPessoaFisica>
          <pagamentoResidenteExterior>
            <datPag>DateTime</datPag>
            <tipRen>Integer</tipRen>
            <forTri>Integer</forTri>
            <vlrDed>Double</vlrDed>
            <vliRrf>Double</vliRrf>
          </pagamentoResidenteExterior>
        </ContribuicaoPrevidenciariaReceitaBruta>
      </parameters>
    </ser:Importar>
  </soapenv:Body>
</soapenv:Envelope>
ClosedParâmetros da requisição:
NomeTipoPreenchimentoAjuda
contribuicaoPrevidenciariaReceitaBrutaSetOpcionalContribuição Previdenciária sobre a Receita Bruta
contribuicaoPrevidenciariaReceitaBruta.codEmpIntegerOpcionalNumber(004) - Código da empresa
contribuicaoPrevidenciariaReceitaBruta.codFilIntegerOpcionalNumber(005) - Código da filial
contribuicaoPrevidenciariaReceitaBruta.datCptDateTimeOpcionalDate(MM/YYYY) - Data de Competência
contribuicaoPrevidenciariaReceitaBruta.codPgtIntegerOpcionalNumber(004) - Código do Pagamento
contribuicaoPrevidenciariaReceitaBruta.codForIntegerOpcionalNumber(009) - Código do Fornecedor
contribuicaoPrevidenciariaReceitaBruta.nifBenStringOpcionalString(020) - Número de Identificação Fiscal - NIF
contribuicaoPrevidenciariaReceitaBruta.relPagIntegerOpcionalNumber(003) - Relação fonte pagadora pessoa jurídica e beneficiário pessoa jurídica - [ 500=A fonte pagadora é matriz da beneficiária no exterior;510=A fonte pagadora é filial, sucursal ou agência de beneficiária no exterior;520=A fonte pagadora é controlada ou coligada da beneficiária no exterior, na forma dos §§ 1º e 2º do art. 243 da Lei nº 6.404, de 15 de dezembro de 1976;530=A fonte pagadora é controladora ou coligada da beneficiária no exterior, na forma dos §§ 1º e 2º do art. 243 da Lei nº 6.404, de 1976;540=A fonte pagadora e a beneficiária no exterior estão sob controle societário ou administrativo comum ou quando pelo menos 10% do capital de cada uma, pertencer a uma mesma pessoa física ou jurídica;550=A fonte pagadora e a beneficiária no exterior têm participação societária no capital de uma terceira pessoa jurídica, cuja soma as caracterize como controladoras ou coligadas na forma dos §§ 1º e 2º do art. 243 da Lei nº 6.404, de 1976;560=A fonte pagadora ou a beneficiária no exterior mantenha contrato de exclusividade como agente, como distribuidor ou como concessionário nas operações com bens, serviços e direitos;570=A fonte pagadora e a beneficiária mantêm acordo de atuação conjunta;900=Não há relação entre a fonte pagadora e a beneficiária no exterior ]
contribuicaoPrevidenciariaReceitaBruta.indNifIntegerOpcionalNumber(001) - Indicativo do Número de Identificação Fiscal - [ 1=Beneficiário com NIF;2=Beneficiário dispensado do NIF;3=País não exige NIF ]
contribuicaoPrevidenciariaReceitaBruta.datLauDateTimeOpcionalDate(DD/MM/YYYY) - Data atribuída pelo laudo da moléstia grave
pagamentoPessoaJuridicaSetOpcionalPagamentos Pessoas Jurídicas
pagamentoPessoaJuridica.codDfsIntegerOpcionalNumber(006) - Código do dispositivo fiscal
pagamentoPessoaJuridica.codSusDoubleOpcionalNumber(014) - Codigo da Suspensão
pagamentoPessoaJuridica.datPagDateTimeOpcionalDate(DD/MM/YYYY) - Data do Pagamento
pagamentoPessoaJuridica.indOriIntegerOpcionalNumber(001) - Indicativo da origem dos recursos - [ 1=Recursos do próprio declarante;2=Recursos de terceiros (Instituição Financeira respon. pelo repasse dos valores) ]
pagamentoPessoaJuridica.vlrTriDoubleOpcionalNumber(015,2) - Valor do Rendimento tributável
pagamentoPessoaJuridica.vlrRetDoubleOpcionalNumber(015,2) - Valor da retenção na Fonte
pagamentoPessoaJuridica.cnpOriStringOpcionalString(014) - CNPJ da empresa de origem dos recursos
pagamentoPessoaJuridica.vlrCujDoubleOpcionalNumber(015,2) - Valor da despesa com custas judiciais
advogadosPJUSetOpcionalAdvogados Pagamentos Pessoas Jurídicas
advogadosPJU.codForIntegerOpcionalNumber(009) - Código do Fornecedor
advogadosPJU.vlrDesDoubleOpcionalNumber(015,2) - Valor da despesa com Advogado
pagamentoPessoaFisicaSetOpcionalPagamentos Pessoas Físicas
pagamentoPessoaFisica.datPagDateTimeOpcionalDate(DD/MM/YYYY) - Data do Pagamento
pagamentoPessoaFisica.indSusStringOpcionalString(001) - Indicativo de Exigibilidade Suspensa - [ S=Sim;N=Não ]
pagamentoPessoaFisica.indDecStringOpcionalString(001) - Indicativo 13º Salário - [ S=Sim;N=Não ]
pagamentoPessoaFisica.vlrRtrDoubleOpcionalNumber(015,2) - Valor do Rendimento Tributável
pagamentoPessoaFisica.vlIRRFDoubleOpcionalNumber(015,2) - Vlr. Imposto Retido na Fonte
pagamentoPessoaFisica.vlrDepDoubleOpcionalNumber(015,2) - Vlr. Depósito Judicial
pagamentoPessoaFisica.vlrAnoDoubleOpcionalNumber(015,2) - Compensação Judicial do ano calendário
pagamentoPessoaFisica.vlrAntDoubleOpcionalNumber(015,2) - Compensação Judicial dos anos anteriores.
rendimentosRecebidosAcumuladamenteSetOpcionalRendimentos Recebidos Acumuladamente
rendimentosRecebidosAcumuladamente.codDfsIntegerOpcionalNumber(006) - Código do dispositivo fiscal
rendimentosRecebidosAcumuladamente.codSusDoubleOpcionalNumber(014) - Codigo da Suspensão
rendimentosRecebidosAcumuladamente.natRraStringOpcionalString(050) - Natureza do Rendimento
rendimentosRecebidosAcumuladamente.qtdMesIntegerOpcionalNumber(005) - Quantidade de meses
rendimentosRecebidosAcumuladamente.vlrCusDoubleOpcionalNumber(015,2) - Valor da despesa com custas judiciais
advogadosRRASetOpcionalAdvogados Rendimentos Recebidos Acumuladamente
advogadosRRA.codForIntegerOpcionalNumber(009) - Código do Fornecedor
advogadosRRA.vlrDesDoubleOpcionalNumber(015,2) - Valor da despesa com Advogado
demaisRendimentosDecisaoJudicialSetOpcionalDemais Rendimentos Decorrentes de Decisão Judicial
demaisRendimentosDecisaoJudicial.codDfsIntegerOpcionalNumber(006) - Código do dispositivo fiscal
demaisRendimentosDecisaoJudicial.codSusDoubleOpcionalNumber(014) - Codigo da Suspensão
demaisRendimentosDecisaoJudicial.indOriIntegerOpcionalNumber(001) - Indicativo da origem dos recursos - [ 1=Recursos do próprio declarante;2=Recursos de terceiros (Instituição Financeira respon. pelo repasse dos valores) ]
demaisRendimentosDecisaoJudicial.cnpOriStringOpcionalString(014) - CNPJ da empresa de origem dos recursos
demaisRendimentosDecisaoJudicial.vlrCusDoubleOpcionalNumber(015,2) - Valor da despesa com custas judiciais
advogadosIPRSetOpcionalAdvogados Demais Rendimentos Decorrentes de Decisão Judicial
advogadosIPR.codForIntegerOpcionalNumber(009) - Código do Fornecedor
advogadosIPR.vlrDesDoubleOpcionalNumber(015,2) - Valor da despesa com Advogado
rendimentosIsentosNaoTributaveisSetOpcionalRendimentos Isentos Não Tributáveis
rendimentosIsentosNaoTributaveis.tipIseIntegerOpcionalNumber(002) - Tipo de Isenção - [ 01=Parcela Isenta 65 anos;02=Diária e Ajuda de Custo;03=Indenização e rescisão de contrato, inclusive a título de PDV;04=Abono pecuniário;05=Outros (especificar);06=Lucros e dividendos pagos a partir de 1996;07=Valores pagos à titular ou sócio de microempresa ou empresa de pequeno porte, exceto pró-labore e alugueis;08=Pensão, aposentadoria ou reforma por moléstia grave ou acidente em serviço;09=Benefícios indiretos e/ou reembolso de despesas recebidas por voluntário da copa do mundo ou da copa das confederações;10=Bolsa de estudo recebida por médico-residente;11=Complementação de aposentadoria, correspondente às contribuições efetuadas no período de 01/01/1989 a 31/12/1995 ]
rendimentosIsentosNaoTributaveis.vlrIseDoubleOpcionalNumber(015,2) - Valor da Parcela Isenta
rendimentosIsentosNaoTributaveis.desRenStringOpcionalString(100) - Descrição do rendimento isento/Não tributável
detalhamentoDeducoesSetOpcionalDetalhamento Deduções
detalhamentoDeducoes.tipDedIntegerOpcionalNumber(001) - Tipo de Dedução - [ 1=Previdência Oficial;2=Previdência Privada;3=Fapi;4=Funpresp;5=Pensão Alimentícia;6=Dependentes ]
detalhamentoDeducoes.vlrDedDoubleOpcionalNumber(015,2) - Valor da Dedução da Base de Cálculo
detalhamentoCompetenciasSetOpcionalDetalhamentos das Competências
detalhamentoCompetencias.indPerIntegerOpcionalNumber(001) - Indicativo de período de referência - [ 1=Folha de pagamento mensal;2=Folha do décimo terceiro salário ]
detalhamentoCompetencias.vlrTriDoubleOpcionalNumber(015,2) - Valor do Rendimento tributável
detalhamentoCompetencias.perRefDateTimeOpcionalDate(DD/MM/YYYY) - Período de Pagamento
pagamentoResidenteExteriorSetOpcionalPagamentos a Residente ou Domiciliando no Exterior
pagamentoResidenteExterior.datPagDateTimeOpcionalDate(DD/MM/YYYY) - Data de Pagamento
pagamentoResidenteExterior.tipRenIntegerOpcionalNumber(003) - Tipo de Rendimento - [ 100=Rendas de propriedade imobiliária;110=Rendas do transporte internacional;120=Lucros e dividendos distribuídos;130=Juros;140=Royalties;150=Ganhos de Capital;160=Rendas do trabalho sem vínculo empregatício;170=Renda do trabalho com vínculo empregatício;180=Remuneração de administradores;190=Rendas de artistas e de esportistas;200=Pensões;210=Pagamentos governamentais;220=Rendas de professores e pesquisadores;230=Rendas de estudantes e aprendizes;240=Rendimentos de empregados ou contratados - COPA;250=Prêmios de árbitros, jogadores de futebol e outros membros das delegações - COPA;300=Outras rendas ]
pagamentoResidenteExterior.forTriIntegerOpcionalNumber(002) - Forma de Tributação - [ 10=Retenção do IRRF - alíquota padrão;11=Retenção do IRRF - alíquota da tabela progressiva;12=Retenção do IRRF - alíquota diferenciada (países tributação favorecida);13=Retenção do IRRF - alíquota limitada conforme cláusula em convênio;30=Retenção do IRRF - outras hipóteses;40=Não retenção do IRRF - isenção estabelecida em convênio;41=Não retenção do IRRF - isenção prevista em lei interna;42=Não retenção do IRRF - alíquota Zero prevista em lei interna;43=Não retenção do IRRF - pagamento antecipado do imposto;44=Não retenção do IRRF - medida Judicial;50=Não retenção do IRRF - outras hipóteses ]
pagamentoResidenteExterior.vlrDedDoubleOpcionalNumber(015,2) - Valor Pago.
pagamentoResidenteExterior.vliRrfDoubleOpcionalNumber(015,2) - Valor do Imposto Retido na Fonte
ClosedResposta:

Observação

Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, a mensagem do erro ocorrido. 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ImportarResponse>
      <result>
        <Retorno>
          <codEmp>Integer</codEmp>
          <codFil>Integer</codFil>
          <datCpt>DateTime</datCpt>
          <codFor>Integer</codFor>
          <tipRet>Integer</tipRet>
          <msgRet>String</msgRet>
        </Retorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ImportarResponse>
  </soapenv:Body>
</soapenv:Envelope>
ClosedAtributos da resposta:
NomeTipoDescrição
retornoSetRetorno
retorno.codEmpIntegerNumber(004) - Código da empresa
retorno.codFilIntegerNumber(005) - Código da filial
retorno.datCptDateTimeDate(DD/MM/YYYY) - Data de Competência
retorno.codForIntegerNumber(009) - Código do Fornecedor
retorno.tipRetIntegerNumber(004) - Tipo de Retorno de Processamento: 1 = Processado com sucesso, 2 = Ocorreram erros
retorno.msgRetStringString(1000) - Mensagem de Retorno de Processamento
erroExecucaoString Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:Vazio ou nulo, indicando que a execução foi feita com sucessoA mensagem do erro ocorrido no servidorSó impede a gravação quando o retorno.tipRet for igual a "2"

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

Todos os direitos de cópias reservadas para Senior Sistemas S.A.

A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).

Ver site completo