Adapter EAI - Seller

CONTEÚDO

Visão Geral
Configuração do Adapter MATA040
Exemplos de mensagem EAI - JSON
Tags
Processamento de campos sem tags e/ou customizados
Pontos de Entrada
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

Exemplos de arquivo JSON

JSON de envio (GET)

{
   "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]"
      }
   }
}

JSON de Recebimento (POST)

{
   "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

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.
Code	Código do Vendedor	Código referente ao registro Protheus (A3_COD).
InternalId	InternalId do Vendedor	O campo é preenchido com valor de referência do De/Para de Vendedores (SA3).
ShortName	Nome Reduzido do Vendedor	Código referente ao registro Protheus (A3_NREDUZ).
Name	Nome do Vendedor	Código referente ao registro Protheus (A3_NOME).
Active	Bloqueia o Vendedor	Código referente ao registro Protheus (A3_MSBLQL).
Login	Código de Usuário	Código referente ao registro Protheus (A3_CODUSR).
RepresentativeType	Tipo de Representante	Código referente ao registro Protheus (A3_TIPO).
PersonalIdentification	CNPJ/CPF do vendedor	Código referente ao registro Protheus (A3_CGC).
ZipCode	CEP do Vendedor	Có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).
SalesChargeInterface	Forma de Pagamento	Código referente ao registro Protheus (A3_GERASE2).
Address
Address	Endereço do Vendedor	Código referente ao registro Protheus (A3_END).
District	Bairro do Vendedor	Código referente ao registro Protheus (A3_BAIRRO).
Address > City
Description	Município do Vendedor	Código referente ao registro Protheus (A3_MUN).
Address > State
StateCode	Estado do Vendedor	Código referente ao registro Protheus (A3_EST).
StateInternalId	InternalId do Estado do Vendedor	Código referente ao registro Protheus (A3_EST).
StateDescription	Descrição do Estado	Descrição do estado (Tabela 12 da SX5).
CommunicationInformation
PhoneDDD	Código do DDD	Código referente ao registro Protheus (A3_DDDTEL).
PhoneNumber	Número do Telefone	Código referente ao registro Protheus (A3_TEL).
FaxDDD	Código do DDD do FAX	Usado apenas na mensagem de envio com conteúdo em branco.
FaxNumber	Número do FAX do Vendedor	Código referente ao registro Protheus (A3_FAX).
FaxNumberExtension	Extensão do Número de FAX	Usado apenas na mensagem de envio com conteúdo em branco.
HomePage	Home-Page	Código referente ao registro Protheus (A3_HPAGE).
Email	E-Mail	Có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

Informações adicionais

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;
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

Ponto de entrada para a mensagem de envio.
PE M040OENV - Inclusão Tags customizadas no envio EAI Seller via Json
Ponto de entrada para a mensagem de recebimento.
PE M040OEAI - Inclusão de campos customizados no EAI Seller via Json

07. TABELAS UTILIZADAS

XX4 - Adapters EAI
SA3 - Cadastro de Vendedores

Árvore de páginas