Skip to main content

455 posts tagged with "API"

View All Tags

: Staging

: Production

✨ New

Orders

Enhanced order line tracking

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

Shipping

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.

Payouts

Delete draft payouts

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

Attributes

Numeric attributes on product variants

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

💎 Changed

Performance

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

Checkout

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

Shipping

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

Products

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

Payouts

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.
Emails

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

Attributes

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

: Staging

: Production

✨ New

payouts

Delete payouts

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

Learn more ->

payouts

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.

catalog

Numeric variant attributes

Variants now support attributes with the numeric input type.

🪲 Fixed

payouts

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

data entry

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

checkout

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

emails

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

payouts

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.

: Staging

: Production

✨ New

Products

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.

Discounts

Sale minimum requirements validation

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

Discounts

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.

Orders

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.

Payouts

Subtotal and total on vendor payouts

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

Checkout

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.

🚫 Deprecated

Checkout

Checkout public metadata editing config

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

💎 Changed

API

Available shipping methods now required

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

🪲 Fixed

Orders

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

Orders

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

API

Resolved circular dependency issues that could impact API stability.

: Staging

: Production

✨ New

discounts

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

  • sale
  • saleDiscount
  • voucherDiscount
  • discountedUnitPrice
  • originalUnitPrice
discounts

Added the currency field to the sale query.

payouts

Added the following fields to the VendorPayout model:

  • subtotal
  • total

🪲 Fixed

data entry

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.

Taxes

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

🚫 Deprecated

The enable_edit_checkout_public_metadata_by_customer configuration in the NauticalConfiguration model has been deprecated.

: Staging

: Production

✨ New

Checkout

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.

Payouts

Vendor payout creation

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

API

Enhanced development tools

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

💎 Changed

API

Simplified checkout configuration

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

API

Removed checkout line price override

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

Performance

Observability improvements

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

🪲 Fixed

Orders

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

Payments

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

Payments

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

: Staging

: Production

✨ New

payouts

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

Checkout line sale field

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

🪲 Fixed

invoices

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

webhooks

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.

🚫 Deprecated

checkout

The following MarketplaceConfiguration fields have been deprecated:

  • maxCheckoutLineQuantity
  • maxCheckoutQuantity
  • minCheckoutAmount
orders

Removed the subscription model

checkout

Removed checkoutLinePriceOverride mutation.

: Staging

: Production

✨ New

Discounts

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.

Discounts

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 mgmt

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

Orders

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.

Webhooks

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

: Staging

: Production

🪲 Fixed

Webhooks

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

Payouts

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

Discounts

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.

: Staging

: Production

✨ New

Catalog

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 ->

Catalog

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.

Catalog

Product template strategy field

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

Catalog

New attribute input types

Added several new supported input types to the AttributeInputTypeEnum.

Catalog

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.

Catalog

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

Catalog

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

: Staging

: Production

✨ New

API

Sandbox configuration

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

🪲 Fixed

Tax

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

Products

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

Discounts

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

Was this page helpful?