Tray

Adicionando a fonte de dados

Para adicionar o conector do Tray, siga os passos abaixo:

1) Faça login na Kondado e deixe a página aberta

2) Em outra aba, faça login na sua conta da Tray com uma conta de administrador

3) Insira a URL administrativa de sua loja (por exemplo sua-loja.commercesuite.com.br) abaixo e clique em Autenticar

4) Você será direcionado para a página de adição do Tray no app da Kondado (onde fez login no passo (1)). Clique em AUTORIZAR

5) Na nova janela, clique em "Autorizar" novamente

6) Você será direcionado de volta para a Kondado, já com o seu aplicativo autorizado. Agora basta dar um nome para o seu conector e clicar em "SALVAR"

Pipelines

Resumo

Diagrama de relacionamento

Clique para expandir

Cupons de desconto

Tipo de replicacao: Integral

Relacionamentos:

Cupons de desconto da loja, com um registro por cupom. Traz o código do cupom, descrição, tipo de cupom e de desconto, valor do desconto e faixa de valores de aplicação, período de validade, regras de aplicação (frete, restrição local, acumulação, produtos em promoção) e contadores de uso e seus limites.

Campo Tipo

discountcoupon_id

float

[pt] id do cupom

    Pedidos > > discount_coupon

discountcoupon_code

text

[pt] Nome do cupom. Obs: Neste campo não é aceito espaço e acentuação nas palavras

discountcoupon_coupon_type

text

[pt] Tipo de cupom

discountcoupon_created

timestamp

[pt] Data de criação do cupom

discountcoupon_cumulative_discount

text

[pt] Permitir que o cupom acumule o desconto com o desconto progressivo. Tabela B

discountcoupon_description

text

[pt] Descrição do cupom

discountcoupon_ends_at

text

[pt] Data final da validade do cupom

discountcoupon_freight_application

text

[pt] Aplicação sobre o frete

discountcoupon_local_application

text

[pt] Local de aplicação

discountcoupon_local_restriction

text

[pt] Restrição de local

discountcoupon_should_apply_on_valid_promotional_products

float

[pt] Indicador (0/1) de aplicação sobre produtos em promoção válidos

discountcoupon_starts_at

text

[pt] Data de início da validade do cupom

discountcoupon_type

text

[pt] Tipo de desconto

discountcoupon_updated

timestamp

[pt] Data da última atualização do cupom

discountcoupon_usage_counter

float

[pt] Contador de usos do cupom

discountcoupon_usage_counter_limit

float

[pt] Limita a quantidade de vezes que o cupom poderá ser usado no geral

discountcoupon_usage_counter_limit_customer

float

[pt] Limite de usos do cupom por cliente

discountcoupon_usage_sum

float

[pt] Valor acumulado de uso do cupom

discountcoupon_usage_sum_limit

float

[pt] Limita o valor do cupom

discountcoupon_value

float

[pt] Valor de desconto do cupom

discountcoupon_value_end

float

[pt] Valor máximo do produto para ser aplicado o desconto

discountcoupon_value_start

float

[pt] Valor mínimo do produto para ser aplicado o desconto

Clientes

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Objeto principal

Cadastro de clientes da loja, com um registro por cliente. Traz nome, apelido, e-mail, sexo, data de nascimento, cidade e estado, perfil/grupo do cliente, adesão à newsletter, desconto associado, datas de criação, modificação, registro e última visita.

Campo Tipo

id

float

[pt] Código do cliente

profile_approves_registration

float

[pt] Indicador (0/1) de aprovação de cadastro do perfil do cliente

profile_id

float

[pt] Código do perfil/grupo do cliente

profile_name

text

[pt] Nome do perfil/grupo do cliente

birth_date

date

[pt] Data de aniversário

city

text

[pt] Cidade

created

timestamp

[pt] Data de criação

discount

float

[pt] Desconto associado ao cliente

email

text

[pt] E-mail

gender

float

[pt] Sexo

last_visit

date

[pt] Data da última visita

modified

timestamp

[pt] Data de modificação

name

text

[pt] Nome

newsletter

float

[pt] Newsletter ativa

nickname

text

[pt] Apelido do cliente

profile_customer_id

float

[pt] Código do cliente no perfil

registration_date

date

[pt] Data de registro

state

text

[pt] Sigla do estado

cpf

text

[pt] CPF do cliente (pessoa física)

cnpj

text

[pt] CNPJ do cliente (pessoa jurídica)

company_name

text

[pt] Razão social (pessoa jurídica)

count_orders

float

[pt] Quantidade de pedidos do cliente

tray_customers__customeraddress

Sub-tabela de clientes: endereços cadastrados de cada cliente, com um registro por endereço vinculado ao cliente pelo código do cliente.

Campo Tipo

id

float

[pt] Código do cliente

customeraddress_id

float

[pt] Código do endereço do cliente

tray_customers__attributes

Sub-tabela de clientes: atributos personalizados de cada cliente, com um registro por atributo (identificador e valor) vinculado ao cliente pelo código do cliente.

Campo Tipo

id

float

[pt] Código do cliente

attributes_customer_attribute_id

float

[pt] Código do atributo personalizado do cliente

attributes_id

float

[pt] Código do registro de atributo

attributes_value

text

[pt] Valor do atributo personalizado

Newsletters

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Relacionamentos:

Inscrições na newsletter da loja, com um registro por inscrição. Traz o e-mail e o nome do inscrito, o status da inscrição, o token e as datas de criação e modificação.

Campo Tipo

newsletter_id

float

[pt] Código do newsletters

newsletter_email

text

[pt] Email do cliente

    Clientes > > email

newsletter_created

timestamp

[pt] Data de criação

newsletter_modified

timestamp

[pt] Data de modificação

newsletter_name

text

[pt] Nome do cliente

newsletter_status

float

[pt] Newsletter ativo

newsletter_token

text

[pt] Token da inscrição

Pedidos: detalhes

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Relacionamentos:

Detalhes complementares dos pedidos, com um registro por pedido (vinculado ao pedido pelo código do pedido). Traz informações de marketplace, endereço de cobrança, custo, parcelamento e juros, datas (pedido, entrega, envio), prazo de entrega, IP do cliente, observações, parceiro de origem, URLs de acompanhamento e mensagens do meio de pagamento.

Campo Tipo

order_id

float

[pt] Identificador do pedido

    Pedidos > > id

order_extratabs

text

[pt] Abas extras do pedido

order_marketplaceorder

text

[pt] Dados do pedido no marketplace

order_orderinvoiceamount

text

[pt] Valor da nota fiscal do pedido em R$ (BRL)

order_pickuplocation

text

[pt] Local de retirada do pedido

order_app_id

float

[pt] Identificador do aplicativo do pedido

order_billing_address

text

[pt] Endereço de cobrança

order_cart_additional_values_discount

float

[pt] Desconto adicional do carrinho em R$ (BRL)

order_cart_additional_values_increase

float

[pt] Acréscimo adicional do carrinho em R$ (BRL)

order_client_ip

text

[pt] IP do cliente

order_cost

float

[pt] Custo do pedido em R$ (BRL)

order_customer_note

text

[pt] Observação do cliente

order_date

date

[pt] Data do pedido (ISO-8601)

order_delivered

float

[pt] Indicador (0/1) de pedido entregue

order_delivered_status

text

[pt] Status de entrega

order_delivery_date

text

[pt] Data de entrega

order_delivery_time

float

[pt] Prazo de entrega

order_hour

text

[pt] Hora do pedido

order_installment

float

[pt] Número de parcelas

order_interest

float

[pt] Juros do pedido em R$ (BRL)

order_modified

timestamp

[pt] Data de modificação do pedido (ISO-8601)

order_partner_id

text

[pt] Identificador do parceiro

order_partner_name

text

[pt] Nome do parceiro

order_sending_date

date

[pt] Data de envio (ISO-8601)

order_shipping_cancelled

text

[pt] Envio cancelado

order_store_segment

text

[pt] Segmento da loja

order_tracking_url

text

[pt] URL de rastreamento

order_urls

text

[pt] URLs do pedido

paymentmethodmessage_confirmation

float

[pt] Indicador (0/1) de confirmação da mensagem do meio de pagamento

paymentmethodmessage_text

text

[pt] Texto da mensagem do meio de pagamento

paymentmethodmessage_text_confirm

text

[pt] Texto de confirmação da mensagem do meio de pagamento

paymentmethodmessage_text_pag

text

[pt] Texto de pagamento da mensagem do meio de pagamento

order_customer_id

text

[pt] Código do cliente

    Clientes > > id

order_status

text

[pt] Status do pedido

order_orderstatus_id

text

[pt] Código do status do pedido

    Status de pedidos > > id

order_total

float

[pt] Total do pedido

order_partial_total

float

[pt] Valor parcial do pedido (produtos)

order_discount

float

[pt] Desconto do pedido

order_shipment_value

float

[pt] Valor do frete

order_original_shipment_value

float

[pt] Valor original do frete (antes de descontos)

order_shipment

text

[pt] Forma de envio

order_taxes

float

[pt] Taxas do pedido

order_payment_method

text

[pt] Forma de pagamento

order_payment_method_id

text

[pt] Código da forma de pagamento

order_payment_method_type

text

[pt] Tipo da forma de pagamento

order_interest_paid_by

text

[pt] Quem paga os juros do parcelamento

order_coupon_code

text

[pt] Código do cupom usado

order_coupon_discount

float

[pt] Desconto do cupom

order_coupon_type

text

[pt] Tipo do desconto do cupom

customer_name

text

[pt] Nome do cliente

customer_email

text

[pt] E-mail do cliente

customer_phone

text

[pt] Telefone fixo do cliente

customer_cellphone

text

[pt] Celular do cliente

customer_cpf

text

[pt] CPF do cliente

customer_cnpj

text

[pt] CNPJ do cliente

customer_company_name

text

[pt] Razão social do cliente

customer_type

text

[pt] Tipo de cadastro do cliente: 0 = pessoa física, 1 = pessoa jurídica

customer_gender

text

[pt] Sexo do cliente: 0 = masculino, 1 = feminino

customer_birth_date

date

[pt] Data de nascimento do cliente

customer_city

text

[pt] Cidade do cliente

customer_state

text

[pt] UF do cliente

customer_zip_code

text

[pt] CEP do cliente

Pedidos: informações adicionais dos produtos

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Relacionamentos:

Sub-tabela dos detalhes do pedido: informações adicionais dos produtos do pedido, com um registro por produto/variação, trazendo o código e o nome do produto, o código da variação e a informação adicional associada.

Campo Tipo

order_id

float

[pt] Código do pedido

    Pedidos > > id

additionalproductinfo_information

text

[pt] Informação adicional do produto

additionalproductinfo_product_id

float

[pt] Código do produto

additionalproductinfo_product_name

text

[pt] Nome do produto

additionalproductinfo_variant_id

float

[pt] Código da variação

Pedidos: notas fiscais

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Relacionamentos:

Sub-tabela dos detalhes do pedido: dados de nota fiscal do pedido, com um registro por nota vinculado ao pedido pelo código do pedido, trazendo as informações da nota fiscal e o CFOP dos produtos.

Campo Tipo

order_id

float

[pt] Código do pedido

    Pedidos > > id

orderinvoice_orderinvoice

text

[pt] Informações da nota fiscal

orderinvoice_productcfop

text

[pt] CFOP dos produtos

orderinvoice_id

text

[pt] Código da nota fiscal

orderinvoice_number

text

[pt] Número da nota fiscal

orderinvoice_serie

text

[pt] Série da nota fiscal

orderinvoice_key

text

[pt] Chave de acesso da nota fiscal

orderinvoice_issue_date

date

[pt] Data de emissão da nota fiscal

orderinvoice_value

float

[pt] Valor da nota fiscal

orderinvoice_link

text

[pt] Link da nota fiscal

orderinvoice_xml_danfe

text

[pt] Link do XML/DANFE da nota fiscal

Pedidos: detalhes: mercado livre

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Relacionamentos:

Sub-tabela dos detalhes do pedido: dados do pedido correspondente no Mercado Livre, com um registro por pedido vinculado ao pedido pelo código do pedido. Traz códigos e datas da venda no Mercado Livre, item anúnciado e quantidade, dados de envio (Mercado Envios, tipo logístico, status e substatus do frete, código de rastreio) e identificação do comprador.

Campo Tipo

order_id

float

[pt] Identificador do pedido na Tray

    Pedidos > > id

mlorder_cliente_id

float

[pt] ID do cliente na Tray

mlorder_codigo

float

[pt] Código da venda no Mercado Livre

mlorder_created

timestamp

[pt] Data da criação do pedido na Tray

mlorder_date_delivered

text

[pt] Data quando foi entregue o pedido.

mlorder_estimated_delivery_time

date

[pt] Estimativa de entrega

mlorder_estimated_handling_limit

date

[pt] Data-limite para o vendedor encaminhar

mlorder_id

float

[pt] Id do pedido no MLorders - Controle Tray

mlorder_invoice_data_id

float

[pt] ID da nota fiscal no ML.

mlorder_item_id

text

[pt] Anúncio do Mercado Livre comprado

mlorder_item_quantity

float

[pt] Quantidade do anúncio que foi comprado

mlorder_item_title

text

[pt] Nome do produto comprado

mlorder_logistic_type

text

[pt] Tipo de logistica do envio. Dado com base na API do ML

mlorder_mercado_envio

text

[pt] Tipo de envio da venda.

mlorder_messages_locked_by

text

[pt] Campo interno Tray. É utilizado pra controlar qual usuario ta enviando mensagens nesse pedido no momento, para que outro usuario não tente mandar ao mesmo tempo

mlorder_ml_coleta

float

[pt] Se é um serviço de coleta do ML (0 ou 1)

mlorder_ml_collect

float

[pt] Se é um serviço de coleta do ML (0 ou 1)

mlorder_nickname

text

[pt] Nome do apelido que teve venda

mlorder_pack_id

text

[pt] ID do carrinho, quando ocorre venda de mais de 1 produto.

mlorder_pedido_id

float

[pt] ID do pedido na Tray

mlorder_pickup_id

text

[pt] ID do pickup quando existente

mlorder_romaneio_id

float

[pt] Identificador do romaneio

mlorder_service_id

float

[pt] Identificação do ID de serviço no ML.

mlorder_shipment_id

float

[pt] Código que identifica o envio no ML

mlorder_shipping_mode

text

[pt] Tipo de entrega no ML

mlorder_shipping_option_id

float

[pt] Id do shipments option da API do ML

mlorder_shipping_status

text

[pt] Status do shipments no ML

mlorder_shipping_substatus

text

[pt] Substatus do shipments no ML

mlorder_status_frete_ml

text

[pt] Status do shipments no ML

mlorder_substatus_frete_ml

text

[pt] Substatus do shipments no ML

mlorder_updated

timestamp

[pt] Data da ultima atualização do pedido

mlorder_user_id

float

[pt] ID do apelido que teve venda

Pedidos: transações

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Relacionamentos:

Sub-tabela dos detalhes do pedido: transações de pagamento do pedido, com um registro por transação vinculada ao pedido pelo código do pedido, trazendo o código da transação, a URL de pagamento e o boleto bancário.

Campo Tipo

order_id

float

[pt] Código do pedido

    Pedidos > > id

ordertransactions_bank_slip

text

[pt] Boleto bancário

ordertransactions_transaction_id

float

[pt] Código da transação

ordertransactions_url_payment

text

[pt] URL de pagamento

ordertransactions_account_id

text

[pt] Código da conta do gateway de pagamento

Pagamentos

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): Selecione a data inicial de leitura dos dados

Relacionamentos:

Pagamentos dos pedidos, com um registro por pagamento vinculado ao pedido pelo código do pedido. Traz o meio de pagamento, local de pagamento, valor pago, observações e datas de criação, pagamento e modificação.

Campo Tipo

payment_id

float

[pt] Código do pagamento

payment_order_id

float

[pt] Código do pedido

    Pedidos > > id

payment_created

timestamp

[pt] Data de criação

payment_date

date

[pt] Data do pagamento

payment_modified

timestamp

[pt] Data de modificação

payment_note

text

[pt] Informações adicionais do pagamento

payment_payment_method_id

float

[pt] Código do meio de pagamento

payment_payment_place

text

[pt] Local de pagamento

payment_value

float

[pt] Valor pago

Pedidos

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Relacionamentos:

Pedidos da loja, com um registro por pedido. Traz dados do checkout como cliente, datas (pedido, pagamento, envio), forma e meio de pagamento, valores (total, desconto, frete, acréscimos, comissões), cupom aplicado, status do pedido e informações de entrega e emissão de nota.

Campo Tipo

id

text

[pt] Código do pedido

invoiceissuer__application

text

[pt] Aplicativo emissor de nota fiscal

invoiceissuer__url

text

[pt] URL do emissor de nota fiscal

orderstatus__allow_edit_order

float

[pt] Indicador (0/1) de permissão de edição do pedido

orderstatus__background

text

[pt] Cor de fundo associada ao status do pedido

orderstatus__default

float

[pt] Indicador (0/1) de status padrão do pedido

orderstatus__description

text

[pt] Descrição do status do pedido

orderstatus__id

float

[pt] Código do status do pedido

orderstatus__show_backoffice

float

[pt] Indicador (0/1) de exibição do status no backoffice

orderstatus__show_status_central

text

[pt] Indicador de exibição do status na central de status

orderstatus__status

text

[pt] Status do pedido

orderstatus__type

text

[pt] Tipo do status do pedido

access_code

text

[pt] Código de acesso

customer_id

text

[pt] Código do cliente

    Clientes > > id

date

date

[pt] Data do pedido

discount

float

[pt] Valor de desconto

discount_coupon

text

[pt] Código do cupom de desconto

estimated_delivery_date

date

[pt] Tempo estimado de entrega

external_code

text

[pt] Código externo do pedido

has_invoice

float

[pt] Indicador (0/1) de existência de nota fiscal

has_payment

float

[pt] Indicador (0/1) de existência de pagamento

has_shipment

float

[pt] Indicador (0/1) de existência de envio

id_quotation

text

[pt] Código externo de cotação de frete (Gateway de Frete)

is_traceable

text

[pt] É rastreavel

modified

timestamp

[pt] Data de Modificação

partial_total

float

[pt] Valor parcial do pedido

payment_date

date

[pt] Data de Pagamento

payment_form

text

[pt] Forma de pagamento do pedido

payment_method_rate

float

[pt] Taxa do meio de pagamento

point_sale

text

[pt] Ponto de venda

printed

text

[pt] Indicador de impressão do pedido

progressive_discount

float

[pt] Valor de desconto progressivo

sending_code

text

[pt] Código de Envio

session_id

text

[pt] Código da sessão

shipment

text

[pt] Forma de envio

shipment_date

date

[pt] Data de envio do pedido

shipment_integrator

text

[pt] Integrador de Envio

shipment_value

float

[pt] Valor de frete

shipping_progressive_discount

float

[pt] Valor de desconto progressivo sobre o frete

status

text

[pt] Status do pedido

store_note

text

[pt] Observação da loja sobre o pedido

taxes

float

[pt] Valor de acréscimo / taxa

total

float

[pt] Valor total do pedido

total_comission

float

[pt] Total de comissão

total_comission_user

float

[pt] Comissão por usuario

value_1

float

[pt] Valor

interest

float

[pt] Juros do pedido

cart_additional_values_discount

float

[pt] Desconto de valores adicionais do carrinho

cart_additional_values_increase

float

[pt] Acréscimo de valores adicionais do carrinho

tracking_url

text

[pt] URL de rastreamento

coupon_code

text

[pt] Código do cupom usado

coupon_discount

float

[pt] Desconto do cupom

orderstatus__display_name

text

[pt] Nome de exibição do status do pedido

orderstatus__font_color

text

[pt] Cor da fonte do status do pedido

shippinglabel__application

text

[pt] Aplicativo emissor da etiqueta de envio

shippinglabel__url

text

[pt] URL da etiqueta de envio

Produtos

Tipo de replicacao: Integral

Objeto principal

Catálogo de produtos da loja, com um registro por produto. Traz nome, marca, categoria principal e relacionadas, referência, EAN, NCM, preços (de custo, de venda, mínimo e promocional) com período de promoção, estoque e estoque mínimo, quantidade vendida, avaliações, dimensões/peso, disponibilidade e situação (ativo, frete grátis, produto virtual, kit, possui variação), URLs, datas de criação, modificação, ativação e desativação.

Campo Tipo

id

text

[pt] Código da variação do produto

activation_date

date

[pt] Data de ativação do produto

additional_button

float

[pt] Botão adicional do produto

all_categories

text

[pt] Todas as categorias do produto

availability

text

[pt] Disponibilidade do produto

available

float

[pt] Produto disponível (Veja Tabela A)

available_for_purchase

float

[pt] Produto disponível para compra

available_in_store

float

[pt] Indicador (0/1) de produto disponível na loja física

brand

text

[pt] Marca do produto

brand_id

text

[pt] Código da marca do produto

category_id

text

[pt] Código da categoria principal do produto

cost_price

float

[pt] Preço de custo do produto

count_rating

float

[pt] Valor da classificação do produto

created

timestamp

[pt] Data de criação do produto

deactivation_date

date

[pt] Data de desativação do produto

deactivation_status_history

text

[pt] Histórico de status de desativação do produto

dollar_cost_price

float

[pt] Preço de custo do produto em dollar

ean

text

[pt] Código EAN do produto

end_promotion

date

[pt] Data de termino da promoção do produto

free_shipping

float

[pt] Produto com frete grátis (Veja Tabela C)

has_variation

float

[pt] Produto com variação (Veja Tabela F)

height

float

[pt] Altura do produto

hot

float

[pt] Produto em destaque (Veja Tabela E)

id_campaign

text

[pt] Código da campanha

is_kit

float

[pt] O produto possui kit

kit_has_variation

float

[pt] Indicador (0/1) de kit com variação

length

float

[pt] Comprimento do produto

minimum_price

float

[pt] Preço mínimo

minimum_stock

float

[pt] Estoque mínimo do produto

minimum_stock_alert

float

[pt] Aviso de estoque mínimo do produto

model

text

[pt] Modelo do produto

modified

timestamp

[pt] Data de modificação do produto

name

text

[pt] Nome do produto

ncm

text

[pt] Código NCM do produto

payment_option

text

[pt] Detalhes/Opções de pagamento do produto

payment_option_html

text

[pt] HTML das opções de pagamento

price

float

[pt] Preço do produto

promotional_minimum_price

float

[pt] Preço promocional mínimo

promotional_price

float

[pt] Preço promocional do produto

quantity_sold

float

[pt] Quantidade vendida do produto

rating

float

[pt] Classificação do produto

reference

text

[pt] Referência do produto

related_categories

text

[pt] Categorias adicionais do produto

release

float

[pt] Produto lançamento (Veja Tabela D)

release_date

text

[pt] Data de lançamento do produto

shortcut

text

[pt] Atalho do produto

slug

text

[pt] Final da url do produto

start_promotion

date

[pt] Data de início da promoção do produto

stock

float

[pt] Estoque do produto

upon_request

float

[pt] Produto sob consulta

url_http

text

[pt] URL do produto

url_https

text

[pt] URL segura do produto

variant_without_price

float

[pt] Indicador (0/1) de variação sem preço

variant_without_promotional_price

float

[pt] Indicador (0/1) de variação sem preço promocional

video

text

[pt] Vídeo do produto

virtual_product

text

[pt] Produto virtual (Veja Tabela I)

weight

float

[pt] Peso do produto

width

float

[pt] Largura do produto

productsettings_when_stock_runs_out

text

[pt] Comportamento quando o estoque acaba

productsettings_order_days_availability

float

[pt] Prazo de disponibilidade para encomenda (dias)

tray_products_payment_option_details

Sub-tabela de produtos: condições de pagamento disponíveis para cada produto, com um registro por opção vinculada ao produto pelo código do produto, trazendo o tipo e o nome de exibição do meio de pagamento, número de parcelas, taxa e valor.

Campo Tipo

product_id

text

[pt] Código da variação do produto

payment_option_details_display_name

text

[pt] Nome de exibição da opção de pagamento

payment_option_details_plots

float

[pt] Número de parcelas da opção de pagamento

payment_option_details_tax

float

[pt] Taxa da opção de pagamento

payment_option_details_type

text

[pt] Tipo da opção de pagamento

payment_option_details_value

float

[pt] Valor da opção de pagamento

tray_products_ProductImage

Sub-tabela de produtos: imagens de cada produto, com um registro por imagem vinculada ao produto pelo código do produto, trazendo a URL da imagem e as URLs das miniaturas em diferentes tamanhos.

Campo Tipo

product_id

text

[pt] Código da variação do produto

productimage_https

text

[pt] URL segura da imagem do produto

productimage_thumbs_180_https

text

[pt] URL segura da miniatura do produto (180px)

productimage_thumbs_30_https

text

[pt] URL segura da miniatura do produto (30px)

productimage_thumbs_90_https

text

[pt] URL segura da miniatura do produto (90px)

tray_products_metatag

Sub-tabela de produtos: metatags de SEO de cada produto, com um registro por metatag vinculada ao produto pelo código do produto, trazendo o tipo e o conteúdo da metatag.

Campo Tipo

product_id

text

[pt] Código da variação do produto

metatag_content

text

[pt] Conteúdo da metatag

metatag_type

text

[pt] Tipo da metatag

tray_products_properties

Sub-tabela de produtos: propriedades/características de cada produto, com um registro por propriedade vinculada ao produto pelo código do produto, trazendo o nome e o valor da propriedade.

Campo Tipo

product_id

text

[pt] Código da variação do produto

propriedades_nome

text

[pt] Nome da propriedade

propriedades_valor

text

[pt] Valor da propriedade

Produtos (Kits)

Tipo de replicacao: Integral

Relacionamentos:

Objeto principal

Kits de produtos, com um registro por kit. Traz o produto que representa o kit, marca, garantia, disponibilidade em dias, quantidade, tipo e valor de desconto, regra de preço e valor do kit.

Campo Tipo

productkit_product_id

float

[pt] Será o id do produto que irá compor o kit

    Produtos vendidos > > id

productkit_id

float

[pt] id do kit

productkit_availability_days

float

[pt] Disponbilidade em dias do kit

productkit_brand

text

[pt] Marca

productkit_discount_type

text

[pt] Valor do desconto em reais ou percentual

productkit_discount_value

float

[pt] Valor de desconto do kit

productkit_price

float

[pt] Valor do kit

productkit_price_rule

float

[pt] Valor do produto

productkit_product_parent_id

float

[pt] Será o id do produto principal, que irá compor o kit

productkit_quantity

float

[pt] Quantidade

productkit_warranty

text

[pt] Dados da garantia do kit

tray_products_kits__productvariantkit

Sub-tabela de kits de produtos: variações que compõem cada kit, com um registro por variação vinculada ao kit pelo seu código, trazendo o código da variação e o preço.

Campo Tipo

productvariantkit_product_kit_id

float

[pt] Id do kit ao qual a variação está vinculada

productvariantkit_price

float

[pt] Preço da variação no kit (valor em R$ (BRL))

productvariantkit_variant_id

float

[pt] Código da variação que compõe o kit

Produtos: variantes

Tipo de replicacao: Integral

Relacionamentos:

Variações de produtos (SKUs), com um registro por variação vinculada ao produto pelo código do produto. Traz SKU, referência, EAN, atributos de cor, estoque e estoque mínimo, quantidade vendida, preços (de custo, de venda e promocional) com período de promoção, dimensões/peso, disponibilidade, opções de pagamento e imagem ilustrativa.

Campo Tipo

variant_id

float

[pt] Código da variação

    Produtos vendidos > > variant_id

variant_sku

text

[pt] SKU da variação

variant_available

float

[pt] Indicador (0/1) de variação disponível

variant_color_id_1

float

[pt] Código da cor primária da variação

variant_color_id_2

float

[pt] Código da cor secundaria da variação

variant_cost_price

float

[pt] Preço da variação de custo da variação

variant_cubic_weight

float

[pt] Peso cubico da variação

variant_dollar_cost_price

float

[pt] Preço de custo da variação em dólar

variant_ean

text

[pt] Código EAN da variação

variant_end_promotion

text

[pt] Data de termino de promoção da variação

variant_height

float

[pt] Altura da variação

variant_illustrative_image

text

[pt] Imagem ilustrativa da variação

variant_length

float

[pt] Comprimento da variação

variant_minimum_stock

float

[pt] Estoque mínimo da variação

variant_order

float

[pt] Ordem da visualização da variação

variant_payment_option

text

[pt] Detalhes/Opções de pagamento da variação

variant_payment_option_html

text

[pt] Opções de pagamento da variação em HTML

variant_price

float

[pt] Preço da variação

variant_product_id

float

[pt] Código

variant_promotional_price

float

[pt] Preço promocional da variação

variant_quantity_sold

float

[pt] Quantidade vendida da variação

variant_reference

text

[pt] Referência da variação

variant_start_promotion

text

[pt] Data de início de promoção da variação

variant_stock

float

[pt] Estoque da variação

variant_url

text

[pt] URL da variação

variant_weight

float

[pt] Peso da variação

variant_width

float

[pt] Largura da variação

variant_availability

text

[pt] Disponibilidade da variação

variant_availability_days

float

[pt] Prazo de disponibilidade (dias)

variant_when_stock_runs_out

text

[pt] Comportamento quando o estoque acaba

variant_order_days_availability

float

[pt] Prazo de disponibilidade para encomenda (dias)

Produtos vendidos

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os produtos serão lidos

Relacionamentos:

Itens vendidos nos pedidos, com um registro por produto/variante de cada pedido (relacionado ao pedido pelo código do pedido). Contém produto, variação, nome, marca, modelo, referência, NCM, quantidade vendida, preços (original, de venda e de custo), comissão e dimensões/peso do item.

Campo Tipo

order_id

text

[pt] Código do pedido

    Pedidos > > id

additional_information

text

[pt] Informações adicionais

brand

text

[pt] Marca

comissao

float

[pt] Comissão (valor em R$ (BRL))

cost_price

float

[pt] Preço de custo (valor em R$ (BRL))

height

float

[pt] Altura do item

id

text

[pt] Código do produto vendido

id_campaign

text

[pt] Código da campanha

included_items

text

[pt] Itens incluídos

length

float

[pt] Comprimento do item

model

text

[pt] Modelo

name

text

[pt] Nome do produto

ncm

text

[pt] Código NCM

original_price

float

[pt] Valor original

price

float

[pt] Valor de venda

product_id

text

[pt] Código do produto

    Produtos > > id

product_kit_id

text

[pt] Código do kit do produto

product_kit_id_kit

text

[pt] Código do kit

quantity

float

[pt] Quantidade vendida

reference

text

[pt] Código de referência

release_date

text

[pt] Data de lançamento (ISO-8601)

stock_id

text

[pt] Código do estoque

text_variant

text

[pt] Variação (texto)

variant_id

text

[pt] Código da variação

warranty

text

[pt] Garantia

weight

float

[pt] Peso do item

weight_cubic

float

[pt] Peso cúbico do item

width

float

[pt] Largura do item

Atributos de clientes

Tipo de replicacao: Integral

Relacionamentos:

Objeto principal

Atributos personalizados de cadastro de cliente, um registro por atributo (os valores de cada cliente estão na integração Customers).

Campo Tipo

id

text

[pt] Código do atributo

description

text

[pt] Nome do atributo

type

text

[pt] Tipo do campo do atributo

person_type

text

[pt] Tipo de pessoa ao qual o atributo se aplica

required

text

[pt] Indicador (0/1) de preenchimento obrigatório

enabled

text

[pt] Indicador (0/1) de atributo ativo

tray_customers_attributes__options

Sub-tabela de atributos de cliente: opções de resposta de cada atributo, um registro por opção.

Campo Tipo

attribute_id

text

[pt] Código do atributo

    Atributos de clientes > > id

id

text

[pt] Código da opção

name

text

[pt] Opção

display_order

float

[pt] Ordem de exibição

Avaliações de produtos

Tipo de replicacao: Integral

Relacionamentos:

Avaliações (comentários e notas) de produtos feitas pelos clientes, um registro por avaliação.

Campo Tipo

id

text

[pt] Código da avaliação

product_id

text

[pt] Código do produto

    Produtos > > id

customer_id

text

[pt] Código do cliente

    Clientes > > id

order_id

text

[pt] Código do pedido

    Pedidos > > id

date

timestamp

[pt] Data e hora da avaliação

rating

float

[pt] Nota dada ao produto

title

text

[pt] Título da avaliação

comment

text

[pt] Comentário

status

text

[pt] Indicador (0/1) de avaliação aprovada

show_email

text

[pt] Indicador (0/1) de exibição do e-mail do autor

Características de produtos

Tipo de replicacao: Integral

Relacionamentos:

Objeto principal

Características de produto cadastradas na loja (ex.: cor, material), um registro por característica.

Campo Tipo

id

text

[pt] Código da característica

name

text

[pt] Nome da característica

position

float

[pt] Posição de exibição

display

text

[pt] Indicador (0/1) de exibição na loja

active_display

text

[pt] Indicador (0/1) de exibição ativa

has_product

text

[pt] Indicador (0/1) de característica usada em produtos

tray_properties__values

Sub-tabela de características: valores possíveis de cada característica, um registro por valor.

Campo Tipo

property_id

text

[pt] Código da característica

    Características de produtos > > id

id

text

[pt] Código do valor

name

text

[pt] Valor

image_https

text

[pt] Imagem do valor (https)

Carrinhos (inclui abandonados)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualização (dias): Quantos dias antes do último savepoint os carrinhos continuam sendo relidos a cada execução, porque itens entram e saem do carrinho depois que ele é criado
  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os registros serão lidos na primeira carga

Relacionamentos:

Objeto principal

Carrinhos da loja (inclui carrinhos abandonados), um registro por carrinho. A Tray só mantém carrinhos recentes; carrinhos convertidos em pedido ou expirados deixam de ser atualizados.

Campo Tipo

session_id

text

[pt] Sessão do carrinho (identificador do carrinho)

customer_id

text

[pt] Código do cliente (0 quando o visitante não se identificou)

    Clientes > > id

email

text

[pt] E-mail informado no carrinho

date_time

timestamp

[pt] Data e hora do carrinho

date

date

[pt] Data do carrinho

sub_total

float

[pt] Subtotal dos produtos

total

float

[pt] Total do carrinho

coupon_discount

float

[pt] Desconto de cupom

order_discount

float

[pt] Desconto do pedido

progressive_discount

float

[pt] Desconto progressivo

shipping_progressive_discount

float

[pt] Desconto progressivo de frete

cart_additional_values_total

float

[pt] Total de valores adicionais

shipping_name

text

[pt] Forma de envio escolhida

shipping_price

float

[pt] Valor do frete escolhido

shipping_zip_code

text

[pt] CEP usado na cotação do frete

partner_id

text

[pt] Código do parceiro

    Parceiros > > id

partner_name

text

[pt] Nome do parceiro

point_sale

text

[pt] Ponto de venda

previous_url

text

[pt] Última página visitada antes do carrinho

tray_carts__products

Sub-tabela de carrinhos: produtos de cada carrinho, um registro por item.

Campo Tipo

session_id

text

[pt] Sessão do carrinho

    Carrinhos (inclui abandonados) > > session_id

id_item

text

[pt] Código do item no carrinho

product_id

text

[pt] Código do produto

    Produtos > > id

variant_id

text

[pt] Código da variação

name

text

[pt] Nome do produto

reference

text

[pt] Referência do produto

ean

text

[pt] EAN do produto

brand

text

[pt] Marca do produto

quantity

float

[pt] Quantidade

price

float

[pt] Preço unitário

sub_total

float

[pt] Subtotal do item

text_variant

text

[pt] Descrição da variação

date

timestamp

[pt] Data e hora em que o item entrou no carrinho

Categorias

Tipo de replicacao: Integral

Relacionamentos:

Categorias de produtos da loja, um registro por categoria (a hierarquia vem em parent_id).

Campo Tipo

id

text

[pt] Código da categoria

parent_id

text

[pt] Código da categoria pai (0 = categoria raiz)

    Categorias > > id

name

text

[pt] Nome da categoria

small_description

text

[pt] Descrição curta

description

text

[pt] Descrição

display_order

float

[pt] Ordem de exibição

active

text

[pt] Indicador (0/1) de categoria ativa

has_product

text

[pt] Indicador (0/1) de categoria com produtos

Clientes (detalhes)

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os registros serão lidos na primeira carga

Relacionamentos:

Cadastro completo de cada cliente (consulta individual por cliente), com telefone, celular, documentos, endereço principal e totais de compra. Um registro por cliente; só clientes criados ou alterados desde a última execução são consultados.

Campo Tipo

id

text

[pt] Código do cliente

    Clientes > > id

name

text

[pt] Nome do cliente

nickname

text

[pt] Apelido do cliente

email

text

[pt] E-mail do cliente

phone

text

[pt] Telefone fixo do cliente, como cadastrado na loja

cellphone

text

[pt] Celular do cliente, como cadastrado na loja

cpf

text

[pt] CPF do cliente (pessoa física)

cnpj

text

[pt] CNPJ do cliente (pessoa jurídica)

rg

text

[pt] RG do cliente

company_name

text

[pt] Razão social (pessoa jurídica)

state_inscription

text

[pt] Inscrição estadual (pessoa jurídica)

type

text

[pt] Tipo de cadastro do cliente: 0 = pessoa física, 1 = pessoa jurídica

gender

text

[pt] Sexo do cliente: 0 = masculino, 1 = feminino

birth_date

date

[pt] Data de nascimento

address

text

[pt] Endereço principal do cadastro (logradouro)

number

text

[pt] Número do endereço principal

complement

text

[pt] Complemento do endereço principal

neighborhood

text

[pt] Bairro do endereço principal

city

text

[pt] Cidade do endereço principal

state

text

[pt] UF do endereço principal

zip_code

text

[pt] CEP do endereço principal

country

text

[pt] País do endereço principal

blocked

text

[pt] Indicador (0/1) de cliente bloqueado

reseller

text

[pt] Indicador de cliente revendedor

credit_limit

float

[pt] Limite de crédito do cliente

discount

float

[pt] Desconto do cliente (%)

newsletter

text

[pt] Indicador (0/1) de inscrição na newsletter

profile_customer_id

text

[pt] Código do perfil do cliente

    Perfis de clientes > > id

profile_name

text

[pt] Nome do perfil do cliente

profile_approves_registration

text

[pt] Indicador (0/1) de aprovação de cadastro do perfil

indicator_id

text

[pt] Código do cliente que indicou este cliente

observation

text

[pt] Observação do cadastro

count_orders

float

[pt] Quantidade de pedidos do cliente

total_orders

float

[pt] Valor total dos pedidos do cliente

last_purchase

date

[pt] Data da última compra

last_visit

date

[pt] Data da última visita

last_sending_newsletter

date

[pt] Data do último envio de newsletter

terms

timestamp

[pt] Data e hora de aceite dos termos da loja

is_foreign

text

[pt] Indicador (0/1) de cliente estrangeiro

registration_date

date

[pt] Data de cadastro

created

timestamp

[pt] Data e hora de criação do registro

modified

timestamp

[pt] Data e hora da última modificação

last_modification

timestamp

[pt] Data e hora da última alteração cadastral feita pelo cliente

Clientes (detalhes: endereços)

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de alteração os registros serão lidos na primeira carga

Relacionamentos:

Endereços cadastrados de cada cliente (cobrança e entrega), um registro por endereço. Só clientes criados ou alterados desde a última execução são consultados.

Campo Tipo

customer_id

text

[pt] Código do cliente

    Clientes > > id

id

text

[pt] Código do endereço

description

text

[pt] Descrição do endereço

recipient

text

[pt] Destinatário

address

text

[pt] Logradouro

number

text

[pt] Número

complement

text

[pt] Complemento

neighborhood

text

[pt] Bairro

city

text

[pt] Cidade

state

text

[pt] UF

zip_code

text

[pt] CEP

country

text

[pt] País

type

text

[pt] Tipo do endereço: 0 = cobrança, 1 = entrega

type_delivery

text

[pt] Indicador (0/1) de endereço de entrega

active

text

[pt] Indicador (0/1) de endereço ativo

not_list

text

[pt] Indicador (0/1) de endereço oculto na listagem do cliente

Dados da loja

Tipo de replicacao: Integral

Dados cadastrais da loja (um único registro).

Campo Tipo

id

text

[pt] Código da loja

name

text

[pt] Nome da loja

title

text

[pt] Título da loja

company_name

text

[pt] Razão social

cnpj

text

[pt] CNPJ

cpf

text

[pt] CPF (loja de pessoa física)

register_type

text

[pt] Tipo de cadastro da loja

responsible_name

text

[pt] Nome do responsável

email_1

text

[pt] E-mail principal

email_2

text

[pt] E-mail secundário

phone_number_1

text

[pt] Telefone 1

phone_number_2

text

[pt] Telefone 2

phone_number_3

text

[pt] Telefone 3

address

text

[pt] Endereço

number

text

[pt] Número

complement

text

[pt] Complemento

neighborhood

text

[pt] Bairro

city

text

[pt] Cidade

state

text

[pt] UF

postal_code

text

[pt] CEP

country

text

[pt] País

uri

text

[pt] Endereço da loja

secure_uri

text

[pt] Endereço seguro da loja

coin

text

[pt] Moeda

contract

text

[pt] Plano contratado

internal_status

text

[pt] Situação da loja na Tray

acquisition_channel

text

[pt] Canal de aquisição

office_hour

text

[pt] Horário de atendimento

logo_https

text

[pt] Logotipo (https)

Estoques (MultiCD)

Tipo de replicacao: Integral

Estoques (centros de distribuição do MultiCD) da loja, um registro por estoque.

Campo Tipo

id

text

[pt] Código do estoque

name

text

[pt] Nome do estoque

key

text

[pt] Chave do estoque

remove_stock

text

[pt] Indicador (0/1) de baixa de estoque nas vendas

Formas de envio

Tipo de replicacao: Integral

Formas de envio (frete) configuradas na loja, um registro por forma de envio.

Campo Tipo

id

text

[pt] Código da forma de envio

name

text

[pt] Nome da forma de envio

display_name

text

[pt] Nome exibido ao cliente

identifier

text

[pt] Identificador da forma de envio

gateway

text

[pt] Integrador/gateway de frete

cod

text

[pt] Código de serviço da forma de envio

status

text

[pt] Indicador (0/1) de forma de envio ativa

Marcas

Tipo de replicacao: Integral

Marcas cadastradas na loja, um registro por marca.

Campo Tipo

id

text

[pt] Código da marca

brand

text

[pt] Nome da marca

slug

text

[pt] Identificador da marca na URL

Parceiros

Tipo de replicacao: Integral

Parceiros (afiliados) cadastrados na loja, um registro por parceiro.

Campo Tipo

id

text

[pt] Código do parceiro

name

text

[pt] Nome do parceiro

site

text

[pt] Site do parceiro

commission

float

[pt] Comissão do parceiro (%)

Perfis de clientes

Tipo de replicacao: Integral

Perfis de cliente (grupos, ex.: atacado/varejo) configurados na loja, um registro por perfil.

Campo Tipo

id

text

[pt] Código do perfil

name

text

[pt] Nome do perfil

status

text

[pt] Indicador (0/1) de perfil ativo

approves_registration

text

[pt] Indicador (0/1) de cadastro sujeito a aprovação

show_price

text

[pt] Indicador (0/1) de exibição de preço

payment_shipping_status

text

[pt] Indicador (0/1) de regras próprias de pagamento e frete

price_list_id

text

[pt] Código da lista de preço

price_list_name

text

[pt] Nome da lista de preço

theme_id

text

[pt] Código do tema

Status de pedidos

Tipo de replicacao: Integral

Status de pedido configurados na loja, um registro por status.

Campo Tipo

id

text

[pt] Código do status

status

text

[pt] Nome do status

description

text

[pt] Descrição do status

type

text

[pt] Tipo do status (ex.: aberto, finalizado, cancelado)

is_default

text

[pt] Indicador (0/1) de status padrão da Tray

show_backoffice

text

[pt] Indicador (0/1) de exibição no painel

show_status_central

text

[pt] Indicador (0/1) de exibição na central do cliente

allow_edit_order

text

[pt] Indicador (0/1) de pedido editável neste status

allow_change

text

[pt] Indicador (0/1) de status alterável

background

text

[pt] Cor de fundo do status

font_color

text

[pt] Cor da fonte do status

Usuários da loja

Tipo de replicacao: Integral

Usuários do painel administrativo da loja, um registro por usuário. As permissões vêm em texto JSON.

Campo Tipo

id

text

[pt] Código do usuário

name

text

[pt] Login do usuário

full_name

text

[pt] Nome completo

email

text

[pt] E-mail do usuário

cpf

text

[pt] CPF do usuário

active

text

[pt] Indicador (0/1) de usuário ativo

main_user

text

[pt] Indicador (0/1) de usuário principal da loja

two_factor_enabled

text

[pt] Indicador (0/1) de autenticação em dois fatores

mcp_enabled

text

[pt] Indicador (0/1) de acesso MCP habilitado

last_login

timestamp

[pt] Data e hora do último acesso

password_update_date

timestamp

[pt] Data e hora da última troca de senha

permissions

text

[pt] Permissões do usuário por módulo (JSON)

Notas

  1. Este conector pode ser removido da plataforma da Kondado em breve. Saiba mais
  • Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Adicionar o conector da Tray na Kondado

Configure a replicacao de pedidos, produtos e clientes da sua loja Tray para o destino escolhido.

1
Gere as credenciais no painel da Tray

No painel administrativo da Tray, cadastre um app e obtenha Consumer Key, Consumer Secret e a URL da loja.

2
Adicione a fonte Tray na Kondado

Na Kondado, acesse 'Fontes' e adicione uma nova fonte Tray, informando Consumer Key, Consumer Secret e URL da loja.

3
Crie a integracao escolhendo o pipeline

Selecione um dos pipelines listados nesta pagina (pedidos, produtos, clientes, etc.) e defina o savepoint inicial.

4
Defina destino e frequencia

Escolha o destino e a frequencia de atualizacao.

5
Ative e valide

Ative a integracao e confirme no destino se as tabelas da Tray chegaram corretamente.

Perguntas frequentes

Quais credenciais preciso para conectar minha loja Tray?▼
O conector da Tray usa Consumer Key e Consumer Secret do app, alem da URL/loja. Voce gera essas credenciais no painel administrativo da Tray apos cadastrar um app na sua conta.
O conector Tray envia pedidos para outros sistemas?▼
Nao. A Kondado e uma plataforma ETL: o conector Tray extrai dados do ecommerce e replica para um destino analitico (Data Warehouse, BI, planilha). Nao e uma ferramenta de automacao app-to-app.
Quais dados da Tray posso replicar?▼
Voce pode extrair pedidos, produtos, clientes, transacoes, categorias, formas de pagamento e demais entidades expostas pela API da Tray, conforme os pipelines listados nesta pagina.
A replicacao da Tray e incremental ou completa?▼
Pedidos e produtos com timestamp de atualizacao sao replicados de forma incremental. Tabelas estruturais (como categorias) podem usar replicacao completa.
Para quais destinos posso enviar os dados da Tray?▼
Os dados podem ser replicados para Power BI, Looker Studio, Google Sheets, Excel, BigQuery, PostgreSQL, MySQL, SQL Server, Redshift, S3, Supabase e Neon. Veja a pagina de destinos.
Com que frequencia os dados da Tray sao atualizados?▼
A integracao roda na frequencia que voce escolher ao configurar o agendamento.

Escrito por·Publicado em 2021-03-23·Atualizado em 2026-04-26