Bling

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

Credenciais necessárias

Disponibilizar os acessos ao banco de dados para a Dito:
- Login
- Senha
- Client_id
- Client_secret

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

IDs das lojas na Bling que serão integradas junto ao nome da loja que a marca gostariam de visualizar no dashboard, dessa forma:

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.

Extração dos dados

Para extração dos dados, a Dito dito aos endpoints:

Endpoint Transações: "https://www.bling.com.br/Api/v3/pedidos/vendas"
- Transação específica: "https://www.bling.com.br/Api/v3/pedidos/vendas/"
Endpoint Vendedores: "https://www.bling.com.br/Api/v3/vendedores"
Endpoint Formas de pagamentos: "https://www.bling.com.br/Api/v3/formas-pagamentos"
Endpoint Produtos: "https://www.bling.com.br/Api/v3/categorias/produtos"
- Produto específico: "https://www.bling.com.br/Api/v3/produtos/"
Endpoint Dados Pessoais: "https://www.bling.com.br/Api/v3/contatos/"

Plano de tracking

Dados dos Usuários

Dados do Usuário	Cadastro do Usuário	Glossário Dito
ID Nome E-mail Cidade Data de nascimento Gênero cpf cnpj Telefone Endereço Bairro UF tipo pessoa Cep	dito.identify( { id: dito.generateID('99999999999'), name: 'Nome Usuário', email: '[email protected] ', location: 'Cidade', birthday: '22/12/1997' gender: 'female' data: { cpf_cnpj: '999.999.999-99', telefone: '31988887777', endereco: 'Nome Rua, 33', bairro: 'Bairro', uf: 'SP', tipo_pessoa: 'F' cep: '30775220' } } );	Tipo pessoa: Esta propriedade é utilizada para identificação do tipo, seja pessoa física ou jurídica. 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.

Dados dos Eventos

Página/ação - Evento	Propriedades (exemplo)	Glossário Dito
Comprou - comprou	- numero_pedido: - id_loja: - id_transacao: - codigo_cliente: - operacao: - codigo_vendedor: - desconto: - metodo_pagamento: - total: - quantidade_produtos:Revenue (695.55) - vendedor:	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	- categoria: - codigo_produto: - desconto_produto: - id_produto: - id_transacao: - nome_produto: - preco_produto: - quantidade:	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".