Pesquisa avançada

Integração StarTwo: Views obrigatórias no banco de dados

1. Qual é o objetivo desta FAQ?

Orientar técnicos, analistas e revendas sobre a verificação das views necessárias para integração do sistema com a empresa StarTwo.

Antes de abrir chamado para desenvolvimento, deve-se confirmar se essas views já existem no banco de dados do cliente.

2. Quais views precisam existir?

As views obrigatórias são:

<pre class="cm-content q9tKkq_readonly m-0">vw_c_dados_associado vw_c_lista_barras vw_c_lista_estoque vw_c_mercadorias_compradas vw_c_mercadorias_vendidaspre>
 

Essas views disponibilizam os dados utilizados pela StarTwo para consultar informações de cadastro, produtos, compras, vendas, códigos de barras e estoque.

3. Para que serve cada view?

vw_c_dados_associado

Disponibiliza os dados cadastrais da empresa ou filial associada.

Principais informações:

 
<pre class="cm-content q9tKkq_readonly m-0">CNPJ Razão socialpre>
 

vw_c_lista_barras

Disponibiliza os códigos de barras dos produtos movimentados no sistema.

Principais informações:

 
<pre class="cm-content q9tKkq_readonly m-0">Código de barras CNPJ do associado Código da mercadoria Data da movimentaçãopre>
 

vw_c_lista_estoque

Disponibiliza o estoque dos produtos movimentados.

Principais informações:

 
<pre class="cm-content q9tKkq_readonly m-0">CNPJ do associado Código do produto Descrição da mercadoria Unidade Data Quantidade em estoquepre>
 

vw_c_mercadorias_compradas

Disponibiliza as mercadorias compradas pelo associado.

Principais informações:

 
<pre class="cm-content q9tKkq_readonly m-0">CNPJ do associado Produto Unidade Código da mercadoria Quantidade CNPJ do fornecedor Razão social do fornecedor Valor total Data da comprapre>
 

vw_c_mercadorias_vendidas

Disponibiliza as mercadorias vendidas pelo associado.

Principais informações:

 
<pre class="cm-content q9tKkq_readonly m-0">CNPJ do associado Produto Unidade Código da mercadoria Quantidade vendida Valor total vendido Data da vendapre>
 

4. Como verificar se as views já existem?

No PostgreSQL, execute:

 
<pre class="cm-content q9tKkq_readonly m-0">SELECT schemaname, viewname FROM pg_views WHERE viewname IN ( 'vw_c_dados_associado', 'vw_c_lista_barras', 'vw_c_lista_estoque', 'vw_c_mercadorias_compradas', 'vw_c_mercadorias_vendidas' ) ORDER BY viewname;pre>
 

O resultado deve apresentar as cinco views.

5. Como verificar pelo pgAdmin?

No pgAdmin, siga este caminho:

 
<pre class="cm-content q9tKkq_readonly m-0">Banco de dados > Schemas > public > Viewspre>
 

Confirme se aparecem:

 
<pre class="cm-content q9tKkq_readonly m-0">vw_c_dados_associado vw_c_lista_barras vw_c_lista_estoque vw_c_mercadorias_compradas vw_c_mercadorias_vendidaspre>
 

6. O que fazer quando todas as views já existirem?

Quando todas as views estiverem disponíveis:

  1. Não é necessário solicitar nova criação.
  2. Deve-se testar se elas retornam dados.
  3. Deve-se validar o CNPJ da empresa.
  4. Deve-se informar à StarTwo que as views estão disponíveis.
  5. Devem ser enviados os dados de conexão conforme o procedimento de segurança da empresa.

Nunca envie usuário, senha ou acesso ao banco em chamado público ou grupo aberto.

7. Como testar se as views retornam dados?

Execute:

 
<pre class="cm-content q9tKkq_readonly m-0">SELECT * FROM public.vw_c_dados_associado LIMIT 10; SELECT * FROM public.vw_c_lista_barras LIMIT 10; SELECT * FROM public.vw_c_lista_estoque LIMIT 10; SELECT * FROM public.vw_c_mercadorias_compradas LIMIT 10; SELECT * FROM public.vw_c_mercadorias_vendidas LIMIT 10;pre>
 

O teste deve verificar se:

  • a consulta executa sem erro;
  • existem registros;
  • o CNPJ está correto;
  • os produtos estão sendo apresentados;
  • as datas estão preenchidas;
  • os valores e quantidades são coerentes.

8. E se a view existir, mas não retornar dados?

Verifique:

  • se existem movimentações no período;
  • se o CNPJ da filial está cadastrado corretamente;
  • se existem compras ou vendas lançadas;
  • se os produtos possuem código de barras;
  • se as movimentações estão válidas e não canceladas;
  • se o usuário do banco possui permissão de leitura;
  • se a view apresenta erro ao ser consultada.

Também faça um teste com um período em que exista movimentação conhecida.

Exemplo:

 
<pre class="cm-content q9tKkq_readonly m-0">SELECT * FROM public.vw_c_mercadorias_vendidas WHERE data >= CURRENT_DATE - INTERVAL '30 days' ORDER BY data DESC;pre>
 

9. E se alguma view estiver faltando?

Caso uma ou mais views não existam:

  1. Identifique exatamente quais estão faltando.
  2. Registre a versão do sistema e do banco.
  3. Confirme se o cliente realmente utilizará a integração StarTwo.
  4. Abra chamado para criação ou atualização das views.
  5. Anexe o resultado da consulta de verificação.

Modelo de informação para o chamado:

 
<pre class="cm-content q9tKkq_readonly m-0">Cliente: CNPJ: Versão do sistema: Banco de dados: Integração solicitada: StarTwo Views existentes: - vw_c_dados_associado - vw_c_lista_barras Views ausentes: - vw_c_lista_estoque - vw_c_mercadorias_compradas - vw_c_mercadorias_vendidaspre>
 

10. A existência das views garante que a integração está funcionando?

Não.

A existência das views confirma apenas que a estrutura está disponível.

Ainda é necessário validar:

  • retorno dos dados;
  • permissão de acesso;
  • CNPJ correto;
  • consistência das compras;
  • consistência das vendas;
  • códigos de barras;
  • estoque;
  • conexão da StarTwo com o banco.

11. É permitido alterar os nomes ou campos das views?

Não sem validação prévia.

A StarTwo pode depender dos nomes exatos das views e das colunas. Alterações podem interromper a integração.

Não se deve:

 
<pre class="cm-content q9tKkq_readonly m-0">Renomear as views Excluir colunas Alterar nomes das colunas Modificar tipos dos campos Excluir as viewspre>
 

Qualquer ajuste deve ser analisado pelo desenvolvimento e validado com a StarTwo.

12. A StarTwo acessará as tabelas internas do ERP?

O recomendado é que a StarTwo consulte apenas as views disponibilizadas para integração.

As views funcionam como uma camada de segurança e padronização, evitando acesso direto às tabelas internas do sistema.

13. Qual permissão o usuário da integração precisa ter?

Normalmente, apenas permissão de leitura:

 
<pre class="cm-content q9tKkq_readonly m-0">GRANT SELECT ON public.vw_c_dados_associado TO usuario_startwo; GRANT SELECT ON public.vw_c_lista_barras TO usuario_startwo; GRANT SELECT ON public.vw_c_lista_estoque TO usuario_startwo; GRANT SELECT ON public.vw_c_mercadorias_compradas TO usuario_startwo; GRANT SELECT ON public.vw_c_mercadorias_vendidas TO usuario_startwo;pre>
 

Não é recomendado fornecer permissões de:

 
<pre class="cm-content q9tKkq_readonly m-0">INSERT UPDATE DELETE DROP ALTER CREATEpre>
 

14. Qual é o checklist para liberação?

Antes de informar que o ambiente está pronto, confirme:

 
<pre class="cm-content q9tKkq_readonly m-0">[ ] As cinco views existem [ ] Todas executam sem erro [ ] A view de associado retorna o CNPJ correto [ ] A view de compras retorna registros [ ] A view de vendas retorna registros [ ] A view de barras retorna códigos válidos [ ] A view de estoque retorna saldo [ ] O usuário da integração possui somente leitura [ ] O acesso foi testado [ ] A StarTwo recebeu as informações necessáriaspre>
 

15. Orientação final para técnicos e revendas

Sempre verifique primeiro se o banco já possui as cinco views da integração StarTwo.

Quando elas já existirem, o atendimento deve se concentrar em:

 
<pre class="cm-content q9tKkq_readonly m-0">Testar os dados Validar permissões Confirmar o CNPJ Liberar o acesso de leitura Orientar a StarTwopre>

Avalie este conteúdo:

∅ 0 (0 Voto)

Registros relacionados