Product Updates 2019
Updates from prior years
Version: v3.70
Version: v3.69
draft
to allow saving incomplete integrations.notify
with true
and a valid email
address to have notifications sent on completion.status
which includes debug_files
and source_files
with file name
and href
download link to output and source files respectively.Version: v3.68
parameters.value
that accept complete objects for replacement. Can be used to support warehouse configurations, field mapping and other complex scenarios.Version: v3.67
longtext
fields now display as a textbox and date
fields are now auto formatted.
plugin_bulk_throttle
as companion to plugin_write_throttle
to queue bulk requests before attempting update calls to Magento API.
order_update_failure
not setting order status as REJECTED.oid
field not resizing.Version: v3.66
Version: v3.65
parameters.date_format
to dynamically set date values in any valid date/time format within configurations.Version: v3.64
bill_account
to charge shipments to a third party account for carriers that support it.
.html
extensions.magentotwosku
being cleared.Version: v3.63
object_failure_update
- updated to support multiple objects and response errorKey
to match errors on.disable_all
- prevents this automation and all installed shared automations from running.validate
endpoint to test creation and update of automations.parameters
endpoint to accept parameter based configurations.parameters.allowed_values
for specifying valid configuration automation options.eBayCollectAndRemitTax
- per eBay announcement tax will no longer be combined into Total when taxes exist in both Taxes.TotalTaxAmount and eBayCollectAndRemitTaxes.TaxDetails.TaxAmount.ebay{instance}itemspecifics DELETE
into API and Bulk for clearing specifics from listings.Version: v3.62
Version: v3.61
parameters
. These parameters may be defined as encrypted
which will securely store sensitive data that may be dynamically loaded into integrations. For example, you may have an integration that requires embedding an API key within a JSON or XML payload - using parameters
you may define and set the encrypted API key for dynamic use within the configuration and know that it is being securely loaded at run time.Version: v3.60
longtext
custom fields to type text
when modifying custom field list.Version: v3.59
shippingcompany
is empty.
Version: v3.58
packages
to enable multipart shipments for carriers that support it.
ebay_usetaxtable
setting to enable UseTaxTable
orders_address_validation
to enable address validation of order shipping address imports and updates.search
support improved for relative dates introduced in v3.29.ebaybestofferenabled
not being respected in the product listing interface.shopifyproductid
.stock
instead of total_stock
.Version: v3.57
retry
.Version: v3.56
order_update_search
which accepts a search string to limit order item or shipment updates on both import and export. Deprecated order_update_export_search
introduced in v3.52 in favor of this new setting.vendor_actions
now supported in both exports and imports to manipulate data in external payloads.suredone_actions
now supported in both exports and imports to manipulate data from the SureDone database prior to the requested import or export.ignoreItem ignoreOrder
not respecting edge cases in import of shipments and item updates.Version: v3.55
amznislisted
via bulk or the API. Accepts a value of 1
or 0
and requires force
be set to true
.listingvariationimage
API.when_made
- updated list to latest values offered via the Etsy API.suredone_actions
and vendor_actions
. For example, with an inventory export of stock you can intelligently export the value of maxstock instead with the config {"suredone_actions":[{"search":"maxstock:>0 maxstock:<stock","setValue":{"stock":"maxstock"}}]}
.country_code
.Version: v3.54
when_made
list to include 2010_2019
.etsysku
as protected field for reference of child variations.itemstatus
use to better track order item status in complex and automated fulfillment processes.vendor
use to specify the source of products provided by third parties in automated fulfillment processes.purchaseorderid
use to store third party purchase orders that may be required in drop shipped fulfillment.OrderLineItemID
between responses as a fallback when confirming orders are not already imported with legacy order numbers.Version: v3.53
UsageConstraint
in payloads to show when specifics are Optional, Recommended, or Required.ConditionNotes
are set.Version: v3.52
plugin_bulk_throttle
as companion to plugin_write_throttle
to queue bulk requests before attempting update calls to Magento2 API.
type
called event
for logging intermediate states between updates such a connection status or file upload/download.POST
to channel/amazon/asin/search
id
and type
required, category
optional (boolean)id
- accepts up to 5 values as an array or single string valuetype
- accepts one of ASIN GCID SellerSKU UPC EAN ISBN JAN
category
- when true
will import browse node informationorder_update_export_search
which accepts a search string to limit order item or shipment updates. For example, in a multi item order that is drop shipped from multiple vendors this search can limit which order items to set a Purchase Order ID. Works with setting order_line_item false
.triggers
are leveraged and require implementing multiple return values between calls, there is now support for maintaining values in numbered keys as key1
, key2
, key3
, etc - with numbered trigger values that may be utlized as trigger_value1
, trigger_value2
, trigger_value3
, etc. See example automation below:
{ | |
"name": "Orders Dropship", | |
"vendor": "Turn14", | |
"active": false, | |
"schedule": "15 * * * *", | |
"type": "orders", | |
"action": "export", | |
"connection": { | |
"type": "http", | |
"address": "https://apitest.turn14.com/v1/order/from_quote", | |
"method": "POST", | |
"oauth": { | |
"address": "https://apitest.turn14.com/v1/token", | |
"method": "POST", | |
"grant_type": "client_credentials", | |
"client_id": "***", | |
"client_secret": "***" | |
}, | |
"headers": { | |
"Content-Type": "application/json" | |
}, | |
"triggers": [ | |
{ | |
"key1": "$.data.id", | |
"key2": "$.data.attributes.shipment.*.shipping.*.shipping_quote_id", | |
"address": "https://apitest.turn14.com/v1/quote", | |
"method": "POST", | |
"headers": { | |
"Content-Type": "application/json" | |
}, | |
"template": "{\"data\": {\"environment\": \"testing\", \"po_number\": \"{{data['oid']}}\", \"locations\": [{\"location\": \"default\", \"combine_in_out_stock\": true, \"items\":[{% set itemcount = 0 %}{% for key, item in data['items'] %}{% if (item.dropshipprovider == 'turn14') %}{% if (itemcount > 0) %},{% endif %}{\"item_identifier\": \"{{ item.turn14id }}\", \"item_identifier_type\": \"item_id\", \"quantity\": \"{{ item.quantity }}\" }{% set itemcount = itemcount + 1 %}{% endif %}{% endfor %}], \"shipping\": {\"shipping_code\": 3, \"saturday_delivery\": false, \"signature_required\": false} }], \"acknowledge_prop_65\": {% if data['prop65'] %}true{% else %}false{% endif %}, \"recipient\": {\"name\": \"{{data['shipping']['firstname']}} {{data['shipping']['lastname']}}\", \"address\": \"{{data['shipping']['street1']}}\", \"address_2\": \"{{data['shipping']['street2']}}\", \"city\": \"{{data['shipping']['city']}}\", \"state\": \"{{data['shipping']['stateprovince']}}\", \"country\": \"{{data['shipping']['country']}}\", \"zip\": \"{{data['shipping']['postalcode']}}\", \"phone_number\": \"{{data['shipping']['phone']}}\", \"is_shop_address\": false } }}", | |
"oauth": { | |
"address": "https://apitest.turn14.com/v1/token", | |
"method": "POST", | |
"grant_type": "client_credentials", | |
"client_id": "***", | |
"client_secret": "***" | |
} | |
} | |
] | |
}, | |
"file_configs": [ | |
{ | |
"template": "{\"data\": {\"environment\": \"testing\",\"quote_id\": {{trigger_value1}},\"po_number\": \"{{data['oid']}}\",\"acknowledge_prop_65\": true,\"acknowledge_epa\": true, \"shipping\": [{\"shipping_id\": {{trigger_value2}}}]}}", | |
"search": "status:=READY dropshipprovider:=turn14", | |
"jsonpath": true, | |
"order_update_export": { | |
"status": "ORDERED", | |
"dropshipstatus": "ORDERED" | |
}, | |
"order_update_export_search": "dropshipprovider:=turn14" | |
} | |
] | |
} |
identifer
- is now set as automation-{{id}}job_id
- is now set as the automation slug
type
- is now set as event
for intermediary automation events, with only the final status log specifying type
as either item or orderon
updating Price to 0 when magentoprice
is empty or 0.identifier
with the following characters:+ - = && || > < ! ( ) { } [ ] ^ " ~ * ? :
.Version: v3.51
store_url
setting for ensuring export of production product URLs to Google Shopping. See updated BigCommerce authorization guide.
store_url
setting for ensuring export of production product URLs to Google Shopping.
plugin_bulk_throttle
to limit the number of concurrent update calls.
Sales.ShippingInfo.ShippingStatus
- introduce orderSyncShippingStatus
setting for exporting order shipping status.
401 Unauthorized
.
sku_type
parameter to return variations and non-variations:
sku_type:=variation
will return only variation products.sku_type:-=variation
will return only non-variation products.Version: v3.50
SearchTerms
element change.
AgeRangeDescription
, FootwearSizeSystem
, ShoeSizeAgeGroup
, ShoeSizeGender
, ShoeSizeClass
, ShoeSizeWidth
, ShoeSize
, ShoeSizeToRange
, ShoeSizeGenderUnisex
, ShoeSizeWidthUnisex
, ShoeSizeUnisex
, ShoeSizeToRangeUnisex
weight
- defaults to a 4 decimal place field for new users or by support request.magentotwoskip
not working in bulk.identifiers
(guid or order for products and orders respectively).Version: v3.49
object_failure_update
:
errorCode
accepts HTTP error code, only update object when this error code is received.errorMessage
only update object when error message contains this string.updates
object of key/value pairs of object to be updated.iskit true
).cost
, msrp
and discountprice
fields.Version: v3.48
name
stopped being returned in the payload as of late 2018. To address this, users must use oAuth to authorize the BigCommerce integration in order for SureDone to leverage V3 API functionality.Version: v3.47
ebayrelistid
- added support via the API and Bulk to replace or remove the Relist ItemId.dateutc
when submitting only a valid local date
during order creation.action relist
introduced with a fix in v3.37Version: v3.46
shipitems
in cases where multiple shipsku
and shipquantity
are submitted via separate requests for a single shipment.media
field length to 500 characters.shipsku
and shipquantity
for order line item shipments.Version: v3.45
etsyautorenew
for listing renewal
etsytaxonomyid
- required with etsycategoryid
no longer being required.state inactive
- when performing update of quantity
less than or equal to 0.state active
- when performing relist
and quantity
updated is greater than 0.Version: v3.44
Version: v3.43
request_id
in the logs interface.
ebaylocation
by submitting multiple delimited states IE CA, TN, GA, CA, TN, GA, OH, NY, CO, WA, TX and deleting the PostalCode
via ebayshippingcalculatedpostalcode
from the listing. Maximum 45 characters allowed and ebayshippingcalculatedpostalcode
must have an existing value during the revise.
ExtendedOrderId
- imported as details.ExtendedOrderId
for reference to new eBay order number format during transition.
etsytaxonomyid etsyshippingtemplateid
and any taxonomy specific required fieldsaction end
or via the interface by clicking Disableaction relist
or via the interface by clicking Retryetsyskip
values of alwaysSkipStockPrice alwaysSkipStock alwaysSkipPrice
to prevent quantity and/or price updates.template
within triggers
and http POST variables by using {{TEMPLATE}}
as the post variable configuration value.Version: v3.42
total
due to incorrect eBayCollectAndRemitTax documentation.Version: v3.41
shipitems
or shipsku
with shipquantity
within order shipments to specify line item package SKUs and quantities. This support extends to channels that support ship tracking by order line item such as eBay and Amazon.
shipitems
- accepts an object of arrays, ie {"shipments":[{"shiptracking":"123123123123","shipdate":"NOW","shipitems":{"U8800ZZZ":1}}]}
shipsku
- will set a single shipment item object, ie {[{"shiptracking":"123123123123","shipdate":"NOW","shipsku":"U8800ZZZ","shipquantity":1}]}
shipdetails.items
- the above examples would save as {"items":[{"sku":"U8800ZZZ","quantity":1}]}
within shipdetails.items
refunditems
or refundsku
with refundquantity
within order refunds.REJECTED
status - introduce new status that will not sync to channels or notify customers. Use this status to identify orders that have failed a logistics process such as a failed purchase order or failed drop ship request to a third party warehouse distributor.
CHECKOUTPENDING
status - removed as part of a previous deprecation.true
.paymentmethod
saved as CreditCard
for Managed Payments orders.Version: v3.40
shippingcountry:=us shippingcountry:=billingcountry
.
Version: v3.39
records
now accepts a value up to 1000
to return up to that many log results.Version: v3.38
asins_multi_matches
will now return data for multiple matches.asin_multiple
introduced to provide users with more control over DCi products that match to multiple products in the Amazon catalog:
amznmasin
to MULTIPLE
if there are multiple ASIN matches.amznasinmultiple
header which exposes multiple matched asins.shippingstatus=COMPLETE
.+
characters exist in the file name.HTTP Status 503 - This application is not currently available
, Ack
response checking has been upgraded.Version: v3.37
502
errors sometimes returned.bulk_name
parameter to support custom bulk file and job naming to provide parity with the bulk upload interface.iskit true
with action edit
, kitlinks
and force true
. On success will set stock 0
to allow for dynamic inventory calculation. Will return an error if the product is an existing kit component.iskit false
with action edit
and force true
.minstock
and maxstock
for setting minimum stock buffers and maximum stock levels respectively.availability
and other attributes to be removed if they are missing from the request.alwaysSkipStock alwaysSkipStockPrice
- support removed for all actions except sold
due to the above upgrade.minstock
and maxstock
for setting minimum stock buffers and maximum stock levels respectively.ebay{instance}skip
or amzn{instance}skip
fields to the All Products interface.
Version: v3.36
response_field_map
not writing back data for product exports. This fix enables support for automation based listing integrations to write back product identifiers on successful requests.Version: v3.35
create
, update
and archive
orders has been added to the bulk processor. Similar to product uploads, CSV files with an action
in the first column and identifier (either oid
or order
) in the second column will create or update all order fields provided in the file. Files that do not have an action
in the first column will default to update
. To support multiple shipments, refunds, or order items in a single row provide headers that correlate to the object index that is to be updated, for example to update the second order item quantity
provide itemid2
and quantity2
headers in the file. Furthermore, support for deleting order items, shipments and refunds is available by setting the action
to delete
and identifier to itemid
, shipid
or refundid
to delete order items, shipments and refunds respectively. Mark orders shipped on marketplaces by setting headers and values for shipments (shiptracking
, shipcarrier
and shipdate
minimum) along with shippingstatus
set to COMPLETE
.
action=create,oid,total,itemtotal,taxtotal,sku,quantity,price,customfield
,sku2,price2,customfield2,shippingfirstname,shippinglastname
action=update,order,shippingstatus=COMPLETE,shiptracking,shipcarrier,shipdate=NOW
,shiptracking2,shipcarrier2,shipdate2=NOW
action,shipid
delete,123
action=update,oid,internalnotes
domesticShippingType
and intlShippingType
are now saved under ShippingPolicyProfile
along with the profileName
and profileId
to enable better validation logic via the API.
Internal Error
responses from the eBay API, retry logic has been added to GetItem
calls for import of eBay listings that encounter this error.GetSellerList
calls, a toggle for disabling the clear inactive Item ID job has been implemented.
connection.triggers
is now available. This functionality may accommodate use cases such as a job request that returns a payload to download on import or status confirmation for product listing payloads on export.offerId
as number instead of a string.multiuser
set on.Version: v3.34
varchar
now have a length limit of 2500
.PATCH
and DELETE
requests now return id
in the response.id
is now logged to job_id
for better auditing of updates.400
responses from Google that may have affected end
, delete
and sold
action updates.auctionsrelist on
, outofstock off
and use of maxstock
or minstock
that would list out of stock items on sold
action.Version: v3.33
lineitem
format, which will export each order item on a separate row of the CSV export file. This is only supported with Legacy Export set to Off in the Orders Settings.
link
to publish listings to Google Express.alwaysSkipPrice alwaysSkipStockPrice
- upgraded to no longer send StartPrice
for variation products on ReviseItem
.relist
with no data in using BigCommerce or Magento storefront URLs for sending link
to Google Shopping Actions.ReviseItem
, this has been resolved by no longer sending price if it is less than or equal to 0.Version: v3.32
action=fitment
header along with with a minimum of guid, year, make, model
headers are required to load fitment via this format.
link
and style
tags for embedding styles in the custom eBay description and other fields.
Version: v3.31
shipdetails.items
as an array of sku
to quantity
or as an array of objects with a minimum of sku
and quantity
fields (these objects can also support other fields for extended functionality in third party applications and marketplaces). {"oid": 123, "shiptracking": 99999999, "shipcarrier": "USPS", "shipdetails": {"items": [{"sku": "abc123", "quantity": 2}]}}
ebay{instance}starttime ebay{instance}endtime ebay{instance}promotionstarttime ebay{instance}promotionendtime
ebaymediareset true
with action relist
to ensure excess images are removed from listings.ebayitemspecificsLabel Name
and SureDone will translate the Label Name
and submit the correlated item specific value.Version: v3.30
a-zA-Z0-9-+_ /.():;#|
.Version: v3.29
dateupdated:>"-1 year"
alwaysSkipStockPrice
: introduce marketplace support to skip price & inventory updates.alwaysSkipStock
: introduce marketplace support to skip inventory updates.alwaysSkipPrice
: introduce marketplace support to skip price updates.ebayshippingratetabledom
and ebayshippingratetableintl
fields respectively.ebayshippingratetabledom
or ebayshippingratetableintl
are uploaded, shipping would not revise on eBay.Version: v3.28
productSecondaryImageURL
URLs effectively allowing more than 2 images to be sent to Walmart:
productSecondaryImageURL
is mapped, this field supports multiple images separated by *
.media2
through mediax
.paymentStatus
of pendingAuthorization
are no longer imported.sellOnGoogleQuantity
now sent on all product calls.GetItFast
deprecated, see more.suredone_actions
:
setAddress
change address for object export, only valid when payload_multi
is false
and a template exists, and for connections that support 'address' (email also accepts array for multiple addresses). For example, you can now send purchase orders to multi supplers with unique email addresses that switch based on the search of a custom order item field.replace
: perform string search and replacements during runtime.regexExtract
: use regular expressions to parse out data from strings during runtime.Version: v3.26
payload_multi
to products and orders import
: if true
: normal import, if false
: make an external connection call for each object, used with variables in the address export
: if true
: include all objects in single report, if false
: create one report per object, must be handled by template.Version: v3.25
mark_as_seen
to mark an email as read if successfully importing a file from it.iskit false
, action edit
with force true
.skip
values are now respected for all channels.Version: v3.24
LotSize
to the number of components in the bundle.Version: v3.23
status ARCHIVED
status READY
Complete
on eBay and CheckoutStatus
is Complete
on eBay and OrderStatus
is Completed
on eBay and eBayPaymentStatus
is NoPaymentFailure
on eBay.
X-Bc-Apilimit-Remaining
from their API.
pushManualOrders
now accepts a string of channels to export delimited by ,
.Version: v3.22.0
Version: v3.21.0
Version: v3.20.0
Version: v3.19.0
Version: v3.18.0