Gerar GUID - ProcessCode 1004

Um GUID (Globally Unique Identifier) é um tipo especial de identificador utilizado em aplicações para providenciar um número de referência que será único em qualquer contexto. Neste caso utilizamos essa definição para identificar uma transação dentro do Web Service, garantindo que as solicitações serão únicas e conhecidas apenas pelo solicitante.

Todas as integrações farão o uso do GUID, tanto para identificar o processo (nas consultas de processamento) quanto para a assinatura de mensagens. O software que fará a integração com o Web Service poderá gerar o GUID por conta própria. Ou se desejar, poderá fazer uma chamada no Web Service, utilizando o ProcessCode 1004, que retornará um GUID, que posteriormente deverá ser integrado à mensagem.

Se optar por solicitar o GUID antes do envio de uma integração, o software solicitante deve primeiro chamar a API para obter um novo GUID e incluí-lo na mensagem de processamento.

Tipo do processamento = Síncrono

ProcessCode = 1004

MessageType = 100

ExchangePattern = 1

GUID = Não é enviado, porém estará no retorno

Nos exemplos a seguir, demonstramos como o software solicitante deve chamar nosso serviço, utilizando o ProcessCode 1004, para receber um novo GUID, que deverá ser integrado à mensagem de processamento antes de prosseguir com o envio dos dados.

Exemplo de envio de solicitação de GUID:

XML envio ProcessCode 1004

XML

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:tem="http://tempuri.org/">
 <soap:Header/>
 <soap:Body>
         <tem:Send>
                 <!--Optional:-->
                 <tem:message><![CDATA[<?xml version="1.0" encoding="utf-16"?>
<CrossTalk_Message xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.nddigital.com.br/nddcargo">
   <CrossTalk_Header>
         <ProcessCode>1004</ProcessCode>
           <MessageType>100</MessageType>
           <ExchangePattern>1</ExchangePattern>
           <DateTime>2012-05-28T11:18:04.2162347-03:00</DateTime>
           <EnterpriseId>12345678901234</EnterpriseId>
           <Token>123456789014257896452135</Token>
   </CrossTalk_Header>
  <CrossTalk_Body>
            <CrossTalk_Version_Body versao="4.2.11.0"/>
  </CrossTalk_Body>
 </CrossTalk_Message>]]></tem:message>
                 <!--Optional:-->
                 <tem:rawData/>
         </tem:Send>
 </soap:Body>
</soap:Envelope>

Exemplo de retorno de solicitação de GUID:

XML retorno GUID

XML

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
     <SendResponse xmlns="http://tempuri.org/">
        <SendResult><![CDATA[<?xml version="1.0" encoding="utf-8"?>
<CrossTalk_Message xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <CrossTalk_Header>
   <ResponseCode>0</ResponseCode>
   <ProcessCode>1004</ProcessCode>
   <MessageType>100</MessageType>
   <ExchangePattern>1</ExchangePattern>
   <SourceId>0</SourceId>
   <GUID>4b41c5bd-82fa-4e4c-9f86-a3c5bff3a927</GUID>
   <DateTime>2012-05-28T11:18:04.2162347-03:00</DateTime>
   <EnterpriseId>12345678901234</EnterpriseId>
   <Token>123456789014257896452135</Token>
 </CrossTalk_Header>
</CrossTalk_Message>]]></SendResult>
     </SendResponse>
  </soap:Body>
</soap:Envelope>

Nas próximas páginas deste manual, serão apresentados os detalhes da montagem dos XMLs para o envio das informações referentes ao CIOT e ao VPO. Confira o fluxo abaixo para entender como o GUID se integra a esse processo.

Próximos Passos

Código Identificador da Operação de Transporte

Vale Pedágio Obrigatório