Shopify

Adicionando o conector

Baseado na documentação da API do Shopify

Adicionando o conector do Shopify na Kondado, você pode ter acesso aos dados do seu e-commerce no seu Data Warehouse ou Data Lake – processo também conhecido como ETL ou ELT

Requisitos

  • Siga as instruções abaixa com um usuário do tipo “store owner” ou com permissões de Enable app development

Instruções

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

1) Faça login na sua conta do Shopify (sualoja.myshopify.com) como titular da conta (store owner)
Clique em pesquisa e clique em Apps

2) Após clique em configurações do app e canais de vendas

3) Na página de Apps clique em “Desenvolva apps para a sua loja”

4) Na parte superior clique no botão “Criar um app”

Caso o desenvolvimento de apps esteja desabilitado basta aceitar a criação de apps privados

5) Na nova tela, em “Nome do app” coloque um nome que identifique o seu app, por exemplo “Kondado” em “Desenvolvedor do app” coloque um email da sua empresa para receber comunicações do shopify

6) Na próxima sessão, clique em configurar escopos da API Admin

7) Para as permissões da lista, precisaremos de todas as permissões de “Read” pois realizamos apenas leitura dos dados e clique em salvar

A imagem acima representa apenas um exemplo de permissões. É necessário conceder “Read” para todas as permissões que você deseja obter dados, principalmente as relacionadas a Orders (pedidos)

8) Logo em seguida com as permissões já configuradas clique em “credenciais da API” e “instalar app”.

9) Clique em revelar o token uma vez

Note que, por questões de segurança, o token de acesso da api só pode ser exibido uma vez, então tome nota dele em um lugar seguro, pois será necessário para os próximos passos deste tutorial

10) Faça login na Kondado, vá para a seção de adicionar conectores e selecione o conector do Shopify

11) Dê um nome para o seu conector e preencha os dados da seguinte forma:

  • Em Subdomínio, preencha o início da sua URL administrativa do shopify. Por exemplo, se a URL administrativa da sua loja é minhaloja.myshopify.com, o valor a ser preenchido aqui é minhaloja
  • Em Admin API access token, copie o valor do token obtido no passo (9)

Agora basta clicar em “SALVAR”, testar a conexão e começar a criar integrações!

Integrações

Índice

Gráfico de relacionamento

Clique para ampliar

Orders

Campo Tipo

id

text

[en] The ID of the order, used for API purposes. This is different from the order_number property, which is the ID used by the shop owner and customer

app_id

float

[en] The ID of the app that created the order.

browser_ip

text

[en] The IP address of the browser used by the customer when they placed the order

buyer_accepts_marketing

boolean

[en] Whether the customer consented to receive email updates from the shop

cancel_reason

text

[en] The reason why the order was canceled. Valid values:customer: The customer canceled the order. fraud: The order was fraudulent. inventory: Items in the order were not in inventory. declined: The payment was declined. other: A reason not in this list.

cancelled_at

timestamp

[en] The date and time when the order was canceled – in order's timezone

cart_token

text

[en] The ID of the cart that's associated with the order

checkout_id

text

checkout_token

text

[en] The ID of the checkout that's associated with the order

closed_at

timestamp

[en] The date and time when the order was closed – in order's timezone

confirmed

boolean

contact_email

text

created_at

timestamp

[en] The autogenerated date and time when the order was created in Shopify – in order's timezone

currency

text

[en] The three-letter code (ISO 4217 format) for the shop currency.

current_subtotal_price

float

[en] The current subtotal price of the order in the shop currency. The value of this field reflects order edits, returns, and refunds

currentsubtotalpricepresentmentamount

float

currentsubtotalpricepresentmentcurrency

text

currentsubtotalpriceshopamount

float

currentsubtotalpriceshopcurrency

text

current_total_discounts

float

[en] The current total discounts on the order in the shop currency. The value of this field reflects order edits, returns, and refunds

currenttotaldiscountspresentmentamount

float

currenttotaldiscountspresentmentcurrency

text

currenttotaldiscountsshopamount

float

currenttotaldiscountsshopcurrency

text

currenttotaldutiespresentmentamount

float

currenttotaldutiespresentmentcurrency

text

currenttotaldutiesshopamount

float

currenttotaldutiesshopcurrency

text

current_total_price

float

[en] The current total price of the order in the shop currency. The value of this field reflects order edits, returns, and refunds

currenttotalpricepresentmentamount

float

currenttotalpricepresentmentcurrency

text

currenttotalpriceshopamount

float

currenttotalpriceshopcurrency

text

current_total_tax

float

[en] The current total taxes charged on the order in the shop currency. The value of this field reflects order edits, returns, or refunds

currenttotaltaxpresentmentamount

float

currenttotaltaxpresentmentcurrency

text

currenttotaltaxshopamount

float

currenttotaltaxshopcode

text

customer_locale

text

[en] The two or three-letter language code, optionally followed by a region modifier

device_id

text

email

text

[en] The customer's email address

financial_status

text

[en] The status of payments associated with the order. Can only be set when the order is created. Valid values: pending: The payments are pending. Payment might fail in this state. Check again to confirm whether the payments have been paid successfully; authorized: The payments have been authorized; partially_paid: The order have been partially paid; paid: The payments have been paid; partially_refunded: The payments have been partially refunded; refunded: The payments have been refunded; voided: The payments have been voided

fulfillment_status

text

[en] The order's status in terms of fulfilled line items. Valid values:fulfilled: Every line item in the order has been fulfilled.; empty: None of the line items in the order have been fulfilled.; partial: At least one line item in the order has been fulfilled.; restocked: Every line item in the order has been restocked and the order canceled.

gateway

text

[en] The payment gateway used

landing_site

text

[en] The URL for the page where the buyer landed when they entered the shop.

landing_site_ref

text

location_id

text

[en] The ID of the physical location where the order was processed. This property refers to the POS location. location_id will always be set to empty for online orders

name

text

[en] The order name, generated by combining the order_number property with the order prefix and suffix that are set in the merchant's general settings. This is different from the id property, which is the ID of the order used by the API.

note

text

[en] An optional note that a shop owner can attach to the order.

number

text

[en] The order's position in the shop's count of orders. Numbers are sequential and start at 1

order_number

text

[en] The order 's position in the shop's count of orders starting at 1001. Order numbers are sequential and start at 1001

order_status_url

text

originaltotaldutiespresentmentamount

float

originaltotaldutiespresentmentcurrency

text

originaltotaldutiesshopamount

float

originaltotaldutiesshopcurrency

text

phone

text

[en] The customer's phone number for receiving SMS notifications

presentment_currency

text

[en] The presentment currency that was used to display prices to the customer

processed_at

timestamp

[en] The date and time when an order was processed. This value is the date that appears on your orders and that's used in the analytic reports. By default, it matches the created_at value. If you're importing orders from an app or another platform, then you can set processed_at to a date and time in the past to match when the original order was created – in order's timezone

processing_method

text

[en] How the payment was processed. It has the following valid values: checkout: The order was processed using the Shopify checkout.; direct: The order was processed using a direct payment provider.; manual: The order was processed using a manual payment method.; offsite: The order was processed by an external payment provider to the Shopify checkout.; express: The order was processed using PayPal Express Checkout.; free: The order was processed as a free order using a discount code

reference

text

referring_site

text

[en] The website where the customer clicked a link to the shop

source_identifier

text

source_name

text

[en] Where the order originated. Can be set only during order creation, and is not writeable afterwards. Values for Shopify channels are protected and cannot be assigned by other API clients: web, pos, shopify_draft_order, iphone, and android. Orders created via the API can be assigned any other string of your choice. If unspecified, then new orders are assigned the value of your app's ID

source_url

text

subtotal_price

float

[en] The price of the order in the shop currency after discounts but before shipping, taxes, and tips

subtotalpricepresentmentamount

float

subtotalpricepresentmentcurrency

text

subtotalpriceshopamount

float

subtotalpriceshopcurrency

text

tags

text

[en] Tags attached to the order, formatted as a string of comma-separated values. Tags are additional short descriptors, commonly used for filtering and searching. Each individual tag is limited to 40 characters in length

taxes_included

boolean

[en] Whether taxes are included in the order subtotal

test

boolean

[en] Whether this is a test order

token

text

[en] A unique token for the order

total_discounts

float

[en] The total discounts applied to the price of the order in the shop currency

totaldiscountspresentmentamount

float

totaldiscountspresentmentcurrency

text

totaldiscountsshopamount

float

totaldiscountsshopcurrency

text

total_line_items_price

float

[en] The sum of all line item prices in the shop currency

totallineitemspricepresentmentamount

float

totallineitemspricepresentmentcurrency

text

totallineitemspriceshopamount

float

totallineitemspriceshopcurrency

text

total_outstanding

float

[en] The total outstanding amount of the order in the shop currency

total_price

float

[en] The sum of all line item prices, discounts, shipping, taxes, and tips in the shop currency. Must be positive

totalpricepresentmentamount

float

totalpricepresentmentcurrency

text

totalpriceshopamount

float

totalpriceshopcurrency

text

total_price_usd

float

totalshippingpricepresentmentamount

float

totalshippingpricepresentmentcurrency

text

totalshippingpriceshopamount

float

totalshippingpriceshopcurrency

text

total_tax

float

[en] The sum of all the taxes applied to the order in th shop currency. Must be positive)

totaltaxpresentmentamount

float

totaltaxpresentmentcurrency

text

totaltaxshopamount

float

totaltaxshopcurrency

text

total_tip_received

float

[en] The sum of all the tips in the order in the shop currency

total_weight

float

[en] The sum of all line item weights in grams

updated_at

timestamp

[en] The date and time when the order was last modified. This value can change when no visible fields of an order have been updated

user_id

text

[en] The URL pointing to the order status web page, if applicable

Orders details

Campo Tipo

order_id

float

    Orders > > id

billing_address_address1

text

billing_address_address2

text

billing_address_city

text

billing_address_company

text

billing_address_country

text

billing_address_country_code

text

billing_address_first_name

text

billing_address_last_name

text

billing_address_latitude

text

billing_address_longitude

text

billing_address_name

text

billing_address_phone

text

billing_address_province

text

billing_address_province_code

text

billing_address_zip

text

customer_accepts_marketing

boolean

customer_accepts_marketing_updated_at

timestamp

customer_created_at

timestamp

[en] The date and time (ISO 8601 format) when the customer was created.

customer_currency

text

[en] The three-letter code

customer_default_address_address1

text

[en] The customer's mailing address.

customer_default_address_address2

text

[en] An additional field for the customer's mailing address.

customer_default_address_city

text

[en] The customer's city, town, or village.

customer_default_address_company

text

[en] The customer's company.

customer_default_address_country

text

[en] he customer's country.

customer_default_address_country_code

text

[en] The two-letter country code corresponding to the customer's country.

customer_default_address_country_name

text

[en] The customer's normalized country name.

customer_default_address_customer_id

text

[en] A unique identifier for the customer.

customer_default_address_default

boolean

[en] Whether this address is the default address for the customer.

customer_default_address_first_name

text

[en] The customer's first name.

customer_default_address_id

text

[en] A unique identifier for the address.

customer_default_address_last_name

text

[en] The customer's last name.

customer_default_address_name

text

[en] The customer's first and last names.

customer_default_address_phone

text

[en] The customer's phone number at this address.

customer_default_address_province

text

[en] The customer's region name. Typically a province, a state, or a prefecture.

customer_default_address_province_code

text

[en] The code for the region of the address.

customer_default_address_zip

text

customer_email

text

customer_first_name

text

customer_id

float

    Customers > > customer_id

customer_last_name

text

customer_last_order_id

float

customer_last_order_name

text

customer_multipass_identifier

text

customer_note

text

customer_orders_count

float

[en] The number of orders associated with this customer. Test and archived orders aren't counted.

customer_phone

text

customer_state

text

[en] The state of the customer's account with a shop.

customer_tags

text

customer_tax_exempt

boolean

customer_tax_exemptions

text

customer_total_spent

float

[en] The total amount of money that the customer has spent across their order history.

customer_updated_at

timestamp

[en] The date and time (ISO 8601 format) when the customer information was last updated.

customer_verified_email

boolean

[en] Whether the customer has verified their email address.

payment_gateway_names

text

shipping_address_address1

text

shipping_address_address2

text

shipping_address_city

text

shipping_address_company

float

shipping_address_country

text

shipping_address_country_code

text

shipping_address_first_name

text

shipping_address_last_name

text

shipping_address_latitude

float

shipping_address_longitude

float

shipping_address_name

text

shipping_address_phone

text

shipping_address_province

text

shipping_address_province_code

text

shipping_address_zip

text

Orders Shipping Lines

Campo Tipo

order_id

float

[en] Order id

    Orders > > id

id

float

[en] shipping id

carrier_identifier

text

[en] A reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service.

code

text

[en] A reference to the shipping method.

delivery_category

text

discounted_price

float

[en] The price of the shipping method after line-level discounts have been applied.

discounted_price_set_presentment_money_amount

float

discounted_price_set_presentment_money_currency_code

text

discounted_price_set_shop_money_currency_code

text

discounted_price_set_shop_money_amount

float

phone

text

price

float

[en] The price of this shipping method in the shop currency. Can't be negative.

price_set_presentment_money_amount

float

price_set_presentment_money_currency_code

text

price_set_shop_money_amount

float

price_set_shop_money_currency_code

text

requested_fulfillment_service_id

text

[en] A reference to the fulfillment service that is being requested for the shipping method.

source

text

[en] The source of the shipping method.

title

text

[en] The title of the shipping method.

Orders Discount Applications

Campo Tipo

order_id

float

[en] Order id

    Orders > > id

allocation_method

text

code

text

target_selection

text

target_type

text

[en] Whether the discount is applied on line items or shipping lines.

type

text

value

float

[en] The value of the discount application.

value_type

text

Orders Fulfillments

Campo Tipo

order_id

float

[en] Order id

    Orders > > id

id

float

[en] Fulfillments id

created_at

timestamp

[en] The autogenerated date and time (ISO 8601 format) when the order was created in Shopify. The value for this property cannot be changed.

location_id

float

name

text

receipt_authorization

text

receipt_testcase

boolean

service

text

shipment_status

text

status

text

[en] Orders of a given fulfillment status.

tracking_company

text

[en] The name of the fulfillment service.

tracking_number

text

[en] The fulfillment's tracking number.

tracking_url

text

updated_at

timestamp

[en] A timestamp for when the fulfillment's was updated.

Orders Discount Codes

Campo Tipo

order_id

float

[en] Order id

    Orders > > id

amount

float

[en] The amount that's deducted from the order total

code

text

[en] When the associated discount application is of type code, this property returns the discount code that was entered at checkout. Otherwise this property returns the title of the discount that was applied

type

text

[en] The type of discount: fixed_amount: Applies amount as a unit of the store's currency. For example, if amount is 30 and the store's currency is USD, then 30 USD is deducted from the order total when the discount is applied; percentage: Applies a discount of amount as a percentage of the order total; shipping: Applies a free shipping discount on orders that have a shipping rate less than or equal to amount. For example, if amount is 30, then the discount will give the customer free shipping for any shipping rate that is less than or equal to $30

Orders Transactions

Campo Tipo

order_id

float

[en] The ID for the order that the transaction is associated with.

    Orders > > id

transaction_id

float

[en] Transaction Id

amount

float

[en] The amount of money included in the transaction.

authorization

text

[en] The authorization code associated with the transaction.

created_at

timestamp

[en] The date and time when the transaction was created.

currency

text

[en] The three-letter code for the currency used for the payment.

device_id

text

[en] The ID for the device.

error_code

text

[en] A standardized error code.

gateway

text

[en] The name of the gateway the transaction was issued through.

kind

text

[en] The transaction's type.

location_id

text

[en] The ID of the physical location where the transaction was processed.

message

text

[en] A string generated by the payment provider with additional information about why the transaction succeeded or failed.

parent_id

text

[en] The ID of an associated transaction.

processed_at

timestamp

[en] The date and time when a transaction was processed.

receipt_x_account_id

text

receipt_x_amount

float

receipt_x_currency

text

receipt_x_gateway_reference

text

receipt_x_reference

float

receipt_x_result

text

receipt_x_signature

text

receipt_x_test

text

receipt_x_timestamp

text

source_name

text

[en] The origin of the transaction.

status

text

[en] The status of the transaction.

test

boolean

[en] Whether the transaction is a test transaction.

user_id

text

[en] The ID for the user who was logged into the Shopify POS device when the order was processed, if applicable.

Orders Note Attributes

Campo Tipo

order_id

float

[en] Order id

    Orders > > id

name

text

[en] Name/key of the additional detail about the order

value

text

[en] Value of the name/key of the additional detail about the order

Orders Line Items

Campo Tipo

order_id

float

[en] Order id

    Orders > > id

id

float

[en] The ID of the line item.

fulfillable_quantity

float

fulfillment_service

text

[en] The fulfillment service for the vartiant associated with the line item.

fulfillment_status

text

gift_card

boolean

[en] Returns true if the product associated with the line item is a gift card.

grams

float

[en] The weight of the line item in the store's default weight unit.

name

text

destination_location_address1

text

destination_location_address2

text

destination_location_city

text

destination_location_country_code

text

destination_location_id

float

destination_location_name

text

destination_location_province_code

text

destination_location_zip

text

origin_location_address1

text

origin_location_address2

text

origin_location_city

text

origin_location_country_code

text

origin_location_id

float

origin_location_name

text

origin_location_province_code

text

origin_location_zip

text

price

float

price_set_presentment_money_currency_code

text

price_set_presentment_money_amount

float

price_set_shop_money_currency_code

text

price_set_shop_money_amount

text

product_exists

boolean

product_id

float

[en] The ID of the line item's product.

    Products > > id

quantity

float

[en] The quantity of the line item.

requires_shipping

boolean

[en] Returns true if the variant associated with the line item requires shipping. Returns false if not.

sku

text

[en] The sku of the variant associated with the line item.

taxable

boolean

[en] Returns true if taxes should be charged on the line item. Returns false if not.

title

text

[en] The title of the line item. The title is a combination of line_item.product.title and line_item.variant.title, separated by a hyphen.

total_discount

float

total_discount_set_presentment_money_currency_code

text

total_discount_set_presentment_money_amount

float

total_discount_set_shop_money_currency_code

text

total_discount_set_shop_money_amount

float

variant_id

float

[en] The ID of the line item's variant.

variant_inventory_management

text

variant_title

text

vendor

text

[en] The vendor of the variant associated with the line item.

Orders Visits UTM Parameters

Campo Tipo

order_id

float

[en] The id of the order

    Orders > > id

utmparameters_campaign

text

[en] The name of a marketing campaign.

utmparameters_content

text

[en] Identifies specific content in a marketing campaign. Used to differentiate between similar content or links in a marketing campaign to determine which is the most effective

utmparameters_medium

text

[en] The medium of a marketing campaign, such as a banner or email newsletter

utmparameters_source

text

[en] The source of traffic to the merchant's store, such as Google or an email newsletter

utmparameters_term

float

[en] Paid search terms used by a marketing campaign

occurred_at

timestamp

[en] The date and time when the customer's session occurred.

Orders Refunds

Campo Tipo

order_id

text

[en] Order id

    Orders > > id

id

text

created_at

timestamp

note

text

processed_at

timestamp

user_id

text

Products

Campo Tipo

id

float

[en] An unsigned 64-bit integer that's used as a unique identifier for the product.

body_html

text

[en] A description of the product. Supports HTML formatting.

created_at

timestamp

[en] The date and time (ISO 8601 format) when the product was created.

handle

text

[en] A unique human-friendly string for the product. Automatically generated from the product's title. Used by the Liquid templating language to refer to objects.

image_alt

text

image_created_at

timestamp

image_height

float

image_id

float

[en] Id of the product's first image

image_position

float

image_src

text

image_updated_at

timestamp

image_width

float

product_type

text

[en] A categorization for the product used for filtering and searching products.

published_at

timestamp

[en] The date and time (ISO 8601 format) when the product was published. Can be set to null to unpublish the product from the Online Store channel.

published_scope

text

[en] Whether the product is published to the Point of Sale channel.

status

text

[en] The status of the product. Valid values: active, archived, draft

tags

text

[en] A string of comma-separated tags that are used for filtering and search. A product can have up to 250 tags.

template_suffix

text

[en] The suffix of the Liquid template used for the product page. If this property is specified, then the product page uses a template called 'product.suffix.liquid', where 'suffix' is the value of this property. If this property is or null, then the product page uses the default template 'product.liquid'. (default: null)

title

text

[en] The name of the product.

updated_at

timestamp

[en] The date and time (ISO 8601 format) when the product was last modified.

vendor

text

[en] The name of the product's vendor.

Products: options

Campo Tipo

product_id

float

[en] Product's id

    Products > > id

option_id

float

[en] Product option id

options_name

text

options_position

float

options_values

text

Products: variants

Campo Tipo

product_id

float

[en] The id of the product

    Products > > id

id

float

[en] The unique numeric identifier for the product variant

inventory_item_id

float

[en] The unique identifier for the inventory item

sku

text

[en] A unique identifier for the product variant in the shop

barcode

text

[en] The barcode, UPC, or ISBN number for the product

compare_at_price

float

[en] The original price of the item before an adjustment or a sale

created_at

timestamp

[en] The date and time when the product variant was created

fulfillment_service

text

[en] The fulfillment service associated with the product variant

grams

float

[en] The weight of the product variant in grams

image_id

text

[en] The unique numeric identifier for a product's image

inventory_management

text

[en] The fulfillment service that tracks the number of items in stock for the product variant

inventory_policy

text

[en] Whether customers are allowed to place an order for the product variant when it's out of stock

inventory_quantity

float

[en] An aggregate of inventory across all locations

option1

text

[en] The custom property #1 that a shop owner uses to define product variants

option2

text

[en] The custom property #2 that a shop owner uses to define product variants

option3

text

[en] The custom property #3 that a shop owner uses to define product variants

position

float

[en] The order of the product variant in the list of product variants. The first position in the list is 1. The position of variants is indicated by the order in which they are listed

price

float

[en] The price of the product variant

taxable

boolean

[en] Whether a tax is charged when the product variant is sold

title

text

[en] The title of the product variant. The title field is a concatenation of the option1, option2, and option3 fields

updated_at

timestamp

[en] The date and time when the product variant was last modified

weight

float

[en] The weight of the product variant in the unit system specified with weight_unit

weight_unit

text

[en] The unit of measurement that applies to the product variant's weight

Products: images

Campo Tipo

product_id

float

    Products > > id

alt

text

created_at

timestamp

height

float

id

float

position

float

src

text

updated_at

timestamp

width

float

Inventory: items

Campo Tipo

inventory_item_id

float

[en] The ID for the inventory item.

    Products: variants > > inventory_item_id

available

float

[en] The available quantity of an inventory item at the inventory level's associated location. Returns null if the inventory item is not tracked.

location_id

float

[en] A comma-separated list of location IDs.

updated_at

timestamp

[en] The date and time (ISO 8601 format) when the inventory level was last modified.

Events

Campo Tipo

event_id

float

[en] The ID of the event.

arguments

text

[en] Refers to a certain event and its resources.

author

text

created_at

timestamp

[en] The date and time when the event was created.

description

text

[en] A human readable description of the event.

message

text

[en] A human readable description of the event. Can contain some HTML formatting.

path

text

[en] A relative URL to the resource the event is for, if applicable.

subject_id

float

[en] The ID of the resource that generated the event.

    Products > > id

    Orders > > id

subject_type

text

[en] The type of the resource that generated the event.

verb

text

[en] The type of event that occurred. Different resources generate different types of event.

Customers

Objeto principal

Campo Tipo

customer_id

float

[en] A unique identifier for the customer.

accepts_marketing

boolean

[en] Whether the customer has consented to receive marketing material by email.

accepts_marketing_updated_at

timestamp

[en] when the customer consented or objected to receiving marketing material by email.

created_at

timestamp

[en] The date and time (ISO 8601 format) when the customer was created.

currency

text

[en] The three-letter code (ISO 4217 format) for the currency that the customer used when they paid for their last order.

default_address_address1

text

[en] The customer's mailing address.

default_address_address2

text

[en] An additional field for the customer's mailing address.

default_address_city

text

[en] The customer's city, town, or village.

default_address_company

text

[en] The customer's company.

default_address_country

text

[en] The customer's country.

default_address_country_code

text

[en] The two-letter country code corresponding to the customer's country.

default_address_country_name

text

[en] The customer's normalized country name.

default_address_customer_id

float

[en] A unique identifier for the customer.

default_address_default

boolean

[en] Whether this address is the default address for the customer.

default_address_first_name

text

[en] The customer's first name.

default_address_id

float

[en] A unique identifier for the address.

default_address_last_name

text

[en] The customer's last name.

default_address_name

text

[en] The customer's first and last names.

default_address_phone

text

[en] The customer's phone number at this address.

default_address_province

text

[en] The customer's region name. Typically a province, a state, or a prefecture.

default_address_province_code

text

[en] The code for the region of the address, such as the province, state, or district.

default_address_zip

text

[en] The customer's postal code, also known as zip, postcode, Eircode, etc.

email

text

[en] The unique email address of the customer. Attempting to assign the same email address to multiple customers returns an error.

email_marketing_consent_consent_updated_at

timestamp

[en] The date and time when the customer consented to receive marketing material by email.

email_marketing_consent_opt_in_level

text

[en] The marketing subscription opt-in level, as described in the M3AAWG Sender Best Common Practices, that the customer gave when they consented to receive marketing material by email.

email_marketing_consent_state

text

[en] The current email marketing state for the customer.

first_name

text

[en] The customer's first name.

last_name

text

[en] The customer's last name.

last_order_id

text

[en] The ID of the customer's last order.

last_order_name

text

[en] The name of the customer's last order. This is directly related to the name field on the Order resource.

marketing_opt_in_level

text

multipass_identifier

text

[en] A unique identifier for the customer that's used with Multipass login.

note

text

[en] A note about the customer.

orders_count

float

[en] The number of orders associated with this customer. Test and archived orders aren't counted.

phone

text

[en] The unique phone number (E.164 format) for this customer.

sms_marketing_consent

text

state

text

tags

text

[en] Tags that the shop owner has attached to the customer, formatted as a string of comma-separated values.

tax_exempt

boolean

[en] Whether the customer is exempt from paying taxes on their order.

total_spent

float

[en] The total amount of money that the customer has spent across their order history.

updated_at

timestamp

[en] The date and time (ISO 8601 format) when the customer information was last updated.

verified_email

boolean

[en] Whether the customer has verified their email address.

shopify_customers_addresses

Campo Tipo

customer_id

float

[en] A unique identifier for the customer.

addresses_address1

text

[en] The customer's mailing address.

addresses_address2

text

[en] An additional field for the customer's mailing address.

addresses_city

text

[en] The customer's city, town, or village.

addresses_company

text

[en] The customer's company.

addresses_country

text

[en] The customer's country.

addresses_country_code

text

[en] The two-letter country code corresponding to the customer's country.

addresses_country_name

text

[en] The customer's normalized country name.

addresses_customer_id

float

[en] A unique identifier for the customer.

addresses_default

boolean

[en] Whether this address is the default address for the customer.

addresses_first_name

text

[en] The customer's first name.

addresses_id

float

[en] A unique identifier for the address.

addresses_last_name

text

[en] The customer's last name.

addresses_name

text

[en] The customer's first and last names.

addresses_phone

text

[en] The customer's phone number at this address.

addresses_province

text

[en] The customer's region name. Typically a province, a state, or a prefecture.

addresses_province_code

text

[en] The code for the region of the address, such as the province, state, or district.

addresses_zip

text

[en] The customer's postal code, also known as zip, postcode, Eircode, etc.

Abandoned Checkouts

Campo Tipo

id

float

[en] The ID for the checkout.

abandoned_checkout_url

text

[en] The recovery URL that's sent to a customer so they can recover their checkout.

billing_address_address1

text

[en] The street address of the billing address.

billing_address_address2

text

[en] An optional additional field for the street address of the billing address.

billing_address_city

text

[en] The city of the billing address.

billing_address_company

text

[en] The company of the person associated with the billing address.

billing_address_country

text

[en] The name of the country of the billing address.

billing_address_country_code

text

[en] The two-letter code (ISO 3166-1 alpha-2 format) for the country of the billing address.

billing_address_first_name

text

[en] The first name of the person associated with the payment method.

billing_address_last_name

text

[en] The last name of the person associated with the payment method.

billing_address_latitude

float

[en] The latitude of the billing address.

billing_address_longitude

float

[en] The longitude of the billing address.

billing_address_name

text

[en] The full name of the person associated with the payment method.

billing_address_phone

float

[en] The phone number at the billing address.

billing_address_province

text

[en] The name of the state or province of the billing address.

billing_address_province_code

text

[en] The two-letter abbreviation of the state or province of the billing address.

billing_address_zip

text

[en] The zip or postal code of the billing address.

buyer_accepts_marketing

boolean

[en] Whether the customer would like to receive email updates from the shop. This is set by the I want to receive occasional emails about new products, promotions and other news checkbox during checkout.

buyer_accepts_sms_marketing

boolean

[en] Whether the customer would like to receive SMS updates from the shop. This is set by the Text me with news and offers checkbox during checkout.

cart_token

text

[en] The ID for the cart that's attached to the checkout.

closed_at

text

[en] The date and time (ISO 8601 format) when the checkout was closed. If the checkout was not closed, then this value is null.

completed_at

timestamp

[en] The date and time (ISO 8601 format) when the checkout was completed. For abandoned checkouts, this value is null until a customer completes the checkout using the recovery URL.

created_at

timestamp

[en] The date and time (ISO 8601 format) when the checkout was created.

currency

text

[en] The three-letter code (ISO 4217 format) of the shop's default currency at the time of checkout. For the currency that the customer used at checkout, see presentment_currency.

customer_accepts_marketing

boolean

customer_accepts_marketing_updated_at

timestamp

customer_admin_graphql_api_id

text

customer_created_at

timestamp

customer_currency

text

customer_default_address_province

text

customer_default_address_address1

text

customer_default_address_address2

text

customer_default_address_city

text

customer_default_address_company

text

customer_default_address_country

text

customer_default_address_country_code

text

customer_default_address_country_name

text

customer_default_address_customer_id

text

    Customers > > customer_id

customer_default_address_default

text

customer_default_address_first_name

text

customer_default_address_id

text

    Customers > > customer_id

customer_default_address_last_name

text

customer_default_address_name

text

customer_default_address_phone

text

customer_default_address_province_code

text

customer_default_address_zip

text

customer_email

text

customer_email_marketing_consent_opt_in_level

text

customer_email_marketing_consent_consent_updated_at

text

customer_email_marketing_consent_state

text

customer_first_name

text

customer_id

float

    Customers > > customer_id

customer_last_name

text

customer_last_order_id

float

customer_last_order_name

text

customer_marketing_opt_in_level

text

customer_multipass_identifier

text

customer_note

text

customer_orders_count

float

customer_phone

text

customer_sms_marketing_consent

text

customer_state

text

customer_tags

text

customer_tax_exempt

boolean

customer_tax_exemptions

text

customer_total_spent

float

customer_updated_at

timestamp

customer_verified_email

boolean

customer_locale

text

[en] The two or three-letter language code, optionally followed by a region modifier. Example values: en, en-CA.

device_id

text

[en] The ID of the Shopify POS device that created the checkout.

email

text

[en] The customer's email address.

gateway

text

[en] The payment gateway used by the checkout. For abandoned checkouts, this value is always null.

landing_site

text

[en] The URL for the page where the customer entered the shop.

location_id

text

[en] The ID of the physical location where the checkout was processed.

name

text

note

text

[en] The text of an optional note that a shop owner can attach to the order.

phone

text

[en] Learn more about accessing protected data The customer's phone number for receiving SMS notifications.

presentment_currency

text

[en] The three-letter code (ISO 4217 format) of the currency that the customer used at checkout. For the shop's default currency, see currency.

referring_site

text

[en] The website that referred the customer to the shop.

shipping_address_address1

text

[en] The street address of the shipping address.

shipping_address_address2

text

[en] An optional additional field for the street address of the shipping address.

shipping_address_city

text

[en] The city of the shipping address.

shipping_address_company

text

[en] The company of the person associated with the shipping address.

shipping_address_country

text

shipping_address_country_code

text

[en] The two-letter code (ISO 3166-1 alpha-2 format) for the country of the shipping address.

shipping_address_first_name

text

[en] The first name of the person associated with the shipping address.

shipping_address_last_name

text

[en] The last name of the person associated with the shipping address.

shipping_address_latitude

float

[en] The latitude of the shipping address.

shipping_address_longitude

float

[en] The longitude of the shipping address.

shipping_address_name

text

[en] The full name of the person associated with the shipping address.

shipping_address_phone

float

[en] The phone number at the shipping address.

shipping_address_province

text

[en] The name of the state or province of the shipping address.

shipping_address_province_code

text

[en] The two-letter abbreviation of the state or province of the shipping address.

shipping_address_zip

text

[en] The zip or postal code of the shipping address.

sms_marketing_phone

text

[en] The phone number used to opt in to SMS marketing during checkout.

source

text

source_identifier

text

source_name

text

[en] Where the checkout originated. Valid values: web, pos, iphone, android.

source_url

text

subtotal_price

float

[en] The price of the checkout in presentment currency before shipping and taxes.

taxes_included

boolean

[en] Whether taxes are included in the price.

token

text

[en] A unique ID for a checkout.

total_discounts

float

[en] The total amount of discounts to be applied in presentment currency.

total_duties

text

[en] The total duties of the checkout in presentment currency.

total_line_items_price

float

[en] The sum of the prices of all line items in the checkout in presentment currency.

total_price

float

[en] The sum of line item prices, all discounts, shipping costs, and taxes for the checkout in presentment currency.

total_tax

float

[en] The sum of all the taxes applied to the checkout in presentment currency.

total_weight

float

[en] The sum of all the weights in grams of the line items in the checkout.

updated_at

timestamp

[en] The date and time (ISO 8601 format) when the checkout was last modified.

user_id

text

[en] The ID of the user who created the checkout.

Abandoned Checkouts: shipping lines

Campo Tipo

checkout_id

float

[en] The ID for the checkout.

    Abandoned Checkouts > > id

shipping_lines_id

text

shipping_lines_carrier_identifier

text

shipping_lines_carrier_service_id

text

shipping_lines_code

text

[en] A reference to the shipping method.

shipping_lines_custom_tax_lines

text

shipping_lines_delivery_category

text

shipping_lines_delivery_expectation_range

text

shipping_lines_delivery_expectation_type

text

shipping_lines_delivery_option_group_token

text

shipping_lines_delivery_option_group_type

text

shipping_lines_estimated_delivery_time_range

text

shipping_lines_markup

text

shipping_lines_original_rate_price

text

shipping_lines_original_shop_markup

text

shipping_lines_original_shop_price

float

shipping_lines_phone

text

shipping_lines_presentment_title

text

shipping_lines_price

float

[en] The price of the shipping method in presentment currency.

shipping_lines_requested_fulfillment_service_id

text

shipping_lines_source

text

[en] The channel where the checkout originated. Example value: shopify.

shipping_lines_title

text

[en] The title of the shipping method. Example value: International Shipping.

shipping_lines_validation_context

text

Abandoned Checkouts: note attributes

Campo Tipo

checkout_id

float

[en] The ID for the checkout.

    Abandoned Checkouts > > id

note_attributes_name

text

note_attributes_value

text

Abandoned Checkouts: line items

Campo Tipo

checkout_id

float

[en] The ID for the checkout.

    Abandoned Checkouts > > id

compare_at_price

float

destination_location_id

float

fulfillment_service

text

[en] The fulfillment service provider for the item

gift_card

boolean

grams

float

[en] The weight of the item in grams

key

text

line_price

float

origin_location_id

float

presentment_title

text

presentment_variant_title

text

price

float

[en] The price of the item in presentment currency

product_id

float

[en] The product ID od the item

quantity

float

[en] The number of products that were purchased

rank

text

requires_shipping

boolean

[en] Whether the items requires shipping

sku

text

[en] A unique identifier for the item in the shop

taxable

boolean

title

text

[en] The title of the product

variant_id

float

[en] The product variant ID of item

    Products: variants > > id

variant_price

float

variant_title

text

[en] The title of the product variant

vendor

text

[en] The name of the item's supplier

Abandoned Checkouts: discount codes

Campo Tipo

checkout_id

float

[en] The ID for the checkout.

    Abandoned Checkouts > > id

discount_codes_amount

float

[en] The amount of the discount in presentment currency.

discount_codes_code

text

[en] The discount code.

discount_codes_type

text

[en] The type of discount. Valid values: percentage, shipping, fixed_amount. (default: fixed_amount)

Orders Line Items: propriedades customizadas

Campo Tipo

order_id

float

[en] Order id

    Orders Line Items > > order_id

order_line_item_id

float

[en] The ID of the line item.

    Orders Line Items > > id

property_name

text

[en] The name (key) of the property.

property_value

text

[en] The value of the property.

Order timeline events

Campo Tipo

event_id

text

[en] The ID of the event.

order_id

text

[en] The ID of the order that generated the event.

    Orders > > id

arguments

text

[en] Refers to a certain event and its resources.

author

text

created_at

timestamp

[en] The date and time when the event was created.

description

text

[en] A human readable description of the event.

message

text

[en] A human readable description of the event. Can contain some HTML formatting.

path

text

[en] A relative URL to the resource the event is for, if applicable.

verb

text

[en] The type of event that occurred. Different resources generate different types of event.