Histórico da Página

CONTEÚDO

Visão Geral
Exemplo de utilização
Tela Adapter EAI
Tela Configuração do Adapter MATA410
Exemplos de mensagem EAI - JSON
Tags
Pontos de Entrada
Tabelas utilizadas

01. VISÃO GERAL

Configuração do Adpater Order com formatos diferentes (XML,JSON).

02.

...

CONFIGURAÇÃO DO ADAPTER MATA410

Quando utilizado o Adpater Order (MATA120, MATA410) ambos, obrigatoriamente, devem ter a mesma configuração do formato de arquivo (XML,JSON).

É recomendado a utilização da versão mais atual (4.003).

03. TELA ADAPTER EAI

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

Image Removed

...

Dica

title	Versão do adapter

Utilizar a versão 4.003 que é a última homologada para integração via XML ou JSON.

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

Image Added

Campo Formato configurado para JSONXML.

Image Removed Image Added

Campo Formato configurado para JSON.

Image Removed Image Added

...

03.

...

EXEMPLOS DE MENSAGEM EAI - JSON

Expandir

title	Exemplos de arquivo JSON

XML 2.000

Deck of Cards

id	Tags
effectType	fade

Card

label
id	1

Envio
effectType	fade

Elemento

Bloco de código

language

Descrição

yml

Observação

theme

BusinessContent

Midnight

CompanyId

firstline	1
title	JSON de envio (GET)
linenumbers	true

{
   "Header":{
      "UUID":"111111111-1111-1111-1111-11111111111",
      "Type":"BusinessMessage",
      "SubType":"event",
      "Event":"upsert",
      "Transaction":"ORDER",
      "StandardVersion":"1.000",
      "Version":"4.003",
      "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":{
      "InternalId":"T1|D MG 01|FTADD1|2",
      "OrderPurpose":"2",
      "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "CompanyInternalId":"T1|D MG 01",
      "OrderId":"FTADD1",
      "CustomerInternalId":"T1|D MG|FATADD|01|C",
      "CustomerCode":"FATADD01",
      "CurrencyCode":"1 ",
      "CurrencyId":"T1|D MG 01|1",
      "PaymentTermCode":"006",
      "PaymentConditionInternalId":"T1|D MG 01|006",
      "RegisterDate":"2025-05-13",
      "FreightType":"2",
      "FreightValue":10,
      "GrossWeight":5,
      "InsuranceValue":20,
      "SellerCode":"T1|D MG|000001",
      "Discounts":[
         {
            "Discount":1
         },
         {
            "Discount":2
         },
         {
            "Discount":3
         },
         {
            "Discount":0
         }
      ],
      "PriceTableNumber":"T1|D MG|057",
      "CarrierCode":"T1|D MG|000001",
      "InvoiceMessage":"TESTE MENSAGEM",
      "InvoiceNumber":"",
      "InvoiceSerie":"",
      "WorkCode":"00000000000001",
      "ListOfCreditDocument":[
         {
            "CreditDocumentInternalId":"T1|D MG 01|FAT|EAIFLDS01|1|RA",
            "Value":100
         }
      ],
      "SalesOrderItens":[
         {
            "InternalId":"T1|D MG 01|FTADD1|01|2",
            "CompanyId":"T1",
            "BranchId":"D MG 01",
            "OrderId":"FTADD1",
            "OrderItem":"01",
            "ItemCode":"FATIADDFIELDS01",
            "ItemDescription":"FAT INT ADDFIELDS 01",
            "ItemInternalId":"T1|D MG 01|FATIADDFIELDS01",
            "ItemUnitOfMeasure":"UN",
            "UnitOfMeasureInternalId":"T1|D MG|UN",
            "Quantity":5,
            "QuantityReached":"",
            "UnityPrice":94.11,
            "TotalPrice":470.55,
            "CostCenterCode":"",
            "CostCenterInternalId":"",
            "ItemDiscounts":{
               "ItemDiscount":0
            },
            "WarehouseInternalId":"T1|D MG|01",
            "TypeOperation":"506",
            "LotNumber":"",
            "SubLotNumber":"",
            "SeriesItem":"",
            "AddressingItem":"",
            "RequestItemInternalId":"",
            "InvoicingDate":"    -  -  ",
            "DeliveryDate":"2025-05-13",
            "InvoiceNumber":"",
            "InvoiceSerie":"",
            "AlloccatedQuantity":5,
            "QuantityDelivered":0,
            "CustomerOrderNumber":"TSTFAT   ",
            "ItemReserveInternalId":"      ",
            "ListOfApportionOrderItem":[
               {
                  "InternalId":"T1|D MG 01|FTADD1|01|2|01",
                  "CostCenterInternalId":"T1|D MG 01 |FAT000001",
                  "AccountantAcountInternalId":"T1|D MG    |000001",
                  "Percentual":40
               },
               {
                  "InternalId":"T1|D MG 01|FTADD1|01|2|02",
                  "CostCenterInternalId":"T1|D MG 01 |FAT000002",
                  "AccountantAcountInternalId":"T1|D MG    |000002",
                  "Percentual":60
               }
            ],
         },
         {
            "InternalId":"T1|D MG 01|FTADD1|02|2",
            "CompanyId":"T1",
            "BranchId":"D MG 01",
            "OrderId":"FTADD1",
            "OrderItem":"02",
            "ItemCode":"FATIADDFIELDS02",
            "ItemDescription":"FAT INT ADDFIELDS 02",
            "ItemInternalId":"T1|D MG 01|FATIADDFIELDS02",
            "ItemUnitOfMeasure":"UN",
            "UnitOfMeasureInternalId":"T1|D MG|UN",
            "Quantity":5,
            "QuantityReached":"",
            "UnityPrice":112.93,
            "TotalPrice":564.65,
            "CostCenterCode":"",
            "CostCenterInternalId":"",
            "ItemDiscounts":{
               "ItemDiscount":141.15
            },
            "WarehouseInternalId":"T1|D MG|01",
            "TypeOperation":"506",
            "LotNumber":"ADDFIELDS",
            "SubLotNumber":"",
            "SeriesItem":"",
            "AddressingItem":"0001",
            "RequestItemInternalId":"",
            "InvoicingDate":"    -  -  ",
            "DeliveryDate":"2025-05-13",
            "InvoiceNumber":"",
            "InvoiceSerie":"",
            "AlloccatedQuantity":0,
            "QuantityDelivered":0,
            "CustomerOrderNumber":"         ",
            "ItemReserveInternalId":"FATADD",
         }
      ]
   }
}

Card

id	2
label	Recebimento
effectType	fade

Bloco de código

language	js
theme	Midnight
firstline	1
title	JSON de Recebimento (POST)
linenumbers	true

{
   "Header":{
      "Version":"4.003",
      "CompanyId":"T1",
      "BranchId":"D MG 01",
      "GeneratedOn":"2025-05-13T09:10:36Z",
      "Enterprise":"01",
      "ProductVersion":"12",
      "SourceApplication":"environment",
      "ProductName":"PROTHEUS",
      "Transaction":"ORDER",
      "StandardVersion":"1.000",
      "UUID":"DSERFAT-31315-12345678-ADDFIELDS-01",
      "SubType":"event",
      "Event":"upsert",
      "Type":"BusinessMessage",
      "DeliveryType":"sync"
   },
   "Content":{
      "BranchId":"D MG 01",
      "InternalId":"FTADD2",
      "CustomerCode":"FATADD01",
      "CarrierCode":"000001",
      "PaymentTermCode":"006",
      "Discounts":0,
      "SellerCode":"",
      "SellerIdCode":"FAT001",
      "RegisterDate":"2025-05-13T09:10:36Z",
      "PriceTableNumber":"",
      "PriceTableIdCode":"057",
      "InvoiceMessage":"Teste 12345",
      "FreightType":"2",
      "FreightValue":10,
      "GrossWeight":5,
      "InsuranceValue":20,
      "Event":"upsert",
      "OrderPurpose":"2",
      "WorkCode":"00000000000001",
      "ListOfCreditDocument":[
         {
            "CreditDocumentInternalId":"T1|D MG 01|FAT|EAIFLDS02|1|RA",
            "Value":200
         }
      ],
      "SalesOrderItens":[
         {
            "BranchId":"01",
            "OrderId":"3878",
            "OrderItem":"1",
            "ItemCode":"FATIADDFIELDS01",
            "WarehouseInternalId":"T1|D MG|01",
            "Quantity":5,
            "UnityPrice":90,
            "TypeOperation":"506",
            "DeliveryDate":"2025-05-13T09:10:36Z",
            "ItemUnitOfMeasure":"UN",
            "InternalId":"FTADD201",
            "CustomerOrderNumber":"123455",
            "ItemDiscounts":{
               "ItemDiscount":10
            }
         },
         {
            "BranchId":"01",
            "OrderId":"3878",
            "OrderItem":"1",
            "ItemCode":"FATIADDFIELDS02",
            "WarehouseInternalId":"T1|D MG|01",
            "Quantity":5,
            "UnityPrice":135,
            "TypeOperation":"506",
            "DeliveryDate":"2025-05-13T09:10:36Z",
            "ItemUnitOfMeasure":"UN",
            "InternalId":"FTADD202",
            "CustomerOrderNumber":"123455",
            "ItemDiscounts":{
               "ItemDiscount":10
            }
         }
      ]
   }
}

04. TAGS

Código com valor de referência do De/Para de Tabela de Preços (DA0).

Para utilização deve possuir o Adapter PRICELISTHEADERITEM (OMSA010) cadastrado ou cadastrar manualmente o valor de referência

Deck of Cards

id	Tags
effectType	fade

Card

id	1
label	XML 2.000
effectType	fade

Elemento	Descrição	Observação
BusinessContent
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.
OrderPurpose	Objetivo do pedido	Indica se o Pedido se trata de: 1 - Compra 2 - Venda
InternalId	InternalId do Pedido	O campo é preenchido com valor de referência do De/Para de Pedidos (SC5/SC7).
RegisterDate	Data de Emissão
OrderId	Número do Pedido	Código referente ao registro Protheus (C5_NUM).
CustomerCode	Código do Cli/For	Código referente ao registro Protheus (A1_COD+A1_LOJA/A2_COD+A2_LOJA). Para utilização deste o CustomerInternalId não deve ser enviado.
CustomerInternalId	InternalId do Cli/For	Código referente ao De/Para (XXF). Para utilização deve possuir o Adapter CUSTOMERVENDOR (MATA030 ou MATA360)cadastrado.
PaymentTermCode	Condição de Pagamento	Código referente ao registro Protheus (E4_CODIGO).
PaymentConditionInternalId	InternalId da Condição de Pagamento	Código com valor de referência do De/Para de Condição de Pagamento (SE4). Para utilização deve possuir o Adapter PAYMENTCONDITION (MATA360) cadastrado.
Discount	Desconto	Realiza cálculo com base no valor total de cada item e adiciona no campo C5_DESC1 (valor de desconto no cabeçalho). Para outras versões, o tratamento desta TAG é alterada, adicionando o desconto no cabeçalho (SC5) por exemplo.
PriceTableNumber	Tabela de Preços	Código com valor de referência do De/Para de Tabela de Preços (DA0). Para utilização deve possuir o Adapter PRICELISTHEADERITEM (OMSA010) cadastrado ou cadastrar manualmente o valor de referência.
SalesOrderItens.Item
InternalId	InternalID Item do Pedido	O campo é preenchido com valor de referência do De/Para de Itens do Pedido (C6_ITEM).
OrderItem	Item do Pedido	O campo é preenchido com valor sequencial de referência do De/Para de Itens do Pedido (C6_ITEM).
ItemInternalId	InternalId do Produto	O campo é preenchido com valor de referência do De/Para de Produto (B1_COD). Para utilização deve possuir o Adapter ITEM (MATA010) cadastrado.
ItemCode	Código do Produto	Código referente ao registro Protheus (B1_COD).
Quantity	Quantidade
UnityPrice	Preço unitário
TotalPrice	Valor Total
TypeOperation	Tipo da Operação	Se menor que 3 será tratado como C6_OPER, caso contrario será tratado como C6_TES.
CostCenterCode	Centro de Custo	Código referente ao registro Protheus (CTT_CUSTO).
CostCenterInternalId	InternalID do Centro de Custo	O campo é preenchido com valor de referência do De/Para de Centro de Custo (CTT_CUSTO). Para utilização deve possuir o Adapter COSTCENTER (CTBA030) cadastrado.

Card

id	2
label	XML 3.002
effectType	fade

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.

Elemento	Descrição	Observação
BusinessContent
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.

OrderPurpose	Objetivo do pedido	Indica se o Pedido se trata de: 1 - Compra 2 - Venda
InternalId	InternalId do Pedido	O campo é preenchido com valor de referência do De/Para de Pedidos (SC5/SC7).
RegisterDate	Data de Emissão
OrderId	Número do Pedido	Código referente ao registro Protheus (C5_NUM).
CustomerCode	Código do Cli/For	Código referente ao registro Protheus (A1_COD+A1_LOJA/A2_COD+A2_LOJA). Para utilização deste o CustomerInternalId não deve ser enviado.
CustomerInternalId	InternalId do Cli/For	Código referente ao De/Para (XXF). Para utilização deve possuir o Adapter CUSTOMERVENDOR (MATA030 ou MATA360)cadastrado.
PaymentTermCode	Condição de Pagamento	Código referente ao registro Protheus (E4_CODIGO).
PaymentConditionInternalId	InternalId da condição de pagamento	Código com valor de referência do De/Para de Condição de Pagamento (SE4). Para utilização deve possuir o Adapter PAYMENTCONDITION (MATA360) cadastrado.
Discount	Desconto	Realiza cálculo com base no valor total de cada item e adiciona no campo

C5

C6_

DESC1

VALDESC (valor de desconto

no cabeçalho

para cada item). Para outras versões, o tratamento desta TAG é alterada, adicionando o desconto no cabeçalho (SC5) por exemplo

.

PriceTableNumber

Tabela de Preços

.
SalesOrderItens.Item
InternalId	InternalID Item do Pedido	O campo é preenchido com valor de referência do De/Para de Itens do Pedido (C6_ITEM).
OrderItem	Item do Pedido	O campo é preenchido com valor sequencial de referência do De/Para de Itens do Pedido (C6_ITEM).
ItemInternalId	InternalId do Produto	O campo é preenchido com valor de referência do De/Para de Produto (B1_COD). Para utilização deve possuir o Adapter ITEM (MATA010) cadastrado.
ItemCode	Código do Produto	Código referente ao registro Protheus (B1_COD).
Quantity	Quantidade
UnityPrice	Preço unitário
TotalPrice	Valor Total
TypeOperation	Tipo da Operação	Se menor que 3 será tratado como C6_OPER, caso contrario será tratado como C6_TES.
CostCenterCode	Centro de Custo	Código referente ao registro Protheus (CTT_CUSTO).
CostCenterInternalId	InternalID do Centro de Custo	O campo é preenchido com valor de referência do De/Para de Centro de Custo (CTT_CUSTO). Para utilização deve possuir o Adapter COSTCENTER (CTBA030) cadastrado.


InvoiceMessage	Mensagem da nota	Código referente ao registro Protheus (C5_MENNOTA).
FreightValue	Valor do Frete	Código referente ao registro Protheus (C5_FRETE).
GrossWeight	Peso Bruto

Tabela de Preços (DA0). Para utilização deve possuir o Adapter PRICELISTHEADERITEM (OMSA010) cadastrado.
PriceTableIdCode	Tabela de Preços	Código referente ao registro Protheus (DA0_CODTAB) Para utilização deste, o PriceTableNumber não deve ser enviado.
InvoiceNumber	Número da Nota	Código referente ao registro Protheus (C5_NOTA).
InvoiceSerie	Série da Nota	Código referente ao registro Protheus (C5_SERIE).
CurrencyId	Moeda	Código

registro Protheus (C5_CNO).
Discounts
Discount	Percentual do desconto	Código referente ao registro Protheus (

ItemDiscounts	Valor do Desconto do Item	Realiza cálculo com base no valor total de cada item e adiciona no campo C6_VALDESC (valor de desconto para cada item). Específico para mensagem de recebimento.
LotNumber	Lote do Item	Código referente ao registro Protheus (C6_LOTECTL).
SubLotNumber	Sub Lote do Item	Código referente ao registro Protheus (C6_NUMLOTE).
SeriesItem	Serie do Item

InvoicingDate	Data do Faturamento	Código referente ao registro Protheus (C6_DTFAT).
DeliveryDate	Data de Entrega	Código referente ao registro Protheus (C6_ENTREG).
InvoiceNumber	Número da Nota	Código referente ao registro Protheus (C6_NOTA) se o item já tiver sido faturado parcialmente.
InvoiceSerie	Número da Série da Nota

Árvore de páginas

Versões comparadas

Versão antiga 52

Nova versão Atual

Chave

CONTEÚDO

01. VISÃO GERAL

02.

CONFIGURAÇÃO DO ADAPTER MATA410

03. TELA ADAPTER EAI

03.

EXEMPLOS DE MENSAGEM EAI - JSON

04. TAGS

05. PROCESSAMENTO DE CAMPOS SEM TAGS E/OU CUSTOMIZADOS

06. PONTOS DE ENTRADA

07. TABELAS UTILIZADAS

/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.
OrderPurpose	Objetivo do pedido	Indica se o Pedido se trata de: 1 - Compra 2 - Venda
InternalId	InternalId do Pedido	O campo é preenchido

Pedidos (SC5/SC7).
RegisterDate	Data de Emissão
OrderId	Número do Pedido	Código referente ao registro Protheus (C5_NUM).
CustomerCode	Código do Cli/For	Código referente ao registro Protheus (A1_COD+A1_LOJA/A2_COD+A2_LOJA). Para utilização deste, o CustomerInternalId não deve ser enviado.
CustomerInternalId	InternalId do Cli/For	Código referente ao De/Para (XXF

cadastrado.
PaymentTermCode	Condição de Pagamento	Código referente ao registro Protheus (E4_CODIGO).
PaymentConditionInternalId	InternalId da condição de pagamento	Código

Itens do Pedido (C6_ITEM).
OrderItem	Item do Pedido	O campo é preenchido com valor sequencial de referência do De/Para de Itens do Pedido (C6_ITEM).
ItemInternalId	InternalId do Produto	O campo é preenchido