A Dito extrai os dados através da API disponibilizada pela Millenium.

Credenciais necessária

  • Endpoint
  • Login
  • Senha

Informações obrigatórias antes das extrações de dados

  • Número dos eventos de venda e devolução da Millenium que devem ser considerados para cálculo do faturamento da loja e dados que vamos trazer para a Dito.

🚧

É muito importante que o número dos eventos de venda e devolução seja validada pela marca antes do início das extrações dos dados, para que não haja divergências no momento de validar a receita da marca na Dito.


Horário da extração

Todos os acessos ocorrem de madrugada entre 0h e 3h, exceto o primeiro acesso onde iremos pegar a carga retroativa completa do cliente e o tempo de processamento vai depender da quantidade de dados que o cliente possui.

Plano de tracking:

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

Dados dos Usuários


Dados do UsuárioCadastro do UsuárioGlossário Dito
ID
Nome
E-mail
Cidade
Data de nascimento
Gênero

Código pessoa
cpf
Telefone
Endereço
Bairro
Cep
UF
Tipo pessoa
dito.identify({
id: dito.generateID('99999999999'),
name: 'Nome Usuário',
email: '[email protected] ',
location: 'Cidade',
birthday: '22/12/1997'
gender: 'female'
data: {
cd_pessoa: '000003703579'
cpf: '999.999.999-99',
telefone: '31988887777',
endereco: 'Nome Rua, 33',
bairro: 'Bairro',
uf: 'SP',
cep: '30775220'
tipo_pessoa: 'PF'
}});
ID: Informação única utilizada para
identificar e registrar os usuários durante
a coleta de informações que estarão
presentes na ficha dos mesmos.
Recomendamos que ele esteja em todas
as páginas do seu ambiente. São exemplos
de IDs: CPF, e-mail e código próprio.

Cd pessoa: Esta propriedade é utilizada
para identificação do código do usuário
no banco de dados da marca.

Dados dos Eventos

Ação - Evento MilleniumPropriedades (exemplo)Glossário Dito
Cadastrou -register- browser (Firefox)
- dispositivo (Desktop)
- sistema_operacional (Windows)
- utm_source (Dito)
- utm_medium (email)
- utm_campaign (Dito-vendas-recorrentes)
Evento padrão

As propriedades listadas no 'Evento padrão'
também serão adicionadas automaticamente
em todos os eventos listados nesse plano.
Comprou - comprouRevenue (xxxx)

- id_transacao
- desconto
- total
- metodo_pagamento
- romaneio
- codigo_vendedor
- vendedor
- id_loja
- loja
- quantidade_produtos
- nome_transportadora
- tipo_operacao
- numero_nota
Comprou: Este evento representa o financeiro
de uma de compra faturada. Será registrado
uma única vez, contemplando os valores totais
da transação. Além disso, esse evento será
fundamental, pois é a partir dele que todas as
telas de resultados e relatórios financeiros,
serão nutridos.
Comprou produto - comprou-produto- id_transacao

- id_produto

- quantidade

- desconto

- nome_produto

- cod_cor

- cor

- estampa

- cod_estampa

- tamanho

- grade

- produto_pv

- preco_produto

- colecao

- marca

- cod_produto

- tipo_operacao
Comprou-produto: Este evento 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.

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".
Devolveu - devolveuRevenue (-xxx)

- id_transacao
- desconto
- total
- metodo_pagamento
- romaneio
- id_loja
- loja
- quantidade_produtos
- nome_transportadora
- tipo_operacao
Devolveu: Este evento representa o financeiro
de uma de devolução. Será registrado uma única
vez, contemplando os valores totais da transação,
a fim de subtrair na receita total do usuário.
Devolveu produto - devolveu-produto- id_transacao
- cod_produto
- quantidade
- desconto
- nome_produto
- cod_cor
- cor
- estampa
- cod_estampa
- preco_produto
- tipo_operacao
- sku
Devolveu produto: Este evento apresenta as
informações dos produtos e os dados relacionados
a transação de devolução. Será registrado um
evento devolveu-produto para cada produto
único que compõe a devolução.

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".

👍

Caso haja necessidade de alterar ou enviar outros dados que não estão no plano de tracking, é necessário que seja utilizada uma integração customizada.