Web service Com.senior.g5.co.mcm.ven.contratovenda
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.
Campos 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
Exemplo:
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.
Campos 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
Exemplo:
- 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
- Síncrono: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_ven_contratovenda?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mcm_ven_contratovenda?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_mcm_ven_contratovenda?wsdl
- Ao informar a competência na linha do item do contrato, o sistema busca uma validade, na tabela de preços, que atenda ao primeiro dia da competência. Exemplo: considere a inclusão de um item com a competência 05/2023. Nesse caso, seria 01/05/2023 o primeiro dia da competência 05/2023. Assim, a tabela de preços deve ter a data inicial da validade menor ou igual a 01/05/2023
- Se a competência não for inserida na linha do item do contrato, o sistema vai considerar a data de emissão do contrato. Na tabela de preços deve haver uma validade que atenda à data de emissão dele. Exemplo: se o contrato tem a data de emissão igual a 17/05/2023, a data de validade da tabela de preços deve ser anterior ou igual a 17/05/2023
Informar ou trocar uma tabela de preços no item de produto ou serviço
O sistema tem o seguinte comportamento em relação à validade da tabela de preços:
Porta
Gerar
Mercado - Gestão de Vendas - Contratos - Gerar.
Necessita autenticação: sim.
Situação de versão: atual.
Versão: 4.
Classe do sistema ERP que implementa a porta do web service: TSr160ContratoVenda.
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:Gerar>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<tipOri>String</tipOri>
<qtdPar>Integer</qtdPar>
<produtos>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<numCtr>Integer</numCtr>
<datCpt>DateTime</datCpt>
<seqCvp>Integer</seqCvp>
<tnsPro>String</tnsPro>
<codPro>String</codPro>
<codDer>String</codDer>
<cplCvp>String</cplCvp>
<iniVig>DateTime</iniVig>
<fimVig>DateTime</fimVig>
<proRat>String</proRat>
<codClf>String</codClf>
<codStr>String</codStr>
<codDep>String</codDep>
<codLot>String</codLot>
<qtdCvp>Double</qtdCvp>
<uniMed>String</uniMed>
<qtdVen>Double</qtdVen>
<uniVen>String</uniVen>
<codMoe>String</codMoe>
<datMoe>DateTime</datMoe>
<cotMoe>Double</cotMoe>
<codTpr>String</codTpr>
<prePad>Double</prePad>
<preRep>Double</preRep>
<preUni>Double</preUni>
<preVen>Double</preVen>
<perDsc>Double</perDsc>
<vlrDsc>Double</vlrDsc>
<perIpi>Double</perIpi>
<perDif>Double</perDif>
<perIcm>Double</perIcm>
<perIrf>Double</perIrf>
<perCom>Double</perCom>
<perFun>Double</perFun>
<perSen>Double</perSen>
<perPit>Double</perPit>
<perCrt>Double</perCrt>
<perCsl>Double</perCsl>
<perOur>Double</perOur>
<codTic>String</codTic>
<codTrd>String</codTrd>
<codTst>String</codTst>
<numPrj>Integer</numPrj>
<codFpj>Integer</codFpj>
<ctaFin>Integer</ctaFin>
<ctaRed>Integer</ctaRed>
<codCcu>String</codCcu>
<codSnf>String</codSnf>
<numNfv>Integer</numNfv>
<seqIpv>Integer</seqIpv>
<sitCvp>String</sitCvp>
<codMot>Integer</codMot>
<obsMot>String</obsMot>
<qtdBfp>Double</qtdBfp>
<datGar>DateTime</datGar>
<datIni>DateTime</datIni>
<codAgc>String</codAgc>
<qtdMin>Double</qtdMin>
<qtdMax>Double</qtdMax>
<vlrFat>Double</vlrFat>
<vlrTot>Double</vlrTot>
<preFix>String</preFix>
<perOfe>Double</perOfe>
<perAcr>Double</perAcr>
<proCli>String</proCli>
<codGru>String</codGru>
<prdRea>Integer</prdRea>
<iniRea>DateTime</iniRea>
<ultRea>DateTime</ultRea>
<perRea>Double</perRea>
<prdRre>Integer</prdRre>
<iniRre>DateTime</iniRre>
<ultRre>DateTime</ultRre>
<perRre>Double</perRre>
<prdRpa>Integer</prdRpa>
<iniRpa>DateTime</iniRpa>
<ultRpa>DateTime</ultRpa>
<perRpa>Double</perRpa>
<datUft>DateTime</datUft>
<proPar>Integer</proPar>
<camposUsuario>
<campoUSU>String</campoUSU>
<valorUSU>String</valorUSU>
</camposUsuario>
<aliFus>Double</aliFus>
<aliFnt>Double</aliFnt>
</produtos>
<terminais>
<seqTer>Integer</seqTer>
<numTer>String</numTer>
<ufsTer>String</ufsTer>
</terminais>
<ignorarErrosItens>String</ignorarErrosItens>
<codEmp>Integer</codEmp>
<ctrRea>String</ctrRea>
<servicos>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<numCtr>Integer</numCtr>
<datCpt>DateTime</datCpt>
<seqCvs>Integer</seqCvs>
<tnsSer>String</tnsSer>
<codSer>String</codSer>
<cplCvs>String</cplCvs>
<iniVig>DateTime</iniVig>
<fimVig>DateTime</fimVig>
<proRat>String</proRat>
<codClf>String</codClf>
<codStr>String</codStr>
<qtdCvs>Double</qtdCvs>
<uniMed>String</uniMed>
<codMoe>String</codMoe>
<datMoe>DateTime</datMoe>
<cotMoe>Double</cotMoe>
<codTpr>String</codTpr>
<prePad>Double</prePad>
<preRep>Double</preRep>
<preUni>Double</preUni>
<perDsc>Double</perDsc>
<vlrDsc>Double</vlrDsc>
<perIss>Double</perIss>
<perCom>Double</perCom>
<perIns>Double</perIns>
<perIpi>Double</perIpi>
<perDif>Double</perDif>
<perIcm>Double</perIcm>
<perIrf>Double</perIrf>
<perPit>Double</perPit>
<perCsl>Double</perCsl>
<perCrt>Double</perCrt>
<perOur>Double</perOur>
<codTic>String</codTic>
<codTrd>String</codTrd>
<codTst>String</codTst>
<numPrj>Integer</numPrj>
<codFpj>Integer</codFpj>
<ctaFin>Integer</ctaFin>
<ctaRed>Integer</ctaRed>
<codCcu>String</codCcu>
<codPro>String</codPro>
<codDer>String</codDer>
<obsCvs>String</obsCvs>
<codSnf>String</codSnf>
<numNfv>Integer</numNfv>
<seqIsv>Integer</seqIsv>
<sitCvs>String</sitCvs>
<codMot>Integer</codMot>
<obsMot>String</obsMot>
<prdRea>Integer</prdRea>
<iniRea>DateTime</iniRea>
<ultRea>DateTime</ultRea>
<perRea>Double</perRea>
<prdRre>Integer</prdRre>
<iniRre>DateTime</iniRre>
<ultRre>DateTime</ultRre>
<perRre>Double</perRre>
<prdRpa>Integer</prdRpa>
<inirpa>DateTime</inirpa>
<ultRpa>DateTime</ultRpa>
<perRpa>Double</perRpa>
<datIni>DateTime</datIni>
<datUft>DateTime</datUft>
<proPar>Integer</proPar>
<camposUsuario>
<campoUSU>String</campoUSU>
<valorUSU>String</valorUSU>
</camposUsuario>
<aliFus>Double</aliFus>
<aliFnt>Double</aliFnt>
</servicos>
<inserirApenasContratoCompleto>String</inserirApenasContratoCompleto>
<codFil>Integer</codFil>
<diaPar>Integer</diaPar>
<validarCampoUsuario>String</validarCampoUsuario>
<numCtr>Integer</numCtr>
<ctrIft>String</ctrIft>
<tipCtr>Integer</tipCtr>
<prdRea>Integer</prdRea>
<codCli>Integer</codCli>
<iniRea>DateTime</iniRea>
<numOfi>String</numOfi>
<prdRpa>Integer</prdRpa>
<objCtr>String</objCtr>
<datIni>DateTime</datIni>
<crtOri>Integer</crtOri>
<datFim>DateTime</datFim>
<datEmi>DateTime</datEmi>
<diaBas>Integer</diaBas>
<datEnt>DateTime</datEnt>
<diaFix>Integer</diaFix>
<cliFat>Integer</cliFat>
<iniVig>DateTime</iniVig>
<codRep>Integer</codRep>
<fimVig>DateTime</fimVig>
<codTpr>String</codTpr>
<diaRep>Integer</diaRep>
<seqEnt>Integer</seqEnt>
<iniRep>DateTime</iniRep>
<seqCob>Integer</seqCob>
<fimRep>DateTime</fimRep>
<codFcr>String</codFcr>
<iniCom>DateTime</iniCom>
<datFcr>DateTime</datFcr>
<fimCom>DateTime</fimCom>
<criFtc>Integer</criFtc>
<codCpg>String</codCpg>
<criPrt>Integer</criPrt>
<codFpg>Integer</codFpg>
<sitCtr>String</sitCtr>
<usaJmc>String</usaJmc>
<codMot>Integer</codMot>
<perJrs>Double</perJrs>
<obsMot>String</obsMot>
<tolJrs>Double</tolJrs>
<recRec>String</recRec>
<tipJrs>String</tipJrs>
<numPrj>Integer</numPrj>
<perMul>Double</perMul>
<indSpr>String</indSpr>
<tolMul>Double</tolMul>
<indMrd>String</indMrd>
<dscNeg>Double</dscNeg>
<tipSrc>String</tipSrc>
<codCrp>String</codCrp>
<numTer>String</numTer>
<codTra>Integer</codTra>
<ufsTer>String</ufsTer>
<tnsPro>String</tnsPro>
<datCmp>DateTime</datCmp>
<tnsSer>String</tnsSer>
<datVec>DateTime</datVec>
<sobreporTnsProSer>String</sobreporTnsProSer>
<usoIni>DateTime</usoIni>
<recalcular>String</recalcular>
<usoFim>DateTime</usoFim>
<codMs1>Integer</codMs1>
<codBar>String</codBar>
<codMs2>Integer</codMs2>
<debAut>String</debAut>
<codMs3>Integer</codMs3>
<codBdc>String</codBdc>
<codMs4>Integer</codMs4>
<codAge>String</codAge>
<agpDsc>String</agpDsc>
<codPix>String</codPix>
<obsCtr>String</obsCtr>
<contratoUsuario>
<campoUSU>String</campoUSU>
<valorUSU>String</valorUSU>
</contratoUsuario>
<excluirCTR>String</excluirCTR>
<cgcCpf>String</cgcCpf>
</parameters>
</ser:Gerar>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| tipOri | String | (Opcional) - String(001) - Origem da chamada do web service (I - Incluir / A - Alterar). Há dois tipos de serviço que o web service de geração de contratos atende: 1. Inclusão e alteração de contratos contendo as informações do contrato como código da empresa, código da filial, numero do contrato 2. Alteração de contrato somente incluindo itens de serviço apenas com a informação do CPF/CNPJ do cliente e informações necessárias do serviço Para a opção 1 Pode ser utilizado a origem I ou A e tem que ser informados os demais campos obrigatórios da documentação. Para a opção 2 Pode somente ser informado A juntamente com o campo CGCCPF que é o Cpf ou CNPJ do cliente de faturamento de contrato onde o sistema irá fazer uma busca e verificar se o cliente está duplicado ou se já existe um contrato em vigencia para este cliente de faturamento, caso não exista ou tenha contrato duplicado ou até mesmo o cliente esteja duplicado o web service irá retornar como erro. Também nesta opção só ira atender a inclusão de novos itens de serviço e serão obrigatórios informar os campos: CodSer e QtdSer, juntamente com a regra VEN-160PRECO01 para definir os preços padrões e unitários. |
| qtdPar | Integer | (Opcional) - Number(003) - Quantidade de Parcelas |
| produtos | Set | |
| produtos.codEmp | Integer | (Opcional) - Number(004) - Empresa |
| produtos.codFil | Integer | (Opcional) - Number(005) - Filial |
| produtos.numCtr | Integer | (Opcional) - Number(009) - Contrato |
| produtos.datCpt | DateTime | (Opcional) - Date(000) - Data da competência |
| produtos.seqCvp | Integer | (Opcional) - Number(003) - Sequência do item de produto |
| produtos.tnsPro | String | (Obrigatório) - String(005) - Transação do produto |
| produtos.codPro | String | (Obrigatório) - String(014) - Código do produto |
| produtos.codDer | String | (Opcional) - String(007) - Código da Derivação |
| produtos.cplCvp | String | (Opcional) - String(250) - Complemento do item de produto |
| produtos.iniVig | DateTime | (Opcional) - Date(000) - Data Início Vig. |
| produtos.fimVig | DateTime | (Opcional) - Date(000) - Data Final Vig. |
| produtos.proRat | String | (Opcional) - String(001) - Pró-rata - Lista: S = Sim, N = Não |
| produtos.codClf | String | (Opcional) - String(003) - Classif. Fiscal |
| produtos.codStr | String | (Opcional) - String(003) - Sit. Trib. |
| produtos.codDep | String | (Opcional) - String(010) - Código do Depósito |
| produtos.codLot | String | (Opcional) - String(050) - Lote Fab. |
| produtos.qtdCvp | Double | (Obrigatório) - Number(014) - Quantidade do item de produto |
| produtos.uniMed | String | (Obrigatório) - String(003) - Unidade de medida |
| produtos.qtdVen | Double | (Obrigatório) - Number(014) - Quantidade de venda do item de produto |
| produtos.uniVen | String | (Obrigatório) - String(003) - Unidade de medida de venda do item de produto |
| produtos.codMoe | String | (Obrigatório) - String(003) - Código da moeda. |
| produtos.datMoe | DateTime | (Opcional) - Date(000) - Data Cot. |
| produtos.cotMoe | Double | (Opcional) - Number(019) - Vlr. Cot. |
| produtos.codTpr | String | (Opcional) - String(004) - Tab. Preço |
| produtos.prePad | Double | (Obrigatório) - Number(014) - Preço padrão do item de produto |
| produtos.preRep | Double | (Opcional) - Number(014) - Vlr. Repasse |
| produtos.preUni | Double | (Obrigatório) - Number(014) - Preço unitário do item de produto |
| produtos.preVen | Double | (Opcional) - Number(014) - Preço Uni. Med. Ven. |
| produtos.perDsc | Double | (Opcional) - Number(005) - % Desc. |
| produtos.vlrDsc | Double | (Opcional) - Number(015) - Desc. Item |
| produtos.perIpi | Double | (Opcional) - Number(005) - % IPI |
| produtos.perIcm | Double | (Opcional) - Number(005) - % ICMS |
| produtos.perIrf | Double | (Opcional) - Number(004) - % IRRF |
| produtos.perCom | Double | (Opcional) - Number(005) - % Comissão |
| produtos.perFun | Double | (Opcional) - Number(004) - % Funrural |
| produtos.perPit | Double | (Opcional) - Number(004) - % PIS |
| produtos.perCrt | Double | (Opcional) - Number(004) - % Cofins |
| produtos.perCsl | Double | (Opcional) - Number(004) - % CSLL |
| produtos.perOur | Double | (Opcional) - Number(004) - % Out. Ret. |
| produtos.codTic | String | (Opcional) - String(003) - ICMS Esp. |
| produtos.codTrd | String | (Opcional) - String(003) - Cód. Red. Impostos |
| produtos.codTst | String | (Opcional) - String(003) - ICMS Subst. |
| produtos.numPrj | Integer | (Opcional) - Number(008) - Projeto |
| produtos.codFpj | Integer | (Opcional) - Number(004) - Fase |
| produtos.ctaFin | Integer | (Opcional) - Number(007) - Cta. Fin. |
| produtos.ctaRed | Integer | (Opcional) - Number(007) - Cta. Contábil |
| produtos.codCcu | String | (Opcional) - String(009) - Centro de Custo |
| produtos.codSnf | String | (Opcional) - String(003) - Série NF |
| produtos.numNfv | Integer | (Opcional) - Number(009) - Nº NF |
| produtos.seqIpv | Integer | (Opcional) - Number(003) - Seq. NF |
| produtos.sitCvp | String | (Opcional) - String(001) - Sit. - Lista: A = Ativo, I = Inativo |
| produtos.codMot | Integer | (Opcional) - Number(006) - Código do motivo |
| produtos.obsMot | String | (Opcional) - String(250) - Observação do motivo |
| produtos.qtdBfp | Double | (Opcional) - Number(011) - Qtd. Base Formação Preço |
| produtos.datGar | DateTime | (Opcional) - Date(000) - Data Garantia |
| produtos.datIni | DateTime | (Obrigatório) - Date(000) - Data Início Fat. |
| produtos.codAgc | String | (Opcional) - String(005) - Agrupamento Comercial |
| produtos.qtdMin | Double | (Opcional) - Number(014) - Qtd. Min. |
| produtos.qtdMax | Double | (Opcional) - Number(014) - Qtd. Max. |
| produtos.vlrFat | Double | (Opcional) - Number(014) - Valor Faturado |
| produtos.vlrTot | Double | (Opcional) - Number(014) - Valor Total |
| produtos.preFix | String | (Opcional) - String(001) - Fixo - Lista: S = Sim, N = Não |
| produtos.perOfe | Double | (Opcional) - Number(005) - % Oferta |
| produtos.perAcr | Double | (Opcional) - Number(005) - % Acréscimo |
| produtos.proCli | String | (Opcional) - String(030) - Cód. Prod. Cli. |
| produtos.codGru | String | (Opcional) - String(010) - Código do Grupo |
| produtos.prdRea | Integer | (Opcional) - Number(002) - Period. Reajuste |
| produtos.iniRea | DateTime | (Opcional) - Date(000) - Data Início Reajuste |
| produtos.ultRea | DateTime | (Opcional) - Date(000) - Data Últ. Reajuste |
| produtos.perRea | Double | (Opcional) - Number(007) - % Últ. Reajuste |
| produtos.prdRre | Integer | (Opcional) - Number(002) - Periodo Reajuste Preço Repasse |
| produtos.iniRre | DateTime | (Opcional) - Date(000) - Data Inicio Reajuste Preço Repasse |
| produtos.ultRre | DateTime | (Opcional) - Date(000) - Data Último Reajuste Preço Repasse |
| produtos.perRre | Double | (Opcional) - Number(007) - % Últ. Reajuste Preço Repasse |
| produtos.prdRpa | Integer | (Opcional) - Number(002) - Period. Reajuste Preço Padrão |
| produtos.iniRpa | DateTime | (Opcional) - Date(000) - Data Inicio Reajuste Preço Padrão |
| produtos.ultRpa | DateTime | (Opcional) - Date(000) - Data Último Reajuste Preço Padrão |
| produtos.perRpa | Double | (Opcional) - Number(007) - % Últ. Reajuste Preço Padrão |
| produtos.datUft | DateTime | (Opcional) - Date(000) - Data Últ. Faturamento |
| produtos.PerSen | Double | (Opcional) Number (004) % Senar |
| produtos.camposUsuario | Set | |
| produtos.camposUsuario.campoUSU | String | (Obrigatório) - String - Nome do campo de usuário |
| produtos.camposUsuario.valorUSU | String | (Obrigatório) - String - Valor do campo de usuário |
| produtos.aliFus | Double | Number(005,2) - Percentual do FUST |
| produtos.aliFnt | Double | Number(005,2) - Percentual do FUNTTEL |
| ignorarErrosItens | String | (Opcional) - Quando “S - Sim", processa os próximos itens mesmo que encontre algum erro. Quando "N - Não", o web service vai parar a execução no momento que encontrar algum erro no processamento do item. Valor padrão: "S - Sim" |
| codEmp | Integer | (Obrigatório) - Number(004) - Código da empresa |
| ctrRea | String | (Opcional) - String(001) - Controla reajuste contrato |
| servicos | Set | |
| servicos.codEmp | Integer | (Opcional) - Number(004) - Código da empresa |
| servicos.codFil | Integer | (Opcional) - Number(005) - Código da Filial |
| servicos.numCtr | Integer | (Opcional) - Number(009) - Número do contrato (interno) |
| servicos.datCpt | DateTime | (Opcional) - Date(000) - Data da competência |
| servicos.seqCvs | Integer | (Opcional) - Number(003) - Sequência do item de serviço |
| servicos.tnsSer | String | (Obrigatório) - String(005) - Transação do serviço |
| servicos.codSer | String | (Obrigatório) - String(014) - Código do serviço |
| servicos.cplCvs | String | (Opcional) - String(250) - Complemento do serviço |
| servicos.iniVig | DateTime | (Opcional) - Date(000) - Data Início Vig. |
| servicos.fimVig | DateTime | (Opcional) - Date(000) - Data Final Vig. |
| servicos.proRat | String | (Opcional) - String(001) - Pró-rata - Lista: S = Sim, N = Não |
| servicos.codClf | String | (Opcional) - String(003) - Classif. Fiscal |
| servicos.codStr | String | (Opcional) - String(003) - Sit. Trib. |
| servicos.qtdCvs | Double | (Obrigatório) - Number(014,5) - Quantidade do item de serviço |
| servicos.uniMed | String | (Obrigatório) - String(003) - Unidade de medida do item de serviço |
| servicos.codMoe | String | (Obrigatório) - String(003) - Código da moeda. |
| servicos.datMoe | DateTime | (Opcional) - Date(000) - Data Cotação da moeda |
| servicos.cotMoe | Double | (Opcional) - Number(019) - Vlr. Cotação da moeda |
| servicos.codTpr | String | (Opcional) - String(004) - Tab. Preço |
| servicos.prePad | Double | (Obrigatório) - Number(014,5) - Preço padrão do item de serviço |
| servicos.preRep | Double | (Opcional) - Number(014) - Preço Rep. |
| servicos.preUni | Double | (Obrigatório) - Number(014,5) - Preço unitário do item de serviço |
| servicos.perDsc | Double | (Opcional) - Number(005) - % Desc. |
| servicos.vlrDsc | Double | (Opcional) - Number(015) - Desc. Item |
| servicos.perIss | Double | (Opcional) - Number(004) - % ISS |
| servicos.perCom | Double | (Opcional) - Number(005) - % Comiss. |
| servicos.perIns | Double | (Opcional) - Number(004) - % INSS |
| servicos.perIpi | Double | (Opcional) - Number(005) - % IPI |
| servicos.perIcm | Double | (Opcional) - Number(005) - % ICMS |
| servicos.perIrf | Double | (Opcional) - Number(004) - % IRRF |
| servicos.perPit | Double | (Opcional) - Number(004) - % PIS |
| servicos.perCsl | Double | (Opcional) - Number(004) - % CSLL |
| servicos.perCrt | Double | (Opcional) - Number(004) - % Cofins |
| servicos.perOur | Double | (Opcional) - Number(004) - % Out. Ret. |
| servicos.codTic | String | (Opcional) - String(003) - ICMS Esp. |
| servicos.codTrd | String | (Opcional) - String(003) - Cód. Red. Impostos |
| servicos.codTst | String | (Opcional) - String(003) - ICMS Subst. |
| servicos.numPrj | Integer | (Opcional) - Number(008) - Projeto |
| servicos.codFpj | Integer | (Opcional) - Number(004) - Fase |
| servicos.ctaFin | Integer | (Opcional) - Number(007) - Cta. Fin. |
| servicos.ctaRed | Integer | (Opcional) - Number(007) - Cta. Ctb. |
| servicos.codCcu | String | (Opcional) - String(009) - Centro de Custo |
| servicos.codPro | String | (Opcional) - String(014) - Código do Produto |
| servicos.codDer | String | (Opcional) - String(007) - Código da Derivação |
| servicos.obsCvs | String | (Opcional) - String(999) - Obs. Item |
| servicos.codSnf | String | (Opcional) - String(003) - Série NF |
| servicos.numNfv | Integer | (Opcional) - Number(009) - Nº NF |
| servicos.seqIsv | Integer | (Opcional) - Number(003) - Seq. NF |
| servicos.sitCvs | String | (Opcional) - String(001) - Sit. - Lista: A = Ativo, I = Inativo |
| servicos.codMot | Integer | (Opcional) - Number(006) - Mot. |
| servicos.obsMot | String | (Opcional) - String(250) - Obs. Mot. |
| servicos.prdRea | Integer | (Opcional) - Number(002) - Period. Reaj. |
| servicos.iniRea | DateTime | (Opcional) - Date(000) - Data Início Reaj. |
| servicos.ultRea | DateTime | (Opcional) - Date(000) - Data Últ. Reaj. |
| servicos.perRea | Double | (Opcional) - Number(007) - % Últ. Reaj. |
| servicos.prdRre | Integer | (Opcional) - Number(002) - Period. Reaj.Pre.Rep. |
| servicos.iniRre | DateTime | (Opcional) - Date(000) - Data Inicio Reajuste Preço Repasse |
| servicos.ultRre | DateTime | (Opcional) - Date(000) - Data Último Reajuste Preço Repasse |
| servicos.perRre | Double | (Opcional) - Number(007) - % Últ. Reajuste Preço Repasse |
| servicos.prdRpa | Integer | (Opcional) - Number(002) - Periodo Reajuste Preço Padrão |
| servicos.inirpa | DateTime | (Opcional) - Date(000) - Data Ini. Reaj. Preço Padrão |
| servicos.ultRpa | DateTime | (Opcional) - Date(000) - Data Últ. Reaj. Preço Padrão |
| servicos.perRpa | Double | (Opcional) - Number(007) - % Últ. Reaj. Preço Padrão |
| servicos.datIni | DateTime | (Opcional) - Date(000) - Início Faturamento |
| servicos.datUft | DateTime | (Opcional) - Date(000) - Data Último Faturamento |
| servicos.camposUsuario | Set | |
| servicos.camposUsuario.campoUSU | String | (Obrigatório) - String - Nome do campo de usuário |
| servicos.camposUsuario.valorUSU | String | (Obrigatório) - String - Valor do campo de usuário |
| servicos.aliFus | Double | Number(005,2) - Percentual do FUST |
| servicos.aliFnt | Double | Number(005,2) - Percentual do FUNTTEL |
| inserirApenasContratoCompleto | String | (Opcional) - Quando "S - Sim", insere o contrato se não houver erros no produto, serviço ou dados gerias. Quando "N - Não", insere o contrato mesmo se houver erro no produto, serviço ou dados gerias. Valor padrão: "S- Sim" |
| codFil | Integer | (Obrigatório) - Number(005) - Código da filial |
| diaPar | Integer | (Opcional) - Number(003) - Quantidade de meses de intervalo entre as parcelas |
| validarCampoUsuario | String |
(Opcional) - Quando "S - Sim", faz a validação dos valores passados aos campos de usuário conforme o
tamanho na base de dados e exibe uma mensagem de erro, se houver.
|
| numCtr | Integer | (Obrigatório) - Number(009) - Número do contrato |
| ctrIft | String | (Opcional) - String(001) - Controla faturamento contrato |
| tipCtr | Integer | (Obrigatório) - Number(002) - Tipo de contrato |
| prdRea | Integer | (Opcional) - Number(002) - Periodicidade de reajuste do contrato |
| codCli | Integer | (Obrigatório) Number(009) - Código do cliente do contrato |
| iniRea | DateTime | (Opcional) - Date - Data de inicio do reajuste |
| numOfi | String | (Opcional) - String(020) - Número oficial do contrato |
| prdRpa | Integer | (Opcional) - Number(002) - Periodicidade reajuste preço padrão. |
| objCtr | String | (Opcional) - String(250) - Objeto do Contrato |
| datIni | DateTime | (Opcional) - Date - Data de inicio de faturamento. |
| crtOri | Integer | (Opcional) |
| datFim | DateTime | (Opcional) - Date - Data de inicio de faturamento. |
| datEmi | DateTime | (Opcional) - Date - Data de emissão do contrato |
| diaBas | Integer | (Opcional) - Number(002) - Dia base do Faturamento |
| datEnt | DateTime | (Opcional) - Date - Data de entrada |
| diaFix | Integer | (Opcional) - Number(002) - Dia fixo de vencimento |
| cliFat | Integer | (Opcional) - Number(009) - Código do cliente de faturamento do contrato |
| iniVig | DateTime | (Opcional) - Date - Data de inicio da vigencia do contrato |
| codRep | Integer | (Opcional) - Number(009) - Código do representante |
| fimVig | DateTime | (Opcional) - Date - Data final da vigencia do contrato |
| codTpr | String | (Opcional) - String(004) - Código da tabela de preço |
| diaRep | Integer | (Opcional) - Number(002) - Dia do repasse |
| seqEnt | Integer | (Opcional) - Number(005) - Sequência do endereço de entrega |
| iniRep | DateTime | (Opcional) - Date - Data inicial do repasse |
| seqCob | Integer | (Opcional) - Number(005) - Sequência do endereço de cobrança |
| fimRep | DateTime | (Opcional) - Date - Data final do repasse |
| codFcr | String | (Opcional) - String(003) - Código do fator de correção |
| iniCom | DateTime | (Opcional) - Date - Data inicial pagamento da comissão |
| datFcr | DateTime | (Opcional) - Date - Data do fator de correção |
| fimCom | DateTime | (Opcional) - Date - Data final do pagamento da comissão |
| criFtc | Integer | (Opcional) - Number(001) - Critério de faturamento |
| codCpg | String | (Opcional) - String(006) - Condição do pagamento |
| criPrt | Integer | (Opcional) - Number(005) - Critério para cálculo pró-rata. |
| codFpg | Integer | (Opcional) - Number(002) - Forma de pagamento |
| sitCtr | String | (Opcional) - String(001) - Situação do contrato |
| usaJmc | String | (Opcional) - String(001) - Usa juros e multa contrato |
| codMot | Integer | (Opcional) - Number(006) - Código do motivo da situação |
| perJrs | Double | (Opcional) - Number(003,2) - Percentual de juros de mora |
| obsMot | String | (Opcional) - String(250) - Observação do motivo da situação do contrato |
| tolJrs | Double | (Opcional) - Number(002) - Tolerância de juros |
| recRec | String | (Opcional) - String(001) - Reconhcer Receita (IFRS/POC) (N - Nenhum / C - Custo / E - Evolução do Projeto) |
| numPrj | Number | (Opcional) - Number(009) - Número do Projeto para Reconhcimento de Receita (IFRS/POC) |
| contratoUsuario | Set | |
| contratoUsuario.campoUSU | String | (Obrigatório) - String - Nome do campo de usuário |
| contratoUsuario.valorUSU | String | (Obrigatório) - String - Valor do campo de usuário |
| tipJrs | String | (Opcional) - String(001) - Tipo de juros |
| excluirCTR | String | (Opcional) - String(001) - Excluir contrato? (S- Sim / N - Não) |
| perMul | Double | (Opcional) - Number(003,2) - Percentual de multa |
| tolMul | Double | (Opcional) - Number(002) - Tolerância multa |
| dscNeg | Double | (Opcional) - Number(013,2) - Valor do desconto negociado |
| cgcCpf | String | (Opcional) - String(001) - CPF ou CNPJ do cliente de faturamento do contrato, somente utilizado quando a origem do contrato for alteração para inclusão do item de serviço através do CPF/CNPJ. |
| codCrp | String | (Opcional) - String(003) - Grupo contas a receber |
| codTra | Integer | (Opcional) - Number(009) - Código da transportadora |
| tnsPro | String | (Opcional) - String(005) - Transação de produtos |
| tnsSer | String | (Opcional) - String(005) - Transação de serviços |
| sobreporTnsProSer | String | (Opcional) - String(001) - Sobrepor a transação de produto e serviço |
| recalcular | String | Recalcula e busca valores dos itens do contrato quando alterar o cliente faturamento. Opções: S - Sim, N - Não |
| codMs1 | Integer | (Opcional) - Number(004) - Código da mensagem |
| codMs2 | Integer | (Opcional) - Number(004) - Código da mensagem |
| codMs3 | Integer | (Opcional) - Number(004) - Código da mensagem |
| codMs4 | Integer | (Opcional) - Number(004) - Código da mensagem |
| agpDsc | String | (Opcional) - String(001) - Agrupa descrições |
| obsCtr | String | (Opcional) - String - Observação do contrato |
| nFCom.indSpr | String | String(001) - Serviço Pré-Pago - [ S=Sim;N=Não ] |
| nFCom.indMrd | String | String(001) - Indicador de Sessão de Meios de Rede - [ S=Sim;N=Não ] |
| nFCom.tipSrc | String | Number(002) - Tipo de serviço utilizado - [ 1=Telefonia;2=Comunicação de dados;3=TV por Assinatura;4=Provimento de acesso à Internet;5=Multimídia;6=Outros;7=Vários ] |
| nFCom.numTer | String | String(012) - Número do terminal principal do serviço contratado |
| nFCom.ufsTer | String | String(002) - Sigla do estado |
| nFCom.datCmp | DateTime | Date(DD/MM/YYYY) - Ano e mês referência do faturamento |
| nFCom.datVec | DateTime | Date(DD/MM/YYYY) - Data de vencimento da fatura |
| nFCom.usoIni | DateTime | Date(DD/MM/YYYY) - Data de período de uso Inicial |
| nFCom.usoFim | DateTime | Date(DD/MM/YYYY) - Data de período de uso final |
| nFCom.codBar | String | String(048) - Linha digitável do código de barras |
| nFCom.debAut | String | String(020) - Código de autorização débito em conta |
| nFCom.codBan | String | String(005) - Número do banco para débito em conta |
| nFCom.codAge | String | String(010) - Número da agência bancária para débito em conta |
| nFCom.codPix | String | String(2000) - URL do QRCode do PIX da fatura |
| terminaisAdicionais | Set | Terminais Adicionais da NFCom. |
| terminaisAdicionais.numTer | String | String(012) - Número do terminal adicional |
| terminaisAdicionais.ufsTer | String | String(002) - Sigla do estado |
Resposta:
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:GerarResponse>
<result>
<tipoRetorno>String</tipoRetorno>
<mensagemRetorno>String</mensagemRetorno>
<retornoServico>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<numCtr>Integer</numCtr>
<seqCvs>Integer</seqCvs>
<sitCvs>String</sitCvs>
<retorno>String</retorno>
</retornoServico>
<retornoProduto>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<numCtr>Integer</numCtr>
<seqCvp>Integer</seqCvp>
<sitCvp>String</sitCvp>
<retorno>String</retorno>
</retornoProduto>
<retornoContrato>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<numCtr>Integer</numCtr>
<tipCtr>Integer</tipCtr>
<sitCtr>String</sitCtr>
<retorno>String</retorno>
</retornoContrato>
<erroExecucao>String</erroExecucao>
</result>
</ser:GerarResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos da resposta:
| Nome | Tipo | Descrição |
|---|---|---|
| erroExecucao | String | 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" |
| tipoRetorno | String | (Obrigatório) - Number(001) - Indicativo do tipo de retorno da solicitação - Lista: 1 = Processado, 2 = Erro. Em ambos retornos, as descrições são mostradas no campo MensagemRetorno |
| mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
| retornoServico | Set | |
| retornoServico.codEmp | Integer | (Obrigatório) - Number(004) - Código da Empresa |
| retornoServico.codFil | Integer | (Obrigatório) - Number(005) - Código da Filial |
| retornoServico.numCtr | Integer | (Obrigatório) - Number(009) - Número interno do contrato |
| retornoServico.seqCvs | Integer | (Obrigatório) - Number(003) - Sequência do Item de Serviço |
| retornoServico.sitCvs | String | (Obrigatório) - String(001) - Situação do Item de Serviço. Valores da lista:
A - Ativo I - Inativo |
| retornoServico.retorno | String | (Obrigatório) - String(100) - Retorno do processamento. |
| retornoProduto | Set | |
| retornoProduto.codEmp | Integer | (Obrigatório) - Number(004) - Código da Empresa |
| retornoProduto.codFil | Integer | (Obrigatório) - Number(005) - Código da Filial |
| retornoProduto.numCtr | Integer | (Obrigatório) - Number(009) - Número Interno do Contrato |
| retornoProduto.seqCvp | Integer | (Obrigatório) - Number(003) - Sequência do Item de Produto do Contrato |
| retornoProduto.sitCvp | String | (Obrigatório) - String(001) - Situação do Item de Produto. Valores da lista:
A- Ativo I - Inativo |
| retornoProduto.retorno | String | (Obrigatório) - String(100) - Retorno do processamento. |
| retornoContrato | Set | |
| retornoContrato.codEmp | Integer | (Obrigatório) - Number(004) - Código da empresa |
| retornoContrato.codFil | Integer | (Obrigatório) - Number(005) - Código da filial |
| retornoContrato.numCtr | Integer | (Obrigatório) - Number(009) - Número Interno do Contrato |
| retornoContrato.tipCtr | Integer | (Obrigatório) - Number(002) - Tipo de Contrato. Valores da lista:
1 - Comercial Normal 2 - Comercial Adicional 3 - Financeiro Normal 4 - Financeiro Adicional 5 - Comercial Sócios 6 - Comercial Variável 7 - Comercial com Participação 8 - Comercial Licitação 9 - Comercial de Abastecimento 10 - Financeiro com Saldo 11 - Por Evento 12 - Transporte de Cargas |
| retornoContrato.sitCtr | String | (Obrigatório) - String(001) - Situação do Contrato. Valores da lista:
A - Ativo I - Inativo |
| retornoContrato.retorno | String | (Obrigatório) - String(100) - Retorno do processamento. |
English
Español
English
Español


