Traide Changelog

Improved discount tracking​

Enhanced the discount system to ensure the correct discount values are consistently saved and tracked across order and checkout flows.

Order fee IDs now returned​

The orderFeeCreate mutation now returns the ID of the created fee, making it easier to track and reference fees programmatically.

Updated payout permissions​

All payout-related mutations now require the MANAGE_MARKETPLACE permission for improved security and access control.

Sale type requirement​

The saleType field is now required when creating or updating sales, ensuring consistent categorization of promotional activities.

Fixed an issue where guest checkout without automatic payment capture was not working correctly. Guests can now complete checkout flows that defer payment capture.

Fixed an issue where creating a checkout for guest users required an email address. Guest checkouts can now be created without providing an email upfront.

Fixed an error that occurred when converting certain checkout types to quote orders, ensuring a smoother quote generation process.

Fixed an issue where payment amounts could exceed the remaining order balance (total minus already captured payments), preventing over-payment scenarios.

Fixed an issue that could create duplicate transaction records in the database, ensuring cleaner payment tracking.

Fixed an issue where certain monetary input values were not being correctly parsed, ensuring accurate order totals and fee calculations.

Fixed an issue where the orderFeeCreate mutation was not returning the ID of the order fee it created.

Fixed an issue that resulted in an AttributeError with the checkoutConvertToNauticalQuoteOrder mutation.

Customer update webhook on address changes​

The customer_update webhook now fires when a customer's address is added, updated, or removed, making it easier to keep external systems in sync with customer data.

Performance improvements​

Made several performance improvements across the platform:

• Checkout completion is now significantly faster, addressing latency issues during order finalization.
• Product variant price calculations are more efficient, reducing database queries.
• Creating and updating marketplace order lines is optimized for better performance.

Fixed an issue where some fields were missing when adding refund lines to orders.

Fixed an issue where field validation errors were displayed twice when creating a customer account.

Fixed an issue where CSV uploads on draft and quote orders could fail or produce incorrect results.

Fixed an issue where the payoutUpdate mutation could update payouts that were already marked as completed or failed.

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

Fixed an order line CSV upload issue on draft and quote orders that could apply discounts incorrectly after the 1.35 release.

Fixed performance issues related to checkouts and editing order lines after the 1.35 release.

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.