docs: avalara integration tutorial (#13808)

* docs: avalara integration tutorial

* fix getTaxLines method

* fixes

* fix broken link

* fix build error

* fix vale errors

www/apps/resources/app/commerce-modules/tax/tax-provider/page.mdx

@@ -1,3 +1,5 @@
+import { CardList } from "docs-ui"
+
 export const metadata = {
   title: `Tax Module Provider`,
 }
@@ -20,9 +22,7 @@ The Medusa application uses the Tax Module Provider whenever it needs to calcula
 
 ![Diagram showcasing the communication between Medusa the Tax Module Provider, and the third-party tax provider.](https://res.cloudinary.com/dza7lstvk/image/upload/v1746790996/Medusa%20Resources/tax-provider-service_kcgpne.jpg)
 
----
-
-## Default Tax Provider
+### Default Tax Provider
 
 The Tax Module provides a `system` tax provider that acts as a placeholder tax provider. It performs basic tax calculation, as you can see in the [Create Tax Module Provider](/references/tax/provider#gettaxlines) guide.
 
@@ -34,6 +34,22 @@ The identifier of the system tax provider is `tp_system`.
 
 </Note>
 
+### Other Tax Providers
+
+<CardList
+  items={[
+    {
+      href: "/integrations/guides/avalara",
+      title: "Avalara",
+      badge: {
+        variant: "blue",
+        children: "Tutorial"
+      }
+    }
+  ]}
+  className="mb-1"
+/>
+
 ---
 
 ## How to Create a Custom Tax Provider?

www/apps/resources/app/integrations/page.mdx

@@ -301,3 +301,23 @@ Integrate a search engine to index and search products or other types of data in
   ]}
   className="mb-1"
 />
+
+---
+
+## Tax
+
+Integrate a third-party tax calculation service to handle tax rates and rules in your Medusa application.
+
+<CardList
+  items={[
+    {
+      href: "/integrations/guides/avalara",
+      title: "Avalara",
+      badge: {
+        variant: "blue",
+        children: "Tutorial"
+      }
+    }
+  ]}
+  className="mb-1"
+/>

www/apps/resources/generated/edit-dates.mjs

@@ -103,7 +103,7 @@ export const generatedEditDates = {
   "app/deployment/admin/vercel/page.mdx": "2024-10-16T08:10:29.377Z",
   "app/deployment/storefront/vercel/page.mdx": "2025-05-20T07:51:40.712Z",
   "app/deployment/page.mdx": "2025-09-29T10:23:47.833Z",
-  "app/integrations/page.mdx": "2025-09-17T08:08:37.954Z",
+  "app/integrations/page.mdx": "2025-10-22T07:14:23.467Z",
   "app/medusa-cli/page.mdx": "2024-08-28T11:25:32.382Z",
   "app/medusa-container-resources/page.mdx": "2025-07-31T13:24:15.786Z",
   "app/medusa-workflows-reference/page.mdx": "2025-01-20T08:21:29.962Z",
@@ -6476,7 +6476,7 @@ export const generatedEditDates = {
   "references/types/interfaces/types.IPaymentProvider/page.mdx": "2025-10-21T08:10:48.134Z",
   "references/types/interfaces/types.WebhookActionResult/page.mdx": "2025-05-20T07:51:41.086Z",
   "references/types/interfaces/types.WebhookActionData/page.mdx": "2025-05-20T07:51:41.086Z",
-  "app/commerce-modules/tax/tax-provider/page.mdx": "2025-05-20T07:51:40.711Z",
+  "app/commerce-modules/tax/tax-provider/page.mdx": "2025-10-22T07:14:23.461Z",
   "app/recipes/bundled-products/examples/standard/page.mdx": "2025-06-26T11:52:18.819Z",
   "app/recipes/bundled-products/page.mdx": "2025-05-20T07:51:40.718Z",
   "app/infrastructure-modules/analytics/local/page.mdx": "2025-08-21T05:30:26.867Z",
@@ -6683,5 +6683,6 @@ export const generatedEditDates = {
   "references/types/types/types.ListShippingOptionsForCartWorkflowInput/page.mdx": "2025-10-21T08:10:45.503Z",
   "references/utils/Fulfillment/variables/utils.Fulfillment.ShippingOptionTypeWorkflowEvents/page.mdx": "2025-10-21T08:10:52.748Z",
   "references/utils/PromotionUtils/enums/utils.PromotionUtils.ApplicationMethodAllocation/page.mdx": "2025-10-21T08:10:52.665Z",
-  "references/utils/PromotionUtils/enums/utils.PromotionUtils.CampaignBudgetType/page.mdx": "2025-10-21T08:10:52.672Z"
+  "references/utils/PromotionUtils/enums/utils.PromotionUtils.CampaignBudgetType/page.mdx": "2025-10-21T08:10:52.672Z",
+  "app/integrations/guides/avalara/page.mdx": "2025-10-22T09:56:11.929Z"
 }

www/apps/resources/generated/files-map.mjs

@@ -935,6 +935,10 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/integrations/guides/algolia/page.mdx",
     "pathname": "/integrations/guides/algolia"
   },
+  {
+    "filePath": "/www/apps/resources/app/integrations/guides/avalara/page.mdx",
+    "pathname": "/integrations/guides/avalara"
+  },
   {
     "filePath": "/www/apps/resources/app/integrations/guides/contentful/page.mdx",
     "pathname": "/integrations/guides/contentful"

www/apps/resources/generated/generated-integrations-sidebar.mjs

@@ -271,6 +271,23 @@ const generatedgeneratedIntegrationsSidebarSidebar = {
           "children": []
         }
       ]
+    },
+    {
+      "loaded": true,
+      "isPathHref": true,
+      "type": "category",
+      "title": "Tax",
+      "initialOpen": true,
+      "children": [
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "link",
+          "path": "/integrations/guides/avalara",
+          "title": "Avalara",
+          "children": []
+        }
+      ]
     }
   ]
 }

www/apps/resources/sidebars/integrations.mjs

@@ -185,4 +185,16 @@ export const integrationsSidebar = [
       },
     ],
   },
+  {
+    type: "category",
+    title: "Tax",
+    initialOpen: true,
+    children: [
+      {
+        type: "link",
+        path: "/integrations/guides/avalara",
+        title: "Avalara",
+      },
+    ],
+  },
 ]