CONTEÚDO

  1. Visão Geral
  2. Configuração do Adapter MATA410
  3. Exemplos de mensagem EAI - JSON
  4. Tags
  5. Pontos de Entrada
  6. Tabelas utilizadas 

01. VISÃO GERL

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

02. CONFIGURAÇÃO DO ADAPTER MATA410

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

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


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

          


         Campo Formato configurado para XML.

       


         Campo Formato configurado para JSON.

       

03. EXEMPLOS DE MENSAGEM EAI - JSON

04. TAGS

ElementoDescriçãoObservação
BusinessContent
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.
OrderPurposeObjetivo do pedido

Indica se o Pedido se trata de:
1 - Compra

2 - Venda

InternalIdInternalId do PedidoO campo é preenchido com valor de referência do De/Para de Pedidos (SC5/SC7).
RegisterDateData de Emissão
OrderIdNúmero do Pedido

Código referente ao registro Protheus (C5_NUM).

CustomerCodeCó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.

CustomerInternalIdInternalId do Cli/For

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

Para utilização deve possuir o Adapter CUSTOMERVENDOR (MATA030 ou MATA360) cadastrado.

PaymentTermCodeCondição de PagamentoCó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
InternalIdInternalID Item do Pedido

O campo é preenchido com valor de referência do De/Para de Itens do Pedido (C6_ITEM).

OrderItemItem do PedidoO campo é preenchido com valor sequencial de referência do De/Para de Itens do Pedido (C6_ITEM).
ItemInternalIdInternalId 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.

ItemCodeCódigo do ProdutoCódigo referente ao registro Protheus (B1_COD).
QuantityQuantidade
UnityPricePreço unitário
TotalPriceValor Total
TypeOperationTipo da OperaçãoSe menor que 3 será tratado como C6_OPER, caso contrario será tratado como C6_TES.
CostCenterCodeCentro de CustoCódigo referente ao registro Protheus (CTT_CUSTO).
CostCenterInternalIdInternalID 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.

ElementoDescriçãoObservação
BusinessContent
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.
OrderPurposeObjetivo do pedido

Indica se o Pedido se trata de:
1 - Compra

2 - Venda

InternalIdInternalId do PedidoO campo é preenchido com valor de referência do De/Para de Pedidos (SC5/SC7).
RegisterDateData de Emissão
OrderIdNúmero do Pedido

Código referente ao registro Protheus (C5_NUM).

CustomerCodeCó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.

CustomerInternalIdInternalId do Cli/For

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

Para utilização deve possuir o Adapter CUSTOMERVENDOR (MATA030 ou MATA360) cadastrado.

PaymentTermCodeCondição de PagamentoCó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 C6_VALDESC (valor de desconto para cada item). Para outras versões, o tratamento desta TAG é alterada, adicionando o desconto no cabeçalho (SC5) por exemplo.

SalesOrderItens.Item
InternalIdInternalID Item do Pedido

O campo é preenchido com valor de referência do De/Para de Itens do Pedido (C6_ITEM).

OrderItemItem do PedidoO campo é preenchido com valor sequencial de referência do De/Para de Itens do Pedido (C6_ITEM).
ItemInternalIdInternalId 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.

ItemCodeCódigo do ProdutoCódigo referente ao registro Protheus (B1_COD).
QuantityQuantidade
UnityPricePreço unitário
TotalPriceValor Total
TypeOperationTipo da OperaçãoSe menor que 3 será tratado como C6_OPER, caso contrario será tratado como C6_TES.
CostCenterCodeCentro de CustoCódigo referente ao registro Protheus (CTT_CUSTO).
CostCenterInternalIdInternalID 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.



ElementoDescriçãoObservação
BusinessContent
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.
OrderPurposeObjetivo do pedido

Indica se o Pedido se trata de:
1 - Compra

2 - Venda

InternalIdInternalId do PedidoO campo é preenchido com valor de referência do De/Para de Pedidos (SC5/SC7).
RegisterDateData de Emissão
OrderIdNúmero do Pedido

Código referente ao registro Protheus (C5_NUM).

CustomerCodeCó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.

CustomerInternalIdInternalId do Cli/For

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

Para utilização deve possuir o Adapter CUSTOMERVENDOR (MATA030 ou MATA360) cadastrado.

PaymentTermCodeCondição de PagamentoCó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 C6_VALDESC (valor de desconto 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

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
InternalIdInternalID Item do Pedido

O campo é preenchido com valor de referência do De/Para de Itens do Pedido (C6_ITEM).

OrderItemItem do PedidoO campo é preenchido com valor sequencial de referência do De/Para de Itens do Pedido (C6_ITEM).
ItemInternalIdInternalId 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.

ItemCodeCódigo do ProdutoCódigo referente ao registro Protheus (B1_COD).
QuantityQuantidade
UnityPricePreço unitário
TotalPriceValor Total
TypeOperationTipo da OperaçãoSe menor que 3 será tratado como C6_OPER, caso contrario será tratado como C6_TES.
CostCenterCodeCentro de CustoCódigo referente ao registro Protheus (CTT_CUSTO).
CostCenterInternalIdInternalID 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.



ElementoDescriçãoObservação
BusinessContent
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.
OrderPurposeObjetivo do pedido

Indica se o Pedido se trata de:
1 - Compra

2 - Venda

InternalIdInternalId do PedidoO campo é preenchido com valor de referência do De/Para de Pedidos (SC5/SC7).
RegisterDateData de Emissão
OrderIdNúmero do Pedido

Código referente ao registro Protheus (C5_NUM).

CustomerCodeCó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.

CustomerInternalIdInternalId do Cli/For

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

Para utilização deve possuir o Adapter CUSTOMERVENDOR (MATA030 ou MATA360) cadastrado.

PaymentTermCodeCondição de PagamentoCó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.

FreightType

Tipo de Frete

Código referente ao registro Protheus (C5_TPFRETE).

CarrierCode

Transportadora

Código com valor de referência do De/Para de Transportadora (SA4).

Para utilização deve possuir o Adapter CARRIERS (MATA050) cadastrado

InvoiceMessage

Mensagem da nota

Código referente ao registro Protheus (C5_MENNOTA).

FreightValueValor do Frete

Código referente ao registro Protheus (C5_FRETE).

GrossWeight

Peso Bruto

Código referente ao registro Protheus (C5_PBRUTO).

InsuranceValue

Valor do Seguro

Código referente ao registro Protheus (C5_SEGURO).

SellerCode

Código do vendedor

Código com valor de referência do De/Para de Vendedores (SE3).

Para utilização deve possuir o Adapter SELLER (MATA040) cadastrado ou cadastrar manualmente o valor de referência.

SellerIdCode

Código do vendedor

Código referente ao registro Protheus (A3_COD)

Para utilização deste, o SellerCode não deve ser enviado.

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.

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 com valor de referência do De/Para de Moeda (CTO).

Para utilização deve possuir o Adapter CURRENCY (CTBA140) cadastrado.

CurrencyCode

Moeda

Código referente ao registro Protheus (C5_MOEDA)

Para utilização deste, o CurrencyId não deve ser enviado.

WorkCode

Código da Obra

Código referente ao registro Protheus (C5_CNO).

SalesOrderItens.Item
InternalIdInternalID Item do Pedido

O campo é preenchido com valor de referência do De/Para de Itens do Pedido (C6_ITEM).

OrderItemItem do PedidoO campo é preenchido com valor sequencial de referência do De/Para de Itens do Pedido (C6_ITEM).
ItemInternalIdInternalId 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.

ItemCodeCódigo do Produto

Código referente ao registro Protheus (C6_PRODUTO).

Para utilização deste, o ItemInternalId não deve ser enviado.

ItemDescriptionDescrição do ItemCódigo referente ao registro Protheus (C6_PRODUTO).
WarehouseInternalIdLocais de Estoque

O campo é preenchido com valor de referência do De/Para de Armazém (NRR).

Para utilização deve possuir o Adapter WAREHOUSE (AGRA045) cadastrado.

UnitOfMeasureInternalIdUnidade de Medida do Item

O campo é preenchido com valor de referência do De/Para de Unidade de Medida (SAH).

Para utilização deve possuir o Adapter UNITOFMEASURE (QIEA030) cadastrado.

QuantityQuantidadeCódigo referente ao registro Protheus (C6_QTDVEN).
UnityPricePreço unitárioCódigo referente ao registro Protheus (C6_PRCVEN).
TotalPriceValor TotalCódigo referente ao registro Protheus (C6_PRUNIT).
TypeOperationTipo da OperaçãoSe menor que 3 será tratado como C6_OPER, caso contrario será tratado como C6_TES.
CostCenterCodeCentro de CustoCódigo referente ao registro Protheus (CTT_CUSTO).
CostCenterInternalIdInternalID 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.

ItemDiscountsValor 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). Para outras versões, o tratamento desta TAG é alterada, adicionando o desconto no cabeçalho (SC5) por exemplo.

LotNumberLote do Item

Código referente ao registro Protheus (C6_LOTECTL).

SubLotNumberSub Lote do Item

Código referente ao registro Protheus (C6_NUMLOTE).

SeriesItemSerie do Item 

Código referente ao registro Protheus (C6_NUMSERI).

AddressingItemEndereço do Item

Código referente ao registro Protheus (C6_LOCALIZ).

InvoicingDateData do Faturamento

Código referente ao registro Protheus (C6_DTFAT).

DeliveryDateData de Entrega

Código referente ao registro Protheus (C6_ENTREG).

AllocatedQuantityQuantidade Alocada

Código referente ao registro Protheus (C6_QTDEMP).

QuantityDeliveredQuantidade Entregue

Código referente ao registro Protheus (C6_QTDENT).

ItemReserveInternalIdReserva do Item

O campo é preenchido com valor de referência do De/Para de Reserva do Item (C0_DOCRES).

Para utilização deve possuir o Adapter ITEMRESERVE (LOJA704) cadastrado.

CustomerOrderNumberNúmero do Pedido do Cliente

Código referente ao registro Protheus (C6_PEDCLI).

ListOfApportionOrderItem
ProjectInternalIdCódigo do Projeto

O campo é preenchido com valor de referência do De/Para de Projeto (AF8_PROJET).

Para utilização deve possuir o Adapter PROJECT  (PMSA200) cadastrado.

TaskInternalIdCódigo da Tarefa

O campo é preenchido com valor de referência do De/Para do Código da Tarefa (AF9_TAREFA).

Para utilização deve possuir o Adapter TASKPROJECT (PMSA203) cadastrado.



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 (SC5 e SC6):
    • Os campos sem tag a serem gravados nas tabelas SC5 e SC6 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 (_USERLGI), Log de Alteração (_USERLGA) das tabelas SC5 e SC6 os campos já tagueados não serão incluídos na seção "AddFields".

06. PONTOS DE ENTRADA

07. TABELAS UTILIZADAS