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:

vw_c_dados_associado
vw_c_lista_barras
vw_c_lista_estoque
vw_c_mercadorias_compradas
vw_c_mercadorias_vendidas

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:

CNPJ
Razão social

vw_c_lista_barras

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

Principais informações:

Código de barras
CNPJ do associado
Código da mercadoria
Data da movimentação

vw_c_lista_estoque

Disponibiliza o estoque dos produtos movimentados.

Principais informações:

CNPJ do associado
Código do produto
Descrição da mercadoria
Unidade
Data
Quantidade em estoque

vw_c_mercadorias_compradas

Disponibiliza as mercadorias compradas pelo associado.

Principais informações:

CNPJ do associado
Produto
Unidade
Código da mercadoria
Quantidade
CNPJ do fornecedor
Razão social do fornecedor
Valor total
Data da compra

vw_c_mercadorias_vendidas

Disponibiliza as mercadorias vendidas pelo associado.

Principais informações:

CNPJ do associado
Produto
Unidade
Código da mercadoria
Quantidade vendida
Valor total vendido
Data da venda

4. Como verificar se as views já existem?

No PostgreSQL, execute:

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;

O resultado deve apresentar as cinco views.

5. Como verificar pelo pgAdmin?

No pgAdmin, siga este caminho:

Banco de dados
  > Schemas
    > public
      > Views

Confirme se aparecem:

vw_c_dados_associado
vw_c_lista_barras
vw_c_lista_estoque
vw_c_mercadorias_compradas
vw_c_mercadorias_vendidas

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:

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;

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:

SELECT *
FROM public.vw_c_mercadorias_vendidas
WHERE data >= CURRENT_DATE - INTERVAL '30 days'
ORDER BY data DESC;

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:

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_vendidas

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:

Renomear as views
Excluir colunas
Alterar nomes das colunas
Modificar tipos dos campos
Excluir as views

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:

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;

Não é recomendado fornecer permissões de:

INSERT
UPDATE
DELETE
DROP
ALTER
CREATE

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

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

[ ] 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árias

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:

Testar os dados
Validar permissões
Confirmar o CNPJ
Liberar o acesso de leitura
Orientar a StarTwo