463 posts tagged with "API"

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.

This release contains internal improvements and maintenance updates.

Metadata on product variants​

Added support for storing metadata on product variants, allowing you to attach custom data to individual product variations.

Fixed an issue where the dashboard orders summary query could incorrectly include marketplace order vendor data in certain scenarios.