CONTEÚDO
- Visão Geral
- 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).
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
Campo Formato configurado para XML.
Campo Formato configurado para JSON.
03. EXEMPLOS DE MENSAGEM EAI - JSON
04. TAGS
| 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: 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. |
| 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: 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 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 | ||
| 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. |
| 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: 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 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 | ||
| 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. |
| 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: 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. |
| FreightType | Tipo de Frete |
Código numérico correspondente ao campo C5_TPFRETE, utilizado para representar o tipo de frete, sendo: |
| 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). |
| FreightValue | Valor 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). |
| Discounts | ||
| Discount | Percentual do desconto |
Código referente ao registro Protheus (C5_DESC1, C5_DESC2, C5_DESC3 e C5_DESC4). Específico para mensagem de envio. |
| SalesOrderItens | ||
| 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 (C6_PRODUTO). Para utilização deste, o ItemInternalId não deve ser enviado. |
| ItemDescription | Descrição do Item | Código referente ao registro Protheus (C6_PRODUTO). |
| WarehouseInternalId | Locais 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. |
| UnitOfMeasureInternalId | Unidade 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. |
| Quantity | Quantidade | Código referente ao registro Protheus (C6_QTDVEN). |
| UnityPrice | Preço unitário | Código referente ao registro Protheus (C6_PRCVEN) e na mensagem de recebimento grava também o campo (C6_PRUNIT). |
| TotalPrice | Valor Total | Código referente ao registro Protheus (C6_VALOR). |
| 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. |
| 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). |
| 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 | Código referente ao registro Protheus (C6_NUMSERI). |
| AddressingItem | Endereço do Item | Código referente ao registro Protheus (C6_LOCALIZ). |
| 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 | Código referente ao registro Protheus (C6_SERIE) se o item já tiver sido faturado parcialmente. |
| AllocatedQuantity | Quantidade Alocada | Código referente ao registro Protheus (C6_QTDEMP). |
| QuantityDelivered | Quantidade Entregue | Código referente ao registro Protheus (C6_QTDENT). |
| ItemReserveInternalId | Reserva 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, caso contrário, será enviado o código o número de documento da reserva (C6_RESRVA). |
| CustomerOrderNumber | Número do Pedido do Cliente | Código referente ao registro Protheus (C6_PEDCLI). |
| ListOfApportionOrderItem | ||
| InternalId | InternalId do Pedido de Venda | Específico se houver integração com SIGAPMS. |
| ProjectInternalId | Có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. |
| TaskInternalId | Có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. Específico para mensagem de envio se houver integração com SIGAPMS. |
| CostCenterInternalId | InternalId do Centro de Custo | Código referente ao De/Para (XXF). Para utilização deve possuir o Adapter COSTCENTER (CTBA030) cadastrado. |
| Value | Valor do rateio por centro de custo | Específico para mensagem de envio se houver integração com SIGAPMS. |
| Quantity | Quantidade do rateio por centro de custo | Específico para mensagem de envio se houver integração com SIGAPMS. |
| Percentual | Percentual do rateio por centro de custo | |
ListOfCreditDocument |
||
| CreditDocumentInternalId | InternalId do Título a Receber (Recebimento Antecipado) | Código referente ao De/Para (XXF). Para utilização deve possuir o Adapter ACCOUNTRECEIVABLEDOCUMENT (FINA040) cadastrado. |
| Value | Valor do Título RA | Código referente ao registro Protheus (E1_VALOR). |
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 (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;
- Exclusões na seção "AddFields":
- Os campos Log de Inclusão (_USERLGI), Log de Alteração (_USERLGA) e UUID (_MSUIDT) das tabelas SC5 e SC6 os campos já tagueados não serão incluídos na seção "AddFields";
- Na mensagem de recebimento se houver integração com módulo SIGAPMS ou integração Protheus x HIS, o campo C5_NATUREZ será excluso da seção "AddFields pois será gravado com o conteúdo do parâmetro MV_SLMNTPV;
- Na mensagem de recebimento o campo C5_ORIGEM não será incluído na seção "AddFields", pois se a integração for Protheus x Logix, o campo será gravado com conteúdo LOGIX, caso contrário será gravado com conteúdo MSGEAI.
06. PONTOS DE ENTRADA
- Ponto de entrada para a mensagem de recebimento.
DT PE MT410EAI - Edição dos Arrays de cabeçalho e itens antes da gravação - Integração
07. TABELAS UTILIZADAS
XX4 - Adapters EAI
- SC5 - Pedidos de Venda
- SC6 - Itens do Pedidos de Venda


