Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

As mensagens TOTVS possuem um segmento chamado MessageInformation que possui as principais informações utilizadas para identificação e roteamento da mensagem. Segue abaixo um exemplo:Image Removed


Bloco de código
languagexml
titleMessageInformation
linenumberstrue
collapsetrue
	<MessageInformation version="2.002">
		<BranchId>L MG 01</BranchId>
		<CompanyId>T2</CompanyId>
		<UserId>22</UserId/>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018-03-20T12:49:39Z</GeneratedOn>
		<Product name="PROTHEUS" version="12"/>
		<SourceApplication>P12_DEV_SERVERT2</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>UNITOFMEASURE</Transaction>
		<Type>BusinessMessage</Type>
		<UUID>69f90943-9cfc-b5e9-b485-500f17604e38</UUID>
	</MessageInformation>


A seguir é apresentado uma descrição detalhada de cada item ilustrado acima:

  • MessageInformation version: Identifica qual a versão da mensagem de negócio. Uma mensagem de Item, por exemplo, pode sofrer alterações no decorrer do tempo, sendo que cada uma destas alterações irá afetar esta informação;
    UUID:
  • CompanyId/BranchId/UserId: Identificador da empresa/filial e usuário que gerou a mensagem (obrigatória);

  • DeliveryType: Forma de envio da mensagem, podendo ser "sync" ou "async", ou seja, "síncrono" ou "assíncrono" respectivamente;

  • GeneratedOn: Identifica o timestamp de geração desta mensagem;

  • Product: Identifica o produto e versão do aplicativo que originou a mensagem. Neste caso, o valor pode ser igual, mesmo em instâncias diferentes do mesmo aplicativo;

  • SourceApplication: Identifica Identificador único da mensagem e que não pode ser igual ao UUID de qualquer outra mensagem em qualquer um dos aplicativos participantes da integração;
    Type: Identifica o tipo da mensagem (BusinessMessage ou ResponseMessage);
    Transaction: Identificador do tipo de transação da mensagem. Esta informação será utilizada pelos aplicativos para definir como os dados serão processados no recebimento;
    StandardVersion: Identifica a versão do padrão TOTVS, ou seja, do formato utilizado nas áreas genéricas da mensagem TOTVS. Caso o padrão TOTVS seja alterado, este valor será alterado;
    SourceApplication: Identifica a instância dos aplicativos que gerou a mensagem. Uma instância representa uma instalação/configuração daquele aplicativo/produto. Caso duas instâncias do mesmo aplicativo participem da mesma integração, cada uma deverá ser identificada de forma única;
    CompanyId/BranchId/UserId: Identificador da empresa/filial e usuário que gerou a mensagem (obrigatória);
    Product: Identifica o produto e versão do aplicativo que originou a mensagem. Neste caso, o valor pode ser igual, mesmo em instâncias diferentes do mesmo aplicativo;
    GeneratedOn: Identifica o timestamp de geração desta mensagem;

  • StandardVersion: Identifica a versão do padrão TOTVS, ou seja, do formato utilizado nas áreas genéricas da mensagem TOTVS. Caso o padrão TOTVS seja alterado, este valor será alterado;

  • Transaction: Identificador do tipo de transação da mensagem. Esta informação será utilizada pelos aplicativos para definir como os dados serão processados no recebimento;

  • Type: Identifica o tipo da mensagem (BusinessMessage ou ResponseMessage);

  • UUID: Identificador único da mensagem e que não pode ser igual ao UUID de qualquer outra mensagem em qualquer um dos aplicativos participantes da integraçãoDeliveryType: Forma de envio da mensagem, podendo ser "sync" ou "async", ou seja, "síncrono" ou "assíncrono" respectivamente.

O PIMSConnector utilizará a estrutura de mensagem padronizada, para realizar a troca das mensagens entres os aplicativos externos, aproveitando os fundamentos presentes na Mensagem Estruturada.