01. Plataforma

02. Destinos

03. Conectores

55PBX

ActiveCampaign

Api4com

Apple App Store

ASAAS

AWS CloudWatch Metrics

Azure Table Storage

BigQuery (conector)

Bitrix24 CRM

Bling!

Blip (Take)

Brasil.io

ClickUp

Clockify

ContaAzul

Criteo

E-goi

EADBOX

Exact Sales

Facebook

Fatura Simples

Freshdesk

FTP

Google Ads (Adwords)

Google Analytics 4 (GA4)

Google Cloud Storage

Google Play Store

Google Search Console (Google Webmasters)

Google Sheets

Granatum

Hi Platform

Hotmart

HubSpot

Huggy

InfluxDB v1.x

Infusionsoft (Keap)

Instagram

Jira

Kondado

Linkedin

Loja Integrada

MailChimp

Mandrill

Meetime

Mercado Livre

Microsoft Advertising

Microsoft SQL Server (conector)

Microsoft SQL Server SSH (conector)

Mixpanel

Monday.com

MongoDB

Movidesk

MySQL (conector)

MySQL SSH (conector)

NectarCRM

Notion

Nuvemshop

Omie

Oracle (conector)

Pagar.me

Pinterest Ads

Pipedrive

Pipefy

PipeRun

Ploomes

PostgreSQL (conector)

Pushwoosh

RD Station

RDStation CRM

Recruiterbox

S3 (conector)

Salesforce

Salesforce Marketing Cloud

SenseData

Shopify

Stilingue

Superlógica

Sympla

Taboola

Tangerino

TikTok Ads

TikTok Orgânico

Tiny ERP

Toggl

Tray

Trello

Twilio

VNDA

VTEX

Wake Commerce (antigo Tray Corp by FBits)

Webhook

Wootric

X Ads

YouTube

Zeeng

Zendesk

Zendesk Chat

Índice de Conectores Kondado

04. API

05. Visualização

06. Central de Ajuda

VTEX

Adicionando o conector

  1. Acesse o painel administrativo da VTEX com a conta de usuario master
  2. Na barra lateral, acesse Configuracoes da Conta, depois Gerenciamento da Conta e entao clique em Chaves de aplicacao
  3. Clique no botao Gerenciar minhas chaves, voce sera direcionado(a) para a pagina Minhas chaves:
  4. Clique no botao Gerar Chave
  5. Insira um nome para a chave de aplicacao que esta sendo criada
  6. PASSO IMPORTANTE: Clique em +Adicionar Perfis para associar a chave aos perfis de acesso desejados - a chave de aplicacao sera capaz de autenticar integracoes com os modulos e funcionalidades aos quais os perfis escolhidos dao acesso
  7. Clique no botao Gerar
  8. Sera exibida uma URL de compartilhamento (share.vtex.com/credentials/...)
  9. ACESSE ESSA URL em uma nova aba do navegador
  10. O token real sera exibido - COPIE O TOKEN (nao a URL)
  11. Faca login na plataforma da Kondado e va para a pagina de adicionar conectores
  12. Selecione o conector da VTEX e preencha as informacoes conforme imagem abaixo
      1. Nome da conta: e a primeira parte da sua URL administrativa da VTEX. Por exemplo, se a sua URL e kondado.myvtex.com, o valor a ser preenchido e kondado
      2. Access Key: corresponde a Chave de aplicacao gerada no passo (5)
      3. Access Secret: corresponde ao Token de aplicacao copiado no passo (10)
    1. De um nome ao seu conector e clique em SALVAR

IMPORTANTE: Cole o TOKEN no campo Access Secret, NAO a URL.



Escopos minimos recomendados:
  • OMS > Listar pedidos - obrigatorio para teste de conexao e lista de pedidos
  • OMS > Visualizar pedido - obrigatorio para detalhes de pedidos
  • Catalogo > Obter Produto e SKU - para SKUs e Produtos
  • Logistica > Visualizador de Logistica - para Estoque
  • Pricing > Visualizar Precos - para Precos
  • Rates and Benefits > Visualizar Beneficios e Promocoes - para Promocoes e Cupons

Referencia: Recursos do License Manager

Integrações

Índice

Gráfico de relacionamento

Clique para ampliar

Coupons

Tipo de replicacao: Integral

Campo Tipo

coupon_id

text

[pt] Identificador do cupom.

expirationintervalperuse

text

[pt] Intervalo para reutilização do cupom.

isarchived

boolean

[pt] Indica se a promoção está arquivada.

lastmodifiedutc

timestamp

[pt] Data/hora UTC da última modificação.

maxitemsperclient

float

[pt] Quantidade máxima de itens por cliente.

utmcampaign

text

[pt] Filtro de campanha UTM.

utmsource

text

[pt] Filtro de origem UTM.

Estoque

Tipo de replicacao: Integral

Relacionamentos:

Posição de estoque dos SKUs por armazém.

Campo Tipo

skuid

text

[pt] Identificador do SKU associado ao registro de estoque.

    SKUs > > skuid

warehouseid

text

[pt] Identificador do centro de distribuição.

warehousename

text

[pt] Nome do armazém ou loja responsável pelo estoque.

totalquantity

float

[pt] Quantidade total disponível no estoque.

reservedquantity

float

[pt] Quantidade reservada para pedidos em andamento.

hasunlimitedquantity

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

id

text

[pt] Identificador da entidade no master data.

updatedin

timestamp

[pt] Momento em que o registro foi atualizado pela última vez

createdin

timestamp

[pt] Momento em que o registro foi criado

property_x

text

[pt] Exemplo de propriedade dinâmica

property_y

float

[pt] Exemplo numérico de propriedade dinâmica

property_z

date

[pt] Exemplo de propriedade dinâmica em formato de data

Pedidos

  1. Pedidos com o status de incompleto não serão retornados
  2. 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

orderid

text

[pt] Identificador do pedido no OMS VTEX.

origin

text

[pt] Origem do pedido, como Marketplace ou Fulfillment.

status

text

[pt] Status do pedido.

workflowinerrorstate

boolean

[pt] Indica se o workflow deste pedido está em retentativa.

lastmessageunread

text

[pt] Última mensagem transacional ainda não lida.

sequence

float

[pt] Identificador sequencial interno do pedido.

callcenteroperatorname

text

[pt] Nome do operador de call center associado ao pedido.

paymentnames

text

[pt] Nomes amigáveis dos meios de pagamento usados.

affiliateid

text

[pt] Nome do estabelecimento responsável pelo pedido.

shippingestimateddatemax

timestamp

[pt] Data máxima estimada para entrega do pedido.

invoiceinput

text

[pt] Dados enviados para a emissão da nota fiscal.

workflowinretry

boolean

[pt] Indica se o workflow está em retentativa.

shippingestimateddate

timestamp

[pt] Data prevista de envio ou entrega do pedido.

invoiceoutput

text

[pt] Resposta retornada após a emissão da nota fiscal.

marketplaceorderid

text

[pt] Identificador do pedido no marketplace parceiro.

hostname

text

[pt] Hostname VTEX que processou o pedido.

orderiscomplete

boolean

[pt] Indica se o pedido foi concluído.

listtype

text

[pt] Tipo da lista de presentes ligada ao pedido (quando houver).

totalvalue

float

[pt] Valor total do pedido em centavos.

saleschannel

text

[pt] Canal de vendas utilizado pelo pedido.

totalitems

float

[pt] Quantidade total de itens no pedido.

authorizeddate

timestamp

[pt] Data em que o pedido foi autorizado.

creationdate

timestamp

[pt] Data de criação do pedido.

statusdescription

text

[pt] Descrição textual do status do pedido.

listid

text

[pt] Identificador da lista de presentes relacionada, quando existir.

shippingestimateddatemin

timestamp

[pt] Data mínima estimada para entrega do pedido.

currencycode

text

[pt] Código da moeda conforme a norma ISO 4217.

clientname

text

[pt] Nome do cliente exibido no pedido.

Pedidos: informações logísticas

  1. Pedidos com o status de incompleto não serão retornados
  2. 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

orderid

text

[pt] Identificador do pedido ligado a estas informações logísticas.

    Pedidos > > orderid

itemindex

float

[pt] Posição do item na lista de logística.

    Pedidos: itens > > kdd_itemindex

addressid

text

[pt] Identificador do endereço usado para entrega.

deliverychannel

text

[pt] Canal logístico (entrega, retirada, pickup).

deliverycompany

text

[pt] Nome da transportadora ou parceiro responsável pela entrega.

deliverywindow

text

[pt] Janela de entrega planejada (quando informada).

listprice

float

[pt] Preço de tabela do item nesta opção logística (centavos).

lockttl

text

[pt] Prazo de bloqueio utilizado para reservar a janela de entrega.

pickuppointid

text

[pt] Identificador do ponto de retirada associado.

pickupstoreinfo__additionalinfo

text

[pt] Informações adicionais exibidas sobre o ponto de retirada.

pickupstoreinfo_addresstype

text

[pt] Tipo do endereço do ponto de retirada.

pickupstoreinfo_addressreceiver

text

[pt] Nome do responsável pelo ponto de retirada.

pickupstoreinfo_addressid

text

[pt] Identificador do endereço do ponto de retirada.

pickupstoreinfo_addresspostalcode

text

[pt] CEP do ponto de retirada.

pickupstoreinfo_addresscity

text

[pt] Cidade do ponto de retirada.

pickupstoreinfo_addressstate

text

[pt] UF/estado do ponto de retirada.

pickupstoreinfo_addresscountry

text

[pt] País do ponto de retirada.

pickupstoreinfo_addressstreet

text

[pt] Logradouro do ponto de retirada.

pickupstoreinfo_addressnumber

text

[pt] Número do endereço do ponto de retirada.

pickupstoreinfo_addressneighborhood

text

[pt] Bairro do ponto de retirada.

pickupstoreinfo_addresscomplement

text

[pt] Complemento do endereço do ponto de retirada.

pickupstoreinfo_addressreference

text

[pt] Referência/landmark para localizar o ponto de retirada.

pickupstoreinfo_addresscoordinates

text

[pt] Coordenadas geográficas do ponto de retirada.

pickupstoreinfo__dockid

text

[pt] Identificador do dock/porta usado para retirada.

pickupstoreinfo__friendlyname

text

[pt] Nome amigável exibido para o ponto de retirada.

pickupstoreinfo__ispickupstore

boolean

[pt] Indica se o local é habilitado para retirada.

polygonname

text

[pt] Nome do polígono logístico aplicado.

price

float

[pt] Preço do frete para este trecho (centavos).

selectedsla

text

[pt] Nome da SLA logística selecionada para o item.

sellingprice

float

[pt] Preço de venda efetivo da entrega (centavos).

shippingestimate

text

[pt] Estimativa textual do prazo de entrega.

shippingestimatedate

timestamp

[pt] Data estimada de entrega para esta opção.

shipsto

text

[pt] País de destino no padrão ISO 3166 alfa-3.

transittime

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

orderid

text

[pt] Identificador do pedido vinculado à SLA.

itemindex

float

[pt] Posição do item nesta lista de SLAs.

slas__deliverychannel

text

[pt] Canal de entrega oferecido na SLA.

slas__deliverywindow

text

[pt] Janela de entrega prevista na SLA.

slas__id

text

[pt] Identificador da SLA.

slas__lockttl

text

[pt] Prazo de bloqueio usado pela SLA.

slas__name

text

[pt] Nome amigável da SLA.

slas__pickuppointid

text

[pt] Identificador do ponto de retirada da SLA.

pickupstoreinfo__additionalinfo

text

[pt] Informações adicionais exibidas sobre o ponto de retirada.

pickupstoreinfo_addresstype

text

[pt] Tipo de endereço do ponto de retirada.

pickupstoreinfo_addressreceiver

text

[pt] Nome do responsável no ponto de retirada.

pickupstoreinfo_addressid

text

[pt] Identificador do endereço do ponto de retirada.

pickupstoreinfo_addresspostalcode

text

[pt] CEP do ponto de retirada.

pickupstoreinfo_addresscity

text

[pt] Cidade do ponto de retirada.

pickupstoreinfo_addressstate

text

[pt] UF/estado do ponto de retirada.

pickupstoreinfo_addresscountry

text

[pt] País do ponto de retirada.

pickupstoreinfo_addressstreet

text

[pt] Logradouro do ponto de retirada.

pickupstoreinfo_addressnumber

text

[pt] Número do ponto de retirada.

pickupstoreinfo_addressneighborhood

text

[pt] Bairro do ponto de retirada.

pickupstoreinfo_addresscomplement

text

[pt] Complemento do endereço de retirada.

pickupstoreinfo_addressreference

text

[pt] Referência ou ponto de apoio do local de retirada.

pickupstoreinfo_addresscoordinates

text

[pt] Coordenadas do ponto de retirada.

pickupstoreinfo__dockid

text

[pt] Identificador do dock utilizado para retirada.

pickupstoreinfo__friendlyname

text

[pt] Nome amigável exibido para o ponto de retirada.

pickupstoreinfo__ispickupstore

boolean

[pt] Informa se o local está habilitado como loja de retirada.

slas__polygonname

text

[pt] Polígono aplicado à rota da SLA.

slas__price

float

[pt] Preço do frete cobrado pela SLA (centavos).

slas__shippingestimate

text

[pt] Estimativa de envio para esta SLA.

slas__transittime

text

[pt] Tempo de trânsito informado pela SLA.

vtex_logisticsinfo__deliveryIds

Identificadores de entrega detalhando transportadoras e quantidades.

Campo Tipo

orderid

text

[pt] Identificador do pedido vinculado ao deliveryId.

itemindex

float

[pt] Posição do item dentro da lista de deliveryIds.

deliveryids__accountcarriername

text

[pt] Nome da transportadora configurada na conta.

deliveryids__courierid

text

[pt] Identificador do courier neste deliveryId.

deliveryids__couriername

text

[pt] Nome exibido do courier.

deliveryids__dockid

text

[pt] Dock utilizado para despachar este deliveryId.

deliveryids__quantity

float

[pt] Quantidade de itens neste deliveryId.

deliveryids__warehouseid

text

[pt] Depósito responsável por este deliveryId.

Pedidos: dados de marketing

  1. Pedidos com o status de incompleto não serão retornados
  2. 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

orderid

text

[pt] Identificador do pedido relacionado aos dados de marketing.

    Pedidos > > orderid

utmsource

text

[pt] Parâmetro UTM Source associado ao pedido.

utmpartner

text

[pt] Parâmetro de parceiro (utmPartner) informado pelo lojista.

utmmedium

text

[pt] Parâmetro UTM Medium utilizado na campanha.

utmcampaign

text

[pt] Parâmetro UTM Campaign associado ao pedido.

coupon

text

[pt] Cupom de desconto do pedido (normalizado para maiúsculas).

    Coupons > > coupon_id

utmicampaign

text

[pt] Parâmetro interno de campanha (utmiCampaign).

utmipage

text

[pt] Parâmetro interno de página (utmiPage).

utmipart

text

[pt] Parâmetro interno de parte (utmiPart).

marketingtags

text

[pt] Lista de tags/identificadores de marketing enviados pelo pedido.

Pedidos: dados de envio

  1. Pedidos com o status de incompleto não serão retornados
  2. 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

orderid

text

[pt] Identificador do pedido ao qual os dados de entrega pertencem.

    Pedidos > > orderid

address__addresstype

text

[pt] Tipo do endereço de entrega.

address__neighborhood

text

[pt] Bairro do endereço de entrega.

address__addressid

text

[pt] Identificador do endereço de entrega.

address__complement

text

[pt] Complemento do endereço de entrega.

address__number

text

[pt] Número do endereço de entrega.

address__street

text

[pt] Logradouro do endereço de entrega.

address__geocoordinates

text

[pt] Coordenadas geográficas do endereço de entrega.

address__city

text

[pt] Cidade do endereço de entrega.

address__reference

text

[pt] Referência do endereço de entrega.

address__receivername

text

[pt] Nome do destinatário da entrega.

address__country

text

[pt] País de entrega no formato ISO 3166 ALPHA-3.

address__state

text

[pt] Estado/UF do endereço de entrega.

address__postalcode

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

orderid

text

[pt] Pedido ao qual o endereço selecionado pertence.

selectedaddresses__addresstype

text

[pt] Tipo de endereço selecionado (entrega, cobrança, retirada).

selectedaddresses__neighborhood

text

[pt] Bairro registrado para o endereço escolhido.

selectedaddresses__addressid

text

[pt] Identificador interno do endereço selecionado.

selectedaddresses__complement

text

[pt] Complemento do endereço escolhido.

selectedaddresses__number

text

[pt] Número do endereço selecionado.

selectedaddresses__street

text

[pt] Logradouro do endereço selecionado.

selectedaddresses__geocoordinates

text

[pt] Coordenadas geográficas associadas ao endereço.

selectedaddresses__city

text

[pt] Cidade do endereço selecionado.

selectedaddresses__reference

text

[pt] Ponto de referência informado para facilitar a entrega.

selectedaddresses__receivername

text

[pt] Nome da pessoa que receberá a entrega.

selectedaddresses__country

text

[pt] País do endereço selecionado.

selectedaddresses__state

text

[pt] Estado/UF do endereço selecionado.

selectedaddresses__postalcode

text

[pt] CEP/código postal do endereço selecionado.

Pedidos: detalhes

  1. Pedidos com o status de incompleto não serão retornados
  2. 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

orderid

text

[pt] Identificador do pedido no OMS VTEX.

    Pedidos > > orderid

kdd_customer_id

text

[pt] Identificador aproximado do cliente gerado pela Kondado (experimental).

origin

text

[pt] Origem do pedido, como Marketplace ou Fulfillment.

totalitems

float

[pt] Quantidade total de itens no pedido.

clientname

text

[pt] Nome do cliente exibido no pedido.

marketplaceservicesendpoint

text

[pt] Endpoint configurado para integrações com o marketplace.

opentextfield

text

[pt] Campo livre para observações adicionais do pedido.

sequence

text

[pt] Identificador sequencial interno do pedido.

taxdata

text

[pt] Dados fiscais agregados retornados no pedido.

marketplaceorderid

text

[pt] Código do pedido no marketplace parceiro.

customdata

text

[pt] Estrutura personalizada com dados enviados pelo cliente.

followupemail

text

[pt] E-mail do responsável pela loja/atendimento.

ischeckedin

boolean

[pt] Informa se o pedido foi retirado no ponto físico.

lastchange

timestamp

[pt] Data da última alteração registrada no pedido.

subscriptiondata

text

[pt] Informações de assinatura ou recorrência vinculadas ao pedido.

iscompleted

boolean

[pt] Indica se o pedido foi concluído.

affiliateid

text

[pt] Nome do estabelecimento responsável pela venda.

lastmessage

text

[pt] Última mensagem transacional registrada para o pedido.

cancellationdata

text

[pt] Detalhes sobre cancelamentos solicitados ou concluídos.

clientprofiledata__corporatephone

text

[pt] Telefone corporativo informado pelo cliente.

clientprofiledata__iscorporate

boolean

[pt] Indica se o cliente é corporativo.

clientprofiledata__customerclass

text

[pt] Classificação comercial atribuída ao cliente.

clientprofiledata__corporatedocument

text

[pt] Documento corporativo (CNPJ ou similar) do cliente.

clientprofiledata__phone

text

[pt] Telefone principal informado no pedido.

clientprofiledata__userprofileid

text

[pt] Identificador do perfil de usuário no ambiente VTEX.

clientprofiledata__documenttype

text

[pt] Tipo de documento informado pelo cliente (CPF, passaporte etc.).

clientprofiledata__id

text

[pt] Identificador do registro de perfil do cliente.

clientprofiledata__firstname

text

[pt] Primeiro nome do cliente.

clientprofiledata__lastname

text

[pt] Sobrenome do cliente.

clientprofiledata__tradename

text

[pt] Nome fantasia informado para o cliente.

clientprofiledata__stateinscription

text

[pt] Inscrição estadual ou registro fiscal complementar do cliente.

clientprofiledata__corporatename

text

[pt] Razão social do cliente corporativo.

clientprofiledata__document

text

[pt] Documento principal do cliente (CPF, CNPJ etc.).

clientprofiledata__email

text

[pt] E-mail de contato informado pelo cliente.

orderformid

text

[pt] Identificador do formulário de pedido no VTEX.

creationdate

timestamp

[pt] Data de criação do pedido.

allowcancellation

boolean

[pt] Indica se o pedido aceita cancelamento.

changesattachment

text

[pt] Registros de anexos relacionados a alterações do pedido.

invoiceddate

timestamp

[pt] Data em que a nota fiscal foi emitida.

allowedition

boolean

[pt] Indica se o pedido aceita edição após criado.

merchantname

text

[pt] Nome do seller/loja responsável pelo pedido.

authorizeddate

timestamp

[pt] Data em que o pedido foi autorizado.

cancelreason

text

[pt] Motivo informado para cancelamento do pedido.

hostname

text

[pt] Hostname da conta registrado no License Manager.

callcenteroperatordata

text

[pt] Dados do operador de call center responsável pelo pedido.

value

float

[pt] Valor associado ao price tag aplicado ao pedido.

statusdescription

text

[pt] Descrição textual do status atual do pedido.

commercialconditiondata

text

[pt] Detalhes da condição comercial aplicada ao pedido.

ordergroup

text

[pt] Identificador do grupo de pedidos relacionado.

status

text

[pt] Status atual do pedido.

sellerorderid

text

[pt] Identificador do pedido no seller/marketplace.

giftregistrydata

text

[pt] Informações da lista de presentes vinculada ao pedido.

checkedinpickuppointid

text

[pt] Ponto de retirada onde o pedido foi conferido.

roundingerror

float

[pt] Total de diferenças originadas por arredondamento.

saleschannel

text

[pt] Identificador do canal de vendas do pedido.

marketplace__iscertified

text

[pt] Indica se o marketplace informado é certificado.

marketplace__baseurl

text

[pt] URL base do marketplace responsável pelo pedido.

marketplace__name

text

[pt] Nome do marketplace que originou o pedido.

Pedidos: itens

  1. Pedidos com o status de incompleto não serão retornados
  2. 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

orderid

text

[pt] Identificador do pedido ao qual o item pertence.

    Pedidos > > orderid

order_creationdate

timestamp

[pt] Data de criação do pedido referente ao item.

kdd_itemindex

int

[pt] Índice calculado que indica a posição do item no array de resposta do pedido (usado para referenciar outros pipelines com `itemindex`).

serialnumbers

text

[pt] Séries associadas ao item, quando aplicável.

offerings

text

[pt] Ofertas adicionais vinculadas ao item.

pricetags

text

[pt] Lista de etiquetas de preço e promoções aplicadas.

isgift

boolean

[pt] Indica se o item foi marcado como presente no pedido.

freightcommission

float

[pt] Valor de comissão de frete registrado para o seller.

commission

float

[pt] Comissão registrada para o seller.

params

text

[pt] Parâmetros adicionais aplicados ao item.

shippingprice

float

[pt] Valor de frete atribuído ao item.

ean

text

[pt] Código EAN do SKU.

parentassemblybinding

text

[pt] Referência ao conjunto pai do qual este item faz parte.

name

text

[pt] Nome exibido do item no pedido.

assemblies

text

[pt] Lista de componentes ou acessórios associados ao item.

pricedefinitions

text

[pt] Definições detalhadas de preços e descontos aplicados ao item.

measurementunit

text

[pt] Unidade de medida utilizada para o item.

unitmultiplier

float

[pt] Multiplicador aplicado à unidade de medida do item.

productid

text

[pt] Identificador do produto ao qual o item pertence.

refid

text

[pt] Código de referência configurado para o item.

taxcode

text

[pt] Código fiscal associado ao item.

pricevaliduntil

text

[pt] Data limite para manter o preço informado.

tax

float

[pt] Valor de impostos calculados para o item.

detailurl

text

[pt] URL pública (slug) para os detalhes do produto.

parentitemindex

text

[pt] Índice do item pai quando existe agrupamento ou kit.

callcenteroperator

text

[pt] Operador de call center responsável pelo item/pedido.

id

text

[pt] Identificador único retornado para o item.

seller

text

[pt] Seller (loja) responsável por este item.

uniqueid

text

[pt] Identificador único do item dentro do pedido.

costprice

float

[pt] Custo do item registrado no pedido (centavos).

presaledate

text

[pt] Data de pré-venda cadastrada para o item.

sellingprice

float

[pt] Preço de venda aplicado ao item (centavos).

sellersku

text

[pt] Identificador do SKU no seller.

    SKUs > > skuid

price

float

[pt] Preço base do item (centavos).

manualprice

text

[pt] Preço informado manualmente para o item.

rewardvalue

float

[pt] Valor de recompensa associado ao item.

lockid

text

[pt] Identificador da reserva (lock) do item.

imageurl

text

[pt] URL da imagem do SKU.

listprice

float

[pt] Preço de lista do item (centavos).

quantity

float

[pt] Quantidade do item no pedido.

additionalinfo__brandname

text

[pt] Nome da marca do item.

additionalinfo__brandid

text

[pt] Identificador numérico da marca do item.

additionalinfo__categoriesids

text

[pt] IDs das categorias vinculadas ao item.

_kdd_categories_sequence

text

[pt] Sequência de categorias do item separadas por > (calculado pela Kondado).

additionalinfo__productclusterid

text

[pt] Clusters de produtos associados ao item.

additionalinfo__commercialconditionid

text

[pt] Identificador da condição comercial aplicada ao item.

additionalinfo__offeringinfo

text

[pt] Descrição textual da oferta associada ao item.

additionalinfo__offeringtype

text

[pt] Tipo de oferta (por exemplo, desconto, brinde, serviço).

additionalinfo__offeringtypeid

text

[pt] Identificador do tipo de oferta aplicada.

additionalinfo__dimension__cubicweight

float

[pt] Peso cúbico do item.

additionalinfo__dimension__height

float

[pt] Altura do item.

additionalinfo__dimension__length

float

[pt] Comprimento do item.

additionalinfo__dimension__weight

float

[pt] Peso do item.

additionalinfo__dimension__width

float

[pt] Largura do item.

vtex_orders_items__additionalinfo__categories

Tabela auxiliar com cada categoria atribuída aos itens.

Campo Tipo

item_orderid

text

[pt] Pedido relacionado à categoria registrada.

uniqueid

text

[pt] Identificador único do item usado para ligação com a categoria.

additionalinfo__categories__id

text

[pt] Identificador da categoria listada para o item.

additionalinfo__categories__name

text

[pt] Nome da categoria registrada para o item.

Pedidos: pagamentos: transações

  1. Pedidos com o status de incompleto não serão retornados
  2. 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

orderid

text

[pt] Identificador do pedido.

    Pedidos > > orderid

isactive

boolean

[pt] Indica se a promoção está ativa.

merchantname

text

[pt] Nome do lojista.

status

text

[pt] Status atual da promoção.

transactionid

text

[pt] Identificador da transação.

vtex_payment_transactions__payments

Campo Tipo

orderid

text

[pt] Identificador do pedido.

    Pedidos > > orderid

transactionid

text

[pt] Identificador da transação.

payments_postalcode

text

[pt] CEP do endereço de pagamento.

payments_city

text

[pt] Cidade do endereço de pagamento.

payments_complement

text

[pt] Complemento do endereço de pagamento.

payments_country

text

[pt] País do endereço de pagamento.

payments_geocoordinates

text

[pt] Coordenadas do endereço de pagamento.

payments_neighborhood

text

[pt] Bairro do endereço de pagamento.

payments_number

text

[pt] Número do endereço de pagamento.

payments_reference

text

[pt] Referência para o endereço de pagamento.

payments_state

text

[pt] Estado/UF do endereço de pagamento.

payments_street

text

[pt] Logradouro do endereço de pagamento.

payments_message

text

[pt] Mensagem retornada pelo processador.

payments_returncode

text

[pt] Código de retorno do processador.

payments_accountid

text

[pt] Identificador da conta de pagamento.

payments_authid

text

[pt] Identificador de autorização retornado.

payments_bankissuedinvoicebarcodenumber

text

[pt] Código de barras do boleto emitido.

payments_bankissuedinvoicebarcodetype

text

[pt] Tipo de código de barras do boleto.

payments_bankissuedinvoiceidentificationnumber

text

[pt] Número identificador do boleto bancário.

payments_bankissuedinvoiceidentificationnumberformatted

text

[pt] Identificador formatado do boleto.

payments_cardholder

text

[pt] Nome do portador do cartão.

payments_duedate

date

[pt] Data de vencimento do pagamento.

payments_expiremonth

text

[pt] Mês de vencimento do cartão.

payments_expireyear

text

[pt] Ano de vencimento do cartão.

payments_firstdigits

text

[pt] Primeiros dígitos do cartão (BIN).

payments_giftcardasdiscount

text

[pt] Valor aplicado de gift card como desconto.

payments_giftcardcaption

text

[pt] Rótulo do gift card informado.

payments_giftcardid

text

[pt] Identificador do gift card utilizado no pagamento.

payments_giftcardname

text

[pt] Nome do gift card utilizado.

payments_giftcardprovider

text

[pt] Fornecedor do gift card.

payments_group

text

[pt] Grupo do pagamento (ex.: creditCard, bankInvoice).

payments_id

text

[pt] Identificador do pagamento dentro da transação.

payments_installments

float

[pt] Número de parcelas aplicadas.

payments_koinurl

text

[pt] URL retornada pela Koin quando aplicável.

payments_lastdigits

text

[pt] Últimos dígitos do cartão.

payments_ns

text

[pt] Número sequencial (NSU) retornado.

payments_parentaccountid

text

[pt] Identificador de conta pai do pagamento.

payments_paymentsystem

text

[pt] Identificador do meio de pagamento.

payments_paymentsystemname

text

[pt] Nome do meio de pagamento.

payments_redemptioncode

text

[pt] Código de resgate retornado.

payments_referencevalue

float

[pt] Valor de referência enviado ao meio de pagamento.

payments_tid

text

[pt] Identificador TID da transação.

payments_url

text

[pt] URL fornecida para o pagamento (redirect, boleto etc.).

payments_value

float

[pt] Valor do pagamento em centavos.

Pedidos: taxas e benefícios

  1. Orders com o status de incompleto não serão retornadas
  2. 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

orderid

text

[pt] Identificador do pedido que recebeu a promoção.

    Pedidos > > orderid

description

text

[pt] Descrição da promoção aplicada.

featured

boolean

[pt] Indica se a promoção pode ser acumulada com outras.

promotion_id

text

[pt] Identificador único da promoção.

    Promotions > > promotion_id

name

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.

Campo Tipo

orderid

text

[pt] Pedido ao qual estes parâmetros casados pertencem.

promotion_id

text

[pt] Identificador único da promoção.

matchedparameters_key

text

[pt] Chave do parâmetro casado que aciona a promoção.

matchedparameters_val

text

[pt] Valor do parâmetro casado que satisfaz a condição.

Pedidos: totais

  1. Pedidos com o status de incompleto não serão retornados
  2. 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

orderid

text

[pt] Identificador do pedido no OMS VTEX.

    Pedidos > > orderid

totalvalue

float

[pt] Valor total do pedido (centavos).

totaldiscount

float

[pt] Total de descontos aplicados em centavos.

totalshipping

float

[pt] Total de frete cobrado em centavos.

totaltax

float

[pt] Total de impostos do pedido em centavos.

Promotions

Tipo de replicacao: Integral

Objeto principal

Campo Tipo

promotion_id

text

[pt] Identificador da promoção.

activategiftsmultiplier

boolean

[pt] Quando verdadeiro, ativa o multiplicador de brindes.

aresaleschannelidsexclusive

boolean

[pt] Define se os canais listados deixam a promoção exclusiva.

begindate

timestamp

[pt] Data inicial da promoção (UTC).

description

text

[pt] Descrição textual da promoção.

enddate

timestamp

[pt] Data final da promoção (UTC).

hasmaxpriceperitem

boolean

[pt] Informa se existe preço máximo por item para aplicar o benefício.

isactive

boolean

[pt] Indica se a promoção está ativa.

isarchived

boolean

[pt] Indica se a promoção está arquivada.

istax

boolean

[pt] Informa se a promoção atua como um imposto.

lastmodifiedutc

timestamp

[pt] Data/hora UTC da última modificação.

maxusage

float

[pt] Quantidade máxima de usos permitida.

name

text

[pt] Nome da promoção.

percentualtax

float

[pt] Percentual de imposto aplicado sobre o pedido.

scope_allcatalog

boolean

[pt] Define se a promoção atinge todo o catálogo.

scope_brands

float

[pt] Lista de marcas que acionam a promoção.

scope_brandsareinclusive

boolean

[pt] Quando verdadeiro, somente as marcas listadas se qualificam; caso contrário, são excluídas.

scope_categories

float

[pt] Categorias consideradas pela promoção.

scope_categoriesareinclusive

boolean

[pt] Define se as categorias listadas incluem ou excluem produtos.

scope_collections

float

[pt] Coleções às quais a promoção se aplica.

scope_collectionsareinclusive

boolean

[pt] Define se as coleções listadas incluem ou excluem produtos.

scope_products

float

[pt] Lista de produtos considerados no escopo.

scope_productsareinclusive

boolean

[pt] Define se os produtos listados incluem ou excluem a promoção.

scope_sellers

float

[pt] IDs de vendedores considerados no escopo.

scope_sellersareinclusive

boolean

[pt] Define se os vendedores listados incluem ou excluem o benefício.

scope_skus

float

[pt] SKUs cobertos pelo escopo.

scope_skusareinclusive

boolean

[pt] Define se os SKUs listados incluem ou excluem a promoção.

status

text

[pt] Status atual da promoção.

type

text

[pt] Tipo de promoção.

utmcampain

text

[pt] Filtro de campanha UTM.

utmsource

text

[pt] Filtro de origem UTM.

utmicampaign

text

[pt] Filtro interno de campanha UTM.

promotions__Campaigns

Campo Tipo

promotion_id

text

[pt] Identificador da promoção.

campaigns_value

text

[pt] Valor listado em campanhas.

promotions_idsSalesChannel

Campo Tipo

promotion_id

text

[pt] Identificador da promoção.

idssaleschannel_value

float

[pt] Valor dentro de idsSalesChannel.

SKUs

Tipo de replicacao: Integral

Objeto principal

Metadados completos do catálogo de SKUs VTEX.

Campo Tipo

skuid

text

[pt] Identificador único do SKU.

width

float

[pt] Largura do SKU (cm).

packagedweightkg

float

[pt] Peso da embalagem em quilogramas.

height

float

[pt] Altura do SKU em centímetros.

unitmultiplier

float

[pt] Multiplicador aplicado à quantidade adicionada ao carrinho.

commercialconditionid

float

[pt] Identificador da condição comercial aplicada ao SKU.

refid

text

[pt] Código de referência configurado para o SKU.

iskit

boolean

[pt] Indica se o SKU representa um kit.

kititenssellapart

boolean

[pt] Define se os componentes do kit podem ser vendidos separadamente.

estimateddatearrival

text

[pt] Data estimada de chegada do SKU ao estoque.

packagedwidth

float

[pt] Largura da embalagem do SKU (cm).

name

text

[pt] Nome exibido do SKU.

packagedheight

float

[pt] Altura da embalagem do SKU (cm).

packagedlength

float

[pt] Comprimento da embalagem do SKU (cm).

cubicweight

float

[pt] Peso cúbico calculado da embalagem.

length

float

[pt] Comprimento do SKU em centímetros.

productid

text

[pt] Identificador do produto ao qual o SKU pertence.

manufacturercode

text

[pt] Código do fabricante informado para o SKU.

measurementunit

text

[pt] Unidade de medida do SKU (ex.: un, kg).

weightkg

float

[pt] Peso do SKU em quilogramas.

rewardvalue

float

[pt] Valor de recompensa concedido ao comprar o SKU.

modaltype

text

[pt] Define o modelo de entrega/fulfillment do SKU.

creationdate

timestamp

[pt] Data de criação do SKU.

isactive

boolean

[pt] Indica se o SKU está ativo.

ean

text

[pt] EAN do SKU.

vtex_skus_videos

URLs de vídeo vinculadas a cada SKU.

Campo Tipo

skuid

text

[pt] Identificador do SKU relacionado ao vídeo.

video_url

text

[pt] URL de vídeo associado ao SKU.

SKUs: kits

Tipo de replicacao: Integral

Relacionamentos:

Composição dos SKUs de kit VTEX com os componentes e respectivas quantidades.

Campo Tipo

sku_kit_id

float

[pt] Identificador do SKU pai do kit.

    SKUs > > skuid

component_sku_id

float

[pt] Identificador do SKU componente vinculado ao kit.

    SKUs > > skuid

quantity

float

[pt] Quantidade do componente incluída no kit.

unitprice

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

skuid

float

[pt] Identificador numérico do SKU.

    SKUs > > skuid

baseprice

float

[pt] Preço base de venda do SKU (centavos).

costprice

float

[pt] Custo de venda do SKU (centavos).

listprice

float

[pt] Preço de tabela do item nesta opção logística (centavos).

markup

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

skuid

float

[pt] Identificador numérico do SKU.

    SKUs > > skuid

daterange_from

timestamp

[pt] Data e hora inicial da vigência do preço fixo.

daterange_up_to

timestamp

[pt] Data e hora final da vigência do preço fixo.

fixedprices_listprice

float

[pt] Preço de lista definido dentro da configuração de preço fixo.

fixedprices_minquantity

float

[pt] Quantidade mínima necessária para aplicar o preço fixo.

fixedprices_tradepolicyid

float

[pt] Identificador da política comercial responsável pelo preço fixo.

fixedprices_value

float

[pt] Valor em que o preço fixo deve ser cobrado.

Produtos

Tipo de replicacao: Integral

Relacionamentos:

Catálogo de produtos VTEX com metadados comerciais.

Campo Tipo

id

text

[pt] Identificador numérico único do produto.

    Pedidos: itens > > productid

brandid

text

[pt] Identificador da marca associada ao produto.

categoryid

text

[pt] Identificador da categoria do produto.

departmentid

text

[pt] Identificador do departamento vinculado à categoria.

description

text

[pt] Descrição completa do produto.

descriptionshort

text

[pt] Descrição curta exibida em páginas e vitrines.

isactive

boolean

[pt] Indica se o produto está ativo para venda.

isvisible

boolean

[pt] Mostra (true) ou oculta (false) o produto em buscas e páginas, sem impedir a compra.

keywords

text

[pt] Palavras-chave ou sinônimos do produto, separados por vírgula (campo obsoleto).

linkid

text

[pt] Slug usado para montar a URL da página do produto; quando vazio, é gerado a partir do nome.

metatagdescription

text

[pt] Descrição curta para SEO; recomenda-se até 150 caracteres.

name

text

[pt] Nome do produto (máximo 150 caracteres).

refid

text

[pt] Código de referência configurado para o produto.

releasedate

timestamp

[pt] Usado para ordenar resultados de busca pela data de lançamento.

score

text

[pt] Valor utilizado para priorizar o produto nas pranchas de busca.

showwithoutstock

boolean

[pt] Quando true, ativa o recurso "avise-me" ao ficar sem estoque.

taxcode

text

[pt] Código fiscal do produto, utilizado para cálculo de impostos.

title

text

[pt] Título do produto (tag ), importante para SEO e limitado a 150 caracteres.</small></p> </td> </tr> </table></div></div></div> <h2 id='end-notes' name='end-notes'>Notas</h2><div><div class="kdd-auto-generated-notes"><ul><li>Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas</li></ul></div></div> </p> </div> </div> </div> <!-- <div class="col-lg-2 col-xs-12 d-none d-lg-block blog-post-follow-us-lg" id="post_left_cta"> <div class="row section"> <div class="col-lg-12 col-xs-12"> <p class="header"> Inscreva-se </p> <p class="text"> Abordamos dados e análises dentro das empresas. </p> <p class="text-btn"> <a id="left-btn-newsletter" class="btn-subscribe"> Receba novos artigos por e-mail </a> </p> </div> </div> <div class="row section"> <div class="col-lg-12 col-xs-12"> <p class="header-social"> Compartilhe </p> <p> <a href="https://www.linkedin.com/shareArticle?mini=true&url=https://kondado.com.br/blog/wiki/2019/11/27/adicionando-o-conector-da-vtex-na-plataforma-da-kondado/&title=VTEX" onclick="window.open(this.href, 'mywin','left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" class="social"> <i class="fab fa-linkedin"></i> </a> <a href="https://www.facebook.com/sharer/sharer.php?u=https://kondado.com.br/blog/wiki/2019/11/27/adicionando-o-conector-da-vtex-na-plataforma-da-kondado/&src=sdkpreparse" onclick="window.open(this.href, 'mywin','left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" class="social"> <i class="fab fa-facebook"></i> </a> <a href="https://twitter.com/intent/tweet?text=VTEX&url=https://kondado.com.br/blog/wiki/2019/11/27/adicionando-o-conector-da-vtex-na-plataforma-da-kondado/" onclick="window.open(this.href, 'mywin','left=20,top=20,width=500,height=500,toolbar=1,resizable=0'); return false;" class="social"> <i class="fab fa-twitter"></i> </a> </p> <p> </p> <p> </p> </div> </div> </div> --> </div> </div> </div> </div> </div> <script type='text/javascript' src='https://kondado.com.br/blog/wiki/wp-content/themes/wiki/assets/libs/node_modules/popper.js/dist/umd/popper.js?ver=%20%20%20%20%20%20%20%203.3.6' id='popper-js'></script> <script type='text/javascript' src='https://kondado.com.br/blog/wiki/wp-content/themes/wiki/assets/libs/node_modules/bootstrap-material-design/dist/js/bootstrap-material-design.js?ver=3.3.6' id='bootstrap-js'></script> </body> </html>