Exibir origem

CONTEÚDO

Visão Geral
Exemplo de utilização
Configuração do Adapter MATA040
Exemplos de mensagem EAI - JSON
Tags
Processamento de campos sem tags e/ou customizados
Tabelas utilizadas

01. VISÃO GERAL

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

02. EXEMPLO DE UTILIZAÇÃO

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

03. CONFIGURAÇÃO DO ADAPTER MATA030

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

Linha Microsiga Protheus > Adapter EAI - Seller > image-2025-4-7_11-24-10.png

04. EXEMPLOS DE MENSAGEM EAI - JSON

{
   "Header":{
      "UUID":"436601c4-51c9-eff2-2ee2-b678a055b9b8",
      "Type":"BusinessMessage",
      "SubType":"event",
      "Event":"upsert",
      "Transaction":"CUSTOMERVENDOR",
      "StandardVersion":"1.000",
      "Version":"2.002",
      "SourceApplication":"P1212310T1",
      "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "Enterprise":"D ",
      "BusinessUnit":"MG ",
      "ProductName":"Protheus",
      "ProductVersion":"12",
      "GeneratedOn":"2025-03-25T18:12:36Z",
      "DeliveryType":"Async"
   },
   "Content":{
      "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "CompanyInternalId":"T1|D MG 01 ",
      "Code":"FTC009",
      "StoreId":"01",
      "InternalId":"T1|D MG|FTC009|01|C",
      "ShortName":"CT009 - Incluir",
      "Name":"Inclui - Envio EAI JSON - CT009",
      "Type":1,
      "StrategicCustomerType":"1",
      "EntityType":1,
      "RegisterDate":"1990-03-01",
      "RegisterSituation":"Active",
      "GovernmentalInformation":[
         {
            "Name":"INSCRICAO ESTADUAL",
            "Scope":"State",
            "Id":"860883954180"
         },
         {
            "Name":"INSCRICAO MUNICIPAL",
            "Scope":"Municipal",
            "Id":"260325"
         },
         {
            "Name":"CNPJ",
            "Scope":"Federal",
            "Id":"77337553000169"
         },
         {
            "Name":"SUFRAMA",
            "Scope":"Federal",
            "Id":"202503260"
         },
         {
            "Name":"INSCRICAO RURAL",
            "Scope":"State",
            "Id":"11223344"
         },
         {
            "Name":"RG",
            "Scope":"Federal",
            "Id":"11223345"
         }
      ],
      "Segment":[
         {
            "Name":"Segment1",
            "InternalId":"T1||000001",
            "CodeERP":"000001",
            "Description":"Industria Quimica\/Resinas\/Tintas\/Sinteticos"
         },
         {
            "Name":"Segment2",
            "InternalId":"T1||000002",
            "CodeERP":"000002",
            "Description":"Industria Faramaceutica\/Veterinaria"
         },
         {
            "Name":"Segment3",
            "InternalId":"T1||000003",
            "CodeERP":"000003",
            "Description":"Industria Refino Petroleo\/Destilacao Alcool"
         },
         {
            "Name":"Segment4",
            "InternalId":"T1||000004",
            "CodeERP":"000004",
            "Description":"Industria Plasticos"
         },
         {
            "Name":"Segment5",
            "InternalId":"T1||000005",
            "CodeERP":"000005",
            "Description":"Industria Textil"
         },
         {
            "Name":"Segment6",
            "InternalId":"T1||000006",
            "CodeERP":"000006",
            "Description":"Industria Vestuario\/Confeccoes"
         },
         {
            "Name":"Segment7",
            "InternalId":"T1||000007",
            "CodeERP":"000007",
            "Description":"Industria Informatica"
         },
         {
            "Name":"Segment8",
            "InternalId":"T1||000008",
            "CodeERP":"000008",
            "Description":"Industria Nautica"
         }
      ],
      "FreightType":{
         "Code":"C",
         "Description":"CIF"
      },
      "Carrier":{
         "CodeERP":"FAT001",
         "InternalId":"T1|D MG|FAT001",
         "Description":"TRANSPORTADORA FATURAMENTO PADRAO"
      },
      "Address":{
         "Address":"RUA TESTE",
         "Number":"1",
         "Complement":"CASA 1",
         "City":{
            "CityCode":"3550308",
            "CityInternalId":"3550308",
            "CityDescription":"SAO PAULO"
         },
         "District":"SANTANA",
         "State":{
            "StateCode":"SP",
            "StateInternalId":"SP",
            "StateDescription":"SAO PAULO"
         },
         "Country":{
            "CountryCode":"105",
            "CountryInternalId":"105",
            "CountryDescription":"BRASIL"
         },
         "Region":{
            "RegionCode":"001",
            "RegionInternalId":"T1||001",
            "RegionDescription":"NORTE"
         },
         "ZIPCode":"02510000",
         "POBox":"C1058"
      },
      "ShippingAddress":{
         "Address":"RUA TESTE",
         "Number":"2",
         "Complement":"BLOCO A",
         "City":{
            "CityCode":"3550308",
            "CityDescription":"SAO PAULO"
         },
         "District":"SANTANA",
         "State":{
            "StateCode":"SP"
         },
         "ZIPCode":"04278050"
      },
      "ListOfCommunicationInformation":[
         {
            "PhoneNumber":"551112345678",
            "FaxNumber":"87654321",
            "HomePage":"www.teste.com.br",
            "Email":"[email protected]"
         }
      ],
      "ListOfContacts":[
         {
            "ContactInformationName":"TESTE"
         }
      ],
      "BillingInformation":{
         "Address":{
            "Address":"RUA TESTE",
            "Number":"3",
            "Complement":"",
            "District":"IPIRANGA",
            "ZIPCode":"04278050",
            "City":{
               "CityDescription":"SAO PAULO"
            },
            "State":{
               "StateCode":"SP"
            }
         }
      },
      "VendorInformation":{
         "VendorType":{
            "Code":"FAT001",
            "VendorInformationInternalID":"T1|D MG|FAT001"
         }
      },
      "PaymentConditionCode":"030",
      "PaymentConditionInternalId":"T1|D MG 01|030",
      "PriceListHeaderItemCode":"001",
      "PriceListHeaderItemInternalId":"T1|D MG|001",
      "CreditInformation":{
         "CreditLimit":1
      },
      "Taxpayer":"1"
   }
}

{
   "Header":{
      "UUID":"DSERFAT-31227-15931641-JSON-FTAG0101",
      "Type":"BusinessMessage",
      "SubType":"event",
      "Event":"upsert",
      "Transaction":"CUSTOMERVENDOR",
      "StandardVersion":"1.000",
      "Version":"2.000",
      "SourceApplication":"environment",
      "CompanyId":"T1",
      "BranchId":"D MG 01",
      "Enterprise":"D",
      "BusinessUnit":"MG",
      "ProductName":"PROTHEUS",
      "ProductVersion":"12",
      "GeneratedOn":"2025-03-31T00:20:27Z",
      "DeliveryType":"sync"
   },
   "Content":{
      "CompanyId":"T1",
      "BranchId":"D MG 01",
      "CompanyInternalId":"T1|D MG 01",
      "Code":"FTAG01",
      "StoreId":"01",
      "InternalId":"T1|D MG|FTAG01|01|C",
      "ShortName":"CLIENTE FTAG01",
      "Name":"CADASTRO CLIENTE FTAG01",
      "Type":1,
      "StrategicCustomerType":"3",
      "EntityType":2,
      "RegisterDate":"1999-01-04",
      "RegisterSituation":"Active",
      "GovernmentalInformation":[
         {
            "Name":"INSCRICAO ESTADUAL",
            "Scope":"State",
            "Id":"860883954180"
         },
         {
            "Name":"INSCRICAO MUNICIPAL",
            "Scope":"Municipal",
            "Id":"260325"
         },
         {
            "Name":"CNPJ",
            "Scope":"Federal",
            "Id":"77337553000169"
         },
         {
            "Name":"SUFRAMA",
            "Scope":"Federal",
            "Id":"202503260"
         },
         {
            "Name":"RG",
            "Scope":"Federal",
            "Id":"11223345"
         },
         {
            "Name":"INSCRICAO RURAL",
            "Scope":"State",
            "Id":"11223344"
         }
      ],
      "Segment":[
         {
            "Name":"Segment1",
            "InternalId":"T1||000001",
            "CodeERP":"000001",
            "Description":"Industria Quimica\/Resinas\/Tintas\/Sinteticos"
         },
         {
            "Name":"Segment2",
            "InternalId":"T1||000002",
            "CodeERP":"000002",
            "Description":"Industria Faramaceutica\/Veterinaria"
         },
         {
            "Name":"Segment3",
            "InternalId":"T1||000003",
            "CodeERP":"000003",
            "Description":"Industria Refino Petroleo\/Destilacao Alcool"
         },
         {
            "Name":"Segment4",
            "InternalId":"T1||000004",
            "CodeERP":"000004",
            "Description":"Industria Plasticos"
         },
         {
            "Name":"Segment5",
            "InternalId":"T1||000005",
            "CodeERP":"000005",
            "Description":"Industria Textil"
         },
         {
            "Name":"Segment6",
            "InternalId":"T1||000006",
            "CodeERP":"000006",
            "Description":"Industria Vestuario\/Confeccoes"
         },
         {
            "Name":"Segment7",
            "InternalId":"T1||000007",
            "CodeERP":"000007",
            "Description":"Industria Informatica"
         },
         {
            "Name":"Segment8",
            "InternalId":"T1||000008",
            "CodeERP":"000008",
            "Description":"Industria Nautica"
         }
      ],
      "FreightType":{
         "Code":"S",
         "Description":"Sem frete"
      },
      "Carrier":{
         "CodeERP":"FAT001",
         "InternalId":"T1|D MG|FAT001",
         "Description":"TRANSPORTADORA FATURAMENTO PADRAO"
      },
      "Address":{
         "Address":"RUA TESTE",
         "Number":"1",
         "Complement":"CASA 10",
         "City":{
            "CityCode":"3550308",
            "CityInternalId":"3550308",
            "CityDescription":"SAO PAULO"
         },
         "District":"VILA MADALENA",
         "State":{
            "StateCode":"SP",
            "StateInternalId":"SP",
            "StateDescription":"SAO PAULO"
         },
         "Country":{
            "CountryCode":"105",
            "CountryInternalId":"105",
            "CountryDescription":"BRASIL"
         },
         "Region":{
            "RegionCode":"001",
            "RegionInternalId":"T1||001",
            "RegionDescription":"NORTE"
         },
         "ZIPCode":"05417110",
         "POBox":"C1058"
      },
      "ShippingAddress":{
         "Address":"RUA TESTE",
         "Number":"2",
         "Complement":"BLOCO A",
         "City":{
            "CityCode":"3550308",
            "CityDescription":"SAO PAULO"
         },
         "District":"IPIRANGA",
         "State":{
            "StateCode":"SP"
         },
         "ZIPCode":"04278050"
      },
      "ListOfCommunicationInformation":[
         {
            "PhoneNumber":"551112342467",
            "FaxNumber":"12342468",
            "HomePage":"www.teste.com.br",
            "Email":"[email protected]"
         }
      ],
      "ListOfContacts":[
         {
            "ContactInformationName":"TESTE"
         }
      ],
      "BillingInformation":{
         "Address":{
            "Address":"RUA TESTE",
            "Number":"50",
            "Complement":"123",
            "District":"IPIRANGA",
            "ZIPCode":"04278050",
            "City":{
               "CityDescription":"SAO PAULO"
            },
            "State":{
               "StateCode":"SP"
            }
         }
      },
      "VendorInformation":{
         "VendorType":{
            "Code":"FTEAI2",
            "VendorInformationInternalID":"T1|D MG 01 |FTEAI2"
         }
      },
      "PaymentConditionCode":"030",
      "PaymentConditionInternalId":"T1|D MG 01|030",
      "PriceListHeaderItemCode":"001",
      "PriceListHeaderItemInternalId":"T1|D MG|001",
      "CreditInformation":{
         "CreditLimit":1,
         "MaturityCreditLimit":"2099-10-01"
      },
      "Taxpayer":"1"
   }
}

05. 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).
SellerPassword	Senha para uso no dispositivos HandHeld.	Código referente ao registro Protheus (A3_SENHA).
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).

06. 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

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

07. PONTOS DE ENTRADA

08. TABELAS UTILIZADAS

XX4 - Adapters EAI
SA3 - Cadastro de Vendedores