Histórico da Página

Informações

title	Importante!

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.

Produto	Fluxo	Tipo da Mensagem	Versão MSU	Formato
Protheus	Envia	Assincrona	4.005 API	JSON
CiaShop	Recebe	Assincrona	4.005	JSON

Dica

title	Dica!

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.

No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
Clique em incluir e cadastre a rotina responsável pela mensagem Item, como mostra o vídeo abaixo:

Expandir

title	Assistir o vídeo

Informações

title	Auxilio no preenchimento dos campos

Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

Versão

Alias

Rota

Formato

MATA010

Item

Produto

Sim

Não

Síncrono

Todas

LjxjCsCoPr()

PAD.APP

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

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

Conector de Widget

width	400
url	https://www.youtube.com/watch?v=eLoLWcfcLoU&list=PLXa8l0dq5zRmzBg2ZVvB0yfQdth9tf0EL
height	400

Informações

title	Duvida

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

Expandir

title	Ver os dados necessários

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

Dica

title	Visualizar o dado gerado

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:

Acesse o ambiente Configurador (SIGACFG) em Ambiente/Schedule/Schedule, opção EAI:
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:

Conector de Widget

width	400
url	https://www.youtube.com/watch?v=eLoLWcfcLoU&list=PLXa8l0dq5zRmzBg2ZVvB0yfQdth9tf0EL
height	400

Expandir

title	Exemplo da mensagem ITEM

Bloco de código

title	Json

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

Dica

title	Fluxo da integração de Produto

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, como mostra o exemplo abaixo:

GIF DE DE-PARA

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, como mostra o exemplo abaixo:

GIF DE FALHA E MENSAGEM DE FALHA

Informações