Tiny
A Dito extrai os dados através da API disponibilizada pela Tiny.
Credenciais necessárias
As credenciais abaixo devem ser encaminhadas para cada loja:
- Token API: código usado para autenticar as chamadas de API que a Dito irá realizar para o ERP. Fica na conta de cada loja. Para coletar, seguir o tutorial: https://tiny.com.br/api-docs/api2-gerar-token-api
- Nome: nome da loja
- Id da Loja: loja_id é um parâmetro numérico que a estrutura de dados da Dito usa para identificar de que loja vieram os eventos de compra e devolução. Caso não tenha nenhum número de identificação para as lojas, pode-se usar o padrão: 0001, 0002. Lembrete: guardar a informação de qual id representa qual loja.
- As credenciais abaixo são utilizadas par acesso ao relatório, que ajudará na validação dos dados após a integração:
- Login
- Senha
Importante!
As credenciai necessárias acima deverão ser fornecidas por loja!
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ário | Cadastro do Usuário | Glossário Dito |
|---|---|---|
| ID Nome Cidade Data de nascimento Gênero cpf cnpj Telefone Endereço Bairro UF tipo pessoa Cep Complemento | 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' complemento: 'CASA' }}); | 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. Tipo pessoa: Esta propriedade é utilizada para identificação do tipo, seja pessoa física ou jurídica. 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 | Propriedades (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 - comprou | Revenue - id_transacao - operacao - total - desconto - cd_pessoa - codigo_vendedor - vendedor - loja_fantasia - id_loja - loja - quantidade_produtos | 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 - cd_produto - quantidade - desconto - nome_produto - especie - peso - cor - tamanho - preco_produto - tipoclas - classificacao - id_produto | 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 - devolveu | Revenue - id_transacao - operacao - tp_situacao - total - desconto - cd_pessoa - codigo_vendedor - vendedor - loja_fantasia - id_loja - loja - quantidade_produtos | 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 - cd_produto - quantidade - desconto - nome_produto - especie - peso - cor - tamanho - preco_produto - tipoclas - classificacao - id_produto | 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.
Updated 8 days ago