CONTEÚDO

  1. Visão Geral
  2. Configuração do Adapter MATA040
  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 Seller com formatos diferentes (XML,JSON).

02. CONFIGURAÇÃO DO ADAPTER MATA040

Exemplo de configuração do adapter Seller no formato JSON.

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

       

03. EXEMPLOS DE MENSAGEM EAI - JSON

{
   "Header":{
      "UUID":"b72d51be-95fe-9dac-43d0-3ecf110a0813",
      "Type":"BusinessMessage",
      "SubType":"event",
      "Event":"upsert",
      "Transaction":"SELLER",
      "StandardVersion":"1.000",
      "Version":"2.001",
      "SourceApplication":"P1212310T1",
      "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "Enterprise":"D ",
      "BusinessUnit":"MG ",
      "ProductName":"Protheus",
      "ProductVersion":"12",
      "GeneratedOn":"2025-04-09T19:00:49Z",
      "DeliveryType":"Async"
   },
   "Content":{
      "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "CompanyInternalId":"T1|D MG 01 ",
      "Code":"VEND01",
      "InternalId":"T1|D MG|VEND01",
      "Name":"VENDEDOR INTEGRACAO JSON",
      "ShortName":"VEND INT JSON",
      "Active":"0",
      "Login":"000773",
      "RepresentativeType":"I",
      "PersonalIdentification":"63407313000189",
      "SalesChargeInformation":{
         "CustomerVendorInternalId":"T1|D MG|VEND01|01|F",
         "SalesChargeInterface":"S"
      },
      "Address":{
         "Address":"RUA A, 1",
         "District":"BAIRRO TESTE",
         "City":{
            "Description":"SAO PAULO"
         },
         "State":{
            "StateCode":"SP",
            "StateInternalId":"SP",
            "StateDescription":"SAO PAULO"
         }
      },
      "ZipCode":"02511000",
      "CommunicationInformation":{
         "PhoneDDD":"011",
         "PhoneNumber":"123456789",
         "FaxDDD":"",
         "FaxNumber":"123456789",
         "FaxNumberExtension":"",
         "HomePage":"TESTE.COM.BR",
         "Email":"[email protected]"
      }
   }
}
{
   "Header":{
      "ProductVersion":"12",
      "BranchId":"D MG 01 ",
      "CompanyId":"T1",
      "Enterprise":"D ",
      "BusinessUnit":"MG ",
      "DeliveryType":"Sync",
      "Type":"BusinessMessage",
      "SourceApplication":"MASTERSALES",
      "ProductName":"PROTHEUS",
      "Transaction":"SELLER",
      "StandardVersion":"1.000",
      "Version":"2.001",
      "UUID":"DSERFAT-31253-12345678-ADDFIELDS-01",
      "SubType":"Event",
      "Event":"Upsert",
      "GeneratedOn":"2025-04-04T10:05:01Z"
   },
   "Content":{
      "CompanyId":"T1",
      "CompanyInternalId":"T1|D MG 01 ",
      "BranchId":"D MG 01 ",
      "Code":"VEND02",
      "InternalId":"T1|D MG    |VEND02",
      "ShortName":"VEND INT JSON 2",
      "Name":"VENDEDOR INTEGRACAO JSON 2",
      "Active":"0",
      "SellerPassword":"12345 ",
      "RepresentativeType":"I",
      "ZipCode":"02511000",
      "PersonalIdentification":"61830618000173",
      "SalesChargeInformation":{
         "SalesChargeInterface":"S",
         "CustomerVendorInternalId":"01|02|003|04"
      },
      "Login":"USERORIGEM",
      "Address":{
         "Address":"AV BRAS LEME, 1000",
         "District":"CASA VERDE",
         "City":{
            "Description":"SAO PAULO"
         },
         "State":{
            "StateCode":"SP",
            "StateDescription":"SAO PAULO",
            "StateInternalId":"SP"
         }
      },
      "CommunicationInformation":{
         "PhoneNumber":"44557788       ",
         "FaxNumber":"44557788       ",
         "HomePage":"www.teste.com.br",
         "PhoneDDD":"011",
         "Email":"[email protected]"
      }
   }
}


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.
CodeCódigo do Vendedor

Código referente ao registro Protheus (A3_COD).

InternalIdInternalId do VendedorO campo é preenchido com valor de referência do De/Para de Vendedores (SA3).
ShortNameNome Reduzido do VendedorCódigo referente ao registro Protheus (A3_NREDUZ).
NameNome do VendedorCódigo referente ao registro Protheus (A3_NOME).
ActiveBloqueia o VendedorCódigo referente ao registro Protheus (A3_MSBLQL).
LoginCódigo de UsuárioCódigo referente ao registro Protheus (A3_CODUSR).
RepresentativeTypeTipo de RepresentanteCódigo referente ao registro Protheus (A3_TIPO).
PersonalIdentificationCNPJ/CPF do vendedorCódigo referente ao registro Protheus (A3_CGC).
ZipCodeCEP do VendedorCódigo referente ao registro Protheus (A3_CEP).
SalesChargeInformation

CustomerVendorInternalId

Código do Vendedor como Fornecedor e Loja 

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

Para utilização deve possuir o Adapter CUSTOMERVENDOR (MATA020) cadastrado.

Código referente ao registro Protheus (A3_FORNECE e A3_LOJA).

SalesChargeInterfaceForma de Pagamento

Código referente ao registro Protheus (A3_GERASE2).

Address
AddressEndereço do VendedorCódigo referente ao registro Protheus (A3_END).
DistrictBairro do VendedorCódigo referente ao registro Protheus (A3_BAIRRO).
Address > City
DescriptionMunicípio do VendedorCódigo referente ao registro Protheus (A3_MUN).
Address > State
StateCodeEstado do VendedorCódigo referente ao registro Protheus (A3_EST).
StateInternalIdInternalId do Estado do VendedorCódigo referente ao registro Protheus (A3_EST).
StateDescriptionDescrição do EstadoDescrição do estado (Tabela 12 da SX5).
CommunicationInformation
PhoneDDDCódigo do DDDCódigo referente ao registro Protheus (A3_DDDTEL).
PhoneNumberNúmero do TelefoneCódigo referente ao registro Protheus (A3_TEL).
FaxDDDCódigo do DDD do FAXUsado apenas na mensagem de envio com conteúdo em branco.
FaxNumberNúmero do FAX do VendedorCódigo referente ao registro Protheus (A3_FAX).
FaxNumberExtensionExtensão do Número de FAXUsado apenas na mensagem de envio com conteúdo em branco.
HomePageHome-PageCódigo referente ao registro Protheus (A3_HPAGE).
EmailE-MailCódigo referente ao registro Protheus (A3_EMAIL).

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 (SA3):
    • Os campos sem tag a serem gravados na tabela SA3 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 (A3_USERLGI), Log de Alteração (A3_USERLGA) e os campos já tagueados não serão incluídos na seção "AddFields".

06. PONTOS DE ENTRADA

07. TABELAS UTILIZADAS