VNDA

Adicionando a fonte de dados

Adicionando o conector

1) Faça login na sua conta da VNDA como Administrador

Atenção: é importante que o usuário que está fazendo login tenha o perfil de Administrador

2) Após o login, vá em Admin>Configurações>Integrações>API> símbolo de + (Gerar token). Isso irá gerar um pop-up conforme abaixo:

3) No pop-up, em Nome preencha "Kondado" e em E-mail coloque um email seu que irá receber o token

Forneça um email válido e ao qual você tenha acesso, pois o token será enviado para lá

3.1) Recomendamos que marque todos os escopos e deixe o campo "Hosts" em branco

4) De imediato irá ser enviado o token para o respectivo e-mail com as instruções de como usar o token. O assunto do e-mail sempre será Token de acesso para API da Vnda. Copie o token recebido

5) Faça login na Kondado, vá para a seção de adicionar conectores e selecione o conector da VNDA

6) No conector, em "Nome" dê um nome para o seu conector e, em Site da loja preencha a URL que você utiliza para acessar a área administrativa do seu site e em Token cole o valor obtido no passo (4)

Agora basta clicar em SALVAR e para começar a receber dados da VNDA no Data Warehouse ou Data Lake

Pipelines

Diagrama de relacionamento

Clique para expandir

Estoque

Tipo de replicacao: Integral

Relacionamentos:

variant_id → Variantes > id

Registros de estoque consolidados por variante.

Campo	Tipo
id	float	[pt] Identificador do registro de estoque.
created_at	timestamp	[pt] Data em que o registro de estoque foi criado.
name	text	[pt] Nome da localização ou bucket de estoque.
place_id	float	[pt] Identificador da localização utilizada para o estoque.
price	float	[pt] Preço associado ao item em estoque.
product_id	float	[pt] Produto ao qual o estoque pertence.
quantity	float	[pt] Quantidade atual registrada no estoque.
quantity_sold	float	[pt] Quantidade vendida a partir deste estoque.
sale_price	float	[pt] Preço de venda aplicado ao estoque.
slug	text	[pt] Slug associado ao item do estoque.
updated_at	timestamp	[pt] Data da última atualização do estoque.
variant_id	float	[pt] Identificador da variante a que o estoque pertence. Variantes > > id

Pedidos

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data iniciaremos a leitura

Relacionamentos:

items__variant_id > items → Variantes > id

Objeto principal

Pedidos VNDA com dados comerciais, de pagamento e de entrega.

Campo	Tipo
id	float	[pt] Identificador numérico do pedido.
affiliate_tag	text	[pt] Tag ou parceiro de afiliados associado ao pedido.
agent	text	[pt] Identificação do agente ou canal que originou o pedido.
ame	boolean	[pt] Indica se o pedido teve pagamento via carteira Ame.
ame_qr_code	text	[pt] Código QR fornecido pela Ame para este pedido.
antifraud_assurance	text	[pt] Resultado ou mensagem do processo antifraude.
browser_ip	text	[pt] Endereço IP informado pelo navegador do comprador.
canceled_at	timestamp	[pt] Data e hora em que o pedido foi cancelado.
card	boolean	[pt] Indica se o pagamento foi feito com cartão.
card_number	text	[pt] Número ou final do cartão informado para pagamento.
card_validity	text	[pt] Validade do cartão utilizado no pedido.
cart_id	float	[pt] Identificador do carrinho associado ao pedido.
channel	text	[pt] Canal de origem do pedido (loja, app ou marketplace).
client_id	float	[pt] Identificador do cliente na plataforma VNDA.
code	text	[pt] Código público do pedido exibido ao cliente.
confirmed_at	timestamp	[pt] Data e hora em que o pedido foi confirmado.
coupon_code	text	[pt] Cupom promocional aplicado ao pedido.
delivered_at	timestamp	[pt] Data e hora em que a entrega foi concluída.
delivery_days	float	[pt] Quantidade de dias estimada para entrega.
delivery_message	text	[pt] Mensagem ou instrução de entrega fornecida.
delivery_type	text	[pt] Modalidade logística escolhida para envio.
deposit	boolean	[pt] Indica se o pagamento foi realizado por depósito.
discount_price	float	[pt] Valor total de descontos aplicados ao pedido.
email	text	[pt] E mail de contato informado no pedido.
expected_delivery_date	date	[pt] Data prevista de entrega comunicada ao cliente.
has_split	boolean	[pt] Indica se o pagamento foi dividido em mais de um meio.
installments	float	[pt] Quantidade de parcelas acordadas para o pagamento.
paid_at	timestamp	[pt] Data e hora em que o pedido foi pago.
payment_authorization	text	[pt] Código de autorização fornecido pelo adquirente.
payment_due_date	timestamp	[pt] Data de vencimento do pagamento.
payment_gateway	text	[pt] Gateway ou provedor responsável pelo processamento.
payment_method	text	[pt] Forma de pagamento selecionada.
payment_tid	text	[pt] Identificador da transação retornado pelo processador.
pix	boolean	[pt] Indica se o pedido foi pago via Pix.
pix_qr_code	text	[pt] Código QR do Pix disponibilizado ao cliente.
rebate_discount	float	[pt] Valor de cashback ou abatimento aplicado.
rebate_token	text	[pt] Token de controle do programa de rebate.
received_at	timestamp	[pt] Data e hora em que o cliente confirmou o recebimento.
shipped_at	timestamp	[pt] Data e hora em que o pedido foi despachado.
shipping_label	text	[pt] Identificador ou etiqueta usada no frete.
shipping_price	float	[pt] Valor cobrado de frete.
shipping_tracked_at	timestamp	[pt] Momento em que o rastreio ficou disponível.
slip	boolean	[pt] Indica se foi emitido boleto bancário.
slip_due_date	timestamp	[pt] Data de vencimento do boleto.
slip_token	text	[pt] Token de referência do boleto.
slip_url	text	[pt] URL para visualização do boleto.
status	text	[pt] Status atual do pedido no fluxo VNDA.
subtotal	float	[pt] Subtotal dos itens antes de frete e impostos.
taxes	float	[pt] Valor total de impostos do pedido.
token	text	[pt] Token interno exclusivo do pedido.
total	float	[pt] Valor total após descontos e acréscimos.
tracking_code	text	[pt] Código principal de rastreamento informado.
tracking_code_list	text	[pt] Lista com todos os códigos de rastreamento.
updated_at	timestamp	[pt] Data e hora da última atualização do pedido.
user_code	text	[pt] Código interno do usuário relacionado ao pedido.
user_id	text	[pt] Identificador do usuário responsável pelo pedido.

vnda_orders_extra_fields

Campos extras configurados em cada pedido.

Campo	Tipo
order_id	float	[pt] Identificador do pedido ao qual o campo extra pertence.
extra_fields_key	text	[pt] Nome do campo extra armazenado.
extra_fields_value	text	[pt] Valor texto atribuído ao campo extra.

vnda_orders__items

Itens de pedido com informações de produto e medidas.

Campo	Tipo
order_id	float	[pt] Identificador do pedido ao qual o item pertence.
items__has_customizations	boolean	[pt] Indica se o item possui personalizações.
items__height	float	[pt] Altura do item em unidades cadastradas.
items__id	float	[pt] Identificador único do item dentro do pedido.
items__length	float	[pt] Comprimento do item.
items__original_price	float	[pt] Preço original do item antes de descontos.
items__package	text	[pt] Tipo de embalagem associado ao item.
items__picture_url	text	[pt] URL da imagem do item.
items__place_city	text	[pt] Cidade associada ao local do item.
items__place_id	text	[pt] Identificador do local vinculado ao item.
items__place_name	text	[pt] Nome do local vinculado ao item.
items__price	float	[pt] Preço vigente cobrado pelo item.
items__product_id	float	[pt] Identificador do produto relacionado ao item.
items__product_name	text	[pt] Nome do produto exibido no item.
items__quantity	float	[pt] Quantidade solicitada do item.
items__reference	text	[pt] Referência interna do item.
items__sku	text	[pt] SKU do item conforme catálogo.
items__total	float	[pt] Valor total do item considerando a quantidade.
items__variant_id	float	[pt] Identificador da variante do item. Variantes > > id
items__variant_name	text	[pt] Nome da variante selecionada.
items__weight	float	[pt] Peso do item.
items__width	float	[pt] Largura do item.

Produtos

Tipo de replicacao: Integral

Objeto principal

Produtos do catálogo VNDA com atributos de venda.

Campo	Tipo
id	float	[pt] Identificador do produto no catálogo VNDA.
active	boolean	[pt] Indica se o produto está ativo para venda.
available	boolean	[pt] Indica se o produto possui disponibilidade.
description	text	[pt] Descrição em texto do produto.
discount_id	float	[pt] Identificador da regra de desconto aplicada.
discount_rule	text	[pt] Regra de desconto vinculada ao produto.
html_description	text	[pt] Descrição do produto em HTML.
image_url	text	[pt] URL principal da imagem do produto.
installments	text	[pt] Informações de parcelamento sugeridas.
min_quantity	float	[pt] Quantidade mínima permitida para compra.
name	text	[pt] Nome comercial do produto.
on_sale	boolean	[pt] Indica se o produto está em promoção.
plain_description	text	[pt] Descrição sem formatação.
price	float	[pt] Preço base do produto.
product_type	text	[pt] Categoria ou tipo configurado.
rating_rating	float	[pt] Média de avaliação atribuída ao produto.
rating_votes	float	[pt] Quantidade de votos registrados na avaliação.
reference	float	[pt] Código de referência do produto.
sale_price	float	[pt] Preço promocional vigente.
slug	text	[pt] Slug usado na URL do produto.
updated_at	timestamp	[pt] Data da última atualização do produto.
url	text	[pt] URL pública do produto.

vnda_products___tags

Tags livres associadas aos produtos.

Campo	Tipo
product_id	float	[pt] Identificador do produto relacionado.
tag_name	text	[pt] Nome da tag associada ao produto.

vnda_products__category_tags

Categorias e tags hierárquicas atribuídas aos produtos.

Campo	Tipo
product_id	float	[pt] Identificador do produto associado à tag.
category_tags_name	text	[pt] Nome da categoria ou tag.
category_tags_tag_type	text	[pt] Tipo da tag de categoria.
category_tags_title	text	[pt] Título exibido da tag de categoria.

Variantes

Tipo de replicacao: Integral

Relacionamentos:

product_id → Produtos > id

Objeto principal

Variantes de produtos com disponibilidade e preços.

Campo	Tipo
id	float	[pt] Identificador da variante de produto.
available	boolean	[pt] Indica se a variante está disponível.
available_quantity	float	[pt] Quantidade disponível para a variante.
handling_days	float	[pt] Dias necessários para preparar o envio.
height	float	[pt] Altura da variante.
image_url	text	[pt] URL da imagem específica da variante.
installments	text	[pt] Condições de parcelamento da variante.
length	float	[pt] Comprimento da variante.
main	boolean	[pt] Indica se esta é a variante principal.
min_quantity	float	[pt] Quantidade mínima para comprar a variante.
name	text	[pt] Nome ou rótulo da variante.
norder	float	[pt] Posição da variante na ordenação.
price	float	[pt] Preço base da variante.
product_id	float	[pt] Identificador do produto pai. Produtos > > id
quantity	float	[pt] Quantidade total registrada da variante.
quantity_sold	float	[pt] Quantidade vendida da variante.
sale_price	float	[pt] Preço promocional da variante.
sku	float	[pt] SKU específico da variante.
slug	text	[pt] Slug usado para a variante.
stock	float	[pt] Quantidade disponível em estoque.
updated_at	timestamp	[pt] Data da última atualização da variante.
weight	float	[pt] Peso da variante.
width	float	[pt] Largura da variante.

vnda_variants___custom_attributes

Atributos personalizados das variantes.

Campo	Tipo
variant_id	float	[pt] Identificador da variante proprietária do atributo.
custom_attributes_key	text	[pt] Nome do atributo personalizado.
custom_attributes_val	text	[pt] Valor armazenado para o atributo personalizado.

vnda_variants___properties

Propriedades estruturadas das variantes.

Campo	Tipo
variant_id	float	[pt] Identificador da variante proprietária da propriedade.
properties_defining	boolean	[pt] Indica se a propriedade define a variante.
properties_name	text	[pt] Nome da propriedade.
properties_property	text	[pt] Código interno da propriedade.
properties_value	text	[pt] Valor atribuído à propriedade.

Notas

Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Conectar a VNDA à Kondado

Siga estes passos para gerar um token de API na VNDA e configurar o conector na Kondado, enviando seus dados de e-commerce para um Data Warehouse ou Data Lake.

Acesse a VNDA como Administrador

Faça login na sua conta da VNDA com um usuário que tenha perfil de Administrador. Sem essa permissão, você não conseguirá acessar as configurações de API necessárias para a integração.

Gere um token de API para a Kondado

No painel da VNDA, navegue até Admin > Configurações > Integrações > API e clique no símbolo de + (Gerar token). No pop-up, preencha o Nome com "Kondado" e informe um e-mail válido seu para receber o token. Recomendamos marcar todos os escopos e deixar o campo "Hosts" em branco.

Copie o token recebido por e-mail

O token será enviado imediatamente para o e-mail informado, com o assunto Token de acesso para API da Vnda. Acesse sua caixa de entrada, abra o e-mail e copie o token gerado, pois você precisará dele no próximo passo.

Configure o conector VNDA na Kondado

Faça login na Kondado, acesse a página de conectores e selecione o conector da VNDA. Dê um nome ao conector, preencha o campo Site da loja com a URL da sua área administrativa e cole o Token copiado no passo anterior.

Salve e comece a receber dados

Clique em SALVAR para finalizar. A partir de agora, seus dados da VNDA — como pedidos, produtos, variantes e estoque — começarão a fluir automaticamente para o seu destino configurado, seja um Data Warehouse ou Data Lake.

Perguntas frequentes

Quais permissões são necessárias para gerar o token da VNDA?▼

O usuário que realizar o login na VNDA precisa ter o perfil de Administrador. Sem essa permissão, as opções de API não estarão disponíveis no menu Admin > Configurações > Integrações.

O que devo fazer se o token da VNDA não chegar ao meu e-mail?▼

Verifique se o e-mail informado está correto e se você tem acesso à caixa de entrada. O e-mail tem o assunto Token de acesso para API da Vnda e é enviado de imediato após a geração. Caso não encontre, verifique também a pasta de spam ou lixo eletrônico.

Quais dados da VNDA posso integrar à Kondado?▼

O conector permite extrair dados de Pedidos (com itens e campos extras), Produtos (com tags e categorias), Variantes (com atributos customizados e propriedades) e Estoque. Esses dados podem ser enviados para diferentes destinos como Data Warehouses e Data Lakes.

É obrigatório marcar todos os escopos ao gerar o token?▼

Não é obrigatório, mas é recomendado marcar todos os escopos para garantir que a Kondado tenha acesso completo aos dados da sua loja. Deixar o campo "Hosts" em branco também é recomendado para evitar restrições de acesso.

Posso usar os dados da VNDA para criar dashboards?▼

Sim. Após integrar seus dados da VNDA à Kondado, você pode enviá-los para ferramentas de BI e criar dashboards para acompanhar métricas de vendas, estoque e performance da sua loja.

Escrito por

Thassyo Pereira·Publicado em 2021-06-15·Atualizado em 2026-06-01