CONTEÚDO

  1. Visão Geral
  2. Configuração do Adapter OMSA010
  3. Exemplos de mensagem EAI - JSON
  4. Tags
  5. Processamento de campos sem tags e/ou customizados
  6. Pontos de Entrada
  7. 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

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"
            }
         ]
      }
   }
}
{
   "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

ElementoDescriçãoObservação
Content
CompanyIdEmpresaO campo é preenchido com valor de referência do De/Para de Empresa.
CompanyInternalIdInternalId da empresaO campo é preenchido com valor de referência do De/Para de Empresa e Filial.
BranchIdFilialO campo é preenchido com valor de referência do De/Para de Filial.
CodeCódigo da Tabela de Preços

Código referente ao registro Protheus (DA0_CODTAB).

InternalIdInternalId do Tabela de PreçosO campo é preenchido com valor de referência do De/Para de Tabela de Preços (DA0).
NameNome da Tabela de PreçosCódigo referente ao registro Protheus (DA0_DESCRI).
InitialDateData de Validade InicialCódigo referente ao registro Protheus (DA0_DATDE).
FinalDateData de Validade FinalCódigo referente ao registro Protheus (DA0_DATATE).
InitialHourHora de Validade InicialCódigo referente ao registro Protheus (DA0_HORADE).
FinalHourHora de Validade FinalCódigo referente ao registro Protheus (DA0_HORAATE)
ActiveTablePriceTabela AtivaCódigo referente ao registro Protheus (DA0_ATIVO).
Page
Indica qual a página atual
TotalPagesIndica o total de páginas
PageSizeIndica o número de produtos por página
TotalRecordsIndica o número de produtos na tabela de preço
NextPageIndica se haverá a próxima página
ItensTablePrice > Item

Itemcode

Código do Produto

Código referente ao registro Protheus (DA1_CODPRO).

ItemInternalIdCódigo interno do Produto

Código referente ao De/Para (XXF).

MinimumSalesPriceEndereço do Tabela de PreçosCódigo referente ao registro Protheus (DA1_PRCVEN).
DiscountValueBairro do Tabela de PreçosCódigo referente ao registro Protheus (DA1_VLRDES).
DiscountFactorMunicípio do Tabela de PreçosCódigo referente ao registro Protheus (DA1_PERDES).
ItemValidityEstado do Tabela de PreçosCódigo referente ao registro Protheus (DA1_DATVIG).
ActiveItemPriceInternalId do Estado do Tabela de PreçosCódigo referente ao registro Protheus (DA1_ATIVO).
TypePriceDescrição do EstadoCódigo referente ao registro Protheus (DA1_TIPPRE).
EventTipo de evento UPSERT ou DELETEInclusão, Alteração ou Deleção do item da tabela de preço.
InternalIdInternalId do Tabela de Preços

O campo é preenchido com valor de referência do De/Para de Tabela de Preços (DA0).

CodeCódigo da tabela de preçoCódigo referente ao registro Protheus (DA1_CODTAB).
NameNome da Tabela de PreçoCódigo referente ao registro Protheus (DA0_DESTAB).

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)

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


  1. 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;
  2. 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