Linha Microsiga Protheus

Árvore de páginas

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

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

    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