O cadastro de Produtos será realizado no sistema TOTVS Protheus, e será integrado com o sistema TOTVS OMNI através de comunicação de Mensagem Única (CommercialFamily).

Caso queira verificar os campos que compõem a mensagem de Categoria, acesse  https://api.totvs.com.br/legado Clique no Link: Mensagem Padronizada, depois em  Lista de serviços e busque a mensagem Item.


ProdutoFluxoTipo da MensagemVersão MSUFormato
ProtheusEnviaAssincrona4.005 APIJSON
CiaShopRecebeAssincrona4.005JSON

Antes de realizar a integração de uma Categoria, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).

  • Mas afinal o que é um Adapter?

O  Adapter é uma rotina responsável pela mensagem (Item) e seu cadastro é necessário para definir algumas informações importantes, como por exemplo, o tipo da mensagem JSON ou XML, se será possível enviar e receber a mensagem ou somente uma dessas opções.

  • Importante: Como pré-requisito para o cadastro do Adapter é imprescindível ter o Cadastro de Rota.


  1. No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i

  2. Clique em incluir e cadastre a rotina responsável pela mensagem Item, como mostra o vídeo abaixo:


Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

VersãoAliasRotaFormato
MATA010ItemProdutoSimNãoSíncronoTodas

LjxjCsCoPr()

PAD.APP4.005

SUA_ROTA

JSON


Importante: O campo Condição de envio pode ser preenchido com uma função ou expressão logica, para determinar se o Produto em questão será enviado ou não, no caso do adapter de ITEM, estamos utilizando a função LjxjCsCoPr():

LjxjCsCoPr(): Esta função verifica se o produto cadastrado atende as seguintes condições:

Produto vinculado à uma Categoria de Produtos

Produto com complemento de produtos cadastrado e o campo E-commerce(B5_ECFLAG)  = 1 - Ativo.

Atendendo estes requisitos a mensagem de Item será gerada e enviada ao TOTVS OMNI.


Cadastro e integração do Produto

  1. No Faturamento (SIGAFAT) acesse Atualizações / Cadastros / Produtos (MATA010).
  2. Inclua/Altere o produto com as informações necessárias, como mostra o vídeo abaixo:


O que um produto precisa ter para ser integrado com o TOTVS OMNI corretamente?

Ter categoria previamente cadastrada no Protheus

Produto vinculado à uma Categoria de Produtos

Produto com complemento de produtos cadastrado e o campo E-commerce(B5_ECFLAG)  = 1 - Ativo.


Mensagem gerada e enviada para o TOTVS OMNI


Após realizar o cadastro de Produto e suas demais informações necessárias para integra-lo é possível visualizar a mensagem gerada e enviada para o TOTVS OMNI, para isso siga o passo a passo abaixo:


  1. Acesse o ambiente Configurador (SIGACFG) em Ambiente/Schedule/Schedule, opção EAI:
  2. Em seguida posicione o cursos na mensagem gerada e clique no ícone da Lupa e em seguida, Visualizar mensagem original, como mostra o vídeo abaixo:



{
    "Header": {
        "ProductVersion": "12",
        "BranchId": "01",
        "Type": "BusinessMessage",
        "ProductName": "Protheus",
        "BusinessUnit": "",
        "DeliveryType": "Sync",
        "Transaction": "ITEM",
        "StandardVersion": "1.000",
        "Version": "4.007",
        "UUID": "36130507-ba1d-db7f-0901-ccfb1c4f4e93",
        "SubType": "event",
        "Enterprise": "",
        "Event": "upsert",
        "CompanyId": "99",
        "GeneratedOn": "2022-08-01T14:31:15Z",
        "SourceApplication": "PROTHEUS3399"
    },
    "Content": {
        "ItemStatus": "1",
        "StandardWarehouseInternalId": "99|01|01",
        "ItemTitle": "                                                                                                    ",
        "ItemWidth": "0",
        "CompanyId": "99",
        "UnitOfMeasureCode": "UN",
        "Code": "702",
        "FiscalInformation": {
            "CsllAliquot": "0",
            "IrrfIncidence": "false",
            "IssServiceCode": "         ",
            "PisRetaining": "false",
            "CsllRetaining": "false",
            "PisAliquot": "0",
            "CofinsAliquot": "0",
            "TaxSubstitutionCode": "         ",
            "CofinsRetaining": "false",
            "IssAliquot": "0",
            "MunicipalTaxCod": "                    "
        },
        "ItemLenght": "0",
        "EconomicLot": "0",
        "Name": "PRODUTO OMNI QA",
        "MinimumLot": "0",
        "ManufacturerCode": "                    ",
        "ItemHeight": "0",
        "NetWeight": "0",
        "Values": {
            "CostPrice": "0",
            "SalesPrice": "15",
            "AverageCostPrice": "0",
            "StandardCostPrice": "0"
        },
        "Brand": "",
        "ShortName": "PRODUTO OMNI QA",
        "Active": "1",
        "MultiplicationFactorValue": "0",
        "CompanyinternalId": "99|01",
        "InternalId": "99||702",
        "ProductType": "10",
        "GrossWeight": "0",
        "ItemFeaturesTechnical": "",
        "ItemDescription": "asd",
        "ItemDimensions": "0",
        "BranchId": "01",
        "UnitOfMeasureInternalId": "99||UN",
        "ListOfComercialFamilyItem": {
            "ComercialFamilyItem": [{
                    "ComercialFamilyCode": "000001",
                    "ComercialFamilyInternalId": "99||000001",
                    "ComercialFamilyItem": "CAT 12.1.25"
                }
            ]
        },
        "StandardWarehouseDescription": "ARMAZEM PADRAO",
        "TypeUMConversion": [{
                "type": "M",
                "Description": "Multiplicador"
            }
        ],
        "StandardWarehouseCode": "01",
        "Trail": "N",
        "BinControl": "False",
        "Origin": ""
    }
}