Outbound sync data structures
This page describes the data types, structures and examples for each field for each sync operation.
Last updated
This page describes the data types, structures and examples for each field for each sync operation.
Last updated
Outbound syncs require certain fields to be specific data types.
Supported Outbound Sync operations:
Note: 1. * means the field is REQUIRED to be filled and cannot be null. 2. enum fields only accepts certain terms as strings which are shown in its corresponding example.
This operation creates a new customer in Shopify.
*first_name
string
John
*last_name
number
Smith
tags
string
first
phone
string
+60123456789
email
string
testexample@gmail.com
note
string
Bulk Customer
tax_exempt
boolean
TRUE | FALSE
email_marketing_consent
object
sms_marketing_consent
object
addresses
array of objects
This operation updates the details of an existing customer in Shopify. Will not update if no existing customer ID is found.
*record_id
number
651023456789
first_name
string
John
last_name
number
Smith
tags
string
first
phone
string
+60123456789
email
string
testexample@gmail.com
note
string
Bulk Customer
tax_exempt
boolean
TRUE | FALSE
email_marketing_consent
object
sms_marketing_consent
object
addresses
array of objects
This operation creates a customer if the customer has never been created with this sync operation. This operation will update the existing customer's details if the customer was previously created from this sync operation.
*record_id
number
651023456789
*first_name
string
John
*last_name
number
Smith
tags
string
first
phone
string
+60123456789
email
string
testexample@gmail.com
note
string
Bulk Customer
tax_exempt
boolean
TRUE | FALSE
email_marketing_consent
object
sms_marketing_consent
object
addresses
array of objects
This operation deletes an already existing customer. Will not delete if existing customer ID is not found.
*record_id
number
651023456789
This operation creates a new product in Shopify.
*title
string
Computer Laptop 32 inch
body_html
string
Silent, powerful and affordable laptop!
product_type
string
Laptop
published_scope
string (enum)
web | global
status
string (enum)
active | archived | draft
tags
string
Affordable, Big Screen
variants
array of objects
vendor
string
Steve Jobs
This operation updates the details of an existing product in Shopify. Will not update if no existing product ID is found.
*record_id
number
632910392
title
string
Computer Laptop 32 inch
body_html
string
Silent, powerful and affordable laptop!
product_type
string
Laptop
published_scope
string (enum)
web | global
status
string (enum)
active | archived | draft
tags
string
Affordable, Big Screen
variants
array of objects
vendor
string
Steve Jobs
This operation creates a product if the product has never been created with this sync operation. This operation will update the existing product's details if the product was previously created from this sync operation.
*record_id
number
632910392
*title
string
Computer Laptop 32 inch
body_html
string
Silent, powerful and affordable laptop!
product_type
string
Laptop
published_scope
string (enum)
web | global
status
string (enum)
active | archived | draft
tags
string
Affordable, Big Screen
variants
array of objects
vendor
string
Steve Jobs
This operation deletes an already existing product. Will not delete if existing product ID is not found.
*record_id
number
632910392
This operation creates a new order in Shopify.
*line_items
array of objects
email
string
testuser@example.com
phone
string
+60123456789
billing_address
object
shipping_address
object
discount_codes
array of objects
financial_status
string (enum)
pending | paid | authorized | partially_paid | partially_refunded | refunded | voided
tax_lines
will fail if line_items have tax_lines object
array of objects
customer
object
fulfillment_status
string
fulfilled | null | partial | restocked
note
string
Bulk order
note_attributes
array of objects
buyer_accepts_marketing
boolean
TRUE | FALSE
tags
string
RTX, Intel, SSD, Music
The entire create operation for the record will FAIL if the line_items field, which also accepts a tax_lines field in the object, has a present tax_lines field as part of the object.
It is advisable to fill the tax_lines field as part of each item if each individual item has it's own tax details.
If all items share the same tax details, it is advisable to not have any tax_lines objects in each line_item but part of the optional parameter instead.
In Object Examples (Order) demonstrates the usage of the tax_lines object in line_items.
This operation updates the details of an existing order in Shopify. Will not update if no existing order ID is found.
*record_id
number
50123456789
note
string
Bulk order
note_attributes
array of objects
buyer_accepts_marketing
boolean
TRUE | FALSE
tags
string
RTX, Intel, SSD, Music
phone
string
shipping_address
object
customer
null
null
This operation creates an order if the order has never been created with this sync operation. This operation will update the existing order's details if the product was previously created from this sync operation.
*line_items
array of objects
Example under "Object Examples"
*record_id
number
50123456789
email
string
testuser@example.com
phone
string
+60123456789
billing_address
object
shipping_address
object
discount_codes
array of objects
financial_status
string (enum)
pending | paid | authorized | partially_paid | partially_refunded | refunded | voided
tax_lines
will fail if line_items have tax_lines object
array of objects
customer
object | null
fulfillment_status
string (enum)
fulfilled | null | partial | restocked
note
string
Bulk order
note_attributes
array of objects
buyer_accepts_marketing
boolean
TRUE | FALSE
tags
string
RTX, Intel, SSD, Music
This operation deletes an already existing order. Will not delete if existing order ID is not found.
*record_id
number
50123456789
This operation fulfills an existing unfulfilled order's items given the fulfillment order ID. Orders that have all items fulfilled will be marked as fulfilled. Orders that have only part of it's items fulfilled will be marked as partially fulfilled.
*line_items_by_fulfillment_order
array of objects
message
string
Leave at doorstep
notify_customer
boolean
TRUE | FALSE
origin_address
object
tracking_info
object
This operations updates an existing fulfilled order's details, such as the tracking information and delivery company.
*record_id
number
4123456789
tracking_info
object
notify_customer
boolean
TRUE | FALSE
This operation will fulfill an order if the order has never been fulfilled with this sync operation. This operation will update the existing fulfillment's details if the order was previously fulfilled from this sync operation.
*line_items_by_fulfillment_order
array of objects
*record_id
number
4123456789
tracking_info
object
notify_customer
boolean
TRUE | FALSE
This operation will unfulfill an order, changing the items of orders from fulfilled into unfulfilled state.
*record_id
number
4123456789
This operation creates a new product variant from a product.
*product_id
number
123456789
title
string
Pen (Blue)
price
string
15.99
This operation updates an existing product variant from a product.
*record_id
number
123456789
*product_id
number
123456789
title
string
Pen (Blue)
price
string
15.99
This operation updates an existing product variant from a product, or creates a new product variant if the same title does not exist.
*product_id
number
123456789
*record_id
number
123456789
title
string
Pen (Blue)
price
string
15.99
This operation deletes an exisitng product variant from a product.
*product_id
number
123456789
Inventory Item Levels syncs the inventory count of a product variant at a location.
An inventory level is the object that connects between a product variant and a location, allowing stock to be moved from/into the location.
This operation creates a new inventory level between an inventory item and a location. Having an inventory level allows stock to be stocked at that specified location.
*inventory_item_id
number
123456789
inventory_level_amount
object
This operation updates the inventory level stock count between an inventory item and a location. It replaces the stock count for that inventory level.
*inventory_item_id
number
123456789
quantity_name
string
available | on_hand
inventory_level_amount
object
This operation updates the inventory level stock count between an inventory item and a location. If there is no exsiting inventory level to update, it will create a new inventory level with the corresponding amount initially stocked.
*inventory_item_id
number
123456789
quantity_name
string
available | on_hand
inventory_level_amount
object
This operation deletes the inventory level.
*inventory_item_id
number
123456789
inventory_level_amount
object
If the given inventory level (the combination of inventory_item_id and location_id) is the last remaining inventory level associated with the product variant, it cannot be deleted.
Reference:
| null