Skip to main content

API v1.11

: Staging

: Production

✨ New

Webhooks

New webhooks

Added the following webhook event types:

  • category_deleted
  • category_updated
  • collection_created
  • collection_deleted
  • collection_updated
  • price_book_created
  • price_book_updated
  • product_deleted
  • refund_created
  • refund_deleted
  • refund_updated
  • stock_deleted
  • variant_deleted
  • warehouse_created
  • warehouse_deleted
  • warehouse_updated

Learn more ->

Integrations

Sync prices with Shopify

Added a new setting to the Shopify app, is_product_price_sync_enabled, that updates Nautical product prices when they are updated in Shopify. Note that this is a one-way sync, with Shopify serving as the source of truth for pricing.

Settings

Marketplace timezone

Added the timezone field to the MarketplaceConfiguration model, which accepts the IANA timezone name. This field is now honored in queries for the insights APIs. We will be honoring it in other timezone fields in a future release.

💎 Changed

Order Lines

We are now storing the total price for each line item as returned from the tax-engine, eliminating several tax-related rounding errors.

Nautical Orders

The marketplace order can now be accessed as part of payment queries through a new nautical_order field on the Payment type

Draft Orders

We made several performance improvements around draft order APIs when the order contains a high number of line items.

Orders

The orders and nauticalOrders queries have a new filter to query by company name.

Orders
Breaking change in decline fulfillments API

The orderDeclineFulfillment mutation now requires the quantity to be listed with the associated warehouse via a new stocks field. This allows the declined items to be deallocated back to the correct warehouse.

Example mutation
mutation {
orderDeclineFulfillment(
order: "T3JkZXI6MTMzMDk="
input: {
notifyCustomer: true
lines: {
orderLineId: "T3JkZXJMaW5lOjMwMzIy",
stocks: [
{
quantityDeclined: 1,
warehouse: "V2FyZWhvd...mUyYWYxZQ=="
}
]
}
}
) {
fulfillments {
id
status
totalLinesQuantity
lines {
id
quantity
}
}
}
Show more ↓

🪲 Fixed

Refunds

Fixed an issue where refunds were not including taxes in the refundPayment total. A new total_gross field is introduced to process the refundPayment with taxes included.

Permissions

Fixed an issue where seller staff members could view products owned by other sellers when working with categories.

Webhooks

Fixed an issue where the stock_allocated, stock_deallocated, and stock_updated webhooks were not being triggered by order events.

Webhooks

Fixed an issue where the payout_updated and vendor_payout_updated webhooks were not being triggered by certain payout events.

Webhooks

Fixed an issue where the seller_updated webhook was not being triggered when metadata updates.

Products

Fixed an issue filtering categories when the seller is a member of a master marketplace.

Orders

Fixed an issue where the quantity field on order types should be required. Note: This field has been deprecated. We will eventually prefer the quantityOrdered field.

Orders

Fixed an issue where line quantity updates were not always triggering updates in tax calculation plugins.

Multi-Currency
Fixed an issue where multi-currency environments would crash if a discount was applied.

: Staging

: Production

API v1.11.2

✨ New

Orders

Add vouchers to quote and draft orders

Added the ability to add and remove vouchers on a draft or quote order. Vouchers can be managed on draft or quote orders through the following new mutations:

  • NauticalOrderUpdateApplyVoucherCode
  • NauticalOrderUpdateDeleteDiscount
  • OrderUpdateApplyVoucherCode
  • OrderUpdateDeleteDiscount
Example mutation
mutation {
NauticalOrderUpdateApplyVoucherCode(
id: "TmF1dGljYWxPcmRlcjo1"
voucherCode: "SEPT10OFF"
) {
nauticalOrder {
id
discount {
amount
}
voucher {
id
name
code
}
}
orderErrors {
field
message
code
}
}
}
Show more ↓
Invoices

Display marketplace tax ID on invoices

Added the display of VAT Business Identification No to invoices generated from a marketplace order. The value is pulled from the taxId field on the seller account reserved for the marketplace (seller #1).

Learn more ->

💎 Changed

Orders
Date search filters now respect the marketplace timezone.

🪲 Fixed

Orders
Fixed an issue with seller order filtering when searching by both first and last name in the search filter.
Orders
Fixed an issue where shipping taxes for seller orders were not being saved when manually creating a payment against a draft order.
Vendor mgmt

Fixed an issue where the updateSeller mutation would fail if the seller did not have an attached agreement.

Was this page helpful?