{"section":"tutorials","requestedLocale":"pt","requestedSlug":"catalogo-data-pipeline","locale":"pt","slug":"catalogo-data-pipeline","path":"docs/pt/tutorials/beta/vtex-data-pipeline-beta/catalogo-data-pipeline.md","branch":"main","content":"O conjunto de dados é composto por cinco tabelas que fornecem as informações mais recentes do catálogo de uma conta VTEX. Neste conjunto de dados são disponibilizadas informações de **produtos, SKUs, marcas, categorias** e **especificações.**  \n\n> ⚠️ No modelo de dados de Catálogo, somente **Marcas** e **Categorias** com pelo menos um produto ou SKU vinculado no catálogo são elegíveis para envio, mesmo que estejam inativas.\n\nNesta seção você encontrará as seguintes informações:  \n\n- [Características dos dados](#características-dos-dados)\n- [Tabela produtos](#tabela-produtos)\n- [Tabela SKUs](#tabela-skus)\n- [Tabela marcas](#tabela-marcas)\n- [Tabela categorias](#tabela-categorias)\n- [Tabela especificações](#tabela-especificacoes)\n- [Tabela cluster](#tabela-cluster)\n- [Análise com dados de catálogo](#analise-com-dados-de-catalogo)\n- [Correlações com outros dados](#correlacao-com-outros-dados)\n\n## Características dos dados\n\n| **Caracterítica** | **Descrição** |\n|:---:|:---:|\n| **Origem dos dados** | Os dados são obtidos a partir do [módulo de catálogo](/pt/docs/tutorials/catalogo-visao-geral). |\n| **Disponibilidade** | Os dados podem ser acessados no Admin VTEX. |\n| **Histórico** | Os dados disponibilizado são a partir de fevereiro de 2025. |\n| **Menor intervalo de atualização possível** | Uma hora. |\n\n## Tabela product\n\nA tabela `product` contém informações sobre os produtos cadastrados no catálogo VTEX, incluindo identificadores, categorias, marcas e visibilidade na loja. Também armazena informações sobre imagens, SKUs relacionados e canais de venda nos quais o produto está disponível. Também registra datas importantes, como criação, atualização e lançamentos.\n\n| __Nome da Coluna__  | __Tipo da coluna__  | __Descrição__ |\n|-----------------|---------------|-----------|\n| account  | character varying(255) | Conta proprietária do produto. |\n| product_id | integer | Identificador único do produto, gerado pela VTEX. |\n| product_ref_id  | character varying(255) | Código de referência interno configurado pelo comerciante. |\n| brand_id | super | Identificador da marca do produto. |\n| category_id | super  | Código de referência interna da categoria do produto. |\n| skus| super  | Coleção de SKUs associados ao produto. |\n| clusters_id  | super  | Identificador dos clusters aos quais o produto pertence. |\n| product_name | character varying(255) | Nome do produto. |\n| product_image  | character varying(65535) | Imagem principal utilizada para representar o produto. |\n| is_active  | boolean | Indica se o produto está ativo no catálogo. Outros fatores, como estoque e preço, também podem afetar sua disponibilidade na loja. |\n| is_visible | boolean | Indica se o produto está visível na loja. |\n| tax_code | character varying(255)  | Código fiscal do produto, utilizado para cálculo de impostos. |\n| product_path  | character varying(255) | Parte da URL da página do produto. |\n| related_categories  | super  | Lista de categorias relacionadas ao produto. |\n| similar_categories  | super  | Lista de categorias similares, usada para agrupar produtos relacionados. |\n| sales_channels  | super | Canais de venda nos quais o produto está disponível. |\n| dt_first_release    | timestamp with time zone | Data planejada de lançamento do produto. |\n| dt_last_release | timestamp with time zone| Data do último lançamento do produto. |\n| dt_created | timestamp with time zone | Data de criação do registro nos sistemas internos. |\n| dt_updated | timestamp with time zone| Data da última atualização do registro nos sistemas internos. |\n| batch_id  | character varying(13) | Identificador do lote para rastreamento de atualizações. |\n| sk_product | character varying(32) | Chave sintética do produto, usada como chave primária. |\n| sk_brand| character varying(32)| Chave estrangeira para associação com a tabela de marcas. |\n| sk_category| character varying(32) | Chave estrangeira para associação com a tabela de categorias. |\n| sk_skus| super | Informações sobre os SKUs do produto. |\n| sk_cluster  | super| Informações sobre clusters associados ao produto. |\n| sk_related_categories | super| Lista de categorias relacionadas ao produto, seguindo uma configuração hierárquica. |\n\n## Tabela sku\n\nEsta tabela detalha os SKUs associados a produtos. Inclui identificadores exclusivos, dimensões físicas, códigos de fabricante e EANs. Também armazena informações sobre imagens, serviços adicionais, kits e atributos específicos de cada SKU. Datas de criação e atualização são registradas para controle. \n\n| __Nome da Coluna__ | __Tipo da coluna__ | __Descrição__ |\n|----------------|--------------|-----------|\n| account | character varying(255) | Conta proprietária do SKU. |\n| product_id  | bigint | Identificador único do produto associado ao SKU. |\n| sku_id| bigint | Identificador único do SKU. |\n| is_active| boolean  | Indica se o SKU está ativo no catálogo. Outros fatores, como estoque e preço, também podem afetar sua disponibilidade. |\n| is_kit  | boolean  | Indica se o SKU é um kit composto por múltiplos produtos. |\n| sku_ref_id| character varying(65535) | Código de referência interna do SKU. |\n| sku_dimensions | super | Dimensões do SKU, utilizadas para cálculos de frete. |\n| sku_real_dimensions | super | Dimensões reais do produto sem embalagem, usadas na página de detalhes do produto. |\n| sku_manufacturer_code | character varying(65535) | Código de referência do fabricante. |\n| sku_eans | super  | Códigos EAN associados ao SKU. |\n| sku_kit_items | super  | Itens incluídos no kit do SKU. |\n| sku_image_url | character varying(65535)     | URL da imagem principal do SKU. |\n| sku_image_gallery  | super  | Galeria de imagens do SKU. |\n| sku_services | super| Serviços adicionais associados ao SKU (ex.: embalagem para presente). |\n| sku_attachments  | super | Anexos relacionados ao SKU, como personalizações. |\n| sku_attributes| super| Atributos específicos do SKU. |\n| sku_videos  | super  | Vídeos relacionados ao SKU. |\n| sku_files| super | Arquivos associados ao SKU. |\n| dt_created  | timestamp with time zone | Data de criação do registro nos sistemas internos. |\n| dt_updated| timestamp with time zone| Data da última atualização do registro nos sistemas internos. |\n| batch_id  | character varying(13)| Identificador do lote para rastreamento de atualizações. |\n| sk_sku | character varying(32)| Identificador único do SKU, usado para integração com a tabela de produtos. |\n| sk_product  | character varying(32)  | Identificador único do produto associado ao SKU. |\n\n## Tabela brand\n\nA tabela `brand` contém informações sobre as marcas registradas no catálogo VTEX, incluindo identificadores, nomes e status de ativação. Também mantém registros de criação e atualização, além de um identificador único para integração com outras tabelas.\n\n| __Nome da Coluna__  | __Tipo da coluna__  | __Descrição__ |\n|-----------------|---------------|-----------|\n| account | character varying(255)   | Conta proprietária da marca. |\n| brand_id | bigint  | Identificador único da marca. |\n| brand_name| character varying(65535) | Nome da marca. |\n| is_active | boolean | Indica se a marca está ativa. |\n| dt_created| timestamp with time zone | Data de criação do registro. |\n| dt_updated | timestamp with time zone | Data da última atualização do registro. |\n| batch_id | character varying(13)  | Identificador do lote de processamento. |\n| sk_brand | character varying(32) | Identificador único da marca no catálogo. |\n\n## Tabela category\n\nA tabela `category` apresenta os produtos em categorias hierárquicas. Armazena identificadores, nomes, caminhos completos de categoria e status de ativação. Permite a organização dos produtos dentro da estrutura do catálogo.\n\n| __Nome da Coluna__  | __Tipo da coluna__  | __Descrição__ |\n|-----------------|---------------|-----------|\n| sk_category | character varying(32) | Identificador único da categoria (chave primária). |\n| account | character varying(255)  | Conta proprietária da categoria. |\n| category_id | bigint | Identificador único da categoria. |\n| category_name  | character varying(65535) | Nome da categoria. |\n| category_full_path_uri_name | character varying(65535) | Caminho hierárquico da categoria por nome. |\n| category_full_path | character varying(65535) | Caminho hierárquico da categoria por ID. |\n| is_active  | boolean | Indica se a categoria está ativa. |\n| dt_created | timestamp with time zone | Data de criação do registro. |\n| dt_updated | timestamp with time zone | Data da última atualização do registro. |\n| batch_id | character varying(13) | Identificador do lote de processamento. |\n\n## Tabela specification\n\nA tabela `specification` armazena especificações técnicas dos produtos e SKUs, como grupos de especificação, valores atribuídos e se uma especificação é obrigatória. Também contém identificadores para facilitar a integração com produtos, SKUs e grupos de especificação, garantindo um detalhamento mais preciso dos itens cadastrados.\n\n| __Nome da Coluna__   | __Tipo da coluna__ | __Descrição__ |\n|------------------|--------------|-----------|\n| sk_specification  | character varying(32)   | Identificador único da especificação. |\n| sk_product  | character varying(32)   | Identificador único do produto. |\n| sk_specification_group  | character varying(32)   | Identificador único do grupo de especificação. |\n| sk_sku  | character varying(32)   | Identificador único do SKU. |\n| specification_name  | character varying(65535) | Nome da especificação. |\n| specification_value  | character varying(65535) | Valor da especificação. |\n| dt_created| timestamp with time zone | Data de criação do registro. |\n| dt_updated | timestamp with time zone | Data da última atualização do registro. |\n| batch_id | character varying(13)   | Identificador do lote de processamento. |\n\n## Tabela cluster\n\nA tabela cluster armazena informações sobre agrupamentos de contas, representando conjuntos de lojas ou sellers.\n\n| __Nome da Coluna__       | __Tipo da coluna __ | __Descrição__ |\n|:----------:|:-------------:|:-----------:|\n| sk_category         | character varying(32)      | Chave sintética criada por hash da conta e do category_id, usada como chave primária. |\n| account            | character varying(255)     | Conta associada ao cluster, representando o comerciante ou loja. |\n| cluster_id         | bigint                      | Identificador único do cluster dentro da conta. |\n| cluster_name       | character varying(65535)   | Nome do cluster, usado para exibição e identificação. |\n| is_active          | boolean                     | Indica se o cluster está ativo e deve ser considerado nas operações. |\n| is_searchable      | boolean                     | Indica se o cluster é pesquisável e pode ser encontrado em funcionalidades de busca. |\n| cluster_date_from  | timestamp with time zone   | Data de início do cluster, indicando quando ele se torna ativo. |\n| cluster_date_to    | timestamp with time zone   | Data de término do cluster, indicando quando ele se torna inativo. |\n| dt_created        | timestamp with time zone   | Data e hora em que o registro foi criado no datalake, no fuso UTC. |\n| dt_updated        | timestamp with time zone   | Data e hora em que o registro foi atualizado no datalake, no fuso UTC. |\n| batch_id          | character varying(13)      | Identificador do lote, usado para processamento e rastreamento de atualizações. |\n\n## Análise com dados de catálogo\n\nAlgumas opções de análise com os dados de catálogo são:\n\n**- Verificar o status de um produto:** use o campo `isActive` para verificar se o módulo de catálogo considera um produto ativo.  \n**- Identificar SKUs relacionados:** obtenha uma lista de todos os SKUs vinculados a um produto principal.  \n**- Detalhar especificações do produto:** recupere todas as especificações de um produto, incluindo sua marca, categoria e outros detalhes relevantes.  \n\n## Correlação com outros dados\n\nOs dados do catálogo estão conectados a vários outros modelos de dados. Aqui estão algumas correlações importantes:\n\n**- Relação com estoque:** ao integrar os dados do catálogo com as informações de estoque, é possível determinar com precisão a quantidade disponível de cada produto.  \n**- Relação com pedidos:** a combinação dos dados do catálogo com os detalhes dos pedidos permite analisar com exatidão o número de pedidos associados a cada produto no catálogo.  \n**- Impacto na taxa de conversão:** a avaliação dos dados de navegação para determinar a taxa de conversão do funil da loja ajuda a entender o papel de cada produto no comportamento de navegação dos usuários.  \n\n### Conheça outros Conjuntos de dados\n\n- [Inventário](/pt/docs/tutorials/inventario-data-pipeline-beta)  \n- [Pagamentos](/pt/docs/tutorials/pagamentos-data-pipeline-beta)  \n- [Pedidos](/pt/docs/tutorials/pedidos-data-pipeline-beta)  \n- [Preços](/pt/docs/tutorials/precos-data-pipeline-beta)  \n- [Promoção](/pt/docs/tutorials/promocoes-data-pipeline-beta)  \n- [Vale-presente](/pt/docs/tutorials/vale-presente-data-pipeline)  \n- [Logs do Bridge](/pt/docs/tutorials/logs-do-bridge-data-pipeline)"}