Skip to main content

API v1.12

: Staging

: Production

✨ New

Orders

Backorders API

Added the ability to enable backorders with customizable settings, allowing you to set backorder thresholds and selectively activate this feature for specific product variants.

To activate the backorders feature, a new marketplace configuration enableBackorders field has been introduced. Once enabled, you can control which items are eligible for backordering through the allowBackorders boolean field on each product variant. By default, both fields are set to false (off) to maintain your current settings.

When adding or adjusting stock, StockInput now accepts the outOfStockThreshold field, which defaults to 0. This field allows you to set a negative value for how far stock levels can go below zero. When backorders and thresholds are set up, the quantityAvailable field can take on a negative value, but it cannot go past the limits defined by the outOfStockThreshold.

Learn more ->

Integrations

Webhook queue manager plugins

Refactored webhooks to enhance security and functionality in conjunction with queue manager plugins. If any of the following plugins are enabled, webhooks will now be directed to their respective queues:

  • Amazon Simple Queue Service
  • Google Cloud Pub/Sub
  • Microsoft Azure Service Bus
note

When you enable one of the above plugins, the queue is automatically subscribed to all webhook events. There is no filtering on the Nautical side as to which events are sent to the queue.

Orders

Store PO number on Checkout and NauticalOrder

Added the capability to store Purchase Order (PO) numbers in both the Checkout and NauticalOrder models. This includes the ability to search for purchase order numbers using the search filter.

During the checkout process, you can use the checkoutAddPoNumbers mutation to input one or more PO numbers, allowing buyers to easily reference these during transactions. You can also use the checkoutRemovePoNumber mutation to remove a PO number.

Once the checkout is completed, these PO numbers are saved to the resulting NauticalOrder. This ensures that each marketplace order can have one or more associated PO numbers for record-keeping and future reference. After checkout, you can manage PO numbers by updating the NauticalOrder directly.

🪲 Fixed

Catalog

Fixed an issue where bulk creation of variants resulted in a GraphQL error ID cannot represent value: None.

Orders

Fixed an issue that prevented searching for seller orders by the customer's company name. The search filter now includes the customer's company name if the token running the GraphQL query has the manage_users permission.

Webhooks

Fixed an issue where the orderCancel or orderBulkCancel mutations were not triggering stock deallocated webhooks upon cancelling orders.

Orders

Fixed an issue where changing the customer in a draft marketplace order did not update the customer address. Now, when you select a different customer, the address fields will automatically update to reflect the new customer's information.

: Staging

: Production

API v1.12.1

✨ New

Orders

Surface PO number on invoice

Invoices now display PO numbers if they are available on the corresponding marketplace order (NauticalOrder). Invoices must be regenerated for this change to take effect.

🪲 Fixed

Orders

Fixed an issue where declining the full quantity of an order line from a marketplace order did not update the nauticalOrder.total.tax.amount value to reflect the adjusted tax amount. This inconsistency also affected invoice information, making invoices different from what was displayed on the Order Details page in the Dashboard.

Orders

Fixed an issue related to the caching of invoice shipping prices and order line tax amounts.

Insights

Fixed an issue where the query for top-performing products incorrectly included deleted variants.

: Staging

: Production

API v1.12.2

✨ New

Orders

Sort orders by PO number

Added the ability to sort marketplace orders (nauticalOrder) by PO numbers.

🪲 Fixed

Inventory

Fixed an issue where, when enableStockAllocationForDrafts=true, stock was not being deallocated after deleting draft orders.

Integrations

Fixed an issue where the Shopify price sync toggle was not appearing for sellers with existing integrations.

: Staging

: Production

API v1.12.3

🪲 Fixed

Integrations

Fixed an issue that prevented the order_creation email to send in certain circumstances with an TypeError: Object of type X is not JSON serializable error.

Was this page helpful?