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 (ITEM).

Caso queira verificar os campos que compõem a mensagem de Item, 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
TOTVS ProtheusEnviaSincrona4.011JSON
TOTVS OMNIRecebeSincrona4.011JSON

Antes de realizar a integração de um Produto, 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.


Cadastro do adapter ITEM 

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

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?

Deve ser configurado o cadastro do Conector  e carga inicial de produto (Pagina de configuração no OMNI Beatriz irá enviar o link da carga inicial de produto)

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.


Já tenho diversos produtos cadastrados que atende os dados informados acima e quero integra-los, o que eu faço?

Neste caso deve ser realizado a execução da Carga inicial.


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": ""
    }
}


Demais informações


Após realizar o cadastro do Produto no TOTVS Protheus será gerado a mensagem ITEM no EAI do configurador, essa mensagem é disparada ao TOTVS OMNI através da ROTA cadastrada e vinculado ao Adapter ITEM.


Quando recepcionado e processada a mensagem ITEM pelo TOTVS OMNI, o mesmo retorna uma mensagem para o Protheus informando sucesso ou falha na integração.

Em caso de sucesso, é gravado no Protheus na tabela XXF um DE/PARA de Produto, com o código do Produto atribuído no TOTVS OMNI relacionando com o código do Produto no Protheus.

Em caso de falha no monitor do EAI é possível verificar que a legenda da mensagem foi alterada para a cor amarela, indicando falha e conseguimos visualizar o motivo da falha através da do detalhe da mensagem.


A mensagem pode ter diversos tipos de status e cada um deles esta vinculado a uma legenda sendo elas:

Aguardando execução

Executando

Finalizada

Falhou

Bloqueado

Não entregue

Recusada

Entregue