API v1.14

Nov 22, 2023: Staging

Nov 30, 2023: Production

✨ New

Orders

Order line item notes

Added the ability to add a note per order line item. The following mutations have been added to add line-level notes:

• checkoutLineAddNote: Adds a note to a CheckoutLine.
  note

  When the checkout is converted to an order, any CheckoutLines are converted to NauticalOrder and Order lines.

• nauticalOrderLineAddNote: Adds a note to a NauticalOrderLine.
• orderLineAddNote: Adds a note to an OrderLine.

Learn more ->

Locations

New locations queries

Added the locationSearch and locationGeocode queries, to replace the deprecated mutations.

Integrations

Email payloads with order line item thumbnails

Added the original.url field to images on order line items for SendGrid email payloads. This new field provides the URL of the unprocessed, original image, facilitating the integration of image thumbnails in dynamic email templates.

This update provides a way around the SendGrid limitation with accessing the sized thumbnail URLs, which were previously available but incompatible with SendGrid handlebars.

💎 Changed

Payments

Validation error when payment token already used

Added a validation error for instances where a token has already been used for a payment.

Catalog

Sort products or variants by brand or manufacturer

Added the ability to sort products or variants by the brand and manufacturer fields.

🚫 Deprecated

Locations

Deprecated location mutations

The locationSearch and locationGeocode mutations have been deprecated. Instead, use the new locations queries.

Shipping

Deprecated secondary address

Deprecated the ShippingMethod.requiresSecondaryAddress and secondaryAddress fields, which were non-functional.

Shipping

Deprecated shipping fields

The checkout.shippingMethod and nauticalOrder.shippingMethodName fields have been marked deprecated. These fields were not functional as shipping is stored on the seller order (order).

Fulfillments

Removed NauticalFulfillment model

The following models have bee removed, as fulfillments are tracked at the seller order level.

• NauticalFulfillment
• NauticalFulfillmentLine

This change has been made backwards-compatible. To keep backwards compatibility for NauticalOrder.fulfillments, the type of that field is changed to Fulfillment but the resolver is changed to an empty list.

Payments

Removed connection between seller order and payments

Removed the connection between seller orders (order) and payment objects. This connection had already logically been empty since the deprecation in version 1.9.

As a result, any existing logic querying orders must not explicitly include payments.

Checkout

Removed taxRate field from order lines

The taxRate field has been removed from the NauticalOrderLine and OrderLine objects.

Orders

Removed nauticalSuborders query

The nauticalSuborders query has been removed.