Versions Compared

Version Old Version 14 New Version 15
Changes made by

Former user

Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleOperação: obterToken

Retorna um token para a unidade gestora poder usar o serviço do TCE. Permite somente um token por unidade gestora.

Definição:          

  • obterToken(inteiro codigoUnidadeGestora)

Parâmetros:

  • codigoUnidadeGestora: código da Unidade Gestora conforme serviço listar da tabela unidades gestoras.

Resposta (campos dados):

  • posicao: posição atual do seu token na fila
  • situacao: situação do token
  • chaveToken: o token em si, deverá ser usado nos demais serviços


Exemplo:

Code Block
languagexml
titleSolicitação (O cabeçalho “soapenv:Header” foi omitido para simplificação da documentação):
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tok="http://token.ws.tce.sc.gov.br/">
 <soapenv:Header>
 <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
 <wsse:UsernameToken>
 <wsse:Username>USUARIO</wsse:Username>
 <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">SENHA</wsse:Password>
</wsse:UsernameToken>
 </wsse:Security>
 </soapenv:Header>
 <soapenv:Body>
 <tok:obterToken>
 <codigoUg>10006</codigoUg>
 </tok:obterToken>
 </soapenv:Body>
</soapenv:Envelope>


Code Block
languagexml
titleResposta:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
 <soap:Body>
 <ns2:obterTokenResponse xmlns:ns2="http://token.ws.tce.sc.gov.br/">
 <return>
 <dados>
 <entry>
 <key>chaveToken</key>
<value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">d95a313b-4ba9-49b1-aca0-53c1f1bd16a4</value>
 </entry>
 <entry>
 <key>posicao</key>
<value xsi:type="xs:int" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">2</value>
 </entry>
 <entry>
 <key>situacao</key>
<value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Pronto
para envio ou consulta</value>
 </entry>
 </dados>
 <mensagem>Token criado com sucesso</mensagem>
 <status>OK</status>
 </return>
 </ns2:obterTokenResponse>
 </soap:Body>
</soap:Envelope>



Expand
titleOperação: obterSituacaoToken

Retorna a situação do token passado como parâmetro. Para evitar solicitações indefinidas a este serviço o sistema punirá com a remoção do token da fila sempre que for feita duas chamadas seguidas  do serviço obterSituacaoToken em menos de cinco segundos.

Definição:

  • obterSituacaoToken(caracteres token)

Parâmetros:

  • token: o token recebido no serviço obterToken.

Resposta (campos dados):

  • posicao: posição atual do seu token na fila
  • situacao: situação do token

Exemplo

Code Block
languagexml
titleSolicitação (O cabeçalho “soapenv:Header” foi omitido para simplificação da documentação):
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tok="http://token.ws.tce.sc.gov.br/">
 <soapenv:Header…
 <soapenv:Body>
 <tok:obterSituacaoToken>
 <token>d95a313b-4ba9-49b1-aca0-53c1f1bd16a4</token>
 </tok:obterSituacaoToken>
 </soapenv:Body>
</soapenv:Envelope>


Code Block
languagexml
titleResposta:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
 <soap:Body>
 <ns2:obterSituacaoTokenResponse xmlns:ns2="http://token.ws.tce.sc.gov.br/">
 <return>
 <dados>
 <entry>
 <key>posicao</key>
 <value xsi:type="xs:int" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">1</value>
 </entry>
 <entry>
 <key>situacao</key>
 <value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Pronto para envio ou
consulta</value>
 </entry>
 </dados>
 <mensagem>Situação token obtida com sucesso</mensagem>
 <status>OK</status>
 </return>
 </ns2:obterSituacaoTokenResponse>
 </soap:Body>
</soap:Envelope>