Developer Changelog

Staff now have the ability to set up custom domains for their marketplace. When a custom domain is set, it will automatically be returned as the shop domain. A custom domain can be deleted by setting a tenant to inactive.

Added mutations to create and delete custom domains.

Added the ability to validate default email address and sender name if the Nautical Emails plugin is active.

Fixed an issue where payout status updates from ARCHIVED to DRAFT. Now payout status updates can only move from LOCKED to DRAFT.

Fixed an issue where an unexpected server error message appears when updating a seller agreement if the seller does not have an owner.

Fixed an issue with fetching user permissions. Staff can now retrieve only known permissions when fetching for a group.

Fixed an issue where discounts were not displayed as a negative value in confirmation emails.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Fully Deprecated​

The following fields, types, and mutations have reached end of their deprecation period and have been removed:

• PeriodicTaskEnabledUpdate
• WebhookPeriodicTask

Added the capability to search Nautical orders by voucher code, improving searchability and tracking within the system.

Introduced a new webhook event for fulfillment_updated, enabling real-time tracking for fulfillment status updates.

Improved stability and latency issues in ShippingZone.is_supported_country_area that were affecting Checkout timeouts.

Enhanced checkout stability:

• Fixed integer casting error in CheckoutSellerShippingMethodsUpdate to improve error handling and accuracy when incorrect ID types are provided.
• Addressed issues where voucher usage limits were causing checkout failures.

Added tracking URLs to the fulfillment schema, allowing better visibility and traceability for fulfillment status.

Introduced validation to prevent duplicate voucher codes in a single checkout. Now, attempting to apply the same voucher code multiple times raises an InvalidPromoCode error with a clear message.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Newly Deprecated​

The following fields and types are now deprecated and will be removed in future releases:

• Webhooks - webhookSamplePayload

Fully Deprecated​

The following fields, types, and mutations have reached end of their deprecation period and have been removed:

• actions - Orders will be changed to have no actions. All actions should be performed against the NauticalOrder
• quantity - On the nauticalOrderLine and OrderLine models. Use the more explicit quantityOrdered instead
• quantity On the refundLine model. This value was split into quantityFulfilled and quantityUnfulfilled
• currencies.totalLinesPrice
• defaultCurrency
• isSellerShippingZoneCreationAllowed

Added the ability to filter the following by public and private metadata:

• Categories
• Product Types
• Attributes

Customers can now upgrade their accounts to sellers without creating a new account.

Enhanced API stability with improved logging, monitoring, and error handling.

Enhanced checkout stability:

• Checkouts now display an error when a product is unavailable.
• Fixed error handling for line items from sellers without signed agreements.

Staff members can now perform metadata updates on OrderLine items for orders they placed.

Corrected error messages when attempting to update marketplace configurations.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Newly Deprecated​

The following fields, types, and mutations have reached end of their deprecation period and have been removed:

• Branding
• CoreData
• assignNavigation mutation
• Shop Type fields
• Fulfillment.totalLinesPrice field
• Affiliates - All affiliates-related fields, queries and mutations
• Channels - Channel-related fields and types

Fixed an issue where financial ledger lock failures caused ledger imbalances and checkout issues.

Improved error handling around authentication to prevent tenant validation middleware from causing 500 errors when tokens expire.

Stabilized the permissions for agreement queries to ensure correct access control.

Optimized the Order.payout_status query to improve response time and handling for payout status updates.

Added the ability to include custom fields in fulfillments and the OrderFulfill mutation for greater flexibility.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Login For Products​

The "Login For Products" marketplace option has been deprecated and removed.

Fixed an issue where guest orders were not generating a SalesInvoice in Avalara.

Resolved an issue where the Nautical order confirmation was not appearing for guest users.

Fixed an attribute-related inequality error on the products page.

Resolved an issue where the new MANAGE_EMAILS permission was not automatically added to users with full access permissions.

Fixed an issue where users were unable to add permissions to the seller admin group.

Orders related to previous payouts will now remain linked to that payout, even when the same order is involved in a new payout.

Addressed a timeout issue on collection reordering mutations.

staffCreate and staffUpdate now correctly trigger the appropriate user events.

Added unfulfilledQuantityRefunded and fulfilledQuantityRefunded fields to the OrderLine. These fields now reflect the quantities refunded on orders.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Default Shipping Zone​

• The default field for ShippingZone will be removed on October 17, 2024. Shipping zones will no longer be marked as default, and this field will no longer be supported. The default shipping zone will be used for countries not covered by other zones.

Added the ability to filter seller orders by vendor payout IDs or payout IDs. It is now easier to get the overall list of orders that are included in payouts via vendorPayout and payouts queries.

• Added mutations to delete the banner and logo on Sellers.
• Seller staff members, in addition to seller owners, can now access and complete Seller Onboarding Checklist tasks.
• Added the ability to set the seller's default address as the warehouse address when creating new warehouses.

Staff can now perform metadata updates on checkouts that belong to them.

Fixed issue where certain payment capture types were not triggering autocommit in Avalara when the Autocommit toggle was set to true.

Improved error handling in the product bulk delete flow. Error message now shows the reason for failure if the one or more products are in active orders.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Designer Data Undeprecated​

Undeprecated designerData to meet SendGrid requirements. This data will remain available until further notice.

Added productStatusLogs to field to the Product type. This field tracks and saves changes to product statuses, including:

• The user who made the status change.
• The sub-status of the product and the reason for the change.
• A timestamp of when it was updated.

Added additional fields to the sellerBySlug query:

• Banner
• Store description
• Status

The VariantBulkCreate mutation now take externalId and externalSource as inputs.

Fixed an issue with category deletions. Added soft deletion that ensures ledgers, audit trails for commission calculations, and order cancellations are not blocked by deleted categories.

Sellers can now only delete warehouses and shipping zones they own.

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

Newly Deprecated​

The following types have been marked for deprecation:

• The microsites and all related query and mutations.
  • Please use sellerBySlug to query seller related information
  • Please use the collections functionality to create custom product and variant collections
• The features and all related query and mutations.
  • Please use customFields and attributes

Product review functionality has been removed​

The following types had been marked for deprecation and have been removed in this version:

• The productRatingsAndReviews query
• The productReviewSubmit mutation

Catalog export Undeprecated​

The catalogExport mutation has been undeprecated and will continue to be supported.

Fixed an issue where tax lines for free shipping sales and vouchers were still being sent to Avalara.

Removed Grouped Products​

The Grouped Products feature has been deprecated and will no longer be supported

For the full list of deprecations and suggested replacements, see GraphQL API Deprecations and Removals.

General Fixes and Updates​

We've added stability fixes related to Upcoming Multitenancy feature

Error Handling​

Resolved an issue where certain gateway responses were not processed correctly.

Performance Enhancements​

Improved overall system performance by optimizing the handling of certain processes, resulting in faster response times.

Deprecation Notice for Removed Queries and Mutations​

There are no newly deprecated or removed queries or mutations in this version, but please note there are some scheduled removals in the upcoming release next week.

For the most up-to-date information on deprecations and removals, please see GraphQL API Deprecations and Removals

Dummy Tax Plugin Stability Fixes​

We've added stability fixes to the Dummy Tax Plugin.

CORS Header Fixes​

Resolved a CORS issue that was causing headers to be blocked.

Seller Metadata Filtering​

Added the ability to filter sellers by metadata, providing more robust search capabilities within the system.

Seller Onboarding​

Pending sellers can now access the catalog page and see more details on their status.

Deprecation Notice for Removed Queries and Mutations​

The following API queries and mutations have been removed as part of our ongoing deprecation process:

• sellerName
• priceBookEntities
• businessEntities
• businessEntity

Removed Mutations:

• businessEntityCreate
• businessEntityUpdate
• businessEntityDelete
• businessEntityAddToPriceBook
• businessEntityRemoveFromPriceBook

For the most up-to-date information on deprecations and removals, please see GraphQL API Deprecations and Removals