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
- Abandoned Checkouts
- Abandoned Checkouts: discount codes
- Abandoned Checkouts: line items
- Abandoned Checkouts: note attributes
- Abandoned Checkouts: shipping lines
- Customers
- Events
- Inventory: items
- Order timeline events
- Orders
- Orders Details
- Orders Discount Applications
- Orders Discount Codes
- Orders Fulfillments
- Orders Line Items
- Orders Line Items: propriedades customizadas
- Orders Note Attributes
- Orders Refunds
- Orders Shipping Lines
- Orders Transactions
- Orders Visits UTM Parameters
- Products
- Products: images
- Products: options
- Products: variants
Gráfico de relacionamento
Clique para ampliar
Orders
Campo | Tipo | |
---|---|---|
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 |
|
float |
[en] The ID of the app that created the order. |
|
text |
[en] The IP address of the browser used by the customer when they placed the order |
|
boolean |
[en] Whether the customer consented to receive email updates from the shop |
|
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. |
|
timestamp |
[en] The date and time when the order was canceled – in order's timezone |
|
text |
[en] The ID of the cart that's associated with the order |
|
text |
||
text |
[en] The ID of the checkout that's associated with the order |
|
timestamp |
[en] The date and time when the order was closed – in order's timezone |
|
boolean |
||
text |
||
timestamp |
[en] The autogenerated date and time when the order was created in Shopify – in order's timezone |
|
text |
[en] The three-letter code (ISO 4217 format) for the shop currency. |
|
float |
[en] The current subtotal price of the order in the shop currency. The value of this field reflects order edits, returns, and refunds |
|
float |
||
text |
||
float |
||
text |
||
float |
[en] The current total discounts on the order in the shop currency. The value of this field reflects order edits, returns, and refunds |
|
float |
||
text |
||
float |
||
text |
||
float |
||
text |
||
float |
||
text |
||
float |
[en] The current total price of the order in the shop currency. The value of this field reflects order edits, returns, and refunds |
|
float |
||
text |
||
float |
||
text |
||
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 |
|
float |
||
text |
||
float |
||
text |
||
text |
[en] The two or three-letter language code, optionally followed by a region modifier |
|
text |
||
text |
[en] The customer's email address |
|
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 |
|
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. |
|
text |
[en] The payment gateway used |
|
text |
[en] The URL for the page where the buyer landed when they entered the shop. |
|
text |
||
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 |
|
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. |
|
text |
[en] An optional note that a shop owner can attach to the order. |
|
text |
[en] The order's position in the shop's count of orders. Numbers are sequential and start at 1 |
|
text |
[en] The order 's position in the shop's count of orders starting at 1001. Order numbers are sequential and start at 1001 |
|
text |
||
float |
||
text |
||
float |
||
text |
||
text |
[en] The customer's phone number for receiving SMS notifications |
|
text |
[en] The presentment currency that was used to display prices to the customer |
|
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 |
|
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 |
|
text |
||
text |
[en] The website where the customer clicked a link to the shop |
|
text |
||
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 |
|
text |
||
float |
[en] The price of the order in the shop currency after discounts but before shipping, taxes, and tips |
|
float |
||
text |
||
float |
||
text |
||
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 |
|
boolean |
[en] Whether taxes are included in the order subtotal |
|
boolean |
[en] Whether this is a test order |
|
text |
[en] A unique token for the order |
|
float |
[en] The total discounts applied to the price of the order in the shop currency |
|
float |
||
text |
||
float |
||
text |
||
float |
[en] The sum of all line item prices in the shop currency |
|
float |
||
text |
||
float |
||
text |
||
float |
[en] The total outstanding amount of the order in the shop currency |
|
float |
[en] The sum of all line item prices, discounts, shipping, taxes, and tips in the shop currency. Must be positive |
|
float |
||
text |
||
float |
||
text |
||
float |
||
float |
||
text |
||
float |
||
text |
||
float |
[en] The sum of all the taxes applied to the order in th shop currency. Must be positive) |
|
float |
||
text |
||
float |
||
text |
||
float |
[en] The sum of all the tips in the order in the shop currency |
|
float |
[en] The sum of all line item weights in grams |
|
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 |
|
text |
[en] The URL pointing to the order status web page, if applicable |
Orders details
Campo | Tipo | |
---|---|---|
float |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
boolean |
||
timestamp |
||
timestamp |
[en] The date and time (ISO 8601 format) when the customer was created. |
|
text |
[en] The three-letter code |
|
text |
[en] The customer's mailing address. |
|
text |
[en] An additional field for the customer's mailing address. |
|
text |
[en] The customer's city, town, or village. |
|
text |
[en] The customer's company. |
|
text |
[en] he customer's country. |
|
text |
[en] The two-letter country code corresponding to the customer's country. |
|
text |
[en] The customer's normalized country name. |
|
text |
[en] A unique identifier for the customer. |
|
boolean |
[en] Whether this address is the default address for the customer. |
|
text |
[en] The customer's first name. |
|
text |
[en] A unique identifier for the address. |
|
text |
[en] The customer's last name. |
|
text |
[en] The customer's first and last names. |
|
text |
[en] The customer's phone number at this address. |
|
text |
[en] The customer's region name. Typically a province, a state, or a prefecture. |
|
text |
[en] The code for the region of the address. |
|
text |
||
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
||
text |
||
float |
[en] The number of orders associated with this customer. Test and archived orders aren't counted. |
|
text |
||
text |
[en] The state of the customer's account with a shop. |
|
text |
||
boolean |
||
text |
||
float |
[en] The total amount of money that the customer has spent across their order history. |
|
timestamp |
[en] The date and time (ISO 8601 format) when the customer information was last updated. |
|
boolean |
[en] Whether the customer has verified their email address. |
|
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
float |
||
float |
||
text |
||
text |
||
text |
||
text |
||
text |
Orders Shipping Lines
Campo | Tipo | |
---|---|---|
float |
[en] Order id |
|
float |
[en] shipping id |
|
text |
[en] A reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service. |
|
text |
[en] A reference to the shipping method. |
|
text |
||
float |
[en] The price of the shipping method after line-level discounts have been applied. |
|
float |
||
text |
||
text |
||
float |
||
text |
||
float |
[en] The price of this shipping method in the shop currency. Can't be negative. |
|
float |
||
text |
||
float |
||
text |
||
text |
[en] A reference to the fulfillment service that is being requested for the shipping method. |
|
text |
[en] The source of the shipping method. |
|
text |
[en] The title of the shipping method. |
Orders Discount Applications
Campo | Tipo | |
---|---|---|
float |
[en] Order id |
|
text |
||
text |
||
text |
||
text |
[en] Whether the discount is applied on line items or shipping lines. |
|
text |
||
float |
[en] The value of the discount application. |
|
text |
Orders Fulfillments
Campo | Tipo | |
---|---|---|
float |
[en] Order id |
|
float |
[en] Fulfillments id |
|
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. |
|
float |
||
text |
||
text |
||
boolean |
||
text |
||
text |
||
text |
[en] Orders of a given fulfillment status. |
|
text |
[en] The name of the fulfillment service. |
|
text |
[en] The fulfillment's tracking number. |
|
text |
||
timestamp |
[en] A timestamp for when the fulfillment's was updated. |
Orders Discount Codes
Campo | Tipo | |
---|---|---|
float |
[en] Order id |
|
float |
[en] The amount that's deducted from the order total |
|
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 |
|
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 | |
---|---|---|
float |
[en] The ID for the order that the transaction is associated with. |
|
float |
[en] Transaction Id |
|
float |
[en] The amount of money included in the transaction. |
|
text |
[en] The authorization code associated with the transaction. |
|
timestamp |
[en] The date and time when the transaction was created. |
|
text |
[en] The three-letter code for the currency used for the payment. |
|
text |
[en] The ID for the device. |
|
text |
[en] A standardized error code. |
|
text |
[en] The name of the gateway the transaction was issued through. |
|
text |
[en] The transaction's type. |
|
text |
[en] The ID of the physical location where the transaction was processed. |
|
text |
[en] A string generated by the payment provider with additional information about why the transaction succeeded or failed. |
|
text |
[en] The ID of an associated transaction. |
|
timestamp |
[en] The date and time when a transaction was processed. |
|
text |
||
float |
||
text |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
text |
[en] The origin of the transaction. |
|
text |
[en] The status of the transaction. |
|
boolean |
[en] Whether the transaction is a test transaction. |
|
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 | |
---|---|---|
float |
[en] Order id |
|
text |
[en] Name/key of the additional detail about the order |
|
text |
[en] Value of the name/key of the additional detail about the order |
Orders Line Items
Campo | Tipo | |
---|---|---|
float |
[en] Order id |
|
float |
[en] The ID of the line item. |
|
float |
||
text |
[en] The fulfillment service for the vartiant associated with the line item. |
|
text |
||
boolean |
[en] Returns true if the product associated with the line item is a gift card. |
|
float |
[en] The weight of the line item in the store's default weight unit. |
|
text |
||
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
||
boolean |
||
float |
[en] The ID of the line item's product. |
|
float |
[en] The quantity of the line item. |
|
boolean |
[en] Returns true if the variant associated with the line item requires shipping. Returns false if not. |
|
text |
[en] The sku of the variant associated with the line item. |
|
boolean |
[en] Returns true if taxes should be charged on the line item. Returns false if not. |
|
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. |
|
float |
||
text |
||
float |
||
text |
||
float |
||
float |
[en] The ID of the line item's variant. |
|
text |
||
text |
||
text |
[en] The vendor of the variant associated with the line item. |
Orders Visits UTM Parameters
Campo | Tipo | |
---|---|---|
float |
[en] The id of the order |
|
text |
[en] The name of a marketing campaign. |
|
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 |
|
text |
[en] The medium of a marketing campaign, such as a banner or email newsletter |
|
text |
[en] The source of traffic to the merchant's store, such as Google or an email newsletter |
|
float |
[en] Paid search terms used by a marketing campaign |
|
timestamp |
[en] The date and time when the customer's session occurred. |
Orders Refunds
Campo | Tipo | |
---|---|---|
text |
[en] Order id |
|
text |
||
timestamp |
||
text |
||
timestamp |
||
text |
Products
Campo | Tipo | |
---|---|---|
float |
[en] An unsigned 64-bit integer that's used as a unique identifier for the product. |
|
text |
[en] A description of the product. Supports HTML formatting. |
|
timestamp |
[en] The date and time (ISO 8601 format) when the product was created. |
|
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. |
|
text |
||
timestamp |
||
float |
||
float |
[en] Id of the product's first image |
|
float |
||
text |
||
timestamp |
||
float |
||
text |
[en] A categorization for the product used for filtering and searching products. |
|
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. |
|
text |
[en] Whether the product is published to the Point of Sale channel. |
|
text |
[en] The status of the product. Valid values: active, archived, draft |
|
text |
[en] A string of comma-separated tags that are used for filtering and search. A product can have up to 250 tags. |
|
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) |
|
text |
[en] The name of the product. |
|
timestamp |
[en] The date and time (ISO 8601 format) when the product was last modified. |
|
text |
[en] The name of the product's vendor. |
Products: options
Campo | Tipo | |
---|---|---|
float |
[en] Product's id |
|
float |
[en] Product option id |
|
text |
||
float |
||
text |
Products: variants
Campo | Tipo | |
---|---|---|
float |
[en] The id of the product |
|
float |
[en] The unique numeric identifier for the product variant |
|
float |
[en] The unique identifier for the inventory item |
|
text |
[en] A unique identifier for the product variant in the shop |
|
text |
[en] The barcode, UPC, or ISBN number for the product |
|
float |
[en] The original price of the item before an adjustment or a sale |
|
timestamp |
[en] The date and time when the product variant was created |
|
text |
[en] The fulfillment service associated with the product variant |
|
float |
[en] The weight of the product variant in grams |
|
text |
[en] The unique numeric identifier for a product's image |
|
text |
[en] The fulfillment service that tracks the number of items in stock for the product variant |
|
text |
[en] Whether customers are allowed to place an order for the product variant when it's out of stock |
|
float |
[en] An aggregate of inventory across all locations |
|
text |
[en] The custom property #1 that a shop owner uses to define product variants |
|
text |
[en] The custom property #2 that a shop owner uses to define product variants |
|
text |
[en] The custom property #3 that a shop owner uses to define product variants |
|
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 |
|
float |
[en] The price of the product variant |
|
boolean |
[en] Whether a tax is charged when the product variant is sold |
|
text |
[en] The title of the product variant. The title field is a concatenation of the option1, option2, and option3 fields |
|
timestamp |
[en] The date and time when the product variant was last modified |
|
float |
[en] The weight of the product variant in the unit system specified with weight_unit |
|
text |
[en] The unit of measurement that applies to the product variant's weight |
Products: images
Campo | Tipo | |
---|---|---|
float |
||
text |
||
timestamp |
||
float |
||
float |
||
float |
||
text |
||
timestamp |
||
float |
Inventory: items
Campo | Tipo | |
---|---|---|
float |
[en] The ID for the inventory item. |
|
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. |
|
float |
[en] A comma-separated list of location IDs. |
|
timestamp |
[en] The date and time (ISO 8601 format) when the inventory level was last modified. |
Events
Campo | Tipo | |
---|---|---|
float |
[en] The ID of the event. |
|
text |
[en] Refers to a certain event and its resources. |
|
text |
||
timestamp |
[en] The date and time when the event was created. |
|
text |
[en] A human readable description of the event. |
|
text |
[en] A human readable description of the event. Can contain some HTML formatting. |
|
text |
[en] A relative URL to the resource the event is for, if applicable. |
|
float |
[en] The ID of the resource that generated the event. |
|
text |
[en] The type of the resource that generated the event. |
|
text |
[en] The type of event that occurred. Different resources generate different types of event. |
Customers
Objeto principal
Campo | Tipo | |
---|---|---|
float |
[en] A unique identifier for the customer. |
|
boolean |
[en] Whether the customer has consented to receive marketing material by email. |
|
timestamp |
[en] when the customer consented or objected to receiving marketing material by email. |
|
timestamp |
[en] The date and time (ISO 8601 format) when the customer was created. |
|
text |
[en] The three-letter code (ISO 4217 format) for the currency that the customer used when they paid for their last order. |
|
text |
[en] The customer's mailing address. |
|
text |
[en] An additional field for the customer's mailing address. |
|
text |
[en] The customer's city, town, or village. |
|
text |
[en] The customer's company. |
|
text |
[en] The customer's country. |
|
text |
[en] The two-letter country code corresponding to the customer's country. |
|
text |
[en] The customer's normalized country name. |
|
float |
[en] A unique identifier for the customer. |
|
boolean |
[en] Whether this address is the default address for the customer. |
|
text |
[en] The customer's first name. |
|
float |
[en] A unique identifier for the address. |
|
text |
[en] The customer's last name. |
|
text |
[en] The customer's first and last names. |
|
text |
[en] The customer's phone number at this address. |
|
text |
[en] The customer's region name. Typically a province, a state, or a prefecture. |
|
text |
[en] The code for the region of the address, such as the province, state, or district. |
|
text |
[en] The customer's postal code, also known as zip, postcode, Eircode, etc. |
|
text |
[en] The unique email address of the customer. Attempting to assign the same email address to multiple customers returns an error. |
|
timestamp |
[en] The date and time when the customer consented to receive marketing material by email. |
|
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. |
|
text |
[en] The current email marketing state for the customer. |
|
text |
[en] The customer's first name. |
|
text |
[en] The customer's last name. |
|
text |
[en] The ID of the customer's last order. |
|
text |
[en] The name of the customer's last order. This is directly related to the name field on the Order resource. |
|
text |
||
text |
[en] A unique identifier for the customer that's used with Multipass login. |
|
text |
[en] A note about the customer. |
|
float |
[en] The number of orders associated with this customer. Test and archived orders aren't counted. |
|
text |
[en] The unique phone number (E.164 format) for this customer. |
|
text |
||
text |
||
text |
[en] Tags that the shop owner has attached to the customer, formatted as a string of comma-separated values. |
|
boolean |
[en] Whether the customer is exempt from paying taxes on their order. |
|
float |
[en] The total amount of money that the customer has spent across their order history. |
|
timestamp |
[en] The date and time (ISO 8601 format) when the customer information was last updated. |
|
boolean |
[en] Whether the customer has verified their email address. |
shopify_customers_addresses
Campo | Tipo | |
---|---|---|
float |
[en] A unique identifier for the customer. |
|
text |
[en] The customer's mailing address. |
|
text |
[en] An additional field for the customer's mailing address. |
|
text |
[en] The customer's city, town, or village. |
|
text |
[en] The customer's company. |
|
text |
[en] The customer's country. |
|
text |
[en] The two-letter country code corresponding to the customer's country. |
|
text |
[en] The customer's normalized country name. |
|
float |
[en] A unique identifier for the customer. |
|
boolean |
[en] Whether this address is the default address for the customer. |
|
text |
[en] The customer's first name. |
|
float |
[en] A unique identifier for the address. |
|
text |
[en] The customer's last name. |
|
text |
[en] The customer's first and last names. |
|
text |
[en] The customer's phone number at this address. |
|
text |
[en] The customer's region name. Typically a province, a state, or a prefecture. |
|
text |
[en] The code for the region of the address, such as the province, state, or district. |
|
text |
[en] The customer's postal code, also known as zip, postcode, Eircode, etc. |
Abandoned Checkouts
Campo | Tipo | |
---|---|---|
float |
[en] The ID for the checkout. |
|
text |
[en] The recovery URL that's sent to a customer so they can recover their checkout. |
|
text |
[en] The street address of the billing address. |
|
text |
[en] An optional additional field for the street address of the billing address. |
|
text |
[en] The city of the billing address. |
|
text |
[en] The company of the person associated with the billing address. |
|
text |
[en] The name of the country of the billing address. |
|
text |
[en] The two-letter code (ISO 3166-1 alpha-2 format) for the country of the billing address. |
|
text |
[en] The first name of the person associated with the payment method. |
|
text |
[en] The last name of the person associated with the payment method. |
|
float |
[en] The latitude of the billing address. |
|
float |
[en] The longitude of the billing address. |
|
text |
[en] The full name of the person associated with the payment method. |
|
float |
[en] The phone number at the billing address. |
|
text |
[en] The name of the state or province of the billing address. |
|
text |
[en] The two-letter abbreviation of the state or province of the billing address. |
|
text |
[en] The zip or postal code of the billing address. |
|
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. |
|
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. |
|
text |
[en] The ID for the cart that's attached to the checkout. |
|
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. |
|
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. |
|
timestamp |
[en] The date and time (ISO 8601 format) when the checkout was created. |
|
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. |
|
boolean |
||
timestamp |
||
text |
||
timestamp |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
text |
||
text |
||
text |
||
boolean |
||
text |
||
float |
||
timestamp |
||
boolean |
||
text |
[en] The two or three-letter language code, optionally followed by a region modifier. Example values: en, en-CA. |
|
text |
[en] The ID of the Shopify POS device that created the checkout. |
|
text |
[en] The customer's email address. |
|
text |
[en] The payment gateway used by the checkout. For abandoned checkouts, this value is always null. |
|
text |
[en] The URL for the page where the customer entered the shop. |
|
text |
[en] The ID of the physical location where the checkout was processed. |
|
text |
||
text |
[en] The text of an optional note that a shop owner can attach to the order. |
|
text |
[en] Learn more about accessing protected data The customer's phone number for receiving SMS notifications. |
|
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. |
|
text |
[en] The website that referred the customer to the shop. |
|
text |
[en] The street address of the shipping address. |
|
text |
[en] An optional additional field for the street address of the shipping address. |
|
text |
[en] The city of the shipping address. |
|
text |
[en] The company of the person associated with the shipping address. |
|
text |
||
text |
[en] The two-letter code (ISO 3166-1 alpha-2 format) for the country of the shipping address. |
|
text |
[en] The first name of the person associated with the shipping address. |
|
text |
[en] The last name of the person associated with the shipping address. |
|
float |
[en] The latitude of the shipping address. |
|
float |
[en] The longitude of the shipping address. |
|
text |
[en] The full name of the person associated with the shipping address. |
|
float |
[en] The phone number at the shipping address. |
|
text |
[en] The name of the state or province of the shipping address. |
|
text |
[en] The two-letter abbreviation of the state or province of the shipping address. |
|
text |
[en] The zip or postal code of the shipping address. |
|
text |
[en] The phone number used to opt in to SMS marketing during checkout. |
|
text |
||
text |
||
text |
[en] Where the checkout originated. Valid values: web, pos, iphone, android. |
|
text |
||
float |
[en] The price of the checkout in presentment currency before shipping and taxes. |
|
boolean |
[en] Whether taxes are included in the price. |
|
text |
[en] A unique ID for a checkout. |
|
float |
[en] The total amount of discounts to be applied in presentment currency. |
|
text |
[en] The total duties of the checkout in presentment currency. |
|
float |
[en] The sum of the prices of all line items in the checkout in presentment currency. |
|
float |
[en] The sum of line item prices, all discounts, shipping costs, and taxes for the checkout in presentment currency. |
|
float |
[en] The sum of all the taxes applied to the checkout in presentment currency. |
|
float |
[en] The sum of all the weights in grams of the line items in the checkout. |
|
timestamp |
[en] The date and time (ISO 8601 format) when the checkout was last modified. |
|
text |
[en] The ID of the user who created the checkout. |
Abandoned Checkouts: shipping lines
Campo | Tipo | |
---|---|---|
float |
[en] The ID for the checkout. |
|
text |
||
text |
||
text |
||
text |
[en] A reference to the shipping method. |
|
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
float |
||
text |
||
text |
||
float |
[en] The price of the shipping method in presentment currency. |
|
text |
||
text |
[en] The channel where the checkout originated. Example value: shopify. |
|
text |
[en] The title of the shipping method. Example value: International Shipping. |
|
text |
Abandoned Checkouts: note attributes
Campo | Tipo | |
---|---|---|
float |
[en] The ID for the checkout. |
|
text |
||
text |
Abandoned Checkouts: line items
Campo | Tipo | |
---|---|---|
float |
[en] The ID for the checkout. |
|
float |
||
float |
||
text |
[en] The fulfillment service provider for the item |
|
boolean |
||
float |
[en] The weight of the item in grams |
|
text |
||
float |
||
float |
||
text |
||
text |
||
float |
[en] The price of the item in presentment currency |
|
float |
[en] The product ID od the item |
|
float |
[en] The number of products that were purchased |
|
text |
||
boolean |
[en] Whether the items requires shipping |
|
text |
[en] A unique identifier for the item in the shop |
|
boolean |
||
text |
[en] The title of the product |
|
float |
[en] The product variant ID of item |
|
float |
||
text |
[en] The title of the product variant |
|
text |
[en] The name of the item's supplier |
Abandoned Checkouts: discount codes
Campo | Tipo | |
---|---|---|
float |
[en] The ID for the checkout. |
|
float |
[en] The amount of the discount in presentment currency. |
|
text |
[en] The discount code. |
|
text |
[en] The type of discount. Valid values: percentage, shipping, fixed_amount. (default: fixed_amount) |
Orders Line Items: propriedades customizadas
Campo | Tipo | |
---|---|---|
float |
[en] Order id |
|
float |
[en] The ID of the line item. |
|
text |
[en] The name (key) of the property. |
|
text |
[en] The value of the property. |
Order timeline events
Campo | Tipo | |
---|---|---|
text |
[en] The ID of the event. |
|
text |
[en] The ID of the order that generated the event. |
|
text |
[en] Refers to a certain event and its resources. |
|
text |
||
timestamp |
[en] The date and time when the event was created. |
|
text |
[en] A human readable description of the event. |
|
text |
[en] A human readable description of the event. Can contain some HTML formatting. |
|
text |
[en] A relative URL to the resource the event is for, if applicable. |
|
text |
[en] The type of event that occurred. Different resources generate different types of event. |