Adapter EAI - PriceListHeaderItem

CONTEÚDO

Visão Geral
Configuração do Adapter OMSA010
Exemplos de mensagem EAI - JSON
Tags
Processamento de campos sem tags e/ou customizados
Pontos de Entrada
Tabelas utilizadas

01. VISÃO GERAL

Configuração do Adapter PriceListHeaderItem com formatos diferentes (XML,JSON).

02. CONFIGURAÇÃO DO ADAPTER OMSA010

Exemplo de configuração do adapter Seller no formato JSON.

No modulo SIGACFG (Configurador) Ambiente > Schedule > Adapter EAI > Incluir OMSA010

03. EXEMPLOS DE MENSAGEM EAI - JSON

Exemplos de arquivo JSON

JSON de envio (GET)

Demonstra Por? Tabela (MV_PAR01 = 1)

{
   "Header":{
      "UUID":"111111111-1111-1111-1111-11111111111",
      "Type":"BusinessMessage",
      "SubType":"event",
      "Event":"upsert",
      "Transaction":"PRICELISTHEADERITEM",
      "StandardVersion":"1.000",
      "Version":"2.000",
      "SourceApplication":"environment",
      "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "Enterprise":"D ",
      "BusinessUnit":"MG ",
      "ProductName":"Protheus",
      "ProductVersion":"12",
      "GeneratedOn":"2015-01-01T12:00:00Z",
      "DeliveryType":"Async"
   },
   "Content":{
      "CompanyID":"T1",
      "BranchId":"D MG 01 ",
      "CompanyInternalID":"T1|D MG 01 ",
      "InternalId":"T1|D MG|FTI",
      "Code":"FTI",
      "Name":"TABELA DE PRECO ADDFIELDS     ",
      "InitialDate":"13\/06\/2025",
      "FinalDate":"13\/06\/2025",
      "InitialHour":"00:00:00",
      "FinalHour":"23:59:00",
      "ActiveTablePrice":"1",
      "Page":1,
      "TotalPages":1,
      "PageSize":2,
      "TotalRecords":2,
      "NextPage":false,
      "ItensTablePrice":{
         "Item":[
            {
               "ItemCode":"FATIADDFIELDS01               ",
               "ItemInternalId":"T1|D MG 01|FATIADDFIELDS01               ",
               "MinimumSalesPrice":100,
               "DiscountValue":0,
               "DiscountFactor":0,
               "ItemValidity":"13\/06\/2025",
               "ActiveItemPrice":"1",
               "TypePrice":"5",
               "Event":"upsert",
            },
            {
               "ItemCode":"FATIADDFIELDS02               ",
               "ItemInternalId":"T1|D MG 01|FATIADDFIELDS02               ",
               "MinimumSalesPrice":1000,
               "DiscountValue":0,
               "DiscountFactor":0,
               "ItemValidity":"13\/06\/2025",
               "ActiveItemPrice":"1",
               "TypePrice":"5",
               "Event":"upsert"
            }
         ]
      }
   }
}


Demonstra Por? Produto (MV_PAR01 = 2)

{
   "Header":{
      "UUID":"111111111-1111-1111-1111-11111111111",
      "Type":"BusinessMessage",
      "SubType":"event",
      "Event":"upsert",
      "Transaction":"PRICELISTHEADERITEM",
      "StandardVersion":"1.000",
      "Version":"2.000",
      "SourceApplication":"environment",
      "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "Enterprise":"D ",
      "BusinessUnit":"MG ",
      "ProductName":"Protheus",
      "ProductVersion":"12",
      "GeneratedOn":"2015-01-01T12:00:00Z",
      "DeliveryType":"Async"
   },
   "Content":{
      "CompanyID":"T1",
      "BranchId":"D MG 01 ",
      "CompanyInternalID":"T1|D MG 01 ",
      "Page":1,
      "TotalPages":1,
      "PageSize":1,
      "TotalRecords":1,
      "NextPage":false,
      "ItensTablePrice":{
         "Item":[
            {
               "InternalId":"T1|D MG|052",
               "Code":"052",
               "Name":"JSON MV_PAR PRODUTO           ",
               "ItemCode":"FTR001                        ",
               "ItemInternalId":"T1|D MG 01|FTR001                        ",
               "MinimumSalesPrice":200,
               "DiscountValue":0,
               "DiscountFactor":0,
               "ItemValidity":"19\/06\/2024",
               "ActiveItemPrice":"1",
               "TypePrice":"5",
               "Event":"upsert"
            }
         ]
      }
   }
}

JSON de Recebimento (POST)

{
   "Header":{
      "Version":"2.000",
	 "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "GeneratedOn":"2015-01-01T12:00:00Z",
      "ProductVersion":"12",
      "SourceApplication":"TOTVSSFA",
      "ProductName":"TOTVSSFA",
      "Transaction":"PRICELISTHEADERITEM",
      "StandardVersion":"1.000",
      "UUID":"DSERFAT-31317-12345678-ADDFIELDS-01",
      "SubType":"event",
      "Event":"upsert",
      "Type":"BusinessMessage",
      "DeliveryType":"Sync"
   },
   "Content":{
      "CompanyID":"T1",
      "BranchId":"D MG 01 ",
      "Code":"FTJ",
      "Name":"TABELA DE PRECO ADDFIELDS 02  ",
      "ActiveTablePrice":"1",
      "InitialDate":"11\/06\/2025",
      "FinalDate":"11\/06\/2025",
      "InitialHour":"00:00:00",
      "FinalHour":"23:59:00",
      "ItensTablePrice":{
         "Item":[
            {
               "DiscountValue":0,
               "ItemValidity":"11\/06\/2025",
               "ItemCode":"FATIADDFIELDS01",
               "Event":"upsert",
               "MinimumSalesPrice":500,
               "ActiveItemPrice":"1",
               "DiscountFactor":0,
			   "DiscountValue":0,
               "TypePrice":"5"
            },
            {
               "DiscountValue":0,
               "ItemValidity":"11\/06\/2025",
               "ItemCode":"FATIADDFIELDS02",
               "Event":"upsert",
               "MinimumSalesPrice":100,
               "ActiveItemPrice":"1",
               "DiscountFactor":0,
 			   "DiscountValue":0, 
               "TypePrice":"5"
            }
         ]
      }
   }
}

04. Tags

Elemento	Descrição	Observação
Content
CompanyId	Empresa	O campo é preenchido com valor de referência do De/Para de Empresa.
CompanyInternalId	InternalId da empresa	O campo é preenchido com valor de referência do De/Para de Empresa e Filial.
BranchId	Filial	O campo é preenchido com valor de referência do De/Para de Filial.
Code	Código da Tabela de Preços	Código referente ao registro Protheus (DA0_CODTAB).
InternalId	InternalId do Tabela de Preços	O campo é preenchido com valor de referência do De/Para de Tabela de Preços (DA0).
Name	Nome da Tabela de Preços	Código referente ao registro Protheus (DA0_DESCRI).
InitialDate	Data de Validade Inicial	Código referente ao registro Protheus (DA0_DATDE).
FinalDate	Data de Validade Final	Código referente ao registro Protheus (DA0_DATATE).
InitialHour	Hora de Validade Inicial	Código referente ao registro Protheus (DA0_HORADE).
FinalHour	Hora de Validade Final	Código referente ao registro Protheus (DA0_HORAATE)
ActiveTablePrice	Tabela Ativa	Código referente ao registro Protheus (DA0_ATIVO).
Page	Indica qual a página atual
TotalPages	Indica o total de páginas
PageSize	Indica o número de produtos por página
TotalRecords	Indica o número de produtos na tabela de preço
NextPage	Indica se haverá a próxima página
ItensTablePrice > Item
Itemcode	Código do Produto	Código referente ao registro Protheus (DA1_CODPRO).
ItemInternalId	Código interno do Produto	Código referente ao De/Para (XXF).
MinimumSalesPrice	Preço de Venda	Código referente ao registro Protheus (DA1_PRCVEN).
DiscountValue	Valor do desconto	Código referente ao registro Protheus (DA1_VLRDES).
DiscountFactor	Fator de Acresc./Desconto	Código referente ao registro Protheus (DA1_PERDES).
ItemValidity	Vigência do Item	Código referente ao registro Protheus (DA1_DATVIG).
ActiveItemPrice	Item Ativo	Código referente ao registro Protheus (DA1_ATIVO).
TypePrice	Tipo de Preço	Código referente ao registro Protheus (DA1_TIPPRE).
Event	Tipo de evento UPSERT ou DELETE	Inclusão, Alteração ou Deleção do item da tabela de preço.
InternalId	InternalId do Tabela de Preços	O campo é preenchido com valor de referência do De/Para de Tabela de Preços (DA0).
Code	Código da tabela de preço	Código referente ao registro Protheus (DA1_CODTAB).
Name	Nome da Tabela de Preço	Código referente ao registro Protheus (DA0_DESTAB).

Paginação EAI Tabela de Preço

As tags Page, TotalPages, PageSize, TotalRecords e NextPage são referentes ao processo de paginação, o qual consiste na quebra dos envios da mensagem de forma a gerar múltiplos registros na tabela XX3.
Para mais informações sobre o assunto acesse o link - Paginação EAI Tabela de Preço
Na mensagem de envio, as tags são geradas através da rotina Sincronizador EAI - Sincronizador EAI (APCFG020a - SIGACFG)

Pergunta F12 - Demonstra Por ?

As tags InternalId, Code e Name dos itens da Tabela de Preço são geradas apenas se a pergunta "Demonstra Por?" nos F12 da rotina estiver com conteúdo Produto.

Para um melhor entendimento sobre as tags que são consideradas na mensagem de envio de acordo com a pergunta "Demonstra Por?", verifique os exemplos de mensagem de envio no item 3 EXEMPLOS DE MENSAGEM EAI - JSON.

05. PROCESSAMENTO DE CAMPOS SEM TAGS E/OU CUSTOMIZADOS

Para o processamento de campos sem tag, sejam eles customizados ou padrão, acesse o link abaixo para obter maiores informações sobre o processo para integrar os campos, sem a necessidade de customizar o Protheus.

Integração - Processamento de campos sem tag e/ou customizados

Informações adicionais

Campos sem tag - mensagem de recebimento (DA0 e DA1):
- Os campos sem tag a serem gravados nas tabelas DA0 e DA1 são de responsabilidade do cliente, assim como o conteúdo a ser gravado nesses campos;
Exclusões na seção "AddFields":
- Os campos Log de Inclusão (_USERGI) e Log de Alteração (_USERGA) das tabelas DA0 e DA1 os campos já tagueados não serão incluídos na seção "AddFields".

06. PONTOS DE ENTRADA

07. TABELAS UTILIZADAS

XX4 - Adapters EAI
SA3 - Cadastro de Tabela de Preçoses

Árvore de páginas