❗️

IMPORTANTE: As orientações e scripts realizam a criação de views previamente validadas pela Dito, porém a responsabilidade pela manutenção e possíveis alterações não são responsabilidade da Dito, visamos compartilhar este documento com objetivo de auxiliar, mas a responsabilidade por disponibilização dos dados para integração é da própria marca.

  • Tipo de integração: Padronizada - Facilitada com ERP
  • Sistema: Linx
  • Fonte de dados/Extrator: View - Banco de dados
  • VPN: site-to-site ou liberação por IP
  • Dados integrados: Consumidores e Transações
  • Tipo de ID do consumidor: CPF
  • Frequência de atualização: D-1

Plano de tracking:

A estrutura dos dados que serão enviados é padronizada neste tipo de integração. Não é possível alterar, nem incluir novos tipos de dados.

O plano de tracking, contendo a estrutura utilizada, pode ser consultado abaixo:

Características do Consumidor

TítuloNome do campo na DitoFormato na DitoExemplo de conteúdo
NomenameTextoNome Consumidor
E-mailemailTexto[email protected]
CidadelocationTextoBelo Horizonte
Data de nascimentobirthdayData (DD/MM/YYYY)22/12/1995
Gênerogender"male" para masculino
"female" para feminino
"male" ou "female"
CPF/CNPJcpf
cnpj
Texto (11 números para CPF e 14 números para CNPJ)99999999999
99999999999999
TelefonetelefoneNúmero (DDD + Telefone)31988887777
EndereçoenderecoTextoNome Rua, 33
UFufTexto (2 caracteres)MG
Código de Endereçamento Postal (CEP)cepNúmero30775220

Comportamentos do Consumidor

Comportamento: comprou

  • Objetivo: Este comportamento representa o financeiro de uma compra faturada. Será registrado uma única vez, contemplando os valores totais da transação. Além disso, esse comportamento será fundamental, pois é a partir dele que todas as telas de resultados e relatórios financeiros serão nutridos.
  • Propriedades:
TítuloNome do campo na DitoFormato na DitoExemplo de conteúdo
Código do vendedorcodigo_vendedorO conteúdo depende se o mesmo código de vendedor se repete por loja ou não. Ex: vendedor ID 50 na loja ID 1 e vendedor ID 50 na loja ID 2.

NÃO SE REPETE: apenas o código.
SE REPETE: “código”+”:”+”código da loja”
"50" ou "50:1"
Código da lojaid_lojaNúmero123
Código da transaçãoid_transacaoNúmero46650
Nome da lojanome_lojaTextoBH SHOPPING
Nome do vendedornome_vendedorTextoNOME VENDEDOR
Tipo da lojatipo_lojaTextoLOJA
Rede de lojasrede_lojasTexto03
Descrição da rede de lojasdesc_rede_lojasTextoOUTLET
Quantidade de produtosquantidade_produtosNúmero2
Método de pagamentoforma_pagamentoTextoCARTÃO
Valor de descontototal_descontoNúmero17.45
Valor total da compratotalNúmero695.55
Valor de fretevalor_freteNúmero43.61

Comportamento: comprou-produto

  • Objetivo: Este comportamento apresenta as informações dos produtos e os dados relacionados. Será registrado um evento comprou-produto para cada produto único que compõe a transação (evento comprou). Obs: caso o usuário compre o mesmo produto em uma quantidade maior que 1, será registrado apenas um deste evento, sendo a quantidade sinalizada na propriedade "quantidade".
  • Propriedades:
TítuloNome do campo na DitoFormato na DitoExemplo de conteúdo
Código da transaçãoid_transacaoNúmero

Mesmo conteúdo do campo id_transacao do comportamento comprou.
46650
Código do produtoid_produtoNúmero12787
Categoria do produtocategoriaTextoKIT
Subcategoria do produtosubcategoriaTextoALGUMA SUBCATEGORIA
Coleção do produtocolecaoTextoINVERNO
Cor do produtocorTextoPRETA
Grupo do produtogrupoTextoMOLETOM
Subgrupo do produtosubgrupoTextoALGUM SUBGRUPO
Linha do produtolinhaTextoLINHA
Marca do produtomarcaTextoALGUMA MARCA
Modelo do produtomodeloTextoALGUM MODELO
Nome do produtonome_produtoTextoCAMISETA X
Tamanho do produtotamanhoTextoM
Preço do produtopreco_produtoNúmero349
Desconto para o produtodescontoNúmero0
Quantidadequantidade_produtoNúmero1

Comportamento: devolveu

  • Objetivo: Este comportamento representa o financeiro de uma devolução de compra. Será registrado uma única vez, contemplando os valores totais da transação. Além disso, esse comportamento será fundamental, pois é a partir dele que todas as telas de resultados e relatórios financeiros serão nutridos.
  • Propriedades:
TítuloNome do campo na DitoFormato na DitoExemplo de conteúdo
Código do vendedorcodigo_vendedorO conteúdo depende se o mesmo código de vendedor se repete por loja ou não. Ex: vendedor ID 50 na loja ID 1 e vendedor ID 50 na loja ID 2.

NÃO SE REPETE: apenas o código.
SE REPETE: “código”+”:”+”código da loja”
"50" ou "50:1"
Código da lojaid_lojaNúmero123
Código da transaçãoid_transacaoNúmero46650
Nome da lojanome_lojaTextoBH SHOPPING
Nome do vendedornome_vendedorTextoNOME VENDEDOR
Tipo da lojatipo_lojaTextoLOJA
Rede de lojasrede_lojasTexto03
Descrição da rede de lojasdesc_rede_lojasTextoOUTLET
Quantidade de produtosquantidade_produtosNúmero2
Método de pagamentoforma_pagamentoTextoCARTÃO
Valor de descontototal_descontoNúmero17.45
Valor total da compratotalNúmero695.55
Valor de fretevalor_freteNúmero43.61

Comportamento: devolveu-produto

  • Objetivo: Este comportamento apresenta as informações dos produtos devolvidos e os dados relacionados. Será registrado um evento devolveu-produto para cada produto único que compõe a transação (evento devolveu). Obs: caso o usuário devolva o mesmo produto em uma quantidade maior que 1, será registrado apenas um deste evento, sendo a quantidade sinalizada na propriedade "quantidade".
  • Propriedades:
TítuloNome do campo na DitoFormato na DitoExemplo de conteúdo
Código da transaçãoid_transacaoNúmero

Mesmo conteúdo do campo id_transacao do comportamento devolveu.
46650
Código do produtoid_produtoNúmero12787
Categoria do produtocategoriaTextoKIT
Subcategoria do produtosubcategoriaTextoALGUMA SUBCATEGORIA
Coleção do produtocolecaoTextoINVERNO
Cor do produtocorTextoPRETA
Grupo do produtogrupoTextoMOLETOM
Subgrupo do produtosubgrupoTextoALGUM SUBGRUPO
Linha do produtolinhaTextoLINHA
Marca do produtomarcaTextoALGUMA MARCA
Modelo do produtomodeloTextoALGUM MODELO
Nome do produtonome_produtoTextoCAMISETA X
Tamanho do produtotamanhoTextoM
Preço do produtopreco_produtoNúmero349
Desconto para o produtodescontoNúmero0
Quantidadequantidade_produtoNúmero1

Atividades técnicas:

  1. Criar as Views através dos scripts abaixo com acesso as tabelas da Linx;
  2. Criar um usuário no banco de dados com acesso de consulta às Views;
  3. Definir se vai utilizar VPN (site-to-site) ou liberação por IP para acesso ao banco de dados;
    1. Caso for utilizar VPN, disponibilizar as informações que serão solicitadas pelo
      time de segurança da Dito para configuração.
  4. Disponibilizar os acessos ao banco de dados para a Dito:
    1. Nome do banco
    2. Host
    3. Porta
    4. Usuário
    5. Senha
    6. Driver (SGBD)
    7. Driver SSL Mode (se utilizar)
    8. Driver options (se utilizar)

Scripts para criar views na Linx para acesso da Dito:

  • Os scipts para criação das views devem ser solicitados para o time Dito. Deverão ser criadas 3 views disponibilizadas pela Dito:
    • dito_crm_vendedores.sql
    • dito_crm_tamanhos.sql
    • dito_crm_compras.sql