Traide Changelog

Enhanced order line tracking​

Added tracking for additional fields on marketplace order lines, providing more detailed information for order management and reporting.

Shipping discounts at checkout​

Shipping discounts are now automatically applied at checkout when minimum order requirements are met, making it easier for customers to see their savings.

Delete draft payouts​

Marketplace operators can now delete draft payouts before they are finalized, providing more flexibility in payout management.

Numeric attributes on product variants​

Product variants now support numeric attributes, enabling better product specification and filtering capabilities.

Performance improvements​

Made several performance improvements across the platform:

• Added the ability to disable GraphQL tracing to reduce overhead in production environments.
• Optimized discount calculation utilities for faster checkout processing.

Fixed an issue where the CheckoutSellerShippingMethodsBulkUpdate mutation did not properly accept GraphQL IDs.

Fixed an issue where deleted shipping methods could cause errors during checkout migrations.

Fixed an issue where product price queries did not always return the expected price, min_price, and max_price values.

Fixed issues with vendor payout calculations in the legacy payouts flow:

• Checkout vendor payouts now correctly match orders.
• Vendor payout totals are now calculated accurately.

Fixed an issue where the display_gross_prices field was always set to true in email payloads, regardless of the actual marketplace configuration.

Fixed an issue where multiselect product attributes did not allow selecting multiple options properly.

Delete payouts​

Added the payoutDelete mutation, for deleting an individual draft payout.

Learn more ->

Create empty payouts​

You can now create draft payouts even when no orders qualify, to enable the creation of vendor payouts against an empty payout to support prepayment scenarios.

Numeric variant attributes​

Variants now support attributes with the numeric input type.

Fixed an issue where payouts could fail with an error stating that the vendor payout did not match the orders.

Fixed an issue preventing multiple options to be entered in multi-select fields.

Fixed an issue where checkoutSellerShippingMethodsBulkUpdate mutation did not update shipping prices after the 1.34 release.

Fixed an issue where the display_gross_prices field was always sent as true in SendGrid email payloads.

Fixed an issue where payout statements could display shipping costs incorrectly on payout statements processed with the legacy, non-ledgerized payout system. This was purely a Dashboard display issue for historical payouts and did not affect the amount paid to the seller.

Empty values for dropdown and multiselect attributes​

Product attributes with dropdown or multiselect types can now be saved with empty values, providing more flexibility when managing product variations.

Sale minimum requirements validation​

Sales now validate minimum purchase requirements, ensuring discounts are only applied when customers meet the configured criteria.

Currency field on sales and vouchers​

The currency field is now exposed on sales and vouchers in the API, making it easier to work with multi-currency discounts.

Sale information on order lines​

Order lines now include additional sale-related fields, providing better visibility into which discounts were applied at the time of purchase.

Subtotal and total on vendor payouts​

Added subtotal and total fields to VendorPayout, making it easier to understand payout calculations.

Improved seller shipping method handling​

Redesigned how shipping methods are managed per seller during checkout, improving accuracy and reliability when calculating shipping costs for marketplace orders.

Checkout public metadata editing config​

The configuration option to edit checkout public metadata is now deprecated and will be removed in a future release.

Available shipping methods now required​

The availableShippingMethods field is now non-nullable, ensuring shipping method information is always present when querying checkout data.

Fixed an issue where vat_code was not properly included in order line data.

Fixed an issue that could cause errors when retrieving seller orders in certain scenarios.

Resolved circular dependency issues that could impact API stability.

Added the following fields to the NauticalOrderLine object, to retrieve information about discounted pricing specific to an order line:

• sale
• saleDiscount
• voucherDiscount
• discountedUnitPrice
• originalUnitPrice

Added the currency field to the sale query.

Added the following fields to the VendorPayout model:

• subtotal
• total

Fixed an issue where you could not set dropdown or multi-select attributes back to an empty value after they are set to a value.

Fixed an issue where the nauticalOrderRefreshTaxes mutation was failing due to an error with the vat_code field.

The enable_edit_checkout_public_metadata_by_customer configuration in the NauticalConfiguration model has been deprecated.

Sale tracking on checkout lines​

Checkout lines now track which sale (if any) applies to them, making it easier to understand pricing and discounts during the checkout process.

Vendor payout creation​

Added the ability to create individual vendor payouts within a marketplace payout, giving operators more control over payout management.

Enhanced development tools​

Improved developer onboarding with updated documentation and a new populatedb command that simplifies database setup for local development and testing.

Simplified checkout configuration​

Removed legacy checkout settings for minimum/maximum quantities and minimum order amounts, streamlining the checkout configuration process.

Removed checkout line price override​

The checkoutLinePriceOverride mutation has been removed. Use sale-based pricing or other discount mechanisms instead.

Observability improvements​

Switched from DataDog to OpenTelemetry for tracing, improving monitoring capabilities and reducing overhead in production environments.

Fixed an issue where duplicate invoice numbers could be generated under certain conditions.

Fixed an issue where Stripe webhook events weren't correctly triggering the "fully paid" status for marketplace orders.

Fixed validation on Stripe payment amounts to ensure only positive values are accepted.

Add vendor payout to draft payout​

Added the vendorPayoutCreate mutation, to add a seller to a draft payout if they were not included when the payout was initially created.

Checkout line sale field​

Added the sale field to the checkoutLine model, which returns a matching sale for the checkout line, if applicable.

Fixed an issue where multiple invoices could be generated with the same invoice number.

Fixed an issue where ACH payments were not triggering the Nautical Order Updated Webhook or the Nautical Order Fully Paid Webhooks when the ACH payment was captured.

The following MarketplaceConfiguration fields have been deprecated:

• maxCheckoutLineQuantity
• maxCheckoutQuantity
• minCheckoutAmount

Removed the subscription model

Removed checkoutLinePriceOverride mutation.

Variant-level discount control​

Added the ability to apply sales and vouchers directly to specific product variants, giving you more granular control over promotional pricing. You can now:

• Assign individual variants to sales and vouchers
• Filter vouchers by variant ID
• View which variants are included in each discount through the API

This enables more targeted promotions, such as offering discounts on specific sizes, colors, or configurations of a product.

Minimum requirements for sales​

Sales can now specify minimum purchase requirements, allowing you to create promotions like "Buy 2, get 10% off" or set minimum order values for discount eligibility.

Seller owner access to payout details​

Seller owners can now access detailed payout information for their vendor accounts, providing better visibility into payment processing and settlement schedules.

Fixed an issue where declining a fulfillment would incorrectly remove an applied voucher from the order. Vouchers now remain properly applied when fulfillments are declined.

Fixed an issue where bulk publishing products did not trigger the product updated webhook. Product update webhooks now fire correctly during bulk publish operations.

Fixed an issue where the product_update webhook was not being triggered when products were published in bulk using the productBulkPublish mutation.

Fixed an issue where seller admins could not query order.fees, resulting in a 404 page when opening a payout in the dashboard.

Fixed an issue where voucher discounts, specifically those with the "Limit one per customer" setting enabled, were not calculated correctly after a fulfillment was declined.

Custom fields​

Added the ability for marketplace operators to define custom fields for various object models. The following objects support custom fields: USER, PRODUCT, VARIANT, CATEGORY, and COLLECTION.

Add attributes to custom field templates to make those attributes available for data entry on the associated object.

This feature includes the following GraphQL changes:

• Assign an attribute to an object model’s custom field template with the customAttributeAssign mutation.
• Query custom field templates with the customFieldTemplates query.
• Remove attributes from a custom field template with the customAttributeUnassign mutation.
• The following inputs have been updated to support assigning customFields when creating and updating objects:
• ProductInput, ProductCreateInput
• ProductVariantInput, ProductVariantCreateInput
• UserCreateInput, CustomerInput, StaffUpdateInput
• CategoryInput
• CollectionInput, CollectionCreateInput

Learn more ->

Attribute template strategy field​

Added the attributeTemplateStrategy field to the MarketplaceConfiguration model, allowing operators to customize how attributes are assigned across product attributes, variant attributes, and custom fields.

Related to this change, added the templated field, which you can query under product attributes, variant attributes, and custom fields to see if the selected attribute came from a templated assignment.

Product template strategy field​

Added the requireProductTypes field to the MarketplaceConfiguration model, allowing operators to make product template usage optional.

New attribute input types​

Added several new supported input types to the AttributeInputTypeEnum.

Update product template on product​

The productUpdate mutation now accepts the productType input field, allowing you to change the product template on an existing product.

Update parent product on variant​

The productVariantUpdate mutation now accepts the product input field, allowing you to change the parent product of a variant.

Fixed an issue with filtering the variants list based on the isPublished field.

Sandbox configuration​

Added new sandbox fields to the marketplace configuration, allowing for easier testing and development workflows.

Fixed an issue where tax calculations defaulted to gross pricing instead of net pricing, which could lead to unexpected tax amounts in certain configurations.

Fixed an issue where product variant listings did not correctly respect the is_published flag, potentially showing unpublished variants in some queries.

Improved performance when loading sale information for products, making discount-related queries faster.