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.

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

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

03. SOLUÇÃO

A

...

A funcionalidade desenvolvida inclui:

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.

...

    ◦ A ação de Inativar preenche o campo DTEXCLUSAO, e a ação de Reativar limpa o DTEXCLUSAO.

  • 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).

Sugestão: Devido à complexidade da configuração das GRIDs (Credenciais e Configurações), que envolvem lógica de ComboBox, recarregamento de parâmetros e validação de campos OBRIGATORIOS, sugere-se a utilização da macro TOTVS CUSTOM TABS BOX para melhor organização do PASSO A PASSO de utilização das abas.

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:

Serviços 1.38.1.3

Tipo

Nome

Versão Mínima

winthor-integracao-config1.38.2.6
Layout IFOOD1.38.0.8
winthor-integracao-2650

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.

...