Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.




Informações
titleImportante!

O cadastro de Clientes será realizado no sistema 

...

TOTVS OMNI, e será integrado com o

...

sistema TOTVS Protheus através de comunicação de Mensagem Única (CUSTOMERVENDOR).

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

Produto

Fluxo

Tipo da Mensagem

Versão MSU

Formato

Ciashop
TOTVS OMNIEnvia
Assíncrona
Síncrona2.005

JSON

TOTVS ProtheusRecebe
Assíncrona
Síncrona2.005JSON
Dica
titleDica!

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

  • Mas afinal o que é um Adapter?

Adapter é uma rotina responsável pela mensagem (CustomerVendor) 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 CUSTOMERVENDOR

        Pré-requisitos:

...

  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:


Expandir
titleAssistir o vídeo

Adicionar vídeo

Informações
titleAuxilio no preenchimento dos campos

Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

VersãoAliasRotaFormato
MATA030CustomerVendorCliente/FornecedorNãoSimSíncronoTodas


PAD.APP2.000

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


Integrando um cliente no Protheus



Dica
titleDica!

Como é realizada a integração de cliente entre o TOTVS OMNI e o TOTVS Protheus?

Na camada do TOTVS OMNI, ao recepcionar um pedido e os dados do cliente, o mesmo realiza alguns procedimentos internos e em seguida envia ao Protheus a mensagem CustomerVendor, responsável pelos dados de cadastro do cliente no Protheus.

Recepcionamos e processamos esta mensagem e o cliente é cadastrado no Protheus de forma automática. 

Caso já tenha cadastrado o cliente no Protheus o que vai acontecer?

A mensagem CustomerVendor, é processada normalmente e é verificado se o cliente de mesmo CPF/CNPJ já existe no Protheus e se o endereço de entrega e os demais dados são os mesmos. Se sim o cadastro do cliente é mantido o mesmo.

Caso o endereço de entrega seja diferente, o cadastro do cliente no Protheus mantido e em seguida é gerado um novo cadastro para o cliente com o mesmo CÓDIGO(A1_COD), alterando o numero da LOJA(A1_LOJA) e preenchendo o novo endereço do cliente.

Importante: Para o funcionamento do cenário mencionado acima é de extrema importância que os parâmetros  MV_VALCNPJ e MV_VALCPF, estejam preenchidos com 1, como informado na documentação.


Abaixo exemplo da mensagem CustomerVendor:

Expandir
titleExemplo da mensagem CustomerVendor
Bloco de código
titleJson
Inserir json de CustomerVendor


Demais informações


Dica
titleFluxo da integração de Reserva de Produto

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

Em caso de sucesso, é gravado no Protheus na tabela XXF um DE/PARA de cliente, com o código da reserva no TOTVS OMNI relacionando com o código do cliente gerado 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
titleLegendas de status da mensagem

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

Image Added Aguardando execução

Image Added Executando

Image Added Finalizada

Image Added Falhou

Image Added Bloqueado

Image Added Não entregue

Image Added Recusada

Image Added Entregue

Image Removed

Clique em Salvar para integrar o produto com o sistema da Protheus.

        Importante: o registro será enviado toda vez que confirmar alguma ação: Inclusão, Alteração ou Exclusão.

  • Ciashop Envio - CUSTOMERVENDOR
    Envio da mensagem:
    Para identificar o registro da mensagem enviada pelo sistema CIASHOP,é necessário acessar o DashBoard (Ferramenta de visualização de processamento de mensagens) e em seguida pesquisar pelo UUID da mensagem enviada pelo Ciashop nos seguintes destinos:
    • Aguarandoprocessamento: Indica a quantidade de processos específicos, por exemplo (Reserva) estão aguardando na fila para serem executados.
    • Processando:Significa que após aguardar na fila o arquivo é envidado para ser processado.
    • Processado:Significa que o arquivo foi processado com sucesso, como por exemplo, enviou uma reserva para o Protheus e o mesmo retorno uma mensagem de sucesso. 
    • Error: Significa que receberá o log de erro da integração especifica, tanto ao tentar enviar quanto AguardoCallback com retorno de erro.
    • Reprocessar: Indica que a mensagem estava processando e teve algum tipo de erro ou uma possível instabilidade e a mensagem irá reprocessar novamente

  OBS: link do DashBoard é fornecido pela CiaShop.

Image Removed

...

Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"

Acessar o ambiente Configurador (SIGACFG) em Ambiente/Schedule/Schedule, opção EAI:

Image Removed

           

Mensagem única CustomerVendor

Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original.

Código da Função: CustomerVendor

UUID: 6f0ee673-b629-48d8-a69e-afd5a8f3b5e4

Descrição da Mensagem: Clientes

Tipo da Transação: Recepção

Tipo da Mensagem: Business Message

Url de Envio: http://eaistaging.ciashop.com.br/protheus/tirateima

Evento: UpSert

Json:

Image Removed

Verificação do Registro no Protheus.

Entrar no módulo de Faturamento/Atualizações/Cadastro/Clientes:

Image RemovedImage Removed

...