Links

2024

Commerce Layer changelog for software updates, new features, and general improvements.

Ensured non-editable attributes preservation during order placement, and more ⚠️

Core API

March 12, 2024

Be advised that we introduced a potential breaking change ⚠️ by refining the non-editable attributes check during the order placement. Altering those attributes during the order's placement process is not permitted, since they can trigger collateral effects and cause an inconsistent order status. Now, if try to edit them when you patch the order passing the _place trigger attribute no error is raised (to guarantee the order's placement), but the changes are silently ignored. On top of that, we added some minor updates to our APIs:
  • Shipments — we exposed a new virtual relationship on the shipment object that you can leverage to get all the line items included in the shipment (both the ones associated with stock line items and stock transfers).
  • Webhooks — we added two new events that you can leverage to be notified when the last run of an order subscription has succeeded or failed.

Introduced circuit breaker for all external resources, and more

Core API

March 7, 2024

Now all Commerce Layer external resources are subject to a circuit breaker check. If the call to your external endpoint fails consecutively more than 30 times, the circuit breaker opens and any further request to the resource will be skipped. The circuit is automatically reset anytime a call to your external endpoint succeeds before reaching the counter's threshold. You can check the circuit breaker's current status by fetching some new specific attributes, and/or reset it manually via trigger. On top of that, we added some minor updates to our APIs:
  • External promotions — now you can distribute the external promotion discount only on specific line items by adding their IDs to the response sent by your external service.
  • Promotions — now you can filter promotions also by type.
  • Customer payment sources — now you can filter customer payment sources also by payment source token.
  • Adjustments — as recently done for gift cards, now you can leverage a specific attribute to prevent negative adjustment amounts from being distributed as discounts on all the taxable items of the order.

Added option to not distribute gift card discount for tax calculation, and more

Core API

February 28, 2024

Now you can leverage a specific attribute at the single gift card level to prevent the total discount due to gift cards used to pay for an order from being distributed on all the taxable items of the order. On top of that, we added some minor updates to our APIs:
  • External promotions — now the currency code is no longer required to create external promotions which can be applied across all currencies.
  • Stock transfers — now, when stock transfers become upcoming the related stock is no longer decremented. Instead, the necessary stock reservations are created to eventually allow order editing (the stock will be then actually decremented when the stock transfer is completed).

Asynchronous order placement and new resource errors endpoint
🌟

Core API

February 20, 2024

Now you can decide to place your orders asynchronously by setting the related flag at the order level. In this scenario, if the order passes a subset of the synchronous standard validations it's momentarily moved to a new placing status where additional validations are performed (e.g. stock availability, coupons validity, etc.) before moving it through the next steps of its lifecycle. You can also check for errors that might keep an order stuck in placing by fetching the new resource errors endpoint, which will store until order approval not only any errors that occurred during the attempt to place an order (both synchronously and asynchronously), but also the ones coming from external validations, failed subscriptions, and more.

New split by line items inventory strategy
🌟

Core API

February 15, 2024

We added a new inventory strategy to the list of available ones. Now you can leverage the split by line item strategy by setting the related attribute accordingly at the inventory model level. This way, at least a separate shipment will be automatically created per each line item of the order. Please note that this new strategy only works for SKUS: if an order contains bundles, all the shipments and stock will be still managed by using the split shipments strategy as a fallback.

Enabled auto-place option for Stripe, and more

Core API

February 14, 2024

Now you can set an auto-place option at the payment method to ensure your orders are automatically placed upon authorization performed asynchronously (at the moment, available for Stripe gateways only). On top of that, we added some minor updates to our APIs:
  • Promotions relationships — now, when creating a new promotion or updating an existing one, you can create or update the associated SKU list, but you can't create or update the associated coupons and promotion rules anymore.
  • Shipments — now you can manually create or update shipments even when the associated order is fulfilled.
  • Returns — now you can create or update returns even when the associated order's fulfillment is in progress.

Cart express checkout buttons available in JS Drop-in v2.1.0

February 7, 2024

The Cart component of our JS Drop-in library now supports express checkout buttons for both Apple Pay and Google Pay via Stripe. We improved also the Availability component by adding the rule prop that enables you to choose which delivery lead time to display (one of the cheapest or the fastest).
To learn more and see our micro frontends in action, explore the interactive documentation. For any additional details or potential breaking changes see the release notes.

New Provisioning plugin
🌟

CLI

February 1, 2024

v1.0.0 of our Provisioning CLI plugin is out! Now you can use Commerce Layer Provisioning API (performing all the available CRUD actions on all resources and more) directly from the command line. To learn more about the plugin commands and options, please refer to the open-source GitHub repo README.

TypeScript SDK for Provisioning API
🌟

SDK

January 31, 2024

We just released v1.0.0 of our Provisioning SDK, an open-source TypeScript library wrapper that makes it quick and easy to interact with Commerce Layer Provisioning API, both in browser and Node.js applications. The TypeScript SDK is built on top of the Provisioning OpenAPI schema, which you can use as well to to build mock servers, auto-generate code, SDKs for other languages, implement contract testing, and more.

Introducing our new Provisioning API 🚀

January 30, 2024

We’ve released our Provisioning API, which now enables Commerce Layer clients to manage provisioning tasks (such as organization creation, API credentials, memberships, roles and permissions management, etc.) programmatically instead of manually and exercise greater control over your organizational structure and user onboarding.
You can find the credentials to access the Provisioning API together with your account settings in the Dashboard.
To learn more, check the documentation and read our blog here.

Added the new Stock Transfers app to the dashboard hub
🚀

Dashboard

January 25, 2024

As part of our new Dashboard renovations, we’ve released a new Stock Transfers application to help you manage stock transfers whenever your orders require one, allowing you to maintain a distributed inventory model without disrupting demand. You are now able to check all the key information behind each stock transfer and control their transition from one status to another. Click on the Hub tab and see it for yourself!
To learn more, read our blog here.

Added the editing feature to the Orders app

Dashboard

January 24, 2024

You can now leverage the order editing feature — previously available via API only — also from the Orders app of the Dashboard, being able to edit orders (e.g. adding or removing items, coupons or gift cards, adjustments, etc.) after placement (and before approval).

Added option to manually decrement stock after order approval

Core API

January 11, 2024

Now you can override the default API behavior (automatic stock quantities decrementation and stock reservations cancellation at order approval) by setting a simple flag on the inventory model. That lets you manually manage those actions at any time after the order approval by leveraging the trigger attributes exposed at the shipment and/or at the stock line item level.
Last modified 3d ago