Virtual Age V2
A Dito extrai os dados através da API disponibilizada pela Shopify.
Credenciais necessárias
- Client_id
- Username
- Client_secret
- Password
Rotas utilizadas:
- Endpoint Autorização: /api/totvsmoda/authorization/v2/token
- Endpoint lojas: /api/totvsmoda/person/v2/branchesList
- Endpoint Dados pessoais: /api/totvsmoda/person/v2/legal-entities/search
- Endpoint Dados pessoais (PF): /api/totvsmoda/person/v2/individuals/search
- Endpoint Vendedores: /api/totvsmoda/seller/v2/search
- Endpoint Transações: /api/totvsmoda/fiscal/v2/invoices/search
- Endpoint Produtos: /api/totvsmoda/product/v2/products/search
Requisitos obrigatórios
- Código das lojas
- Código de operação de vendas de cada loja
- Código de operação de devoluções de cada 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 UF tipo pessoa (F/J) cd_pessoa Status | dito.identify({ id: dito.generateID('99999999999'), name: 'Nome Usuário', email: '[email protected] ', location: 'Cidade', birthday: '22/12/1997' gender: 'female' data: { cpf: '999.999.999-99', telefone: '31988887777', endereco: 'Nome Rua, 33', uf: 'SP', tipo_pessoa: 'F', cod_pessoa: '101234' status: 'ativo', }}); | 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 ERP. |
Dados dos Eventos
| Página/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 (R$ XXXX) - id_transacao - operacao - codigo_operacao - total - desconto_percentual - cod_pessoa - codigo_vendedor - vendedor - id_loja - loja - quantidade_produtos - tipo_pagamento - valor_frete | 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_ecommerce - categoria_produto - cod_cor (XXXX - colecao - cor - campanha - descricao - flow - familia - id_produto - id_transacao - linha - marca - nome_produto - preco_produto - quantidade_produto - sku_produto - tamanho - tecido | 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 (R$ - XXXX) - id_transacao - operacao - codigo_operacao - total - desconto_percentual - cod_pessoa - codigo_vendedor - vendedor - id_loja - loja - quantidade_produtos - tipo_pagamento - valor_frete | 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 | - categoria_ecommerce - categoria_produto - cod_cor (XXXX - colecao - cor - campanha - descricao - flow - familia - id_produto - id_transacao - linha - marca - nome_produto - preco_produto - quantidade_produto - sku_produto - tamanho - tecido | 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