Páginas filhas
  • DINTVENDAS-36 - DT - 2670 - Integrações E-commerce

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

01. DADOS GERAIS

Produto:

Solucoes_totvs
SolucaoTOTVS Distribuição e Varejo


Linha de Produto:

Linhas_totvs
LinhaLinha Winthor


Segmento:

Segmentos_totvs
SegmentoDistribuição


Módulo:

26 - Modulo Integrações


Função:Cadastro Centralizado de Integrações
País:Brasil
Ticket:

Requisito/Story/Issue (informe o requisito relacionado) :DINTVENDAS-36

02. SITUAÇÃO/REQUISITO

A necessidade é a Criação de nova rotina para integração com parceiros.
O requisito envolve criar uma rotina de cadastro centralizado de integrações. O projeto inicial está baseado nas necessidades do iFood, mas deve ser modelado e preparado para comportar outros parceiros futuramente.
O objetivo é centralizar as configurações de integração em uma única tela, onde todas as integrações ficam configuradas e cada uma é representada por uma linha.

03. SOLUÇÃO

A funcionalidade desenvolvida é a Rotina 2670 - Integrações E-commerce, um cadastro centralizado implementado no Módulo 26.
Esta rotina resolve o desafio de gerenciar múltiplas integrações em um único ponto, apresentando as seguintes características:

1. Interface Modernizada:

  • A Tela de Aterrissagem segue o padrão cadastros modernizados, contendo Filtros Ativo/Inativo e um GRID que lista o código, descrição da integração e Status. O status é controlado pelo campo DTEXCLCLUSAO na tabela de cabeçalhos. O menu de 3 pontos oferece opções de Editar, Inativar (preenche DTEXCLUSAO), e Reativar (limpa DTEXCLUSAO para registros inativos). Ação de duplo clique também deve abrir a tela de edição.


2. Estrutura de Cadastro com Abas: A inclusão/edição abre uma tela com duas abas: Credenciais e Configurações, utilizando o novo componente NG de abas.

  • O cabeçalho exige campos obrigatórios como Descrição, Layout (Multi-seleção lendo da tabela PCINTEGRAECOMMERCE_LAYOUTC) e Filiais (Multi-seleção para vincular filiais à integração).


3. Configurabilidade por Filial (GRIDs Configuráveis): Ambas as abas se comportam como GRIDs configuráveis, com lógica baseada na tabela PCINTEGRAECOMMERCE_LAYOUTI.

  • Credenciais (TIPO = 'CREDENCIAS'): A Filial é obrigatória, pois cada filial possui chaves distintas de autenticação.
  • Configurações (TIPO = 'CONFIGURACOES'): Deve permitir a opção GERAL no multiseleção de filiais, aplicando uma regra padrão.
  • Validação: Parâmetros definidos como OBRIGATORIO são exibidos em negrito e bloqueiam a gravação caso estejam vazios.


4. Persistência dos Dados: As configurações são gravadas nas seguintes tabelas:

  • PCINTEGRAECOMMERCE_CONFIG (Cabeçalho, incluindo DTEXCLUSAO).
  • PCINTEGRAECOMMERCE_FILIAL (Vinculação de filiais).
  • PCINTEGRAECOMMERCE_PARAMS (Parâmetros, onde o campo CODFILIAL pode ser nulo se for um parâmetro GERAL).
Totvs custom tabs box
tabsSaiba como Funciona
idspasso1,
Totvs custom tabs box items
defaultyes
referenciapasso1

Rotinas e Dependências:

Abaixo estão as rotinas e tabelas necessárias para a funcionalidade:

Tipo

Nome

Versão Mínima

Rotina

2670 - Integrações E-commerce

38.0.4.15

Tabela

PCINTEGRAECOMMERCE_LAYOUTC

07.00.03.00

Tabela

PCINTEGRAECOMMERCE_LAYOUTI

07.00.04.00

Tabela

PCINTEGRAECOMMERCE_CONFIG (Cabeçalho)

08.00.01.00

Tabela

PCINTEGRAECOMMERCE_FILIAL (Vinculação)

07.00.02.00

Tabela

PCINTEGRAECOMMERCE_PARAMS (Parâmetros)

07.00.03.00

Tabela

INSERT__INTEGRACAO_ECOMMERCE

08.00.01.00

Rotina

ROTINA.2670

08.00.01.00

PASSO A PASSO: Criação e Gestão de Integrações Centralizadas
Este guia detalha o processo de utilização da Rotina 2670 (Cadastro Centralizado de Integrações).

1. Abertura da Rotina (Tela de Aterrissagem)

      1. Acesse o Módulo 26 e abra a rotina ROTINA.2670.
      2. Utilize os Filtros Ativo/Inativo para listar os registros.
      3. Para criar uma nova integração, clique no Botão Novo.
      4. Para editar, use o Menu de 3 pontos (opção Editar) ou o duplo clique sobre a linha no GRID.

2. Tela de Inclusão / Edição (Cabeçalho)

Preencha os campos obrigatórios:

      1. Descrição: Informe o nome da integração.
      2. Layout: Utilize a Multi-seleção, buscando dados da tabela PCINTEGRAECOMMERCE_LAYOUTC. OBS: O sistema deve trazer a descrição da tabela e o código entre parênteses à frente do nome.
      3. Filiais: Use a Multi-seleção para vincular filiais à integração.

3. Aba Credenciais

Esta aba configura os parâmetros de autenticação (TIPO = 'CREDENCIAS'):

      1. No ComboBox, selecione a Filial. A seleção é obrigatória. O ComboBox listará apenas as filiais vinculadas no cabeçalho.
      2. Preencha o Valor do parâmetro para cada Nome do parâmetro (campo DESCRICAO_LIVRE).
      3. Campos em negrito (marcados como OBRIGATORIO) bloqueiam a gravação caso estejam vazios.

4. Aba Configurações

Esta aba configura os parâmetros gerais e específicos (TIPO = 'CONFIGURACOES'):

      1. No ComboBox, selecione a filial ou a opção GERAL, que aplica a regra padrão.
      2. Preencha os valores na GRID. A lógica de validação e o comportamento são os mesmos da Aba Credenciais.

5. Gravação da Configuração

    1. Clique em Salvar (ou Cancelar), seguindo o padrão modernizado.
    2. O sistema exibirá a tela padrão de confirmação de gravação após salvar.


04. DEMAIS INFORMAÇÕES

• A rotina de cadastro centralizado de integrações foi modelada inicialmente para atender às necessidades do iFood, mas foi preparada para suportar a inclusão de outros parceiros futuramente.
• O sistema utiliza campos de metadados como ORDEMEXIBICAO (para o ORDER BY dos parâmetros) e EDITAVEL (que controla se o valor pode ser alterado) para configurar o comportamento da GRID, baseados na PCINTEGRAECOMMERCE_LAYOUTI.
• A persistência dos parâmetros (PCINTEGRAECOMMERCE_PARAMS) armazena o CODFILIAL, que pode ser nulo quando o parâmetro for configurado como GERAL na aba Configurações.

Aviso
titleImportante

As versões estarão disponíveis para download na rotina 801 do WTA. 

https://centraldecontrole.pcinformatica.com.br/


Mantenha suas rotinas sempre atualizadas!

05. ASSUNTOS RELACIONADOS