Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 3

changes.mady.by.user Alberto Jose

Gravado em

comparado com

Nova versão 4

changes.mady.by.user Alberto Jose

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Configuração do Adapter MATA040
  4. Exemplos de mensagem EAI - JSON
  5. Tags
  6. Processamento de campos sem tags e/ou customizadosPontos de Entrada
  7. Tabelas utilizadas

01. VISÃO GERAL

        Configuração do Adapter Seller com formatos diferentes (XML,JSON).

02.

...

Quando utilizado o Adapter Seller (MATA040) obrigatoriamente, devem ter a mesma configuração do formato de arquivo (XML,JSON).  

...

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

Expandir
titleExemplos de arquivo JSON
Deck of Cards
idTags
effectTypefade
Card
id1
labelEnvio
effectTypefade
Bloco de código
languageyml
themeMidnight
firstline1
titleJSON de envio (GET)
linenumberstrue
{
   "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]"
      }
   }
}
Card
id2
labelRecebimento
effectTypefade
Bloco de código
languagejs
themeMidnight
firstline1
titleJSON de Recebimento (POST)
linenumberstrue
{
   "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]"
      }
   }
}


0504. Tags

Deck of Cards
idTags
effectTypefade
Card
id1
labelJSON
effectTypefade
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.

...

Aviso
titleInformações adicionais
  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

  • XX4 - Adapters EAI

  • SA3 - Cadastro de Vendedores