Adicionando a fonte de dados
Método 1: Dev Dashboard (recomendado)
É o jeito mais simples: não precisa de conta no Shopify Partners, nem de URL de redirecionamento, nem de link de instalação. O app é criado a partir do admin da sua própria loja.
Requisitos: ser o dono da loja (Store Owner) ou um colaborador com permissão para desenvolver apps.
⚠️ Atenção: por este método a Shopify libera apenas os pedidos dos últimos 60 dias (o escopo read_all_orders não está disponível para apps criados pelo Dev Dashboard da loja). Produtos, clientes, estoque e demais objetos não têm esse limite. Se você precisa do histórico completo de pedidos, use o Método 2: Partner Dashboard.
- No admin da sua loja (admin.shopify.com), vá em Configurações > Apps > Desenvolver apps e clique em Build apps in Dev Dashboard.
- No Dev Dashboard, clique em Create app e dê um nome (ex: "Kondado").
- Em Scopes, cole a lista abaixo e clique em Release (duas vezes, para confirmar):
read_all_cart_transforms,read_analytics,read_app_proxy,read_assigned_fulfillment_orders,read_audit_events,read_cart_transforms,read_cash_tracking,read_channels,read_checkout_branding_settings,read_checkouts,read_companies,read_content,read_custom_fulfillment_services,read_custom_pixels,read_customer_data_erasure,read_customer_events,read_customer_merge,read_customers,read_delivery_customizations,read_delivery_option_generators,read_discounts,read_discovery,read_draft_orders,read_fulfillment_constraint_rules,read_fulfillments,read_gift_card_transactions,read_gift_cards,read_inventory,read_inventory_shipments,read_inventory_shipments_received_items,read_inventory_transfers,read_legal_policies,read_locales,read_marketing_events,read_marketing_integrated_campaigns,read_markets,read_markets_home,read_merchant_managed_fulfillment_orders,read_metaobject_definitions,read_metaobjects,read_online_store_navigation,read_online_store_pages,read_order_edits,read_orders,read_packing_slip_templates,read_payment_customizations,read_payment_terms,read_pixels,read_price_rules,read_privacy_settings,read_product_feeds,read_product_listings,read_products,read_publications,read_purchase_options,read_reports,read_resource_feedbacks,read_returns,read_script_tags,read_shipping,read_shopify_payments_accounts,read_shopify_payments_bank_accounts,read_shopify_payments_disputes,read_shopify_payments_payouts,read_shopify_payments_provider_accounts_sensitive,read_store_credit_account_transactions,read_store_credit_accounts,read_themes,read_third_party_fulfillment_orders,read_translations,read_validations - Na página do app, clique em Install app, escolha a sua loja e clique em Install.
- Em Settings, copie o Client ID e o Client secret.
- Na Kondado, acesse app.kondado.com.br/sources/new/96, escolha o método Dev Dashboard, informe o subdomínio da loja (ex:
minha-loja.myshopify.com), o Client ID e o Client secret e clique em Salvar.
⚠️ O Client secret é uma credencial sensível. Não compartilhe em canais públicos.
Método 2: Partner Dashboard (histórico completo de pedidos)
Use este método se você precisa dos pedidos com mais de 60 dias. Ele exige uma conta no Shopify Partners e a aprovação do escopo read_all_orders pela Shopify.
⚠️ Recomendação importante antes de começar
Se você possui acesso a mais de uma loja Shopify, recomendamos fortemente que todo o processo abaixo seja realizado em uma aba anônima / janela privada do navegador.
Isso evita que o Shopify utilize uma sessão já autenticada e acabe conectando a loja incorreta durante a criação do app ou no momento da autorização.
Requisitos
- Uma conta no Shopify Partners (gratuita)
- O usuário deve ser o dono da loja Shopify (Store Owner)
⚠️ Segurança: O Client Secret é uma credencial sensível. Não compartilhe em canais públicos.
Instruções
-
Crie uma conta no Shopify Partners
Acesse accounts.shopify.com/signup e crie sua conta. Durante o cadastro:
- Escolha "Criar novo Partner"
- Selecione o objetivo "Build Apps"
- Complete o cadastro com seus dados

-
Acesse o Dev Dashboard
Após verificar seu e-mail, no menu lateral clique em App distribution → All apps → View Dev Dashboard.

-
Crie um novo app
No Dev Dashboard, clique em Create app e defina um nome (ex: "Kondado Integration").

-
Configure Redirect URL, escopos e publique o app
No campo Redirect URLs, insira:
https://app.kondado.com.br/sources/new/96Em Access > Scopes, copie e cole os seguintes escopos:

Em seguida, clique em Release para publicar a versão.

-
Configure a distribuição do app
No menu lateral esquerdo, acesse a aba Distribution e selecione Custom distribution. Isso permite instalar o app em lojas específicas.


⚠️ Não está vendo a aba Distribution?
Isso acontece quando o app foi criado com a conta da sua loja (merchant) em vez de uma conta Shopify Partners. A aba Distribution só existe em apps criados dentro de uma organização Partner.
Como corrigir:
- Abra uma aba anônima / janela privada do navegador
- Crie uma conta gratuita no Shopify Partners (passo 1 acima)
- Acesse o Dev Dashboard pelo caminho: App distribution → All apps → View Dev Dashboard
- Crie o app novamente nesta sessão
Importante: O método de distribuição não pode ser alterado depois de escolhido. Se você já escolheu "Custom distribution", não pode trocar para outro método — é preciso criar um novo app do zero se precisar mudar.
-
Autorizar o app Shopify e instalar na loja
Após configurar a distribuição, você precisará inserir o domínio de sua loja para gerar o link de autorização de instalação.

Para obter o domínio de sua loja, acesse o painel administrativo em admin.shopify.com. Após fazer login, na página inicial (Home) você verá o domínio da sua loja. Copie esse domínio.
⚠️ Atenção ao formato do domínio:
Utilize somente o domínio no formato:
exemplo.myshopify.comNão inclua:
- Prefixos como
https://ouhttp:// - Caminhos adicionais ou parâmetros, como
/new_store,?param=...
Exemplos incorretos:
https://exemplo.myshopify.comexemplo.myshopify.com/new_store

Com o link gerado pelo Shopify, copie e cole no seu navegador para ser direcionado para instalação.

Agora escolha a loja para instalar o seu app.

Clique em Install.

- Prefixos como
-
Copie as credenciais do app
Volte ao Dev Dashboard, abra seu app e acesse Settings. Copie:
- Client ID
- Client Secret

-
Conecte na Kondado
Em app.kondado.com.br/sources/new/96, preencha:
- Client ID
- Client Secret
- Domínio da loja
Clique em Next e depois conecte com o Shopify.

Nota: A tela de autorização do Shopify pode aparecer novamente nesta etapa. Se isso acontecer, clique em Install para prosseguir.
-
Salve a conexão
Após a autorização, você será redirecionado para a Kondado. Clique em Salvar para finalizar.

Pipelines
Resumo
- Carrinhos abandonados
- Carrinhos abandonados: códigos de desconto
- Carrinhos abandonados: itens
- Carrinhos abandonados: observações personalizadas
- Clientes
- Estoque: itens
- Eventos
- Pedidos
- Pedidos: códigos de desconto
- Pedidos: descontos aplicados
- Pedidos: detalhes
- Pedidos: entregas
- Pedidos: fretes
- Pedidos: itens
- Pedidos: itens: propriedades personalizadas
- Pedidos: linha do tempo
- Pedidos: observações personalizadas
- Pedidos: reembolsos
- Pedidos: transações
- Pedidos: visitas: parâmetros UTM
- Produtos
- Produtos: imagens
- Produtos: opções
- Produtos: variantes
Diagrama de relacionamento
Clique para expandir
Carrinhos abandonados
- Esta integração requer no mínimo os seguintes escopos:
read_customersread_inventoryread_marketplace_ordersread_ordersread_products
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Checkouts abandonados representam carrinhos que os clientes iniciaram mas não finalizaram, ou seja, checkouts que não se converteram em pedidos. Cada registro contém o conteúdo do checkout, totais, moeda, dados do cliente e de endereço, além da URL de recuperação. Um checkout permanece abandonado enquanto completed_at estiver nulo; quando o cliente conclui a compra pela URL de recuperação, completed_at é preenchido.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] O identificador do checkout. |
|
|
text |
[pt] A URL de recuperação enviada ao cliente para que ele possa retomar e concluir o checkout abandonado. |
|
|
text |
[pt] O logradouro (rua e número) do endereço de cobrança. |
|
|
text |
[pt] Campo adicional opcional para o logradouro do endereço de cobrança (complemento). |
|
|
text |
[pt] A cidade do endereço de cobrança. |
|
|
text |
[pt] A empresa associada ao endereço de cobrança. |
|
|
text |
[pt] O nome do país do endereço de cobrança. |
|
|
text |
[pt] O código de duas letras do país do endereço de cobrança (formato ISO 3166-1 alpha-2). |
|
|
text |
[pt] O primeiro nome da pessoa associada ao meio de pagamento. |
|
|
text |
[pt] O sobrenome da pessoa associada ao meio de pagamento. |
|
|
float |
[pt] A latitude do endereço de cobrança. |
|
|
float |
[pt] A longitude do endereço de cobrança. |
|
|
text |
[pt] O nome completo da pessoa associada ao meio de pagamento. |
|
|
text |
[pt] O telefone do endereço de cobrança. |
|
|
text |
[pt] O nome do estado ou província do endereço de cobrança. |
|
|
text |
[pt] A abreviação de duas letras do estado ou província do endereço de cobrança. |
|
|
text |
[pt] O CEP ou código postal do endereço de cobrança. |
|
|
text |
[pt] O identificador do carrinho vinculado a este checkout. |
|
|
timestamp |
[pt] A data e hora (formato ISO 8601) em que o checkout foi concluído. Em checkouts abandonados, este valor permanece nulo até que o cliente conclua a compra pela URL de recuperação. |
|
|
timestamp |
[pt] A data e hora (formato ISO 8601) em que o checkout foi criado. |
|
|
text |
[pt] O código de três letras (formato ISO 4217) da moeda padrão da loja no momento do checkout. Para a moeda que o cliente utilizou no checkout, consulte presentment_currency. |
|
|
text |
[pt] O identificador global (GID) do cliente na API GraphQL. |
|
|
timestamp |
[pt] A data e hora (formato ISO 8601) em que o cadastro do cliente foi criado. |
|
|
text |
[pt] O nome do estado ou província do endereço padrão do cliente. |
|
|
text |
[pt] O logradouro (rua e número) do endereço padrão do cliente. |
|
|
text |
[pt] Campo adicional opcional para o logradouro do endereço padrão do cliente (complemento). |
|
|
text |
[pt] A cidade do endereço padrão do cliente. |
|
|
text |
[pt] A empresa associada ao endereço padrão do cliente. |
|
|
text |
[pt] O nome do país do endereço padrão do cliente. |
|
|
text |
[pt] O código de duas letras do país do endereço padrão do cliente (formato ISO 3166-1 alpha-2). |
|
|
text |
[pt] O nome normalizado do país do endereço padrão do cliente. |
|
|
text |
[pt] O identificador do cliente ao qual o endereço padrão pertence. |
|
|
text |
[pt] O primeiro nome da pessoa associada ao endereço padrão do cliente. |
|
|
text |
[pt] O identificador do endereço padrão do cliente. |
|
|
text |
[pt] O sobrenome da pessoa associada ao endereço padrão do cliente. |
|
|
text |
[pt] O nome completo da pessoa associada ao endereço padrão do cliente. |
|
|
text |
[pt] O telefone do endereço padrão do cliente. |
|
|
text |
[pt] A abreviação de duas letras do estado ou província do endereço padrão do cliente. |
|
|
text |
[pt] O CEP ou código postal do endereço padrão do cliente. |
|
|
text |
[pt] O endereço de e-mail do cliente. |
|
|
text |
[pt] O primeiro nome do cliente. |
|
|
text |
[pt] O identificador único do cliente. |
|
|
text |
[pt] O sobrenome do cliente. |
|
|
text |
[pt] O identificador do último pedido realizado pelo cliente. |
|
|
text |
[pt] O nome (número) do último pedido do cliente, diretamente relacionado ao campo name do pedido. |
|
|
text |
[pt] Um identificador único do cliente utilizado no login via Multipass. |
|
|
text |
[pt] Uma observação sobre o cliente. |
|
|
float |
[pt] A quantidade de pedidos associados a este cliente. Pedidos de teste e arquivados não são contabilizados. |
|
|
text |
[pt] O telefone único do cliente (formato E.164). |
|
|
text |
[pt] As informações de consentimento de marketing por SMS, indicando quando e de que forma o cliente autorizou o recebimento de mensagens promocionais. |
|
|
text |
[pt] A situação da conta do cliente na loja. Valores possíveis incluem: disabled (sem conta ativa), invited (convidado a criar uma conta), enabled (conta criada) e declined (recusou o convite para criar conta). |
|
|
text |
[pt] Marcadores (tags) que o lojista atribuiu ao cliente, no formato de uma lista de valores separados por vírgula. |
|
|
boolean |
[pt] Indica se o cliente é isento do pagamento de impostos em seus pedidos. |
|
|
text |
[pt] A lista de isenções fiscais específicas aplicáveis ao cliente (aplicável apenas a impostos canadenses). |
|
|
float |
[pt] O valor total gasto pelo cliente em todo o seu histórico de pedidos. |
|
|
timestamp |
[pt] A data e hora (formato ISO 8601) da última atualização das informações do cliente. |
|
|
boolean |
[pt] Indica se o cliente verificou seu endereço de e-mail. |
|
|
text |
[pt] O código de idioma de duas ou três letras, opcionalmente seguido por um modificador de região. Exemplos: en, en-CA, pt-BR. |
|
|
text |
[pt] Um identificador legível do checkout, exibido como um número precedido pelo símbolo #. |
|
|
text |
[pt] O texto de uma nota opcional que o lojista pode anexar ao checkout. |
|
|
text |
[pt] O código de três letras (formato ISO 4217) da moeda que o cliente utilizou no checkout. Para a moeda padrão da loja, consulte currency. |
|
|
text |
[pt] O logradouro (rua e número) do endereço de entrega. |
|
|
text |
[pt] Campo adicional opcional para o logradouro do endereço de entrega (complemento). |
|
|
text |
[pt] A cidade do endereço de entrega. |
|
|
text |
[pt] A empresa associada ao endereço de entrega. |
|
|
text |
[pt] O nome do país do endereço de entrega. |
|
|
text |
[pt] O código de duas letras do país do endereço de entrega (formato ISO 3166-1 alpha-2). |
|
|
text |
[pt] O primeiro nome da pessoa associada ao endereço de entrega. |
|
|
text |
[pt] O sobrenome da pessoa associada ao endereço de entrega. |
|
|
float |
[pt] A latitude do endereço de entrega. |
|
|
float |
[pt] A longitude do endereço de entrega. |
|
|
text |
[pt] O nome completo da pessoa associada ao endereço de entrega. |
|
|
text |
[pt] O telefone do endereço de entrega. |
|
|
text |
[pt] O nome do estado ou província do endereço de entrega. |
|
|
text |
[pt] A abreviação de duas letras do estado ou província do endereço de entrega. |
|
|
text |
[pt] O CEP ou código postal do endereço de entrega. |
|
|
float |
[pt] O valor do checkout (na moeda da loja) antes do frete e dos impostos. |
|
|
boolean |
[pt] Indica se os impostos já estão incluídos no preço. |
|
|
float |
[pt] O valor total dos descontos aplicados ao checkout, na moeda da loja. |
|
|
text |
[pt] O total de taxas alfandegárias (duties) do checkout, na moeda da loja. |
|
|
float |
[pt] A soma dos preços de todos os itens do checkout, na moeda da loja. |
|
|
float |
[pt] A soma dos preços dos itens, descontos, frete e impostos do checkout, na moeda da loja. |
|
|
float |
[pt] A soma de todos os impostos aplicados ao checkout, na moeda da loja. |
|
|
timestamp |
[pt] A data e hora (formato ISO 8601) da última modificação do checkout. |
Carrinhos abandonados: códigos de desconto
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Codigos de desconto aplicados no carrinho abandonado.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] ID do checkout abandonado ao qual este codigo de desconto pertence. |
|
|
float |
[pt] O valor total de desconto aplicado ao checkout abandonado, expresso na moeda de apresentacao (a moeda exibida ao cliente no checkout). Valor monetario reportado como decimal; quando o checkout tem mais de um codigo de desconto, este total no nivel do checkout se repete em cada linha de codigo. |
|
|
text |
[pt] Um codigo de desconto aplicado ao checkout abandonado (o codigo informado pelo cliente para obter o desconto). Quando mais de um codigo e aplicado ao mesmo checkout, cada codigo e reportado em sua propria linha. |
Carrinhos abandonados: itens
- Esta integração requer no mínimo os seguintes escopos:
read_assigned_fulfillment_ordersread_inventoryread_locationsread_marketplace_fulfillment_ordersread_marketplace_ordersread_markets_homeread_merchant_managed_fulfillment_ordersread_ordersread_productsread_third_party_fulfillment_orders
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Itens de linha dos carrinhos abandonados: cada linha e um produto/variacao adicionado a um checkout que nao foi concluido, com quantidade, preco unitario, preco "de" (compare at), SKU, peso e dados da variacao. Grao: um registro por item do checkout abandonado.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador unico do checkout abandonado ao qual este item pertence. |
|
|
float |
[pt] Preco "de" (compare at) da variacao: preco unitario original ou de referencia exibido ao lado do preco de venda para indicar desconto, expresso na moeda base da loja. Pode vir vazio quando nao ha preco de comparacao definido. |
|
|
boolean |
[pt] Indica se o produto deste item e um vale-presente (gift card). Verdadeiro para produtos do tipo vale-presente, falso caso contrario. |
|
|
float |
[pt] Peso de uma unidade do item, expresso em gramas. |
|
|
text |
[pt] Identificador unico deste item dentro do checkout abandonado. |
|
|
float |
[pt] Preco unitario original do item, expresso na moeda de exibicao apresentada ao cliente (presentment). |
|
|
text |
[pt] Titulo do produto conforme apresentado ao cliente. |
|
|
text |
[pt] Titulo da variacao do produto conforme apresentado ao cliente. |
|
|
float |
[pt] Preco unitario original do item, expresso na moeda base da loja. |
|
|
text |
[pt] Identificador unico do produto associado a este item. |
|
|
float |
[pt] Quantidade de unidades do item adicionadas ao checkout. |
|
|
text |
[pt] SKU (unidade de manutencao de estoque) do item: codigo definido pelo lojista que identifica a variacao do produto. |
|
|
boolean |
[pt] Indica se o item esta sujeito a impostos. Verdadeiro quando ha incidencia de impostos sobre o item, falso caso contrario. |
|
|
text |
[pt] Titulo do produto associado a este item. |
|
|
text |
[pt] Identificador unico da variacao do produto associada a este item. |
|
|
float |
[pt] Preco "de" (compare at) da variacao: preco unitario original ou de referencia na moeda base da loja. Pode vir vazio quando nao ha preco de comparacao definido. |
|
|
text |
[pt] Titulo da variacao do produto associada a este item. |
|
|
text |
[pt] Nome do fornecedor ou fabricante do produto. |
Carrinhos abandonados: observações personalizadas
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Atributos/notas do carrinho abandonado (pares nome/valor).
| Campo | Tipo | |
|---|---|---|
|
float |
[pt] O ID do checkout abandonado ao qual este atributo de observacao pertence; relaciona cada par nome/valor ao seu checkout. |
|
|
text |
[pt] Chave (nome) de um atributo personalizado de nome/valor anexado ao checkout abandonado. Sao campos de formato livre definidos pela loja ou por seus aplicativos para guardar informacoes extras coletadas durante o checkout (por exemplo, um rotulo de mensagem de presente, uma instrucao de entrega ou um campo de endereco adicional). O conjunto de nomes possiveis nao e fixo e varia conforme a loja. |
|
|
text |
[pt] Valor em texto associado ao nome do atributo correspondente no checkout abandonado. O conteudo e de formato livre e definido pela loja ou por seus aplicativos; nao possui formato fixo nem conjunto enumerado de valores. |
Clientes
- Esta integração requer no mínimo os seguintes escopos:
read_customersread_marketplace_ordersread_orders
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Clientes cadastrados na loja: contato, enderecos, total gasto, numero de pedidos e consentimento de marketing.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do cliente. |
|
|
boolean |
[pt] Indica se o cliente consentiu em receber material de marketing por e-mail. |
|
|
timestamp |
[pt] Data e hora em que o cliente consentiu ou se opôs a receber material de marketing por e-mail. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) em que o cliente foi criado. |
|
|
text |
[pt] Código de três letras (formato ISO 4217) da moeda que o cliente utilizou ao pagar seu último pedido. |
|
|
text |
[pt] Endereço de correspondência do cliente. |
|
|
text |
[pt] Campo adicional (complemento) para o endereço de correspondência do cliente. |
|
|
text |
[pt] Cidade, município ou localidade do cliente. |
|
|
text |
[pt] Empresa associada ao endereço do cliente. |
|
|
text |
[pt] País do cliente. |
|
|
text |
[pt] Código de duas letras do país correspondente ao país do cliente. |
|
|
text |
[pt] Nome normalizado do país do cliente. |
|
|
text |
[pt] Identificador único do cliente ao qual este endereço pertence. |
|
|
boolean |
[pt] Indica se este endereço é o endereço padrão do cliente. |
|
|
text |
[pt] Primeiro nome associado a este endereço do cliente. |
|
|
text |
[pt] Identificador único do endereço. |
|
|
text |
[pt] Sobrenome associado a este endereço do cliente. |
|
|
text |
[pt] Primeiro nome e sobrenome associados ao endereço do cliente. |
|
|
text |
[pt] Número de telefone do cliente neste endereço. |
|
|
text |
[pt] Nome da região do cliente. Normalmente um estado, província ou prefeitura. |
|
|
text |
[pt] Código da região do endereço, como estado, província ou distrito. |
|
|
text |
[pt] Código postal do cliente (no Brasil, o CEP), também conhecido como zip, postcode, Eircode, etc. |
|
|
text |
[pt] Endereço de e-mail único do cliente. Tentar atribuir o mesmo e-mail a múltiplos clientes resulta em erro. |
|
|
timestamp |
[pt] Data e hora em que o cliente consentiu em receber material de marketing por e-mail. |
|
|
text |
[pt] Nível de consentimento (opt-in) da assinatura de marketing, conforme as Sender Best Common Practices da M3AAWG, informado pelo cliente ao consentir em receber material de marketing por e-mail. Valores possíveis: single_opt_in, confirmed_opt_in e unknown. |
|
|
text |
[pt] Estado atual do consentimento de marketing por e-mail do cliente. Valores possíveis: subscribed (inscrito), not_subscribed (não inscrito), pending (pendente) e unsubscribed (cancelado). |
|
|
text |
[pt] Primeiro nome do cliente. |
|
|
text |
[pt] Sobrenome do cliente. |
|
|
text |
[pt] ID do último pedido do cliente. |
|
|
text |
[pt] Nome do último pedido do cliente. Relaciona-se diretamente ao campo name do recurso Pedido (Order). |
|
|
text |
[pt] Nível de consentimento (opt-in) da assinatura de marketing, conforme as Sender Best Common Practices da M3AAWG, informado pelo cliente ao consentir em receber material de marketing por e-mail. Valores possíveis: single_opt_in, confirmed_opt_in e unknown. |
|
|
text |
[pt] Identificador único do cliente utilizado no login via Multipass. |
|
|
text |
[pt] Anotação sobre o cliente. |
|
|
float |
[pt] Número de pedidos associados a este cliente. Pedidos de teste e arquivados não são contabilizados. |
|
|
text |
[pt] Situação da conta do cliente na loja. Valores possíveis: disabled (a conta nunca foi criada), invited (o cliente recebeu um convite por e-mail para criar a conta), enabled (o cliente criou a conta) e declined (o cliente recusou o convite para criar a conta). |
|
|
text |
[pt] Tags que o lojista atribuiu ao cliente, formatadas como uma string de valores separados por vírgula. |
|
|
boolean |
[pt] Indica se o cliente é isento de pagar impostos em seus pedidos. |
|
|
float |
[pt] Valor total gasto pelo cliente em todo o seu histórico de pedidos, na moeda da loja. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) em que as informações do cliente foram atualizadas pela última vez. |
|
|
boolean |
[pt] Indica se o cliente verificou seu endereço de e-mail. |
Eventos
- Esta integração requer no mínimo os seguintes escopos:
read_customersread_productsread_orders
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Eventos da loja: log de acoes ocorridas sobre objetos (pedidos, produtos, etc.), com tipo, descricao e data.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] O identificador unico do evento. |
|
|
text |
[pt] Valores citados na mensagem do evento, como o numero do pedido, o nome do cliente ou o titulo do recurso. Fornecidos pela API como uma lista. |
|
|
text |
[pt] Quem originou o evento: o nome de um membro da equipe, o nome da loja, ou "Shopify" quando o evento foi gerado automaticamente pelo sistema. |
|
|
timestamp |
[pt] A data e a hora em que o evento foi criado. |
|
|
text |
[pt] Descricao legivel do evento. Pode conter alguma formatacao em HTML, como links para o recurso relacionado. |
|
|
text |
[pt] URL relativa do recurso a que o evento se refere, quando aplicavel. Pode vir vazia para eventos sem um recurso navegavel. |
|
|
text |
[pt] O ID do recurso que gerou o evento (por exemplo, o pedido, produto ou regra de preco relacionado). |
|
|
text |
[pt] O tipo de recurso que gerou o evento, como Order (pedido), Product (produto), Collection (colecao), PriceRule (regra de preco) ou Article (artigo). |
|
|
text |
[pt] A acao descrita pelo evento. Cada tipo de recurso emite acoes distintas, como create (criacao), update (atualizacao), destroy (exclusao), confirmed (confirmado), cancelled (cancelado), closed (fechado), placed (realizado), published (publicado) ou unpublished (despublicado). |
Estoque: itens
- Esta integração requer no mínimo os seguintes escopos:
read_inventoryread_locations
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Itens de inventario: custo unitario, rastreavel ou nao, e dados por SKU usados no controle de estoque por local.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do item de inventário. Cada item de inventário corresponde a uma variação de produto e é usado para acompanhar seu estoque. |
|
|
float |
[pt] Quantidade disponível (vendável) do item de inventário. Retorna nulo quando o item não está configurado para rastrear estoque. |
|
|
text |
[pt] ID do local (location) associado a este registro de inventário. Cada linha representa um item de inventário em um único local de estoque. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) em que o nível de inventário neste local foi modificado pela última vez. |
Pedidos: linha do tempo
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Eventos da loja: log de acoes ocorridas sobre objetos (pedidos, produtos, etc.), com tipo, descricao e data.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] O ID do evento. |
|
|
text |
[pt] O ID do pedido que gerou o evento. |
|
|
text |
[pt] Valores que referenciam os recursos envolvidos no evento (como nomes de itens ou colecoes), apresentados como um unico texto. |
|
|
text |
[pt] Quem gerou o evento. Pode ser a propria plataforma, em eventos automaticos/de sistema, ou o nome do usuario ou aplicativo responsavel pela acao. |
|
|
timestamp |
[pt] A data e hora em que o evento foi criado. |
|
|
text |
[pt] Uma descricao do evento em linguagem natural. |
|
|
text |
[pt] Uma descricao do evento em linguagem natural. Pode conter alguma formatacao HTML. |
|
|
text |
[pt] Uma URL relativa para o recurso ao qual o evento se refere, quando aplicavel. |
|
|
text |
[pt] O tipo de acao representada pelo evento. Abrange o ciclo de vida do pedido (ex.: criado, confirmado, fechado, cancelado), pagamentos (ex.: venda, pago, pago externamente), processamento/envio (ex.: enviado, etiqueta de envio comprada, itens reabastecidos), devolucoes (ex.: produtos devolvidos, devolucao aprovada) e comentarios manuais, entre outros. Recursos diferentes geram tipos diferentes de evento. |
Pedidos
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_ordersread_customersread_appsread_locations
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Pedidos da loja (checkout finalizado): cliente, valores, status financeiro e de envio, descontos, moeda e atributos do pedido. Grão: um registro por pedido.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] O identificador do pedido utilizado pela API. É diferente de order_number, que é o número visível para o lojista e o cliente |
|
|
text |
[pt] O identificador do aplicativo que criou o pedido |
|
|
text |
[pt] O endereço IP do navegador utilizado pelo cliente no momento em que o pedido foi feito |
|
|
boolean |
[pt] Indica se o cliente consentiu em receber comunicações por e-mail da loja |
|
|
text |
[pt] O motivo pelo qual o pedido foi cancelado. Valores possíveis: customer (cancelado pelo cliente), fraud (pedido fraudulento), inventory (itens sem estoque), declined (pagamento recusado), other (outro motivo não listado) |
|
|
timestamp |
[pt] A data e hora em que o pedido foi cancelado, no fuso horário do pedido |
|
|
timestamp |
[pt] A data e hora em que o pedido foi fechado, no fuso horário do pedido |
|
|
boolean |
[pt] Indica se o pedido foi confirmado |
|
|
text |
[pt] O endereço de e-mail de contato do cliente utilizado no pedido |
|
|
timestamp |
[pt] A data e hora em que o pedido foi criado na Shopify, gerada automaticamente, no fuso horário do pedido |
|
|
text |
[pt] O código de três letras (padrão ISO 4217) da moeda da loja |
|
|
float |
[pt] O subtotal atual do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do subtotal atual |
|
|
float |
[pt] O subtotal atual do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do subtotal atual |
|
|
float |
[pt] O total atual de descontos do pedido na moeda da loja. Reflete edições, devoluções e reembolsos do pedido |
|
|
float |
[pt] O total atual de descontos do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do total atual de descontos |
|
|
float |
[pt] O total atual de descontos do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do total atual de descontos |
|
|
float |
[pt] O total atual de taxas alfandegárias (impostos de importação) do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do total atual de taxas alfandegárias |
|
|
float |
[pt] O total atual de taxas alfandegárias (impostos de importação) do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do total atual de taxas alfandegárias |
|
|
float |
[pt] O preço total atual do pedido na moeda da loja. Reflete edições, devoluções e reembolsos do pedido |
|
|
float |
[pt] O preço total atual do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do preço total atual |
|
|
float |
[pt] O preço total atual do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do preço total atual |
|
|
float |
[pt] O total atual de impostos cobrados no pedido na moeda da loja. Reflete edições, devoluções e reembolsos do pedido |
|
|
float |
[pt] O total atual de impostos do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do total atual de impostos |
|
|
float |
[pt] O total atual de impostos do pedido (refletindo edições, devoluções e reembolsos), expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do total atual de impostos |
|
|
text |
[pt] O código de idioma de duas ou três letras do cliente, opcionalmente seguido de um modificador de região |
|
|
text |
[pt] O endereço de e-mail do cliente |
|
|
text |
[pt] O status dos pagamentos associados ao pedido. Valores possíveis: pending (pagamento pendente, ainda pode falhar), authorized (pagamento autorizado), partially_paid (pago parcialmente), paid (pago), partially_refunded (reembolsado parcialmente), refunded (reembolsado), voided (estornado/cancelado) |
|
|
text |
[pt] O status do pedido quanto ao processamento (fulfillment) dos itens. Valores possíveis: fulfilled (todos os itens foram processados), partial (ao menos um item foi processado), restocked (todos os itens retornaram ao estoque e o pedido foi cancelado), vazio/nulo (nenhum item foi processado) |
|
|
text |
[pt] O gateway de pagamento utilizado |
|
|
text |
[pt] A URL da página em que o comprador chegou ao entrar na loja |
|
|
text |
[pt] A URL da página de onde o cliente clicou em um link que o direcionou à loja online |
|
|
text |
[pt] O identificador da localização física onde o pedido foi processado. Refere-se à localização de PDV (ponto de venda); fica vazio para pedidos online |
|
|
text |
[pt] O nome do pedido, gerado combinando order_number com o prefixo e o sufixo definidos nas configurações gerais do lojista. É diferente de id, que é o identificador do pedido usado pela API |
|
|
text |
[pt] Uma observação opcional que o lojista pode anexar ao pedido |
|
|
text |
[pt] A posição do pedido na contagem de pedidos da loja, começando em 1001. Os números são sequenciais |
|
|
text |
[pt] A URL em que o cliente pode acompanhar o status atual do pedido |
|
|
float |
[pt] O total original de taxas alfandegárias (impostos de importação) do pedido no momento de sua criação, expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do total original de taxas alfandegárias |
|
|
float |
[pt] O total original de taxas alfandegárias (impostos de importação) do pedido no momento de sua criação, expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do total original de taxas alfandegárias |
|
|
text |
[pt] O número de telefone do cliente para recebimento de notificações por SMS |
|
|
text |
[pt] A moeda de apresentação utilizada para exibir os preços ao cliente |
|
|
timestamp |
[pt] A data e hora em que o pedido foi efetivado/processado. É a data que aparece nos pedidos e é usada nos relatórios analíticos; por padrão coincide com created_at, mas pode ser definida no passado ao importar pedidos de outra plataforma. No fuso horário do pedido |
|
|
text |
[pt] O site a partir do qual o cliente clicou em um link para a loja |
|
|
text |
[pt] O identificador do pedido na plataforma ou canal de origem. Não corresponde ao ID da Shopify gerado a partir de um rascunho (draft) concluído |
|
|
text |
[pt] A origem do pedido. Só pode ser definida na criação do pedido e não é alterável depois. Valores dos canais Shopify são protegidos: web, pos, shopify_draft_order, iphone e android. Pedidos criados via API podem receber outros valores |
|
|
text |
[pt] A URL da origem de onde o pedido foi gerado, quando encontrada no registro de domínios |
|
|
float |
[pt] O valor do pedido na moeda da loja após descontos, mas antes de frete, impostos e gorjetas |
|
|
float |
[pt] O subtotal do pedido (após descontos, antes de frete, impostos e gorjetas), expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do subtotal |
|
|
float |
[pt] O subtotal do pedido (após descontos, antes de frete, impostos e gorjetas), expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do subtotal |
|
|
text |
[pt] Etiquetas (tags) atribuídas ao pedido, no formato de texto com valores separados por vírgula. São descritores curtos usados para filtrar e pesquisar; cada tag é limitada a 40 caracteres |
|
|
boolean |
[pt] Indica se os impostos estão incluídos no subtotal do pedido |
|
|
boolean |
[pt] Indica se este é um pedido de teste |
|
|
float |
[pt] O total de descontos aplicados ao preço do pedido na moeda da loja |
|
|
float |
[pt] O total de descontos aplicados ao pedido, expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do total de descontos |
|
|
float |
[pt] O total de descontos aplicados ao pedido, expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do total de descontos |
|
|
float |
[pt] A soma dos preços de todos os itens do pedido na moeda da loja |
|
|
float |
[pt] A soma dos preços de todos os itens do pedido, expressa na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação da soma dos preços dos itens |
|
|
float |
[pt] A soma dos preços de todos os itens do pedido, expressa na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja da soma dos preços dos itens |
|
|
float |
[pt] O valor total em aberto (a receber) do pedido na moeda da loja |
|
|
float |
[pt] A soma de todos os itens, descontos, frete, impostos e gorjetas na moeda da loja. Deve ser positivo |
|
|
float |
[pt] O preço total do pedido (itens, descontos, frete, impostos e gorjetas), expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do preço total |
|
|
float |
[pt] O preço total do pedido (itens, descontos, frete, impostos e gorjetas), expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do preço total |
|
|
float |
[pt] O custo total de frete do pedido, expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do total de frete |
|
|
float |
[pt] O custo total de frete do pedido, expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do total de frete |
|
|
float |
[pt] A soma de todos os impostos aplicados ao pedido na moeda da loja. Deve ser positivo |
|
|
float |
[pt] O total de impostos aplicados ao pedido, expresso na moeda de apresentação exibida ao cliente no checkout |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda de apresentação do total de impostos |
|
|
float |
[pt] O total de impostos aplicados ao pedido, expresso na moeda padrão da loja |
|
|
text |
[pt] O código de moeda de três letras (ISO 4217) da moeda da loja do total de impostos |
|
|
float |
[pt] A soma de todas as gorjetas do pedido na moeda da loja |
|
|
float |
[pt] A soma dos pesos de todos os itens do pedido, em gramas |
|
|
timestamp |
[pt] A data e hora da última modificação do pedido. Pode mudar mesmo quando nenhum campo visível do pedido foi alterado |
Pedidos: detalhes
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_ordersread_customersread_appsread_locationsread_marketing_events
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Dados do cliente vinculados ao pedido (snapshot capturado no momento da compra).
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador numerico unico do pedido atribuido pela Shopify. |
|
|
text |
[pt] Logradouro (rua e numero) do endereco de cobranca vinculado a forma de pagamento do pedido. |
|
|
text |
[pt] Linha complementar do endereco de cobranca, como apartamento, sala ou unidade. |
|
|
text |
[pt] Cidade, municipio ou localidade do endereco de cobranca. |
|
|
text |
[pt] Nome da empresa ou organizacao do endereco de cobranca. |
|
|
text |
[pt] Nome completo do pais do endereco de cobranca. |
|
|
text |
[pt] Codigo do pais do endereco de cobranca em duas letras, no formato ISO 3166-1 alpha-2 (ex.: BR, US). |
|
|
text |
[pt] Primeiro nome da pessoa associada ao endereco de cobranca. |
|
|
text |
[pt] Sobrenome da pessoa associada ao endereco de cobranca. |
|
|
text |
[pt] Coordenada de latitude do endereco de cobranca. |
|
|
text |
[pt] Coordenada de longitude do endereco de cobranca. |
|
|
text |
[pt] Nome completo (primeiro nome e sobrenome) da pessoa associada ao endereco de cobranca. |
|
|
text |
[pt] Numero de telefone do endereco de cobranca. |
|
|
text |
[pt] Nome da regiao (como estado, provincia ou prefeitura) do endereco de cobranca. |
|
|
text |
[pt] Codigo abreviado da regiao (como estado ou provincia) do endereco de cobranca (ex.: SP). |
|
|
text |
[pt] Codigo postal (CEP) do endereco de cobranca. |
|
|
boolean |
[pt] Indica se o cliente consentiu em receber material de marketing por e-mail. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) da ultima atualizacao do consentimento de marketing do cliente. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) em que o cadastro do cliente foi criado. |
|
|
text |
[pt] Logradouro (rua e numero) do endereco padrao do cliente. |
|
|
text |
[pt] Linha complementar do endereco padrao do cliente, como apartamento, sala ou unidade. |
|
|
text |
[pt] Cidade, municipio ou localidade do endereco padrao do cliente. |
|
|
text |
[pt] Nome da empresa ou organizacao do endereco padrao do cliente. |
|
|
text |
[pt] Nome completo do pais do endereco padrao do cliente. |
|
|
text |
[pt] Codigo do pais do endereco padrao do cliente em duas letras, no formato ISO 3166-1 alpha-2 (ex.: BR, US). |
|
|
text |
[pt] Nome completo e normalizado do pais do endereco padrao do cliente. |
|
|
text |
[pt] Identificador unico do cliente ao qual este endereco padrao pertence. |
|
|
boolean |
[pt] Indica se este e o endereco padrao do cliente. |
|
|
text |
[pt] Primeiro nome da pessoa no endereco padrao do cliente. |
|
|
text |
[pt] Identificador unico do endereco padrao do cliente. |
|
|
text |
[pt] Sobrenome da pessoa no endereco padrao do cliente. |
|
|
text |
[pt] Nome completo (primeiro nome e sobrenome) da pessoa no endereco padrao do cliente. |
|
|
text |
[pt] Numero de telefone do endereco padrao do cliente. |
|
|
text |
[pt] Nome da regiao (como estado, provincia ou prefeitura) do endereco padrao do cliente. |
|
|
text |
[pt] Codigo abreviado da regiao (como estado ou provincia) do endereco padrao do cliente (ex.: RJ). |
|
|
text |
[pt] Codigo postal (CEP) do endereco padrao do cliente. |
|
|
text |
[pt] Endereco de e-mail do cliente. |
|
|
text |
[pt] Primeiro nome do cliente. |
|
|
text |
[pt] Identificador unico do cliente. |
|
|
text |
[pt] Sobrenome do cliente. |
|
|
text |
[pt] Identificador unico do pedido mais recente do cliente. |
|
|
text |
[pt] Nome (numero do pedido, como #1001) do pedido mais recente do cliente. |
|
|
text |
[pt] Identificador unico utilizado pelo cliente para autenticar via Multipass. |
|
|
text |
[pt] Anotacao em texto livre que o lojista vinculou ao cliente. |
|
|
float |
[pt] Quantidade de pedidos associados a este cliente. Pedidos de teste e arquivados nao sao contabilizados. |
|
|
text |
[pt] Numero de telefone do cliente, no formato E.164. |
|
|
text |
[pt] Situacao da conta do cliente na loja. Os valores possiveis incluem: 'disabled', 'invited', 'enabled' e 'declined'. |
|
|
text |
[pt] Lista de tags (separadas por virgula) aplicadas ao cliente para categorizacao e filtragem. |
|
|
boolean |
[pt] Indica se o cliente e isento do pagamento de impostos em seus pedidos. |
|
|
text |
[pt] Lista de codigos de isencao fiscal aplicados ao cliente (por exemplo, isencoes regionais ou por tipo de status). |
|
|
float |
[pt] Valor total gasto pelo cliente ao longo de todo o seu historico de pedidos. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) da ultima atualizacao das informacoes do cliente. |
|
|
boolean |
[pt] Indica se o cliente verificou seu endereco de e-mail. |
|
|
text |
[pt] Lista de gateways de pagamento utilizados para processar as transacoes do pedido. |
|
|
text |
[pt] Logradouro (rua e numero) do endereco de entrega do pedido. |
|
|
text |
[pt] Linha complementar do endereco de entrega, como apartamento, sala ou unidade. |
|
|
text |
[pt] Cidade, municipio ou localidade do endereco de entrega. |
|
|
text |
[pt] Nome da empresa ou organizacao do endereco de entrega. |
|
|
text |
[pt] Nome completo do pais do endereco de entrega. |
|
|
text |
[pt] Codigo do pais do endereco de entrega em duas letras, no formato ISO 3166-1 alpha-2 (ex.: BR, US). |
|
|
text |
[pt] Primeiro nome da pessoa associada ao endereco de entrega. |
|
|
text |
[pt] Sobrenome da pessoa associada ao endereco de entrega. |
|
|
float |
[pt] Coordenada de latitude do endereco de entrega. |
|
|
float |
[pt] Coordenada de longitude do endereco de entrega. |
|
|
text |
[pt] Nome completo (primeiro nome e sobrenome) da pessoa associada ao endereco de entrega. |
|
|
text |
[pt] Numero de telefone do endereco de entrega. |
|
|
text |
[pt] Nome da regiao (como estado, provincia ou prefeitura) do endereco de entrega. |
|
|
text |
[pt] Codigo abreviado da regiao (como estado ou provincia) do endereco de entrega (ex.: SP). |
|
|
text |
[pt] Codigo postal (CEP) do endereco de entrega. |
Pedidos: descontos aplicados
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Descontos aplicados ao pedido (por codigo, automatico ou manual) com tipo, alvo e valor concedido.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] ID do pedido ao qual esta aplicacao de desconto pertence. |
|
|
text |
[pt] Como o valor do desconto e distribuido entre as linhas a que se aplica. Os valores possiveis incluem ACROSS (o valor e distribuido proporcionalmente entre todas as linhas elegiveis), EACH (o valor e aplicado a cada linha elegivel individualmente) e ONE (o valor e aplicado uma unica vez). |
|
|
text |
[pt] Identificador do desconto aplicado ao pedido. Para descontos por codigo, e o codigo informado no checkout; para descontos manuais, via script ou automaticos, traz o nome/titulo do desconto. Fica vazio quando o desconto nao possui codigo ou titulo associado. |
|
|
text |
[pt] A quais linhas do pedido o desconto se aplica. Os valores possiveis incluem ALL (todas as linhas sao elegiveis), ENTITLED (apenas as linhas que atendem as condicoes do desconto) e EXPLICIT (apenas linhas especificas escolhidas explicitamente para o desconto). |
|
|
text |
[pt] Se o desconto incide sobre os produtos ou sobre o frete do pedido. Os valores possiveis incluem LINE_ITEM (o desconto se aplica aos itens de produto) e SHIPPING_LINE (o desconto se aplica ao frete). |
|
|
text |
[pt] O tipo/origem da aplicacao do desconto. Os valores possiveis incluem DiscountCodeApplication (desconto acionado por um codigo informado no checkout), ManualDiscountApplication (desconto aplicado manualmente pelo lojista), ScriptDiscountApplication (desconto aplicado por um Shopify Script) e AutomaticDiscountApplication (desconto aplicado automaticamente por uma regra da loja). |
|
|
float |
[pt] A magnitude do desconto. Quando value_type e fixed_amount, e um valor monetario na moeda da loja; quando value_type e percentage, e o percentual do preco que sera descontado. |
|
|
text |
[pt] Indica como o campo value deve ser interpretado. Os valores possiveis sao fixed_amount (o desconto e um valor monetario na moeda da loja) e percentage (o desconto e um percentual do preco). |
Pedidos: códigos de desconto
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Codigos de desconto usados no pedido, com o valor concedido por cada codigo.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] ID do pedido ao qual este codigo de desconto pertence. |
|
|
float |
[pt] A magnitude do desconto aplicado por este codigo. Quando type e fixed_amount, e um valor monetario na moeda da loja deduzido do pedido; quando type e percentage, e o percentual do pedido que e descontado. |
|
|
text |
[pt] O identificador do desconto aplicado ao pedido. Para descontos por codigo, e o codigo informado no checkout; para descontos manuais ou via script, traz o titulo do desconto. Pode ficar vazio em descontos automaticos que nao possuem codigo nem titulo associado. |
|
|
text |
[pt] Como o valor do desconto deve ser interpretado. Os valores possiveis sao fixed_amount (amount e um valor monetario na moeda da loja deduzido do pedido) e percentage (amount e o percentual do pedido que e descontado). |
Pedidos: entregas
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_ordersread_fulfillmentsread_locations
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Fulfillments (remessas) do pedido: itens enviados, codigo de rastreamento, transportadora e status de entrega.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido ao qual esta remessa (fulfillment) pertence. |
|
|
text |
[pt] Identificador único da remessa (fulfillment), atribuído pela plataforma. |
|
|
timestamp |
[pt] Data e hora em que a remessa (fulfillment) foi criada (formato ISO 8601, com fuso horário). |
|
|
text |
[pt] Identificador do local de onde os itens são despachados (por exemplo, o depósito ou a loja). |
|
|
text |
[pt] Nome legível da remessa, derivado do número do pedido (por exemplo, o nome do pedido seguido de uma sequência da remessa). |
|
|
text |
[pt] Serviço de fulfillment responsável pela remessa (por exemplo, manual ou um provedor de logística terceirizado). |
|
|
text |
[pt] Status atual da remessa (fulfillment). Valores possíveis incluem: pending (pendente), open (em andamento), success (concluída com sucesso), cancelled (cancelada), error (erro) e failure (falha). |
|
|
text |
[pt] Nome da transportadora responsável pelo transporte da remessa (por exemplo, o serviço de correio ou courier). |
|
|
text |
[pt] Número de rastreamento fornecido pela transportadora para a remessa. |
|
|
text |
[pt] URL onde a remessa pode ser rastreada no site da transportadora. |
|
|
timestamp |
[pt] Data e hora da última atualização da remessa (fulfillment) (formato ISO 8601, com fuso horário). |
Pedidos: itens
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_ordersread_fulfillmentsread_locationsread_productsread_inventory
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Itens de linha do pedido: cada produto/variante comprado, com quantidade, preco unitario, descontos e impostos. Grao: um registro por item do pedido.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] ID do pedido pai ao qual este item de linha pertence. |
|
|
text |
[pt] ID do item de linha (identificador único do item dentro do pedido). |
|
|
text |
[pt] Status de processamento (fulfillment) do item de linha. Um de: 'fulfilled' (toda a quantidade já foi processada/enviada), 'partial' (apenas parte da quantidade foi processada) ou vazio/null (nada processado ainda). |
|
|
boolean |
[pt] Retorna verdadeiro (true) se o produto associado ao item de linha for um vale-presente (gift card). |
|
|
float |
[pt] Peso de uma unidade do item de linha, em gramas. |
|
|
text |
[pt] Nome do produto, incluindo a variante, como aparece no pedido — combinação do título do produto e do título da variante, separados por hífen. |
|
|
text |
[pt] Primeira linha do endereço do local de destino: para onde o item de linha é enviado. |
|
|
text |
[pt] Segunda linha (complemento) do endereço do local de destino (para onde o item de linha é enviado). |
|
|
text |
[pt] Cidade do local de destino (para onde o item de linha é enviado). |
|
|
text |
[pt] Código do país (ISO 3166-1 alfa-2, duas letras) do local de destino. |
|
|
text |
[pt] Identificador do local de destino (para onde o item de linha é enviado). |
|
|
text |
[pt] Nome do local de destino (para onde o item de linha é enviado). |
|
|
text |
[pt] Estado/província (nome ou sigla) do local de destino. |
|
|
text |
[pt] CEP/código postal do local de destino. |
|
|
text |
[pt] Primeira linha do endereço do local de origem: de onde o item de linha é enviado. |
|
|
text |
[pt] Segunda linha (complemento) do endereço do local de origem (de onde o item de linha é enviado). |
|
|
text |
[pt] Cidade do local de origem (de onde o item de linha é enviado). |
|
|
text |
[pt] Código do país (ISO 3166-1 alfa-2, duas letras) do local de origem. |
|
|
text |
[pt] Identificador do local de origem (de onde o item de linha é enviado). |
|
|
text |
[pt] Nome do local de origem (de onde o item de linha é enviado). |
|
|
text |
[pt] Estado/província (nome ou sigla) do local de origem. |
|
|
text |
[pt] CEP/código postal do local de origem. |
|
|
float |
[pt] Preço unitário do item de linha, na moeda da loja, antes de descontos e impostos. |
|
|
text |
[pt] Código da moeda (ISO 4217) do preço unitário na moeda de apresentação (presentment) — a moeda exibida ao cliente. |
|
|
float |
[pt] Valor do preço unitário na moeda de apresentação (presentment) — a moeda exibida ao cliente. |
|
|
text |
[pt] Código da moeda (ISO 4217) do preço unitário na moeda da loja (shop). |
|
|
text |
[pt] Valor do preço unitário na moeda da loja (shop). |
|
|
boolean |
[pt] Retorna verdadeiro (true) se o produto associado ao item de linha ainda existe na loja; falso (false) se ele foi excluído. |
|
|
text |
[pt] ID do produto ao qual este item de linha se refere. |
|
|
float |
[pt] Quantidade de unidades deste item de linha que foram pedidas. |
|
|
boolean |
[pt] Retorna verdadeiro (true) se a variante associada ao item de linha exige envio (frete); falso (false) caso contrário. |
|
|
text |
[pt] SKU (código de controle de estoque) da variante associada ao item de linha. |
|
|
boolean |
[pt] Retorna verdadeiro (true) se devem incidir impostos sobre o item de linha; falso (false) caso contrário. |
|
|
text |
[pt] Título do item de linha: combinação do título do produto e do título da variante, separados por hífen. |
|
|
float |
[pt] Valor total de descontos alocados a este item de linha, na moeda da loja. |
|
|
text |
[pt] Código da moeda (ISO 4217) do desconto total do item de linha na moeda de apresentação (presentment). |
|
|
float |
[pt] Valor do desconto total do item de linha na moeda de apresentação (presentment). |
|
|
text |
[pt] Código da moeda (ISO 4217) do desconto total do item de linha na moeda da loja (shop). |
|
|
float |
[pt] Valor do desconto total do item de linha na moeda da loja (shop). |
|
|
text |
[pt] ID da variante do produto associada ao item de linha. |
|
|
text |
[pt] Título da variante do produto associada ao item de linha (por exemplo, tamanho ou cor). |
|
|
text |
[pt] Fornecedor (vendor) do produto/variante associado ao item de linha. |
Pedidos: itens: propriedades personalizadas
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Propriedades customizadas por item de linha (pares nome/valor definidos pela loja, ex.: gravacao, observacao).
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido que contém o item de linha ao qual esta propriedade personalizada pertence |
|
|
text |
[pt] Identificador do item de linha (entrada de produto/variante dentro do pedido) que carrega esta propriedade personalizada |
|
|
text |
[pt] Nome/chave de uma propriedade personalizada anexada ao item de linha, definida pela loja ou pelo tema (por exemplo, texto de gravação, mensagem de presente, cor customizada, componente de bundle ou detalhe de assinatura) |
|
|
text |
[pt] Valor associado ao nome/chave correspondente da propriedade personalizada anexada ao item de linha |
Pedidos: observações personalizadas
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Atributos/notas adicionais do pedido (pares nome/valor definidos pela loja ou pelo checkout).
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido ao qual este atributo personalizado está associado |
|
|
text |
[pt] Nome/chave de um atributo personalizado (par nome/valor) anexado ao pedido pela loja ou pelo tema, como mensagem de presente, data de entrega ou campo customizado do checkout |
|
|
text |
[pt] Valor correspondente ao nome/chave do atributo personalizado (par nome/valor) anexado ao pedido |
Pedidos: reembolsos
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Reembolsos do pedido: estornos totais ou parciais, com itens reembolsados, valores e motivo. Grao: um registro por reembolso.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] ID do pedido ao qual o reembolso pertence. |
|
|
text |
[pt] Identificador unico do reembolso. |
|
|
timestamp |
[pt] Data e hora em que o reembolso foi criado. |
|
|
text |
[pt] Nota opcional anexada ao reembolso, geralmente descrevendo o motivo ou os detalhes do reembolso. |
|
|
timestamp |
[pt] Data e hora em que o reembolso foi processado. E o carimbo de tempo usado como data efetiva do reembolso em relatorios. |
Pedidos: fretes
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_orders
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Linhas de frete do pedido: metodo de envio, valor cobrado e impostos de frete.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do pedido ao qual esta linha de frete pertence. |
|
|
text |
[pt] Identificador unico desta linha de frete. |
|
|
text |
[pt] Referencia ao servico de transportadora que forneceu a cotacao de frete. Presente quando a tarifa foi calculada por um servico de transportadora de terceiros; caso contrario, pode ficar vazio. |
|
|
text |
[pt] Codigo de referencia que identifica a tarifa de frete, conforme definido pelo servico de frete ou pela transportadora. |
|
|
text |
[pt] Classificacao geral do tipo de entrega desta linha de frete, por exemplo um envio padrao versus uma entrega local. Frequentemente vazio. |
|
|
float |
[pt] Preco desta linha de frete apos a aplicacao dos descontos no nivel da linha, na moeda da loja. |
|
|
float |
[pt] Preco com desconto desta linha de frete na moeda de apresentacao (a moeda exibida ao cliente no checkout). |
|
|
text |
[pt] Codigo de moeda no padrao ISO 4217 da moeda de apresentacao para o preco com desconto do frete (a moeda exibida ao cliente no checkout). |
|
|
text |
[pt] Codigo de moeda no padrao ISO 4217 da moeda da loja para o preco com desconto do frete (a moeda padrao da loja). |
|
|
float |
[pt] Preco com desconto desta linha de frete na moeda da loja (a moeda padrao da loja). |
|
|
text |
[pt] Telefone associado a esta linha de frete, quando informado, usado por algumas transportadoras como contato de entrega. Frequentemente vazio. |
|
|
float |
[pt] Preco desta linha de frete antes de descontos, na moeda da loja. Nao pode ser negativo. |
|
|
float |
[pt] Preco desta linha de frete antes de descontos, na moeda de apresentacao (a moeda exibida ao cliente no checkout). |
|
|
text |
[pt] Codigo de moeda no padrao ISO 4217 da moeda de apresentacao para o preco do frete (a moeda exibida ao cliente no checkout). |
|
|
float |
[pt] Preco desta linha de frete antes de descontos, na moeda da loja (a moeda padrao da loja). |
|
|
text |
[pt] Codigo de moeda no padrao ISO 4217 da moeda da loja para o preco do frete (a moeda padrao da loja). |
|
|
text |
[pt] Referencia ao servico de fulfillment (logistica de expedicao) solicitado para este metodo de frete. |
|
|
text |
[pt] Origem da tarifa de frete, ou seja, o canal ou aplicativo que a gerou (como a loja virtual no checkout ou um aplicativo de frete de terceiros). |
|
|
text |
[pt] Titulo do metodo de frete exibido ao cliente no checkout (por exemplo, o nome da transportadora ou da tarifa). |
Pedidos: transações
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_ordersread_customersread_locationsread_payment_terms
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Transacoes financeiras do pedido (autorizacao, captura, estorno, anulacao) com valor, gateway, forma de pagamento e status.
| Campo | Tipo | |
|---|---|---|
|
float |
[pt] ID do pedido ao qual a transacao esta associada. |
|
|
float |
[pt] Identificador unico da transacao. |
|
|
float |
[pt] Valor monetario envolvido na transacao, na moeda da loja. |
|
|
text |
[pt] Codigo de autorizacao retornado pelo provedor de pagamento para a transacao. |
|
|
timestamp |
[pt] Data e hora em que a transacao foi criada. |
|
|
text |
[pt] Codigo de tres letras (ISO 4217) da moeda usada na transacao. |
|
|
text |
[pt] Codigo de erro padronizado, presente quando a transacao falha (por exemplo: incorrect_number, card_declined, expired_card, processing_error). |
|
|
text |
[pt] Nome do gateway de pagamento por onde a transacao foi processada. |
|
|
text |
[pt] Tipo da transacao. Um de: authorization (reserva do valor), sale (autorizacao e captura juntas), capture (captura de um valor previamente autorizado), void (cancelamento de uma autorizacao) e refund (estorno de um valor capturado). |
|
|
text |
[pt] ID do local fisico (ponto de venda) onde a transacao foi processada, quando aplicavel. |
|
|
text |
[pt] ID da transacao relacionada que originou esta — por exemplo, a autorizacao correspondente a uma captura, cancelamento ou estorno. |
|
|
timestamp |
[pt] Data e hora em que a transacao foi processada pelo gateway. |
|
|
text |
[pt] Campo do recibo retornado pelo gateway: identificador da conta de pagamento informado pelo provedor. O conteudo do recibo varia conforme o gateway que processou a transacao. |
|
|
float |
[pt] Campo do recibo do gateway: o valor da transacao conforme informado pelo provedor de pagamento. |
|
|
text |
[pt] Campo do recibo do gateway: codigo de tres letras da moeda informado pelo provedor de pagamento. |
|
|
text |
[pt] Campo do recibo do gateway: identificador de referencia da transacao no proprio provedor de pagamento. |
|
|
float |
[pt] Campo do recibo do gateway: identificador de referencia que o provedor associa a transacao. |
|
|
text |
[pt] Campo do recibo do gateway: resultado da transacao informado pelo provedor (por exemplo, 'completed', 'pending'). |
|
|
text |
[pt] Campo do recibo do gateway: assinatura/hash retornada pelo provedor para validar a autenticidade do recibo. |
|
|
text |
[pt] Campo do recibo do gateway: indica se o provedor processou a transacao em modo de teste. |
|
|
text |
[pt] Campo do recibo do gateway: data/hora registrada pelo provedor para a transacao. |
|
|
text |
[pt] Origem/canal de vendas da transacao (por exemplo, 'web' para a loja online, 'pos' para ponto de venda, ou um identificador do aplicativo/canal de vendas). |
|
|
text |
[pt] Situacao da transacao. Um de: success, failure, pending e error. |
|
|
boolean |
[pt] Indica se a transacao e uma transacao de teste. |
Pedidos: visitas: parâmetros UTM
Limitação: A API do Shopify limita o acesso a pedidos aos últimos 60 dias por padrão. Para histórico completo, é necessário solicitar o escopo read_all_orders no Partner Dashboard. Consulte instruções.
- Esta integração requer no mínimo os seguintes escopos:
read_ordersread_customersread_marketing_events
Conector criado pelo método Dev Dashboard: a Shopify libera apenas os pedidos criados nos últimos 60 dias. Pedidos mais antigos não são trazidos. Para o histórico completo, crie o conector pelo método Partner Dashboard (escopo read_all_orders).
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Parametros UTM de origem do pedido (campanha, fonte, midia, termo, conteudo) extraidos do landing site da sessao.
| Campo | Tipo | |
|---|---|---|
|
float |
[pt] O identificador único do pedido ao qual estes parâmetros UTM estão associados |
|
|
text |
[pt] O nome da campanha de marketing que originou a visita (parâmetro utm_campaign), como uma promoção sazonal ou um lançamento de produto |
|
|
text |
[pt] Identifica o conteúdo específico de uma campanha de marketing (parâmetro utm_content). Usado para diferenciar links ou anúncios semelhantes dentro de uma mesma campanha e medir qual é o mais efetivo |
|
|
text |
[pt] O meio pelo qual a visita chegou à loja (parâmetro utm_medium), como banner, boletim de e-mail, custo por clique (cpc) ou rede social |
|
|
text |
[pt] A origem do tráfego que levou o visitante à loja (parâmetro utm_source), como um buscador, uma rede social ou um boletim de e-mail |
|
|
float |
[pt] Os termos de busca paga associados à campanha de marketing (parâmetro utm_term), normalmente as palavras-chave de um anúncio de busca paga |
|
|
timestamp |
[pt] A data e hora em que ocorreu a sessão do cliente que gerou estes parâmetros UTM |
Produtos
- Esta integração requer no mínimo os seguintes escopos:
read_products
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Produtos do catalogo da loja: titulo, tipo, fornecedor, tags, status e dados de publicacao.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador unico do produto, atribuido automaticamente pela loja. |
|
|
text |
[pt] Descricao do produto. Pode conter marcacao HTML. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) em que o produto foi criado. |
|
|
text |
[pt] Texto unico e amigavel que identifica o produto, gerado automaticamente a partir do titulo e usado como slug na URL da pagina do produto. |
|
|
text |
[pt] Texto alternativo que descreve a imagem principal (primeira) do produto, usado para acessibilidade e SEO. Pode estar vazio. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) em que a imagem principal (primeira) do produto foi criada. |
|
|
float |
[pt] Altura da imagem principal (primeira) do produto, em pixels. |
|
|
text |
[pt] Identificador unico da imagem principal (primeira) do produto. |
|
|
float |
[pt] Posicao desta imagem na galeria do produto, comecando em 1 (a posicao 1 e a imagem principal). |
|
|
text |
[pt] URL publica da imagem principal (primeira) do produto. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) da ultima modificacao da imagem principal (primeira) do produto. |
|
|
float |
[pt] Largura da imagem principal (primeira) do produto, em pixels. |
|
|
text |
[pt] Categoria do produto, definida pelo lojista, usada para filtrar e buscar produtos. Pode estar vazia. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) em que o produto foi publicado. Fica nula quando o produto nao esta publicado no canal da loja online. |
|
|
boolean |
[pt] Indica se o produto esta publicado tambem no canal de ponto de venda (PDV/POS), alem da loja online. |
|
|
text |
[pt] Situacao do produto. Valores comuns: active (ativo), archived (arquivado), draft (rascunho). |
|
|
text |
[pt] Lista de etiquetas (tags) separadas por virgula, usadas para filtrar e buscar produtos. Um produto pode ter ate 250 etiquetas. |
|
|
text |
[pt] Sufixo do template Liquid usado na pagina do produto. Quando preenchido, a pagina usa o template 'product.<sufixo>.liquid'; quando vazio ou nulo, usa o template padrao 'product.liquid'. |
|
|
text |
[pt] Nome do produto. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) da ultima modificacao do produto. |
|
|
text |
[pt] Nome do fornecedor ou fabricante do produto. |
Produtos: imagens
- Esta integração requer no mínimo os seguintes escopos:
read_productsread_product_listings
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Imagens do produto: URL, posicao na galeria e variantes associadas a cada imagem.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador unico do produto ao qual esta imagem pertence. |
|
|
text |
[pt] Texto alternativo que descreve a imagem, usado para acessibilidade e SEO. Pode estar vazio. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) em que a imagem foi adicionada ao produto. |
|
|
float |
[pt] Altura da imagem, em pixels. |
|
|
text |
[pt] Identificador unico da imagem do produto. |
|
|
float |
[pt] Posicao desta imagem na galeria de imagens do produto, comecando em 1 (a posicao 1 e a imagem principal). |
|
|
text |
[pt] URL publica onde a imagem do produto esta hospedada. |
|
|
timestamp |
[pt] Data e hora (formato ISO 8601) da ultima atualizacao da imagem. |
|
|
float |
[pt] Largura da imagem, em pixels. |
Produtos: opções
- Esta integração requer no mínimo os seguintes escopos:
read_products
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Opcoes de produto (ex.: tamanho, cor) e seus valores possiveis.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do produto ao qual esta opção pertence. |
|
|
text |
[pt] Identificador único da opção do produto. |
|
|
text |
[pt] Nome/rótulo da opção do produto, como Tamanho, Cor ou Material. Produtos que não possuem opções configuradas trazem uma única opção padrão chamada "Title", cujo valor é "Default Title". |
|
|
float |
[pt] Posição ordinal desta opção dentro do produto, começando em 1. Um produto pode ter até três opções, então este valor varia de 1 a 3 e define a ordem em que as opções são apresentadas. |
|
|
text |
[pt] Lista dos possíveis valores que esta opção pode assumir (por exemplo, para uma opção Tamanho: P, M, G; para uma opção Cor: Preto, Marrom), serializada como texto. Cada combinação de valores entre as opções do produto corresponde a uma variante do produto. |
Produtos: variantes
- Esta integração requer no mínimo os seguintes escopos:
read_productsread_inventoryread_locations
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos
Relacionamentos:
Variantes de produto: SKU, preco, preco comparativo, codigo de barras, peso, estoque e opcoes selecionadas.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador numérico único do produto ao qual esta variante pertence |
|
|
text |
[pt] Identificador numérico único da variante do produto |
|
|
text |
[pt] Identificador numérico único do item de estoque associado à variante, usado para controlar a quantidade disponível |
|
|
text |
[pt] Código de referência (SKU) que identifica a variante no estoque da loja. Pode estar vazio |
|
|
text |
[pt] Código de barras, UPC ou ISBN da variante do produto. Pode estar vazio |
|
|
float |
[pt] Preço original (de referência) da variante antes de um desconto ou promoção, na moeda da loja. Fica vazio quando não há preço de comparação |
|
|
timestamp |
[pt] Data e hora em que a variante do produto foi criada |
|
|
float |
[pt] Peso da variante do produto em gramas |
|
|
text |
[pt] Identificador numérico único da imagem do produto associada à variante. Fica vazio quando nenhuma imagem está atribuída |
|
|
text |
[pt] Define se o cliente pode comprar a variante quando ela está sem estoque. Assume 'deny' (bloqueia a compra) ou 'continue' (permite a compra) |
|
|
float |
[pt] Quantidade total da variante em estoque, somada entre todos os locais |
|
|
text |
[pt] Valor da primeira opção do produto (por exemplo, tamanho ou cor) para esta variante. Assume 'Default Title' quando o produto não possui opções |
|
|
text |
[pt] Valor da segunda opção do produto para esta variante. Fica vazio quando o produto tem menos de duas opções |
|
|
text |
[pt] Valor da terceira opção do produto para esta variante. Fica vazio quando o produto tem menos de três opções |
|
|
float |
[pt] Posição da variante na lista de variantes do produto, começando em 1 |
|
|
float |
[pt] Preço de venda da variante do produto, na moeda da loja |
|
|
boolean |
[pt] Indica se há cobrança de imposto na venda da variante do produto |
|
|
text |
[pt] Título da variante do produto, formado pela junção dos valores de option1, option2 e option3 |
|
|
timestamp |
[pt] Data e hora da última modificação da variante do produto |
|
|
float |
[pt] Peso da variante do produto na unidade definida em weight_unit |
|
|
text |
[pt] Unidade de medida do peso da variante. Assume 'g', 'kg', 'oz' ou 'lb' |
Notas
Escopos
Alguns dos escopos necessários para cada integração foram obtidos com ajuda de inteligência artificial. Nos avise caso encontre inconsistências
🔗⚠️ Aviso: Dados Protegidos de Cliente (PII)
Campos de endereço de cobrança (billing_address_*) e endereço de entrega (shipping_address_*) são considerados Dados Protegidos de Cliente (PII - Level 2) pela Shopify.
Disponibilidade por plano Shopify:
- ❌ Basic e Starter: Não disponível - campos retornarão
NULL - ✅ Grow, Shopify, Advanced e Plus: Disponível
Se você está em um plano Basic/Starter e precisa desses dados, será necessário fazer upgrade do plano Shopify.
Solicitando Acesso a Histórico Completo de Pedidos
Por padrão, a API do Shopify limita o acesso a pedidos dos últimos 60 dias. Para acessar histórico completo, é necessário solicitar o escopo read_all_orders.
Passos:
- Acesse partners.shopify.com
- Apps → [seu app] → API access
- Em "Access requests", clique em "Request access" no card "Read all orders scope"
- Descreva a justificativa (ex: "Preciso acessar histórico completo de pedidos para integração de dados")
- Aguarde aprovação do Shopify (pode levar alguns dias)
- Após aprovado, re-autorize o app na loja Shopify
- Re-crie as integrações na Kondado
Nota: Esta solicitação deve ser feita pelo criador do app Partner.
- Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas
Adicionar o conector do Shopify na Kondado
Configure a replicacao de pedidos, produtos, clientes e demais dados da sua loja Shopify para o destino escolhido.
Crie um custom app no admin do Shopify
No admin do Shopify, va em Apps → Develop apps → Create an app, defina os escopos de leitura (read_orders, read_products, read_customers, etc.) e gere o Admin API access token.
Adicione a fonte Shopify na Kondado
Na Kondado, acesse 'Fontes' e adicione uma nova fonte Shopify, informando o subdominio da loja (xxx.myshopify.com) e o access token gerado.
Crie a integracao escolhendo o pipeline
Selecione um dos pipelines listados nesta pagina (orders, products, customers, etc.) e defina o savepoint inicial.
Ative a integracao e valide
Ative a integracao e confira no destino se as tabelas chegaram corretamente. Repita o processo para outros pipelines de Shopify que precisar.