...
- 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).
...
| Dica |
|---|
|
A Utilizar a versão 4.003 que é a última homologada para integração via XML ou JSON. |
...
| Deck of Cards |
|---|
|
| 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çãoCondição de pagamentoPagamento | 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 |
|---|
| | 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 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. |
|
| Card |
|---|
| id | 3 |
|---|
| label | XML 4.003 |
|---|
| 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 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. |
|
| Card |
|---|
| id | 4 |
|---|
| label | JSON |
|---|
| 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. | | FreightType | Tipo de Frete | Código |
referente ao registro Protheus (C5_TPFRETE).numérico correspondente ao campo C5_TPFRETE, utilizado para representar o tipo de frete, sendo:
"1" = C
"2" = F
"3" = T
"4" = R
"5" = D
"6" = S | | 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). |
SalesOrderItens.ItemInternalIdInternalID Item PedidoO campo é preenchido com valor de 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_ |
PRUNIT| 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). |
Para outras versões, o tratamento desta TAG é alterada, adicionando o desconto no cabeçalho (SC5) por exemplo
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 | 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). |
AllocatedQuantity | | InvoiceNumber | Número da Nota |
Quantidade Alocada | 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). |
|
|
0505. PROCESSAMENTO DE CAMPOS SEM TAGS E/OU CUSTOMIZADOS
...
| Aviso |
|---|
| title | 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
...
