Traide Changelog

Shipping zone owner required​

The shippingZone.owner field is now required when creating a shipping zone.

Warehouse owner required​

The warehouse.owner field is now required when creating a warehouse.

Public media query​

The media query is now a public query that does not require authentication.

Seller APPLYING status​

The SellerStatus enum now supports the APPLYING status.

Update seller with tax identifier​

The sellerDataUpdate mutation now supports the identifiers input for setting the seller's tax identification number.

Fixed an issue where VendorPayout.gateway returned a blank response when querying a payout using the Manual payout gateway.

Deprecated affiliates​

Deprecated the affiliates model and related fields, which will be removed on October 26, 2024. For the full list of deprecations, see GraphQL API Deprecations and Removals.

Deprecated channels​

Deprecated the channels model and related fields, which will be removed on October 29, 2024. For the full list of deprecations, see GraphQL API Deprecations and Removals.

Marketplace seller identification​

Added the ability to identify marketplace sellers with a dedicated boolean field, making it easier to distinguish between marketplace operators and individual sellers.

Invoice generation for draft orders​

Added support for generating invoices for draft orders, streamlining the order approval and payment collection process.

Google Analytics integration​

Added a new Google Analytics plugin, allowing marketplaces to track customer behavior and conversion data directly from the platform.

Query ledgers and custom field templates​

Added the ability to query accounting ledgers and individual custom field templates, providing more flexibility for reporting and custom data management.

Automatic admin user creation for sellers​

When creating local sellers, the platform now automatically creates corresponding admin users, reducing manual setup steps.

Marketplace fulfillment configuration​

Updated marketplace configuration to support new fulfillment models, allowing operators to control whether sellers are fulfilled by the marketplace or handle their own fulfillment.

Fixed an issue where seller-created product attributes could be unintentionally removed by other sellers on the marketplace.

Fixed an issue where order payout data was accessible to users without the proper ManageOrders permission.

Fixed an issue where certain refunds were incorrectly included in payout calculations, leading to inaccurate seller payouts.

Fixed an issue where tax-related metadata keys were cleared instead of being properly removed, causing inconsistent tax calculations in some cases.

Fixed an issue where product data was not correctly displayed based on draft versus published view.

Fixed an issue preventing buyers from completing draft orders in certain scenarios.

Fixed an issue with Stripe ACH payments when using stored customer payment methods.

Updated Stripe integration to support newer API versions with changes to charge handling.

Deprecated fields​

The following fields and models are now deprecated and will be removed in a future release:

• Branding and designer data fields
• CoreData model
• Fulfillment.totalLinesPrice (replaced by totalLinesMoney)

Send payment link for draft orders​

Updated the NauticalQuoteOrderSendToCustomer mutation to add the ability to send a payment link to the buyer for draft orders, similar to quote orders.

Also added the ability for buyers to run the NauticalDraftOrderComplete mutation to submit payment and finalize their own draft orders.

Filter products by mpn​

Added the mpn field to the ProductFilterInput filter, to support filtering products by MPN.

Send payment link for draft orders​

Added the isMarketplaceSeller boolean field to the Seller object, which identifies if a seller corresponds to the marketplace owner.

Query a custom field template​

Added the customFieldTemplate query, to retrieve details for a single custom field template.

Query draft orders by token​

The nauticalOrderByToken query now returns draft orders.

Upgraded Klaviyo plugin API​

Upgraded the Klaviyo integration to use Klaviyo's updated API endpoint.

Upgraded Stripe plugin API​

Updated the Stripe API integration to account for changes to the Stripe Charges API.

Updated permission to view seller order payout data​

Updated the permissions required to view payout summary information on seller orders. Sellers now only need the manage_orders permission to view this data.

Fixed an issue with Stripe ACH payments when the "Store customer cards" setting was turned on.

Fixed an issue where the vendorPayoutList query returned excluded payouts.

Fixed a display issue with the commission column in vendor payouts.

Fixed an issue where sellers with permission to manage attributes could edit or delete attributes added by other sellers.

Fixed an issue that caused the following error when creating a new product with a date attribute: TypeError in AttributeValue Model: Multiple Values for 'date_time'

Removed the following types around Klaviyo plugin sync, which are longer in use:

• PluginSyncSettings query
• PluginSyncUpdate mutation
• SyncConfiguration
• SyncConfigurationDirection

Deprecated the Fulfillment.totalLinesPrice field, which is replaced by the Fulfillment.totalLinesMoney field. This field will be removed by October 25, 2024.

Deprecated the ShippingZone.default field. ShippingZones are not marked as default anymore. This field will be removed by October 17, 2024.

Deprecated the following types around designer data, which are no longer in use and will be removed by October 25, 2024.

• DesignerData
• DesignerDataCreate
• DesignerDataUpdate
• BrandingImagesDelete
• BrandingUpdate

Deprecated the following types around core data, which are no longer in use and will be removed by October 25, 2024.

• CoreData
• CoreDataCreate
• CoreDataUpdate

Filter products by manufacturer part number​

Added the ability to filter products by manufacturer part number (MPN), making it easier to search and manage product catalogs.

Seller onboarding settings​

Introduced configurable seller onboarding settings, allowing marketplace operators to customize the onboarding experience and requirements for new sellers.

Discount apportionment improvements​

Discounts are now apportioned based on net amounts, providing more accurate discount calculations across line items.

Klaviyo plugin API updates​

Updated the Klaviyo plugin to use the latest API endpoints, ensuring continued compatibility with Klaviyo's services.

Fixed an issue where the vendor payout list could incorrectly include excluded payouts.

Fixed an issue where sales invoices were not properly updated when fulfillments were declined.

Fixed an issue where seller commission data could not be resolved correctly for legacy orders.

Draft orders can now be sent to customers and queried by token, improving draft order management capabilities.

Fixed an issue where voucher calculations used incorrect currency in certain checkout scenarios.

Fixed ledger balance calculation errors that could occur in foreign exchange environments.

Fixed an issue where content with future publication dates did not properly activate based on the marketplace's timezone.

Extended lock expiry time when saving content to prevent concurrent editing conflicts.

The isSellerShippingZoneCreationAllowed field has been deprecated and will be removed in a future version.

The requires_secondary_address field on the ShippingMethod model has been deprecated. The "Default shipping zone" option has also been removed from the backend.

Fixed an issue where payout adjustments could be calculated incorrectly for certain vendor payout configurations.

Fixed an issue where vouchers set to "apply once per order" were not correctly applying to the lowest-cost eligible product.

Fixed an issue where content with a future publication date could be incorrectly marked as published immediately.

Fixed an issue where voucher usage tracking was incorrectly recorded when applying vouchers to draft orders.

Fixed an issue preventing the creation of new content using a slug that was previously used by deleted content.

Content management mutations​

Added new mutations for managing marketplace content:

• Create, update, and publish content pages
• Auto-save draft content with automatic expiration
• Discard draft changes
• Delete content pages

Draft content auto-saves expire after 30 minutes of inactivity.

Country-based shipping zones​

Added support for defining shipping zones by country areas, allowing more granular control over where shipping methods are available. Shipping zones now support:

• Country area definitions for more precise geographic coverage
• Validation to ensure country areas are configured correctly
• Metadata and private metadata fields for custom shipping zone data
• Metadata and private metadata fields for shipping methods

Marketplace supported countries​

Added supportedCountries to marketplace configuration, allowing operators to define which countries are available for shipping and checkout. The shop.countries query now respects this configuration when the feature flag is enabled.

Order line relationships​

Added a nauticalOrderLine field to OrderLine, making it easier to access marketplace-specific order data.

Fixed several issues with product attributes:

• Swatch attributes now behave correctly when applied to products and variants
• File attributes can now be properly assigned and updated
• Attribute input values now have explicit validation

Fixed multiple issues with voucher application:

• Vouchers with "once per order" enabled now correctly apply to only one variant
• Vouchers use the minimum price from available products when calculating discounts
• Vouchers with "once per customer" enabled now properly prevent reuse by the same customer
• Percentage discounts now use proper rounding (ROUND_HALF_UP) for more accurate calculations

Fixed an issue where content creation would succeed with duplicate slugs. The API now returns an error when attempting to create content with a slug that already exists.

Fixed an issue where querying sellers could fail if the seller record was missing an owner.

Fixed an issue where adding a new address to a customer record did not trigger the Customer Updated webhook.

Fixed an issue where payment tokens could be incorrectly updated while processing Stripe webhooks.

The isSellerShippingZoneCreationAllowed field has been deprecated in favor of the new country area-based shipping zone configuration.

Added the value input field to AttributeValueInput to support more input type usages, such as the color value for swatch attributes.

Added metadata and privateMetadata to the following models:

• ShippingMethod
• ShippingZone

Manage metadata with the metadataUpdate and privateMetadataUpdate mutations.

Fixed an issue where the customer_updated webhook was not being triggered by adding a customer address.

Deprecated the isSellerShippingZoneCreationAllowed field on the MarketplaceConfiguration model. This field will now always be overridden as true and wil be removed soon.

Unique seller slugs​

Sellers now have unique URL-friendly slugs, making it easier to reference and link to seller profiles throughout the platform.

Query sellers by slug​

Added the ability to query sellers using their unique slug, providing a more user-friendly way to retrieve seller information.

Public seller information​

Introduced a public seller query that returns limited seller information, ideal for displaying seller profiles on storefronts without exposing sensitive data.

Storefront theme customization​

Added support for storefront theme modeling, enabling customization of storefront appearance and branding through queries and mutations.

Media management​

Introduced new media queries and mutations for managing media assets across the platform, providing better control over images, videos, and other media content.

Content management​

Added content type support with queries, enabling more flexible content management capabilities within the platform.

Enhanced shipping zone configuration​

Added support for country-area shipping zones, providing more granular control over shipping configurations by geographic region.

Expanded fee support​

Platform fees can now be applied to any orders, providing more flexibility in how marketplace fees are structured and applied.

Legacy dashboard configuration fields have been marked as deprecated and will be removed in a future release. Please migrate to the new configuration system.

Fixed an issue where shipping sale discounts were not being properly subtracted from order totals.

Fixed an issue preventing seller slugs from being edited through the API.

Fixed validation issues with sale discount amounts that could result in incorrect discount calculations.

Fixed an issue where voucher discounts were not being apportioned correctly across order lines, ensuring accurate per-line discount calculations.

Improved the accuracy of order payout status filtering, ensuring queries return the correct results.

Fixed an issue where image fields were missing alt text attributes.

Fixed an issue where WorkOS user profile information was not being properly retrieved during SSO token creation.

Fixed an issue where inactive sales were being displayed on product and variant pages. Only active sales are now shown.

Seller slug field​

Added the slug field to the Seller model.

PublicSeller model​

Added the PublicSeller model, to retrieve public information about sellers. Also added the sellerBySlug query to retrieve a publicSeller by their unique slug.

Fixed an issue where you could not add order fees to fulfilled orders.

Deprecated dashboard types​

The following types related to the Dashboard have been deprecated:

• The dashboard query
• The dashboardConfigurationUpdate mutation

Sales and vouchers on products and variants​

Added the ability to view all active sales and vouchers directly on product and variant objects, making it easier to understand which discounts apply to specific items.

Voucher apply-once per product​

Added support for vouchers that can be configured to apply only once per product, even when multiple quantities are in the cart. This provides more granular control over discount application.

Sale shipping type updates​

Sales can now be updated to change their shipping type, providing more flexibility in managing promotional campaigns.

Filter staff users by active status​

Added the ability to filter staff users by their active/inactive status, making it easier to manage team member access.

Marketplace default country configuration​

Added a default country setting to marketplace configuration, which is now used throughout the platform for better localization support.

External ID support for warehouses and product images​

Warehouses and product images can now be created or updated using external IDs and sources, simplifying integration with external systems.

Performance improvements​

Made several performance improvements across the platform:

• Updating shipping methods on orders is now significantly faster.
• Creating draft order lines is more efficient.
• Discount calculation performance has been optimized throughout checkout and order flows.

Password reset improvements​

The password reset mutation now allows the redirect URL to be optional, providing more flexibility in implementation.

Fixed an issue where vouchers configured for specific products would incorrectly calculate discounts based on the entire cart subtotal instead of only the specified products.

Fixed an issue where removing the last item from a checkout could cause errors when discounts were applied.

Fixed an issue where sale discount amounts were not properly updated when order line quantities changed.

Fixed an issue where discount amounts in the ledger were incorrect on order finalization.

Fixed an issue where older orders would fail to load when discount v2 features were enabled.

Fixed an issue where adding products to checkouts could cause errors in certain scenarios.

Fixed an issue where the platform could crash if Avalara returned incomplete transaction data.

Fixed how voucher data is sent to Avalara for invoice creation, resolving checkout issues related to tax calculation.

Fixed an issue where invalid refunds could be incorrectly connected to payouts in the ledger flow.

Fixed an issue with Stripe configuration where the auto-capture setting was not properly retrieved.

Fixed an issue with product and variant substatuses not displaying correctly.

Fixed an issue where the PRODUCT_UPDATED webhook was not firing when product features were modified.

Removed deprecated API features​

Removed several long-deprecated queries, mutations, and fields from the API:

• Service account queries and mutations
• Barcode queries
• Legacy webhooks query
• Various deprecated type fields

If you are still using these deprecated features, please update your integration to use the recommended alternatives.