Nautical Changelog

Fixed an issue where refunds processed through Stripe were not consistently being updated to the PAID status.

Fixed an issue where refunds charged to the seller were not included in the seller payout calculations in certain cases.

Fixed an issue with the payout summary for a seller order (order.payoutsSummary.refunds), where the reported refund amount could be incorrect in certain situations. This issue did not affect the actual payout amount.

Removed the sites model, referred to as domains in the dashboard. Supported currencies for the marketplace will now be read from MarketplaceConfiguration.

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.

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.

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.

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.

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.

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.

Updated the ProductVariantFilter input to support filtering variants by metadata or privateMetadata.

Fixed an issue with the productUpdate mutation, where passing a null taxCode value did not clear the existing value.

Fixed an issue where orders outside the payout end date were incorrectly attributed to payouts with the ledger accounting system.

Fixed an issue where the agreementUpdate mutation required all the same inputs as agreementCreate.

Country area code display for address forms​

Added the detailedAllowedCountryAreas field to the CountryDisplay model for displaying area codes in address forms. This field replaces the deprecated CountryDisplay.allowedCountryAreas field.

Fixed an issue where non-qualifying items were incorrectly counted towards the minimum quantity requirement for voucher eligibility.

Fixed an issue where using app authentication to query productVariants sometimes triggered an 'App' object has no attribute 'is_anonymous' error.

Deprecated the CountryDisplay.allowedCountryAreas field. This field will be removed after 2024-12-31.