Skip to main content

Microvix → Linx POS

Atenção

Sugerimos que faça uma carga local em sua base para então efetuar as queries localmente. Queries com joins remotos ficarão extremamente lentas por conta da natureza das views.

Período de validação

No início do projeto deixamos um período menor travado na view para propósitos de validação. Após validado, ajustamos a view removendo o filtro.

Objetivo​

Este documento apresenta as instruções para integração direta via banco de dados, utilizando views padronizadas para expor os dados armazenados no Microvix no formato das tabelas Linx POS.

Este conjunto de views foi desenvolvido para facilitar a integração com o Linx POS, eliminando rotinas customizadas e garantindo aderência ao modelo ERP Linx.

Pré-requisitos​

  • O cliente precisa ter um IP fixo para realizar a carga dos dados, ou adicionar o IP dinamicamente através do aplicativo.
  • A equipe técnica do cliente deverá informar os seus IPs fixos para que possam ser liberados no firewall.
  • A equipe WeRetail irá disponibilizar os endpoints de integração e o usuário de leitura para acesso às views.

Views para Integração​

Para cada view, detalhamos sua finalidade, origem dos dados e principais colunas, conforme os comentários nos scripts originais.

1. LX_ERP_LOJA_VENDA​

  • Descrição: Cabeçalho de vendas traduzido de Microvix para o modelo Linx ERP (tabela LOJA_VENDA). Uma linha por venda.
  • Origem: LinxMovimento_trusted e LinxLojas_trusted.
  • Principais colunas: CODIGO_FILIAL, TICKET, DATA_VENDA, CODIGO_CLIENTE, VENDEDOR, OPERACAO_VENDA, DESCONTO, VALOR_TIKET, VALOR_VENDA_BRUTA, VALOR_TROCA.
  • Observações: Exclui registros logicamente deletados (excluido = 'S'). Cancelamentos são exibidos separadamente.

2. LX_ERP_LOJA_VENDA_VENDEDORES​

  • Descrição: Vendedores por venda traduzidos de Microvix para o modelo Linx ERP (tabela LOJA_VENDA_VENDEDORES). Uma linha por combinação de venda + vendedor.
  • Origem: LinxMovimento_trusted (distinct identificador + cod_vendedor) e LinxLojas_trusted.
  • Principais colunas: CODIGO_FILIAL, TICKET, DATA_VENDA, ID_VENDEDOR, VENDEDOR, CODIGO_CLIENTE.

3. LX_ERP_LOJA_VENDA_TROCA​

  • Descrição: Itens de devolução/troca traduzidos de Microvix para o modelo Linx ERP (tabela LOJA_VENDA_TROCA). Uma linha por item de devolução, filtrado pelo id_cfop de devolução.
  • Origem: LinxMovimento_trusted (filtrado por CFOP de devolução), LinxLojas_trusted e LinxProdutos_trusted.
  • Principais colunas: TICKET, CODIGO_FILIAL, ITEM, DATA_VENDA, PRODUTO, COR_PRODUTO, TAMANHO, QTDE, PRECO_LIQUIDO.

4. LX_ERP_LOJA_VENDA_PRODUTO​

  • Descrição: Itens de venda traduzidos de Microvix para o modelo Linx ERP (tabela LOJA_VENDA_PRODUTO). Uma linha por item.
  • Origem: LinxMovimento_trusted, LinxLojas_trusted e LinxProdutos_trusted.
  • Principais colunas: TICKET, CODIGO_FILIAL, ITEM, PRODUTO, COR_PRODUTO, TAMANHO, QTDE, PRECO_LIQUIDO, DESCONTO_ITEM, QTDE_CANCELADA.

5. LX_ERP_LOJA_VENDA_PGTO​

  • Descrição: Sessão de pagamento por venda traduzida de Microvix para o modelo Linx ERP (tabela LOJA_VENDA_PGTO). Uma linha por venda.
  • Origem: LinxMovimento_trusted agregado, LinxLojas_trusted e LinxMovimentoPlanos_trusted.
  • Principais colunas: CODIGO_FILIAL, TERMINAL, LANCAMENTO_CAIXA, COD_FORMA_PGTO, CAIXA_VENDEDOR, DIGITACAO, DATA, TOTAL_VENDA, VALOR_CANCELADO.

💡 Para detalhamento de formas de pagamento, utilize a view LX_ERP_LOJA_VENDA_PARCELAS.

6. LX_ERP_LOJA_VENDA_PARCELAS​

  • Descrição: Parcelas/planos de pagamento por venda traduzidos de Microvix para o modelo Linx ERP (tabela LOJA_VENDA_PARCELAS). Uma linha por plano de pagamento utilizado na venda.
  • Origem: LinxMovimentoPlanos_trusted, LinxMovimento_trusted e LinxLojas_trusted.
  • Principais colunas: TERMINAL, LANCAMENTO_CAIXA, CODIGO_FILIAL, PARCELA, TIPO_PGTO, VALOR, VENCIMENTO, FINALIZACAO, PARCELAS_CARTAO.

7. LX_ERP_FILIAIS​

  • Descrição: Filiais/lojas traduzidas de Microvix para o modelo Linx ERP (tabela FILIAIS). Uma linha por loja ativa.
  • Origem: LinxLojas_trusted.
  • Principais colunas: FILIAL (chave de integração/cnpj_emp), COD_FILIAL, REGIAO, CGC_CPF, DATA_ABERTURA, CTRL_ESTOQUE_PRODUTO, TIPO_TRIBUTACAO.

8. LX_ERP_ESTOQUE_PRODUTOS​

  • Descrição: Estoque de produtos traduzido de Microvix para o modelo Linx ERP (tabela ESTOQUE_PRODUTOS). Uma linha por combinação de produto, cor e filial.
  • Origem: LinxProdutosDetalhes_trusted, LinxProdutos_trusted e LinxLojas_trusted.
  • Principais colunas: PRODUTO, COR_PRODUTO, FILIAL, CUSTO_MEDIO1, ULTIMO_CUSTO1, ESTOQUE, DATA_CUSTO_MEDIO.

9. LX_ERP_CLIENTES_VAREJO​

  • Descrição: Clientes de varejo traduzidos de Microvix para o modelo Linx ERP (tabela CLIENTES_VAREJO). Uma linha por cliente.
  • Origem: LinxClientesFornec_trusted e LinxLojas_trusted (mapeamento de filial de cadastro).
  • Principais colunas: CODIGO_CLIENTE, CLIENTE_VAREJO (razão/nome), FILIAL, CPF_CGC, CIDADE, BAIRRO, TELEFONE, EMAIL, STATUS, INATIVO_PARA_CRM.

10. LX_ERP_ESTOQUE_DETALHES​

  • Descrição: Detalhamento de estoque traduzido de Microvix para o modelo Linx ERP. Uma linha por combinação de produto, cor, tamanho e filial, oferecendo granularidade maior do que a view LX_ERP_ESTOQUE_PRODUTOS.
  • Origem: LinxProdutosDetalhes_trusted, LinxProdutos_trusted e LinxLojas_trusted.
  • Principais colunas: PRODUTO, COR_PRODUTO, TAMANHO, FILIAL, ESTOQUE, CUSTO_MEDIO1, ULTIMO_CUSTO1.