From b074cc938d3fcb315f3465d95dce6f1cab866b35 Mon Sep 17 00:00:00 2001 From: Matt Brailsford Date: Thu, 5 Jun 2025 09:36:06 +0100 Subject: [PATCH 01/12] Umbraco Commerce v16 Release Notes + Tidy up --- 15/umbraco-commerce/release-notes/README.md | 2 +- 16/umbraco-commerce/release-notes/README.md | 61 ++-------- .../release-notes/v15.0.0-rc.md | 84 -------------- .../release-notes/v15.1.0-rc.md | 45 -------- .../packages/checkout/release-notes.md | 87 +-------------- .../packages/deploy/release-notes.md | 105 +----------------- .../payment-providers/buckaroo/README.md | 2 +- .../payment-providers/klarna/README.md | 2 +- .../payment-providers/mollie/README.md | 2 +- .../payment-providers/nets/README.md | 2 +- .../payment-providers/opayo/README.md | 2 +- .../payment-providers/paypal/README.md | 2 +- .../payment-providers/quickpay/README.md | 2 +- .../payment-providers/stripe/README.md | 2 +- .../payment-providers/stripe/release-notes.md | 27 ++--- .../payment-providers/worldpay/README.md | 2 +- .../install-sales-tax-providers.md | 48 ++++++++ .../sales-tax-providers/taxjar/README.md | 24 ++++ .../taxjar/configuring-taxjar.md | 14 +++ .../taxjar/configuring-umbraco.md | 31 ++++++ .../shipping-providers/dhl/README.md | 2 +- .../shipping-providers/dhl/release-notes.md | 18 +-- .../shipping-providers/easypost/README.md | 2 +- .../easypost/release-notes.md | 18 +-- .../shipping-providers/shipmondo/README.md | 2 +- .../shipmondo/release-notes.md | 18 +-- 26 files changed, 162 insertions(+), 444 deletions(-) delete mode 100644 16/umbraco-commerce/release-notes/v15.0.0-rc.md delete mode 100644 16/umbraco-commerce/release-notes/v15.1.0-rc.md create mode 100644 commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md create mode 100644 commerce-add-ons/sales-tax-providers/taxjar/README.md create mode 100644 commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md create mode 100644 commerce-add-ons/sales-tax-providers/taxjar/configuring-umbraco.md diff --git a/15/umbraco-commerce/release-notes/README.md b/15/umbraco-commerce/release-notes/README.md index b0583af2cf6..736db8eb4bc 100644 --- a/15/umbraco-commerce/release-notes/README.md +++ b/15/umbraco-commerce/release-notes/README.md @@ -16,7 +16,7 @@ If you are upgrading to a new major version, check the breaking changes in the [ ## Release History -This section contains the release notes for Umbraco Commerce 14 including all changes for this version. +This section contains the release notes for Umbraco Commerce 15 including all changes for this version. #### [15.3.2](https://github.com/umbraco/Umbraco.Commerce.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Acomponent%2Fcommerce+label%3Arelease%2F15.3.2) (May 1st 2025) diff --git a/16/umbraco-commerce/release-notes/README.md b/16/umbraco-commerce/release-notes/README.md index 0ff82adbb41..6c95e76f40d 100644 --- a/16/umbraco-commerce/release-notes/README.md +++ b/16/umbraco-commerce/release-notes/README.md @@ -16,61 +16,16 @@ If you are upgrading to a new major version, check the breaking changes in the [ ## Release History -This section contains the release notes for Umbraco Commerce 14 including all changes for this version. +This section contains the release notes for Umbraco Commerce 16 including all changes for this version. -#### [15.2.1](https://github.com/umbraco/Umbraco.Commerce.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.2.1) (Mar 31st 2025) +#### 15.0.0 (12th Jun 2025) -* Fixed an issue in the previous migration that increased the monetary column precision [#681](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/681). -* Fixed bug with Umbraco Commerce price property editor causing error when accessing content via Delivery API [#683](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/683). -* Fixed issue with order list performance being slow [#680](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/680). -* Fixed issue with stock field in multi variants editor always returning zero [#676](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/676). +* v16 final release -#### [15.2.0](https://github.com/umbraco/Umbraco.Commerce.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.2.0) (Mar 3rd 2025) +#### 16.0.0-rc1 (28th May 2025) -* Updated Umbraco.Licenses dependency to fix issue with license resolution in Azure environments. -* Fixed issue with amount based discounts not persisting the amount value correctly [#674](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/674). -* Fixed issue with member group discounts throwing error [#675](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/675). -* Fixed the `OrderHasCustomerEmailAddress` query specification performing the wrong comparison (essentially inverted). -* Fixed issue where a recalculation of an order with a shipping method that no longer meets it's eligability criteria rolls back the Unit of Work even if the failure can be automatically rectified. -* Added "Customer Source" config option to member group discount rule to allow you choose where the customer should be resolved from. Either the order or the session. +Initial release candidate for Umbraco v16. This release doesn't contain any new features rather it's just a v16 compatability release. -#### [15.1.1](https://github.com/umbraco/Umbraco.Commerce.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.1.1) (19th Feb 2025) - -* Fixed bug in price property editor not formatting prices correctly on load when using a non US currency format [#666](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/666). -* Fixed bug in commerce section dashboard showing the wrong order total value + order total count [#601](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/601). -* Fixed bug that deleting a country would throw exception [#477](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/477). -* Fixed bug where deleting a region didn't update Shipping / Payment Method allowed country regions [#669](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/669). -* Fixed bug where error is thrown if saving a shipping / payment method without an SKU by adding client side required field validation [#384](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/384). -* Fixed bug with `applyToCurrentOrder` not applying changes to default currency [#278](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/278). -* Fixed bug where changing a gift card code alias would cause error for orders using that gift card [#149](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/149). -* Added code to retry requests that result in a `DBConcurrencyException`. - -#### 15.1.0 (14th Feb 2025) - -* v15.1.0 final release - -#### 15.1.0-rc1 (7th Feb 2025) - -Read the [v15.1.0-rc release post](v15.1.0-rc.md) for further background on this release. - -* Added cart cleanup service -* Added order line actions UI extension point - -#### 15.0.1 (5th Feb 2025) - -* Fixed `TranslatedValue` erroring if the language key was `null`, instead of falling back to the default value. -* Added async `WithOrderLine` extensions to allow a more fluent API. - -#### 15.0.0 (23rd Jan 2025) - -* v15 final release - -#### 15.0.0-rc1 (24th May 2024) - -Read the [v15.0.0-rc release post](v15.0.0-rc.md) for further background on this release. - -* v15 initial release candidate - -## Legacy release notes - -You can find the release notes for **Vendr** in the [Change log file on GitHub](../../../10/umbraco-commerce/changelog-archive/Vendr-core.md). +* Updated to Umbraco CMS v16 +* Upgraded all third party dependencies +* Removed all obsolete code flagged for removal in v16 diff --git a/16/umbraco-commerce/release-notes/v15.0.0-rc.md b/16/umbraco-commerce/release-notes/v15.0.0-rc.md deleted file mode 100644 index 306d42803c6..00000000000 --- a/16/umbraco-commerce/release-notes/v15.0.0-rc.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -description: Umbraco Commerce v15.0.0-rc release notes. ---- - -# v15.0.0-Rc - -Umbraco Commerce v15.0.0-rc is the initial release of Umbraco Commerce for Umbraco CMS v15. - -## Key Takeaways - -* Everything is now [async](v15.0.0-rc.md#async). -* [Storefront API](v15.0.0-rc.md#storefront-api) aligned with Management API -* A number of [Umbraco v15 updates](v15.0.0-rc.md#umbraco-v15-updates). - -## Async - -The key focus of this release is the move to a fully asynchronous code base. To reduce the maintenance burden, the decision was made to go fully async without maintaining backward compatibility. This will therefore require code updates to use the new async methods. - -### Previous behavior - -Previously all C# API's were synchronous and thus blocking by nature. - -```csharp -// Fluent API example -order.AddProduct(productRef, 1) - .SetPaymentMethod(paymentMethodId) - .SetShippingMethod(shippingMethodId); - -// Service method examples -orderService.SaveOrder(order); -emailTemplateService.SendEmail(emailTemplateId, order); - -// Notification events -public class MyNotification : NotificationEventHandlerBase -{ - public override void Handle(OrderFinalizedNotification evt) - { - // Implement your custom logic here - } -} -``` - -### New behavior - -All APIs are now asynchronous and thus are suffixed with Async and return a Task result. - -```csharp -// Fluent API example -await order.AddProductAsync(productRef, 1) - .SetPaymentMethodAsync(paymentMethodId) - .SetShippingMethodAsync(shippingMethodId); - -// Service method examples -await orderService.SaveOrderAsync(order); -await emailTemplateService.SendEmailAsync(emailTemplateId, order); - -// Notification events -public class MyNotification : NotificationEventHandlerBase -{ - public override Task HandleAsync(OrderFinalizedNotification evt, CancelationToken cancelationToken) - { - // Implement your custom logic here - } -} -``` - -## Storefront API - -Implementing the Management API in v14 provided valuable insights into API structure. Common models were identified between the Management API and the Storefront API. To aid with maintenance and align approaches, the Storefront API was updated to reflect similar patterns. - -The API will largely remain the same, with the main change being updated operation IDs for compatibility with client generators. - -## Umbraco v15 updates - -In addition to the asynchronous work, Umbraco Commerce v15 has been updated to depend on Umbraco v15, which includes the following updates: - -* Runs against .NET 9 -* Variants property editor supports content variants - -## What to Test and How to Give Feedback - -We welcome any feedback on installation or upgrade issues, as well as any bugs found in the sections mentioned above. - -Issues can be raised on the Umbraco Commerce issue tracker at [https://github.com/umbraco/Umbraco.Commerce.Issues/issues](https://github.com/umbraco/Umbraco.Commerce.Issues/issues). diff --git a/16/umbraco-commerce/release-notes/v15.1.0-rc.md b/16/umbraco-commerce/release-notes/v15.1.0-rc.md deleted file mode 100644 index 06543ccb7ee..00000000000 --- a/16/umbraco-commerce/release-notes/v15.1.0-rc.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -description: Umbraco Commerce v15.1.0-RC release notes. ---- - -# v15.1.0-RC - -## Key Takeaways - -* [Cart Cleanup Service](v15.1.0-rc.md#cart-cleanup-service). -* [Order Line Actions](v15.1.0-rc.md#order-line-actions) - -## Cart Cleanup Service - -The cart cleanup service is a new background service that periodically cleans up old abandoned carts. This service is off by default, but can be enabled via app settings. - -```json -{ - "Umbraco" : { - "Commerce": { - "CartCleanupPolicy": { - "EnableCleanup": true, - "KeepCartsForDays": 800 - } - } - } -} -``` - -See the [Configuring Cart Cleanup guide](../how-to-guides/configuring-cart-cleanup.md) for more details. - -## Order Line Actions - -Order line actions are a new UI extension point that lets you register custom buttons to display against each order line of a cart/order. - - -![Custom Order Line Action](../media/v14/order-line-action.png) - -See the [Order Line Actions article](../key-concepts/ui-extensions/order-line-actions.md) for more details. - - -## What to Test and How to Give Feedback - -We welcome any feedback on installation or upgrade issues, as well as any bugs found in the sections mentioned above. - -Issues can be raised on the Umbraco Commerce issue tracker at [https://github.com/umbraco/Umbraco.Commerce.Issues/issues](https://github.com/umbraco/Umbraco.Commerce.Issues/issues). diff --git a/commerce-add-ons/packages/checkout/release-notes.md b/commerce-add-ons/packages/checkout/release-notes.md index ecee2a0653b..6a44c5a8357 100644 --- a/commerce-add-ons/packages/checkout/release-notes.md +++ b/commerce-add-ons/packages/checkout/release-notes.md @@ -1,88 +1,3 @@ # Release Notes -In this section, we have summarized the changes to Checkout package for Umbraco Commerce released in each version. Each version is presented with a link to the [Umbraco Commerce Checkout issue tracker](https://github.com/umbraco/Umbraco.Commerce.Checkout/issues) showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail. - -If there are any breaking changes or other issues to be aware of when upgrading they are also noted here. - -{% hint style="info" %} -For details of releases for **Checkout package for Vendr**, refer to the [Change log file on GitHub](../../changelog-archive/package-checkout.md). -{% endhint %} - -## Release History - -In this section, you can find the release notes for each version of Checkout package for Umbraco Commerce. For each major version, you can find the details about each release. - -
- -Version 15 - -#### 15.0.1 (Apr 7th, 2025) - -* Minor UI styling updates. - -#### 15.0.0 (23rd Jan 2025) - -* v15 release - -
- -
- -Version 14 - -#### 14.0.0 (August 23rd 2024) - -* Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. - -
- -
- -Version 13 - -**13.1.0 (February 21st 2024)** - -* Minor release closing off the RC period. - -**13.1.0-rc1 (February 6th 2024)** - -* Adds support for dynamic and realtime rates. -* Updates a number of obsolete method calls. - -**13.0.0 (December 13th 2023)** - -* Umbraco v13 and Umbraco Commerce v13 support. - -
- -
- -Version 12 - -[**12.0.1**](https://github.com/umbraco/Umbraco.Commerce.Checkout/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.0.1) **(October 18th 2023)** - -* Fixed additional issues in [#1](https://github.com/umbraco/Umbraco.Commerce.Checkout/issues/1) due to front-end views having lowercase asset paths, when they should be title case inline with the folder structure, thus causing a 404 on case-sensitive file systems. - -[**12.0.0**](https://github.com/umbraco/Umbraco.Commerce.Checkout/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.0.0) **(July 5th 2023)** - -* [Initial product launch](https://umbraco.com/blog/umbraco-commerce-release/) - -
- -
- -Version 10 - -[**10.0.2**](https://github.com/umbraco/Umbraco.Commerce.Checkout/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.0.2) **(October 18th 2023)** - -* Fixed additional issues [#1](https://github.com/umbraco/Umbraco.Commerce.Checkout/issues/1) due to front-end views having lowercase asset paths, when they should be title case inline with the folder structure, thus causing a 404 on case-sensitive file systems. - -[**10.0.1**](https://github.com/umbraco/Umbraco.Commerce.Checkout?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.0.1) **(August 15th 2023)** - -* Fixed [#1](https://github.com/umbraco/Umbraco.Commerce.Checkout/issues/1) where static assets weren't getting deployed with the NuGet package and so the installer dashboard was 404ing. Static assets are now correctly embedded. - -[**10.0.0**](https://github.com/umbraco/Umbraco.Commerce.Checkout/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.0.0) **(July 5th 2023)** - -* [Initial product launch](https://umbraco.com/blog/umbraco-commerce-release/) - -
+For details of any changes to the **Umbraco Commerce Checkout** plugin, please refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.Checkout/releases). \ No newline at end of file diff --git a/commerce-add-ons/packages/deploy/release-notes.md b/commerce-add-ons/packages/deploy/release-notes.md index 958ed75f2be..a96b4facd9c 100644 --- a/commerce-add-ons/packages/deploy/release-notes.md +++ b/commerce-add-ons/packages/deploy/release-notes.md @@ -1,106 +1,3 @@ # Release Notes -In this section, we have summarized the changes to Deploy package for Umbraco Commerce released in each version. Each version is presented with a link to the [Umbraco Commerce Deploy issue tracker](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues) showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail. - -If there are any breaking changes or other issues to be aware of when upgrading they are also noted here. - -{% hint style="info" %} -For details of releases for **Deploy package for Vendr**, refer to the [Change log file on GitHub](../../changelog-archive/package-deploy.md). -{% endhint %} - -## Release History - -In this section, you can find the release notes for each version of Deploy package for Umbraco Commerce. For each major version, you can find the details about each release. - - - -
- -Version 14 - -#### [14.1.1](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.1.1) (October 24th 2024) - -* Fixes Unexpected entity type `umbraco-commerce-country` error [#11](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues/11). - -#### 14.1.0 (September 30th 2024) - -* Release for Umbraco Commerce v14.1.0 with Tax Calculation Methods support. - -#### 14.0.0 (August 23rd 2024) - -* Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. - -#### 14.0.0-rc1 (August 5th 2024) - -* Initial conversion for Umbraco v14.0.0 and Umbraco Commerce v14.0.0 support. - -
- -
- -Version 13 - -#### [13.1.2](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.1.2) (October 24th 2024) - -* Fixes Unexpected entity type `umbraco-commerce-country` error [#11](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues/11). - -#### [13.1.2](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.1.2) (August 9rd 2024) - -* Fixed issue where shipping/payment method prices are restored before allowed country regions causing validation errors [#10](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues/10). - - -#### [13.1.1](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.1.1) (March 3rd 2024) - -* Fixed issue with new property not being null checked and so causing error [#8](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues/8). - -#### 13.1.0 (February 21st 2024) - -* Minor release closing off the RC period. - -#### 13.1.0-rc1 (February 6th 2024) - -* Adds support for Locations -* Updates store to handle default location and measurement system. -* Updates shipping methods to handle dynamic and realtime configurations. - -#### 13.0.0 (December 13th 2023) - -* Umbraco v13 and Umbraco Commerce v13 support. - -
- -
- -Version 12 - -#### [12.0.1](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.0.1) (October 18th 2023) - -* Fixed issue where store entity pickers would fail to transfer correctly do to deserializing property editor config to the wrong format [#3](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues/3). - -#### [12.0.0](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.0.0) (July 5th 2023) - -* [Initial product launch](https://umbraco.com/blog/umbraco-commerce-release/). - -
- -
- -Version 10 - -#### [10.0.1](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.0.1) (October 18th 2023) - -* Fixed issue where store entity pickers would fail to transfer correctly do to deserializing property editor config to the wrong format [#3](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues/3). - -#### [10.0.0](https://github.com/umbraco/Umbraco.Commerce.Deploy/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.0.0) (July 5th 2023) - -* [Initial product launch](https://umbraco.com/blog/umbraco-commerce-release/). - -
+For details of any changes to the **Umbraco Commerce Deploy** plugin, please refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.Deploy/releases). \ No newline at end of file diff --git a/commerce-add-ons/payment-providers/buckaroo/README.md b/commerce-add-ons/payment-providers/buckaroo/README.md index faeebab62ca..036f6f4178e 100644 --- a/commerce-add-ons/payment-providers/buckaroo/README.md +++ b/commerce-add-ons/payment-providers/buckaroo/README.md @@ -18,5 +18,5 @@ Here are a few useful links to help you learn more about the Buckaroo payment pr * [Buckaroo Payment methods Documentation](https://docs.buckaroo.io/docs/payment-methods) * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Buckaroo) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Buckaroo/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [Buckaroo checkout information](https://www.buckaroo.eu/large-corporations/solutions/payment-methods) diff --git a/commerce-add-ons/payment-providers/klarna/README.md b/commerce-add-ons/payment-providers/klarna/README.md index b5ed2abc430..b8d433ba495 100644 --- a/commerce-add-ons/payment-providers/klarna/README.md +++ b/commerce-add-ons/payment-providers/klarna/README.md @@ -24,4 +24,4 @@ Here are a few useful links to help you learn more about the Klarna payment prov * [Klarna developer documentation](https://docs.klarna.com/) * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) diff --git a/commerce-add-ons/payment-providers/mollie/README.md b/commerce-add-ons/payment-providers/mollie/README.md index cd35e2f5842..1d0ade25a2d 100644 --- a/commerce-add-ons/payment-providers/mollie/README.md +++ b/commerce-add-ons/payment-providers/mollie/README.md @@ -17,6 +17,6 @@ To Install the Mollie payment provider, see the [Install Payment Providers](../i Here are a few useful links to help you learn more about the Mollie payment provider and the Mollie API: * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Mollie) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Mollie/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [Mollie website](https://www.mollie.com) * [Mollie API documentation](https://docs.mollie.com/reference/v2/payments-api/overview) diff --git a/commerce-add-ons/payment-providers/nets/README.md b/commerce-add-ons/payment-providers/nets/README.md index 0b9de19b905..d3c8875aade 100644 --- a/commerce-add-ons/payment-providers/nets/README.md +++ b/commerce-add-ons/payment-providers/nets/README.md @@ -17,6 +17,6 @@ To Install the Nets payment provider, see the [Install Payment Providers](../ins Here are a few useful links to help you learn more about the Nets payment provider and the Nets API: * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Nets) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Nets/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [Nets documentation](https://developers.nets.eu/nets-easy/en-EU/docs/) * [Nets API reference](https://developers.nets.eu/nets-easy/en-EU/api/) diff --git a/commerce-add-ons/payment-providers/opayo/README.md b/commerce-add-ons/payment-providers/opayo/README.md index 966c553f456..a32979f93de 100644 --- a/commerce-add-ons/payment-providers/opayo/README.md +++ b/commerce-add-ons/payment-providers/opayo/README.md @@ -21,6 +21,6 @@ To Install the Opayo payment provider, see the [Install Payment Providers](../in Here are a few useful links to help you learn more about the Opayo payment provider and the Opayo API: * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Opayo) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Opayo/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [Opayo documentation](https://developer-eu.elavon.com/docs/opayo) * [Opayo API reference](https://developer-eu.elavon.com/docs/opayo/spec/api-reference) diff --git a/commerce-add-ons/payment-providers/paypal/README.md b/commerce-add-ons/payment-providers/paypal/README.md index fffceb61c3a..2766295bf73 100644 --- a/commerce-add-ons/payment-providers/paypal/README.md +++ b/commerce-add-ons/payment-providers/paypal/README.md @@ -17,5 +17,5 @@ To Install the PayPal payment provider, see the [Install Payment Providers](../i Here are a few useful links to help you learn more about the PayPal payment provider and the PayPal API: * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Paypal) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Paypal/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [PayPal checkout documentation](https://developer.paypal.com/docs/checkout/) diff --git a/commerce-add-ons/payment-providers/quickpay/README.md b/commerce-add-ons/payment-providers/quickpay/README.md index bae0dddf8cf..11d735b68f6 100644 --- a/commerce-add-ons/payment-providers/quickpay/README.md +++ b/commerce-add-ons/payment-providers/quickpay/README.md @@ -17,6 +17,6 @@ To Install the QuickPay payment provider, see the [Install Payment Providers](.. Here are a few useful links to help you learn more about the QuickPay payment provider and the QuickPay API: * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Quickpay) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Quickpay/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [QuickPay API information](https://quickpay.net/integrations/quickpay-api/) * [QuickPay API documentation](https://learn.quickpay.net/tech-talk/api/) diff --git a/commerce-add-ons/payment-providers/stripe/README.md b/commerce-add-ons/payment-providers/stripe/README.md index fe86690b781..5d246827e81 100644 --- a/commerce-add-ons/payment-providers/stripe/README.md +++ b/commerce-add-ons/payment-providers/stripe/README.md @@ -17,6 +17,6 @@ To Install the Stripe payment provider, see the [Install Payment Providers](../i Here are a few useful links to help you learn more about the Stripe payment provider and the Stripe API: * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Stripe) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Stripe/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [Stripe checkout information](https://stripe.com/gb/payments/checkout) * [Stripe checkout documentation](https://stripe.com/docs/payments/checkout) diff --git a/commerce-add-ons/payment-providers/stripe/release-notes.md b/commerce-add-ons/payment-providers/stripe/release-notes.md index 77f47619115..83a7d429268 100644 --- a/commerce-add-ons/payment-providers/stripe/release-notes.md +++ b/commerce-add-ons/payment-providers/stripe/release-notes.md @@ -8,39 +8,26 @@ If there are any breaking changes or issues to be aware of when upgrading, they This section contains the release notes for each version of the Stripe Payment Provider for Umbraco Commerce. For each major version, you can find the details about the specific changes. -
+### Version 14 and above -Version 13 +* For details of changes in v14 and above of the **Quickpay Payment Provider for Umbraco Commerce**, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Stripe/releases). -#### [13.1.0 (December 28th 2023)](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Stripe/issues?q=label%3Arelease%2F13.1.0+) +### Version [13.1.0 (December 28th 2023)](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Stripe/issues?q=label%3Arelease%2F13.1.0+) * Migrate from Newtonsoft.Json to System.Text.Json. -#### 13.0.0 (December 13th 2023) +### Version 13.0.0 (December 13th 2023) * Upgraded Umbraco & Umbraco Commerce dependencey to v13 * Upgraded all 3rd party nuget dependencies -
- -
- -Version 12 - -#### 12.0.0 (July 5th 2023) +### Version 12.0.0 (July 5th 2023) * [Initial product launch](https://umbraco.com/blog/umbraco-commerce-release/). -
- -
- -Version 10 - -#### 10.0.0 (July 5th 2023) +### Version 10.0.0 (July 5th 2023) * [Initial product launch](https://umbraco.com/blog/umbraco-commerce-release/). - -
+ ## Legacy release notes diff --git a/commerce-add-ons/payment-providers/worldpay/README.md b/commerce-add-ons/payment-providers/worldpay/README.md index 6bdde007d85..1f5e8537817 100644 --- a/commerce-add-ons/payment-providers/worldpay/README.md +++ b/commerce-add-ons/payment-providers/worldpay/README.md @@ -21,6 +21,6 @@ To Install the Worldpay payment provider, see the [Install Payment Providers](.. Here are a few useful links to help you learn more about the Worldpay payment provider and the Worldpay API: * [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Worldpay) -* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Worldpay/issues) +* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [Worldpay documentation](https://developer.worldpay.com/docs/access-worldpay) * [Worldpay API reference](https://developer.worldpay.com/docs/access-worldpay/api/references) diff --git a/commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md b/commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md new file mode 100644 index 00000000000..05990d04fc2 --- /dev/null +++ b/commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md @@ -0,0 +1,48 @@ +--- +description: >- + Learn how to install and add sales tax providers to your Umbraco Commerce + implementation. +--- + +# Install Sales Tax Providers + +When you need to install a payment provider into your Umbraco Commerce implementation it is done via NuGet. + +You can install a payment provider in one of two ways: + +## Install via the NuGet Manager Console + +1. Open the **NuGet Manager Console**. +2. Enter the following command: + +```bash +Install-Package Umbraco.Commerce.SalesTaxProviders.PROVIDER +``` + +3. Use the available [Sales Tax Providers](install-sales-tax-providers.md#available-sales-tax-providers) table below to find the correct package name for the provider you want to install. + +## Install via the NuGet Package Manager + +1. Open the NuGet Package Manager. +2. Browse for the Sales Tax Provider you want to install. +3. Install the package into your solution. + +Alternatively, you can also find and install the NuGet package via the NuGet Package Manager. + +![Installing Umbraco Commerce via the NuGet Package Manager](media/nuget-package-manager-gui-latest.png) + +## Available Sales Tax Providers + + + + + +
Sales Tax ProviderNuGet Package name
TaxJarUmbraco.Commerce.SalesTaxProviders.TaxJar
+ +## Upgrading + +{% hint style="warning" %} +Before upgrading, always backup your site and database. +{% endhint %} + +Umbraco Commerce uses Umbraco Migrations to install all of its features. To upgrade, install the latest version over the existing package. This process will add new features and update any missing components. diff --git a/commerce-add-ons/sales-tax-providers/taxjar/README.md b/commerce-add-ons/sales-tax-providers/taxjar/README.md new file mode 100644 index 00000000000..80b19233ced --- /dev/null +++ b/commerce-add-ons/sales-tax-providers/taxjar/README.md @@ -0,0 +1,24 @@ +--- +description: Getting Started with the TaxJar sales tax provider for Umbraco Commerce. +--- + +# Overview + +The TaxJar sales tax provider adds functionality to calculate sales tax via [TaxJar](https://www.taxjar.com/). It is a fully featured sales tax provider including realtime tax rate retrieval. + +## [Install TaxJar](../install-sales-tax-providers.md) + +## In this Section + +In this section, we will guide you through the key steps necessary to get you started with the TaxJar sales tax provider for Umbraco Commerce. + +It is assumed that before we begin you already have an Umbraco website configured and Umbraco Commerce installed. If you are not at this stage yet, please read the [core Umbraco Commerce documentation](https://docs.umbraco.com/umbraco-commerce/) to learn how to get started. + +## Useful links + +Below are a few useful links that might come in handy should you wish to learn more about the provider itself, and the TaxJar API. + +* [TaxJar Sales Tax provider source code](https://github.com/umbraco/Umbraco.Commerce.SalesTaxProviders.TaxJar) +* [TaxJar Sales Tax provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) +* [TaxJar information](https://taxjar.com/) +* [TaxJar API documentation](https://developers.taxjar.com/api/reference/) diff --git a/commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md b/commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md new file mode 100644 index 00000000000..0de9a1ff812 --- /dev/null +++ b/commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md @@ -0,0 +1,14 @@ +--- +title: Configuring TaxJar +description: >- + Learn how to configure TaxJar in order to implement the integration with + your Umbraco Commerce installation. +--- + +# Configure TaxJar + +## Step 1: Sign up & Sign in + +1. Head to the [TaxJar Sinup portal](https://app.taxjar.com/sign_up). +2. Enter your details to complete the signup process. +3. From the `TaxJar API` section of the admin portal locate your Sandbox and Live API keys. \ No newline at end of file diff --git a/commerce-add-ons/sales-tax-providers/taxjar/configuring-umbraco.md b/commerce-add-ons/sales-tax-providers/taxjar/configuring-umbraco.md new file mode 100644 index 00000000000..836344d80d8 --- /dev/null +++ b/commerce-add-ons/sales-tax-providers/taxjar/configuring-umbraco.md @@ -0,0 +1,31 @@ +--- +title: Configuring Umbraco +description: >- + Learn how to configure the Umbraco backoffice for enabling the use of + the TaxJar sale tax provider. +--- + +# Configure Umbraco + +This article will give you details about how to configure Umbraco to start using the TaxJar sale tax provider with your Umbraco Commerce implementation. + +## Step 1: Create a Sales Tax Calculation Method + +The following steps are all handled through the Umbraco backoffice. + +1. Navigate to **Settings > Commerce > Stores > {Store Name} > Taxes > Tax Calculation Methods** section. +2. Select the **Create Tax Calculation Method** button to create a new sale tax calculation method. +3. Choose **TaxJar** from the list of available sale tax providers. + +## Step 2: Configure Sales Tax Provider Settings + +The following steps are handled within the tax calculation method editor in the Umbraco backoffice. + +1. Configure the standard sale tax calculation method settings as required. +2. Configure the TaxJar sale tax provider settings as follows: + +| Name | Description | +| ---- | ----------- | +| Sandbox Token | The Sandbox API token from the TaxJar portal. | +| Live Token | The Live API token from the TaxJar portal. | +| Test Mode | Set whether to run in test mode. | diff --git a/commerce-add-ons/shipping-providers/dhl/README.md b/commerce-add-ons/shipping-providers/dhl/README.md index 3490414214c..bb559822a02 100644 --- a/commerce-add-ons/shipping-providers/dhl/README.md +++ b/commerce-add-ons/shipping-providers/dhl/README.md @@ -19,6 +19,6 @@ It is assumed that before we begin you already have an Umbraco website configure Below are a few useful links that might come in handy should you wish to learn more about the provider itself, and the DHL API. * [Shipping provider source code](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.Dhl) -* [Shipping provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.Dhl/issues) +* [Shipping provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [DHL Express information](https://mydhl.express.dhl/) * [DHL Express documentation](https://developer.dhl.com/api-reference/dhl-express-mydhl-api) diff --git a/commerce-add-ons/shipping-providers/dhl/release-notes.md b/commerce-add-ons/shipping-providers/dhl/release-notes.md index d876ff5ba08..464c2c44106 100644 --- a/commerce-add-ons/shipping-providers/dhl/release-notes.md +++ b/commerce-add-ons/shipping-providers/dhl/release-notes.md @@ -8,26 +8,18 @@ If there are any breaking changes or other issues to be aware of when upgrading In this section, you can find the release notes for each version of DHL Shipping Provider for Commerce. For each major version, you can find the details about each release. -
+### Version 14 and above -Version 14 +* For details of changes in v14 and above of the **DHL Shipping Provider for Umbraco Commerce**, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.Dhl/releases). -#### 14.0.0 (August 23rd 2024) +### Version 14.0.0 (August 23rd 2024) * Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. -
- -
- -Version 13 - -#### 13.0.0 (February 21st 2024) +### Version 13.0.0 (February 21st 2024) * Public release closing off the RC period. -#### 13.0.0-rc1 (February 6th 2024) +### Version 13.0.0-rc1 (February 6th 2024) * Initial release. - -
diff --git a/commerce-add-ons/shipping-providers/easypost/README.md b/commerce-add-ons/shipping-providers/easypost/README.md index 2b5908dc2be..53471138a14 100644 --- a/commerce-add-ons/shipping-providers/easypost/README.md +++ b/commerce-add-ons/shipping-providers/easypost/README.md @@ -19,6 +19,6 @@ It is assumed that before we begin you already have an Umbraco website configure Below are a few useful links that might come in handy should you wish to learn more about the provider itself, and the EasyPost API. * [Shipping provider source code](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.EasyPost) -* [Shipping provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.EasyPost/issues) +* [Shipping provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [EasyPost information](https://www.easypost.com/) * [EasyPost documentation](https://www.easypost.com/getting-started) diff --git a/commerce-add-ons/shipping-providers/easypost/release-notes.md b/commerce-add-ons/shipping-providers/easypost/release-notes.md index c9a5e572200..c3d023c096d 100644 --- a/commerce-add-ons/shipping-providers/easypost/release-notes.md +++ b/commerce-add-ons/shipping-providers/easypost/release-notes.md @@ -8,26 +8,18 @@ If there are any breaking changes or other issues to be aware of when upgrading In this section, you can find the release notes for each version of EasyPost Shipping Provider for Commerce. For each major version, you can find the details about each release. -
+### Version 14 and above -Version 14 +* For details of changes in v14 and above of the **EasyPost Shipping Provider for Umbraco Commerce**, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.EasyPost/releases). -#### 14.0.0 (August 23rd 2024) +### Version 14.0.0 (August 23rd 2024) * Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. -
- -
- -Version 13 - -#### 13.0.0 (February 21st 2024) +### Version 13.0.0 (February 21st 2024) * Public release closing off the RC period. -#### 13.0.0-rc1 (February 6th 2024) +### Version 13.0.0-rc1 (February 6th 2024) * Initial release. - -
diff --git a/commerce-add-ons/shipping-providers/shipmondo/README.md b/commerce-add-ons/shipping-providers/shipmondo/README.md index 0051e1d77d7..f4bd9208d04 100644 --- a/commerce-add-ons/shipping-providers/shipmondo/README.md +++ b/commerce-add-ons/shipping-providers/shipmondo/README.md @@ -19,6 +19,6 @@ It is assumed that before we begin you already have an Umbraco website configure Below are a few useful links that might come in handy should you wish to learn more about the provider itself, and the Shipmondo API. * [Shipping provider source code](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.Shipmondo) -* [Shipping provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.Shipmondo/issues) +* [Shipping provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.Issues/issues) * [Shipmondo information](https://www.shipmondo.com/) * [Shipmondo documentation](https://app.shipmondo.com/api/public/v3/specification/) diff --git a/commerce-add-ons/shipping-providers/shipmondo/release-notes.md b/commerce-add-ons/shipping-providers/shipmondo/release-notes.md index 5ca03123453..477f21b9e0b 100644 --- a/commerce-add-ons/shipping-providers/shipmondo/release-notes.md +++ b/commerce-add-ons/shipping-providers/shipmondo/release-notes.md @@ -8,26 +8,18 @@ If there are any breaking changes or other issues to be aware of when upgrading In this section, you can find the release notes for each version of Shipmondo Shipping Provider for Commerce. For each major version, you can find the details about each release. -
+### Version 14 and above -Version 14 +* For details of changes in v14 and above of the **Shipmondo Shipping Provider for Umbraco Commerce**, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.ShippingProviders.Shipmondo/releases). -#### 14.0.0 (August 23rd 2024) +### Version 14.0.0 (August 23rd 2024) * Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. -
- -
- -Version 13 - -#### 13.0.0 (February 21st 2024) +### Version 13.0.0 (February 21st 2024) * Public release closing off the RC period. -#### 13.0.0-rc1 (February 6th 2024) +### Version 13.0.0-rc1 (February 6th 2024) * Initial release. - -
From 0cfae85001bbf8290aeda73097680a66923e844a Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:45:46 +0200 Subject: [PATCH 02/12] Update 16/umbraco-commerce/release-notes/README.md --- 16/umbraco-commerce/release-notes/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/16/umbraco-commerce/release-notes/README.md b/16/umbraco-commerce/release-notes/README.md index e8f23eda04a..b39750fcf5d 100644 --- a/16/umbraco-commerce/release-notes/README.md +++ b/16/umbraco-commerce/release-notes/README.md @@ -24,7 +24,7 @@ This section contains the release notes for Umbraco Commerce 16 including all ch #### 16.0.0-rc1 (28th May 2025) -Initial release candidate for Umbraco v16. This release doesn't contain any new features rather it's just a v16 compatability release. +Initial release candidate for Umbraco v16. This release doesn't contain any new features; rather, it's a v16 compatibility release. * Updated to Umbraco CMS v16 * Upgraded all third party dependencies From 511fc760ac58c0452a778f140257f8334afacac7 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:45:53 +0200 Subject: [PATCH 03/12] Update 16/umbraco-commerce/release-notes/README.md --- 16/umbraco-commerce/release-notes/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/16/umbraco-commerce/release-notes/README.md b/16/umbraco-commerce/release-notes/README.md index b39750fcf5d..b5f3d0878a3 100644 --- a/16/umbraco-commerce/release-notes/README.md +++ b/16/umbraco-commerce/release-notes/README.md @@ -20,7 +20,7 @@ This section contains the release notes for Umbraco Commerce 16 including all ch #### 15.0.0 (12th Jun 2025) -* v16 final release +* Version 16 final release. #### 16.0.0-rc1 (28th May 2025) From dc377c148808a0f2a260149d9c8a6e03db5df745 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:45:59 +0200 Subject: [PATCH 04/12] Update 16/umbraco-commerce/release-notes/README.md --- 16/umbraco-commerce/release-notes/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/16/umbraco-commerce/release-notes/README.md b/16/umbraco-commerce/release-notes/README.md index b5f3d0878a3..6048d74bc07 100644 --- a/16/umbraco-commerce/release-notes/README.md +++ b/16/umbraco-commerce/release-notes/README.md @@ -26,6 +26,6 @@ This section contains the release notes for Umbraco Commerce 16 including all ch Initial release candidate for Umbraco v16. This release doesn't contain any new features; rather, it's a v16 compatibility release. -* Updated to Umbraco CMS v16 -* Upgraded all third party dependencies -* Removed all obsolete code flagged for removal in v16 +* Updated to Umbraco CMS v16. +* Upgraded all third-party dependencies. +* Removed all obsolete code flagged for removal in v16. From f660ee4dad2806c6b0871d0b8d5c7b18daa2cf7e Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:47:20 +0200 Subject: [PATCH 05/12] Update commerce-add-ons/packages/checkout/release-notes.md --- commerce-add-ons/packages/checkout/release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commerce-add-ons/packages/checkout/release-notes.md b/commerce-add-ons/packages/checkout/release-notes.md index 6a44c5a8357..6832e428be2 100644 --- a/commerce-add-ons/packages/checkout/release-notes.md +++ b/commerce-add-ons/packages/checkout/release-notes.md @@ -1,3 +1,3 @@ # Release Notes -For details of any changes to the **Umbraco Commerce Checkout** plugin, please refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.Checkout/releases). \ No newline at end of file +For details of any changes to the **Umbraco Commerce Checkout** plugin, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.Checkout/releases). \ No newline at end of file From 8cc273b2b61ddb7ec24ebb640684921ce2131748 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:47:27 +0200 Subject: [PATCH 06/12] Update commerce-add-ons/packages/deploy/release-notes.md --- commerce-add-ons/packages/deploy/release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commerce-add-ons/packages/deploy/release-notes.md b/commerce-add-ons/packages/deploy/release-notes.md index a96b4facd9c..249632fee77 100644 --- a/commerce-add-ons/packages/deploy/release-notes.md +++ b/commerce-add-ons/packages/deploy/release-notes.md @@ -1,3 +1,3 @@ # Release Notes -For details of any changes to the **Umbraco Commerce Deploy** plugin, please refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.Deploy/releases). \ No newline at end of file +For details of any changes to the **Umbraco Commerce Deploy** plugin, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.Deploy/releases). \ No newline at end of file From 08b4a48997ee12eef7b56451785c8f31fe22305e Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:47:34 +0200 Subject: [PATCH 07/12] Update commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md --- .../sales-tax-providers/install-sales-tax-providers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md b/commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md index 05990d04fc2..8da44cd8962 100644 --- a/commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md +++ b/commerce-add-ons/sales-tax-providers/install-sales-tax-providers.md @@ -24,7 +24,7 @@ Install-Package Umbraco.Commerce.SalesTaxProviders.PROVIDER ## Install via the NuGet Package Manager 1. Open the NuGet Package Manager. -2. Browse for the Sales Tax Provider you want to install. +2. Browse for the **Sales Tax Provider** you want to install. 3. Install the package into your solution. Alternatively, you can also find and install the NuGet package via the NuGet Package Manager. From efbf3356ca5c2b54887e74d6fbce2528fa76ae42 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:47:39 +0200 Subject: [PATCH 08/12] Update commerce-add-ons/sales-tax-providers/taxjar/README.md --- commerce-add-ons/sales-tax-providers/taxjar/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commerce-add-ons/sales-tax-providers/taxjar/README.md b/commerce-add-ons/sales-tax-providers/taxjar/README.md index 80b19233ced..af29e9ed41a 100644 --- a/commerce-add-ons/sales-tax-providers/taxjar/README.md +++ b/commerce-add-ons/sales-tax-providers/taxjar/README.md @@ -10,7 +10,7 @@ The TaxJar sales tax provider adds functionality to calculate sales tax via [Tax ## In this Section -In this section, we will guide you through the key steps necessary to get you started with the TaxJar sales tax provider for Umbraco Commerce. +This section guides you through the key steps necessary to get started with the TaxJar sales tax provider for Umbraco Commerce. It is assumed that before we begin you already have an Umbraco website configured and Umbraco Commerce installed. If you are not at this stage yet, please read the [core Umbraco Commerce documentation](https://docs.umbraco.com/umbraco-commerce/) to learn how to get started. From d76de7e14570ae2ac6f3175b95d431bf9d494923 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:47:45 +0200 Subject: [PATCH 09/12] Update commerce-add-ons/sales-tax-providers/taxjar/README.md --- commerce-add-ons/sales-tax-providers/taxjar/README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/commerce-add-ons/sales-tax-providers/taxjar/README.md b/commerce-add-ons/sales-tax-providers/taxjar/README.md index af29e9ed41a..44fee3e3df6 100644 --- a/commerce-add-ons/sales-tax-providers/taxjar/README.md +++ b/commerce-add-ons/sales-tax-providers/taxjar/README.md @@ -12,7 +12,8 @@ The TaxJar sales tax provider adds functionality to calculate sales tax via [Tax This section guides you through the key steps necessary to get started with the TaxJar sales tax provider for Umbraco Commerce. -It is assumed that before we begin you already have an Umbraco website configured and Umbraco Commerce installed. If you are not at this stage yet, please read the [core Umbraco Commerce documentation](https://docs.umbraco.com/umbraco-commerce/) to learn how to get started. +Before starting, ensure that you have an Umbraco website configured and Umbraco Commerce installed. If not, refer to the [core Umbraco Commerce documentation](https://docs.umbraco.com/umbraco-commerce/) to get started. + ## Useful links From 0947e081e7e9bc80867fd936eeada29e8659755b Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:47:54 +0200 Subject: [PATCH 10/12] Update commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md --- .../sales-tax-providers/taxjar/configuring-taxjar.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md b/commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md index 0de9a1ff812..8235a87a4ec 100644 --- a/commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md +++ b/commerce-add-ons/sales-tax-providers/taxjar/configuring-taxjar.md @@ -9,6 +9,6 @@ description: >- ## Step 1: Sign up & Sign in -1. Head to the [TaxJar Sinup portal](https://app.taxjar.com/sign_up). +1. Go to the [TaxJar Signup portal](https://app.taxjar.com/sign_up). 2. Enter your details to complete the signup process. 3. From the `TaxJar API` section of the admin portal locate your Sandbox and Live API keys. \ No newline at end of file From 87965d8f7677e6278f6423a29d2ff262412eb898 Mon Sep 17 00:00:00 2001 From: Matt Brailsford Date: Fri, 6 Jun 2025 08:53:32 +0100 Subject: [PATCH 11/12] Added links to SUMMARY.md files --- commerce-add-ons/packages/SUMMARY.md | 1 + commerce-add-ons/payment-providers/SUMMARY.md | 1 + .../sales-tax-providers/README.md | 20 +++++++++++++++++++ .../sales-tax-providers/SUMMARY.md | 18 +++++++++++++++++ .../shipping-providers/SUMMARY.md | 1 + 5 files changed, 41 insertions(+) create mode 100644 commerce-add-ons/sales-tax-providers/README.md create mode 100644 commerce-add-ons/sales-tax-providers/SUMMARY.md diff --git a/commerce-add-ons/packages/SUMMARY.md b/commerce-add-ons/packages/SUMMARY.md index 69b245251ea..9a935be8393 100644 --- a/commerce-add-ons/packages/SUMMARY.md +++ b/commerce-add-ons/packages/SUMMARY.md @@ -7,6 +7,7 @@ * [Umbraco Commerce](https://docs.umbraco.com/umbraco-commerce/) * [Commerce Payment Providers](https://docs.umbraco.com/umbraco-commerce-payment-providers) * [Commerce Shipping Providers](https://docs.umbraco.com/umbraco-commerce-shipping-providers) +* [Commerce Sales Tax Providers](https://docs.umbraco.com/umbraco-commerce-sales-tax-providers) ## Cart diff --git a/commerce-add-ons/payment-providers/SUMMARY.md b/commerce-add-ons/payment-providers/SUMMARY.md index 14420b0cdb9..e7ce6c63444 100644 --- a/commerce-add-ons/payment-providers/SUMMARY.md +++ b/commerce-add-ons/payment-providers/SUMMARY.md @@ -8,6 +8,7 @@ * [Umbraco Commerce](https://docs.umbraco.com/umbraco-commerce/) * [Commerce Packages](https://docs.umbraco.com/umbraco-commerce-packages) * [Commerce Shipping Providers](https://docs.umbraco.com/umbraco-commerce-shipping-providers) +* [Commerce Sales Tax Providers](https://docs.umbraco.com/umbraco-commerce-sales-tax-providers) ## Invoicing diff --git a/commerce-add-ons/sales-tax-providers/README.md b/commerce-add-ons/sales-tax-providers/README.md new file mode 100644 index 00000000000..808eab86600 --- /dev/null +++ b/commerce-add-ons/sales-tax-providers/README.md @@ -0,0 +1,20 @@ +--- +description: >- + Learn more about each of the available integrations for implementing sales tax providers into your Umbraco Commerce installation. +--- + +# What are Sales Tax Providers? + +Sales tax providers are essential for your Umbraco Commerce installation when you need to calculate the sales tax of an order dynamically, such as in the US. + +Sales tax providers are installed individually with the following HQ supported providers available. + +## Available integrations + + + +
TaxJartaxjar
+ +## Using These Docs + +**These docs are aimed at developers and users** who have at least a basic understanding of [Umbraco](https://umbraco.com), as well as Umbraco backoffice principles. diff --git a/commerce-add-ons/sales-tax-providers/SUMMARY.md b/commerce-add-ons/sales-tax-providers/SUMMARY.md new file mode 100644 index 00000000000..6ffcb18de94 --- /dev/null +++ b/commerce-add-ons/sales-tax-providers/SUMMARY.md @@ -0,0 +1,18 @@ +# Table of contents + +* [What are Sales Tax Providers?](README.md) +* [Install Sales Tax Provider](install-sales-tax-providers.md) + +## Commerce Products + +* [Umbraco Commerce](https://docs.umbraco.com/umbraco-commerce/) +* [Commerce Packages](https://docs.umbraco.com/umbraco-commerce-packages) +* [Commerce Payment Providers](https://docs.umbraco.com/umbraco-commerce-payment-providers) +* [Commerce Shipping Providers](https://docs.umbraco.com/umbraco-commerce-shiping-providers) + +## TaxJar + +* [Overview](taxjar/README.md) +* [Configure TaxJar](taxjar/configuring-taxjar.md) +* [Configure Umbraco](taxjar/configuring-umbraco.md) +* [Release Notes](taxjar/release-notes.md) diff --git a/commerce-add-ons/shipping-providers/SUMMARY.md b/commerce-add-ons/shipping-providers/SUMMARY.md index 93796b4bcac..a4c3659a730 100644 --- a/commerce-add-ons/shipping-providers/SUMMARY.md +++ b/commerce-add-ons/shipping-providers/SUMMARY.md @@ -8,6 +8,7 @@ * [Umbraco Commerce](https://docs.umbraco.com/umbraco-commerce/) * [Commerce Packages](https://docs.umbraco.com/umbraco-commerce-packages) * [Commerce Payment Providers](https://docs.umbraco.com/umbraco-commerce-payment-providers) +* [Commerce Sales Tax Providers](https://docs.umbraco.com/umbraco-commerce-sales-tax-providers) ## DHL From 937199aef4d334b964c29cae0305676347eac9e9 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Wed, 11 Jun 2025 09:37:36 +0200 Subject: [PATCH 12/12] Remove deleted articles from SUMMARY --- 16/umbraco-commerce/SUMMARY.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/16/umbraco-commerce/SUMMARY.md b/16/umbraco-commerce/SUMMARY.md index c24fc4b759d..6ebfa8beec6 100644 --- a/16/umbraco-commerce/SUMMARY.md +++ b/16/umbraco-commerce/SUMMARY.md @@ -2,8 +2,6 @@ * [Umbraco Commerce Documentation](README.md) * [Release Notes](release-notes/README.md) - * [v15.1.0-Rc](release-notes/v15.1.0-rc.md) - * [v15.0.0-Rc](release-notes/v15.0.0-rc.md) ## Commerce Products