Adicionando o conector
- Acesse o painel administrativo da VTEX com a conta de usuário master
- Na barra lateral, acesse Configurações da Conta, depois Gerenciamento da Conta e então clique em Chaves de aplicação
- Clique no botão Gerenciar minhas chaves, você será direcionado(a) para a página Minhas chaves:
- Clique no botão Gerar Chave
- Insira um nome para a chave de aplicação que está sendo criada
- PASSO IMPORTANTE PARA O FUNCIONAMENTO DO CONECTOR:
Clique em +Adicionar Perfis para associar a chave aos perfis de acesso desejados -> a chave de aplicação será capaz de autenticar integrações com os módulos e funcionalidades aos quais os perfis escolhidos dão acesso - Clique no botão Gerar
- No campo que é exibido em seguida, fica o token. Por uma questão de segurança, ele é exibido apenas uma vez. Copie esse token e guarde-o em local seguro.
- Faça login na plataforma da Kondado e vá para a página de adicionar conectores
- Selecione o conector da VTEX e preencha as informações conforme imagem abaixo

- Nome da conta: é a primeira parte da sua URL administrativa da VTEX. Por exemplo, se a sua URL é kondado.myvtex.com, o valor a ser preenchido é kondado
- Access Key: corresponde a Chave de aplicação gerada no passo (7)
- Access Secret: corresponde ao Token de aplicação gerado no passo (7) e copiado no passo (8)
- Dê um nome ao seu conector e clique em SALVAR
Integrações
Índice
Gráfico de relacionamento
Clique para ampliar
Coupons
Tipo de replicacao: Integral
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do cupom. |
|
|
text |
[pt] Intervalo para reutilização do cupom. |
|
|
boolean |
[pt] Indica se a promoção está arquivada. |
|
|
timestamp |
[pt] Data/hora UTC da última modificação. |
|
|
float |
[pt] Quantidade máxima de itens por cliente. |
|
|
text |
[pt] Filtro de campanha UTM. |
|
|
text |
[pt] Filtro de origem UTM. |
Estoque
Posição de estoque dos SKUs por armazém.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do SKU associado ao registro de estoque. |
|
|
text |
[pt] Identificador do centro de distribuição. |
|
|
text |
[pt] Nome do armazém ou loja responsável pelo estoque. |
|
|
float |
[pt] Quantidade total disponÃvel no estoque. |
|
|
float |
[pt] Quantidade reservada para pedidos em andamento. |
|
|
boolean |
[pt] Indica se o SKU é tratado como estoque ilimitado. |
Master data
- Para usar esta integração você precisará da permissão ADMIN_DS
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos
- Entidade: Selecione a entidade
Estrutura padrão de tabela Master Data usada quando nenhuma entidade personalizada está configurada.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da entidade no master data. |
|
|
timestamp |
[pt] Momento em que o registro foi atualizado pela última vez |
|
|
timestamp |
[pt] Momento em que o registro foi criado |
|
|
text |
[pt] Exemplo de propriedade dinâmica |
|
|
float |
[pt] Exemplo numérico de propriedade dinâmica |
|
|
date |
[pt] Exemplo de propriedade dinâmica em formato de data |
Pedidos
- Pedidos com o status de incompleto não serão retornados
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido no OMS VTEX. |
|
|
text |
[pt] Origem do pedido, como Marketplace ou Fulfillment. |
|
|
text |
[pt] Status do pedido. |
|
|
boolean |
[pt] Indica se o workflow deste pedido está em retentativa. |
|
|
text |
[pt] Última mensagem transacional ainda não lida. |
|
|
float |
[pt] Identificador sequencial interno do pedido. |
|
|
text |
[pt] Nome do operador de call center associado ao pedido. |
|
|
text |
[pt] Nomes amigáveis dos meios de pagamento usados. |
|
|
text |
[pt] Nome do estabelecimento responsável pelo pedido. |
|
|
timestamp |
[pt] Data máxima estimada para entrega do pedido. |
|
|
text |
[pt] Dados enviados para a emissão da nota fiscal. |
|
|
boolean |
[pt] Indica se o workflow está em retentativa. |
|
|
timestamp |
[pt] Data prevista de envio ou entrega do pedido. |
|
|
text |
[pt] Resposta retornada após a emissão da nota fiscal. |
|
|
text |
[pt] Identificador do pedido no marketplace parceiro. |
|
|
text |
[pt] Hostname VTEX que processou o pedido. |
|
|
boolean |
[pt] Indica se o pedido foi concluído. |
|
|
text |
[pt] Tipo da lista de presentes ligada ao pedido (quando houver). |
|
|
float |
[pt] Valor total do pedido em centavos. |
|
|
text |
[pt] Canal de vendas utilizado pelo pedido. |
|
|
float |
[pt] Quantidade total de itens no pedido. |
|
|
timestamp |
[pt] Data em que o pedido foi autorizado. |
|
|
timestamp |
[pt] Data de criação do pedido. |
|
|
text |
[pt] Descrição textual do status do pedido. |
|
|
text |
[pt] Identificador da lista de presentes relacionada, quando existir. |
|
|
timestamp |
[pt] Data mínima estimada para entrega do pedido. |
|
|
text |
[pt] Código da moeda conforme a norma ISO 4217. |
|
|
text |
[pt] Nome do cliente exibido no pedido. |
Pedidos: informações logísticas
- Pedidos com o status de incompleto não serão retornados
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
Relacionamentos:
Objeto principal
Detalhes logísticos por item do pedido (canal, prazos e pickup).
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido ligado a estas informações logísticas. |
|
|
float |
[pt] Posição do item na lista de logística. |
|
|
text |
[pt] Identificador do endereço usado para entrega. |
|
|
text |
[pt] Canal logístico (entrega, retirada, pickup). |
|
|
text |
[pt] Nome da transportadora ou parceiro responsável pela entrega. |
|
|
text |
[pt] Janela de entrega planejada (quando informada). |
|
|
float |
[pt] Preço de tabela do item nesta opção logística (centavos). |
|
|
text |
[pt] Prazo de bloqueio utilizado para reservar a janela de entrega. |
|
|
text |
[pt] Identificador do ponto de retirada associado. |
|
|
text |
[pt] Informações adicionais exibidas sobre o ponto de retirada. |
|
|
text |
[pt] Tipo do endereço do ponto de retirada. |
|
|
text |
[pt] Nome do responsável pelo ponto de retirada. |
|
|
text |
[pt] Identificador do endereço do ponto de retirada. |
|
|
text |
[pt] CEP do ponto de retirada. |
|
|
text |
[pt] Cidade do ponto de retirada. |
|
|
text |
[pt] UF/estado do ponto de retirada. |
|
|
text |
[pt] País do ponto de retirada. |
|
|
text |
[pt] Logradouro do ponto de retirada. |
|
|
text |
[pt] Número do endereço do ponto de retirada. |
|
|
text |
[pt] Bairro do ponto de retirada. |
|
|
text |
[pt] Complemento do endereço do ponto de retirada. |
|
|
text |
[pt] Referência/landmark para localizar o ponto de retirada. |
|
|
text |
[pt] Coordenadas geográficas do ponto de retirada. |
|
|
text |
[pt] Identificador do dock/porta usado para retirada. |
|
|
text |
[pt] Nome amigável exibido para o ponto de retirada. |
|
|
boolean |
[pt] Indica se o local é habilitado para retirada. |
|
|
text |
[pt] Nome do polígono logístico aplicado. |
|
|
float |
[pt] Preço do frete para este trecho (centavos). |
|
|
text |
[pt] Nome da SLA logística selecionada para o item. |
|
|
float |
[pt] Preço de venda efetivo da entrega (centavos). |
|
|
text |
[pt] Estimativa textual do prazo de entrega. |
|
|
timestamp |
[pt] Data estimada de entrega para esta opção. |
|
|
text |
[pt] País de destino no padrão ISO 3166 alfa-3. |
|
|
text |
[pt] Tempo de trânsito informado para a rota. |
vtex_logisticsinfo__slas
SLAs disponíveis por item, incluindo fretes e pontos de retirada.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido vinculado à SLA. |
|
|
float |
[pt] Posição do item nesta lista de SLAs. |
|
|
text |
[pt] Canal de entrega oferecido na SLA. |
|
|
text |
[pt] Janela de entrega prevista na SLA. |
|
|
text |
[pt] Identificador da SLA. |
|
|
text |
[pt] Prazo de bloqueio usado pela SLA. |
|
|
text |
[pt] Nome amigável da SLA. |
|
|
text |
[pt] Identificador do ponto de retirada da SLA. |
|
|
text |
[pt] Informações adicionais exibidas sobre o ponto de retirada. |
|
|
text |
[pt] Tipo de endereço do ponto de retirada. |
|
|
text |
[pt] Nome do responsável no ponto de retirada. |
|
|
text |
[pt] Identificador do endereço do ponto de retirada. |
|
|
text |
[pt] CEP do ponto de retirada. |
|
|
text |
[pt] Cidade do ponto de retirada. |
|
|
text |
[pt] UF/estado do ponto de retirada. |
|
|
text |
[pt] País do ponto de retirada. |
|
|
text |
[pt] Logradouro do ponto de retirada. |
|
|
text |
[pt] Número do ponto de retirada. |
|
|
text |
[pt] Bairro do ponto de retirada. |
|
|
text |
[pt] Complemento do endereço de retirada. |
|
|
text |
[pt] Referência ou ponto de apoio do local de retirada. |
|
|
text |
[pt] Coordenadas do ponto de retirada. |
|
|
text |
[pt] Identificador do dock utilizado para retirada. |
|
|
text |
[pt] Nome amigável exibido para o ponto de retirada. |
|
|
boolean |
[pt] Informa se o local está habilitado como loja de retirada. |
|
|
text |
[pt] Polígono aplicado à rota da SLA. |
|
|
float |
[pt] Preço do frete cobrado pela SLA (centavos). |
|
|
text |
[pt] Estimativa de envio para esta SLA. |
|
|
text |
[pt] Tempo de trânsito informado pela SLA. |
vtex_logisticsinfo__deliveryIds
Identificadores de entrega detalhando transportadoras e quantidades.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido vinculado ao deliveryId. |
|
|
float |
[pt] Posição do item dentro da lista de deliveryIds. |
|
|
text |
[pt] Nome da transportadora configurada na conta. |
|
|
text |
[pt] Identificador do courier neste deliveryId. |
|
|
text |
[pt] Nome exibido do courier. |
|
|
text |
[pt] Dock utilizado para despachar este deliveryId. |
|
|
float |
[pt] Quantidade de itens neste deliveryId. |
|
|
text |
[pt] Depósito responsável por este deliveryId. |
Pedidos: dados de marketing
- Pedidos com o status de incompleto não serão retornados
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
Relacionamentos:
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido relacionado aos dados de marketing. |
|
|
text |
[pt] Parâmetro UTM Source associado ao pedido. |
|
|
text |
[pt] Parâmetro de parceiro (utmPartner) informado pelo lojista. |
|
|
text |
[pt] Parâmetro UTM Medium utilizado na campanha. |
|
|
text |
[pt] Parâmetro UTM Campaign associado ao pedido. |
|
|
text |
[pt] Cupom de desconto do pedido (normalizado para maiúsculas). |
|
|
text |
[pt] Parâmetro interno de campanha (utmiCampaign). |
|
|
text |
[pt] Parâmetro interno de página (utmiPage). |
|
|
text |
[pt] Parâmetro interno de parte (utmiPart). |
|
|
text |
[pt] Lista de tags/identificadores de marketing enviados pelo pedido. |
Pedidos: dados de envio
- Pedidos com o status de incompleto não serão retornados
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
Relacionamentos:
Objeto principal
Dados principais de entrega por pedido.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido ao qual os dados de entrega pertencem. |
|
|
text |
[pt] Tipo do endereço de entrega. |
|
|
text |
[pt] Bairro do endereço de entrega. |
|
|
text |
[pt] Identificador do endereço de entrega. |
|
|
text |
[pt] Complemento do endereço de entrega. |
|
|
text |
[pt] Número do endereço de entrega. |
|
|
text |
[pt] Logradouro do endereço de entrega. |
|
|
text |
[pt] Coordenadas geográficas do endereço de entrega. |
|
|
text |
[pt] Cidade do endereço de entrega. |
|
|
text |
[pt] Referência do endereço de entrega. |
|
|
text |
[pt] Nome do destinatário da entrega. |
|
|
text |
[pt] País de entrega no formato ISO 3166 ALPHA-3. |
|
|
text |
[pt] Estado/UF do endereço de entrega. |
|
|
text |
[pt] CEP ou código postal do endereço de entrega. |
vtex_orders_shipping_data__selectedAddresses
Endereços selecionados em cada pedido, incluindo pontos de retirada.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Pedido ao qual o endereço selecionado pertence. |
|
|
text |
[pt] Tipo de endereço selecionado (entrega, cobrança, retirada). |
|
|
text |
[pt] Bairro registrado para o endereço escolhido. |
|
|
text |
[pt] Identificador interno do endereço selecionado. |
|
|
text |
[pt] Complemento do endereço escolhido. |
|
|
text |
[pt] Número do endereço selecionado. |
|
|
text |
[pt] Logradouro do endereço selecionado. |
|
|
text |
[pt] Coordenadas geográficas associadas ao endereço. |
|
|
text |
[pt] Cidade do endereço selecionado. |
|
|
text |
[pt] Ponto de referência informado para facilitar a entrega. |
|
|
text |
[pt] Nome da pessoa que receberá a entrega. |
|
|
text |
[pt] País do endereço selecionado. |
|
|
text |
[pt] Estado/UF do endereço selecionado. |
|
|
text |
[pt] CEP/código postal do endereço selecionado. |
Pedidos: detalhes
- Pedidos com o status de incompleto não serão retornados
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
Relacionamentos:
Detalhes completos de cada pedido, abrangendo cliente, marketplace e status.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido no OMS VTEX. |
|
|
text |
[pt] Identificador aproximado do cliente gerado pela Kondado (experimental). |
|
|
text |
[pt] Origem do pedido, como Marketplace ou Fulfillment. |
|
|
float |
[pt] Quantidade total de itens no pedido. |
|
|
text |
[pt] Nome do cliente exibido no pedido. |
|
|
text |
[pt] Endpoint configurado para integrações com o marketplace. |
|
|
text |
[pt] Campo livre para observações adicionais do pedido. |
|
|
text |
[pt] Identificador sequencial interno do pedido. |
|
|
text |
[pt] Dados fiscais agregados retornados no pedido. |
|
|
text |
[pt] Código do pedido no marketplace parceiro. |
|
|
text |
[pt] Estrutura personalizada com dados enviados pelo cliente. |
|
|
text |
[pt] E-mail do responsável pela loja/atendimento. |
|
|
boolean |
[pt] Informa se o pedido foi retirado no ponto físico. |
|
|
timestamp |
[pt] Data da última alteração registrada no pedido. |
|
|
text |
[pt] Informações de assinatura ou recorrência vinculadas ao pedido. |
|
|
boolean |
[pt] Indica se o pedido foi concluído. |
|
|
text |
[pt] Nome do estabelecimento responsável pela venda. |
|
|
text |
[pt] Última mensagem transacional registrada para o pedido. |
|
|
text |
[pt] Detalhes sobre cancelamentos solicitados ou concluídos. |
|
|
text |
[pt] Telefone corporativo informado pelo cliente. |
|
|
boolean |
[pt] Indica se o cliente é corporativo. |
|
|
text |
[pt] Classificação comercial atribuída ao cliente. |
|
|
text |
[pt] Documento corporativo (CNPJ ou similar) do cliente. |
|
|
text |
[pt] Telefone principal informado no pedido. |
|
|
text |
[pt] Identificador do perfil de usuário no ambiente VTEX. |
|
|
text |
[pt] Tipo de documento informado pelo cliente (CPF, passaporte etc.). |
|
|
text |
[pt] Identificador do registro de perfil do cliente. |
|
|
text |
[pt] Primeiro nome do cliente. |
|
|
text |
[pt] Sobrenome do cliente. |
|
|
text |
[pt] Nome fantasia informado para o cliente. |
|
|
text |
[pt] Inscrição estadual ou registro fiscal complementar do cliente. |
|
|
text |
[pt] Razão social do cliente corporativo. |
|
|
text |
[pt] Documento principal do cliente (CPF, CNPJ etc.). |
|
|
text |
[pt] E-mail de contato informado pelo cliente. |
|
|
text |
[pt] Identificador do formulário de pedido no VTEX. |
|
|
timestamp |
[pt] Data de criação do pedido. |
|
|
boolean |
[pt] Indica se o pedido aceita cancelamento. |
|
|
text |
[pt] Registros de anexos relacionados a alterações do pedido. |
|
|
timestamp |
[pt] Data em que a nota fiscal foi emitida. |
|
|
boolean |
[pt] Indica se o pedido aceita edição após criado. |
|
|
text |
[pt] Nome do seller/loja responsável pelo pedido. |
|
|
timestamp |
[pt] Data em que o pedido foi autorizado. |
|
|
text |
[pt] Motivo informado para cancelamento do pedido. |
|
|
text |
[pt] Hostname da conta registrado no License Manager. |
|
|
text |
[pt] Dados do operador de call center responsável pelo pedido. |
|
|
float |
[pt] Valor associado ao price tag aplicado ao pedido. |
|
|
text |
[pt] Descrição textual do status atual do pedido. |
|
|
text |
[pt] Detalhes da condição comercial aplicada ao pedido. |
|
|
text |
[pt] Identificador do grupo de pedidos relacionado. |
|
|
text |
[pt] Status atual do pedido. |
|
|
text |
[pt] Identificador do pedido no seller/marketplace. |
|
|
text |
[pt] Informações da lista de presentes vinculada ao pedido. |
|
|
text |
[pt] Ponto de retirada onde o pedido foi conferido. |
|
|
float |
[pt] Total de diferenças originadas por arredondamento. |
|
|
text |
[pt] Identificador do canal de vendas do pedido. |
|
|
text |
[pt] Indica se o marketplace informado é certificado. |
|
|
text |
[pt] URL base do marketplace responsável pelo pedido. |
|
|
text |
[pt] Nome do marketplace que originou o pedido. |
Pedidos: itens
- Pedidos com o status de incompleto não serão retornados
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
Relacionamentos:
Objeto principal
Itens de cada pedido com preços, quantidades e metadados adicionais.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido ao qual o item pertence. |
|
|
timestamp |
[pt] Data de criação do pedido referente ao item. |
|
|
int |
[pt] Índice calculado que indica a posição do item no array de resposta do pedido (usado para referenciar outros pipelines com `itemindex`). |
|
|
text |
[pt] Séries associadas ao item, quando aplicável. |
|
|
text |
[pt] Ofertas adicionais vinculadas ao item. |
|
|
text |
[pt] Lista de etiquetas de preço e promoções aplicadas. |
|
|
boolean |
[pt] Indica se o item foi marcado como presente no pedido. |
|
|
float |
[pt] Valor de comissão de frete registrado para o seller. |
|
|
float |
[pt] Comissão registrada para o seller. |
|
|
text |
[pt] Parâmetros adicionais aplicados ao item. |
|
|
float |
[pt] Valor de frete atribuído ao item. |
|
|
text |
[pt] Código EAN do SKU. |
|
|
text |
[pt] Referência ao conjunto pai do qual este item faz parte. |
|
|
text |
[pt] Nome exibido do item no pedido. |
|
|
text |
[pt] Lista de componentes ou acessórios associados ao item. |
|
|
text |
[pt] Definições detalhadas de preços e descontos aplicados ao item. |
|
|
text |
[pt] Unidade de medida utilizada para o item. |
|
|
float |
[pt] Multiplicador aplicado à unidade de medida do item. |
|
|
text |
[pt] Identificador do produto ao qual o item pertence. |
|
|
text |
[pt] Código de referência configurado para o item. |
|
|
text |
[pt] Código fiscal associado ao item. |
|
|
text |
[pt] Data limite para manter o preço informado. |
|
|
float |
[pt] Valor de impostos calculados para o item. |
|
|
text |
[pt] URL pública (slug) para os detalhes do produto. |
|
|
text |
[pt] Índice do item pai quando existe agrupamento ou kit. |
|
|
text |
[pt] Operador de call center responsável pelo item/pedido. |
|
|
text |
[pt] Identificador único retornado para o item. |
|
|
text |
[pt] Seller (loja) responsável por este item. |
|
|
text |
[pt] Identificador único do item dentro do pedido. |
|
|
float |
[pt] Custo do item registrado no pedido (centavos). |
|
|
text |
[pt] Data de pré-venda cadastrada para o item. |
|
|
float |
[pt] Preço de venda aplicado ao item (centavos). |
|
|
text |
[pt] Identificador do SKU no seller. |
|
|
float |
[pt] Preço base do item (centavos). |
|
|
text |
[pt] Preço informado manualmente para o item. |
|
|
float |
[pt] Valor de recompensa associado ao item. |
|
|
text |
[pt] Identificador da reserva (lock) do item. |
|
|
text |
[pt] URL da imagem do SKU. |
|
|
float |
[pt] Preço de lista do item (centavos). |
|
|
float |
[pt] Quantidade do item no pedido. |
|
|
text |
[pt] Nome da marca do item. |
|
|
text |
[pt] Identificador numérico da marca do item. |
|
|
text |
[pt] IDs das categorias vinculadas ao item. |
|
|
text |
[pt] Sequência de categorias do item separadas por > (calculado pela Kondado). |
|
|
text |
[pt] Clusters de produtos associados ao item. |
|
|
text |
[pt] Identificador da condição comercial aplicada ao item. |
|
|
text |
[pt] Descrição textual da oferta associada ao item. |
|
|
text |
[pt] Tipo de oferta (por exemplo, desconto, brinde, serviço). |
|
|
text |
[pt] Identificador do tipo de oferta aplicada. |
|
|
float |
[pt] Peso cúbico do item. |
|
|
float |
[pt] Altura do item. |
|
|
float |
[pt] Comprimento do item. |
|
|
float |
[pt] Peso do item. |
|
|
float |
[pt] Largura do item. |
vtex_orders_items__additionalinfo__categories
Tabela auxiliar com cada categoria atribuída aos itens.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Pedido relacionado à categoria registrada. |
|
|
text |
[pt] Identificador único do item usado para ligação com a categoria. |
|
|
text |
[pt] Identificador da categoria listada para o item. |
|
|
text |
[pt] Nome da categoria registrada para o item. |
Pedidos: pagamentos: transações
- Pedidos com o status de incompleto não serão retornados
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
Relacionamentos:
Objeto principal
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido. |
|
|
boolean |
[pt] Indica se a promoção está ativa. |
|
|
text |
[pt] Nome do lojista. |
|
|
text |
[pt] Status atual da promoção. |
|
|
text |
[pt] Identificador da transação. |
vtex_payment_transactions__payments
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido. |
|
|
text |
[pt] Identificador da transação. |
|
|
text |
[pt] CEP do endereço de pagamento. |
|
|
text |
[pt] Cidade do endereço de pagamento. |
|
|
text |
[pt] Complemento do endereço de pagamento. |
|
|
text |
[pt] País do endereço de pagamento. |
|
|
text |
[pt] Coordenadas do endereço de pagamento. |
|
|
text |
[pt] Bairro do endereço de pagamento. |
|
|
text |
[pt] Número do endereço de pagamento. |
|
|
text |
[pt] Referência para o endereço de pagamento. |
|
|
text |
[pt] Estado/UF do endereço de pagamento. |
|
|
text |
[pt] Logradouro do endereço de pagamento. |
|
|
text |
[pt] Mensagem retornada pelo processador. |
|
|
text |
[pt] Código de retorno do processador. |
|
|
text |
[pt] Identificador da conta de pagamento. |
|
|
text |
[pt] Identificador de autorização retornado. |
|
|
text |
[pt] Código de barras do boleto emitido. |
|
|
text |
[pt] Tipo de código de barras do boleto. |
|
|
text |
[pt] Número identificador do boleto bancário. |
|
|
text |
[pt] Identificador formatado do boleto. |
|
|
text |
[pt] Nome do portador do cartão. |
|
|
date |
[pt] Data de vencimento do pagamento. |
|
|
text |
[pt] Mês de vencimento do cartão. |
|
|
text |
[pt] Ano de vencimento do cartão. |
|
|
text |
[pt] Primeiros dígitos do cartão (BIN). |
|
|
text |
[pt] Valor aplicado de gift card como desconto. |
|
|
text |
[pt] Rótulo do gift card informado. |
|
|
text |
[pt] Identificador do gift card utilizado no pagamento. |
|
|
text |
[pt] Nome do gift card utilizado. |
|
|
text |
[pt] Fornecedor do gift card. |
|
|
text |
[pt] Grupo do pagamento (ex.: creditCard, bankInvoice). |
|
|
text |
[pt] Identificador do pagamento dentro da transação. |
|
|
float |
[pt] Número de parcelas aplicadas. |
|
|
text |
[pt] URL retornada pela Koin quando aplicável. |
|
|
text |
[pt] Últimos dígitos do cartão. |
|
|
text |
[pt] Número sequencial (NSU) retornado. |
|
|
text |
[pt] Identificador de conta pai do pagamento. |
|
|
text |
[pt] Identificador do meio de pagamento. |
|
|
text |
[pt] Nome do meio de pagamento. |
|
|
text |
[pt] Código de resgate retornado. |
|
|
float |
[pt] Valor de referência enviado ao meio de pagamento. |
|
|
text |
[pt] Identificador TID da transação. |
|
|
text |
[pt] URL fornecida para o pagamento (redirect, boleto etc.). |
|
|
float |
[pt] Valor do pagamento em centavos. |
Pedidos: taxas e benefícios
- Orders com o status de incompleto não serão retornadas
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
Relacionamentos:
Objeto principal
Promoções aplicadas por pedido, incluindo parâmetros casados.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido que recebeu a promoção. |
|
|
text |
[pt] Descrição da promoção aplicada. |
|
|
boolean |
[pt] Indica se a promoção pode ser acumulada com outras. |
|
|
text |
[pt] Identificador único da promoção. |
|
|
text |
[pt] Nome da promoção aplicada. |
vtex_orders_rates_and_benefits_matchedParameters
Lista de parâmetros casados utilizados para ativar a promoção neste pedido.
Pedidos: totais
- Pedidos com o status de incompleto não serão retornados
- As datas são enviadas no fuso-horário UTC
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Janela de atualização (dias): Depois de realizada, a ordem ainda pode ser alterada. Esse parâmetro indica quantos dias depois da data de criação devemos atualizar a mesma ordem
- Data inicial de leitura (Savepoint): A partir de qual data de criação as ordens serão lidas
Relacionamentos:
Tabela com os totais financeiros consolidados por pedido.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido no OMS VTEX. |
|
|
float |
[pt] Valor total do pedido (centavos). |
|
|
float |
[pt] Total de descontos aplicados em centavos. |
|
|
float |
[pt] Total de frete cobrado em centavos. |
|
|
float |
[pt] Total de impostos do pedido em centavos. |
Promotions
Tipo de replicacao: Integral
Objeto principal
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da promoção. |
|
|
boolean |
[pt] Quando verdadeiro, ativa o multiplicador de brindes. |
|
|
boolean |
[pt] Define se os canais listados deixam a promoção exclusiva. |
|
|
timestamp |
[pt] Data inicial da promoção (UTC). |
|
|
text |
[pt] Descrição textual da promoção. |
|
|
timestamp |
[pt] Data final da promoção (UTC). |
|
|
boolean |
[pt] Informa se existe preço máximo por item para aplicar o benefício. |
|
|
boolean |
[pt] Indica se a promoção está ativa. |
|
|
boolean |
[pt] Indica se a promoção está arquivada. |
|
|
boolean |
[pt] Informa se a promoção atua como um imposto. |
|
|
timestamp |
[pt] Data/hora UTC da última modificação. |
|
|
float |
[pt] Quantidade máxima de usos permitida. |
|
|
text |
[pt] Nome da promoção. |
|
|
float |
[pt] Percentual de imposto aplicado sobre o pedido. |
|
|
boolean |
[pt] Define se a promoção atinge todo o catálogo. |
|
|
float |
[pt] Lista de marcas que acionam a promoção. |
|
|
boolean |
[pt] Quando verdadeiro, somente as marcas listadas se qualificam; caso contrário, são excluídas. |
|
|
float |
[pt] Categorias consideradas pela promoção. |
|
|
boolean |
[pt] Define se as categorias listadas incluem ou excluem produtos. |
|
|
float |
[pt] Coleções às quais a promoção se aplica. |
|
|
boolean |
[pt] Define se as coleções listadas incluem ou excluem produtos. |
|
|
float |
[pt] Lista de produtos considerados no escopo. |
|
|
boolean |
[pt] Define se os produtos listados incluem ou excluem a promoção. |
|
|
float |
[pt] IDs de vendedores considerados no escopo. |
|
|
boolean |
[pt] Define se os vendedores listados incluem ou excluem o benefício. |
|
|
float |
[pt] SKUs cobertos pelo escopo. |
|
|
boolean |
[pt] Define se os SKUs listados incluem ou excluem a promoção. |
|
|
text |
[pt] Status atual da promoção. |
|
|
text |
[pt] Tipo de promoção. |
|
|
text |
[pt] Filtro de campanha UTM. |
|
|
text |
[pt] Filtro de origem UTM. |
|
|
text |
[pt] Filtro interno de campanha UTM. |
promotions__Campaigns
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da promoção. |
|
|
text |
[pt] Valor listado em campanhas. |
promotions_idsSalesChannel
SKUs
Tipo de replicacao: Integral
Objeto principal
Metadados completos do catálogo de SKUs VTEX.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do SKU. |
|
|
float |
[pt] Largura do SKU (cm). |
|
|
float |
[pt] Peso da embalagem em quilogramas. |
|
|
float |
[pt] Altura do SKU em centÃmetros. |
|
|
float |
[pt] Multiplicador aplicado à quantidade adicionada ao carrinho. |
|
|
float |
[pt] Identificador da condição comercial aplicada ao SKU. |
|
|
text |
[pt] Código de referência configurado para o SKU. |
|
|
boolean |
[pt] Indica se o SKU representa um kit. |
|
|
boolean |
[pt] Define se os componentes do kit podem ser vendidos separadamente. |
|
|
text |
[pt] Data estimada de chegada do SKU ao estoque. |
|
|
float |
[pt] Largura da embalagem do SKU (cm). |
|
|
text |
[pt] Nome exibido do SKU. |
|
|
float |
[pt] Altura da embalagem do SKU (cm). |
|
|
float |
[pt] Comprimento da embalagem do SKU (cm). |
|
|
float |
[pt] Peso cúbico calculado da embalagem. |
|
|
float |
[pt] Comprimento do SKU em centÃmetros. |
|
|
text |
[pt] Identificador do produto ao qual o SKU pertence. |
|
|
text |
[pt] Código do fabricante informado para o SKU. |
|
|
text |
[pt] Unidade de medida do SKU (ex.: un, kg). |
|
|
float |
[pt] Peso do SKU em quilogramas. |
|
|
float |
[pt] Valor de recompensa concedido ao comprar o SKU. |
|
|
text |
[pt] Define o modelo de entrega/fulfillment do SKU. |
|
|
timestamp |
[pt] Data de criação do SKU. |
|
|
boolean |
[pt] Indica se o SKU está ativo. |
|
|
text |
[pt] EAN do SKU. |
vtex_skus_videos
URLs de vídeo vinculadas a cada SKU.
SKUs: kits
Tipo de replicacao: Integral
Relacionamentos:
Composição dos SKUs de kit VTEX com os componentes e respectivas quantidades.
| Campo | Tipo | |
|---|---|---|
|
float |
[pt] Identificador do SKU pai do kit. |
|
|
float |
[pt] Identificador do SKU componente vinculado ao kit. |
|
|
float |
[pt] Quantidade do componente incluída no kit. |
|
|
float |
[pt] Preço unitário atribuído ao componente do kit. |
SKUs: preços
Tipo de replicacao: Integral
Relacionamentos:
Objeto principal
Tabela com atributos de precificação dos SKUs VTEX (base, lista, custo e markup).
| Campo | Tipo | |
|---|---|---|
|
float |
[pt] Identificador numérico do SKU. |
|
|
float |
[pt] Preço base de venda do SKU (centavos). |
|
|
float |
[pt] Custo de venda do SKU (centavos). |
|
|
float |
[pt] Preço de tabela do item nesta opção logística (centavos). |
|
|
float |
[pt] Percentual de margem desejada para o SKU. |
vtex_skus_prices__fixedPrices
Regras de preço fixo configuradas por SKU e política comercial.
| Campo | Tipo | |
|---|---|---|
|
float |
[pt] Identificador numérico do SKU. |
|
|
timestamp |
[pt] Data e hora inicial da vigência do preço fixo. |
|
|
timestamp |
[pt] Data e hora final da vigência do preço fixo. |
|
|
float |
[pt] Preço de lista definido dentro da configuração de preço fixo. |
|
|
float |
[pt] Quantidade mínima necessária para aplicar o preço fixo. |
|
|
float |
[pt] Identificador da política comercial responsável pelo preço fixo. |
|
|
float |
[pt] Valor em que o preço fixo deve ser cobrado. |
Produtos
Catálogo de produtos VTEX com metadados comerciais.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador numérico único do produto. |
|
|
text |
[pt] Identificador da marca associada ao produto. |
|
|
text |
[pt] Identificador da categoria do produto. |
|
|
text |
[pt] Identificador do departamento vinculado à categoria. |
|
|
text |
[pt] Descrição completa do produto. |
|
|
text |
[pt] Descrição curta exibida em páginas e vitrines. |
|
|
boolean |
[pt] Indica se o produto está ativo para venda. |
|
|
boolean |
[pt] Mostra (true) ou oculta (false) o produto em buscas e páginas, sem impedir a compra. |
|
|
text |
[pt] Palavras-chave ou sinônimos do produto, separados por vÃrgula (campo obsoleto). |
|
|
text |
[pt] Slug usado para montar a URL da página do produto; quando vazio, é gerado a partir do nome. |
|
|
text |
[pt] Descrição curta para SEO; recomenda-se até 150 caracteres. |
|
|
text |
[pt] Nome do produto (máximo 150 caracteres). |
|
|
text |
[pt] Código de referência configurado para o produto. |
|
|
timestamp |
[pt] Usado para ordenar resultados de busca pela data de lançamento. |
|
|
text |
[pt] Valor utilizado para priorizar o produto nas pranchas de busca. |
|
|
boolean |
[pt] Quando true, ativa o recurso "avise-me" ao ficar sem estoque. |
|
|
text |
[pt] Código fiscal do produto, utilizado para cálculo de impostos. |
|
|
text |
[pt] TÃtulo do produto (tag |
Notas
- Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas
