From b0d8017e5307dd1cb7f590050053cca0cdb01369 Mon Sep 17 00:00:00 2001 From: Yaacov Tarko <98383332+yaacov-commenda@users.noreply.github.com> Date: Wed, 5 Nov 2025 13:16:48 +0530 Subject: [PATCH 01/45] fix logos --- logo/dark.svg | 32 +++++++++++--------------------- logo/light.svg | 32 +++++++++++--------------------- 2 files changed, 22 insertions(+), 42 deletions(-) diff --git a/logo/dark.svg b/logo/dark.svg index 8b343cd6f..5b3a0ae37 100644 --- a/logo/dark.svg +++ b/logo/dark.svg @@ -1,21 +1,11 @@ - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + \ No newline at end of file diff --git a/logo/light.svg b/logo/light.svg index 03e62bf1d..4b0ed95be 100644 --- a/logo/light.svg +++ b/logo/light.svg @@ -1,21 +1,11 @@ - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + \ No newline at end of file From e6649350e117ec1da7592a19e88143bc61edaa40 Mon Sep 17 00:00:00 2001 From: Yaacov Tarko <98383332+yaacov-commenda@users.noreply.github.com> Date: Wed, 5 Nov 2025 13:21:25 +0530 Subject: [PATCH 02/45] fix favicon --- docs.json | 22 +++++++++++----------- favicon-32x32.png | Bin 0 -> 421 bytes favicon.svg | 19 ------------------- 3 files changed, 11 insertions(+), 30 deletions(-) create mode 100644 favicon-32x32.png delete mode 100644 favicon.svg diff --git a/docs.json b/docs.json index 46b44cc4a..c776c7aee 100644 --- a/docs.json +++ b/docs.json @@ -7,7 +7,7 @@ "light": "#07C983", "dark": "#15803D" }, - "favicon": "/favicon.svg", + "favicon": "/favicon-32x32.png", "navigation": { "tabs": [ { @@ -102,15 +102,15 @@ }, "contextual": { "options": [ - "copy", - "view", - "chatgpt", - "claude", - "perplexity", - "mcp", - "cursor", - "vscode" - ] + "copy", + "view", + "chatgpt", + "claude", + "perplexity", + "mcp", + "cursor", + "vscode" + ] }, "footer": { "socials": { @@ -119,4 +119,4 @@ "linkedin": "https://linkedin.com/company/mintlify" } } -} +} \ No newline at end of file diff --git a/favicon-32x32.png b/favicon-32x32.png new file mode 100644 index 0000000000000000000000000000000000000000..e3dd4b355bba319f1babcb10f8e6d135c35ca911 GIT binary patch literal 421 zcmV;W0b2fvP)Px$Ur9tkR9Hvt*3U{KK@i9Bk0A?@J$aCQ25-Jb4xYR(?8%ES;ydgs=uJ<8pkBrO zhkp=vS3RhgsF?8uZ+yddT*;BM9xMHd zPYR&ZBY0t4q=H`+weo~&$nzxk|C5~garB&s%EArK!%x}@-#EZNwy+$2_`X>%lbY}5 zXo;Zdw19<_)6@V3B-V&`yoz6_M*-L6!$~-f - - - - - - - - - - - - - - - - - - From 378fe18627d070076157d528db3293871f2bebbd Mon Sep 17 00:00:00 2001 From: Yaacov Tarko <98383332+yaacov-commenda@users.noreply.github.com> Date: Wed, 5 Nov 2025 13:27:31 +0530 Subject: [PATCH 03/45] fix name --- docs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.json b/docs.json index c776c7aee..1c692edc0 100644 --- a/docs.json +++ b/docs.json @@ -1,7 +1,7 @@ { "$schema": "https://mintlify.com/docs.json", "theme": "mint", - "name": "Mint Starter Kit", + "name": "Commenda Sales Tax", "colors": { "primary": "#16A34A", "light": "#07C983", From 35fb689dd2f285ccffe57569cb96358e4d319b10 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 20 Nov 2025 06:16:25 +0000 Subject: [PATCH 04/45] Update api-reference/exclude-jurisdiction-logic.mdx --- api-reference/exclude-jurisdiction-logic.mdx | 164 +++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 api-reference/exclude-jurisdiction-logic.mdx diff --git a/api-reference/exclude-jurisdiction-logic.mdx b/api-reference/exclude-jurisdiction-logic.mdx new file mode 100644 index 000000000..b774aa97a --- /dev/null +++ b/api-reference/exclude-jurisdiction-logic.mdx @@ -0,0 +1,164 @@ +--- +title: 'Exclude jurisdiction logic' +description: 'How the calculation endpoint handles jurisdiction exclusion for tax calculations' +--- + +## Overview + +The exclude jurisdiction logic allows you to configure tax rates that selectively exclude certain jurisdiction types from tax calculations. This is useful for scenarios where specific jurisdiction types should not be taxed based on the tax rate configuration. + +## How it works + +When a tax rate is configured with excluded jurisdiction types, the calculation engine filters out those jurisdiction types before applying the tax rate. This ensures that tax is only calculated for the appropriate jurisdictions. + +### Database schema + +The `jurisdiction_rates` table includes an `exclude_jurisdiction_types` column: + +```sql +ALTER TABLE "jurisdiction_rates" +ADD COLUMN "exclude_jurisdiction_types" text[] NULL; +``` + +This column stores an array of jurisdiction type strings that should be excluded when applying this tax rate. + +## Jurisdiction types + +The following jurisdiction types can be excluded: + +- `STATE_OR_PROVINCE` - State or province level jurisdictions +- `COUNTY` - County level jurisdictions +- `CITY` - City level jurisdictions +- `DISTRICT` - Special district jurisdictions +- `LOCAL` - Local jurisdictions + +## Configuration + +### Setting excluded jurisdictions + +When ingesting tax rates via CSV, you can specify excluded jurisdiction types in the `exclude jurisdictions` column: + +```csv +commenda id,rate,tax type,exclude jurisdictions +STATE_CA_1001,8.5%,SALES_TAX,"CITY,DISTRICT" +``` + +The system will: +1. Split the comma-separated values +2. Trim whitespace from each type +3. Sort them lexicographically +4. Validate each type against the allowed jurisdiction types +5. Store them in the database + +### Validation + +The system validates that all excluded jurisdiction types are valid. If an invalid type is provided, the ingestion will fail with an error: + +``` +invalid jurisdiction type passed. Passed jurisdiction type (INVALID_TYPE) +``` + +## Calculation behavior + +During tax calculation, the exclude jurisdiction logic works as follows: + +1. **Jurisdiction resolution**: The system resolves all applicable jurisdictions for the transaction address +2. **Rate retrieval**: Tax rates are fetched for the resolved jurisdictions +3. **Filtering**: For each rate with `exclude_jurisdiction_types` configured, the system filters out jurisdictions matching those types +4. **Tax calculation**: Tax is calculated only on the remaining (non-excluded) jurisdictions + +### Example scenario + +Consider a transaction in California with the following resolved jurisdictions: +- `STATE_CA_1001` (State) +- `CO_CEN_06_037` (County - Los Angeles) +- `CI_CEN_06_037_44000` (City - Los Angeles) + +If a tax rate is configured with: +- `commenda_jurisdiction_id`: `STATE_CA_1001` +- `rate`: 7.25% +- `exclude_jurisdiction_types`: `["CITY", "DISTRICT"]` + +The calculation will: +1. Apply the 7.25% rate to state and county jurisdictions +2. Exclude city and district jurisdictions from this rate +3. Allow other rates (if configured) to apply to the excluded jurisdiction types + +## Use cases + +### State-level exemptions + +Exclude local jurisdictions when applying state-level tax rates: + +```csv +STATE_TX_1001,6.25%,SALES_TAX,"CITY,COUNTY,DISTRICT" +``` + +### County-level restrictions + +Exclude city jurisdictions when applying county rates: + +```csv +CO_CEN_48_201,1.0%,SALES_TAX,"CITY" +``` + +### Special district handling + +Exclude specific jurisdiction types for special tax districts: + +```csv +DIST_CA_1001_001,0.5%,SALES_TAX,"CITY,COUNTY" +``` + +## API integration + +The exclude jurisdiction logic is automatically applied during tax calculations through the calculation endpoint. No additional API parameters are required - the logic is driven entirely by the tax rate configuration in the database. + +### Calculation endpoint + +When you call the calculation endpoint: + +```bash +POST /api/v1/calculate +``` + +The system automatically: +1. Resolves jurisdictions for the provided address +2. Retrieves applicable tax rates +3. Applies exclude jurisdiction filtering +4. Returns the calculated tax amounts + +## Best practices + +1. **Be specific**: Only exclude jurisdiction types that should genuinely not be taxed by this rate +2. **Avoid conflicts**: Ensure excluded jurisdictions have alternative rates configured if they should be taxed +3. **Test thoroughly**: Verify calculations with various address combinations to ensure correct behavior +4. **Document exceptions**: Keep records of why specific jurisdiction types are excluded for audit purposes + +## Technical implementation + +The exclude jurisdiction logic is implemented in the content ingestion service: + +```go +// From jurisdiction_rates.go +excludedJurisdictionTypes := getHeaderValue(row, headerMap, "exclude jurisdictions") + +if excludedJurisdictionTypes != "" { + // Split by comma, trim spaces, sort lexicographically + types := strings.Split(excludedJurisdictionTypes, ",") + for i, t := range types { + types[i] = strings.TrimSpace(t) + } + sort.Strings(types) + excludedJurisdictionTypes = strings.Join(types, ",") +} + +// Validate each jurisdiction type +for _, eachJurisdictionType := range strings.Split(excludedJurisdictionTypes, ",") { + if !isValidJurisdictionType(eachJurisdictionType) { + return error + } +} +``` + +The filtered jurisdiction types are stored in the database and automatically applied during tax calculations. From 48b9061106fe195be46e9f70183fe353cb0dff94 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 20 Nov 2025 06:16:42 +0000 Subject: [PATCH 05/45] Update docs.json --- docs.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs.json b/docs.json index 1c692edc0..fa035b822 100644 --- a/docs.json +++ b/docs.json @@ -53,7 +53,8 @@ { "group": "API documentation", "pages": [ - "api-reference/introduction" + "api-reference/introduction", + "api-reference/exclude-jurisdiction-logic" ] }, { From b9eede13787b1b2ee5e94908474fafbe23d4370e Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 20 Nov 2025 05:52:08 -0800 Subject: [PATCH 06/45] Documentation edits made through Mintlify web editor --- docs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.json b/docs.json index fa035b822..fcc1dfa12 100644 --- a/docs.json +++ b/docs.json @@ -1,6 +1,6 @@ { "$schema": "https://mintlify.com/docs.json", - "theme": "mint", + "theme": "linden", "name": "Commenda Sales Tax", "colors": { "primary": "#16A34A", From 769cddfa35603aceee14c64598c9490aa66ff2d5 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 20 Nov 2025 05:54:55 -0800 Subject: [PATCH 07/45] Documentation edits made through Mintlify web editor --- docs.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs.json b/docs.json index fcc1dfa12..c8f5d7f9b 100644 --- a/docs.json +++ b/docs.json @@ -3,9 +3,9 @@ "theme": "linden", "name": "Commenda Sales Tax", "colors": { - "primary": "#16A34A", - "light": "#07C983", - "dark": "#15803D" + "primary": "#026EB9", + "light": "#026EB9", + "dark": "#98C1D7" }, "favicon": "/favicon-32x32.png", "navigation": { From 808c381ada20d46984dcc636e88c7a9dc427e3b5 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 20 Nov 2025 06:06:37 -0800 Subject: [PATCH 08/45] Documentation edits made through Mintlify web editor --- docs.json | 12 ++++++------ favicon-32x32.png | Bin 421 -> 1252 bytes logo/FullLogoLockupBlack.svg | 9 +++++++++ logo/FullLogoLockupWhite.svg | 9 +++++++++ logo/dark.svg | 11 ----------- logo/light.svg | 11 ----------- 6 files changed, 24 insertions(+), 28 deletions(-) create mode 100644 logo/FullLogoLockupBlack.svg create mode 100644 logo/FullLogoLockupWhite.svg delete mode 100644 logo/dark.svg delete mode 100644 logo/light.svg diff --git a/docs.json b/docs.json index c8f5d7f9b..33c86365d 100644 --- a/docs.json +++ b/docs.json @@ -1,17 +1,17 @@ { "$schema": "https://mintlify.com/docs.json", "theme": "linden", - "name": "Commenda Sales Tax", + "name": "Commenda Platform Documentation", "colors": { "primary": "#026EB9", - "light": "#026EB9", + "light": "#D6E2E9", "dark": "#98C1D7" }, "favicon": "/favicon-32x32.png", "navigation": { "tabs": [ { - "tab": "Guides", + "tab": "Integration Guides", "groups": [ { "group": "Getting started", @@ -48,7 +48,7 @@ ] }, { - "tab": "API reference", + "tab": "Compliance Engine", "groups": [ { "group": "API documentation", @@ -85,8 +85,8 @@ } }, "logo": { - "light": "/logo/light.svg", - "dark": "/logo/dark.svg" + "light": "/logo/FullLogoLockupBlack.svg", + "dark": "/logo/FullLogoLockupWhite.svg" }, "navbar": { "links": [ diff --git a/favicon-32x32.png b/favicon-32x32.png index e3dd4b355bba319f1babcb10f8e6d135c35ca911..1b1d1795f27aedf70fe166f4e086feca96a58ead 100644 GIT binary patch delta 1233 zcmV;?1TOof1LO&iBYy;$Nklu|8Pbp8K7 z^?8pi>*_hB!F43xd%knNzvp>>zoV2&r5%(2MWrlen5*9lW5Hj4(`1B~T*nAG3KJ9Z!P()+Nz20;2Wt$s|5J8^zU3Q5ReWn?fL& zQ}Gdj5B?H^*QUT`HW5pNT}@k10%G#%L;-t#2;-B{IJT~E;n#2u9ZoY$`uJEd0!5;q zxtzhP-vn_YkblO&?M}2(`^i`y?RImG-gBP|LLggEafBMbH59_1(L7dot=O^3gRdr1 zn)%yEWDauv+y5pIN)@s9WCRC(iXxI#;k26Y!a6TzIDRga<+lQltqB%j-NwjF7O#C9 z)Y2@+T$fnePR-YK+41G?Nu&!U5-`C{QuFnm`??_u4+0|rXtx-{7|+P=8ev_5Xg-rFU?`A6GG9Ww!;BX=)4zOmbZ-TfW7YpD$Z zM*T3eK!3=}xm_e6y^%CTKumsYJb~9wgz&-7QM~j0RaQ3@8~qMEx3&#VYTe_pK%pP< zD)3033lH?zA(r>kJx1U%eq92wY*8zxdrw7hC0PXH3MVh6@%DEiOi^1iQHd*OY0}r; zf=zxq!s#O9@TGK-Hev9PHM&z`^6^LxZw`g=F@Mc25iJWP(!1RjJh;pO7d4l$YEhXD zqpW^Gl66@X-8I$g4G9cSr5NQQoSx2rL9gu*@HIXgcHZNGkdQQ#OGlgJLr5!(xF_%S zV9!7Y`jn^aiX$17?=igc zbr8FbUcnc?B{YJS{d&Ej3!L=dGxxS)iCurmhHe{rS@Vad(iprD$7dH44AKGtO~}w^ z6Z{dGj284T=Z)!~US6`A{(fww8;YqsP=D?m784%rb8A`f{+U@MXqFJ8{+RaXQ(nYw z39n&xbz5Bm0=#XN8+S6bs!x$rlN;{zk;En+j-Z7dBFPRG00v1!K~w_(CxI4D=8RMx00000NkvXXu0mjf4(>+( delta 396 zcmV;70dxN338e#&BYyw^b5ch_0Itp)=>Px$Ur9tkR9Hvt*3U{KK@i9Bk0A?@J$aCQ z25-Jb4xYR(?8%ES;ydgs=uJ<8pkBrOhkp=vS3RhgsFd>7M^5Zy2o~El zW-%@Ys`&WCd>gA+!*6`UcU;MlvmPt`icbol(<69cT%>|u6}9q&YRK~>_y3ce`Em4| zh|0nZ&cjdI3g0-uKDMwNe)zswFq4|^=4gqa>9l}_l+)Az1tivpcf5*Us7C?U<-u?Xmq*stTA3|;Kh6<->0m8-dw?}y$sDPn<4vz%Q@=j(d zN~Yo!2xu!=K+9Vf(2T~nN)T{3$la*)a|o?i+&h#iprr%>8__svE(#a0g1a!@RDys; q)Fb>*5}$*RQ6*CA=kSgfa1X>&w;;M91}6Xj002ovP6b4+LSTaJPP@qf diff --git a/logo/FullLogoLockupBlack.svg b/logo/FullLogoLockupBlack.svg new file mode 100644 index 000000000..f61386801 --- /dev/null +++ b/logo/FullLogoLockupBlack.svg @@ -0,0 +1,9 @@ + + + + + + + + + diff --git a/logo/FullLogoLockupWhite.svg b/logo/FullLogoLockupWhite.svg new file mode 100644 index 000000000..39cac24f2 --- /dev/null +++ b/logo/FullLogoLockupWhite.svg @@ -0,0 +1,9 @@ + + + + + + + + + diff --git a/logo/dark.svg b/logo/dark.svg deleted file mode 100644 index 5b3a0ae37..000000000 --- a/logo/dark.svg +++ /dev/null @@ -1,11 +0,0 @@ - - - - - - - - - - - \ No newline at end of file diff --git a/logo/light.svg b/logo/light.svg deleted file mode 100644 index 4b0ed95be..000000000 --- a/logo/light.svg +++ /dev/null @@ -1,11 +0,0 @@ - - - - - - - - - - - \ No newline at end of file From d8b0d127e2136786dc343e3182c6b8a8ac044541 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 20 Nov 2025 06:09:36 -0800 Subject: [PATCH 09/45] Documentation edits made through Mintlify web editor --- docs.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs.json b/docs.json index 33c86365d..67d8c0254 100644 --- a/docs.json +++ b/docs.json @@ -4,8 +4,8 @@ "name": "Commenda Platform Documentation", "colors": { "primary": "#026EB9", - "light": "#D6E2E9", - "dark": "#98C1D7" + "light": "#98C1D7", + "dark": "#D6E2E9" }, "favicon": "/favicon-32x32.png", "navigation": { From 4676d954a472e47ecd56933d1308b852dfaf01c2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 24 Nov 2025 18:22:03 +0000 Subject: [PATCH 10/45] Documentation edits made through Mintlify web editor --- docs.json | 2 +- logo/FullLogoLockupBlack.svg | 10 +++++----- logo/FullLogoLockupWhite.svg | 10 +++++----- 3 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs.json b/docs.json index 67d8c0254..c094121ef 100644 --- a/docs.json +++ b/docs.json @@ -4,7 +4,7 @@ "name": "Commenda Platform Documentation", "colors": { "primary": "#026EB9", - "light": "#98C1D7", + "light": "#F8F6F1", "dark": "#D6E2E9" }, "favicon": "/favicon-32x32.png", diff --git a/logo/FullLogoLockupBlack.svg b/logo/FullLogoLockupBlack.svg index f61386801..1b3479175 100644 --- a/logo/FullLogoLockupBlack.svg +++ b/logo/FullLogoLockupBlack.svg @@ -1,9 +1,9 @@ - - + + - - + + - + diff --git a/logo/FullLogoLockupWhite.svg b/logo/FullLogoLockupWhite.svg index 39cac24f2..2214250b2 100644 --- a/logo/FullLogoLockupWhite.svg +++ b/logo/FullLogoLockupWhite.svg @@ -1,9 +1,9 @@ - - + + - - + + - + From aad43454c3b87fac2b8f82c32a8a62f68602a6f5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 24 Nov 2025 18:24:53 +0000 Subject: [PATCH 11/45] Documentation edits made through Mintlify web editor --- docs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.json b/docs.json index c094121ef..a41c73642 100644 --- a/docs.json +++ b/docs.json @@ -5,7 +5,7 @@ "colors": { "primary": "#026EB9", "light": "#F8F6F1", - "dark": "#D6E2E9" + "dark": "#F8F6F1" }, "favicon": "/favicon-32x32.png", "navigation": { From c962d023dc9b36c1f4fcffba4ea8f68e1f396f71 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 11:40:45 +0000 Subject: [PATCH 12/45] Documentation edits made through Mintlify web editor --- aryans-folder.mdx/the-one.mdx | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 aryans-folder.mdx/the-one.mdx diff --git a/aryans-folder.mdx/the-one.mdx b/aryans-folder.mdx/the-one.mdx new file mode 100644 index 000000000..e49711334 --- /dev/null +++ b/aryans-folder.mdx/the-one.mdx @@ -0,0 +1,6 @@ +--- +title: "New file" +description: "Description of your new file." +--- + +Hi \ No newline at end of file From 140eaf5a3b51aed50821699e1d74d953e4028579 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 11:46:54 +0000 Subject: [PATCH 13/45] Documentation edits made through Mintlify web editor --- docs.json | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs.json b/docs.json index a41c73642..09f07d761 100644 --- a/docs.json +++ b/docs.json @@ -13,6 +13,12 @@ { "tab": "Integration Guides", "groups": [ + { + "group": "Aryan's Group", + "pages": [ + "aryans-folder/the-one" + ] + }, { "group": "Getting started", "pages": [ From f72cef5f0bad6a15eb26f37ba397a44910b25ced Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 12:06:55 +0000 Subject: [PATCH 14/45] Documentation edits made through Mintlify web editor --- docs.json | 6 +- integrations/woocommerce.mdx | 432 +++++++++++++++++++++++++++++++++++ 2 files changed, 435 insertions(+), 3 deletions(-) create mode 100644 integrations/woocommerce.mdx diff --git a/docs.json b/docs.json index 09f07d761..9dd70c7fb 100644 --- a/docs.json +++ b/docs.json @@ -11,12 +11,12 @@ "navigation": { "tabs": [ { - "tab": "Integration Guides", + "tab": "Guides", "groups": [ { - "group": "Aryan's Group", + "group": "Integrations", "pages": [ - "aryans-folder/the-one" + "integrations/woocommerce" ] }, { diff --git a/integrations/woocommerce.mdx b/integrations/woocommerce.mdx new file mode 100644 index 000000000..59eb379af --- /dev/null +++ b/integrations/woocommerce.mdx @@ -0,0 +1,432 @@ +--- +title: "WooCommerce integration" +description: "Learn how Rootfi integrates with WooCommerce to fetch e-commerce data" +--- + +## Overview + +Rootfi's WooCommerce integration enables you to seamlessly fetch and synchronize e-commerce data from WooCommerce stores. This integration provides access to orders, products, customers, inventory, and other critical business data. + +## How it works + +The WooCommerce integration connects to your WooCommerce store using the WooCommerce REST API. Once authenticated, Rootfi can fetch data from your store and keep it synchronized in real-time through webhooks. + +### Architecture + +1. **Authentication**: Secure connection using WooCommerce API keys +2. **Data fetching**: Periodic synchronization of store data via REST API +3. **Real-time updates**: Webhook notifications for immediate data changes +4. **Data normalization**: Standardized data format across all integrations + +## Authentication + +### Prerequisites + +- WooCommerce store with REST API enabled +- Admin access to generate API credentials +- HTTPS enabled on your store (required for API access) + +### Connection process + +1. Navigate to your WooCommerce admin dashboard +2. Go to **WooCommerce** \> **Settings** \> **Advanced** \> **REST API** +3. Click **Add key** to generate new API credentials +4. Set the following: + - **Description**: Rootfi Integration + - **User**: Select an admin user + - **Permissions**: Read/Write +5. Copy the generated **Consumer Key** and **Consumer Secret** +6. In Rootfi, provide: + - Store URL + - Consumer Key + - Consumer Secret +7. Test the connection to verify access + +### Security considerations + +- API keys should be stored securely and never exposed in client-side code +- Use HTTPS for all API communications +- Regularly rotate API credentials +- Monitor API access logs for suspicious activity + +## Data entities + +Rootfi fetches the following data entities from WooCommerce: + +### Orders + +Complete order information including line items, customer details, and fulfillment status. + +**Key fields:** + +- `id` - Unique order identifier +- `order_number` - Human-readable order number +- `status` - Order status (pending, processing, completed, etc.) +- `date_created` - Order creation timestamp +- `date_modified` - Last modification timestamp +- `total` - Order total amount +- `subtotal` - Subtotal before taxes and shipping +- `total_tax` - Total tax amount +- `shipping_total` - Shipping cost +- `discount_total` - Total discount amount +- `currency` - Order currency code +- `customer_id` - Associated customer ID +- `billing` - Billing address object +- `shipping` - Shipping address object +- `payment_method` - Payment method used +- `payment_method_title` - Payment method display name +- `line_items` - Array of ordered products +- `shipping_lines` - Shipping method details +- `tax_lines` - Tax breakdown +- `fee_lines` - Additional fees +- `coupon_lines` - Applied coupons +- `refunds` - Refund information + +### Products + +Product catalog including variations, pricing, and inventory. + +**Key fields:** + +- `id` - Unique product identifier +- `name` - Product name +- `slug` - URL-friendly product identifier +- `type` - Product type (simple, variable, grouped, external) +- `status` - Publication status (publish, draft, pending) +- `sku` - Stock keeping unit +- `price` - Current price +- `regular_price` - Regular price before discounts +- `sale_price` - Sale price if on sale +- `date_on_sale_from` - Sale start date +- `date_on_sale_to` - Sale end date +- `stock_quantity` - Available stock count +- `stock_status` - Stock status (instock, outofstock, onbackorder) +- `manage_stock` - Whether stock is managed +- `categories` - Product categories +- `tags` - Product tags +- `images` - Product images array +- `attributes` - Product attributes +- `variations` - Product variations (for variable products) +- `weight` - Product weight +- `dimensions` - Product dimensions (length, width, height) +- `description` - Full product description +- `short_description` - Short product description + +### Customers + +Customer profiles and contact information. + +**Key fields:** + +- `id` - Unique customer identifier +- `email` - Customer email address +- `first_name` - Customer first name +- `last_name` - Customer last name +- `username` - Customer username +- `date_created` - Account creation date +- `date_modified` - Last modification date +- `billing` - Billing address object + - `first_name` + - `last_name` + - `company` + - `address_1` + - `address_2` + - `city` + - `state` + - `postcode` + - `country` + - `email` + - `phone` +- `shipping` - Shipping address object + - `first_name` + - `last_name` + - `company` + - `address_1` + - `address_2` + - `city` + - `state` + - `postcode` + - `country` +- `orders_count` - Total number of orders +- `total_spent` - Total amount spent +- `avatar_url` - Customer avatar URL + +### Inventory + +Stock levels and inventory management data. + +**Key fields:** + +- `product_id` - Associated product ID +- `variation_id` - Variation ID (if applicable) +- `sku` - Stock keeping unit +- `stock_quantity` - Current stock level +- `stock_status` - Stock availability status +- `manage_stock` - Whether stock management is enabled +- `backorders` - Backorder settings (no, notify, yes) +- `low_stock_amount` - Low stock threshold + +### Categories + +Product categorization and taxonomy. + +**Key fields:** + +- `id` - Unique category identifier +- `name` - Category name +- `slug` - URL-friendly identifier +- `parent` - Parent category ID +- `description` - Category description +- `display` - Display type +- `image` - Category image +- `count` - Number of products in category + +### Coupons + +Discount codes and promotional offers. + +**Key fields:** + +- `id` - Unique coupon identifier +- `code` - Coupon code +- `amount` - Discount amount +- `discount_type` - Type of discount (percent, fixed_cart, fixed_product) +- `description` - Coupon description +- `date_expires` - Expiration date +- `usage_count` - Number of times used +- `usage_limit` - Maximum usage limit +- `usage_limit_per_user` - Per-user usage limit +- `individual_use` - Whether coupon can be used with other coupons +- `product_ids` - Applicable product IDs +- `excluded_product_ids` - Excluded product IDs +- `minimum_amount` - Minimum order amount +- `maximum_amount` - Maximum order amount + +### Refunds + +Order refund information. + +**Key fields:** + +- `id` - Unique refund identifier +- `order_id` - Associated order ID +- `date_created` - Refund creation date +- `amount` - Refund amount +- `reason` - Refund reason +- `refunded_by` - User who processed refund +- `line_items` - Refunded line items + +### Tax rates + +Tax configuration and rates. + +**Key fields:** + +- `id` - Unique tax rate identifier +- `country` - Country code +- `state` - State code +- `postcode` - Postal code +- `city` - City name +- `rate` - Tax rate percentage +- `name` - Tax rate name +- `priority` - Tax priority +- `compound` - Whether tax is compound +- `shipping` - Whether tax applies to shipping +- `class` - Tax class + +## API endpoints + +Rootfi uses the following WooCommerce REST API endpoints: + +### Orders + +- `GET /wp-json/wc/v3/orders` - List all orders +- `GET /wp-json/wc/v3/orders/{id}` - Get single order +- `POST /wp-json/wc/v3/orders` - Create order +- `PUT /wp-json/wc/v3/orders/{id}` - Update order + +### Products + +- `GET /wp-json/wc/v3/products` - List all products +- `GET /wp-json/wc/v3/products/{id}` - Get single product +- `POST /wp-json/wc/v3/products` - Create product +- `PUT /wp-json/wc/v3/products/{id}` - Update product + +### Customers + +- `GET /wp-json/wc/v3/customers` - List all customers +- `GET /wp-json/wc/v3/customers/{id}` - Get single customer +- `POST /wp-json/wc/v3/customers` - Create customer +- `PUT /wp-json/wc/v3/customers/{id}` - Update customer + +### Product variations + +- `GET /wp-json/wc/v3/products/{product_id}/variations` - List variations +- `GET /wp-json/wc/v3/products/{product_id}/variations/{id}` - Get variation + +### Categories + +- `GET /wp-json/wc/v3/products/categories` - List categories +- `GET /wp-json/wc/v3/products/categories/{id}` - Get category + +### Coupons + +- `GET /wp-json/wc/v3/coupons` - List coupons +- `GET /wp-json/wc/v3/coupons/{id}` - Get coupon + +### Refunds + +- `GET /wp-json/wc/v3/orders/{order_id}/refunds` - List refunds +- `GET /wp-json/wc/v3/orders/{order_id}/refunds/{id}` - Get refund + +### Tax rates + +- `GET /wp-json/wc/v3/taxes` - List tax rates +- `GET /wp-json/wc/v3/taxes/{id}` - Get tax rate + +## Webhooks + +Rootfi configures webhooks to receive real-time updates from WooCommerce. + +### Supported webhook events + +**Orders:** + +- `order.created` - New order created +- `order.updated` - Order updated +- `order.deleted` - Order deleted + +**Products:** + +- `product.created` - New product created +- `product.updated` - Product updated +- `product.deleted` - Product deleted + +**Customers:** + +- `customer.created` - New customer registered +- `customer.updated` - Customer profile updated +- `customer.deleted` - Customer deleted + +**Inventory:** + +- `product.updated` - Stock level changed (via product update) + +### Webhook configuration + +Webhooks are automatically configured during the integration setup: + +1. Rootfi creates webhook subscriptions via the WooCommerce API +2. Webhook endpoint: `https://api.rootfi.com/webhooks/woocommerce/{integration_id}` +3. Webhook secret is generated for signature verification +4. Events are delivered in real-time as they occur + +### Webhook payload + +Each webhook includes: + +- `event` - Event type +- `created_at` - Event timestamp +- `resource` - Resource type (order, product, customer) +- `data` - Complete resource data + +### Webhook security + +- All webhooks are signed with HMAC-SHA256 +- Signatures are verified before processing +- Invalid signatures are rejected +- Webhook endpoints use HTTPS only + +## Data synchronization + +### Initial sync + +When you first connect a WooCommerce store: + +1. Rootfi fetches all historical data +2. Data is processed in batches to avoid rate limits +3. Sync progress is tracked and resumable +4. Typical sync time: 5-30 minutes depending on store size + +### Incremental sync + +After initial sync: + +1. Webhooks provide real-time updates +2. Periodic polling ensures data consistency +3. Modified records are detected and updated +4. Deleted records are marked as inactive + +### Rate limits + +WooCommerce API rate limits: + +- Default: 25 requests per 10 seconds +- Configurable per store +- Rootfi automatically handles rate limiting with exponential backoff + +## Troubleshooting + +### Common issues + +**Authentication failed:** + +- Verify API credentials are correct +- Ensure REST API is enabled in WooCommerce settings +- Check that HTTPS is enabled on your store +- Confirm the API user has admin permissions + +**Missing data:** + +- Check that the API user has appropriate permissions +- Verify the data exists in WooCommerce +- Review API rate limits and sync status +- Check webhook delivery logs + +**Webhook not receiving updates:** + +- Verify webhook is active in WooCommerce settings +- Check webhook delivery logs in WooCommerce +- Ensure firewall allows outbound connections +- Verify webhook URL is accessible + +**Sync performance issues:** + +- Large product catalogs may take longer to sync +- Consider increasing API rate limits +- Check for API errors in logs +- Monitor server resources + +### Support + +For additional help: + +- Check Rootfi integration logs +- Review WooCommerce system status +- Contact Rootfi support with integration ID +- Provide relevant error messages and timestamps + +## Best practices + +1. **Regular monitoring**: Check sync status and webhook delivery regularly +2. **API key rotation**: Rotate API credentials periodically for security +3. **Test environment**: Test integration changes in staging before production +4. **Data validation**: Verify critical data after initial sync +5. **Error handling**: Monitor error logs and set up alerts for failures +6. **Performance optimization**: Use webhooks for real-time updates instead of frequent polling +7. **Backup**: Maintain regular backups of your WooCommerce data + +## Limitations + +- Historical data retention depends on WooCommerce configuration +- Some custom fields may require additional mapping +- Third-party plugin data may not be included by default +- API rate limits may affect sync speed for large stores +- Webhook delivery is not guaranteed (use polling as backup) + +## Next steps + +- [Configure data mappings](#) +- [Set up automated workflows](#) +- [Monitor integration health](#) +- [Explore analytics and reporting](#) \ No newline at end of file From 0e723d99dcd98b067481862e5006c11ec0021e07 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 12:07:18 +0000 Subject: [PATCH 15/45] Documentation edits made through Mintlify web editor --- aryans-folder.mdx/the-one.mdx | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 aryans-folder.mdx/the-one.mdx diff --git a/aryans-folder.mdx/the-one.mdx b/aryans-folder.mdx/the-one.mdx deleted file mode 100644 index e49711334..000000000 --- a/aryans-folder.mdx/the-one.mdx +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: "New file" -description: "Description of your new file." ---- - -Hi \ No newline at end of file From a01d487d201833c91674f19d7d8be627ebedc956 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 12:09:56 +0000 Subject: [PATCH 16/45] Documentation edits made through Mintlify web editor --- docs.json | 2 +- integrations/{woocommerce.mdx => woocommerce/setup.mdx} | 0 2 files changed, 1 insertion(+), 1 deletion(-) rename integrations/{woocommerce.mdx => woocommerce/setup.mdx} (100%) diff --git a/docs.json b/docs.json index 9dd70c7fb..8abe1b17a 100644 --- a/docs.json +++ b/docs.json @@ -16,7 +16,7 @@ { "group": "Integrations", "pages": [ - "integrations/woocommerce" + "integrations/woocommerce/setup" ] }, { diff --git a/integrations/woocommerce.mdx b/integrations/woocommerce/setup.mdx similarity index 100% rename from integrations/woocommerce.mdx rename to integrations/woocommerce/setup.mdx From 315d1ee38513811b50f7cb88be9c5bc0210ce671 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 12:13:33 +0000 Subject: [PATCH 17/45] Documentation edits made through Mintlify web editor --- docs.json | 1 + integrations/Overview.mdx | 4 ++++ 2 files changed, 5 insertions(+) create mode 100644 integrations/Overview.mdx diff --git a/docs.json b/docs.json index 8abe1b17a..0c6968881 100644 --- a/docs.json +++ b/docs.json @@ -16,6 +16,7 @@ { "group": "Integrations", "pages": [ + "integrations/overview", "integrations/woocommerce/setup" ] }, diff --git a/integrations/Overview.mdx b/integrations/Overview.mdx new file mode 100644 index 000000000..41a155d9f --- /dev/null +++ b/integrations/Overview.mdx @@ -0,0 +1,4 @@ + + This is how you use a card with an icon and a link. Clicking on this card + brings you to the Columns page. + \ No newline at end of file From b7898c60fe59b206541952596afaebf8ec82b644 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 12:16:37 +0000 Subject: [PATCH 18/45] Documentation edits made through Mintlify web editor --- integrations/overview.mdx | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 integrations/overview.mdx diff --git a/integrations/overview.mdx b/integrations/overview.mdx new file mode 100644 index 000000000..80d8b1d5f --- /dev/null +++ b/integrations/overview.mdx @@ -0,0 +1,5 @@ +--- +title: 'New file' +description: 'Description of your new file.' +--- + From 06330ca53d2c27403f165e8a9428a0b64a73303a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 12:16:53 +0000 Subject: [PATCH 19/45] Documentation edits made through Mintlify web editor --- integrations/Overview.mdx | 4 ---- 1 file changed, 4 deletions(-) delete mode 100644 integrations/Overview.mdx diff --git a/integrations/Overview.mdx b/integrations/Overview.mdx deleted file mode 100644 index 41a155d9f..000000000 --- a/integrations/Overview.mdx +++ /dev/null @@ -1,4 +0,0 @@ - - This is how you use a card with an icon and a link. Clicking on this card - brings you to the Columns page. - \ No newline at end of file From 30a78d6661961cbeab65b13cd256dde5cb41dcfa Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 12:20:16 +0000 Subject: [PATCH 20/45] Documentation edits made through Mintlify web editor --- docs.json | 3 ++- integrations/settings.mdx | 9 +++++++++ 2 files changed, 11 insertions(+), 1 deletion(-) create mode 100644 integrations/settings.mdx diff --git a/docs.json b/docs.json index 0c6968881..4f6e7affd 100644 --- a/docs.json +++ b/docs.json @@ -17,7 +17,8 @@ "group": "Integrations", "pages": [ "integrations/overview", - "integrations/woocommerce/setup" + "integrations/woocommerce/setup", + "integrations/settings" ] }, { diff --git a/integrations/settings.mdx b/integrations/settings.mdx new file mode 100644 index 000000000..055ecac39 --- /dev/null +++ b/integrations/settings.mdx @@ -0,0 +1,9 @@ +--- +title: 'New file' +description: 'Description of your new file.' +--- + + + This is how you use a card with an icon and a link. Clicking on this card + brings you to the Columns page. + From ae65c33ad75fafa37d9c3d59a910c2e104181003 Mon Sep 17 00:00:00 2001 From: Sam Suechting Date: Thu, 11 Dec 2025 13:32:16 +0530 Subject: [PATCH 21/45] Restructure docs: new Engine/Integrations/Rootfi tabs with integration pages --- ai-tools/claude-code.mdx | 76 ----- ai-tools/cursor.mdx | 420 --------------------------- ai-tools/windsurf.mdx | 96 ------ development.mdx | 94 ------ docs.json | 116 ++++---- engine/commendaos/overview.mdx | 10 + engine/form-builder/overview.mdx | 10 + engine/indirect-tax/overview.mdx | 10 + engine/workflow-builder/overview.mdx | 14 + essentials/code.mdx | 35 --- essentials/images.mdx | 59 ---- essentials/markdown.mdx | 88 ------ essentials/navigation.mdx | 87 ------ essentials/reusable-snippets.mdx | 110 ------- essentials/settings.mdx | 318 -------------------- index.mdx | 97 ------- integrations/netsuite/overview.mdx | 9 + integrations/overview.mdx | 5 - integrations/quickbooks/overview.mdx | 9 + integrations/settings.mdx | 9 - integrations/shopify/overview.mdx | 10 + integrations/stripe/overview.mdx | 10 + integrations/woocommerce/setup.mdx | 1 + integrations/xero/overview.mdx | 9 + integrations/zoho/overview.mdx | 9 + quickstart.mdx | 80 ----- 26 files changed, 167 insertions(+), 1624 deletions(-) delete mode 100644 ai-tools/claude-code.mdx delete mode 100644 ai-tools/cursor.mdx delete mode 100644 ai-tools/windsurf.mdx delete mode 100644 development.mdx create mode 100644 engine/commendaos/overview.mdx create mode 100644 engine/form-builder/overview.mdx create mode 100644 engine/indirect-tax/overview.mdx create mode 100644 engine/workflow-builder/overview.mdx delete mode 100644 essentials/code.mdx delete mode 100644 essentials/images.mdx delete mode 100644 essentials/markdown.mdx delete mode 100644 essentials/navigation.mdx delete mode 100644 essentials/reusable-snippets.mdx delete mode 100644 essentials/settings.mdx delete mode 100644 index.mdx create mode 100644 integrations/netsuite/overview.mdx delete mode 100644 integrations/overview.mdx create mode 100644 integrations/quickbooks/overview.mdx delete mode 100644 integrations/settings.mdx create mode 100644 integrations/shopify/overview.mdx create mode 100644 integrations/stripe/overview.mdx create mode 100644 integrations/xero/overview.mdx create mode 100644 integrations/zoho/overview.mdx delete mode 100644 quickstart.mdx diff --git a/ai-tools/claude-code.mdx b/ai-tools/claude-code.mdx deleted file mode 100644 index bdc4e04b5..000000000 --- a/ai-tools/claude-code.mdx +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: "Claude Code setup" -description: "Configure Claude Code for your documentation workflow" -icon: "asterisk" ---- - -Claude Code is Anthropic's official CLI tool. This guide will help you set up Claude Code to help you write and maintain your documentation. - -## Prerequisites - -- Active Claude subscription (Pro, Max, or API access) - -## Setup - -1. Install Claude Code globally: - - ```bash - npm install -g @anthropic-ai/claude-code -``` - -2. Navigate to your docs directory. -3. (Optional) Add the `CLAUDE.md` file below to your project. -4. Run `claude` to start. - -## Create `CLAUDE.md` - -Create a `CLAUDE.md` file at the root of your documentation repository to train Claude Code on your specific documentation standards: - -````markdown -# Mintlify documentation - -## Working relationship -- You can push back on ideas-this can lead to better documentation. Cite sources and explain your reasoning when you do so -- ALWAYS ask for clarification rather than making assumptions -- NEVER lie, guess, or make up information - -## Project context -- Format: MDX files with YAML frontmatter -- Config: docs.json for navigation, theme, settings -- Components: Mintlify components - -## Content strategy -- Document just enough for user success - not too much, not too little -- Prioritize accuracy and usability of information -- Make content evergreen when possible -- Search for existing information before adding new content. Avoid duplication unless it is done for a strategic reason -- Check existing patterns for consistency -- Start by making the smallest reasonable changes - -## Frontmatter requirements for pages -- title: Clear, descriptive page title -- description: Concise summary for SEO/navigation - -## Writing standards -- Second-person voice ("you") -- Prerequisites at start of procedural content -- Test all code examples before publishing -- Match style and formatting of existing pages -- Include both basic and advanced use cases -- Language tags on all code blocks -- Alt text on all images -- Relative paths for internal links - -## Git workflow -- NEVER use --no-verify when committing -- Ask how to handle uncommitted changes before starting -- Create a new branch when no clear branch exists for changes -- Commit frequently throughout development -- NEVER skip or disable pre-commit hooks - -## Do not -- Skip frontmatter on any MDX file -- Use absolute URLs for internal links -- Include untested code examples -- Make assumptions - always ask for clarification -```` diff --git a/ai-tools/cursor.mdx b/ai-tools/cursor.mdx deleted file mode 100644 index fbb77616e..000000000 --- a/ai-tools/cursor.mdx +++ /dev/null @@ -1,420 +0,0 @@ ---- -title: "Cursor setup" -description: "Configure Cursor for your documentation workflow" -icon: "arrow-pointer" ---- - -Use Cursor to help write and maintain your documentation. This guide shows how to configure Cursor for better results on technical writing tasks and using Mintlify components. - -## Prerequisites - -- Cursor editor installed -- Access to your documentation repository - -## Project rules - -Create project rules that all team members can use. In your documentation repository root: - -```bash -mkdir -p .cursor -``` - -Create `.cursor/rules.md`: - -````markdown -# Mintlify technical writing rule - -You are an AI writing assistant specialized in creating exceptional technical documentation using Mintlify components and following industry-leading technical writing practices. - -## Core writing principles - -### Language and style requirements - -- Use clear, direct language appropriate for technical audiences -- Write in second person ("you") for instructions and procedures -- Use active voice over passive voice -- Employ present tense for current states, future tense for outcomes -- Avoid jargon unless necessary and define terms when first used -- Maintain consistent terminology throughout all documentation -- Keep sentences concise while providing necessary context -- Use parallel structure in lists, headings, and procedures - -### Content organization standards - -- Lead with the most important information (inverted pyramid structure) -- Use progressive disclosure: basic concepts before advanced ones -- Break complex procedures into numbered steps -- Include prerequisites and context before instructions -- Provide expected outcomes for each major step -- Use descriptive, keyword-rich headings for navigation and SEO -- Group related information logically with clear section breaks - -### User-centered approach - -- Focus on user goals and outcomes rather than system features -- Anticipate common questions and address them proactively -- Include troubleshooting for likely failure points -- Write for scannability with clear headings, lists, and white space -- Include verification steps to confirm success - -## Mintlify component reference - -### Callout components - -#### Note - Additional helpful information - - -Supplementary information that supports the main content without interrupting flow - - -#### Tip - Best practices and pro tips - - -Expert advice, shortcuts, or best practices that enhance user success - - -#### Warning - Important cautions - - -Critical information about potential issues, breaking changes, or destructive actions - - -#### Info - Neutral contextual information - - -Background information, context, or neutral announcements - - -#### Check - Success confirmations - - -Positive confirmations, successful completions, or achievement indicators - - -### Code components - -#### Single code block - -Example of a single code block: - -```javascript config.js -const apiConfig = { - baseURL: 'https://api.example.com', - timeout: 5000, - headers: { - 'Authorization': `Bearer ${process.env.API_TOKEN}` - } -}; -``` - -#### Code group with multiple languages - -Example of a code group: - - -```javascript Node.js -const response = await fetch('/api/endpoint', { - headers: { Authorization: `Bearer ${apiKey}` } -}); -``` - -```python Python -import requests -response = requests.get('/api/endpoint', - headers={'Authorization': f'Bearer {api_key}'}) -``` - -```curl cURL -curl -X GET '/api/endpoint' \ - -H 'Authorization: Bearer YOUR_API_KEY' -``` - - -#### Request/response examples - -Example of request/response documentation: - - -```bash cURL -curl -X POST 'https://api.example.com/users' \ - -H 'Content-Type: application/json' \ - -d '{"name": "John Doe", "email": "john@example.com"}' -``` - - - -```json Success -{ - "id": "user_123", - "name": "John Doe", - "email": "john@example.com", - "created_at": "2024-01-15T10:30:00Z" -} -``` - - -### Structural components - -#### Steps for procedures - -Example of step-by-step instructions: - - - - Run `npm install` to install required packages. - - - Verify installation by running `npm list`. - - - - - Create a `.env` file with your API credentials. - - ```bash - API_KEY=your_api_key_here - ``` - - - Never commit API keys to version control. - - - - -#### Tabs for alternative content - -Example of tabbed content: - - - - ```bash - brew install node - npm install -g package-name - ``` - - - - ```powershell - choco install nodejs - npm install -g package-name - ``` - - - - ```bash - sudo apt install nodejs npm - npm install -g package-name - ``` - - - -#### Accordions for collapsible content - -Example of accordion groups: - - - - - **Firewall blocking**: Ensure ports 80 and 443 are open - - **Proxy configuration**: Set HTTP_PROXY environment variable - - **DNS resolution**: Try using 8.8.8.8 as DNS server - - - - ```javascript - const config = { - performance: { cache: true, timeout: 30000 }, - security: { encryption: 'AES-256' } - }; - ``` - - - -### Cards and columns for emphasizing information - -Example of cards and card groups: - - -Complete walkthrough from installation to your first API call in under 10 minutes. - - - - - Learn how to authenticate requests using API keys or JWT tokens. - - - - Understand rate limits and best practices for high-volume usage. - - - -### API documentation components - -#### Parameter fields - -Example of parameter documentation: - - -Unique identifier for the user. Must be a valid UUID v4 format. - - - -User's email address. Must be valid and unique within the system. - - - -Maximum number of results to return. Range: 1-100. - - - -Bearer token for API authentication. Format: `Bearer YOUR_API_KEY` - - -#### Response fields - -Example of response field documentation: - - -Unique identifier assigned to the newly created user. - - - -ISO 8601 formatted timestamp of when the user was created. - - - -List of permission strings assigned to this user. - - -#### Expandable nested fields - -Example of nested field documentation: - - -Complete user object with all associated data. - - - - User profile information including personal details. - - - - User's first name as entered during registration. - - - - URL to user's profile picture. Returns null if no avatar is set. - - - - - - -### Media and advanced components - -#### Frames for images - -Wrap all images in frames: - -Main dashboard showing analytics overview - - - -Analytics dashboard with charts - - -#### Videos - -Use the HTML video element for self-hosted video content: - - - -Embed YouTube videos using iframe elements: - - - -#### Tooltips - -Example of tooltip usage: - - -API - - -#### Updates - -Use updates for changelogs: - - -## New features -- Added bulk user import functionality -- Improved error messages with actionable suggestions - -## Bug fixes -- Fixed pagination issue with large datasets -- Resolved authentication timeout problems - - -## Required page structure - -Every documentation page must begin with YAML frontmatter: - -```yaml ---- -title: "Clear, specific, keyword-rich title" -description: "Concise description explaining page purpose and value" ---- -``` - -## Content quality standards - -### Code examples requirements - -- Always include complete, runnable examples that users can copy and execute -- Show proper error handling and edge case management -- Use realistic data instead of placeholder values -- Include expected outputs and results for verification -- Test all code examples thoroughly before publishing -- Specify language and include filename when relevant -- Add explanatory comments for complex logic -- Never include real API keys or secrets in code examples - -### API documentation requirements - -- Document all parameters including optional ones with clear descriptions -- Show both success and error response examples with realistic data -- Include rate limiting information with specific limits -- Provide authentication examples showing proper format -- Explain all HTTP status codes and error handling -- Cover complete request/response cycles - -### Accessibility requirements - -- Include descriptive alt text for all images and diagrams -- Use specific, actionable link text instead of "click here" -- Ensure proper heading hierarchy starting with H2 -- Provide keyboard navigation considerations -- Use sufficient color contrast in examples and visuals -- Structure content for easy scanning with headers and lists - -## Component selection logic - -- Use **Steps** for procedures and sequential instructions -- Use **Tabs** for platform-specific content or alternative approaches -- Use **CodeGroup** when showing the same concept in multiple programming languages -- Use **Accordions** for progressive disclosure of information -- Use **RequestExample/ResponseExample** specifically for API endpoint documentation -- Use **ParamField** for API parameters, **ResponseField** for API responses -- Use **Expandable** for nested object properties or hierarchical information -```` diff --git a/ai-tools/windsurf.mdx b/ai-tools/windsurf.mdx deleted file mode 100644 index fce12bfd1..000000000 --- a/ai-tools/windsurf.mdx +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: "Windsurf setup" -description: "Configure Windsurf for your documentation workflow" -icon: "water" ---- - -Configure Windsurf's Cascade AI assistant to help you write and maintain documentation. This guide shows how to set up Windsurf specifically for your Mintlify documentation workflow. - -## Prerequisites - -- Windsurf editor installed -- Access to your documentation repository - -## Workspace rules - -Create workspace rules that provide Windsurf with context about your documentation project and standards. - -Create `.windsurf/rules.md` in your project root: - -````markdown -# Mintlify technical writing rule - -## Project context - -- This is a documentation project on the Mintlify platform -- We use MDX files with YAML frontmatter -- Navigation is configured in `docs.json` -- We follow technical writing best practices - -## Writing standards - -- Use second person ("you") for instructions -- Write in active voice and present tense -- Start procedures with prerequisites -- Include expected outcomes for major steps -- Use descriptive, keyword-rich headings -- Keep sentences concise but informative - -## Required page structure - -Every page must start with frontmatter: - -```yaml ---- -title: "Clear, specific title" -description: "Concise description for SEO and navigation" ---- -``` - -## Mintlify components - -### Callouts - -- `` for helpful supplementary information -- `` for important cautions and breaking changes -- `` for best practices and expert advice -- `` for neutral contextual information -- `` for success confirmations - -### Code examples - -- When appropriate, include complete, runnable examples -- Use `` for multiple language examples -- Specify language tags on all code blocks -- Include realistic data, not placeholders -- Use `` and `` for API docs - -### Procedures - -- Use `` component for sequential instructions -- Include verification steps with `` components when relevant -- Break complex procedures into smaller steps - -### Content organization - -- Use `` for platform-specific content -- Use `` for progressive disclosure -- Use `` and `` for highlighting content -- Wrap images in `` components with descriptive alt text - -## API documentation requirements - -- Document all parameters with `` -- Show response structure with `` -- Include both success and error examples -- Use `` for nested object properties -- Always include authentication examples - -## Quality standards - -- Test all code examples before publishing -- Use relative paths for internal links -- Include alt text for all images -- Ensure proper heading hierarchy (start with h2) -- Check existing patterns for consistency -```` diff --git a/development.mdx b/development.mdx deleted file mode 100644 index ac633bad1..000000000 --- a/development.mdx +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: 'Development' -description: 'Preview changes locally to update your docs' ---- - - - **Prerequisites**: - - Node.js version 19 or higher - - A docs repository with a `docs.json` file - - -Follow these steps to install and run Mintlify on your operating system. - - - - -```bash -npm i -g mint -``` - - - - -Navigate to your docs directory where your `docs.json` file is located, and run the following command: - -```bash -mint dev -``` - -A local preview of your documentation will be available at `http://localhost:3000`. - - - - -## Custom ports - -By default, Mintlify uses port 3000. You can customize the port Mintlify runs on by using the `--port` flag. For example, to run Mintlify on port 3333, use this command: - -```bash -mint dev --port 3333 -``` - -If you attempt to run Mintlify on a port that's already in use, it will use the next available port: - -```md -Port 3000 is already in use. Trying 3001 instead. -``` - -## Mintlify versions - -Please note that each CLI release is associated with a specific version of Mintlify. If your local preview does not align with the production version, please update the CLI: - -```bash -npm mint update -``` - -## Validating links - -The CLI can assist with validating links in your documentation. To identify any broken links, use the following command: - -```bash -mint broken-links -``` - -## Deployment - -If the deployment is successful, you should see the following: - - - Screenshot of a deployment confirmation message that says All checks have passed. - - -## Code formatting - -We suggest using extensions on your IDE to recognize and format MDX. If you're a VSCode user, consider the [MDX VSCode extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) for syntax highlighting, and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) for code formatting. - -## Troubleshooting - - - - - This may be due to an outdated version of node. Try the following: - 1. Remove the currently-installed version of the CLI: `npm remove -g mint` - 2. Upgrade to Node v19 or higher. - 3. Reinstall the CLI: `npm i -g mint` - - - - - Solution: Go to the root of your device and delete the `~/.mintlify` folder. Then run `mint dev` again. - - - -Curious about what changed in the latest CLI version? Check out the [CLI changelog](https://www.npmjs.com/package/mintlify?activeTab=versions). diff --git a/docs.json b/docs.json index 4f6e7affd..60e556664 100644 --- a/docs.json +++ b/docs.json @@ -11,83 +11,107 @@ "navigation": { "tabs": [ { - "tab": "Guides", + "tab": "Engine", "groups": [ { - "group": "Integrations", + "group": "CommendaOS", "pages": [ - "integrations/overview", - "integrations/woocommerce/setup", - "integrations/settings" + "engine/commendaos/overview" ] }, { - "group": "Getting started", + "group": "Indirect Tax", "pages": [ - "index", - "quickstart", - "development" + "engine/indirect-tax/overview" ] }, { - "group": "Customization", + "group": "Workflow Builder", "pages": [ - "essentials/settings", - "essentials/navigation" + "engine/workflow-builder/overview" ] }, { - "group": "Writing content", + "group": "Form Builder", "pages": [ - "essentials/markdown", - "essentials/code", - "essentials/images", - "essentials/reusable-snippets" - ] - }, - { - "group": "AI tools", - "pages": [ - "ai-tools/cursor", - "ai-tools/claude-code", - "ai-tools/windsurf" + "engine/form-builder/overview" ] } ] }, { - "tab": "Compliance Engine", + "tab": "Integrations", "groups": [ { - "group": "API documentation", + "group": "Stripe", + "pages": [ + "integrations/stripe/overview" + ] + }, + { + "group": "Shopify", + "pages": [ + "integrations/shopify/overview" + ] + }, + { + "group": "Xero", + "pages": [ + "integrations/xero/overview" + ] + }, + { + "group": "Zoho", + "pages": [ + "integrations/zoho/overview" + ] + }, + { + "group": "WooCommerce", "pages": [ - "api-reference/introduction", - "api-reference/exclude-jurisdiction-logic" + "integrations/woocommerce/setup" ] }, { - "group": "Endpoint examples", + "group": "QuickBooks", "pages": [ - "api-reference/endpoint/get", - "api-reference/endpoint/create", - "api-reference/endpoint/delete", - "api-reference/endpoint/webhook" + "integrations/quickbooks/overview" + ] + }, + { + "group": "NetSuite", + "pages": [ + "integrations/netsuite/overview" ] } ] + }, + { + "tab": "Rootfi", + "groups": [] } ], "global": { "anchors": [ { - "anchor": "Documentation", - "href": "https://mintlify.com/docs", + "anchor": "Commenda Public Docs", + "href": "https://sales-tax-docs.commenda.io/introduction", "icon": "book-open-cover" }, { - "anchor": "Blog", - "href": "https://mintlify.com/blog", - "icon": "newspaper" + "anchor": "Rootfi Public Docs", + "href": "https://rootfi-commenda.mintlify.app/documentation/general/introduction", + "icon": "book-open-cover" + }, + { + "anchor": "Better Stack", + "href": "https://telemetry.betterstack.com/team/t461894/sources", + "icon": "triangle-exclamation" + }, + { + "anchor": "Baserow", + "href": "https://baserow.io/login", + "icon": "table" } ] } @@ -97,16 +121,10 @@ "dark": "/logo/FullLogoLockupWhite.svg" }, "navbar": { - "links": [ - { - "label": "Support", - "href": "mailto:hi@mintlify.com" - } - ], "primary": { "type": "button", - "label": "Dashboard", - "href": "https://dashboard.mintlify.com" + "label": "Report a bug", + "href": "https://linear.app/commenda/team/ONC/new?template=a04ed671-96f2-4df0-882c-62e7ccf8a27c" } }, "contextual": { @@ -123,9 +141,7 @@ }, "footer": { "socials": { - "x": "https://x.com/mintlify", - "github": "https://github.com/mintlify", - "linkedin": "https://linkedin.com/company/mintlify" + "github": "https://github.com/commenda-eng" } } } \ No newline at end of file diff --git a/engine/commendaos/overview.mdx b/engine/commendaos/overview.mdx new file mode 100644 index 000000000..4f19bbf70 --- /dev/null +++ b/engine/commendaos/overview.mdx @@ -0,0 +1,10 @@ +--- +title: 'CommendaOS' +description: 'Overview of CommendaOS' +icon: 'microchip' +--- + +## Overview + +CommendaOS documentation coming soon. + diff --git a/engine/form-builder/overview.mdx b/engine/form-builder/overview.mdx new file mode 100644 index 000000000..3fb5fd37b --- /dev/null +++ b/engine/form-builder/overview.mdx @@ -0,0 +1,10 @@ +--- +title: 'Form Builder' +description: 'Create and manage custom forms' +icon: 'file-lines' +--- + +## Overview + +Form Builder documentation coming soon. + diff --git a/engine/indirect-tax/overview.mdx b/engine/indirect-tax/overview.mdx new file mode 100644 index 000000000..930dcf3a7 --- /dev/null +++ b/engine/indirect-tax/overview.mdx @@ -0,0 +1,10 @@ +--- +title: 'Indirect Tax' +description: 'Overview of Indirect Tax' +icon: 'receipt' +--- + +## Overview + +Indirect Tax documentation coming soon. + diff --git a/engine/workflow-builder/overview.mdx b/engine/workflow-builder/overview.mdx new file mode 100644 index 000000000..2275e2113 --- /dev/null +++ b/engine/workflow-builder/overview.mdx @@ -0,0 +1,14 @@ +--- +title: 'Workflow Builder' +description: 'Create and manage automated workflows' +icon: 'diagram-project' +--- + +## Overview + +The Workflow Builder allows you to create automated workflows to streamline your sales tax compliance processes. + +## Getting Started + +Get started by creating your first workflow in the dashboard. + diff --git a/essentials/code.mdx b/essentials/code.mdx deleted file mode 100644 index ae2abbfec..000000000 --- a/essentials/code.mdx +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: 'Code blocks' -description: 'Display inline code and code blocks' -icon: 'code' ---- - -## Inline code - -To denote a `word` or `phrase` as code, enclose it in backticks (`). - -``` -To denote a `word` or `phrase` as code, enclose it in backticks (`). -``` - -## Code blocks - -Use [fenced code blocks](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) by enclosing code in three backticks and follow the leading ticks with the programming language of your snippet to get syntax highlighting. Optionally, you can also write the name of your code after the programming language. - -```java HelloWorld.java -class HelloWorld { - public static void main(String[] args) { - System.out.println("Hello, World!"); - } -} -``` - -````md -```java HelloWorld.java -class HelloWorld { - public static void main(String[] args) { - System.out.println("Hello, World!"); - } -} -``` -```` diff --git a/essentials/images.mdx b/essentials/images.mdx deleted file mode 100644 index 1144eb2cc..000000000 --- a/essentials/images.mdx +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: 'Images and embeds' -description: 'Add image, video, and other HTML elements' -icon: 'image' ---- - - - -## Image - -### Using Markdown - -The [markdown syntax](https://www.markdownguide.org/basic-syntax/#images) lets you add images using the following code - -```md -![title](/path/image.jpg) -``` - -Note that the image file size must be less than 5MB. Otherwise, we recommend hosting on a service like [Cloudinary](https://cloudinary.com/) or [S3](https://aws.amazon.com/s3/). You can then use that URL and embed. - -### Using embeds - -To get more customizability with images, you can also use [embeds](/writing-content/embed) to add images - -```html - -``` - -## Embeds and HTML elements - - - -
- - - -Mintlify supports [HTML tags in Markdown](https://www.markdownguide.org/basic-syntax/#html). This is helpful if you prefer HTML tags to Markdown syntax, and lets you create documentation with infinite flexibility. - - - -### iFrames - -Loads another HTML page within the document. Most commonly used for embedding videos. - -```html - -``` diff --git a/essentials/markdown.mdx b/essentials/markdown.mdx deleted file mode 100644 index a45c1d569..000000000 --- a/essentials/markdown.mdx +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: 'Markdown syntax' -description: 'Text, title, and styling in standard markdown' -icon: 'text-size' ---- - -## Titles - -Best used for section headers. - -```md -## Titles -``` - -### Subtitles - -Best used for subsection headers. - -```md -### Subtitles -``` - - - -Each **title** and **subtitle** creates an anchor and also shows up on the table of contents on the right. - - - -## Text formatting - -We support most markdown formatting. Simply add `**`, `_`, or `~` around text to format it. - -| Style | How to write it | Result | -| ------------- | ----------------- | --------------- | -| Bold | `**bold**` | **bold** | -| Italic | `_italic_` | _italic_ | -| Strikethrough | `~strikethrough~` | ~strikethrough~ | - -You can combine these. For example, write `**_bold and italic_**` to get **_bold and italic_** text. - -You need to use HTML to write superscript and subscript text. That is, add `` or `` around your text. - -| Text Size | How to write it | Result | -| ----------- | ------------------------ | ---------------------- | -| Superscript | `superscript` | superscript | -| Subscript | `subscript` | subscript | - -## Linking to pages - -You can add a link by wrapping text in `[]()`. You would write `[link to google](https://google.com)` to [link to google](https://google.com). - -Links to pages in your docs need to be root-relative. Basically, you should include the entire folder path. For example, `[link to text](/writing-content/text)` links to the page "Text" in our components section. - -Relative links like `[link to text](../text)` will open slower because we cannot optimize them as easily. - -## Blockquotes - -### Singleline - -To create a blockquote, add a `>` in front of a paragraph. - -> Dorothy followed her through many of the beautiful rooms in her castle. - -```md -> Dorothy followed her through many of the beautiful rooms in her castle. -``` - -### Multiline - -> Dorothy followed her through many of the beautiful rooms in her castle. -> -> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood. - -```md -> Dorothy followed her through many of the beautiful rooms in her castle. -> -> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood. -``` - -### LaTeX - -Mintlify supports [LaTeX](https://www.latex-project.org) through the Latex component. - -8 x (vk x H1 - H2) = (0,1) - -```md -8 x (vk x H1 - H2) = (0,1) -``` diff --git a/essentials/navigation.mdx b/essentials/navigation.mdx deleted file mode 100644 index 60adeff23..000000000 --- a/essentials/navigation.mdx +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: 'Navigation' -description: 'The navigation field in docs.json defines the pages that go in the navigation menu' -icon: 'map' ---- - -The navigation menu is the list of links on every website. - -You will likely update `docs.json` every time you add a new page. Pages do not show up automatically. - -## Navigation syntax - -Our navigation syntax is recursive which means you can make nested navigation groups. You don't need to include `.mdx` in page names. - - - -```json Regular Navigation -"navigation": { - "tabs": [ - { - "tab": "Docs", - "groups": [ - { - "group": "Getting Started", - "pages": ["quickstart"] - } - ] - } - ] -} -``` - -```json Nested Navigation -"navigation": { - "tabs": [ - { - "tab": "Docs", - "groups": [ - { - "group": "Getting Started", - "pages": [ - "quickstart", - { - "group": "Nested Reference Pages", - "pages": ["nested-reference-page"] - } - ] - } - ] - } - ] -} -``` - - - -## Folders - -Simply put your MDX files in folders and update the paths in `docs.json`. - -For example, to have a page at `https://yoursite.com/your-folder/your-page` you would make a folder called `your-folder` containing an MDX file called `your-page.mdx`. - - - -You cannot use `api` for the name of a folder unless you nest it inside another folder. Mintlify uses Next.js which reserves the top-level `api` folder for internal server calls. A folder name such as `api-reference` would be accepted. - - - -```json Navigation With Folder -"navigation": { - "tabs": [ - { - "tab": "Docs", - "groups": [ - { - "group": "Group Name", - "pages": ["your-folder/your-page"] - } - ] - } - ] -} -``` - -## Hidden pages - -MDX files not included in `docs.json` will not show up in the sidebar but are accessible through the search bar and by linking directly to them. diff --git a/essentials/reusable-snippets.mdx b/essentials/reusable-snippets.mdx deleted file mode 100644 index 376e27bd9..000000000 --- a/essentials/reusable-snippets.mdx +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: "Reusable snippets" -description: "Reusable, custom snippets to keep content in sync" -icon: "recycle" ---- - -import SnippetIntro from '/snippets/snippet-intro.mdx'; - - - -## Creating a custom snippet - -**Pre-condition**: You must create your snippet file in the `snippets` directory. - - - Any page in the `snippets` directory will be treated as a snippet and will not - be rendered into a standalone page. If you want to create a standalone page - from the snippet, import the snippet into another file and call it as a - component. - - -### Default export - -1. Add content to your snippet file that you want to re-use across multiple - locations. Optionally, you can add variables that can be filled in via props - when you import the snippet. - -```mdx snippets/my-snippet.mdx -Hello world! This is my content I want to reuse across pages. My keyword of the -day is {word}. -``` - - - The content that you want to reuse must be inside the `snippets` directory in - order for the import to work. - - -2. Import the snippet into your destination file. - -```mdx destination-file.mdx ---- -title: My title -description: My Description ---- - -import MySnippet from '/snippets/path/to/my-snippet.mdx'; - -## Header - -Lorem impsum dolor sit amet. - - -``` - -### Reusable variables - -1. Export a variable from your snippet file: - -```mdx snippets/path/to/custom-variables.mdx -export const myName = 'my name'; - -export const myObject = { fruit: 'strawberries' }; -``` - -2. Import the snippet from your destination file and use the variable: - -```mdx destination-file.mdx ---- -title: My title -description: My Description ---- - -import { myName, myObject } from '/snippets/path/to/custom-variables.mdx'; - -Hello, my name is {myName} and I like {myObject.fruit}. -``` - -### Reusable components - -1. Inside your snippet file, create a component that takes in props by exporting - your component in the form of an arrow function. - -```mdx snippets/custom-component.mdx -export const MyComponent = ({ title }) => ( -
-

{title}

-

... snippet content ...

-
-); -``` - - - MDX does not compile inside the body of an arrow function. Stick to HTML - syntax when you can or use a default export if you need to use MDX. - - -2. Import the snippet into your destination file and pass in the props - -```mdx destination-file.mdx ---- -title: My title -description: My Description ---- - -import { MyComponent } from '/snippets/custom-component.mdx'; - -Lorem ipsum dolor sit amet. - - -``` diff --git a/essentials/settings.mdx b/essentials/settings.mdx deleted file mode 100644 index 884de13a4..000000000 --- a/essentials/settings.mdx +++ /dev/null @@ -1,318 +0,0 @@ ---- -title: 'Global Settings' -description: 'Mintlify gives you complete control over the look and feel of your documentation using the docs.json file' -icon: 'gear' ---- - -Every Mintlify site needs a `docs.json` file with the core configuration settings. Learn more about the [properties](#properties) below. - -## Properties - - -Name of your project. Used for the global title. - -Example: `mintlify` - - - - - An array of groups with all the pages within that group - - - The name of the group. - - Example: `Settings` - - - - The relative paths to the markdown files that will serve as pages. - - Example: `["customization", "page"]` - - - - - - - - Path to logo image or object with path to "light" and "dark" mode logo images - - - Path to the logo in light mode - - - Path to the logo in dark mode - - - Where clicking on the logo links you to - - - - - - Path to the favicon image - - - - Hex color codes for your global theme - - - The primary color. Used for most often for highlighted content, section - headers, accents, in light mode - - - The primary color for dark mode. Used for most often for highlighted - content, section headers, accents, in dark mode - - - The primary color for important buttons - - - The color of the background in both light and dark mode - - - The hex color code of the background in light mode - - - The hex color code of the background in dark mode - - - - - - - - Array of `name`s and `url`s of links you want to include in the topbar - - - The name of the button. - - Example: `Contact us` - - - The url once you click on the button. Example: `https://mintlify.com/docs` - - - - - - - - - Link shows a button. GitHub shows the repo information at the url provided including the number of GitHub stars. - - - If `link`: What the button links to. - - If `github`: Link to the repository to load GitHub information from. - - - Text inside the button. Only required if `type` is a `link`. - - - - - - - Array of version names. Only use this if you want to show different versions - of docs with a dropdown in the navigation bar. - - - - An array of the anchors, includes the `icon`, `color`, and `url`. - - - The [Font Awesome](https://fontawesome.com/search?q=heart) icon used to feature the anchor. - - Example: `comments` - - - The name of the anchor label. - - Example: `Community` - - - The start of the URL that marks what pages go in the anchor. Generally, this is the name of the folder you put your pages in. - - - The hex color of the anchor icon background. Can also be a gradient if you pass an object with the properties `from` and `to` that are each a hex color. - - - Used if you want to hide an anchor until the correct docs version is selected. - - - Pass `true` if you want to hide the anchor until you directly link someone to docs inside it. - - - One of: "brands", "duotone", "light", "sharp-solid", "solid", or "thin" - - - - - - - Override the default configurations for the top-most anchor. - - - The name of the top-most anchor - - - Font Awesome icon. - - - One of: "brands", "duotone", "light", "sharp-solid", "solid", or "thin" - - - - - - An array of navigational tabs. - - - The name of the tab label. - - - The start of the URL that marks what pages go in the tab. Generally, this - is the name of the folder you put your pages in. - - - - - - Configuration for API settings. Learn more about API pages at [API Components](/api-playground/demo). - - - The base url for all API endpoints. If `baseUrl` is an array, it will enable for multiple base url - options that the user can toggle. - - - - - - The authentication strategy used for all API endpoints. - - - The name of the authentication parameter used in the API playground. - - If method is `basic`, the format should be `[usernameName]:[passwordName]` - - - The default value that's designed to be a prefix for the authentication input field. - - E.g. If an `inputPrefix` of `AuthKey` would inherit the default input result of the authentication field as `AuthKey`. - - - - - - Configurations for the API playground - - - - Whether the playground is showing, hidden, or only displaying the endpoint with no added user interactivity `simple` - - Learn more at the [playground guides](/api-playground/demo) - - - - - - Enabling this flag ensures that key ordering in OpenAPI pages matches the key ordering defined in the OpenAPI file. - - This behavior will soon be enabled by default, at which point this field will be deprecated. - - - - - - - A string or an array of strings of URL(s) or relative path(s) pointing to your - OpenAPI file. - - Examples: - - ```json Absolute - "openapi": "https://example.com/openapi.json" - ``` - ```json Relative - "openapi": "/openapi.json" - ``` - ```json Multiple - "openapi": ["https://example.com/openapi1.json", "/openapi2.json", "/openapi3.json"] - ``` - - - - - - An object of social media accounts where the key:property pair represents the social media platform and the account url. - - Example: - ```json - { - "x": "https://x.com/mintlify", - "website": "https://mintlify.com" - } - ``` - - - One of the following values `website`, `facebook`, `x`, `discord`, `slack`, `github`, `linkedin`, `instagram`, `hacker-news` - - Example: `x` - - - The URL to the social platform. - - Example: `https://x.com/mintlify` - - - - - - Configurations to enable feedback buttons - - - - Enables a button to allow users to suggest edits via pull requests - - - Enables a button to allow users to raise an issue about the documentation - - - - - - Customize the dark mode toggle. - - - Set if you always want to show light or dark mode for new users. When not - set, we default to the same mode as the user's operating system. - - - Set to true to hide the dark/light mode toggle. You can combine `isHidden` with `default` to force your docs to only use light or dark mode. For example: - - - ```json Only Dark Mode - "modeToggle": { - "default": "dark", - "isHidden": true - } - ``` - - ```json Only Light Mode - "modeToggle": { - "default": "light", - "isHidden": true - } - ``` - - - - - - - - - A background image to be displayed behind every page. See example with - [Infisical](https://infisical.com/docs) and [FRPC](https://frpc.io). - diff --git a/index.mdx b/index.mdx deleted file mode 100644 index 15c23fb6c..000000000 --- a/index.mdx +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: "Introduction" -description: "Welcome to the new home for your documentation" ---- - -## Setting up - -Get your documentation site up and running in minutes. - - - Follow our three step quickstart guide. - - -## Make it yours - -Design a docs site that looks great and empowers your users. - - - - Edit your docs locally and preview them in real time. - - - Customize the design and colors of your site to match your brand. - - - Organize your docs to help users find what they need and succeed with your product. - - - Auto-generate API documentation from OpenAPI specifications. - - - -## Create beautiful pages - -Everything you need to create world-class documentation. - - - - Use MDX to style your docs pages. - - - Add sample code to demonstrate how to use your product. - - - Display images and other media. - - - Write once and reuse across your docs. - - - -## Need inspiration? - - - Browse our showcase of exceptional documentation sites. - diff --git a/integrations/netsuite/overview.mdx b/integrations/netsuite/overview.mdx new file mode 100644 index 000000000..85a27721e --- /dev/null +++ b/integrations/netsuite/overview.mdx @@ -0,0 +1,9 @@ +--- +title: 'NetSuite' +description: 'NetSuite integration' +--- + +## Overview + +NetSuite integration documentation coming soon. + diff --git a/integrations/overview.mdx b/integrations/overview.mdx deleted file mode 100644 index 80d8b1d5f..000000000 --- a/integrations/overview.mdx +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: 'New file' -description: 'Description of your new file.' ---- - diff --git a/integrations/quickbooks/overview.mdx b/integrations/quickbooks/overview.mdx new file mode 100644 index 000000000..d5c109bd9 --- /dev/null +++ b/integrations/quickbooks/overview.mdx @@ -0,0 +1,9 @@ +--- +title: 'QuickBooks' +description: 'QuickBooks integration' +--- + +## Overview + +QuickBooks integration documentation coming soon. + diff --git a/integrations/settings.mdx b/integrations/settings.mdx deleted file mode 100644 index 055ecac39..000000000 --- a/integrations/settings.mdx +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 'New file' -description: 'Description of your new file.' ---- - - - This is how you use a card with an icon and a link. Clicking on this card - brings you to the Columns page. - diff --git a/integrations/shopify/overview.mdx b/integrations/shopify/overview.mdx new file mode 100644 index 000000000..b1eef4496 --- /dev/null +++ b/integrations/shopify/overview.mdx @@ -0,0 +1,10 @@ +--- +title: 'Shopify' +description: 'Shopify integration' +icon: 'shopify' +--- + +## Overview + +Shopify integration documentation coming soon. + diff --git a/integrations/stripe/overview.mdx b/integrations/stripe/overview.mdx new file mode 100644 index 000000000..62017ae44 --- /dev/null +++ b/integrations/stripe/overview.mdx @@ -0,0 +1,10 @@ +--- +title: 'Stripe' +description: 'Stripe integration' +icon: 'stripe-s' +--- + +## Overview + +Stripe integration documentation coming soon. + diff --git a/integrations/woocommerce/setup.mdx b/integrations/woocommerce/setup.mdx index 59eb379af..4004df164 100644 --- a/integrations/woocommerce/setup.mdx +++ b/integrations/woocommerce/setup.mdx @@ -1,6 +1,7 @@ --- title: "WooCommerce integration" description: "Learn how Rootfi integrates with WooCommerce to fetch e-commerce data" +icon: "wordpress" --- ## Overview diff --git a/integrations/xero/overview.mdx b/integrations/xero/overview.mdx new file mode 100644 index 000000000..313837f02 --- /dev/null +++ b/integrations/xero/overview.mdx @@ -0,0 +1,9 @@ +--- +title: 'Xero' +description: 'Xero integration' +--- + +## Overview + +Xero integration documentation coming soon. + diff --git a/integrations/zoho/overview.mdx b/integrations/zoho/overview.mdx new file mode 100644 index 000000000..bb25a2285 --- /dev/null +++ b/integrations/zoho/overview.mdx @@ -0,0 +1,9 @@ +--- +title: 'Zoho' +description: 'Zoho integration' +--- + +## Overview + +Zoho integration documentation coming soon. + diff --git a/quickstart.mdx b/quickstart.mdx deleted file mode 100644 index c711458ba..000000000 --- a/quickstart.mdx +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: "Quickstart" -description: "Start building awesome documentation in minutes" ---- - -## Get started in three steps - -Get your documentation site running locally and make your first customization. - -### Step 1: Set up your local environment - - - - During the onboarding process, you created a GitHub repository with your docs content if you didn't already have one. You can find a link to this repository in your [dashboard](https://dashboard.mintlify.com). - - To clone the repository locally so that you can make and preview changes to your docs, follow the [Cloning a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) guide in the GitHub docs. - - - 1. Install the Mintlify CLI: `npm i -g mint` - 2. Navigate to your docs directory and run: `mint dev` - 3. Open `http://localhost:3000` to see your docs live! - - Your preview updates automatically as you edit files. - - - -### Step 2: Deploy your changes - - - - Install the Mintlify GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app). - - Our GitHub app automatically deploys your changes to your docs site, so you don't need to manage deployments yourself. - - - For a first change, let's update the name and colors of your docs site. - - 1. Open `docs.json` in your editor. - 2. Change the `"name"` field to your project name. - 3. Update the `"colors"` to match your brand. - 4. Save and see your changes instantly at `http://localhost:3000`. - - Try changing the primary color to see an immediate difference! - - - -### Step 3: Go live - - - 1. Commit and push your changes. - 2. Your docs will update and be live in moments! - - -## Next steps - -Now that you have your docs running, explore these key features: - - - - - Learn MDX syntax and start writing your documentation. - - - - Make your docs match your brand perfectly. - - - - Include syntax-highlighted code blocks. - - - - Auto-generate API docs from OpenAPI specs. - - - - - - **Need help?** See our [full documentation](https://mintlify.com/docs) or join our [community](https://mintlify.com/community). - From 5c4c4c99a5ac329ff4d648459c5b9049d8c62100 Mon Sep 17 00:00:00 2001 From: Sam Suechting Date: Thu, 11 Dec 2025 13:47:44 +0530 Subject: [PATCH 22/45] Add Workflow Builder documentation --- .../How to crearte a workflow _.md | 86 ++++++++ .../How to start the project locally _.md | 55 +++++ ...Service Requests using Workflow Builder.md | 110 ++++++++++ .../Workflow Builder DSL types.md | 132 ++++++++++++ .../Workflow Builder Data Models.md | 155 +++++++++++++ .../Workflow Builder Definition Types.md | 203 ++++++++++++++++++ .../Workflow Builder Engg Document.md | 8 + .../Workflow Builder JSON Schemas.md | 132 ++++++++++++ .../Workflow Builder Product Concepts.md | 3 + .../Workflow Builder Product Document.md | 35 +++ .../Workflow Builder Product How Tos.md | 3 + .../Workflow Builder Root Document.md | 16 ++ .../Workflow Builder Runtime Types.md | 83 +++++++ ...finition Validation Rules Documentation.md | 199 +++++++++++++++++ .../workflow-builder/Workflow Step Types.md | 44 ++++ 15 files changed, 1264 insertions(+) create mode 100644 engine/workflow-builder/How to crearte a workflow _.md create mode 100644 engine/workflow-builder/How to start the project locally _.md create mode 100644 engine/workflow-builder/Rendering Service Requests using Workflow Builder.md create mode 100644 engine/workflow-builder/Workflow Builder DSL types.md create mode 100644 engine/workflow-builder/Workflow Builder Data Models.md create mode 100644 engine/workflow-builder/Workflow Builder Definition Types.md create mode 100644 engine/workflow-builder/Workflow Builder Engg Document.md create mode 100644 engine/workflow-builder/Workflow Builder JSON Schemas.md create mode 100644 engine/workflow-builder/Workflow Builder Product Concepts.md create mode 100644 engine/workflow-builder/Workflow Builder Product Document.md create mode 100644 engine/workflow-builder/Workflow Builder Product How Tos.md create mode 100644 engine/workflow-builder/Workflow Builder Root Document.md create mode 100644 engine/workflow-builder/Workflow Builder Runtime Types.md create mode 100644 engine/workflow-builder/Workflow Definition Validation Rules Documentation.md create mode 100644 engine/workflow-builder/Workflow Step Types.md diff --git a/engine/workflow-builder/How to crearte a workflow _.md b/engine/workflow-builder/How to crearte a workflow _.md new file mode 100644 index 000000000..6b0e05e3d --- /dev/null +++ b/engine/workflow-builder/How to crearte a workflow _.md @@ -0,0 +1,86 @@ +# How to create a workflow ? + +### **1\. Accessing Workflow Management** + +* Go to the **Admin Portal**. +* On the left sidebar, scroll to the bottom and click **Workflow Management**. +* You’ll land on a page that lists all existing workflows. +* On the top right, you’ll see two tabs: + * **Workflow Links** + * **Create Workflow** + +### **2\. Creating a New Workflow Template** + +1. Click Create Workflow. +2. A modal appears where you can enter: + * Workflow name + * Other optional fields +3. Click Create to add the new workflow. +4. The new workflow will now appear in the workflows table. + +### **3\. Opening an Existing Workflow** + +* Click any row in the workflow list. +* This opens the Workflow Detail Page for that template. +* Here you’ll see all existing versions for that workflow. +* For a newly created workflow, this section will be empty. + +### **4\. Creating a Version** + +1. On the workflow detail page, click Add Version (top right). +2. A modal appears asking for: + * Version number + * Starter version (optional) + * This lets you start from an existing version instead of building from scratch. +3. Click Create to generate the new version. +4. The system opens the Workflow Editor. + +### **5\. Using the Workflow Editor** + +Inside the editor, you will see: + +* A Steps Panel on the left, containing all available step types. +* A central Canvas where you can drag and drop steps to build your workflow. +* A Configuration Panel on the right that appears when you click any step. + +#### **Important Notes** + +* There is no autosave right now. +* Save your progress frequently using the Save button on the top right. +* When ready, click Publish. +* Newly created versions start in Draft status. +* Publishing makes the version eligible to be activated. + +### **6\. Marking a Version as Active** + +1. After publishing a version, return to the workflow’s versions list. +2. You will see an Activate Version option next to published versions. +3. Marking a version as active makes it the version used whenever this workflow is generated. + +### **7\. Understanding Workflow Links** + +Workflow links decide *how and when* a workflow is triggered. + +To access links: + +* Go back to the main workflow page. +* Click the Workflow Links tab. + +You’ll see a list of existing links. You can edit or delete these. + +#### **Creating a Workflow Link** + +1. Click Add Link. +2. A modal will open where you must select: + * Workflow Template (dropdown of all templates) + * Link Type: + * Service Request Type + * Product ID + * Identifier: + * The exact service request type or product ID +3. Save the link. + +#### How Links Work + +* When a matching service request is created, or a product with the specified ID is purchased, the system automatically triggers and generates the workflow. + diff --git a/engine/workflow-builder/How to start the project locally _.md b/engine/workflow-builder/How to start the project locally _.md new file mode 100644 index 000000000..c0c5d1204 --- /dev/null +++ b/engine/workflow-builder/How to start the project locally _.md @@ -0,0 +1,55 @@ +# How to run the project locally ? + +1. Install the temporal CLI using + +```shell +brew install temporal +``` + +2. Clone the github repo from here \- [https://github.com/commenda-eng/commenda-temporal-dsl](https://github.com/commenda-eng/commenda-temporal-dsl) +3. Create a .env file + 1. **COMMENDA\_LOGICAL\_BACKEND\_API\_KEY \-** used to interact with the logical backend. + 2. **COMMENDA\_LOGICAL\_BACKEND\_CLIENT\_KEY** \- to validate the requests coming from the logical backend. + + +```ts +COMMENDA_TEMPORAL_BACKEND_API_KEY=RjrbIP9ZNYkuMf6ICRQLDwTdcfeoIaQU6T0DcIl3UjcXsXFC2JsrThQ6FLE8W3qk +COMMENDA_LOGICAL_BACKEND_API_KEY=5d19648dc2800784225ff909cb1682bf3d5f51d6181114eaae8ee2396320b8c2 +COMMENDA_LOGICAL_BACKEND_API_URL=http://localhost:8000/api/v1 +TEMPORAL_NAMESPACE=default +TEMPORAL_WORKER_ROLE=DSL_ENGINE +TEMPORAL_TASK_QUEUE=dsl-engine +TEMPORAL_API_KEY='xxxx' // only required for the staging and prod +TEMPORAL_ADDRESS='xxxx' // only required for the staging and prod +TEMPORAL_WORKER_BUILD_ID=1 +AWS_ACCESS_KEY_ID="Use the same from Commenda Logical Backend" +AWS_SECRET_ACCESS_KEY="Use the same from Commenda Logical Backend" +AWS_REGION=ap-south-1 +PORT=8001 +NODE_ENV=development +``` + +4. In the commenda logical backend, add the following keys + 1. **TEMPORAL\_BACKEND\_CLIENT\_KEY** \- It is used in the logical backend to validate the requests coming from the temporal-backend. + 2. **COMMENDA\_TEMPORAL\_BACKEND\_API\_KEY** \- used to interact with the temporal backend. + +```ts +COMMENDA_TEMPORAL_BACKEND_API_KEY=RjrbIP9ZNYkuMf6ICRQLDwTdcfeoIaQU6T0DcIl3UjcXsXFC2JsrThQ6FLE8W3qk +COMMENDA_TEMPORAL_BACKEND_URL=http://localhost:8001 +TEMPORAL_BACKEND_CLIENT_KEY=5d19648dc2800784225ff909cb1682bf3d5f51d6181114eaae8ee2396320b8c2 +``` + +**COMMENDA\_LOGICAL\_BACKEND\_CLIENT\_KEY** of the temporal backend should match the **COMMENDA\_TEMPORAL\_BACKEND\_API\_KEY** of the logical backend. + +**TEMPORAL\_BACKEND\_CLIENT\_KEY** of the logical backend should map to the **COMMENDA\_LOGICAL\_BACKEND\_API\_KEY** of the temporal backend. + +5. First run the “**npm run temporal:dev**”. This will start the temporal server for you on “[**http://localhost:8233**](http://localhost:8233)”. You will also see a [temporal.db](http://temporal.db) created in the root directory. This db stores all the executions. +6. Secondly, run “**npm run start:dev**”, this will just start the node project server on 8001 port. +7. Lastly, run “**npm run temporal:worker**”, this will start the temporal worker which will actually run your code, + + + +Note :- +Always remember, if you are making any changes to the environment variables, then add it on **github** and update the same in **deploy-app.yaml** file as well. + +### Now your temporal backend is up and running. \ No newline at end of file diff --git a/engine/workflow-builder/Rendering Service Requests using Workflow Builder.md b/engine/workflow-builder/Rendering Service Requests using Workflow Builder.md new file mode 100644 index 000000000..483a1ca78 --- /dev/null +++ b/engine/workflow-builder/Rendering Service Requests using Workflow Builder.md @@ -0,0 +1,110 @@ +# Rendering Service Request UI + +*Note:- The given method is just a temporary solution till we have a fully functional workflow powered by form builder. This is just for powering our existing service requests orchestration using workflows. **JUST ORCHESTRATION**. Other business contexts like files, assigneeType, workRequest, corporation, company etc still lie inside the serviceRequest.* + +For each **service request type**, we maintain a configuration that defines: + +* Which **task groups** exist +* Which **tasks** belong to each group + +We represent these using a TaskGroup enum and a Task enum. + +At runtime, we use this configuration to generate the **service request instances** on the backend. + +On the frontend, we have a componentMap that maps each taskKey to a React component, which is then rendered. + Examples of common components include: + +* AddBankAccount +* MarkAsCompleted + +## Workflow Executions As Source of Truth + +Whenever a service request is initiated, we try to start a **workflow execution** for it. + +* A workflow execution is started **only if** there is a workflow link associated with that service request type. +* If a workflow execution exists, it becomes the **source of truth** for task statuses. + +Ideally, we would render the service request UI **directly** from the workflow execution and remove the separate service request model. However, this is not currently possible because there is additional business context attached to the service request that workflows don’t know about (e.g. files, agentFirms, subsidiaries, corporations, etc.). + +As a result: + +* We will have **service request runtime instances** and **workflow execution runtime instances** co-existing. +* These two must be **kept in sync**. +* **Statuses** should always come from the workflow execution. + +## Syncing Task Updates + +Every time we update a task in the service request: + +1. If the service request has an associated workflow execution, we **propagate the update** to the workflow execution. +2. We wait for that update to complete and then **fetch the latest runtime statuses** from the workflow. +3. We iterate over the new statuses and build the corresponding Prisma mutations. +4. We execute those updates inside a **transaction**. + +If something fails midway (e.g. while creating or applying all mutations), we provide a **manual “Sync” button** that can be used to reconcile statuses between the service request and the workflow. + +## Mapping Workflows to Service Requests + +When creating a new workflow, you will have the option to **connect it to a service request**: + +* At the workflow level, we have a legacyServiceRequestKey. +* Within a workflow, you can create **stepGroups**. +* These stepGroups can be linked to existing taskGroups from the service request model. + +The mapping flow looks like this: + +1. **Select** the legacyServiceRequestKey. +2. **Select** the taskGroup for each stepGroup. +3. For each step, **select** the taskKey. + +Once this mapping is complete: + +* If a UI component exists for a given taskKey in componentMap, that custom component will be rendered. +* If no matching component is found, we render a **Generic Task**: + * It is assigned to an agent. + * It behaves as a “Mark as Completed” task. + +This means: + +* Any new task groups or tasks you add in the workflow that **do not** map 1:1 to existing service request tasks will fall back to the **Generic Task** UI. + +## + +## Handling Dynamic DSC Task Groups for India Pvt Ltd + +The India Pvt Ltd incorporation workflow requires dynamic task groups: each director who does not already have a DSC must go through a separate DSC onboarding flow. + +This creates a domain mismatch: + +* In the **Workflow domain**, DSC onboarding is represented as one child workflow per director. +* In the **Service Request domain**, each DSC workflow must appear as a separate task group. + +We do not yet know whether this pattern generalizes to all future workflows (child-of-child workflows, multiple step groups, etc.), so we implement a targeted, DSC-specific solution that can evolve later. + +We do the following right now :- + +* Identifies DSC-related child workflow executions. +* Creates or updates corresponding Service Request task groups. +* Links each task group to the correct workflow execution (`workflowExecutionId`). +* Ensures the group name and ordering follow the SR UI conventions. + +When the UI updates a task, we determine which workflow execution to update: + +```ts +workflowExecutionToUpdate = + serviceRequestTaskGroup.workflowExecutionId + OR serviceRequest.workflowExecutionId +``` + +If the task belongs to a DSC group, we update the **child workflow execution**. +Otherwise, we update the **parent workflow execution**. + +## Why We Are Not Generalizing Yet + +* Should all child workflows appear as Service Request task groups? +* Should child-of-child workflows be shown? +* How should workflows with multiple step groups be projected? +* Should we introduce a generic “projection type” system? + +We will revisit these once more diverse workflows are built and real patterns emerge. + diff --git a/engine/workflow-builder/Workflow Builder DSL types.md b/engine/workflow-builder/Workflow Builder DSL types.md new file mode 100644 index 000000000..3dcf052b9 --- /dev/null +++ b/engine/workflow-builder/Workflow Builder DSL types.md @@ -0,0 +1,132 @@ +# Workflow Builder DSL types + +## Expressions + +It will evaluate to some value. ExpressionType will decide which engine will be used for evaluation. There can be different types of expressions but currently we only support JSONATA Expressions. + +```ts +export enum ExpressionType { + JSONATA = 'jsonata', +} export type TExpr = { type: ExpressionType.JSONATA; src: string }; +``` + +### Evaluation Scope + +This is not a type. + +All the expressions are evaluated against an environment which is the Evaluation Scope. It has the following properties:. +**“\_\_context\_\_”** \- use this to access the global context. +**“\_\_steps\_\_”** \- use this to access any step’s output. Eg:- \_\_step\_\_.stepID.name +**“\_\_datasources\_\_”** \- use this to access any datasource’s output that was fetched during that step. Eg:- \_\_ds\_\_.dsID.corporation.companyLegalName +**“\_\_each\_\_”** \- use this to access each item when iterating through a collection. Eg:- \_\_each\_\_.id + +## Value Providers + +### TFieldRef + +This defines how to access any field. +Currently, there are 4 sources from where you can access the field which is defined using FieldRefSource. + +* **FieldRefSource.CONTEXT** \- Access from the global context +* **FieldRefSource.STEP** \- Access from the output of a step +* **FieldRefSource.DATASOURCE** \- Access from the output of a datasource +* **FieldRefSource.EACH** \- If you are within a loop, you can access individual item fields. + +**path** \- It should be a **dot notation string** only. It will be used to access a particular key inside the source object. This is a string and not an expression. We are using a very light lib “dot-props” for it. + +```ts +export type TFieldRef = + | { source: FieldRefSource.CONTEXT; path: string } + | { source: FieldRefSource.STEP; stepId: string; path: string } + | { source: FieldRefSource.DATASOURCE; key: string; path: string } + | { source: FieldRefSource.EACH; path: string } +``` + +### TValueProvider + +Tell us how to produce a value. You produce a value in three ways :- + +- **const**: It is a hard coded value. +- **field**: by accessing any field. +- **expr**: computing an expression against the evaluation scope. + +```ts +export type TValueProvider = +| { type: "const"; value: unknown } +| { type: "field"; ref: TFieldRef } +| { type: "expr"; expr: TExpr }; +``` + +### TParamValue + +This is used to generate the parameter values of a datasource or function which we would want to call. + +```ts +export type TParamValue = TValueProvider | { [k: string]: TParamValue } | TParamValue[]; +``` + +### TDatasourceCall + +We have data sources in our system which you can call and fetch data. Sometimes we would want to use them within our workflow. You define a datasource call using TDatasourceCall. + +```ts +export type TDataSourceCall = { + id: string; + alias: string; + type: DataSourceType.COMMENDA_LOGICAL_BACKEND; + dataSourceID: string; // from the db. + params?: TParamValue; + select?: TExpr; // Default - it will store the entire output of the data source. If you want to transform the output of the data source or store any specific field from the output. + scope?: 'per-step' | 'per-item'; // default: per-step +}; +``` + +### TIteratorProvider + +These should output an array. +**expression** \- it will evaluate the expression against the evaluation context. +**step** \- it will access the output of a step and return an array. +**datasource** \- it will access the output of a data source and return an array. The datasource would be already loaded. + +```ts +export type TIterableProvider = + | { type: IterableType.EXPRESSION; expr: TExpr } + | { type: IterableType.STEP; stepId: string; select?: TExpr } + | { type: IterableType.DATASOURCE; key: string; select?: TExpr }; +``` + +### TMapping + +Each mapping specifies where the value should be written (targetPath) and how the value should be derived (value), along with an optional mode that controls how data is written. + +* **targetPath** \- A dot-notation path (e.g., "director.id") representing where in the target object the value will be placed. +* **mode** \- defines how the data should be written. + * **set** (default): replaces or sets the value at the target path. + * **append**: used when the target is an array; appends the new value. + + + +```ts +export type TMapping = { + id: string; + targetPath: string; + value: TValueProvider; + mode?: 'set' | 'append'; +}; +``` + +Example :- + +```json +{ + "id": "map-directorId", + "targetPath": "directorId", + "value": { + "type": "expr", + "expr": { "src": "__each__.id" } + }, + "mode": "set" +} +``` + +In the above example, directorId will be set to batch item id (`__each__.id).` \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Data Models.md b/engine/workflow-builder/Workflow Builder Data Models.md new file mode 100644 index 000000000..001f1dedc --- /dev/null +++ b/engine/workflow-builder/Workflow Builder Data Models.md @@ -0,0 +1,155 @@ +# Workflow Data Models + +All of this is in commenda-logical-backend. + +## Workflow Templates + +This model stores a workflow template. + +```ts +model WorkflowTemplate { + id String @id @default(cuid()) + name String + description String? + + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + ActiveVersion WorkflowTemplateVersion? @relation(fields: [activeVersionId], references: [id], name: "active_workflow_template_version") + activeVersionId String? @unique + + Versions WorkflowTemplateVersion[] @relation("workflow_template_has_version") + + WorkflowTemplateLinks WorkflowTemplateLink[] +} + +``` + +## Workflow Template Versions + +This model stores multiple versions of a particular template. The templates are initially created in Draft status. Only one WorkflowTemplateVersion can be linked to the workflow as the currently-active version. + +// Let’s add details here explaining how VersionStatus and ActiveWorkflowTemplate interact and exactly what each one means. + +```ts +enum WorkflowTemplateVersionStatus { + DRAFT + PUBLISHED + DEPRECATED +} + +model WorkflowTemplateVersion { + id String @id @default(cuid()) + + WorkflowTemplate WorkflowTemplate @relation(fields: [workflowTemplateId], references: [id], onDelete: Cascade, name: "workflow_template_has_version") + workflowTemplateId String + + version String // Semantic version: "1.0.0" + versionNote String? // Changelog for this version + + definition Json + + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + status WorkflowTemplateVersionStatus @default(DRAFT) + + // This will be filled, if this is the active version of the workflow. + ActiveWorkflowTemplate WorkflowTemplate? @relation(name: "active_workflow_template_version") + + WorkflowExecutions WorkflowExecution[] + + @@unique([workflowTemplateId, version]) +} + +``` + +## Workflow Links + +Workflow Link tells how a workflow should be triggered. There are two types of links currently. +SERVICE\_CATALOG \- If you want to link it to a specific type of service request. +PRODUCT \- If you want to link to a product from our billing software (currently Chargebee). + +So if any service request or a product is bought and a workflow link is present, an instance of the active workflow template for that workflow will be created by calling the TemporalWorkflowService API. + +```ts +enum WorkflowLinkType { + SERVICE_CATALOG + PRODUCT +} +model WorkflowTemplateLink { + id String @id @default(cuid()) + + WorkflowTemplate WorkflowTemplate @relation(fields: [workflowTemplateId], references: [id], onDelete: Cascade) + workflowTemplateId String + + entityType WorkflowLinkType + entityId String + + @@unique([entityType, entityId]) +} +``` + +## Workflow Executions + +This is a running instance of a workflow template version, corresponding to a specific service that is being delivered for a customer or a subworkflow thereof. The actual runtime state of this execution gets tracked in temporal. + +Each workflow instance is in one of the following statuses: + +* CREATED \- The instance was created and hasn’t started to run. +* STARTED \- The execution of the workflow has started. +* FAILED\_TO\_START \- The execution failed to start. +* COMPLETED \- workflow execution completed successfully. +* FAILED \- workflow execution failed. + +In the data model, + +* **workflowTemplateVersionId** \- refers to the template version used for execution. +* **parentWorkflowExecutionId** \- If this is the child execution, it will refer to the workflowExecution that triggered it. +* **rootWorkflowExecutionId** \- tracks the root workflow that eventually triggered this execution. Can be used for correlation of related requests. +* **context** \- the additional data about this workflow execution. Like directorID, if DSC. + * Within the temporal execution engine this is not used. It’s just metadata stored in the global context of the request, which the caller can use. + * Not currently getting used for anything. +* **ServiceRequest** \- The service request associated with this execution +* **ServiceRequestTaskGroup** \- task groups like DSC are also treated as child workflow execution. + +```ts + +enum WorkflowExecutionStatus { + CREATED + STARTED + FAILED_TO_START + COMPLETED +} + +// Running instance of a workflow template +model WorkflowExecution { + id String @id @default(cuid()) + + name String + + WorkflowTemplateVersion WorkflowTemplateVersion @relation(fields: [workflowTemplateVersionId], references: [id]) + workflowTemplateVersionId String + + createdAt DateTime @default(now()) + + ParentWorkflowExecution WorkflowExecution? @relation(fields: [parentWorkflowExecutionId], references: [id], onDelete: Cascade, name: "parent_workflow_execution") + parentWorkflowExecutionId String? + +rootWorkflowExecutionId String? + RootWorkflowExecution WorkflowExecution? @relation(fields: [rootWorkflowExecutionId], references: [id], onDelete: Cascade, name: "root_workflow_execution") + + context Json? + // This is not the runtime status of the workflow execution. + status WorkflowExecutionStatus @default(CREATED) + + ChildWorkflowExecutions WorkflowExecution[] @relation("parent_workflow_execution") + +DescendantWorkflowExecutionsFromRoot WorkflowExecution[] @relation("root_workflow_execution") + + ServiceRequest ServiceRequest? + ServiceRequestTaskGroup ServiceRequestTaskGroup? +} + +``` + diff --git a/engine/workflow-builder/Workflow Builder Definition Types.md b/engine/workflow-builder/Workflow Builder Definition Types.md new file mode 100644 index 000000000..cd6868eb8 --- /dev/null +++ b/engine/workflow-builder/Workflow Builder Definition Types.md @@ -0,0 +1,203 @@ +# Workflow Builder Definition + +### TWorkflowDefinition + +* name \- name of this workflow +* steps \- steps involved in the workflow +* stepTransitions \- stores transitions between the steps +* stepGroups \- stores all the stepGroups which is just for a UI wrapper around the tasks. +* legacyServiceRequestType \- maps to the service request type. + +```ts +export type TWorkflowDefinition = { + id: string; + name: string; + steps: TWorkflowStepDefinition[]; + stepTransitions: TWorkflowStepTransition[]; + stepGroups?: TStepGroup[]; + legacyServiceRequestType?: string; +}; + +``` + +### TWorkflowStepDefintion + +#### WorkflowStepType + +* **start** — The entry point of the workflow. Each workflow must have exactly one start node. +* **end** — The terminal node of the workflow. A workflow must have exactly one end node. +* **human**.\* — Represents a step that requires human input. + * human.url\_redirect — Redirects a user to a specific URL. // Not implemented + * human.form — Presents a structured form to collect data. // Not implemented + * human.confirm — Waits for user confirmation or acknowledgment. + * human.doc\_upload — Requests a user to upload one or more documents. // Not implemented +* **sys.sub\_workflow** — A system step that invokes another workflow, either in single execution mode or in batch (iterative) mode. +* **gateway**.\* — A logical control-flow node used for routing execution. + * gateway.parallel\_split — Triggers multiple branches to run in parallel. + * gateway.parallel\_join — Waits for all incoming branches to complete before proceeding. + * gateway.exclusive\_split — Chooses exactly one outgoing path based on evaluated conditions. Condition is required only in one of the paths. + * gateway.inclusive\_split — Can trigger multiple outgoing branches if their conditions evaluate to true. + +#### TWorkflowBaseStepDefinition + +* **id** — A unique identifier for the step within the workflow. +* **type** — The type of step, one of the WorkflowStepType values. +* **name** — A human-readable label shown in the UI and logs. +* **outputSchema** — An optional JSON Schema describing the expected structure of the step’s output. This is primarily used for validation and for tooling to infer available data fields. +* **group** — Optional grouping metadata for UI organization. It includes: + * groupId — Identifier for the logical group this step belongs to. + * order — The relative position of this step within the group. +* **legacyServiceRequestTaskKey** — A backward-compatibility field linking this step to older service-request tasks. +* **activationPolicy** — An optional policy that defines the default runtime activation state for this step. +* **ui** — Contains UI metadata for the workflow designer, especially React Flow coordinates: + * reactFlow.position.x and .y — The step’s position in the visual editor canvas. + +```ts +export type TWorkflowBaseStepDefinition = { + id: string; + type: WorkflowStepType; + name: string; + outputSchema?: Record; + group?: { + groupId: string; + order: number; + }; + legacyServiceRequestTaskKey?: string; + activationPolicy?: TStepActivationPolicy; + ui: { + reactFlow: { + position: { + x: number; + y: number; + }; + }; + }; +}; +``` + +#### TStepActivationPolicy + +* **defaultStatus**: defines what the default status of the step should be while starting the step. + + +```ts +export type TStepActivationPolicy = { + defaultStatus?: WorkflowRuntimeStepStatus; +}; +``` + +#### TBaseSubWorkflowStepDefinition + +* **mode** — Defines whether the subworkflow runs once (SINGLE) or for each item in a collection (BATCH). +* **childWorkflowTemplateVersionId** — References the versioned child workflow template to execute. +* **dataSources** — A list of data source calls that can be executed before the subworkflow starts. These provide access to external data that can be used within the step’s execution. +* **inputMapping** — A list of mappings that define how parent child workflows context will be generated. +* **contextProjection** — Similar to inputMapping, but in the opposite direction — defines how outputs from the child workflow are written back into the parent workflow. // Not used anywhere +* **childWorkflowName** — A JSONata expression used to dynamically name the spawned child workflows. If not provided, the system defaults to the child workflow’s template name. +* **iterable** — Defines how the batch is constructed — typically by evaluating a JSONata expression that returns an array. It is only used with BatchSubWorkflows. + +```ts +export type TBaseSubWorkflowStepDefinition = TWorkflowBaseStepDefinition & { + type: WorkflowStepType.SYS_SUB_WORKFLOW; + mode: SubWorkflowStepMode; + childWorkflowTemplateVersionId: string; + dataSources?: TDataSourceCall[]; + inputMapping?: TMapping[]; + contextProjection?: TMapping[]; + childWorkflowName?: TExpr; +}; + +export type TSingleWorkflowStepDefinition = TBaseSubWorkflowStepDefinition & { + mode: SubWorkflowStepMode.SINGLE; +}; + +export type TBatchWorkflowStepDefinition = TBaseSubWorkflowStepDefinition & { + mode: SubWorkflowStepMode.BATCH; + iterable: TIterableProvider; +}; + +export type TSubWorkflowStepDefinition = + | TSingleWorkflowStepDefinition + | TBatchWorkflowStepDefinition; +``` + +#### Other Step type definitions :- + +```ts +export type TStartWorkflowStepDefinition = TWorkflowBaseStepDefinition & { + type: WorkflowStepType.START; +}; + +export type TEndWorkflowStepDefinition = TWorkflowBaseStepDefinition & { + type: WorkflowStepType.END; +}; + +export type TBaseHumanStepDefinition = TWorkflowBaseStepDefinition & { + type: + | WorkflowStepType.HUMAN_URL_REDIRECT + | WorkflowStepType.HUMAN_FORM + | WorkflowStepType.HUMAN_CONFIRM + | WorkflowStepType.HUMAN_DOC_UPLOAD; + // assignee: string; +}; + +export type TBaseGatewayStepDefinition = TWorkflowBaseStepDefinition & { + type: + | WorkflowStepType.GATEWAY_PARALLEL_SPLIT + | WorkflowStepType.GATEWAY_PARALLEL_JOIN + | WorkflowStepType.GATEWAY_EXCLUSIVE_SPLIT + | WorkflowStepType.GATEWAY_INCLUSIVE_SPLIT; +}; + +export type TWorkflowStepDefinition = + | TWorkflowBaseStepDefinition + | TSingleWorkflowStepDefinition + | TBatchWorkflowStepDefinition + | TStartWorkflowStepDefinition + | TEndWorkflowStepDefinition + | TBaseHumanStepDefinition + | TBaseGatewayStepDefinition; +``` + +### TStepTransition + +* **fromStepId** — The step where this transition originates. +* **toStepId** — The target step to be activated if the transition passes. +* **condition** — An optional JSONata expression (TExpr) that evaluates to a boolean value. If true, this transition is followed. +* **isDefault** — Marks this transition as the default branch, used in exclusive gateways when no other condition is met. +* **label** — Optional human-readable name or description for the edge (used in visual editors). +* **onArrival** — Allows setting some configurations like status for the arriving step. +* **ui.reactFlow.handle** — Visual metadata describing which handles (source/target anchors) this edge connects in the diagram editor. + +```ts +export type TWorkflowStepTransition = { + id: string; + fromStepId: string; + toStepId: string; + condition?: TExpr; + isDefault?: boolean; + label?: string; + onArrival?: TStepTransitionOnArrival; + ui: { + reactFlow: { + handle: { + sourceHandle: string; + targetHandle: string; + }; + }; + }; +}; + +``` + +#### TStepTransitionOnArrival + +For example, if the issue is reported from a step, the next step should be action required. + +```ts +export type TStepTransitionOnArrival = { + // Step status when this transition activates the target step + status?: WorkflowRuntimeStepStatus; +}; +``` + diff --git a/engine/workflow-builder/Workflow Builder Engg Document.md b/engine/workflow-builder/Workflow Builder Engg Document.md new file mode 100644 index 000000000..b71c358ae --- /dev/null +++ b/engine/workflow-builder/Workflow Builder Engg Document.md @@ -0,0 +1,8 @@ +All the documents listed here are related to the technical implementation of the workflow builder. + +* [Workflow Builder DSL types](https://docs.google.com/document/d/12kWBJ_LsdETiBxU2K2TzrFWzvB76YeQcQCACx_5P5sQ/edit?usp=sharing) +* [Workflow Builder Data Models](https://docs.google.com/document/d/1QgVQo-Ygrdj9kFvEizMd-Uj5oYkYwngvheY2LSuk6CQ/edit?usp=sharing) +* [Workflow Builder Definition Types](https://docs.google.com/document/d/1aJE2ifnowr41HTsbkX5efLWm__KYdSPPxcTj9tVbPAA/edit?usp=sharing) +* [Workflow Builder Runtime Types](https://docs.google.com/document/d/1qP2Oseh1zg94svyv5s1asOVRDGX6aiJTmU9jd-Ra_DU/edit?usp=sharing) +* [Rendering Service Requests using Workflow Builder](https://docs.google.com/document/d/1MK1OLS_wAWg8I8Ha8FYvOnfans1aAUZViHKgDD8M5Tc/edit?usp=sharing) +* [How to start the project locally ?](https://docs.google.com/document/d/1oF_eSqO6v8TS2ZIOls0g--PChlEInFe9AD6fHSw4RyQ/edit?usp=sharing) \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder JSON Schemas.md b/engine/workflow-builder/Workflow Builder JSON Schemas.md new file mode 100644 index 000000000..45b4da3f8 --- /dev/null +++ b/engine/workflow-builder/Workflow Builder JSON Schemas.md @@ -0,0 +1,132 @@ +## What is a JSON ? + +If a sentence is how humans describe things, JSON is how machines like it. JSON is simply a structured way to store or represent information so that computers understand it. + +Example:- +Humans: “A person has a name Ravi and age 26.” +JSON version: + +```json +{ + "name": "Ravi", + "age": 26 +} +``` + +It’s basically a list of labels and values, arranged neatly. + +## Different type of data types + +### Objects + +Think of it like a container where you can store multiple fields. Like in the above json object we are storing name and age. Start with `{ }` and put **label or key : value** pairs inside. Wrap the labels in **double quotes.** + +```json +{ + "name": "Ravi", + "age": 26 +} + +// This is wrong. +{ + name: "Ravi", + age: 26 +} +``` + +### Number + +A number is… well, a number. Just write the number without quotes. You can perform operations like 2\*3 \= 6\. + +### Strings + +A *string* is just text. Always wrap text in **double quotes.** +Example :- “Ravi”, “26” (numbers can also be treated as texts) + +If you have any number as text you will not be able to perform numeric operations on it. +2\*3 \= 6 but in case of texts “2” \* ”3” \= ?? this is not possible. + +### Boolean + +A simple true or false. + +```json +"isActive": true +``` + +### Enums + +An *enum* means “pick one from this list.” A set of **allowed choices**. + +```json +{ + "type": "string", + "enum": ["male", "female", "other"] +} +``` + +### NULL + +It means empty. Just write `null` (no quotes). + +### Array + +An *array* is like a list of things. Use `[ ]` and separate items with commas. + +```json +"fruits": ["apple", "banana", "orange"] +``` + +## What is a JSON Schema? + +When you are going to collect some information there are going to have some rules. When you are filling up a form there are some rules that are supposed to be followed like + +- Name must be a **text** +- Age must be a **number** +- Date or birth must be a **Date** + +A **JSON schema** is those rules, written for machines. + It tells the system what is allowed, what is expected, and what shape the data should follow. + +Example schema for a simple form: + +```json +{ + "type": "object", + "properties": { + "name": { "type": "string" }, + "age": { "type": "number" }, + "gender": { "type": "string", "enum": ["male", "female", "other"] } + }, + "required": ["name"] +} +``` + +### Understand the JSON Schema ? + +Three things that every json schema usually has :- + +* “type” \- Tells what the main thing is: object, array, string, etc. +* “properties” \- Lists the fields inside your object and their types. +* “required” \- Lists which fields **must** be filled. + +The above schema says that “Hey computer, expect something with a name, age and gender. Name must be text, age must be a number. And please don’t accept a blank name. (It is mentioned in required)” + +## What is a JSON Schema Builder? + +If you are not a developer, we don't want you to go write schemas like this. That is why we have a tool for it \- **JSON schema builder** that lets you make these rules **without writing code**. + +![][image1] + +Instead of typing curly braces like an engineer, you: + +* Add a field +* Choose its type (text, number, boolean, date) +* Mark if it’s required +* Set allowed values + +And the builder secretly converts your choices into the proper JSON schema behind the scenes. + +This is important because you get to define how the data should look like. It will help in creating a blueprint of data and then validate it later with the actual data. + +[image1]: \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Product Concepts.md b/engine/workflow-builder/Workflow Builder Product Concepts.md new file mode 100644 index 000000000..5fe282bd5 --- /dev/null +++ b/engine/workflow-builder/Workflow Builder Product Concepts.md @@ -0,0 +1,3 @@ +This documents includes all the concepts related to the workflow builder :- + +- [Workflow Builder JSON Schemas](https://docs.google.com/document/d/1k_1cXpBTEqpgvI3jFwRProBPzmdvAFkuhK1-WCmLO1o/edit?usp=sharing) \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Product Document.md b/engine/workflow-builder/Workflow Builder Product Document.md new file mode 100644 index 000000000..fd0c31733 --- /dev/null +++ b/engine/workflow-builder/Workflow Builder Product Document.md @@ -0,0 +1,35 @@ +# Workflow Builder Product Document + +## Overview + +Commenda provides various services such as US C Corp and India Pvt Ltd Incorporations, along with filings like Delaware Franchise Tax, IRS 1120, and Sales tax. Currently, most services are handled via service requests. However, as our service offerings expand, managing and updating these requests becomes time-consuming. Even simple task additions require extensive deployment, testing, and release efforts, proving unscalable. The Workflow Builder addresses this by enabling rapid service creation and deployment through an intuitive drag-and-drop editor. + +## Components of the workflow builder + +There are several components involved in the workflow builder. + +### Workflow Management + +In this module, you can manage your existing workflows, including creating new workflows, developing different versions, publishing, activating, and linking them to different areas of our product. You can find it on the workflow management tab in the admin. + +![][image1] + +### Workflow Editor + +This module allows you to build a specific workflow version. It provides a canvas where you can drag and drop and connect various steps (nodes) to design your workflow. Each step offers customizable configurations. + +![][image2] + +### Workflow Visualizer + +This module allows the users of the workflow to take actionable items on each step. + +![][image3] + +Next :- [Workflow Builder Product Concepts](https://docs.google.com/document/u/0/d/1k_1cXpBTEqpgvI3jFwRProBPzmdvAFkuhK1-WCmLO1o/edit) + +[image1]: + +[image2]: + +[image3]: \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Product How Tos.md b/engine/workflow-builder/Workflow Builder Product How Tos.md new file mode 100644 index 000000000..07fd91d31 --- /dev/null +++ b/engine/workflow-builder/Workflow Builder Product How Tos.md @@ -0,0 +1,3 @@ +This document includes different How To do anything in the workflow builder :- + +* [How to crearte a workflow ?](https://docs.google.com/document/d/1ocP9TYmLtpAATq8soQ6pS5Kyzx4dvBAJy8ErSdEpUM4/edit?usp=sharing) \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Root Document.md b/engine/workflow-builder/Workflow Builder Root Document.md new file mode 100644 index 000000000..78152aed6 --- /dev/null +++ b/engine/workflow-builder/Workflow Builder Root Document.md @@ -0,0 +1,16 @@ +This is the root document of the workflow builder. + +* [Workflow Builder Product Document](https://docs.google.com/document/d/1ZWFoj_pNXBb0ZxW-YHh8E9TZ25rtabquByhrmhU42OE/edit?usp=sharing) + * [Workflow Builder Product Concepts](https://docs.google.com/document/d/1YQ920StmAb90hvTrq4l96zplbMXKoknceJD7ciRP0xc/edit?usp=sharing) + * [Workflow Builder JSON Schemas](https://docs.google.com/document/d/1k_1cXpBTEqpgvI3jFwRProBPzmdvAFkuhK1-WCmLO1o/edit?usp=sharing) + * [Workflow Step Types](https://docs.google.com/document/d/1NVizA9_Bp6fODmzueUjJuTtLGNWcAi73uc0TyWxFNik/edit?usp=sharing) + * [Workflow Builder Product How Tos](https://docs.google.com/document/d/1N3CD0G6JICGZWao2t1OW-vHiCAzVRmGqqqqOrIGpl2g/edit?usp=sharing) + * [How to crearte a workflow ?](https://docs.google.com/document/d/1ocP9TYmLtpAATq8soQ6pS5Kyzx4dvBAJy8ErSdEpUM4/edit?usp=sharing) +* [Workflow Builder Engg Document](https://docs.google.com/document/d/1bPzo6eJLUayYv5a3N_M78KyIpGMnwvX3XGxmJXnSf9c/edit?usp=sharing) + * [Workflow Builder DSL types](https://docs.google.com/document/d/12kWBJ_LsdETiBxU2K2TzrFWzvB76YeQcQCACx_5P5sQ/edit?usp=sharing) + * [Workflow Builder Data Models](https://docs.google.com/document/d/1QgVQo-Ygrdj9kFvEizMd-Uj5oYkYwngvheY2LSuk6CQ/edit?usp=sharing) + * [Workflow Builder Definition Types](https://docs.google.com/document/d/1aJE2ifnowr41HTsbkX5efLWm__KYdSPPxcTj9tVbPAA/edit?usp=sharing) + * [Workflow Builder Runtime Types](https://docs.google.com/document/d/1qP2Oseh1zg94svyv5s1asOVRDGX6aiJTmU9jd-Ra_DU/edit?usp=sharing) + * [Rendering Service Requests using Workflow Builder](https://docs.google.com/document/d/1MK1OLS_wAWg8I8Ha8FYvOnfans1aAUZViHKgDD8M5Tc/edit?usp=sharing) + * [How to start the project locally ?](https://docs.google.com/document/d/1oF_eSqO6v8TS2ZIOls0g--PChlEInFe9AD6fHSw4RyQ/edit?usp=sharing) + * [Workflow Definition Validation Rules Documentation](https://docs.google.com/document/d/1m8T2VheNxZhqm9DaXRv0pdxCvdnFJmxmVAA1PDp2UOA/edit?tab=t.0#heading=h.47uxx8m7iwg0) \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Runtime Types.md b/engine/workflow-builder/Workflow Builder Runtime Types.md new file mode 100644 index 000000000..730df2298 --- /dev/null +++ b/engine/workflow-builder/Workflow Builder Runtime Types.md @@ -0,0 +1,83 @@ +# Workflow Runtime Types + +### WorkflowRuntimeStatus + +* **NOT\_STARTED** — The workflow is defined but has not yet begun execution. +* **IN\_PROGRESS** — The workflow is actively executing one or more steps. +* **COMPLETED** — All steps have finished successfully. +* **FAILED** — One or more steps have failed and the workflow cannot continue. +* **CANCELLED** — Execution was explicitly cancelled. + +### TRuntimeWorkflowExecution + +* **rootWorkflowExecutionId**: The root workflow, if child workflows trigger more child workflows. +* **parentWorkflowExecutionId**: References the execution ID of a parent workflow, if this instance was spawned as a subworkflow. +* **workflowTemplateVersionId**: Identifies which version of the workflow template was used to start this execution. +* **runtimeStatus**: The current overall status of this workflow instance. +* **startedAt / completedAt / failedAt** +* **lastActivityAt** \- Currently we only track when a step is updated. +* **context \-** stores some additional information about the workflow. Eg:- For a DSC Incorporation workflow, it would store directorId. It also acts like the global context of the workflow. “**\_\_context\_\_**” refers to the global context. +* **steps**: An object of step execution states, keyed by the step execution id. Each state is a TRuntimeWorkflowStepExecution object. + +```ts +export type TRuntimeWorkflowExecution = { + id: string; + correlationId: string; + parentWorkflowExecutionId?: string; + workflowTemplateVersionId: string; + runtimeStatus: WorkflowRuntimeStatus; + startedAt: string; + completedAt?: string; + failedAt?: string; + lastActivityAt?: string; + context: Record; + steps: Record; +}; +``` + +### WorkflowRuntimeStepStatus + +* **NOT\_STARTED** \- The step has not started till now. +* **IN\_PROGRESS** \- The step is in progress. +* **COMPLETED** \- The step is completed now. +* **DISABLED** \- The step is currently disabled. +* **FAILED** \- The step failed. + +```ts +export enum WorkflowRuntimeStepStatus { + NOT_STARTED = "NotStarted", + IN_PROGRESS = "InProgress", + COMPLETED = "Completed", + DISABLED = "Disabled", + FAILED = "Failed" +} +``` + +### + +### TRuntimeWorkflowExecution + +type \- the step type +stepId \- this is id from the definition +status \- the runtime status of the step +startedAt, completedAt, failedAt \- when the step was started, completed or failed +dueAt \- due date for this step +outputData \- the step’s output following the output schema. +childWorkflowExecutions \- all child workflows triggered in this step. + +```ts +export type TRuntimeWorkflowStepExecution = { + id: string; + type: WorkflowStepType; + stepId: string; + status: WorkflowRuntimeStepStatus; + attempt: number; + startedAt?: string; + completedAt?: string; + failedAt?: string; + dueAt?: string; + outputData?: Record; // following the outputSchema + childWorkflowExecutions?: { id: string }[]; +}; +``` + diff --git a/engine/workflow-builder/Workflow Definition Validation Rules Documentation.md b/engine/workflow-builder/Workflow Definition Validation Rules Documentation.md new file mode 100644 index 000000000..b61a85bda --- /dev/null +++ b/engine/workflow-builder/Workflow Definition Validation Rules Documentation.md @@ -0,0 +1,199 @@ +# Workflow Definition Validation Rules Documentation + +## GRAPH Rules (Topology/Structure) + +These rules validate the workflow graph structure and topology. + +#### 1\. GRAPH\_EXACTLY\_ONE\_START + +Rule: Workflow must have exactly 1 START step +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Counts START steps; fails if count ≠ 1 + +#### 2\. GRAPH\_EXACTLY\_ONE\_END + +Rule: Workflow must have exactly 1 END step +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Counts END steps; fails if count ≠ 1 + +#### 3\. START\_STEP\_NO\_INCOMING + +Rule: START step must not have any incoming transitions +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Checks incoming transitions for START steps + +#### 4\. END\_STEP\_SINGLE\_INCOMING + +Rule: END step must have exactly 1 incoming transition +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Checks incoming count for END steps + +#### 5\. END\_STEP\_NO\_OUTGOING + +Rule: END step must not have outgoing transitions +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Checks outgoing transitions for END steps + +#### 6\. TRANSITIONS\_UNIQUE + +Rule: No duplicate (from, to) transition pairs +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Ensures no duplicate (fromStepId, toStepId) pairs + +#### 7\. NO\_SELF\_LOOPS + +Rule: Self-loop transitions are not allowed +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Checks that fromStepId \!== toStepId for all transitions + +#### 8\. NO\_ISOLATED\_STEPS + +Rule: Steps with no incoming or outgoing transitions are isolated +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Checks for steps (excluding START/END) with 0 incoming and 0 outgoing + +#### 9\. ONLY\_SPLIT\_GATEWAY\_CAN\_FAN\_OUT + +Rule: Only split gateways (parallel, exclusive, inclusive) may have more than one outgoing transition +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Non-split gateway steps cannot have \>1 outgoing transitions + +#### 10\. JOIN\_GATEWAY\_MANY\_IN\_SINGLE\_OUT + +Rule: Join gateway must have at least 2 incoming transitions and exactly 1 outgoing transition +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Applies to GATEWAY\_PARALLEL\_JOIN steps + +#### 11\. CONDITIONAL\_SPLIT\_SINGLE\_DEFAULT + +Rule: Conditional split gateway must have exactly 1 default transition +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Applies to GATEWAY\_EXCLUSIVE\_SPLIT and GATEWAY\_INCLUSIVE\_SPLIT + +#### 12\. EXCLUSIVE\_SPLIT\_TWO\_OUTGOING + +Rule: Exclusive gateway must have exactly 2 outgoing transitions (1 default, 1 conditional) +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Applies to GATEWAY\_EXCLUSIVE\_SPLIT steps + +#### 13\. ONLY\_EXCLUSIVE\_INCLUSIVE\_STEP\_HAVE\_CONDITION + +Rule: Regular steps cannot have conditional transitions +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: Only exclusive/inclusive split gateways can have conditional transitions + +#### 14\. MISSING\_BATCH\_ITERATOR + +Rule: Batch workflow should have an iterator +Severity: ERROR +Error Code: GRAPH\_INVALID +Validation: BATCH mode sub-workflow steps must have an iterable property + +## ID Rules + +These rules ensure unique identifiers across workflow entities. + +#### 1\. STEP\_IDS\_UNIQUE + +Rule: Step IDs must be unique +Severity: ERROR +Error Code: ID\_INVALID +Validation: Ensures no duplicate step IDs in the workflow + +#### 2\. TRANSITION\_IDS\_UNIQUE + +Rule: Transition IDs must be unique +Severity: ERROR +Error Code: ID\_INVALID +Validation: Ensures no duplicate transition IDs + +#### 3\. STEP\_GROUP\_IDS\_UNIQUE + +Rule: Step group IDs must be unique +Severity: ERROR +Error Code: ID\_INVALID +Validation: Ensures no duplicate step group IDs + +## GROUP Rules + +These rules validate step grouping and organization. + +#### 1\. NO\_GROUP\_FOR\_SPECIAL\_NODES + +Rule: Start/end/gateways cannot be grouped +Severity: ERROR +Error Code: GROUPING\_INVALID +Validation: Only human nodes and system nodes can be grouped; START, END, and gateway steps cannot + +#### 2\. GROUP\_STEP\_IDS\_EXISTS + +Rule: Step group contains stepIds that do not reference existing steps +Severity: ERROR +Error Code: GROUPING\_INVALID +Validation: All stepIds in a stepGroup must reference existing steps + +#### 3\. STEP\_BELONGS\_TO\_ONLY\_ONE\_GROUP + +Rule: Step ID belongs to multiple groups. Each step can only belong to one group +Severity: ERROR +Error Code: GROUPING\_INVALID +Validation: Ensures each step appears in at most one stepGroup + +#### 4\. STEP\_GROUP\_CANNOT\_BE\_EMPTY + +Rule: Step group cannot be empty. Each step group must contain at least one step +Severity: ERROR +Error Code: GROUPING\_INVALID +Validation: Each stepGroup must have at least one stepId + +#### 5\. LEGACY\_SERVICE\_REQUEST\_REQUIRES\_STEP\_GROUPS + +Rule: Workflow with legacyServiceRequestType must have at least one step group +Severity: ERROR +Error Code: GROUPING\_INVALID +Validation: If legacyServiceRequestType is set, at least one stepGroup must exist + +## LEGACY\_SERVICE\_REQUEST Rules + +These rules validate legacy service request mappings and compatibility. + +#### 1\. LEGACY\_SERVICE\_REQUEST\_TYPE\_GROUP\_TASK\_UNIQUE + +Rule: Multiple steps share the same legacy combination (serviceRequestType, taskGroup, taskKey) +Severity: ERROR +Error Code: LEGACY\_CONFIG\_INVALID +Validation: The tuple (serviceRequestType, taskGroupKey, taskKey) must be unique across all steps + +#### 2\. LEGACY\_SERVICE\_REQUEST\_TASK\_GROUP\_EXISTS\_IN\_TEMPLATE + +Rule: Step group with legacyServiceRequestTaskGroupKey does not exist in serviceRequestTemplate +Severity: ERROR +Error Code: LEGACY\_CONFIG\_INVALID +Validation: StepGroups with legacyServiceRequestTaskGroupKey must exist in the service request template + +#### 3\. LEGACY\_SERVICE\_REQUEST\_TASK\_EXISTS\_IN\_TEMPLATE + +Rule: Step with legacyServiceRequestTaskKey does not exist in the corresponding taskGroup template +Severity: ERROR +Error Code: LEGACY\_CONFIG\_INVALID +Validation: Steps with legacyServiceRequestTaskKey must exist in the corresponding taskGroup's tasks in the template + +#### 4\. LEGACY\_SERVICE\_REQUEST\_TASK\_ONLY\_ON\_HUMAN\_STEP + +Rule: Only human steps can have legacyServiceRequestTask mapping +Severity: ERROR +Error Code: LEGACY\_CONFIG\_INVALID +Validation: Only human node types can have legacyServiceRequestTaskKey set diff --git a/engine/workflow-builder/Workflow Step Types.md b/engine/workflow-builder/Workflow Step Types.md new file mode 100644 index 000000000..176dfe552 --- /dev/null +++ b/engine/workflow-builder/Workflow Step Types.md @@ -0,0 +1,44 @@ +# Workflow Step Types + +### **START** + +This marks the **beginning of the workflow**. There should be exactly one start step in a workflow. + +### **END** + +This marks **the final point** of the workflow. When the workflow reaches this step, all work for that execution is complete. + +### **HUMAN\_CONFIRM** + +This step means a human just confirms that a step is completed or not before the workflow can continue. +Example: Waiting till the agent files in MCA and marks the step as completed. + +### **SYS\_SUB\_WORKFLOW** + +This step triggers another workflow inside the current workflow. It’s like saying, “Run this small process and come back when it’s done.” The system handles this automatically—no human action required. You can trigger a single and a batch of similar workflows. +Example: We would want to trigger multiple DSC workflows from an India Private Incorporation Workflow. + +### **GATEWAY\_PARALLEL\_SPLIT** + +This step tells the workflow to branch into multiple paths at the same time. +All the branches start together, in parallel. + +### **GATEWAY\_PARALLEL\_JOIN** + +This step waits for all parallel branches to finish before moving forward. +Think of it like: “We’ll continue only after everything running in parallel is completed.” + +### **GATEWAY\_BOOLEAN\_EXCLUSIVE\_SPLIT** + +This is a yes/no decision point in the workflow. +Only one path will be taken depending on the answer. + +### **GATEWAY\_INCLUSIVE\_SPLIT** + +This step allows the workflow to choose multiple paths based on conditions, not just one. +It’s flexible—one or many paths may be taken depending on the data. +Example: +If the user is new → send onboarding. +If the user is premium → send perks. +If both conditions are true → do both. + From 94cc437f0b32fc13b1770a67c86d73626340be7a Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 13:56:40 +0530 Subject: [PATCH 23/45] Update DOCUMENTATION_GENERATION_PLAN.md Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- DOCUMENTATION_GENERATION_PLAN.md | 600 +++++++++++++++++++++++++++++++ 1 file changed, 600 insertions(+) create mode 100644 DOCUMENTATION_GENERATION_PLAN.md diff --git a/DOCUMENTATION_GENERATION_PLAN.md b/DOCUMENTATION_GENERATION_PLAN.md new file mode 100644 index 000000000..e439cb7c7 --- /dev/null +++ b/DOCUMENTATION_GENERATION_PLAN.md @@ -0,0 +1,600 @@ +# Documentation Generation Plan for Workflow Builder + +## Overview +This document provides a comprehensive plan for generating documentation from source .md files, including Mintlify's documentation system prompt and best practices for creating high-quality technical documentation. + +--- + +## Mintlify Documentation System Prompt + +### Core Principles + +1. **Always prefer updating existing content over creating new content** - Search thoroughly for related documentation before creating new files +2. **Gather context first** - Always start by listing files and navigation structure to understand the existing documentation landscape +3. **Complete tasks fully** - Finish all documentation work autonomously without requiring feedback loops +4. **Follow existing conventions** - Match the style, structure, and patterns already present in the documentation +5. **ALWAYS PLAN YOUR TASKS** - Use task management to plan and track progress + +### Standard Workflow + +#### Step 1: Context Gathering (ALWAYS DO THIS FIRST) +Execute in parallel: +- List all existing files to see current documentation +- Read navigation structure to understand site organization + +#### Step 2: Investigation +Based on the task: +- Read relevant existing files to understand current documentation +- Identify patterns in file naming, structure, and navigation paths +- Determine if content should be updated or created new +- Ask clarifying questions if necessary + +#### Step 3: Content Decision +**Strongly prefer updating existing content:** +- If related documentation exists, update it rather than creating duplicates +- Only create new files when the content is genuinely new and distinct +- Check for partial matches - even tangentially related content should be updated rather than duplicated + +#### Step 4: Implementation + +**For Updates (preferred):** +1. Read the full file to understand context +2. Use edit with exact string matching (including whitespace) +3. Set `replaceAll: true` for multiple occurrences +4. Verify navigation items remain correct + +**For New Content (only when necessary):** +1. Create file with write using relative paths +2. Include proper MDX frontmatter: + ```yaml + --- + title: Clear, descriptive page title + description: Concise summary for SEO/navigation + --- + ``` +3. Modify the docs.json navigation object structure to add the new page +4. Follow existing path conventions and hierarchy + +#### Step 5: Verification +After making changes: +- Re-run read_navigation if navigation was modified +- Ensure all files are properly linked in navigation + +#### Step 6: Completion +After completing the task: +- If changes were made: A PR will be automatically created +- If no changes were made: Inform the user +- Always provide a clear, user-friendly summary +- Focus on outcomes, not process + +### Content Standards + +#### File Format +- All files are MDX with YAML frontmatter +- Follow exact formatting conventions present in existing files +- Match existing patterns for consistency + +#### Writing Requirements +- Second-person voice ("you") +- Sentence case for all headings ("Getting started", not "Getting Started") +- Active voice and direct language +- Prerequisites at start of procedural content +- Language tags on all code blocks +- Alt text on all images +- Relative paths for internal links + +#### Language Guidelines +- NO promotional language or marketing speak +- Be specific, not vague - cite sources when making claims +- Avoid excessive conjunctions (moreover, furthermore, additionally) +- No editorializing ("it's important to note") +- Use Lucide icon library for any icons + +#### Technical Accuracy +- Test all code examples before including them +- Verify all external links +- Use precise version numbers and specifications +- Maintain consistent terminology throughout + +#### Component Documentation +- Start with action-oriented language: "Use [component] to..." +- End all property descriptions with periods +- Use proper technical terminology ("boolean" not "bool") +- Keep code examples simple and practical + +### Critical Rules + +1. **Never make assumptions** - Read existing documentation to understand the technical domain +2. **Always complete tasks fully** - No TODOs or partial implementations unless explicitly requested +3. **Respect exact formatting** - When editing, match whitespace and formatting exactly +4. **Maintain navigation integrity** - Ensure all documentation is properly accessible +5. **Prioritize user success** - Document just enough for users to accomplish their goals + +--- + +## Documentation Generation Workflow for Workflow Builder + +### Phase 1: Discovery and Analysis + +#### Step 1: Locate Source Files +``` +Action: List all files in engine/workflow-builder directory +Expected: Find all 15 .md files +``` + +#### Step 2: Read All Source Files +``` +Action: Read each .md file to understand: +- Content structure +- Topics covered +- Code examples +- Relationships between files +- Technical depth +``` + +#### Step 3: Analyze Existing Documentation +``` +Action: Read engine/workflow-builder/overview.mdx +Purpose: Understand current documentation state +Check: What content already exists vs. what's new +``` + +#### Step 4: Review Navigation Structure +``` +Action: Read navigation from docs.json +Purpose: Understand where Workflow Builder fits +Check: Current navigation hierarchy for workflow-builder +``` + +### Phase 2: Content Organization + +#### Step 1: Categorize Content +Organize the 15 files into logical groups: + +**Getting Started** +- Introduction/Overview +- Quickstart guides +- Basic concepts + +**Core Concepts** +- Workflow fundamentals +- Triggers +- Actions +- Conditions +- Variables +- Data flow + +**Advanced Topics** +- Complex workflows +- Error handling +- Performance optimization +- Best practices + +**Reference** +- API documentation +- Configuration options +- Examples and templates + +#### Step 2: Create Content Hierarchy +``` +workflow-builder/ +├── overview.mdx (update existing) +├── quickstart.mdx +├── concepts/ +│ ├── workflows.mdx +│ ├── triggers.mdx +│ ├── actions.mdx +│ ├── conditions.mdx +│ └── variables.mdx +├── guides/ +│ ├── creating-workflows.mdx +│ ├── testing-workflows.mdx +│ └── deploying-workflows.mdx +├── advanced/ +│ ├── error-handling.mdx +│ ├── performance.mdx +│ └── best-practices.mdx +└── reference/ + ├── api.mdx + ├── configuration.mdx + └── examples.mdx +``` + +### Phase 3: Content Transformation + +#### Step 1: Convert .md to .mdx +For each source file: + +1. **Add YAML Frontmatter** +```yaml +--- +title: [Descriptive title from content] +description: [1-2 sentence summary] +--- +``` + +2. **Format Headings** +- Use sentence case +- Ensure proper hierarchy (h1 → h2 → h3) +- Make headings descriptive and scannable + +3. **Enhance Code Blocks** +```javascript +// Add language tags +// Add comments for clarity +// Ensure examples are complete and runnable +``` + +4. **Add Callouts Where Appropriate** +```mdx + +Important information users should know + + + +Critical warnings about potential issues + + + +Helpful tips for better results + +``` + +5. **Structure Content** +- Start with brief introduction +- Add prerequisites if needed +- Use numbered steps for procedures +- Include examples after explanations +- End with next steps or related links + +#### Step 2: Cross-Reference Content +- Link related pages together +- Create "See also" sections +- Reference API docs from guides +- Link examples to concepts + +#### Step 3: Optimize for Clarity +- Break long paragraphs into shorter ones +- Use bullet points for lists +- Add tables for comparison data +- Include diagrams where helpful (describe in alt text) + +### Phase 4: Navigation Integration + +#### Update docs.json Navigation +```json +{ + "group": "Workflow Builder", + "icon": "workflow", + "pages": [ + "engine/workflow-builder/overview", + "engine/workflow-builder/quickstart", + { + "group": "Core concepts", + "pages": [ + "engine/workflow-builder/concepts/workflows", + "engine/workflow-builder/concepts/triggers", + "engine/workflow-builder/concepts/actions", + "engine/workflow-builder/concepts/conditions", + "engine/workflow-builder/concepts/variables" + ] + }, + { + "group": "Guides", + "pages": [ + "engine/workflow-builder/guides/creating-workflows", + "engine/workflow-builder/guides/testing-workflows", + "engine/workflow-builder/guides/deploying-workflows" + ] + }, + { + "group": "Advanced", + "pages": [ + "engine/workflow-builder/advanced/error-handling", + "engine/workflow-builder/advanced/performance", + "engine/workflow-builder/advanced/best-practices" + ] + }, + { + "group": "Reference", + "pages": [ + "engine/workflow-builder/reference/api", + "engine/workflow-builder/reference/configuration", + "engine/workflow-builder/reference/examples" + ] + } + ] +} +``` + +### Phase 5: Quality Assurance + +#### Content Checklist +- [ ] All files have proper frontmatter +- [ ] All headings use sentence case +- [ ] All code blocks have language tags +- [ ] All images have alt text +- [ ] All links are relative and working +- [ ] No marketing language +- [ ] Consistent terminology throughout +- [ ] Examples are complete and tested +- [ ] Prerequisites are listed +- [ ] Next steps are provided + +#### Technical Checklist +- [ ] All files are valid MDX +- [ ] Navigation structure is correct +- [ ] File paths match navigation +- [ ] No broken internal links +- [ ] No duplicate content +- [ ] Proper hierarchy maintained + +--- + +## Best Practices for Workflow Builder Documentation + +### 1. Start with User Goals +- What does the user want to accomplish? +- What's the fastest path to success? +- What are common use cases? + +### 2. Progressive Disclosure +- Start simple, add complexity gradually +- Quickstart → Concepts → Advanced +- Don't overwhelm beginners +- Provide depth for advanced users + +### 3. Show, Don't Just Tell +```mdx + +You can create a workflow with triggers. + + +Create a workflow that sends a notification when a user signs up: + +```javascript +const workflow = { + trigger: 'user.signup', + actions: [ + { + type: 'notification', + message: 'Welcome {{user.name}}!' + } + ] +} +``` +``` + +### 4. Provide Context +- Explain WHY, not just HOW +- Show when to use different approaches +- Explain trade-offs and limitations + +### 5. Use Consistent Patterns + +**For Concepts:** +1. Brief definition +2. Why it matters +3. How it works +4. Simple example +5. Related concepts + +**For Guides:** +1. What you'll build +2. Prerequisites +3. Step-by-step instructions +4. Verification steps +5. Next steps + +**For Reference:** +1. Overview +2. Parameters/options table +3. Examples +4. Related references + +### 6. Anticipate Questions +- What could go wrong? +- What are common mistakes? +- What are the limitations? +- How does this relate to other features? + +### 7. Keep It Current +- Use current syntax and APIs +- Remove deprecated features +- Update examples to best practices +- Note version requirements + +--- + +## Template: Converting .md to .mdx + +### Input (.md file) +```markdown +# Workflow Triggers + +Triggers start workflows when events happen. + +## Types of Triggers + +- Event triggers +- Schedule triggers +- Manual triggers + +## Example + +trigger: 'user.signup' +``` + +### Output (.mdx file) +```mdx +--- +title: Workflow triggers +description: Learn how to use triggers to start workflows automatically when events occur in your application. +--- + +Triggers define when a workflow should start executing. You can configure workflows to run in response to events, on a schedule, or manually. + +## Types of triggers + +Workflow Builder supports three types of triggers: + +- **Event triggers** - Start workflows when specific events occur (e.g., user signup, payment received) +- **Schedule triggers** - Run workflows at specified times or intervals +- **Manual triggers** - Start workflows on-demand via API or UI + +## Configure an event trigger + +Set up a trigger that starts a workflow when a user signs up: + +```javascript +const workflow = { + name: 'Welcome new users', + trigger: { + type: 'event', + event: 'user.signup' + }, + actions: [ + // Actions to perform + ] +} +``` + + +Event triggers execute immediately when the event occurs. For delayed execution, use schedule triggers instead. + + +## Next steps + +- Learn about [workflow actions](/engine/workflow-builder/concepts/actions) +- See [trigger configuration reference](/engine/workflow-builder/reference/api#triggers) +- View [example workflows](/engine/workflow-builder/reference/examples) +``` + +--- + +## Execution Instructions for Another Agent + +### Prerequisites +You need access to: +- All 15 .md files in engine/workflow-builder/ +- Existing overview.mdx file +- docs.json navigation structure +- File system read/write capabilities + +### Step-by-Step Execution + +1. **Discovery Phase** +``` +- List all files in engine/workflow-builder/ +- Read each .md file and note its content +- Read existing overview.mdx +- Read current navigation structure +``` + +2. **Planning Phase** +``` +- Categorize the 15 files by topic +- Determine which content updates existing docs +- Determine which content needs new files +- Plan navigation structure +- Create task list with all files to create/update +``` + +3. **Transformation Phase** +``` +For each source .md file: + - Extract main topic and subtopics + - Determine target .mdx filename and path + - Add YAML frontmatter with title and description + - Convert markdown to MDX format + - Add language tags to code blocks + - Format headings to sentence case + - Add callouts where appropriate + - Add cross-references to related pages + - Write the .mdx file +``` + +4. **Navigation Phase** +``` +- Read current docs.json +- Update navigation structure with new pages +- Organize into logical groups +- Ensure proper hierarchy +- Write updated docs.json +``` + +5. **Verification Phase** +``` +- Verify all files created successfully +- Check navigation structure is valid +- Ensure no broken links +- Confirm all frontmatter is present +- Validate MDX syntax +``` + +6. **Completion Phase** +``` +- Provide summary of all files created/updated +- List navigation changes made +- Note any issues or decisions made +- Confirm documentation is complete +``` + +### Example Task List Format +``` +1. Read all 15 .md files ✓ +2. Analyze content and categorize ✓ +3. Update overview.mdx ✓ +4. Create quickstart.mdx ✓ +5. Create concepts/workflows.mdx ✓ +6. Create concepts/triggers.mdx ✓ +... (continue for all files) +15. Update navigation in docs.json ✓ +16. Verify all links work ✓ +``` + +--- + +## Common Pitfalls to Avoid + +1. **Don't create duplicate content** - Check existing docs first +2. **Don't skip frontmatter** - Every file needs title and description +3. **Don't use title case** - Use sentence case for headings +4. **Don't forget language tags** - All code blocks need them +5. **Don't break navigation** - Ensure paths match file locations +6. **Don't leave TODOs** - Complete all content fully +7. **Don't use marketing language** - Keep it technical and direct +8. **Don't skip examples** - Show working code +9. **Don't forget cross-references** - Link related content +10. **Don't ignore existing patterns** - Match the style of existing docs + +--- + +## Success Criteria + +Documentation is complete when: +- ✓ All 15 .md files are transformed to .mdx +- ✓ All files have proper frontmatter +- ✓ Navigation structure is updated and valid +- ✓ All code blocks have language tags +- ✓ All headings use sentence case +- ✓ Content follows Mintlify standards +- ✓ No broken links +- ✓ No duplicate content +- ✓ Logical organization and hierarchy +- ✓ Cross-references between related pages +- ✓ Examples are complete and practical +- ✓ User can navigate from overview to any topic +- ✓ Content is technically accurate +- ✓ Writing is clear and concise + +--- + +## Contact and Support + +If you encounter issues during documentation generation: +1. Review this plan thoroughly +2. Check existing documentation patterns +3. Verify file paths and navigation structure +4. Ensure all source files are accessible +5. Validate MDX syntax before writing files From 1e898b82733da32a98fd51265a69807374e1d42d Mon Sep 17 00:00:00 2001 From: Sam Suechting Date: Thu, 11 Dec 2025 14:13:51 +0530 Subject: [PATCH 24/45] Add comprehensive Workflow Builder documentation - Transform 15 source .md files into structured MDX documentation - Add overview, quickstart, concepts, guides, and reference sections - Include core concepts, step types, JSON schemas documentation - Add creating workflows and local development guides - Add DSL types, definition types, runtime types, data models references - Add validation rules and service request integration docs - Update navigation structure in docs.json - Remove source .md files after transformation --- docs.json | 29 +- .../How to crearte a workflow _.md | 86 ----- .../How to start the project locally _.md | 55 --- ...Service Requests using Workflow Builder.md | 110 ------ .../Workflow Builder DSL types.md | 132 ------- .../Workflow Builder Data Models.md | 155 -------- .../Workflow Builder Definition Types.md | 203 ----------- .../Workflow Builder Engg Document.md | 8 - .../Workflow Builder JSON Schemas.md | 132 ------- .../Workflow Builder Product Concepts.md | 3 - .../Workflow Builder Product Document.md | 35 -- .../Workflow Builder Product How Tos.md | 3 - .../Workflow Builder Root Document.md | 16 - .../Workflow Builder Runtime Types.md | 83 ----- ...finition Validation Rules Documentation.md | 199 ----------- .../workflow-builder/Workflow Step Types.md | 44 --- .../concepts/core-concepts.mdx | 172 +++++++++ .../concepts/json-schemas.mdx | 242 +++++++++++++ .../workflow-builder/concepts/step-types.mdx | 216 ++++++++++++ .../guides/creating-workflows.mdx | 291 +++++++++++++++ .../guides/local-development.mdx | 177 ++++++++++ engine/workflow-builder/overview.mdx | 85 ++++- engine/workflow-builder/quickstart.mdx | 118 +++++++ .../reference/data-models.mdx | 281 +++++++++++++++ .../reference/definition-types.mdx | 298 ++++++++++++++++ .../workflow-builder/reference/dsl-types.mdx | 236 +++++++++++++ .../reference/runtime-types.mdx | 206 +++++++++++ .../reference/service-request-integration.mdx | 231 ++++++++++++ .../reference/validation-rules.mdx | 330 ++++++++++++++++++ 29 files changed, 2906 insertions(+), 1270 deletions(-) delete mode 100644 engine/workflow-builder/How to crearte a workflow _.md delete mode 100644 engine/workflow-builder/How to start the project locally _.md delete mode 100644 engine/workflow-builder/Rendering Service Requests using Workflow Builder.md delete mode 100644 engine/workflow-builder/Workflow Builder DSL types.md delete mode 100644 engine/workflow-builder/Workflow Builder Data Models.md delete mode 100644 engine/workflow-builder/Workflow Builder Definition Types.md delete mode 100644 engine/workflow-builder/Workflow Builder Engg Document.md delete mode 100644 engine/workflow-builder/Workflow Builder JSON Schemas.md delete mode 100644 engine/workflow-builder/Workflow Builder Product Concepts.md delete mode 100644 engine/workflow-builder/Workflow Builder Product Document.md delete mode 100644 engine/workflow-builder/Workflow Builder Product How Tos.md delete mode 100644 engine/workflow-builder/Workflow Builder Root Document.md delete mode 100644 engine/workflow-builder/Workflow Builder Runtime Types.md delete mode 100644 engine/workflow-builder/Workflow Definition Validation Rules Documentation.md delete mode 100644 engine/workflow-builder/Workflow Step Types.md create mode 100644 engine/workflow-builder/concepts/core-concepts.mdx create mode 100644 engine/workflow-builder/concepts/json-schemas.mdx create mode 100644 engine/workflow-builder/concepts/step-types.mdx create mode 100644 engine/workflow-builder/guides/creating-workflows.mdx create mode 100644 engine/workflow-builder/guides/local-development.mdx create mode 100644 engine/workflow-builder/quickstart.mdx create mode 100644 engine/workflow-builder/reference/data-models.mdx create mode 100644 engine/workflow-builder/reference/definition-types.mdx create mode 100644 engine/workflow-builder/reference/dsl-types.mdx create mode 100644 engine/workflow-builder/reference/runtime-types.mdx create mode 100644 engine/workflow-builder/reference/service-request-integration.mdx create mode 100644 engine/workflow-builder/reference/validation-rules.mdx diff --git a/docs.json b/docs.json index 60e556664..c00e660c0 100644 --- a/docs.json +++ b/docs.json @@ -28,7 +28,34 @@ { "group": "Workflow Builder", "pages": [ - "engine/workflow-builder/overview" + "engine/workflow-builder/overview", + "engine/workflow-builder/quickstart", + { + "group": "Concepts", + "pages": [ + "engine/workflow-builder/concepts/core-concepts", + "engine/workflow-builder/concepts/step-types", + "engine/workflow-builder/concepts/json-schemas" + ] + }, + { + "group": "Guides", + "pages": [ + "engine/workflow-builder/guides/creating-workflows", + "engine/workflow-builder/guides/local-development" + ] + }, + { + "group": "Reference", + "pages": [ + "engine/workflow-builder/reference/dsl-types", + "engine/workflow-builder/reference/definition-types", + "engine/workflow-builder/reference/runtime-types", + "engine/workflow-builder/reference/data-models", + "engine/workflow-builder/reference/validation-rules", + "engine/workflow-builder/reference/service-request-integration" + ] + } ] }, { diff --git a/engine/workflow-builder/How to crearte a workflow _.md b/engine/workflow-builder/How to crearte a workflow _.md deleted file mode 100644 index 6b0e05e3d..000000000 --- a/engine/workflow-builder/How to crearte a workflow _.md +++ /dev/null @@ -1,86 +0,0 @@ -# How to create a workflow ? - -### **1\. Accessing Workflow Management** - -* Go to the **Admin Portal**. -* On the left sidebar, scroll to the bottom and click **Workflow Management**. -* You’ll land on a page that lists all existing workflows. -* On the top right, you’ll see two tabs: - * **Workflow Links** - * **Create Workflow** - -### **2\. Creating a New Workflow Template** - -1. Click Create Workflow. -2. A modal appears where you can enter: - * Workflow name - * Other optional fields -3. Click Create to add the new workflow. -4. The new workflow will now appear in the workflows table. - -### **3\. Opening an Existing Workflow** - -* Click any row in the workflow list. -* This opens the Workflow Detail Page for that template. -* Here you’ll see all existing versions for that workflow. -* For a newly created workflow, this section will be empty. - -### **4\. Creating a Version** - -1. On the workflow detail page, click Add Version (top right). -2. A modal appears asking for: - * Version number - * Starter version (optional) - * This lets you start from an existing version instead of building from scratch. -3. Click Create to generate the new version. -4. The system opens the Workflow Editor. - -### **5\. Using the Workflow Editor** - -Inside the editor, you will see: - -* A Steps Panel on the left, containing all available step types. -* A central Canvas where you can drag and drop steps to build your workflow. -* A Configuration Panel on the right that appears when you click any step. - -#### **Important Notes** - -* There is no autosave right now. -* Save your progress frequently using the Save button on the top right. -* When ready, click Publish. -* Newly created versions start in Draft status. -* Publishing makes the version eligible to be activated. - -### **6\. Marking a Version as Active** - -1. After publishing a version, return to the workflow’s versions list. -2. You will see an Activate Version option next to published versions. -3. Marking a version as active makes it the version used whenever this workflow is generated. - -### **7\. Understanding Workflow Links** - -Workflow links decide *how and when* a workflow is triggered. - -To access links: - -* Go back to the main workflow page. -* Click the Workflow Links tab. - -You’ll see a list of existing links. You can edit or delete these. - -#### **Creating a Workflow Link** - -1. Click Add Link. -2. A modal will open where you must select: - * Workflow Template (dropdown of all templates) - * Link Type: - * Service Request Type - * Product ID - * Identifier: - * The exact service request type or product ID -3. Save the link. - -#### How Links Work - -* When a matching service request is created, or a product with the specified ID is purchased, the system automatically triggers and generates the workflow. - diff --git a/engine/workflow-builder/How to start the project locally _.md b/engine/workflow-builder/How to start the project locally _.md deleted file mode 100644 index c0c5d1204..000000000 --- a/engine/workflow-builder/How to start the project locally _.md +++ /dev/null @@ -1,55 +0,0 @@ -# How to run the project locally ? - -1. Install the temporal CLI using - -```shell -brew install temporal -``` - -2. Clone the github repo from here \- [https://github.com/commenda-eng/commenda-temporal-dsl](https://github.com/commenda-eng/commenda-temporal-dsl) -3. Create a .env file - 1. **COMMENDA\_LOGICAL\_BACKEND\_API\_KEY \-** used to interact with the logical backend. - 2. **COMMENDA\_LOGICAL\_BACKEND\_CLIENT\_KEY** \- to validate the requests coming from the logical backend. - - -```ts -COMMENDA_TEMPORAL_BACKEND_API_KEY=RjrbIP9ZNYkuMf6ICRQLDwTdcfeoIaQU6T0DcIl3UjcXsXFC2JsrThQ6FLE8W3qk -COMMENDA_LOGICAL_BACKEND_API_KEY=5d19648dc2800784225ff909cb1682bf3d5f51d6181114eaae8ee2396320b8c2 -COMMENDA_LOGICAL_BACKEND_API_URL=http://localhost:8000/api/v1 -TEMPORAL_NAMESPACE=default -TEMPORAL_WORKER_ROLE=DSL_ENGINE -TEMPORAL_TASK_QUEUE=dsl-engine -TEMPORAL_API_KEY='xxxx' // only required for the staging and prod -TEMPORAL_ADDRESS='xxxx' // only required for the staging and prod -TEMPORAL_WORKER_BUILD_ID=1 -AWS_ACCESS_KEY_ID="Use the same from Commenda Logical Backend" -AWS_SECRET_ACCESS_KEY="Use the same from Commenda Logical Backend" -AWS_REGION=ap-south-1 -PORT=8001 -NODE_ENV=development -``` - -4. In the commenda logical backend, add the following keys - 1. **TEMPORAL\_BACKEND\_CLIENT\_KEY** \- It is used in the logical backend to validate the requests coming from the temporal-backend. - 2. **COMMENDA\_TEMPORAL\_BACKEND\_API\_KEY** \- used to interact with the temporal backend. - -```ts -COMMENDA_TEMPORAL_BACKEND_API_KEY=RjrbIP9ZNYkuMf6ICRQLDwTdcfeoIaQU6T0DcIl3UjcXsXFC2JsrThQ6FLE8W3qk -COMMENDA_TEMPORAL_BACKEND_URL=http://localhost:8001 -TEMPORAL_BACKEND_CLIENT_KEY=5d19648dc2800784225ff909cb1682bf3d5f51d6181114eaae8ee2396320b8c2 -``` - -**COMMENDA\_LOGICAL\_BACKEND\_CLIENT\_KEY** of the temporal backend should match the **COMMENDA\_TEMPORAL\_BACKEND\_API\_KEY** of the logical backend. - -**TEMPORAL\_BACKEND\_CLIENT\_KEY** of the logical backend should map to the **COMMENDA\_LOGICAL\_BACKEND\_API\_KEY** of the temporal backend. - -5. First run the “**npm run temporal:dev**”. This will start the temporal server for you on “[**http://localhost:8233**](http://localhost:8233)”. You will also see a [temporal.db](http://temporal.db) created in the root directory. This db stores all the executions. -6. Secondly, run “**npm run start:dev**”, this will just start the node project server on 8001 port. -7. Lastly, run “**npm run temporal:worker**”, this will start the temporal worker which will actually run your code, - - - -Note :- -Always remember, if you are making any changes to the environment variables, then add it on **github** and update the same in **deploy-app.yaml** file as well. - -### Now your temporal backend is up and running. \ No newline at end of file diff --git a/engine/workflow-builder/Rendering Service Requests using Workflow Builder.md b/engine/workflow-builder/Rendering Service Requests using Workflow Builder.md deleted file mode 100644 index 483a1ca78..000000000 --- a/engine/workflow-builder/Rendering Service Requests using Workflow Builder.md +++ /dev/null @@ -1,110 +0,0 @@ -# Rendering Service Request UI - -*Note:- The given method is just a temporary solution till we have a fully functional workflow powered by form builder. This is just for powering our existing service requests orchestration using workflows. **JUST ORCHESTRATION**. Other business contexts like files, assigneeType, workRequest, corporation, company etc still lie inside the serviceRequest.* - -For each **service request type**, we maintain a configuration that defines: - -* Which **task groups** exist -* Which **tasks** belong to each group - -We represent these using a TaskGroup enum and a Task enum. - -At runtime, we use this configuration to generate the **service request instances** on the backend. - -On the frontend, we have a componentMap that maps each taskKey to a React component, which is then rendered. - Examples of common components include: - -* AddBankAccount -* MarkAsCompleted - -## Workflow Executions As Source of Truth - -Whenever a service request is initiated, we try to start a **workflow execution** for it. - -* A workflow execution is started **only if** there is a workflow link associated with that service request type. -* If a workflow execution exists, it becomes the **source of truth** for task statuses. - -Ideally, we would render the service request UI **directly** from the workflow execution and remove the separate service request model. However, this is not currently possible because there is additional business context attached to the service request that workflows don’t know about (e.g. files, agentFirms, subsidiaries, corporations, etc.). - -As a result: - -* We will have **service request runtime instances** and **workflow execution runtime instances** co-existing. -* These two must be **kept in sync**. -* **Statuses** should always come from the workflow execution. - -## Syncing Task Updates - -Every time we update a task in the service request: - -1. If the service request has an associated workflow execution, we **propagate the update** to the workflow execution. -2. We wait for that update to complete and then **fetch the latest runtime statuses** from the workflow. -3. We iterate over the new statuses and build the corresponding Prisma mutations. -4. We execute those updates inside a **transaction**. - -If something fails midway (e.g. while creating or applying all mutations), we provide a **manual “Sync” button** that can be used to reconcile statuses between the service request and the workflow. - -## Mapping Workflows to Service Requests - -When creating a new workflow, you will have the option to **connect it to a service request**: - -* At the workflow level, we have a legacyServiceRequestKey. -* Within a workflow, you can create **stepGroups**. -* These stepGroups can be linked to existing taskGroups from the service request model. - -The mapping flow looks like this: - -1. **Select** the legacyServiceRequestKey. -2. **Select** the taskGroup for each stepGroup. -3. For each step, **select** the taskKey. - -Once this mapping is complete: - -* If a UI component exists for a given taskKey in componentMap, that custom component will be rendered. -* If no matching component is found, we render a **Generic Task**: - * It is assigned to an agent. - * It behaves as a “Mark as Completed” task. - -This means: - -* Any new task groups or tasks you add in the workflow that **do not** map 1:1 to existing service request tasks will fall back to the **Generic Task** UI. - -## - -## Handling Dynamic DSC Task Groups for India Pvt Ltd - -The India Pvt Ltd incorporation workflow requires dynamic task groups: each director who does not already have a DSC must go through a separate DSC onboarding flow. - -This creates a domain mismatch: - -* In the **Workflow domain**, DSC onboarding is represented as one child workflow per director. -* In the **Service Request domain**, each DSC workflow must appear as a separate task group. - -We do not yet know whether this pattern generalizes to all future workflows (child-of-child workflows, multiple step groups, etc.), so we implement a targeted, DSC-specific solution that can evolve later. - -We do the following right now :- - -* Identifies DSC-related child workflow executions. -* Creates or updates corresponding Service Request task groups. -* Links each task group to the correct workflow execution (`workflowExecutionId`). -* Ensures the group name and ordering follow the SR UI conventions. - -When the UI updates a task, we determine which workflow execution to update: - -```ts -workflowExecutionToUpdate = - serviceRequestTaskGroup.workflowExecutionId - OR serviceRequest.workflowExecutionId -``` - -If the task belongs to a DSC group, we update the **child workflow execution**. -Otherwise, we update the **parent workflow execution**. - -## Why We Are Not Generalizing Yet - -* Should all child workflows appear as Service Request task groups? -* Should child-of-child workflows be shown? -* How should workflows with multiple step groups be projected? -* Should we introduce a generic “projection type” system? - -We will revisit these once more diverse workflows are built and real patterns emerge. - diff --git a/engine/workflow-builder/Workflow Builder DSL types.md b/engine/workflow-builder/Workflow Builder DSL types.md deleted file mode 100644 index 3dcf052b9..000000000 --- a/engine/workflow-builder/Workflow Builder DSL types.md +++ /dev/null @@ -1,132 +0,0 @@ -# Workflow Builder DSL types - -## Expressions - -It will evaluate to some value. ExpressionType will decide which engine will be used for evaluation. There can be different types of expressions but currently we only support JSONATA Expressions. - -```ts -export enum ExpressionType { - JSONATA = 'jsonata', -} export type TExpr = { type: ExpressionType.JSONATA; src: string }; -``` - -### Evaluation Scope - -This is not a type. - -All the expressions are evaluated against an environment which is the Evaluation Scope. It has the following properties:. -**“\_\_context\_\_”** \- use this to access the global context. -**“\_\_steps\_\_”** \- use this to access any step’s output. Eg:- \_\_step\_\_.stepID.name -**“\_\_datasources\_\_”** \- use this to access any datasource’s output that was fetched during that step. Eg:- \_\_ds\_\_.dsID.corporation.companyLegalName -**“\_\_each\_\_”** \- use this to access each item when iterating through a collection. Eg:- \_\_each\_\_.id - -## Value Providers - -### TFieldRef - -This defines how to access any field. -Currently, there are 4 sources from where you can access the field which is defined using FieldRefSource. - -* **FieldRefSource.CONTEXT** \- Access from the global context -* **FieldRefSource.STEP** \- Access from the output of a step -* **FieldRefSource.DATASOURCE** \- Access from the output of a datasource -* **FieldRefSource.EACH** \- If you are within a loop, you can access individual item fields. - -**path** \- It should be a **dot notation string** only. It will be used to access a particular key inside the source object. This is a string and not an expression. We are using a very light lib “dot-props” for it. - -```ts -export type TFieldRef = - | { source: FieldRefSource.CONTEXT; path: string } - | { source: FieldRefSource.STEP; stepId: string; path: string } - | { source: FieldRefSource.DATASOURCE; key: string; path: string } - | { source: FieldRefSource.EACH; path: string } -``` - -### TValueProvider - -Tell us how to produce a value. You produce a value in three ways :- - -- **const**: It is a hard coded value. -- **field**: by accessing any field. -- **expr**: computing an expression against the evaluation scope. - -```ts -export type TValueProvider = -| { type: "const"; value: unknown } -| { type: "field"; ref: TFieldRef } -| { type: "expr"; expr: TExpr }; -``` - -### TParamValue - -This is used to generate the parameter values of a datasource or function which we would want to call. - -```ts -export type TParamValue = TValueProvider | { [k: string]: TParamValue } | TParamValue[]; -``` - -### TDatasourceCall - -We have data sources in our system which you can call and fetch data. Sometimes we would want to use them within our workflow. You define a datasource call using TDatasourceCall. - -```ts -export type TDataSourceCall = { - id: string; - alias: string; - type: DataSourceType.COMMENDA_LOGICAL_BACKEND; - dataSourceID: string; // from the db. - params?: TParamValue; - select?: TExpr; // Default - it will store the entire output of the data source. If you want to transform the output of the data source or store any specific field from the output. - scope?: 'per-step' | 'per-item'; // default: per-step -}; -``` - -### TIteratorProvider - -These should output an array. -**expression** \- it will evaluate the expression against the evaluation context. -**step** \- it will access the output of a step and return an array. -**datasource** \- it will access the output of a data source and return an array. The datasource would be already loaded. - -```ts -export type TIterableProvider = - | { type: IterableType.EXPRESSION; expr: TExpr } - | { type: IterableType.STEP; stepId: string; select?: TExpr } - | { type: IterableType.DATASOURCE; key: string; select?: TExpr }; -``` - -### TMapping - -Each mapping specifies where the value should be written (targetPath) and how the value should be derived (value), along with an optional mode that controls how data is written. - -* **targetPath** \- A dot-notation path (e.g., "director.id") representing where in the target object the value will be placed. -* **mode** \- defines how the data should be written. - * **set** (default): replaces or sets the value at the target path. - * **append**: used when the target is an array; appends the new value. - - - -```ts -export type TMapping = { - id: string; - targetPath: string; - value: TValueProvider; - mode?: 'set' | 'append'; -}; -``` - -Example :- - -```json -{ - "id": "map-directorId", - "targetPath": "directorId", - "value": { - "type": "expr", - "expr": { "src": "__each__.id" } - }, - "mode": "set" -} -``` - -In the above example, directorId will be set to batch item id (`__each__.id).` \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Data Models.md b/engine/workflow-builder/Workflow Builder Data Models.md deleted file mode 100644 index 001f1dedc..000000000 --- a/engine/workflow-builder/Workflow Builder Data Models.md +++ /dev/null @@ -1,155 +0,0 @@ -# Workflow Data Models - -All of this is in commenda-logical-backend. - -## Workflow Templates - -This model stores a workflow template. - -```ts -model WorkflowTemplate { - id String @id @default(cuid()) - name String - description String? - - createdAt DateTime @default(now()) - updatedAt DateTime @updatedAt - - ActiveVersion WorkflowTemplateVersion? @relation(fields: [activeVersionId], references: [id], name: "active_workflow_template_version") - activeVersionId String? @unique - - Versions WorkflowTemplateVersion[] @relation("workflow_template_has_version") - - WorkflowTemplateLinks WorkflowTemplateLink[] -} - -``` - -## Workflow Template Versions - -This model stores multiple versions of a particular template. The templates are initially created in Draft status. Only one WorkflowTemplateVersion can be linked to the workflow as the currently-active version. - -// Let’s add details here explaining how VersionStatus and ActiveWorkflowTemplate interact and exactly what each one means. - -```ts -enum WorkflowTemplateVersionStatus { - DRAFT - PUBLISHED - DEPRECATED -} - -model WorkflowTemplateVersion { - id String @id @default(cuid()) - - WorkflowTemplate WorkflowTemplate @relation(fields: [workflowTemplateId], references: [id], onDelete: Cascade, name: "workflow_template_has_version") - workflowTemplateId String - - version String // Semantic version: "1.0.0" - versionNote String? // Changelog for this version - - definition Json - - createdAt DateTime @default(now()) - updatedAt DateTime @updatedAt - - status WorkflowTemplateVersionStatus @default(DRAFT) - - // This will be filled, if this is the active version of the workflow. - ActiveWorkflowTemplate WorkflowTemplate? @relation(name: "active_workflow_template_version") - - WorkflowExecutions WorkflowExecution[] - - @@unique([workflowTemplateId, version]) -} - -``` - -## Workflow Links - -Workflow Link tells how a workflow should be triggered. There are two types of links currently. -SERVICE\_CATALOG \- If you want to link it to a specific type of service request. -PRODUCT \- If you want to link to a product from our billing software (currently Chargebee). - -So if any service request or a product is bought and a workflow link is present, an instance of the active workflow template for that workflow will be created by calling the TemporalWorkflowService API. - -```ts -enum WorkflowLinkType { - SERVICE_CATALOG - PRODUCT -} -model WorkflowTemplateLink { - id String @id @default(cuid()) - - WorkflowTemplate WorkflowTemplate @relation(fields: [workflowTemplateId], references: [id], onDelete: Cascade) - workflowTemplateId String - - entityType WorkflowLinkType - entityId String - - @@unique([entityType, entityId]) -} -``` - -## Workflow Executions - -This is a running instance of a workflow template version, corresponding to a specific service that is being delivered for a customer or a subworkflow thereof. The actual runtime state of this execution gets tracked in temporal. - -Each workflow instance is in one of the following statuses: - -* CREATED \- The instance was created and hasn’t started to run. -* STARTED \- The execution of the workflow has started. -* FAILED\_TO\_START \- The execution failed to start. -* COMPLETED \- workflow execution completed successfully. -* FAILED \- workflow execution failed. - -In the data model, - -* **workflowTemplateVersionId** \- refers to the template version used for execution. -* **parentWorkflowExecutionId** \- If this is the child execution, it will refer to the workflowExecution that triggered it. -* **rootWorkflowExecutionId** \- tracks the root workflow that eventually triggered this execution. Can be used for correlation of related requests. -* **context** \- the additional data about this workflow execution. Like directorID, if DSC. - * Within the temporal execution engine this is not used. It’s just metadata stored in the global context of the request, which the caller can use. - * Not currently getting used for anything. -* **ServiceRequest** \- The service request associated with this execution -* **ServiceRequestTaskGroup** \- task groups like DSC are also treated as child workflow execution. - -```ts - -enum WorkflowExecutionStatus { - CREATED - STARTED - FAILED_TO_START - COMPLETED -} - -// Running instance of a workflow template -model WorkflowExecution { - id String @id @default(cuid()) - - name String - - WorkflowTemplateVersion WorkflowTemplateVersion @relation(fields: [workflowTemplateVersionId], references: [id]) - workflowTemplateVersionId String - - createdAt DateTime @default(now()) - - ParentWorkflowExecution WorkflowExecution? @relation(fields: [parentWorkflowExecutionId], references: [id], onDelete: Cascade, name: "parent_workflow_execution") - parentWorkflowExecutionId String? - -rootWorkflowExecutionId String? - RootWorkflowExecution WorkflowExecution? @relation(fields: [rootWorkflowExecutionId], references: [id], onDelete: Cascade, name: "root_workflow_execution") - - context Json? - // This is not the runtime status of the workflow execution. - status WorkflowExecutionStatus @default(CREATED) - - ChildWorkflowExecutions WorkflowExecution[] @relation("parent_workflow_execution") - -DescendantWorkflowExecutionsFromRoot WorkflowExecution[] @relation("root_workflow_execution") - - ServiceRequest ServiceRequest? - ServiceRequestTaskGroup ServiceRequestTaskGroup? -} - -``` - diff --git a/engine/workflow-builder/Workflow Builder Definition Types.md b/engine/workflow-builder/Workflow Builder Definition Types.md deleted file mode 100644 index cd6868eb8..000000000 --- a/engine/workflow-builder/Workflow Builder Definition Types.md +++ /dev/null @@ -1,203 +0,0 @@ -# Workflow Builder Definition - -### TWorkflowDefinition - -* name \- name of this workflow -* steps \- steps involved in the workflow -* stepTransitions \- stores transitions between the steps -* stepGroups \- stores all the stepGroups which is just for a UI wrapper around the tasks. -* legacyServiceRequestType \- maps to the service request type. - -```ts -export type TWorkflowDefinition = { - id: string; - name: string; - steps: TWorkflowStepDefinition[]; - stepTransitions: TWorkflowStepTransition[]; - stepGroups?: TStepGroup[]; - legacyServiceRequestType?: string; -}; - -``` - -### TWorkflowStepDefintion - -#### WorkflowStepType - -* **start** — The entry point of the workflow. Each workflow must have exactly one start node. -* **end** — The terminal node of the workflow. A workflow must have exactly one end node. -* **human**.\* — Represents a step that requires human input. - * human.url\_redirect — Redirects a user to a specific URL. // Not implemented - * human.form — Presents a structured form to collect data. // Not implemented - * human.confirm — Waits for user confirmation or acknowledgment. - * human.doc\_upload — Requests a user to upload one or more documents. // Not implemented -* **sys.sub\_workflow** — A system step that invokes another workflow, either in single execution mode or in batch (iterative) mode. -* **gateway**.\* — A logical control-flow node used for routing execution. - * gateway.parallel\_split — Triggers multiple branches to run in parallel. - * gateway.parallel\_join — Waits for all incoming branches to complete before proceeding. - * gateway.exclusive\_split — Chooses exactly one outgoing path based on evaluated conditions. Condition is required only in one of the paths. - * gateway.inclusive\_split — Can trigger multiple outgoing branches if their conditions evaluate to true. - -#### TWorkflowBaseStepDefinition - -* **id** — A unique identifier for the step within the workflow. -* **type** — The type of step, one of the WorkflowStepType values. -* **name** — A human-readable label shown in the UI and logs. -* **outputSchema** — An optional JSON Schema describing the expected structure of the step’s output. This is primarily used for validation and for tooling to infer available data fields. -* **group** — Optional grouping metadata for UI organization. It includes: - * groupId — Identifier for the logical group this step belongs to. - * order — The relative position of this step within the group. -* **legacyServiceRequestTaskKey** — A backward-compatibility field linking this step to older service-request tasks. -* **activationPolicy** — An optional policy that defines the default runtime activation state for this step. -* **ui** — Contains UI metadata for the workflow designer, especially React Flow coordinates: - * reactFlow.position.x and .y — The step’s position in the visual editor canvas. - -```ts -export type TWorkflowBaseStepDefinition = { - id: string; - type: WorkflowStepType; - name: string; - outputSchema?: Record; - group?: { - groupId: string; - order: number; - }; - legacyServiceRequestTaskKey?: string; - activationPolicy?: TStepActivationPolicy; - ui: { - reactFlow: { - position: { - x: number; - y: number; - }; - }; - }; -}; -``` - -#### TStepActivationPolicy - -* **defaultStatus**: defines what the default status of the step should be while starting the step. - - -```ts -export type TStepActivationPolicy = { - defaultStatus?: WorkflowRuntimeStepStatus; -}; -``` - -#### TBaseSubWorkflowStepDefinition - -* **mode** — Defines whether the subworkflow runs once (SINGLE) or for each item in a collection (BATCH). -* **childWorkflowTemplateVersionId** — References the versioned child workflow template to execute. -* **dataSources** — A list of data source calls that can be executed before the subworkflow starts. These provide access to external data that can be used within the step’s execution. -* **inputMapping** — A list of mappings that define how parent child workflows context will be generated. -* **contextProjection** — Similar to inputMapping, but in the opposite direction — defines how outputs from the child workflow are written back into the parent workflow. // Not used anywhere -* **childWorkflowName** — A JSONata expression used to dynamically name the spawned child workflows. If not provided, the system defaults to the child workflow’s template name. -* **iterable** — Defines how the batch is constructed — typically by evaluating a JSONata expression that returns an array. It is only used with BatchSubWorkflows. - -```ts -export type TBaseSubWorkflowStepDefinition = TWorkflowBaseStepDefinition & { - type: WorkflowStepType.SYS_SUB_WORKFLOW; - mode: SubWorkflowStepMode; - childWorkflowTemplateVersionId: string; - dataSources?: TDataSourceCall[]; - inputMapping?: TMapping[]; - contextProjection?: TMapping[]; - childWorkflowName?: TExpr; -}; - -export type TSingleWorkflowStepDefinition = TBaseSubWorkflowStepDefinition & { - mode: SubWorkflowStepMode.SINGLE; -}; - -export type TBatchWorkflowStepDefinition = TBaseSubWorkflowStepDefinition & { - mode: SubWorkflowStepMode.BATCH; - iterable: TIterableProvider; -}; - -export type TSubWorkflowStepDefinition = - | TSingleWorkflowStepDefinition - | TBatchWorkflowStepDefinition; -``` - -#### Other Step type definitions :- - -```ts -export type TStartWorkflowStepDefinition = TWorkflowBaseStepDefinition & { - type: WorkflowStepType.START; -}; - -export type TEndWorkflowStepDefinition = TWorkflowBaseStepDefinition & { - type: WorkflowStepType.END; -}; - -export type TBaseHumanStepDefinition = TWorkflowBaseStepDefinition & { - type: - | WorkflowStepType.HUMAN_URL_REDIRECT - | WorkflowStepType.HUMAN_FORM - | WorkflowStepType.HUMAN_CONFIRM - | WorkflowStepType.HUMAN_DOC_UPLOAD; - // assignee: string; -}; - -export type TBaseGatewayStepDefinition = TWorkflowBaseStepDefinition & { - type: - | WorkflowStepType.GATEWAY_PARALLEL_SPLIT - | WorkflowStepType.GATEWAY_PARALLEL_JOIN - | WorkflowStepType.GATEWAY_EXCLUSIVE_SPLIT - | WorkflowStepType.GATEWAY_INCLUSIVE_SPLIT; -}; - -export type TWorkflowStepDefinition = - | TWorkflowBaseStepDefinition - | TSingleWorkflowStepDefinition - | TBatchWorkflowStepDefinition - | TStartWorkflowStepDefinition - | TEndWorkflowStepDefinition - | TBaseHumanStepDefinition - | TBaseGatewayStepDefinition; -``` - -### TStepTransition - -* **fromStepId** — The step where this transition originates. -* **toStepId** — The target step to be activated if the transition passes. -* **condition** — An optional JSONata expression (TExpr) that evaluates to a boolean value. If true, this transition is followed. -* **isDefault** — Marks this transition as the default branch, used in exclusive gateways when no other condition is met. -* **label** — Optional human-readable name or description for the edge (used in visual editors). -* **onArrival** — Allows setting some configurations like status for the arriving step. -* **ui.reactFlow.handle** — Visual metadata describing which handles (source/target anchors) this edge connects in the diagram editor. - -```ts -export type TWorkflowStepTransition = { - id: string; - fromStepId: string; - toStepId: string; - condition?: TExpr; - isDefault?: boolean; - label?: string; - onArrival?: TStepTransitionOnArrival; - ui: { - reactFlow: { - handle: { - sourceHandle: string; - targetHandle: string; - }; - }; - }; -}; - -``` - -#### TStepTransitionOnArrival - -For example, if the issue is reported from a step, the next step should be action required. - -```ts -export type TStepTransitionOnArrival = { - // Step status when this transition activates the target step - status?: WorkflowRuntimeStepStatus; -}; -``` - diff --git a/engine/workflow-builder/Workflow Builder Engg Document.md b/engine/workflow-builder/Workflow Builder Engg Document.md deleted file mode 100644 index b71c358ae..000000000 --- a/engine/workflow-builder/Workflow Builder Engg Document.md +++ /dev/null @@ -1,8 +0,0 @@ -All the documents listed here are related to the technical implementation of the workflow builder. - -* [Workflow Builder DSL types](https://docs.google.com/document/d/12kWBJ_LsdETiBxU2K2TzrFWzvB76YeQcQCACx_5P5sQ/edit?usp=sharing) -* [Workflow Builder Data Models](https://docs.google.com/document/d/1QgVQo-Ygrdj9kFvEizMd-Uj5oYkYwngvheY2LSuk6CQ/edit?usp=sharing) -* [Workflow Builder Definition Types](https://docs.google.com/document/d/1aJE2ifnowr41HTsbkX5efLWm__KYdSPPxcTj9tVbPAA/edit?usp=sharing) -* [Workflow Builder Runtime Types](https://docs.google.com/document/d/1qP2Oseh1zg94svyv5s1asOVRDGX6aiJTmU9jd-Ra_DU/edit?usp=sharing) -* [Rendering Service Requests using Workflow Builder](https://docs.google.com/document/d/1MK1OLS_wAWg8I8Ha8FYvOnfans1aAUZViHKgDD8M5Tc/edit?usp=sharing) -* [How to start the project locally ?](https://docs.google.com/document/d/1oF_eSqO6v8TS2ZIOls0g--PChlEInFe9AD6fHSw4RyQ/edit?usp=sharing) \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder JSON Schemas.md b/engine/workflow-builder/Workflow Builder JSON Schemas.md deleted file mode 100644 index 45b4da3f8..000000000 --- a/engine/workflow-builder/Workflow Builder JSON Schemas.md +++ /dev/null @@ -1,132 +0,0 @@ -## What is a JSON ? - -If a sentence is how humans describe things, JSON is how machines like it. JSON is simply a structured way to store or represent information so that computers understand it. - -Example:- -Humans: “A person has a name Ravi and age 26.” -JSON version: - -```json -{ - "name": "Ravi", - "age": 26 -} -``` - -It’s basically a list of labels and values, arranged neatly. - -## Different type of data types - -### Objects - -Think of it like a container where you can store multiple fields. Like in the above json object we are storing name and age. Start with `{ }` and put **label or key : value** pairs inside. Wrap the labels in **double quotes.** - -```json -{ - "name": "Ravi", - "age": 26 -} - -// This is wrong. -{ - name: "Ravi", - age: 26 -} -``` - -### Number - -A number is… well, a number. Just write the number without quotes. You can perform operations like 2\*3 \= 6\. - -### Strings - -A *string* is just text. Always wrap text in **double quotes.** -Example :- “Ravi”, “26” (numbers can also be treated as texts) - -If you have any number as text you will not be able to perform numeric operations on it. -2\*3 \= 6 but in case of texts “2” \* ”3” \= ?? this is not possible. - -### Boolean - -A simple true or false. - -```json -"isActive": true -``` - -### Enums - -An *enum* means “pick one from this list.” A set of **allowed choices**. - -```json -{ - "type": "string", - "enum": ["male", "female", "other"] -} -``` - -### NULL - -It means empty. Just write `null` (no quotes). - -### Array - -An *array* is like a list of things. Use `[ ]` and separate items with commas. - -```json -"fruits": ["apple", "banana", "orange"] -``` - -## What is a JSON Schema? - -When you are going to collect some information there are going to have some rules. When you are filling up a form there are some rules that are supposed to be followed like - -- Name must be a **text** -- Age must be a **number** -- Date or birth must be a **Date** - -A **JSON schema** is those rules, written for machines. - It tells the system what is allowed, what is expected, and what shape the data should follow. - -Example schema for a simple form: - -```json -{ - "type": "object", - "properties": { - "name": { "type": "string" }, - "age": { "type": "number" }, - "gender": { "type": "string", "enum": ["male", "female", "other"] } - }, - "required": ["name"] -} -``` - -### Understand the JSON Schema ? - -Three things that every json schema usually has :- - -* “type” \- Tells what the main thing is: object, array, string, etc. -* “properties” \- Lists the fields inside your object and their types. -* “required” \- Lists which fields **must** be filled. - -The above schema says that “Hey computer, expect something with a name, age and gender. Name must be text, age must be a number. And please don’t accept a blank name. (It is mentioned in required)” - -## What is a JSON Schema Builder? - -If you are not a developer, we don't want you to go write schemas like this. That is why we have a tool for it \- **JSON schema builder** that lets you make these rules **without writing code**. - -![][image1] - -Instead of typing curly braces like an engineer, you: - -* Add a field -* Choose its type (text, number, boolean, date) -* Mark if it’s required -* Set allowed values - -And the builder secretly converts your choices into the proper JSON schema behind the scenes. - -This is important because you get to define how the data should look like. It will help in creating a blueprint of data and then validate it later with the actual data. - -[image1]: \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Product Concepts.md b/engine/workflow-builder/Workflow Builder Product Concepts.md deleted file mode 100644 index 5fe282bd5..000000000 --- a/engine/workflow-builder/Workflow Builder Product Concepts.md +++ /dev/null @@ -1,3 +0,0 @@ -This documents includes all the concepts related to the workflow builder :- - -- [Workflow Builder JSON Schemas](https://docs.google.com/document/d/1k_1cXpBTEqpgvI3jFwRProBPzmdvAFkuhK1-WCmLO1o/edit?usp=sharing) \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Product Document.md b/engine/workflow-builder/Workflow Builder Product Document.md deleted file mode 100644 index fd0c31733..000000000 --- a/engine/workflow-builder/Workflow Builder Product Document.md +++ /dev/null @@ -1,35 +0,0 @@ -# Workflow Builder Product Document - -## Overview - -Commenda provides various services such as US C Corp and India Pvt Ltd Incorporations, along with filings like Delaware Franchise Tax, IRS 1120, and Sales tax. Currently, most services are handled via service requests. However, as our service offerings expand, managing and updating these requests becomes time-consuming. Even simple task additions require extensive deployment, testing, and release efforts, proving unscalable. The Workflow Builder addresses this by enabling rapid service creation and deployment through an intuitive drag-and-drop editor. - -## Components of the workflow builder - -There are several components involved in the workflow builder. - -### Workflow Management - -In this module, you can manage your existing workflows, including creating new workflows, developing different versions, publishing, activating, and linking them to different areas of our product. You can find it on the workflow management tab in the admin. - -![][image1] - -### Workflow Editor - -This module allows you to build a specific workflow version. It provides a canvas where you can drag and drop and connect various steps (nodes) to design your workflow. Each step offers customizable configurations. - -![][image2] - -### Workflow Visualizer - -This module allows the users of the workflow to take actionable items on each step. - -![][image3] - -Next :- [Workflow Builder Product Concepts](https://docs.google.com/document/u/0/d/1k_1cXpBTEqpgvI3jFwRProBPzmdvAFkuhK1-WCmLO1o/edit) - -[image1]: - -[image2]: - -[image3]: \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Product How Tos.md b/engine/workflow-builder/Workflow Builder Product How Tos.md deleted file mode 100644 index 07fd91d31..000000000 --- a/engine/workflow-builder/Workflow Builder Product How Tos.md +++ /dev/null @@ -1,3 +0,0 @@ -This document includes different How To do anything in the workflow builder :- - -* [How to crearte a workflow ?](https://docs.google.com/document/d/1ocP9TYmLtpAATq8soQ6pS5Kyzx4dvBAJy8ErSdEpUM4/edit?usp=sharing) \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Root Document.md b/engine/workflow-builder/Workflow Builder Root Document.md deleted file mode 100644 index 78152aed6..000000000 --- a/engine/workflow-builder/Workflow Builder Root Document.md +++ /dev/null @@ -1,16 +0,0 @@ -This is the root document of the workflow builder. - -* [Workflow Builder Product Document](https://docs.google.com/document/d/1ZWFoj_pNXBb0ZxW-YHh8E9TZ25rtabquByhrmhU42OE/edit?usp=sharing) - * [Workflow Builder Product Concepts](https://docs.google.com/document/d/1YQ920StmAb90hvTrq4l96zplbMXKoknceJD7ciRP0xc/edit?usp=sharing) - * [Workflow Builder JSON Schemas](https://docs.google.com/document/d/1k_1cXpBTEqpgvI3jFwRProBPzmdvAFkuhK1-WCmLO1o/edit?usp=sharing) - * [Workflow Step Types](https://docs.google.com/document/d/1NVizA9_Bp6fODmzueUjJuTtLGNWcAi73uc0TyWxFNik/edit?usp=sharing) - * [Workflow Builder Product How Tos](https://docs.google.com/document/d/1N3CD0G6JICGZWao2t1OW-vHiCAzVRmGqqqqOrIGpl2g/edit?usp=sharing) - * [How to crearte a workflow ?](https://docs.google.com/document/d/1ocP9TYmLtpAATq8soQ6pS5Kyzx4dvBAJy8ErSdEpUM4/edit?usp=sharing) -* [Workflow Builder Engg Document](https://docs.google.com/document/d/1bPzo6eJLUayYv5a3N_M78KyIpGMnwvX3XGxmJXnSf9c/edit?usp=sharing) - * [Workflow Builder DSL types](https://docs.google.com/document/d/12kWBJ_LsdETiBxU2K2TzrFWzvB76YeQcQCACx_5P5sQ/edit?usp=sharing) - * [Workflow Builder Data Models](https://docs.google.com/document/d/1QgVQo-Ygrdj9kFvEizMd-Uj5oYkYwngvheY2LSuk6CQ/edit?usp=sharing) - * [Workflow Builder Definition Types](https://docs.google.com/document/d/1aJE2ifnowr41HTsbkX5efLWm__KYdSPPxcTj9tVbPAA/edit?usp=sharing) - * [Workflow Builder Runtime Types](https://docs.google.com/document/d/1qP2Oseh1zg94svyv5s1asOVRDGX6aiJTmU9jd-Ra_DU/edit?usp=sharing) - * [Rendering Service Requests using Workflow Builder](https://docs.google.com/document/d/1MK1OLS_wAWg8I8Ha8FYvOnfans1aAUZViHKgDD8M5Tc/edit?usp=sharing) - * [How to start the project locally ?](https://docs.google.com/document/d/1oF_eSqO6v8TS2ZIOls0g--PChlEInFe9AD6fHSw4RyQ/edit?usp=sharing) - * [Workflow Definition Validation Rules Documentation](https://docs.google.com/document/d/1m8T2VheNxZhqm9DaXRv0pdxCvdnFJmxmVAA1PDp2UOA/edit?tab=t.0#heading=h.47uxx8m7iwg0) \ No newline at end of file diff --git a/engine/workflow-builder/Workflow Builder Runtime Types.md b/engine/workflow-builder/Workflow Builder Runtime Types.md deleted file mode 100644 index 730df2298..000000000 --- a/engine/workflow-builder/Workflow Builder Runtime Types.md +++ /dev/null @@ -1,83 +0,0 @@ -# Workflow Runtime Types - -### WorkflowRuntimeStatus - -* **NOT\_STARTED** — The workflow is defined but has not yet begun execution. -* **IN\_PROGRESS** — The workflow is actively executing one or more steps. -* **COMPLETED** — All steps have finished successfully. -* **FAILED** — One or more steps have failed and the workflow cannot continue. -* **CANCELLED** — Execution was explicitly cancelled. - -### TRuntimeWorkflowExecution - -* **rootWorkflowExecutionId**: The root workflow, if child workflows trigger more child workflows. -* **parentWorkflowExecutionId**: References the execution ID of a parent workflow, if this instance was spawned as a subworkflow. -* **workflowTemplateVersionId**: Identifies which version of the workflow template was used to start this execution. -* **runtimeStatus**: The current overall status of this workflow instance. -* **startedAt / completedAt / failedAt** -* **lastActivityAt** \- Currently we only track when a step is updated. -* **context \-** stores some additional information about the workflow. Eg:- For a DSC Incorporation workflow, it would store directorId. It also acts like the global context of the workflow. “**\_\_context\_\_**” refers to the global context. -* **steps**: An object of step execution states, keyed by the step execution id. Each state is a TRuntimeWorkflowStepExecution object. - -```ts -export type TRuntimeWorkflowExecution = { - id: string; - correlationId: string; - parentWorkflowExecutionId?: string; - workflowTemplateVersionId: string; - runtimeStatus: WorkflowRuntimeStatus; - startedAt: string; - completedAt?: string; - failedAt?: string; - lastActivityAt?: string; - context: Record; - steps: Record; -}; -``` - -### WorkflowRuntimeStepStatus - -* **NOT\_STARTED** \- The step has not started till now. -* **IN\_PROGRESS** \- The step is in progress. -* **COMPLETED** \- The step is completed now. -* **DISABLED** \- The step is currently disabled. -* **FAILED** \- The step failed. - -```ts -export enum WorkflowRuntimeStepStatus { - NOT_STARTED = "NotStarted", - IN_PROGRESS = "InProgress", - COMPLETED = "Completed", - DISABLED = "Disabled", - FAILED = "Failed" -} -``` - -### - -### TRuntimeWorkflowExecution - -type \- the step type -stepId \- this is id from the definition -status \- the runtime status of the step -startedAt, completedAt, failedAt \- when the step was started, completed or failed -dueAt \- due date for this step -outputData \- the step’s output following the output schema. -childWorkflowExecutions \- all child workflows triggered in this step. - -```ts -export type TRuntimeWorkflowStepExecution = { - id: string; - type: WorkflowStepType; - stepId: string; - status: WorkflowRuntimeStepStatus; - attempt: number; - startedAt?: string; - completedAt?: string; - failedAt?: string; - dueAt?: string; - outputData?: Record; // following the outputSchema - childWorkflowExecutions?: { id: string }[]; -}; -``` - diff --git a/engine/workflow-builder/Workflow Definition Validation Rules Documentation.md b/engine/workflow-builder/Workflow Definition Validation Rules Documentation.md deleted file mode 100644 index b61a85bda..000000000 --- a/engine/workflow-builder/Workflow Definition Validation Rules Documentation.md +++ /dev/null @@ -1,199 +0,0 @@ -# Workflow Definition Validation Rules Documentation - -## GRAPH Rules (Topology/Structure) - -These rules validate the workflow graph structure and topology. - -#### 1\. GRAPH\_EXACTLY\_ONE\_START - -Rule: Workflow must have exactly 1 START step -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Counts START steps; fails if count ≠ 1 - -#### 2\. GRAPH\_EXACTLY\_ONE\_END - -Rule: Workflow must have exactly 1 END step -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Counts END steps; fails if count ≠ 1 - -#### 3\. START\_STEP\_NO\_INCOMING - -Rule: START step must not have any incoming transitions -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Checks incoming transitions for START steps - -#### 4\. END\_STEP\_SINGLE\_INCOMING - -Rule: END step must have exactly 1 incoming transition -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Checks incoming count for END steps - -#### 5\. END\_STEP\_NO\_OUTGOING - -Rule: END step must not have outgoing transitions -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Checks outgoing transitions for END steps - -#### 6\. TRANSITIONS\_UNIQUE - -Rule: No duplicate (from, to) transition pairs -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Ensures no duplicate (fromStepId, toStepId) pairs - -#### 7\. NO\_SELF\_LOOPS - -Rule: Self-loop transitions are not allowed -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Checks that fromStepId \!== toStepId for all transitions - -#### 8\. NO\_ISOLATED\_STEPS - -Rule: Steps with no incoming or outgoing transitions are isolated -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Checks for steps (excluding START/END) with 0 incoming and 0 outgoing - -#### 9\. ONLY\_SPLIT\_GATEWAY\_CAN\_FAN\_OUT - -Rule: Only split gateways (parallel, exclusive, inclusive) may have more than one outgoing transition -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Non-split gateway steps cannot have \>1 outgoing transitions - -#### 10\. JOIN\_GATEWAY\_MANY\_IN\_SINGLE\_OUT - -Rule: Join gateway must have at least 2 incoming transitions and exactly 1 outgoing transition -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Applies to GATEWAY\_PARALLEL\_JOIN steps - -#### 11\. CONDITIONAL\_SPLIT\_SINGLE\_DEFAULT - -Rule: Conditional split gateway must have exactly 1 default transition -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Applies to GATEWAY\_EXCLUSIVE\_SPLIT and GATEWAY\_INCLUSIVE\_SPLIT - -#### 12\. EXCLUSIVE\_SPLIT\_TWO\_OUTGOING - -Rule: Exclusive gateway must have exactly 2 outgoing transitions (1 default, 1 conditional) -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Applies to GATEWAY\_EXCLUSIVE\_SPLIT steps - -#### 13\. ONLY\_EXCLUSIVE\_INCLUSIVE\_STEP\_HAVE\_CONDITION - -Rule: Regular steps cannot have conditional transitions -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: Only exclusive/inclusive split gateways can have conditional transitions - -#### 14\. MISSING\_BATCH\_ITERATOR - -Rule: Batch workflow should have an iterator -Severity: ERROR -Error Code: GRAPH\_INVALID -Validation: BATCH mode sub-workflow steps must have an iterable property - -## ID Rules - -These rules ensure unique identifiers across workflow entities. - -#### 1\. STEP\_IDS\_UNIQUE - -Rule: Step IDs must be unique -Severity: ERROR -Error Code: ID\_INVALID -Validation: Ensures no duplicate step IDs in the workflow - -#### 2\. TRANSITION\_IDS\_UNIQUE - -Rule: Transition IDs must be unique -Severity: ERROR -Error Code: ID\_INVALID -Validation: Ensures no duplicate transition IDs - -#### 3\. STEP\_GROUP\_IDS\_UNIQUE - -Rule: Step group IDs must be unique -Severity: ERROR -Error Code: ID\_INVALID -Validation: Ensures no duplicate step group IDs - -## GROUP Rules - -These rules validate step grouping and organization. - -#### 1\. NO\_GROUP\_FOR\_SPECIAL\_NODES - -Rule: Start/end/gateways cannot be grouped -Severity: ERROR -Error Code: GROUPING\_INVALID -Validation: Only human nodes and system nodes can be grouped; START, END, and gateway steps cannot - -#### 2\. GROUP\_STEP\_IDS\_EXISTS - -Rule: Step group contains stepIds that do not reference existing steps -Severity: ERROR -Error Code: GROUPING\_INVALID -Validation: All stepIds in a stepGroup must reference existing steps - -#### 3\. STEP\_BELONGS\_TO\_ONLY\_ONE\_GROUP - -Rule: Step ID belongs to multiple groups. Each step can only belong to one group -Severity: ERROR -Error Code: GROUPING\_INVALID -Validation: Ensures each step appears in at most one stepGroup - -#### 4\. STEP\_GROUP\_CANNOT\_BE\_EMPTY - -Rule: Step group cannot be empty. Each step group must contain at least one step -Severity: ERROR -Error Code: GROUPING\_INVALID -Validation: Each stepGroup must have at least one stepId - -#### 5\. LEGACY\_SERVICE\_REQUEST\_REQUIRES\_STEP\_GROUPS - -Rule: Workflow with legacyServiceRequestType must have at least one step group -Severity: ERROR -Error Code: GROUPING\_INVALID -Validation: If legacyServiceRequestType is set, at least one stepGroup must exist - -## LEGACY\_SERVICE\_REQUEST Rules - -These rules validate legacy service request mappings and compatibility. - -#### 1\. LEGACY\_SERVICE\_REQUEST\_TYPE\_GROUP\_TASK\_UNIQUE - -Rule: Multiple steps share the same legacy combination (serviceRequestType, taskGroup, taskKey) -Severity: ERROR -Error Code: LEGACY\_CONFIG\_INVALID -Validation: The tuple (serviceRequestType, taskGroupKey, taskKey) must be unique across all steps - -#### 2\. LEGACY\_SERVICE\_REQUEST\_TASK\_GROUP\_EXISTS\_IN\_TEMPLATE - -Rule: Step group with legacyServiceRequestTaskGroupKey does not exist in serviceRequestTemplate -Severity: ERROR -Error Code: LEGACY\_CONFIG\_INVALID -Validation: StepGroups with legacyServiceRequestTaskGroupKey must exist in the service request template - -#### 3\. LEGACY\_SERVICE\_REQUEST\_TASK\_EXISTS\_IN\_TEMPLATE - -Rule: Step with legacyServiceRequestTaskKey does not exist in the corresponding taskGroup template -Severity: ERROR -Error Code: LEGACY\_CONFIG\_INVALID -Validation: Steps with legacyServiceRequestTaskKey must exist in the corresponding taskGroup's tasks in the template - -#### 4\. LEGACY\_SERVICE\_REQUEST\_TASK\_ONLY\_ON\_HUMAN\_STEP - -Rule: Only human steps can have legacyServiceRequestTask mapping -Severity: ERROR -Error Code: LEGACY\_CONFIG\_INVALID -Validation: Only human node types can have legacyServiceRequestTaskKey set diff --git a/engine/workflow-builder/Workflow Step Types.md b/engine/workflow-builder/Workflow Step Types.md deleted file mode 100644 index 176dfe552..000000000 --- a/engine/workflow-builder/Workflow Step Types.md +++ /dev/null @@ -1,44 +0,0 @@ -# Workflow Step Types - -### **START** - -This marks the **beginning of the workflow**. There should be exactly one start step in a workflow. - -### **END** - -This marks **the final point** of the workflow. When the workflow reaches this step, all work for that execution is complete. - -### **HUMAN\_CONFIRM** - -This step means a human just confirms that a step is completed or not before the workflow can continue. -Example: Waiting till the agent files in MCA and marks the step as completed. - -### **SYS\_SUB\_WORKFLOW** - -This step triggers another workflow inside the current workflow. It’s like saying, “Run this small process and come back when it’s done.” The system handles this automatically—no human action required. You can trigger a single and a batch of similar workflows. -Example: We would want to trigger multiple DSC workflows from an India Private Incorporation Workflow. - -### **GATEWAY\_PARALLEL\_SPLIT** - -This step tells the workflow to branch into multiple paths at the same time. -All the branches start together, in parallel. - -### **GATEWAY\_PARALLEL\_JOIN** - -This step waits for all parallel branches to finish before moving forward. -Think of it like: “We’ll continue only after everything running in parallel is completed.” - -### **GATEWAY\_BOOLEAN\_EXCLUSIVE\_SPLIT** - -This is a yes/no decision point in the workflow. -Only one path will be taken depending on the answer. - -### **GATEWAY\_INCLUSIVE\_SPLIT** - -This step allows the workflow to choose multiple paths based on conditions, not just one. -It’s flexible—one or many paths may be taken depending on the data. -Example: -If the user is new → send onboarding. -If the user is premium → send perks. -If both conditions are true → do both. - diff --git a/engine/workflow-builder/concepts/core-concepts.mdx b/engine/workflow-builder/concepts/core-concepts.mdx new file mode 100644 index 000000000..239559a19 --- /dev/null +++ b/engine/workflow-builder/concepts/core-concepts.mdx @@ -0,0 +1,172 @@ +--- +title: 'Core concepts' +description: 'Understand the fundamental building blocks of Workflow Builder' +icon: 'book' +--- + +This guide explains the core concepts you need to understand when working with Workflow Builder. + +## Workflow templates + +A workflow template is a reusable definition of a business process. Templates contain: + +- **Name and description** - Human-readable identifiers +- **Steps** - Individual units of work +- **Transitions** - Connections between steps +- **Step groups** - Logical groupings for UI organization + +Templates support multiple versions, allowing you to iterate on designs while maintaining stable production workflows. + +## Workflow versions + +Each template can have multiple versions with different statuses: + +| Status | Description | +|--------|-------------| +| **DRAFT** | In development, can be edited | +| **PUBLISHED** | Ready to be activated, cannot be edited | +| **DEPRECATED** | No longer recommended for use | + +Only one version can be **active** at a time. When a workflow is triggered, the active version is used. + +## Workflow executions + +An execution is a running instance of a workflow template version. Each execution tracks: + +- **Runtime status** - Current state (NOT_STARTED, IN_PROGRESS, COMPLETED, FAILED, CANCELLED) +- **Step states** - Status of each step in the execution +- **Context** - Data passed into and generated by the workflow +- **Timestamps** - When the execution started, completed, or failed + +## Workflow links + +Links determine when workflows are triggered automatically: + +- **SERVICE_CATALOG** - Triggered when a specific service request type is created +- **PRODUCT** - Triggered when a specific product is purchased + +## Expressions and evaluation + +Workflow Builder uses [JSONata](https://jsonata.org/) expressions for dynamic values and conditions. + +### Evaluation scope + +All expressions are evaluated against an environment with these properties: + +| Variable | Description | Example | +|----------|-------------|---------| +| `__context__` | Access the global workflow context | `__context__.customerId` | +| `__steps__` | Access any step's output | `__steps__.stepId.name` | +| `__datasources__` | Access fetched datasource outputs | `__datasources__.dsId.data` | +| `__each__` | Access current item in iterations | `__each__.id` | + +### Example expression + +```jsonata +__context__.customer.type = 'premium' and __steps__.verification.approved = true +``` + +## Value providers + +Value providers define how to produce a value in mappings and configurations: + +### Constant value + +A hardcoded value: + +```json +{ + "type": "const", + "value": "Hello World" +} +``` + +### Field reference + +Access a value from context, step output, datasource, or iteration: + +```json +{ + "type": "field", + "ref": { + "source": "CONTEXT", + "path": "customer.email" + } +} +``` + +### Expression + +Compute a value using JSONata: + +```json +{ + "type": "expr", + "expr": { + "type": "jsonata", + "src": "__context__.firstName & ' ' & __context__.lastName" + } +} +``` + +## Mappings + +Mappings define how to transform and assign values: + +```json +{ + "id": "map-customer-name", + "targetPath": "customerName", + "value": { + "type": "expr", + "expr": { "src": "__context__.customer.fullName" } + }, + "mode": "set" +} +``` + +| Property | Description | +|----------|-------------| +| `targetPath` | Dot-notation path for the destination | +| `value` | Value provider defining the source | +| `mode` | `set` (replace) or `append` (for arrays) | + +## Datasource calls + +Fetch external data during workflow execution: + +```json +{ + "id": "fetch-customer", + "alias": "customer", + "type": "COMMENDA_LOGICAL_BACKEND", + "dataSourceID": "ds-customer-api", + "params": { + "customerId": { + "type": "field", + "ref": { "source": "CONTEXT", "path": "customerId" } + } + }, + "select": { "type": "jsonata", "src": "$.data" }, + "scope": "per-step" +} +``` + +| Property | Description | +|----------|-------------| +| `dataSourceID` | Reference to the datasource definition | +| `params` | Parameters to pass to the datasource | +| `select` | Transform the response (optional) | +| `scope` | `per-step` or `per-item` for batch workflows | + +## Next steps + + + + Learn about all available step types + + + Understand data validation with schemas + + + diff --git a/engine/workflow-builder/concepts/json-schemas.mdx b/engine/workflow-builder/concepts/json-schemas.mdx new file mode 100644 index 000000000..a2b7f129d --- /dev/null +++ b/engine/workflow-builder/concepts/json-schemas.mdx @@ -0,0 +1,242 @@ +--- +title: 'JSON schemas' +description: 'Define and validate data structures using JSON Schema' +icon: 'brackets-curly' +--- + +JSON Schema is used in Workflow Builder to define the expected structure of step outputs and validate data throughout workflow execution. + +## What is JSON? + +JSON (JavaScript Object Notation) is a structured way to represent information that computers can easily understand. + +**Human language:** "A person has a name Ravi and age 26." + +**JSON version:** + +```json +{ + "name": "Ravi", + "age": 26 +} +``` + +## Data types + +### Objects + +Containers for multiple fields using `{ }` with key-value pairs: + +```json +{ + "name": "Ravi", + "age": 26 +} +``` + + +Keys must be wrapped in double quotes. This is invalid: +```json +{ name: "Ravi" } +``` + + +### Numbers + +Numeric values without quotes: + +```json +{ + "age": 26, + "price": 99.99 +} +``` + +### Strings + +Text values wrapped in double quotes: + +```json +{ + "name": "Ravi", + "city": "Mumbai" +} +``` + +### Booleans + +Simple true/false values: + +```json +{ + "isActive": true, + "isVerified": false +} +``` + +### Arrays + +Lists of values using `[ ]`: + +```json +{ + "fruits": ["apple", "banana", "orange"], + "numbers": [1, 2, 3] +} +``` + +### Null + +Empty or undefined values: + +```json +{ + "middleName": null +} +``` + +## What is JSON Schema? + +A JSON Schema defines the rules and structure that data must follow. Think of it as a blueprint that tells the system: + +- What fields are expected +- What type each field should be +- Which fields are required + +### Example schema + +```json +{ + "type": "object", + "properties": { + "name": { "type": "string" }, + "age": { "type": "number" }, + "gender": { + "type": "string", + "enum": ["male", "female", "other"] + } + }, + "required": ["name"] +} +``` + +This schema says: +- Expect an object with `name`, `age`, and `gender` fields +- `name` must be a string and is required +- `age` must be a number +- `gender` must be one of the allowed values + +## Key schema properties + +| Property | Description | +|----------|-------------| +| `type` | The data type (object, array, string, number, boolean) | +| `properties` | Field definitions for objects | +| `required` | Array of required field names | +| `enum` | Allowed values for a field | +| `items` | Schema for array elements | + +## Using schemas in workflows + +### Output schemas + +Define the expected output structure for steps: + +```json +{ + "type": "SYS_SUB_WORKFLOW", + "name": "Verify Customer", + "outputSchema": { + "type": "object", + "properties": { + "verified": { "type": "boolean" }, + "verificationId": { "type": "string" } + }, + "required": ["verified"] + } +} +``` + +### Validation + +Output schemas are used for: + +- **Validation** - Ensure step outputs match expected structure +- **Tooling** - Help the editor infer available data fields +- **Documentation** - Self-documenting workflow definitions + +## JSON Schema builder + +For non-developers, Workflow Builder includes a visual JSON Schema Builder that lets you create schemas without writing code: + +1. Add a field +2. Choose its type (text, number, boolean, date) +3. Mark if it's required +4. Set allowed values (for enums) + +The builder converts your choices into proper JSON Schema automatically. + +## Common patterns + +### Nested objects + +```json +{ + "type": "object", + "properties": { + "customer": { + "type": "object", + "properties": { + "name": { "type": "string" }, + "email": { "type": "string" } + } + } + } +} +``` + +### Arrays of objects + +```json +{ + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "type": "object", + "properties": { + "id": { "type": "string" }, + "quantity": { "type": "number" } + } + } + } + } +} +``` + +### Optional fields with defaults + +```json +{ + "type": "object", + "properties": { + "status": { + "type": "string", + "default": "pending" + } + } +} +``` + +## Next steps + + + + Learn about the workflow DSL type system + + + Understand workflow validation + + + diff --git a/engine/workflow-builder/concepts/step-types.mdx b/engine/workflow-builder/concepts/step-types.mdx new file mode 100644 index 000000000..5286d6dc8 --- /dev/null +++ b/engine/workflow-builder/concepts/step-types.mdx @@ -0,0 +1,216 @@ +--- +title: 'Step types' +description: 'Learn about the different types of steps available in Workflow Builder' +icon: 'shapes' +--- + +Workflow Builder provides several step types to handle different aspects of your business processes. + +## Control flow steps + +### START + +The entry point of every workflow. Each workflow must have exactly one START step. + +- No incoming transitions allowed +- Exactly one outgoing transition required + +``` +┌─────────┐ +│ START │───▶ (next step) +└─────────┘ +``` + +### END + +The terminal point of every workflow. When execution reaches this step, the workflow is complete. + +- Exactly one incoming transition required +- No outgoing transitions allowed + +``` +(previous step) ───▶ ┌─────────┐ + │ END │ + └─────────┘ +``` + +## Human steps + +### HUMAN_CONFIRM + +A step that waits for human confirmation before the workflow can continue. The assigned person must explicitly mark the step as completed. + +**Use cases:** +- Waiting for an agent to complete a manual task +- Requiring approval before proceeding +- Confirming external actions are done + +``` +┌─────────────────┐ +│ HUMAN_CONFIRM │ +│ │ +│ "Verify docs" │ +└─────────────────┘ +``` + + +Additional human step types like `HUMAN_FORM`, `HUMAN_URL_REDIRECT`, and `HUMAN_DOC_UPLOAD` are planned but not yet implemented. + + +## System steps + +### SYS_SUB_WORKFLOW + +Triggers another workflow (child workflow) from within the current workflow. Supports two modes: + +#### Single mode + +Execute one child workflow: + +```json +{ + "type": "SYS_SUB_WORKFLOW", + "mode": "SINGLE", + "childWorkflowTemplateVersionId": "version-123", + "inputMapping": [...] +} +``` + +#### Batch mode + +Execute multiple child workflows by iterating over a collection: + +```json +{ + "type": "SYS_SUB_WORKFLOW", + "mode": "BATCH", + "childWorkflowTemplateVersionId": "version-123", + "iterable": { + "type": "EXPRESSION", + "expr": { "src": "__context__.directors" } + }, + "inputMapping": [...] +} +``` + +**Use case:** Trigger multiple DSC workflows from an India Private Incorporation workflow, one for each director. + +## Gateway steps + +Gateways control the flow of execution through branching and merging. + +### GATEWAY_PARALLEL_SPLIT + +Branches the workflow into multiple paths that execute simultaneously. + +``` + ┌───▶ Path A ───┐ + │ │ +───▶ [PARALLEL] ────┼───▶ Path B ───┼───▶ + [ SPLIT ] │ │ + └───▶ Path C ───┘ +``` + +- All outgoing paths start at the same time +- Must be paired with a GATEWAY_PARALLEL_JOIN + +### GATEWAY_PARALLEL_JOIN + +Waits for all incoming parallel branches to complete before proceeding. + +``` + Path A ───┐ + │ + Path B ───┼───▶ [PARALLEL] ───▶ + │ [ JOIN ] + Path C ───┘ +``` + +- Requires at least 2 incoming transitions +- Exactly 1 outgoing transition + +### GATEWAY_EXCLUSIVE_SPLIT + +A yes/no decision point where exactly one path is taken based on a condition. + +``` + ┌───▶ Yes path (condition = true) + │ +───▶ [EXCLUSIVE] ───┤ + [ SPLIT ] │ + └───▶ No path (default) +``` + +**Requirements:** +- Exactly 2 outgoing transitions +- One transition must have a condition +- One transition must be marked as default + +**Example condition:** + +```jsonata +__context__.customer.verified = true +``` + +### GATEWAY_INCLUSIVE_SPLIT + +A flexible decision point where multiple paths can be taken based on conditions. + +``` + ┌───▶ Path A (if condition A) + │ +───▶ [INCLUSIVE] ───┼───▶ Path B (if condition B) + [ SPLIT ] │ + └───▶ Default path +``` + +**Use case:** Send different notifications based on user attributes: +- If user is new → send onboarding email +- If user is premium → send perks notification +- If both conditions are true → do both + +## Step configuration + +All steps share these base properties: + +| Property | Description | +|----------|-------------| +| `id` | Unique identifier within the workflow | +| `type` | The step type | +| `name` | Human-readable label | +| `outputSchema` | JSON Schema for step output validation | +| `group` | Grouping metadata (groupId, order) | +| `activationPolicy` | Default runtime activation state | +| `ui.reactFlow.position` | Visual editor coordinates (x, y) | + +## Step groups + +Steps can be organized into logical groups for UI presentation: + +```json +{ + "stepGroups": [ + { + "id": "group-verification", + "name": "Verification", + "stepIds": ["step-1", "step-2", "step-3"] + } + ] +} +``` + + +START, END, and gateway steps cannot be added to groups. Only human and system steps can be grouped. + + +## Next steps + + + + Step-by-step workflow creation guide + + + Technical reference for step definitions + + + diff --git a/engine/workflow-builder/guides/creating-workflows.mdx b/engine/workflow-builder/guides/creating-workflows.mdx new file mode 100644 index 000000000..5150aa34d --- /dev/null +++ b/engine/workflow-builder/guides/creating-workflows.mdx @@ -0,0 +1,291 @@ +--- +title: 'Creating workflows' +description: 'Detailed guide for building workflows with Workflow Builder' +icon: 'hammer' +--- + +This guide provides detailed instructions for creating effective workflows using the Workflow Builder. + +## Planning your workflow + +Before building, consider: + +1. **What process are you automating?** - Map out the business process +2. **What are the steps involved?** - Identify each action or decision point +3. **Who needs to act?** - Determine human vs. automated steps +4. **What conditions exist?** - Identify branching logic +5. **What data flows through?** - Plan data requirements + +## Accessing workflow management + +1. Navigate to the **Admin Portal** +2. Click **Workflow Management** in the left sidebar +3. You'll see all existing workflows listed + +## Creating a template + +1. Click **Create Workflow** (top right) +2. Enter workflow details: + - **Name** - Descriptive identifier + - **Description** - Purpose and scope +3. Click **Create** + +## Version management + +### Creating a version + +1. Open a workflow from the list +2. Click **Add Version** +3. Configure: + - **Version number** - Use semantic versioning (e.g., "1.0.0") + - **Starter version** - Optionally copy from existing version +4. Click **Create** to open the editor + +### Version lifecycle + +``` +DRAFT → PUBLISHED → ACTIVE + │ │ + └── (edit allowed) └── (in production) +``` + +## Using the workflow editor + +### Interface overview + +| Panel | Location | Purpose | +|-------|----------|---------| +| Steps Panel | Left | Available step types | +| Canvas | Center | Visual workflow design | +| Configuration | Right | Step settings | + +### Adding steps + +1. **Drag** a step type from the Steps Panel +2. **Drop** it onto the Canvas +3. **Click** the step to configure + +### Connecting steps + +1. Hover over a step to reveal handles +2. **Drag** from the source handle +3. **Drop** on the target step's input handle +4. A transition line appears + +### Configuring steps + +When you select a step, the Configuration Panel shows: + +- **Basic info** - Name, ID, description +- **Step-specific settings** - Varies by type +- **Output schema** - Expected output structure +- **Group assignment** - UI organization + +## Building step flows + +### Linear flow + +The simplest pattern - steps execute one after another: + +``` +START → Task 1 → Task 2 → Task 3 → END +``` + +### Conditional branching + +Use exclusive split for yes/no decisions: + +``` +START → Check Status → [EXCLUSIVE SPLIT] + │ + ┌─────────┴─────────┐ + ▼ ▼ + (approved) (rejected) + │ │ + Process Notify + │ │ + └─────────┬─────────┘ + ▼ + END +``` + +**Configuration:** +1. Add `GATEWAY_EXCLUSIVE_SPLIT` +2. Create two outgoing transitions +3. Set condition on one: `__context__.status = 'approved'` +4. Mark the other as default + +### Parallel execution + +Run multiple paths simultaneously: + +``` +START → [PARALLEL SPLIT] + │ + ┌─────────┼─────────┐ + ▼ ▼ ▼ + Task A Task B Task C + │ │ │ + └─────────┼─────────┘ + ▼ + [PARALLEL JOIN] → END +``` + +**Configuration:** +1. Add `GATEWAY_PARALLEL_SPLIT` +2. Connect to all parallel tasks +3. Connect all tasks to `GATEWAY_PARALLEL_JOIN` +4. Connect join to next step + +### Sub-workflows + +Execute child workflows for modular design: + +#### Single sub-workflow + +```json +{ + "type": "SYS_SUB_WORKFLOW", + "mode": "SINGLE", + "childWorkflowTemplateVersionId": "child-version-id", + "inputMapping": [ + { + "targetPath": "customerId", + "value": { + "type": "field", + "ref": { "source": "CONTEXT", "path": "customer.id" } + } + } + ] +} +``` + +#### Batch sub-workflows + +For iterating over a collection: + +```json +{ + "type": "SYS_SUB_WORKFLOW", + "mode": "BATCH", + "childWorkflowTemplateVersionId": "child-version-id", + "iterable": { + "type": "EXPRESSION", + "expr": { "src": "__context__.directors" } + }, + "inputMapping": [ + { + "targetPath": "directorId", + "value": { + "type": "expr", + "expr": { "src": "__each__.id" } + } + } + ] +} +``` + +## Working with data + +### Accessing context data + +Use `__context__` to access workflow context: + +```jsonata +__context__.customer.email +``` + +### Accessing step outputs + +Use `__steps__` to access previous step results: + +```jsonata +__steps__.verificationStep.approved +``` + +### Accessing datasources + +Use `__datasources__` after fetching data: + +```jsonata +__datasources__.customerData.profile.name +``` + +### In batch iterations + +Use `__each__` to access the current item: + +```jsonata +__each__.id +``` + +## Saving and publishing + + +**No autosave!** Save frequently using the **Save** button. + + +### Save workflow + +Click **Save** (top right) to preserve your work. + +### Publish version + +1. Review your workflow design +2. Click **Publish** +3. Status changes to **Published** + +### Activate version + +1. Return to the versions list +2. Click **Activate Version** on your published version +3. This version is now used for new executions + +## Setting up triggers + +### Service request triggers + +1. Go to **Workflow Links** tab +2. Click **Add Link** +3. Select: + - **Link Type**: Service Request Type + - **Identifier**: The service request type +4. Save + +### Product triggers + +1. Go to **Workflow Links** tab +2. Click **Add Link** +3. Select: + - **Link Type**: Product ID + - **Identifier**: The product ID from billing +4. Save + +## Best practices + + + + Begin with a basic flow and add complexity incrementally. + + + Organize related steps into logical groups for clarity. + + + Use descriptive names for steps and transitions. + + + Test each version before publishing to production. + + + +## Next steps + + + + Set up local development environment + + + Understand workflow validation + + + diff --git a/engine/workflow-builder/guides/local-development.mdx b/engine/workflow-builder/guides/local-development.mdx new file mode 100644 index 000000000..6e2bf67c9 --- /dev/null +++ b/engine/workflow-builder/guides/local-development.mdx @@ -0,0 +1,177 @@ +--- +title: 'Local development' +description: 'Set up your local environment for Workflow Builder development' +icon: 'laptop-code' +--- + +This guide explains how to set up and run the Workflow Builder project locally for development. + +## Prerequisites + +- Node.js installed +- Homebrew (for macOS) +- Access to the commenda-temporal-dsl repository + +## Step 1: Install Temporal CLI + +Install the Temporal CLI using Homebrew: + +```bash +brew install temporal +``` + +## Step 2: Clone the repository + +```bash +git clone https://github.com/commenda-eng/commenda-temporal-dsl +cd commenda-temporal-dsl +``` + +## Step 3: Configure environment variables + +Create a `.env` file in the project root with the following variables: + +```bash +# API Keys for service communication +COMMENDA_TEMPORAL_BACKEND_API_KEY=your-temporal-backend-api-key +COMMENDA_LOGICAL_BACKEND_API_KEY=your-logical-backend-api-key +COMMENDA_LOGICAL_BACKEND_API_URL=http://localhost:8000/api/v1 + +# Temporal configuration +TEMPORAL_NAMESPACE=default +TEMPORAL_WORKER_ROLE=DSL_ENGINE +TEMPORAL_TASK_QUEUE=dsl-engine +TEMPORAL_WORKER_BUILD_ID=1 + +# Required only for staging/production +# TEMPORAL_API_KEY=xxxx +# TEMPORAL_ADDRESS=xxxx + +# AWS configuration (same as Commenda Logical Backend) +AWS_ACCESS_KEY_ID=your-aws-access-key +AWS_SECRET_ACCESS_KEY=your-aws-secret-key +AWS_REGION=ap-south-1 + +# Server configuration +PORT=8001 +NODE_ENV=development +``` + +## Step 4: Configure logical backend + +In the Commenda Logical Backend, add these environment variables: + +```bash +COMMENDA_TEMPORAL_BACKEND_API_KEY=your-temporal-backend-api-key +COMMENDA_TEMPORAL_BACKEND_URL=http://localhost:8001 +TEMPORAL_BACKEND_CLIENT_KEY=your-logical-backend-api-key +``` + + +**API Key matching is critical:** +- `COMMENDA_LOGICAL_BACKEND_API_KEY` (temporal) must match `COMMENDA_TEMPORAL_BACKEND_API_KEY` (logical) +- `TEMPORAL_BACKEND_CLIENT_KEY` (logical) must match `COMMENDA_LOGICAL_BACKEND_API_KEY` (temporal) + + +## Step 5: Start the services + +Start the services in this order: + +### 1. Start Temporal server + +```bash +npm run temporal:dev +``` + +This starts the Temporal server at `http://localhost:8233`. A `temporal.db` file is created in the root directory to store executions. + +### 2. Start the Node.js server + +```bash +npm run start:dev +``` + +This starts the backend server on port 8001. + +### 3. Start the Temporal worker + +```bash +npm run temporal:worker +``` + +This starts the worker that executes your workflow code. + +## Service architecture + +``` +┌─────────────────────────────────────────────────────────┐ +│ Local Development │ +│ │ +│ ┌──────────────┐ ┌──────────────┐ ┌───────────┐ │ +│ │ Temporal │ │ Node.js │ │ Temporal │ │ +│ │ Server │◀──▶│ Server │◀──▶│ Worker │ │ +│ │ :8233 │ │ :8001 │ │ │ │ +│ └──────────────┘ └──────────────┘ └───────────┘ │ +│ │ │ │ +│ │ ▼ │ +│ │ ┌──────────────┐ │ +│ │ │ Logical │ │ +│ │ │ Backend │ │ +│ │ │ :8000 │ │ +│ │ └──────────────┘ │ +│ ▼ │ +│ ┌──────────────┐ │ +│ │ temporal.db │ │ +│ └──────────────┘ │ +└─────────────────────────────────────────────────────────┘ +``` + +## Temporal UI + +Access the Temporal UI at `http://localhost:8233` to: + +- View workflow executions +- Inspect workflow history +- Debug execution issues +- Monitor worker activity + +## Updating environment variables + + +When modifying environment variables: +1. Update them locally in `.env` +2. Add to GitHub secrets +3. Update `deploy-app.yaml` for deployments + + +## Troubleshooting + +### Temporal server won't start + +- Check if port 8233 is available +- Verify Temporal CLI installation: `temporal --version` +- Check for existing `temporal.db` corruption (delete and restart) + +### Worker not connecting + +- Ensure Temporal server is running first +- Verify `TEMPORAL_TASK_QUEUE` matches across services +- Check network connectivity between services + +### API key errors + +- Double-check key matching between services +- Ensure no whitespace in key values +- Verify keys are properly exported in environment + +## Next steps + + + + Understand the database schema + + + Learn the workflow DSL type system + + + diff --git a/engine/workflow-builder/overview.mdx b/engine/workflow-builder/overview.mdx index 2275e2113..d39f85a36 100644 --- a/engine/workflow-builder/overview.mdx +++ b/engine/workflow-builder/overview.mdx @@ -1,14 +1,89 @@ --- title: 'Workflow Builder' -description: 'Create and manage automated workflows' +description: 'Build automated workflows to orchestrate complex business processes and streamline operations' icon: 'diagram-project' --- -## Overview +The Workflow Builder is a powerful visual tool for creating and managing automated workflows that orchestrate your business processes. It enables you to define complex multi-step processes, handle conditional logic, and integrate with external systems. -The Workflow Builder allows you to create automated workflows to streamline your sales tax compliance processes. +## What is Workflow Builder? -## Getting Started +Workflow Builder allows you to: -Get started by creating your first workflow in the dashboard. +- **Design visual workflows** using a drag-and-drop canvas interface +- **Define step types** including human tasks, system operations, and decision gateways +- **Create conditional logic** with exclusive and inclusive branching +- **Orchestrate sub-workflows** for modular, reusable process design +- **Manage versions** with draft, published, and active states +## Key concepts + + + + Individual units of work in a workflow, including start/end points, human tasks, system tasks, and gateways. + + + Connections between steps that define the flow of execution, optionally with conditions. + + + Reusable workflow definitions that can be versioned and activated. + + + Running instances of workflow templates that track progress and state. + + + +## Workflow architecture + +``` +┌─────────────────────────────────────────────────────────────┐ +│ Workflow Template │ +│ ┌─────────┐ ┌──────────┐ ┌─────────┐ ┌─────────┐ │ +│ │ START │───▶│ Task 1 │───▶│ Gateway │───▶│ END │ │ +│ └─────────┘ └──────────┘ └────┬────┘ └─────────┘ │ +│ │ │ +│ ▼ │ +│ ┌──────────┐ │ +│ │ Task 2 │ │ +│ └──────────┘ │ +└─────────────────────────────────────────────────────────────┘ +``` + +## Step types + +| Type | Description | +|------|-------------| +| **START** | Entry point of the workflow (exactly one required) | +| **END** | Terminal point of the workflow (exactly one required) | +| **HUMAN_CONFIRM** | Waits for human confirmation before continuing | +| **SYS_SUB_WORKFLOW** | Triggers child workflows (single or batch mode) | +| **GATEWAY_PARALLEL_SPLIT** | Branches into multiple parallel paths | +| **GATEWAY_PARALLEL_JOIN** | Waits for all parallel branches to complete | +| **GATEWAY_EXCLUSIVE_SPLIT** | Yes/no decision point (one path taken) | +| **GATEWAY_INCLUSIVE_SPLIT** | Multiple paths based on conditions | + +## Workflow lifecycle + +1. **Create template** - Define a new workflow template with name and description +2. **Add version** - Create a version in draft status +3. **Design workflow** - Use the visual editor to add steps and transitions +4. **Publish version** - Mark the version ready for activation +5. **Activate version** - Set as the active version for new executions +6. **Link triggers** - Connect to service request types or products + +## Next steps + + + + Create your first workflow in minutes + + + Deep dive into workflow concepts + + + Learn about available step types + + + Technical reference for workflow DSL + + diff --git a/engine/workflow-builder/quickstart.mdx b/engine/workflow-builder/quickstart.mdx new file mode 100644 index 000000000..32dba2ea9 --- /dev/null +++ b/engine/workflow-builder/quickstart.mdx @@ -0,0 +1,118 @@ +--- +title: 'Quickstart' +description: 'Create your first workflow in the Workflow Builder' +icon: 'rocket' +--- + +This guide walks you through creating, publishing, and activating your first workflow. + +## Prerequisites + +- Access to the Admin Portal +- Appropriate permissions for workflow management + +## Step 1: Access workflow management + +1. Go to the **Admin Portal** +2. In the left sidebar, scroll to the bottom and click **Workflow Management** +3. You'll see a page listing all existing workflows +4. At the top right, you'll find two tabs: + - **Workflow Links** - Configure triggers + - **Create Workflow** - Create new templates + +## Step 2: Create a workflow template + +1. Click **Create Workflow** +2. In the modal that appears, enter: + - **Workflow name** - A descriptive name for your workflow + - Other optional fields as needed +3. Click **Create** to add the new workflow +4. The new workflow appears in the workflows table + +## Step 3: Create a version + +1. Click any row in the workflow list to open the **Workflow Detail Page** +2. Click **Add Version** (top right) +3. In the modal, enter: + - **Version number** - Semantic version (e.g., "1.0.0") + - **Starter version** (optional) - Copy from an existing version +4. Click **Create** to generate the new version +5. The system opens the **Workflow Editor** + +## Step 4: Design your workflow + +Inside the editor, you'll see: + +- **Steps Panel** (left) - All available step types +- **Canvas** (center) - Drag and drop steps here +- **Configuration Panel** (right) - Appears when you click any step + +### Add steps + +1. Drag a step type from the Steps Panel onto the Canvas +2. Click the step to configure it in the Configuration Panel +3. Connect steps by dragging from output handles to input handles + +### Configure transitions + +1. Click on a transition line to select it +2. For conditional gateways, set the condition expression +3. Mark one transition as the default for exclusive/inclusive splits + + +There is no autosave. Save your progress frequently using the **Save** button (top right). + + +## Step 5: Publish your version + +1. Review your workflow design +2. Click **Publish** (top right) +3. The version status changes from **Draft** to **Published** + + +Newly created versions start in **Draft** status. Publishing makes the version eligible to be activated. + + +## Step 6: Activate the version + +1. Return to the workflow's versions list +2. Find the published version +3. Click **Activate Version** +4. This version is now used whenever this workflow is triggered + +## Step 7: Create workflow links + +Workflow links determine how and when a workflow is triggered. + +### Access workflow links + +1. Go to the main workflow page +2. Click the **Workflow Links** tab +3. View, edit, or delete existing links + +### Create a new link + +1. Click **Add Link** +2. In the modal, select: + - **Workflow Template** - Choose from all templates + - **Link Type**: + - **Service Request Type** - Trigger on specific service requests + - **Product ID** - Trigger when a product is purchased + - **Identifier** - The specific service request type or product ID +3. Click **Save** + + +When a matching service request is created or a product with the specified ID is purchased, the system automatically generates and starts the workflow. + + +## Next steps + + + + Learn about workflow fundamentals + + + Explore all available step types + + + diff --git a/engine/workflow-builder/reference/data-models.mdx b/engine/workflow-builder/reference/data-models.mdx new file mode 100644 index 000000000..5e228d586 --- /dev/null +++ b/engine/workflow-builder/reference/data-models.mdx @@ -0,0 +1,281 @@ +--- +title: 'Data models' +description: 'Database schema reference for Workflow Builder' +icon: 'database' +--- + +This reference documents the database models used by Workflow Builder in the Commenda Logical Backend. + +## WorkflowTemplate + +Stores workflow template definitions: + +```prisma +model WorkflowTemplate { + id String @id @default(cuid()) + name String + description String? + + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + ActiveVersion WorkflowTemplateVersion? @relation( + fields: [activeVersionId], + references: [id], + name: "active_workflow_template_version" + ) + activeVersionId String? @unique + + Versions WorkflowTemplateVersion[] @relation("workflow_template_has_version") + WorkflowTemplateLinks WorkflowTemplateLink[] +} +``` + +| Field | Description | +|-------|-------------| +| `id` | Unique identifier | +| `name` | Template name | +| `description` | Optional description | +| `activeVersionId` | Currently active version | +| `Versions` | All versions of this template | +| `WorkflowTemplateLinks` | Trigger configurations | + +## WorkflowTemplateVersion + +Stores versions of workflow templates: + +```prisma +enum WorkflowTemplateVersionStatus { + DRAFT + PUBLISHED + DEPRECATED +} + +model WorkflowTemplateVersion { + id String @id @default(cuid()) + + WorkflowTemplate WorkflowTemplate @relation( + fields: [workflowTemplateId], + references: [id], + onDelete: Cascade, + name: "workflow_template_has_version" + ) + workflowTemplateId String + + version String + versionNote String? + definition Json + + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + status WorkflowTemplateVersionStatus @default(DRAFT) + + ActiveWorkflowTemplate WorkflowTemplate? @relation( + name: "active_workflow_template_version" + ) + + WorkflowExecutions WorkflowExecution[] + + @@unique([workflowTemplateId, version]) +} +``` + +| Field | Description | +|-------|-------------| +| `id` | Unique identifier | +| `workflowTemplateId` | Parent template reference | +| `version` | Semantic version (e.g., "1.0.0") | +| `versionNote` | Changelog for this version | +| `definition` | JSON workflow definition | +| `status` | DRAFT, PUBLISHED, or DEPRECATED | + +### Version status lifecycle + +``` +DRAFT → PUBLISHED → (activate) → Active + │ │ + │ └──→ DEPRECATED + │ + └── (edit allowed) +``` + +- **DRAFT** - Can be edited, not yet ready for production +- **PUBLISHED** - Ready to be activated, cannot be edited +- **DEPRECATED** - No longer recommended for use + + +Only one version can be linked as the active version for a template at a time. + + +## WorkflowTemplateLink + +Defines how workflows are triggered: + +```prisma +enum WorkflowLinkType { + SERVICE_CATALOG + PRODUCT +} + +model WorkflowTemplateLink { + id String @id @default(cuid()) + + WorkflowTemplate WorkflowTemplate @relation( + fields: [workflowTemplateId], + references: [id], + onDelete: Cascade + ) + workflowTemplateId String + + entityType WorkflowLinkType + entityId String + + @@unique([entityType, entityId]) +} +``` + +| Field | Description | +|-------|-------------| +| `workflowTemplateId` | Template to trigger | +| `entityType` | SERVICE_CATALOG or PRODUCT | +| `entityId` | Service request type or product ID | + +### Link types + +| Type | Trigger condition | +|------|-------------------| +| `SERVICE_CATALOG` | When a specific service request type is created | +| `PRODUCT` | When a specific product is purchased (from billing) | + +When a matching entity is created/purchased and a workflow link exists, the active version of the linked template is automatically instantiated. + +## WorkflowExecution + +Represents a running workflow instance: + +```prisma +enum WorkflowExecutionStatus { + CREATED + STARTED + FAILED_TO_START + COMPLETED +} + +model WorkflowExecution { + id String @id @default(cuid()) + name String + + WorkflowTemplateVersion WorkflowTemplateVersion @relation( + fields: [workflowTemplateVersionId], + references: [id] + ) + workflowTemplateVersionId String + + createdAt DateTime @default(now()) + + ParentWorkflowExecution WorkflowExecution? @relation( + fields: [parentWorkflowExecutionId], + references: [id], + onDelete: Cascade, + name: "parent_workflow_execution" + ) + parentWorkflowExecutionId String? + + RootWorkflowExecution WorkflowExecution? @relation( + fields: [rootWorkflowExecutionId], + references: [id], + onDelete: Cascade, + name: "root_workflow_execution" + ) + rootWorkflowExecutionId String? + + context Json? + status WorkflowExecutionStatus @default(CREATED) + + ChildWorkflowExecutions WorkflowExecution[] @relation("parent_workflow_execution") + DescendantWorkflowExecutionsFromRoot WorkflowExecution[] @relation("root_workflow_execution") + + ServiceRequest ServiceRequest? + ServiceRequestTaskGroup ServiceRequestTaskGroup? +} +``` + +| Field | Description | +|-------|-------------| +| `id` | Unique execution identifier | +| `name` | Execution name | +| `workflowTemplateVersionId` | Template version being executed | +| `parentWorkflowExecutionId` | Parent execution (for sub-workflows) | +| `rootWorkflowExecutionId` | Root execution (for correlation) | +| `context` | Metadata and global context | +| `status` | Execution lifecycle status | + +### Execution status + +| Status | Description | +|--------|-------------| +| `CREATED` | Instance created, not yet started | +| `STARTED` | Execution has begun | +| `FAILED_TO_START` | Execution failed to start | +| `COMPLETED` | Execution finished successfully | + + +The `status` field tracks the database record lifecycle, not the runtime status. Runtime status is tracked in Temporal. + + +### Context field + +The `context` field stores: + +- **Workflow metadata** - e.g., `directorId` for DSC workflows +- **Global context** - Accessible via `__context__` in expressions + +Note: This context is separate from the Temporal runtime context. + +### Hierarchy relationships + +``` +Root Execution + │ + ├── Child Execution 1 (parentWorkflowExecutionId = root) + │ │ + │ └── Grandchild Execution (rootWorkflowExecutionId = root) + │ + └── Child Execution 2 (parentWorkflowExecutionId = root) +``` + +- `parentWorkflowExecutionId` - Direct parent +- `rootWorkflowExecutionId` - Ultimate ancestor (for correlation) + +## Entity relationships + +``` +┌──────────────────┐ +│ WorkflowTemplate │ +└────────┬─────────┘ + │ 1:N + ▼ +┌────────────────────────┐ ┌─────────────────────┐ +│ WorkflowTemplateVersion│──────│ WorkflowTemplateLink│ +└────────┬───────────────┘ └─────────────────────┘ + │ 1:N + ▼ +┌───────────────────┐ +│ WorkflowExecution │──┐ +└───────────────────┘ │ + ▲ │ (parent/child) + └─────────────┘ +``` + +## Next steps + + + + Definition validation rules + + + Legacy service request mapping + + + diff --git a/engine/workflow-builder/reference/definition-types.mdx b/engine/workflow-builder/reference/definition-types.mdx new file mode 100644 index 000000000..955e0ce0c --- /dev/null +++ b/engine/workflow-builder/reference/definition-types.mdx @@ -0,0 +1,298 @@ +--- +title: 'Definition types' +description: 'Technical reference for workflow definition structures' +icon: 'file-code' +--- + +This reference documents the types used to define workflows. + +## TWorkflowDefinition + +The root type for a workflow definition: + +```typescript +export type TWorkflowDefinition = { + id: string; + name: string; + steps: TWorkflowStepDefinition[]; + stepTransitions: TWorkflowStepTransition[]; + stepGroups?: TStepGroup[]; + legacyServiceRequestType?: string; +}; +``` + +| Property | Description | +|----------|-------------| +| `id` | Unique identifier | +| `name` | Human-readable name | +| `steps` | Array of step definitions | +| `stepTransitions` | Connections between steps | +| `stepGroups` | UI groupings for steps | +| `legacyServiceRequestType` | Maps to service request type | + +## Step definitions + +### TWorkflowBaseStepDefinition + +Base properties shared by all steps: + +```typescript +export type TWorkflowBaseStepDefinition = { + id: string; + type: WorkflowStepType; + name: string; + outputSchema?: Record; + group?: { + groupId: string; + order: number; + }; + legacyServiceRequestTaskKey?: string; + activationPolicy?: TStepActivationPolicy; + ui: { + reactFlow: { + position: { + x: number; + y: number; + }; + }; + }; +}; +``` + +| Property | Description | +|----------|-------------| +| `id` | Unique step identifier | +| `type` | Step type enum value | +| `name` | Display label | +| `outputSchema` | JSON Schema for output validation | +| `group` | Grouping metadata | +| `legacyServiceRequestTaskKey` | Legacy task mapping | +| `activationPolicy` | Default activation state | +| `ui.reactFlow.position` | Visual editor coordinates | + +### TStepActivationPolicy + +```typescript +export type TStepActivationPolicy = { + defaultStatus?: WorkflowRuntimeStepStatus; +}; +``` + +### Control flow steps + +```typescript +export type TStartWorkflowStepDefinition = TWorkflowBaseStepDefinition & { + type: WorkflowStepType.START; +}; + +export type TEndWorkflowStepDefinition = TWorkflowBaseStepDefinition & { + type: WorkflowStepType.END; +}; +``` + +### Human steps + +```typescript +export type TBaseHumanStepDefinition = TWorkflowBaseStepDefinition & { + type: + | WorkflowStepType.HUMAN_URL_REDIRECT + | WorkflowStepType.HUMAN_FORM + | WorkflowStepType.HUMAN_CONFIRM + | WorkflowStepType.HUMAN_DOC_UPLOAD; +}; +``` + +### Gateway steps + +```typescript +export type TBaseGatewayStepDefinition = TWorkflowBaseStepDefinition & { + type: + | WorkflowStepType.GATEWAY_PARALLEL_SPLIT + | WorkflowStepType.GATEWAY_PARALLEL_JOIN + | WorkflowStepType.GATEWAY_EXCLUSIVE_SPLIT + | WorkflowStepType.GATEWAY_INCLUSIVE_SPLIT; +}; +``` + +### Sub-workflow steps + +#### Base definition + +```typescript +export type TBaseSubWorkflowStepDefinition = TWorkflowBaseStepDefinition & { + type: WorkflowStepType.SYS_SUB_WORKFLOW; + mode: SubWorkflowStepMode; + childWorkflowTemplateVersionId: string; + dataSources?: TDataSourceCall[]; + inputMapping?: TMapping[]; + contextProjection?: TMapping[]; + childWorkflowName?: TExpr; +}; +``` + +| Property | Description | +|----------|-------------| +| `mode` | SINGLE or BATCH | +| `childWorkflowTemplateVersionId` | Child workflow to execute | +| `dataSources` | Data to fetch before execution | +| `inputMapping` | How to populate child context | +| `contextProjection` | How to project child outputs back | +| `childWorkflowName` | Dynamic naming expression | + +#### Single mode + +```typescript +export type TSingleWorkflowStepDefinition = TBaseSubWorkflowStepDefinition & { + mode: SubWorkflowStepMode.SINGLE; +}; +``` + +#### Batch mode + +```typescript +export type TBatchWorkflowStepDefinition = TBaseSubWorkflowStepDefinition & { + mode: SubWorkflowStepMode.BATCH; + iterable: TIterableProvider; +}; +``` + +The `iterable` property defines how to construct the batch collection. + +### Union type + +```typescript +export type TWorkflowStepDefinition = + | TWorkflowBaseStepDefinition + | TSingleWorkflowStepDefinition + | TBatchWorkflowStepDefinition + | TStartWorkflowStepDefinition + | TEndWorkflowStepDefinition + | TBaseHumanStepDefinition + | TBaseGatewayStepDefinition; +``` + +## Step transitions + +### TWorkflowStepTransition + +```typescript +export type TWorkflowStepTransition = { + id: string; + fromStepId: string; + toStepId: string; + condition?: TExpr; + isDefault?: boolean; + label?: string; + onArrival?: TStepTransitionOnArrival; + ui: { + reactFlow: { + handle: { + sourceHandle: string; + targetHandle: string; + }; + }; + }; +}; +``` + +| Property | Description | +|----------|-------------| +| `id` | Unique identifier | +| `fromStepId` | Source step | +| `toStepId` | Target step | +| `condition` | Optional conditional expression | +| `isDefault` | Default branch for exclusive gateways | +| `label` | Display label | +| `onArrival` | Actions when transition activates target | +| `ui.reactFlow.handle` | Visual editor handle references | + +### TStepTransitionOnArrival + +```typescript +export type TStepTransitionOnArrival = { + status?: WorkflowRuntimeStepStatus; +}; +``` + +Use this to set the target step's status when the transition fires. For example, set to `ACTION_REQUIRED` when an issue is reported. + +## Step groups + +### TStepGroup + +```typescript +export type TStepGroup = { + id: string; + name: string; + stepIds: string[]; + legacyServiceRequestTaskGroupKey?: string; +}; +``` + +| Property | Description | +|----------|-------------| +| `id` | Unique identifier | +| `name` | Display name | +| `stepIds` | Steps belonging to this group | +| `legacyServiceRequestTaskGroupKey` | Legacy task group mapping | + +## Example definition + +```json +{ + "id": "workflow-1", + "name": "Customer Verification", + "steps": [ + { + "id": "start", + "type": "start", + "name": "Start", + "ui": { "reactFlow": { "position": { "x": 0, "y": 0 } } } + }, + { + "id": "verify", + "type": "human.confirm", + "name": "Verify Documents", + "outputSchema": { + "type": "object", + "properties": { + "verified": { "type": "boolean" } + } + }, + "ui": { "reactFlow": { "position": { "x": 200, "y": 0 } } } + }, + { + "id": "end", + "type": "end", + "name": "End", + "ui": { "reactFlow": { "position": { "x": 400, "y": 0 } } } + } + ], + "stepTransitions": [ + { + "id": "t1", + "fromStepId": "start", + "toStepId": "verify", + "ui": { "reactFlow": { "handle": { "sourceHandle": "out", "targetHandle": "in" } } } + }, + { + "id": "t2", + "fromStepId": "verify", + "toStepId": "end", + "ui": { "reactFlow": { "handle": { "sourceHandle": "out", "targetHandle": "in" } } } + } + ] +} +``` + +## Next steps + + + + Execution runtime types + + + Definition validation rules + + + diff --git a/engine/workflow-builder/reference/dsl-types.mdx b/engine/workflow-builder/reference/dsl-types.mdx new file mode 100644 index 000000000..c27a87a91 --- /dev/null +++ b/engine/workflow-builder/reference/dsl-types.mdx @@ -0,0 +1,236 @@ +--- +title: 'DSL types' +description: 'Technical reference for the Workflow Builder Domain Specific Language types' +icon: 'code' +--- + +This reference documents the type system used in Workflow Builder's Domain Specific Language (DSL). + +## Expressions + +Expressions evaluate to a value using a specified expression engine. Currently, JSONata is the supported expression type. + +### ExpressionType + +```typescript +export enum ExpressionType { + JSONATA = 'jsonata', +} +``` + +### TExpr + +```typescript +export type TExpr = { + type: ExpressionType.JSONATA; + src: string +}; +``` + +### Evaluation scope + +All expressions are evaluated against an environment containing: + +| Variable | Description | Example | +|----------|-------------|---------| +| `__context__` | Global workflow context | `__context__.customerId` | +| `__steps__` | Step outputs by ID | `__steps__.stepId.name` | +| `__datasources__` | Datasource outputs by alias | `__datasources__.dsId.data` | +| `__each__` | Current item in iterations | `__each__.id` | + +## Value providers + +### TFieldRef + +Defines how to access a field from different sources. + +```typescript +export enum FieldRefSource { + CONTEXT = 'CONTEXT', + STEP = 'STEP', + DATASOURCE = 'DATASOURCE', + EACH = 'EACH', +} + +export type TFieldRef = + | { source: FieldRefSource.CONTEXT; path: string } + | { source: FieldRefSource.STEP; stepId: string; path: string } + | { source: FieldRefSource.DATASOURCE; key: string; path: string } + | { source: FieldRefSource.EACH; path: string }; +``` + +| Source | Description | +|--------|-------------| +| `CONTEXT` | Access from global context | +| `STEP` | Access from step output | +| `DATASOURCE` | Access from datasource output | +| `EACH` | Access current item in loops | + + +The `path` property uses dot notation (e.g., `"director.id"`) powered by the `dot-props` library. + + +### TValueProvider + +Defines how to produce a value: + +```typescript +export type TValueProvider = + | { type: "const"; value: unknown } + | { type: "field"; ref: TFieldRef } + | { type: "expr"; expr: TExpr }; +``` + +| Type | Description | +|------|-------------| +| `const` | Hardcoded value | +| `field` | Value from a field reference | +| `expr` | Computed expression result | + +### TParamValue + +Used for datasource or function parameters: + +```typescript +export type TParamValue = + | TValueProvider + | { [k: string]: TParamValue } + | TParamValue[]; +``` + +## Datasource calls + +### TDataSourceCall + +```typescript +export enum DataSourceType { + COMMENDA_LOGICAL_BACKEND = 'COMMENDA_LOGICAL_BACKEND', +} + +export type TDataSourceCall = { + id: string; + alias: string; + type: DataSourceType.COMMENDA_LOGICAL_BACKEND; + dataSourceID: string; + params?: TParamValue; + select?: TExpr; + scope?: 'per-step' | 'per-item'; +}; +``` + +| Property | Description | +|----------|-------------| +| `id` | Unique identifier | +| `alias` | Reference name for accessing results | +| `type` | Datasource type | +| `dataSourceID` | Database reference to datasource definition | +| `params` | Parameters to pass to the datasource | +| `select` | Expression to transform output (default: entire output) | +| `scope` | `per-step` (default) or `per-item` for batch workflows | + +## Iterator providers + +### TIterableProvider + +Provides an array for iteration: + +```typescript +export enum IterableType { + EXPRESSION = 'EXPRESSION', + STEP = 'STEP', + DATASOURCE = 'DATASOURCE', +} + +export type TIterableProvider = + | { type: IterableType.EXPRESSION; expr: TExpr } + | { type: IterableType.STEP; stepId: string; select?: TExpr } + | { type: IterableType.DATASOURCE; key: string; select?: TExpr }; +``` + +| Type | Description | +|------|-------------| +| `EXPRESSION` | Evaluate expression against context | +| `STEP` | Access step output array | +| `DATASOURCE` | Access datasource output array | + +## Mappings + +### TMapping + +Specifies how to write values to a target: + +```typescript +export type TMapping = { + id: string; + targetPath: string; + value: TValueProvider; + mode?: 'set' | 'append'; +}; +``` + +| Property | Description | +|----------|-------------| +| `id` | Unique identifier | +| `targetPath` | Dot-notation destination path | +| `value` | How to derive the value | +| `mode` | `set` (replace, default) or `append` (for arrays) | + +### Example + +```json +{ + "id": "map-directorId", + "targetPath": "directorId", + "value": { + "type": "expr", + "expr": { "src": "__each__.id" } + }, + "mode": "set" +} +``` + +This sets `directorId` to the current batch item's `id`. + +## Step types enum + +```typescript +export enum WorkflowStepType { + START = 'start', + END = 'end', + HUMAN_URL_REDIRECT = 'human.url_redirect', + HUMAN_FORM = 'human.form', + HUMAN_CONFIRM = 'human.confirm', + HUMAN_DOC_UPLOAD = 'human.doc_upload', + SYS_SUB_WORKFLOW = 'sys.sub_workflow', + GATEWAY_PARALLEL_SPLIT = 'gateway.parallel_split', + GATEWAY_PARALLEL_JOIN = 'gateway.parallel_join', + GATEWAY_EXCLUSIVE_SPLIT = 'gateway.exclusive_split', + GATEWAY_INCLUSIVE_SPLIT = 'gateway.inclusive_split', +} +``` + +## Sub-workflow modes + +```typescript +export enum SubWorkflowStepMode { + SINGLE = 'SINGLE', + BATCH = 'BATCH', +} +``` + +| Mode | Description | +|------|-------------| +| `SINGLE` | Execute one child workflow | +| `BATCH` | Execute child workflow for each item in collection | + +## Next steps + + + + Workflow definition structure + + + Execution runtime types + + + diff --git a/engine/workflow-builder/reference/runtime-types.mdx b/engine/workflow-builder/reference/runtime-types.mdx new file mode 100644 index 000000000..192a7f338 --- /dev/null +++ b/engine/workflow-builder/reference/runtime-types.mdx @@ -0,0 +1,206 @@ +--- +title: 'Runtime types' +description: 'Technical reference for workflow execution runtime types' +icon: 'play' +--- + +This reference documents the types used during workflow execution. + +## Workflow runtime status + +```typescript +export enum WorkflowRuntimeStatus { + NOT_STARTED = 'NotStarted', + IN_PROGRESS = 'InProgress', + COMPLETED = 'Completed', + FAILED = 'Failed', + CANCELLED = 'Cancelled', +} +``` + +| Status | Description | +|--------|-------------| +| `NOT_STARTED` | Workflow defined but not yet begun | +| `IN_PROGRESS` | Actively executing steps | +| `COMPLETED` | All steps finished successfully | +| `FAILED` | One or more steps failed | +| `CANCELLED` | Execution was explicitly cancelled | + +## Step runtime status + +```typescript +export enum WorkflowRuntimeStepStatus { + NOT_STARTED = 'NotStarted', + IN_PROGRESS = 'InProgress', + COMPLETED = 'Completed', + DISABLED = 'Disabled', + FAILED = 'Failed', +} +``` + +| Status | Description | +|--------|-------------| +| `NOT_STARTED` | Step has not started | +| `IN_PROGRESS` | Step is currently executing | +| `COMPLETED` | Step finished successfully | +| `DISABLED` | Step is disabled | +| `FAILED` | Step execution failed | + +## TRuntimeWorkflowExecution + +Represents a running workflow instance: + +```typescript +export type TRuntimeWorkflowExecution = { + id: string; + correlationId: string; + parentWorkflowExecutionId?: string; + rootWorkflowExecutionId?: string; + workflowTemplateVersionId: string; + runtimeStatus: WorkflowRuntimeStatus; + startedAt: string; + completedAt?: string; + failedAt?: string; + lastActivityAt?: string; + context: Record; + steps: Record; +}; +``` + +| Property | Description | +|----------|-------------| +| `id` | Unique execution identifier | +| `correlationId` | Correlation ID for tracing | +| `parentWorkflowExecutionId` | Parent workflow if spawned as sub-workflow | +| `rootWorkflowExecutionId` | Root workflow in nested hierarchies | +| `workflowTemplateVersionId` | Template version being executed | +| `runtimeStatus` | Current overall status | +| `startedAt` | Execution start timestamp | +| `completedAt` | Completion timestamp (if completed) | +| `failedAt` | Failure timestamp (if failed) | +| `lastActivityAt` | Last step update timestamp | +| `context` | Global workflow context data | +| `steps` | Map of step execution states by ID | + +### Context usage + +The `context` property serves two purposes: + +1. **Global context** - Accessible via `__context__` in expressions +2. **Metadata storage** - Additional execution information (e.g., `directorId` for DSC workflows) + +## TRuntimeWorkflowStepExecution + +Represents a step's execution state: + +```typescript +export type TRuntimeWorkflowStepExecution = { + id: string; + type: WorkflowStepType; + stepId: string; + status: WorkflowRuntimeStepStatus; + attempt: number; + startedAt?: string; + completedAt?: string; + failedAt?: string; + dueAt?: string; + outputData?: Record; + childWorkflowExecutions?: { id: string }[]; +}; +``` + +| Property | Description | +|----------|-------------| +| `id` | Unique step execution ID | +| `type` | Step type | +| `stepId` | Reference to step definition ID | +| `status` | Current step status | +| `attempt` | Attempt number (for retries) | +| `startedAt` | Step start timestamp | +| `completedAt` | Completion timestamp | +| `failedAt` | Failure timestamp | +| `dueAt` | Due date for the step | +| `outputData` | Step output (follows outputSchema) | +| `childWorkflowExecutions` | Child workflows triggered by this step | + +## Runtime flow + +``` +┌─────────────────────────────────────────────────────────┐ +│ Workflow Execution │ +│ │ +│ Status: IN_PROGRESS │ +│ Context: { customerId: "123", ... } │ +│ │ +│ Steps: │ +│ ┌─────────────┬──────────────┬─────────────────┐ │ +│ │ start │ IN_PROGRESS │ outputData: {} │ │ +│ ├─────────────┼──────────────┼─────────────────┤ │ +│ │ verify │ NOT_STARTED │ outputData: null│ │ +│ ├─────────────┼──────────────┼─────────────────┤ │ +│ │ end │ NOT_STARTED │ outputData: null│ │ +│ └─────────────┴──────────────┴─────────────────┘ │ +└─────────────────────────────────────────────────────────┘ +``` + +## Accessing runtime data + +In expressions, access step outputs via the `__steps__` variable: + +```jsonata +__steps__.verify.outputData.verified +``` + +This returns the `verified` field from the `verify` step's output. + +## Child workflow executions + +For sub-workflow steps, `childWorkflowExecutions` contains references to spawned workflows: + +```json +{ + "id": "step-exec-1", + "type": "sys.sub_workflow", + "stepId": "dsc-step", + "status": "Completed", + "childWorkflowExecutions": [ + { "id": "child-exec-1" }, + { "id": "child-exec-2" }, + { "id": "child-exec-3" } + ] +} +``` + +## Status transitions + +### Workflow status flow + +``` +NOT_STARTED → IN_PROGRESS → COMPLETED + │ + ├──────→ FAILED + │ + └──────→ CANCELLED +``` + +### Step status flow + +``` +NOT_STARTED → IN_PROGRESS → COMPLETED + │ + └──────→ FAILED + +(DISABLED can be set at any point via activation policy) +``` + +## Next steps + + + + Database schema reference + + + Definition validation rules + + + diff --git a/engine/workflow-builder/reference/service-request-integration.mdx b/engine/workflow-builder/reference/service-request-integration.mdx new file mode 100644 index 000000000..7a6d730fa --- /dev/null +++ b/engine/workflow-builder/reference/service-request-integration.mdx @@ -0,0 +1,231 @@ +--- +title: 'Service request integration' +description: 'How workflows integrate with the legacy service request system' +icon: 'link' +--- + +This reference explains how Workflow Builder integrates with the existing service request system during the transition period. + + +This is a temporary solution until form builder fully powers the workflow UI. Currently, workflows handle **orchestration only** while service requests maintain business context (files, assignees, corporations, etc.). + + +## Architecture overview + +``` +┌─────────────────────────────────────────────────────────┐ +│ Service Request │ +│ ┌─────────────────────────────────────────────────────┐│ +│ │ Business Context: files, assignees, corporations... ││ +│ └─────────────────────────────────────────────────────┘│ +│ │ │ +│ ▼ │ +│ ┌─────────────────────────────────────────────────────┐│ +│ │ Task Groups & Tasks ││ +│ │ (Statuses synced from Workflow Execution) ││ +│ └─────────────────────────────────────────────────────┘│ +└─────────────────────────────────────────────────────────┘ + │ + │ (sync) + ▼ +┌─────────────────────────────────────────────────────────┐ +│ Workflow Execution │ +│ ┌─────────────────────────────────────────────────────┐│ +│ │ Step Groups & Steps (Source of Truth) ││ +│ └─────────────────────────────────────────────────────┘│ +└─────────────────────────────────────────────────────────┘ +``` + +## Service request configuration + +For each service request type, we maintain a configuration defining: + +- Which **task groups** exist +- Which **tasks** belong to each group + +These are represented using `TaskGroup` and `Task` enums. + +At runtime, this configuration generates service request instances on the backend. + +## Frontend rendering + +The frontend uses a `componentMap` that maps each `taskKey` to a React component: + +```typescript +const componentMap = { + 'add-bank-account': AddBankAccount, + 'mark-as-completed': MarkAsCompleted, + // ... other mappings +}; +``` + +When rendering a task: +1. Look up the `taskKey` in `componentMap` +2. If found, render the custom component +3. If not found, render a **Generic Task** (assigned to an agent, "Mark as Completed" behavior) + +## Workflow as source of truth + +When a service request is initiated: + +1. Check if a **workflow link** exists for that service request type +2. If yes, start a **workflow execution** +3. The workflow execution becomes the **source of truth** for task statuses + + +Service request instances and workflow execution instances co-exist and must be **kept in sync**. Statuses should always come from the workflow execution. + + +## Syncing task updates + +When updating a task in the service request: + +``` +1. Check if service request has associated workflow execution + │ + ▼ +2. Propagate update to workflow execution + │ + ▼ +3. Wait for update to complete + │ + ▼ +4. Fetch latest runtime statuses from workflow + │ + ▼ +5. Build Prisma mutations for each status change + │ + ▼ +6. Execute updates in a transaction +``` + +If something fails midway, a manual **"Sync" button** allows reconciliation between the service request and workflow. + +## Mapping workflows to service requests + +When creating a new workflow, connect it to a service request using these fields: + +### Workflow level + +```typescript +{ + legacyServiceRequestType: "INDIA_PVT_LTD_INCORPORATION" +} +``` + +### Step group level + +```typescript +{ + stepGroups: [ + { + id: "group-1", + name: "Document Verification", + legacyServiceRequestTaskGroupKey: "DOCUMENT_VERIFICATION" + } + ] +} +``` + +### Step level + +```typescript +{ + steps: [ + { + id: "step-1", + type: "human.confirm", + legacyServiceRequestTaskKey: "VERIFY_PAN_CARD" + } + ] +} +``` + +### Mapping flow + +1. **Select** the `legacyServiceRequestType` +2. **Select** the `taskGroup` for each `stepGroup` +3. For each step, **select** the `taskKey` + +## Component rendering logic + +``` +Task has legacyServiceRequestTaskKey? + │ + ┌─────┴─────┐ + │ │ + YES NO + │ │ + ▼ ▼ +Look up in Render +componentMap Generic Task + │ + ▼ +Found? + │ +┌───┴───┐ +│ │ +YES NO +│ │ +▼ ▼ +Render Render +Custom Generic +Comp. Task +``` + +## Handling dynamic DSC task groups + +The India Pvt Ltd incorporation workflow requires dynamic task groups—each director without a DSC goes through a separate DSC onboarding flow. + +### Domain mismatch + +| Domain | Representation | +|--------|----------------| +| Workflow | One child workflow per director | +| Service Request | Separate task group per DSC workflow | + +### Current solution + +```typescript +// Determine which workflow execution to update +workflowExecutionToUpdate = + serviceRequestTaskGroup.workflowExecutionId + || serviceRequest.workflowExecutionId +``` + +The system: + +1. Identifies DSC-related child workflow executions +2. Creates/updates corresponding Service Request task groups +3. Links each task group to the correct `workflowExecutionId` +4. Ensures group names and ordering follow SR UI conventions + +### Update routing + +- If task belongs to a DSC group → update **child workflow execution** +- Otherwise → update **parent workflow execution** + +## Future considerations + + +We have not yet generalized this pattern. Open questions include: + +- Should all child workflows appear as Service Request task groups? +- Should child-of-child workflows be shown? +- How should workflows with multiple step groups be projected? +- Should we introduce a generic "projection type" system? + +These will be revisited as more diverse workflows are built and real patterns emerge. + + +## Next steps + + + + Database schema reference + + + Build workflows with legacy mapping + + + diff --git a/engine/workflow-builder/reference/validation-rules.mdx b/engine/workflow-builder/reference/validation-rules.mdx new file mode 100644 index 000000000..779e55c5a --- /dev/null +++ b/engine/workflow-builder/reference/validation-rules.mdx @@ -0,0 +1,330 @@ +--- +title: 'Validation rules' +description: 'Reference for workflow definition validation rules' +icon: 'check' +--- + +This reference documents all validation rules applied to workflow definitions before they can be published. + +## Graph rules + +These rules validate the workflow graph structure and topology. + +### GRAPH_EXACTLY_ONE_START + +**Rule:** Workflow must have exactly 1 START step + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Validation counts START steps and fails if count ≠ 1. + +### GRAPH_EXACTLY_ONE_END + +**Rule:** Workflow must have exactly 1 END step + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Validation counts END steps and fails if count ≠ 1. + +### START_STEP_NO_INCOMING + +**Rule:** START step must not have any incoming transitions + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Checks incoming transitions for START steps. + +### END_STEP_SINGLE_INCOMING + +**Rule:** END step must have exactly 1 incoming transition + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Checks incoming count for END steps. + +### END_STEP_NO_OUTGOING + +**Rule:** END step must not have outgoing transitions + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Checks outgoing transitions for END steps. + +### TRANSITIONS_UNIQUE + +**Rule:** No duplicate (from, to) transition pairs + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Ensures no duplicate `(fromStepId, toStepId)` pairs. + +### NO_SELF_LOOPS + +**Rule:** Self-loop transitions are not allowed + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Checks that `fromStepId !== toStepId` for all transitions. + +### NO_ISOLATED_STEPS + +**Rule:** Steps with no incoming or outgoing transitions are isolated + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Checks for steps (excluding START/END) with 0 incoming and 0 outgoing transitions. + +### ONLY_SPLIT_GATEWAY_CAN_FAN_OUT + +**Rule:** Only split gateways may have more than one outgoing transition + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Non-split gateway steps cannot have >1 outgoing transitions. + +### JOIN_GATEWAY_MANY_IN_SINGLE_OUT + +**Rule:** Join gateway must have at least 2 incoming transitions and exactly 1 outgoing transition + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Applies to `GATEWAY_PARALLEL_JOIN` steps. + +### CONDITIONAL_SPLIT_SINGLE_DEFAULT + +**Rule:** Conditional split gateway must have exactly 1 default transition + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Applies to `GATEWAY_EXCLUSIVE_SPLIT` and `GATEWAY_INCLUSIVE_SPLIT`. + +### EXCLUSIVE_SPLIT_TWO_OUTGOING + +**Rule:** Exclusive gateway must have exactly 2 outgoing transitions (1 default, 1 conditional) + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Applies to `GATEWAY_EXCLUSIVE_SPLIT` steps. + +### ONLY_EXCLUSIVE_INCLUSIVE_STEP_HAVE_CONDITION + +**Rule:** Regular steps cannot have conditional transitions + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +Only exclusive/inclusive split gateways can have conditional transitions. + +### MISSING_BATCH_ITERATOR + +**Rule:** Batch workflow should have an iterator + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GRAPH_INVALID | + +BATCH mode sub-workflow steps must have an `iterable` property. + +## ID rules + +These rules ensure unique identifiers across workflow entities. + +### STEP_IDS_UNIQUE + +**Rule:** Step IDs must be unique + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | ID_INVALID | + +Ensures no duplicate step IDs in the workflow. + +### TRANSITION_IDS_UNIQUE + +**Rule:** Transition IDs must be unique + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | ID_INVALID | + +Ensures no duplicate transition IDs. + +### STEP_GROUP_IDS_UNIQUE + +**Rule:** Step group IDs must be unique + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | ID_INVALID | + +Ensures no duplicate step group IDs. + +## Group rules + +These rules validate step grouping and organization. + +### NO_GROUP_FOR_SPECIAL_NODES + +**Rule:** Start/end/gateways cannot be grouped + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GROUPING_INVALID | + +Only human nodes and system nodes can be grouped; START, END, and gateway steps cannot. + +### GROUP_STEP_IDS_EXISTS + +**Rule:** Step group contains stepIds that do not reference existing steps + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GROUPING_INVALID | + +All stepIds in a stepGroup must reference existing steps. + +### STEP_BELONGS_TO_ONLY_ONE_GROUP + +**Rule:** Each step can only belong to one group + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GROUPING_INVALID | + +Ensures each step appears in at most one stepGroup. + +### STEP_GROUP_CANNOT_BE_EMPTY + +**Rule:** Each step group must contain at least one step + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GROUPING_INVALID | + +Each stepGroup must have at least one stepId. + +### LEGACY_SERVICE_REQUEST_REQUIRES_STEP_GROUPS + +**Rule:** Workflow with legacyServiceRequestType must have at least one step group + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | GROUPING_INVALID | + +If `legacyServiceRequestType` is set, at least one stepGroup must exist. + +## Legacy service request rules + +These rules validate legacy service request mappings and compatibility. + +### LEGACY_SERVICE_REQUEST_TYPE_GROUP_TASK_UNIQUE + +**Rule:** Multiple steps share the same legacy combination (serviceRequestType, taskGroup, taskKey) + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | LEGACY_CONFIG_INVALID | + +The tuple `(serviceRequestType, taskGroupKey, taskKey)` must be unique across all steps. + +### LEGACY_SERVICE_REQUEST_TASK_GROUP_EXISTS_IN_TEMPLATE + +**Rule:** Step group with legacyServiceRequestTaskGroupKey does not exist in serviceRequestTemplate + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | LEGACY_CONFIG_INVALID | + +StepGroups with `legacyServiceRequestTaskGroupKey` must exist in the service request template. + +### LEGACY_SERVICE_REQUEST_TASK_EXISTS_IN_TEMPLATE + +**Rule:** Step with legacyServiceRequestTaskKey does not exist in the corresponding taskGroup template + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | LEGACY_CONFIG_INVALID | + +Steps with `legacyServiceRequestTaskKey` must exist in the corresponding taskGroup's tasks in the template. + +### LEGACY_SERVICE_REQUEST_TASK_ONLY_ON_HUMAN_STEP + +**Rule:** Only human steps can have legacyServiceRequestTask mapping + +| Property | Value | +|----------|-------| +| Severity | ERROR | +| Error Code | LEGACY_CONFIG_INVALID | + +Only human node types can have `legacyServiceRequestTaskKey` set. + +## Error code summary + +| Error Code | Category | +|------------|----------| +| `GRAPH_INVALID` | Workflow graph structure issues | +| `ID_INVALID` | Duplicate or missing identifiers | +| `GROUPING_INVALID` | Step grouping issues | +| `LEGACY_CONFIG_INVALID` | Legacy mapping issues | + +## Next steps + + + + Legacy service request mapping + + + Build your first workflow + + + From 703ea17ee8fb60686656f5fc44558a82c635d561 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 15:22:45 +0530 Subject: [PATCH 25/45] Update engine/commendaos/overview.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- engine/commendaos/overview.mdx | 167 ++++++++++++++++++++++++++++++++- 1 file changed, 165 insertions(+), 2 deletions(-) diff --git a/engine/commendaos/overview.mdx b/engine/commendaos/overview.mdx index 4f19bbf70..e094c873b 100644 --- a/engine/commendaos/overview.mdx +++ b/engine/commendaos/overview.mdx @@ -1,10 +1,173 @@ --- title: 'CommendaOS' -description: 'Overview of CommendaOS' +description: 'Global entity data modeling system for business entities' icon: 'microchip' --- ## Overview -CommendaOS documentation coming soon. +CommendaOS is Commenda's comprehensive data modeling system for managing business entity information across jurisdictions worldwide. It provides a unified API for modeling, storing, and retrieving entity data including government identifiers, registrations, locations, credentials, and documents. +## Core concepts + +### Business entity + +The central model representing a legal business entity (corporation, LLC, partnership, etc.) operating in any jurisdiction. Business entities contain: + +- **General information**: Legal name, DBA name, business description, formation date +- **Jurisdiction details**: Incorporation country, jurisdiction, entity type +- **Addresses**: Registered office, operating, and mailing addresses +- **Tax information**: Fiscal year, accounting basis, tax classification + +### Government identifiers + +Official identification numbers issued by government authorities for business entities. Examples include: + +- **US**: EIN (Employer Identification Number), state entity numbers +- **India**: PAN, TAN, GSTIN, CIN/LLPIN +- **UK**: Company Registration Number, UTR, VAT Number, PAYE Number +- **Canada**: Business Number, Corporation Number, Company Key +- **Singapore**: UEN, GST Number, CPF Submission Number +- **UAE**: License Number, TRN +- **Australia**: ACN, ABN, TFN, GST Number +- **Germany**: HRB Number, Steuernummer, VAT Number +- **France**: SIREN, Corporate Tax Number, TVA Number + +Each identifier includes: +- Display name and description +- Validation rules (regex patterns) +- Supporting document requirements +- Purpose (formation, taxation, payroll, etc.) +- Function criticality level + +### Registrations + +Formal registrations with government agencies that enable business operations. Common registration types: + +- **Formation**: Company registration with corporate registry +- **Income tax**: Federal/national tax identification +- **Indirect tax**: VAT/GST/sales tax registration +- **Payroll**: Employer withholding and unemployment insurance +- **Social security**: Employee benefit programs +- **Trade**: Import/export licenses +- **Corporate registry**: Access credentials for filing systems + +Registrations can be: +- **Domestic**: For entities formed in the jurisdiction +- **Foreign**: For entities qualified to do business from another jurisdiction +- **Expirable**: Some registrations require renewal + +### Locations + +Physical addresses where business entities operate, categorized by type: + +- **Registered office address**: Official legal address on file with authorities +- **Operating address**: Primary business operations location +- **Mailing address**: Correspondence address +- **Headquarters**: Main administrative office +- **Point of sale**: Retail or customer-facing locations +- **Warehouse**: Inventory storage facilities +- **Branch**: Secondary office locations +- **Employee work location**: Where staff are based + +Locations support: +- Employee count tracking +- Start date for nexus determination +- Multiple location types per address +- Integration with external data sources + +### Credentials + +Secure storage for login credentials to government portals and systems. Credential types include: + +- **Corporate tax portals**: IRS e-Services, state franchise tax systems +- **Indirect tax portals**: VAT/GST/sales tax filing systems +- **Payroll tax portals**: Withholding and unemployment insurance systems +- **Company secretarial portals**: Secretary of State business registries +- **Social security portals**: Employee benefit systems +- **Banking portals**: Financial institution access + +Credentials consist of: +- **Plain text blocks**: Usernames, account numbers, identifiers +- **Secure string blocks**: Passwords, PINs, access tokens (encrypted) +- **Custom blocks**: Jurisdiction-specific fields + +Credentials can be: +- Linked to registrations +- Shared across business entities +- Shared with accountants and service providers + +### Documents + +Business entity documents organized by category: + +- **Formation documents**: Articles of incorporation, bylaws, operating agreements +- **Tax documents**: EIN letters, tax registration certificates +- **Compliance documents**: Annual reports, franchise tax filings +- **Financial documents**: Bank statements, financial statements +- **Personnel documents**: Director identification, employment records + +Documents support: +- Time-sensitive periods (effective start/end dates) +- Version control +- Unique constraints (one per entity) +- Service request associations + +## Key features + +### Multi-jurisdiction support + +CommendaOS models entities across 50+ countries with jurisdiction-specific rules for: +- Required government identifiers +- Mandatory registrations +- Document requirements +- Credential portal access +- Compliance obligations + +### Intelligent validation + +Built-in validation rules ensure data quality: +- Regex patterns for identifier formats +- Uniqueness constraints for critical identifiers +- Date validation for time-sensitive data +- Cross-entity relationship validation + +### Audit logging + +Comprehensive audit trails track all changes to: +- Business entity core data +- Government identifiers +- Registrations +- Locations +- Credentials +- Documents + +### API-first design + +RESTful API endpoints for all operations: +- Create, read, update, delete operations +- Bulk operations for efficiency +- Relationship management +- Credential sharing and access control + +## Use cases + +CommendaOS enables: + +1. **Entity formation**: Track incorporation process and obtain required identifiers +2. **Tax compliance**: Manage tax registrations and filing credentials across jurisdictions +3. **Payroll operations**: Store employer registrations and portal access +4. **Multi-entity management**: Handle parent-subsidiary relationships and corporate groups +5. **Accountant collaboration**: Share credentials and documents with service providers +6. **Nexus tracking**: Monitor physical presence through location data +7. **Compliance automation**: Link registrations to filing obligations +8. **Document management**: Organize entity documents by type and time period + +## Architecture + +CommendaOS is built on: +- **Database**: PostgreSQL with Prisma ORM +- **Backend**: NestJS TypeScript services +- **Security**: Encrypted credential storage in MongoDB +- **Validation**: DTO-based request validation with class-validator +- **Audit**: Comprehensive change tracking system From 4050dc30958c85161d51aefccc8e5a0feb891eae Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 15:26:13 +0530 Subject: [PATCH 26/45] Update engine/commendaos/business-entity.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- engine/commendaos/business-entity.mdx | 228 ++++++++++++++++++++++++++ 1 file changed, 228 insertions(+) create mode 100644 engine/commendaos/business-entity.mdx diff --git a/engine/commendaos/business-entity.mdx b/engine/commendaos/business-entity.mdx new file mode 100644 index 000000000..abcc2ddc3 --- /dev/null +++ b/engine/commendaos/business-entity.mdx @@ -0,0 +1,228 @@ +--- +title: 'Business entity API' +description: 'Manage business entities and their core information' +icon: 'building' +--- + +## Overview + +The Business Entity API provides endpoints for managing legal business entities (corporations, LLCs, partnerships, etc.) and their associated data including locations, persons, government identifiers, registrations, documents, and credentials. + +## Core endpoints + +### Get business entity + +Retrieve a single business entity by ID. + +```http +GET /business-entity/:businessEntityId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Unique identifier for the business entity | + +**Query parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `extends` | string[] | Optional fields to include: `governmentIdentifiers`, `locations` | + +**Response** + +```json +{ + "id": 123, + "legalName": "Acme Corporation", + "dbaName": "Acme", + "incorporationCountry": "US", + "incorporationJurisdiction": "DE", + "entityType": "C_CORP", + "formationDate": "2020-01-15", + "businessDescription": "Software development", + "fiscalYearEnd": "12-31", + "accountingBasis": "ACCRUAL", + "governmentIdentifiers": [...], + "locations": [...] +} +``` + +### Update business entity + +Update core business entity information. + +```http +POST /business-entity/:businessEntityId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Unique identifier for the business entity | + +**Request body** + +```json +{ + "legalName": "Acme Corporation Inc.", + "dbaName": "Acme", + "businessDescription": "Enterprise software development", + "fiscalYearEnd": "12-31", + "accountingBasis": "ACCRUAL", + "taxClassification": "C_CORP" +} +``` + +**Response** + +Returns `200 OK` on success. + +### List business entities + +Get all business entities for a company. + +```http +GET /business-entity/list/company/:companyId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `companyId` | integer | Unique identifier for the company | + +**Response** + +```json +{ + "entities": [ + { + "id": 123, + "legalName": "Acme Corporation", + "incorporationCountry": "US", + "incorporationJurisdiction": "DE" + } + ] +} +``` + +## Key persons + +### Add key person + +Associate a person with a business entity. + +```http +POST /business-entity/:businessEntityId/persons/:personId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `personId` | integer | Person ID | + +**Request body** + +```json +{ + "role": "DIRECTOR", + "startDate": "2020-01-15", + "endDate": null, + "ownershipPercentage": 25.5 +} +``` + +**Response** + +Returns `200 OK` on success. + +### Remove key person + +Remove a person from a business entity. + +```http +DELETE /business-entity/:businessEntityId/persons/:personId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `personId` | integer | Person ID | + +**Response** + +Returns `204 No Content` on success. + +## Bulk operations + +### Bulk assign + +Assign multiple business entities to companies. + +```http +POST /business-entity/bulk/assign +``` + +**Request body** + +```json +[ + { + "businessEntityId": 123, + "companyId": 456 + }, + { + "businessEntityId": 124, + "companyId": 456 + } +] +``` + +**Response** + +```json +{ + "success": [ + { + "businessEntityId": 123, + "companyId": 456 + } + ], + "failed": [] +} +``` + +### Unassign business entity + +Remove a business entity from a company. + +```http +POST /business-entity/unassign +``` + +**Request body** + +```json +{ + "businessEntityId": 123 +} +``` + +**Response** + +Returns `200 OK` on success. + +## Related resources + +- [Locations API](/engine/commendaos/locations) - Manage business entity addresses +- [Government Identifiers API](/engine/commendaos/government-identifiers) - Manage tax IDs and official numbers +- [Registrations API](/engine/commendaos/registrations) - Manage government registrations +- [Documents API](/engine/commendaos/documents) - Manage entity documents +- [Credentials API](/engine/commendaos/credentials) - Manage portal access credentials From eb034ed68a45850cf275b49bc8ca00e2f38bcd61 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 15:26:51 +0530 Subject: [PATCH 27/45] Update engine/commendaos/government-identifiers.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- engine/commendaos/government-identifiers.mdx | 254 +++++++++++++++++++ 1 file changed, 254 insertions(+) create mode 100644 engine/commendaos/government-identifiers.mdx diff --git a/engine/commendaos/government-identifiers.mdx b/engine/commendaos/government-identifiers.mdx new file mode 100644 index 000000000..2fdbb8f03 --- /dev/null +++ b/engine/commendaos/government-identifiers.mdx @@ -0,0 +1,254 @@ +--- +title: 'Government identifiers API' +description: 'Manage official government identification numbers for business entities' +icon: 'id-card' +--- + +## Overview + +The Government Identifiers API manages official identification numbers issued by government authorities, such as EINs, VAT numbers, tax IDs, and company registration numbers across 50+ countries. + +## Core endpoints + +### List government identifiers + +Get all government identifiers for a business entity. + +```http +GET /business-entity/:businessEntityId/government-identifiers +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Unique identifier for the business entity | + +**Query parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `extend` | string[] | Optional fields to include: `supportingDocument` | + +**Response** + +```json +{ + "governmentIdentifiers": [ + { + "id": "gi_abc123", + "type": "EIN", + "value": "12-3456789", + "country": "US", + "jurisdiction": "FEDERAL", + "issuedDate": "2020-01-15", + "expiryDate": null, + "status": "ACTIVE", + "supportingDocument": { + "fileId": "file_xyz789", + "fileName": "EIN_Letter.pdf" + } + } + ], + "count": 1 +} +``` + +### Get government identifier + +Retrieve a single government identifier by ID. + +```http +GET /business-entity/:businessEntityId/government-identifiers/:governmentIdentifierId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `governmentIdentifierId` | string | Government identifier ID | + +**Response** + +```json +{ + "id": "gi_abc123", + "type": "EIN", + "value": "12-3456789", + "country": "US", + "jurisdiction": "FEDERAL", + "issuedDate": "2020-01-15", + "expiryDate": null, + "status": "ACTIVE", + "purpose": "TAXATION", + "supportingDocument": { + "fileId": "file_xyz789", + "fileName": "EIN_Letter.pdf" + } +} +``` + +### Create government identifier + +Add a new government identifier to a business entity. + +```http +POST /business-entity/:businessEntityId/government-identifiers +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | + +**Request body** + +```json +{ + "type": "EIN", + "value": "12-3456789", + "country": "US", + "jurisdiction": "FEDERAL", + "issuedDate": "2020-01-15", + "status": "ACTIVE", + "supportingDocument": { + "fileId": "file_xyz789", + "description": "EIN confirmation letter from IRS" + } +} +``` + +**Response** + +```json +{ + "governmentIdentifier": { + "id": "gi_abc123" + } +} +``` + +### Update government identifier + +Update an existing government identifier. + +```http +POST /business-entity/:businessEntityId/government-identifiers/:governmentIdentifier +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `governmentIdentifier` | string | Government identifier ID | + +**Request body** + +```json +{ + "value": "12-3456789", + "issuedDate": "2020-01-15", + "expiryDate": "2025-01-15", + "status": "ACTIVE", + "supportingDocument": { + "fileId": "file_xyz789", + "description": "Updated EIN letter" + } +} +``` + +**Response** + +Returns `200 OK` on success. + +## Supported identifier types + +### United States + +| Type | Description | Format | Jurisdiction | +|------|-------------|--------|--------------| +| `EIN` | Employer Identification Number | `XX-XXXXXXX` | Federal | +| `STATE_ENTITY_NUMBER` | State entity registration number | Varies by state | State-level | + +### India + +| Type | Description | Format | +|------|-------------|--------| +| `PAN` | Permanent Account Number | `[A-Z]{5}[0-9]{4}[A-Z]` | +| `TAN` | Tax Deduction Account Number | `[A-Z]{4}[0-9]{5}[A-Z]` | +| `GSTIN` | Goods and Services Tax ID | `[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][0-9][Z][0-9A-Z]` | +| `CIN` | Corporate Identity Number | `[LU][0-9]{5}[A-Z]{2}[0-9]{4}[A-Z]{3}[0-9]{6}` | +| `LLPIN` | Limited Liability Partnership ID | `[A-Z]{3}-[0-9]{4}` | + +### United Kingdom + +| Type | Description | Format | +|------|-------------|--------| +| `COMPANY_REGISTRATION_NUMBER` | Companies House number | `[A-Z0-9]{8}` | +| `UTR` | Unique Taxpayer Reference | `[0-9]{10}` | +| `VAT_NUMBER` | VAT registration number | `GB[0-9]{9}` | +| `PAYE_NUMBER` | Pay As You Earn reference | `[0-9]{3}/[A-Z0-9]+` | + +### Canada + +| Type | Description | Format | +|------|-------------|--------| +| `BUSINESS_NUMBER` | CRA Business Number | `[0-9]{9}` | +| `CORPORATION_NUMBER` | Federal corporation number | `[0-9]{7}` | +| `COMPANY_KEY` | Provincial company key | Varies by province | + +### Singapore + +| Type | Description | Format | +|------|-------------|--------| +| `UEN` | Unique Entity Number | `[0-9]{9}[A-Z]` or `[0-9]{10}[A-Z]` | +| `GST_NUMBER` | GST registration number | `M[0-9]{8}[A-Z]` | +| `CPF_SUBMISSION_NUMBER` | CPF submission number | `[0-9]{8}[A-Z]` | + +### United Arab Emirates + +| Type | Description | +|------|-------------| +| `LICENSE_NUMBER` | Trade license number | +| `TRN` | Tax Registration Number | + +### Australia + +| Type | Description | Format | +|------|-------------|--------| +| `ACN` | Australian Company Number | `[0-9]{9}` | +| `ABN` | Australian Business Number | `[0-9]{11}` | +| `TFN` | Tax File Number | `[0-9]{9}` | +| `GST_NUMBER` | GST registration number | `[0-9]{11}` | + +### Germany + +| Type | Description | Format | +|------|-------------|--------| +| `HRB_NUMBER` | Commercial register number | `HRB [0-9]+` | +| `STEUERNUMMER` | Tax number | Varies by state | +| `VAT_NUMBER` | VAT identification number | `DE[0-9]{9}` | + +### France + +| Type | Description | Format | +|------|-------------|--------| +| `SIREN` | Business identification number | `[0-9]{9}` | +| `CORPORATE_TAX_NUMBER` | Corporate tax number | `[0-9]{13}` | +| `TVA_NUMBER` | VAT number | `FR[0-9A-Z]{2}[0-9]{9}` | + +## Validation rules + +Government identifiers are validated using jurisdiction-specific regex patterns. Invalid formats will return a `400 Bad Request` error. + +## Supporting documents + +Each government identifier can have an associated supporting document (e.g., EIN letter, tax registration certificate). Upload the file first using the Files API, then reference the `fileId` when creating or updating the identifier. + +## Related resources + +- [Business Entity API](/engine/commendaos/business-entity) - Manage parent business entities +- [Registrations API](/engine/commendaos/registrations) - Link identifiers to registrations From d09b133fa5e8cf271d7fd3824764099afafd9bf4 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 15:27:27 +0530 Subject: [PATCH 28/45] Update engine/commendaos/registrations.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- engine/commendaos/registrations.mdx | 327 ++++++++++++++++++++++++++++ 1 file changed, 327 insertions(+) create mode 100644 engine/commendaos/registrations.mdx diff --git a/engine/commendaos/registrations.mdx b/engine/commendaos/registrations.mdx new file mode 100644 index 000000000..5951723fd --- /dev/null +++ b/engine/commendaos/registrations.mdx @@ -0,0 +1,327 @@ +--- +title: 'Registrations API' +description: 'Manage government registrations for business entities' +icon: 'file-check' +--- + +## Overview + +The Registrations API manages formal registrations with government agencies that enable business operations, including tax registrations, payroll accounts, corporate registry access, and trade licenses. + +## Core endpoints + +### List registrations + +Get all registrations for a business entity. + +```http +GET /business-entity/:businessEntityId/registrations +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Unique identifier for the business entity | + +**Query parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `extends` | string[] | Optional fields to include: `credentials` | + +**Response** + +```json +{ + "registrations": [ + { + "id": "reg_abc123", + "type": "INCOME_TAX", + "country": "US", + "jurisdiction": "FEDERAL", + "registrationDate": "2020-01-15", + "status": "ACTIVE", + "isDomestic": true, + "expiryDate": null, + "governmentIdentifierId": "gi_xyz789", + "credentials": [...] + } + ], + "count": 1 +} +``` + +### Get registration + +Retrieve a single registration by ID. + +```http +GET /business-entity/:businessEntityId/registrations/:registrationId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `registrationId` | string | Registration ID | + +**Query parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `extends` | string[] | Optional fields to include: `credentials` | + +**Response** + +```json +{ + "registration": { + "id": "reg_abc123", + "type": "INCOME_TAX", + "country": "US", + "jurisdiction": "FEDERAL", + "registrationDate": "2020-01-15", + "status": "ACTIVE", + "isDomestic": true, + "expiryDate": null, + "governmentIdentifierId": "gi_xyz789", + "credentials": [ + { + "id": "cred_123", + "name": "IRS e-Services" + } + ] + } +} +``` + +### Create registration + +Add a new registration to a business entity. + +```http +POST /business-entity/:businessEntityId/registrations +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | + +**Request body** + +```json +{ + "type": "INCOME_TAX", + "country": "US", + "jurisdiction": "FEDERAL", + "registrationDate": "2020-01-15", + "status": "ACTIVE", + "isDomestic": true, + "governmentIdentifierId": "gi_xyz789" +} +``` + +**Response** + +```json +{ + "registration": { + "id": "reg_abc123" + } +} +``` + +### Update registration + +Update an existing registration. + +```http +POST /business-entity/:businessEntityId/registrations/:registrationId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `registrationId` | string | Registration ID | + +**Request body** + +```json +{ + "status": "INACTIVE", + "expiryDate": "2025-12-31", + "registrationDate": "2020-01-15" +} +``` + +**Response** + +Returns `200 OK` on success. + +### Delete registration + +Remove a registration from a business entity. + +```http +DELETE /business-entity/:businessEntityId/registrations/:registrationId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `registrationId` | string | Registration ID | + +**Response** + +Returns `204 No Content` on success. + +## Supported registrations + +### Get supported registrations + +Get all registration types available for a business entity or country. + +```http +GET /business-entity/registrations/supportedRegistrations +``` + +**Query parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Filter by business entity (optional) | +| `country` | string | Filter by country code (optional) | + +**Response** + +```json +{ + "supportedRegistrations": [ + { + "type": "INCOME_TAX", + "displayName": "Federal Income Tax", + "description": "IRS federal income tax registration", + "country": "US", + "jurisdiction": "FEDERAL", + "requiredIdentifiers": ["EIN"], + "isExpirable": false, + "purpose": "TAXATION" + } + ], + "count": 1 +} +``` + +### Get supported registrations for entity + +Get registration types available for a specific business entity. + +```http +GET /business-entity/:businessEntityId/registrations/supportedRegistrations +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | + +**Response** + +Same format as above, filtered by the entity's incorporation country and jurisdiction. + +## Registration types + +### Formation + +Company registration with corporate registry: +- **US**: Secretary of State registration +- **UK**: Companies House registration +- **India**: ROC (Registrar of Companies) registration +- **Singapore**: ACRA registration + +### Income tax + +Federal/national tax identification: +- **US**: IRS federal income tax +- **UK**: HMRC Corporation Tax +- **India**: Income Tax Department +- **Canada**: CRA corporate income tax + +### Indirect tax + +VAT/GST/sales tax registration: +- **US**: State sales tax permits +- **UK**: VAT registration +- **India**: GST registration +- **Singapore**: GST registration +- **UAE**: VAT registration + +### Payroll + +Employer withholding and unemployment insurance: +- **US**: State withholding tax, unemployment insurance +- **UK**: PAYE registration +- **India**: Professional Tax, ESI, EPF +- **Singapore**: CPF registration + +### Social security + +Employee benefit programs: +- **US**: Social Security Administration +- **India**: ESIC, EPFO +- **Singapore**: CPF Board + +### Trade + +Import/export licenses: +- **US**: Customs and Border Protection +- **India**: Import Export Code (IEC) +- **UAE**: Trade license + +### Corporate registry + +Access credentials for filing systems: +- **US**: State business portals +- **UK**: Companies House WebFiling +- **India**: MCA portal +- **Singapore**: BizFile+ + +## Registration status + +| Status | Description | +|--------|-------------| +| `ACTIVE` | Registration is current and valid | +| `INACTIVE` | Registration has been deactivated | +| `PENDING` | Registration application in progress | +| `EXPIRED` | Registration has expired (for expirable types) | +| `SUSPENDED` | Registration temporarily suspended by authority | + +## Domestic vs foreign registrations + +- **Domestic**: For entities formed in the jurisdiction (e.g., Delaware corporation registering in Delaware) +- **Foreign**: For entities qualified to do business from another jurisdiction (e.g., Delaware corporation registering in California) + +## Linking credentials + +Associate portal access credentials with registrations: + +```http +POST /business-entity/:businessEntityId/registrations/:registrationId/credential/:credentialId +``` + +This links a credential to a specific registration, enabling automated filing and compliance workflows. + +## Related resources + +- [Business Entity API](/engine/commendaos/business-entity) - Manage parent business entities +- [Government Identifiers API](/engine/commendaos/government-identifiers) - Required identifiers for registrations +- [Credentials API](/engine/commendaos/credentials) - Portal access for registrations From 377a7292127b802891742c96f57bc4c28f2e3e42 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 15:28:00 +0530 Subject: [PATCH 29/45] Update engine/commendaos/locations.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- engine/commendaos/locations.mdx | 248 ++++++++++++++++++++++++++++++++ 1 file changed, 248 insertions(+) create mode 100644 engine/commendaos/locations.mdx diff --git a/engine/commendaos/locations.mdx b/engine/commendaos/locations.mdx new file mode 100644 index 000000000..583475178 --- /dev/null +++ b/engine/commendaos/locations.mdx @@ -0,0 +1,248 @@ +--- +title: 'Locations API' +description: 'Manage physical addresses and locations for business entities' +icon: 'map-pin' +--- + +## Overview + +The Locations API manages physical addresses where business entities operate, including registered offices, operating addresses, warehouses, branches, and points of sale. Locations are used for nexus determination, compliance tracking, and employee management. + +## Core endpoints + +### List locations + +Get all locations for a business entity. + +```http +GET /business-entity/:businessEntityId/locations +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Unique identifier for the business entity | + +**Response** + +```json +{ + "locations": [ + { + "id": "loc_abc123", + "addressLine1": "123 Main Street", + "addressLine2": "Suite 100", + "city": "San Francisco", + "state": "CA", + "postalCode": "94105", + "country": "US", + "locationType": ["REGISTERED_OFFICE", "OPERATING"], + "startDate": "2020-01-15", + "endDate": null, + "employeeCount": 25, + "source": "COMMENDA", + "sourceId": null + } + ], + "count": 1 +} +``` + +### Get location + +Retrieve a single location by ID. + +```http +GET /business-entity/:businessEntityId/locations/:locationId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `locationId` | string | Location ID | + +**Response** + +```json +{ + "id": "loc_abc123", + "addressLine1": "123 Main Street", + "addressLine2": "Suite 100", + "city": "San Francisco", + "state": "CA", + "postalCode": "94105", + "country": "US", + "locationType": ["REGISTERED_OFFICE", "OPERATING"], + "startDate": "2020-01-15", + "endDate": null, + "employeeCount": 25, + "source": "COMMENDA", + "sourceId": null +} +``` + +### Create location + +Add a new location to a business entity. + +```http +POST /business-entity/:businessEntityId/locations +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | + +**Request body** + +```json +{ + "addressLine1": "123 Main Street", + "addressLine2": "Suite 100", + "city": "San Francisco", + "state": "CA", + "postalCode": "94105", + "country": "US", + "locationType": ["OPERATING"], + "startDate": "2020-01-15", + "employeeCount": 25 +} +``` + +**Response** + +```json +{ + "location": { + "id": "loc_abc123" + } +} +``` + +### Update location + +Update an existing location. + +```http +POST /business-entity/:businessEntityId/locations/:locationId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `locationId` | string | Location ID | + +**Request body** + +```json +{ + "addressLine1": "456 Market Street", + "addressLine2": "Floor 5", + "city": "San Francisco", + "state": "CA", + "postalCode": "94103", + "employeeCount": 30, + "endDate": "2025-12-31" +} +``` + +**Response** + +Returns `200 OK` on success. + +### Delete location + +Remove a location from a business entity. + +```http +DELETE /business-entity/:businessEntityId/locations/:locationId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `locationId` | string | Location ID | + +**Response** + +Returns `204 No Content` on success. + +## Location types + +A single location can have multiple types: + +| Type | Description | Use case | +|------|-------------|----------| +| `REGISTERED_OFFICE` | Official legal address on file with authorities | Required for corporate filings | +| `OPERATING` | Primary business operations location | Main office or headquarters | +| `MAILING` | Correspondence address | Where mail is received | +| `HEADQUARTERS` | Main administrative office | Corporate HQ | +| `POINT_OF_SALE` | Retail or customer-facing location | Stores, showrooms | +| `WAREHOUSE` | Inventory storage facility | Distribution centers | +| `BRANCH` | Secondary office location | Regional offices | +| `EMPLOYEE_WORK_LOCATION` | Where staff are based | Remote offices, coworking spaces | + +## Address fields + +| Field | Type | Required | Description | +|-------|------|----------|-------------| +| `addressLine1` | string | Yes | Street address | +| `addressLine2` | string | No | Apartment, suite, unit, building, floor | +| `city` | string | Yes | City or locality | +| `state` | string | Conditional | State/province (required for US, Canada, India, Australia) | +| `postalCode` | string | Yes | ZIP/postal code | +| `country` | string | Yes | ISO 3166-1 alpha-2 country code | + +## Employee tracking + +Track employee count at each location for: +- Payroll tax nexus determination +- Workers' compensation requirements +- Local tax obligations +- Headcount reporting + +Update `employeeCount` as staff levels change. + +## Nexus determination + +Use `startDate` to track when physical presence began in a jurisdiction. This is critical for: +- Sales tax nexus +- Income tax nexus +- Payroll tax obligations +- Registration requirements + +## Location sources + +Locations can be created from multiple sources: + +| Source | Description | +|--------|-------------| +| `COMMENDA` | Manually entered in CommendaOS | +| `GUSTO` | Synced from Gusto payroll | +| `RIPPLING` | Synced from Rippling HRIS | +| `JUSTWORKS` | Synced from Justworks | +| `DEEL` | Synced from Deel | + +External locations include a `sourceId` for reference back to the originating system. + +## Time periods + +Track location validity with `startDate` and `endDate`: +- `startDate`: When the location became active (required) +- `endDate`: When the location was closed (optional, null for active locations) + +This enables historical tracking of where entities operated over time. + +## Related resources + +- [Business Entity API](/engine/commendaos/business-entity) - Manage parent business entities +- [Registrations API](/engine/commendaos/registrations) - Registrations triggered by location nexus From c9a4967c6dd71d044eb3a6b31d03a4768662f8ed Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 15:28:47 +0530 Subject: [PATCH 30/45] Update engine/commendaos/credentials.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- engine/commendaos/credentials.mdx | 398 ++++++++++++++++++++++++++++++ 1 file changed, 398 insertions(+) create mode 100644 engine/commendaos/credentials.mdx diff --git a/engine/commendaos/credentials.mdx b/engine/commendaos/credentials.mdx new file mode 100644 index 000000000..07987eccd --- /dev/null +++ b/engine/commendaos/credentials.mdx @@ -0,0 +1,398 @@ +--- +title: 'Credentials API' +description: 'Manage secure login credentials for government portals and systems' +icon: 'key' +--- + +## Overview + +The Credentials API provides secure storage for login credentials to government portals and systems, including tax filing portals, corporate registries, payroll systems, and banking portals. Credentials can be linked to business entities and registrations, and shared with accountants and service providers. + +## Core endpoints + +### List credentials + +Get all credentials accessible to the user. + +```http +GET /credentials +``` + +**Query parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Filter by business entity (optional) | +| `extends` | string[] | Optional fields to include | + +**Response** + +```json +{ + "credentials": [ + { + "id": "cred_abc123", + "name": "IRS e-Services", + "type": "CORPORATE_TAX_PORTAL", + "country": "US", + "jurisdiction": "FEDERAL", + "url": "https://www.irs.gov/e-services", + "blocks": [ + { + "type": "PLAIN_TEXT", + "label": "Username", + "value": "john.doe@acme.com" + }, + { + "type": "SECURE_STRING", + "label": "Password", + "value": "***" + } + ], + "createdAt": "2020-01-15T10:00:00Z", + "updatedAt": "2024-03-20T15:30:00Z" + } + ], + "count": 1 +} +``` + +### Get credential + +Retrieve a single credential by ID. + +```http +GET /credentials/:credentialId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `credentialId` | string | Credential ID | + +**Query parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `includeSecrets` | boolean | Include decrypted secure strings (default: false) | +| `includeRegistrations` | boolean | Include linked registrations (default: false) | + +**Response** + +```json +{ + "credential": { + "id": "cred_abc123", + "name": "IRS e-Services", + "type": "CORPORATE_TAX_PORTAL", + "country": "US", + "jurisdiction": "FEDERAL", + "url": "https://www.irs.gov/e-services", + "blocks": [ + { + "type": "PLAIN_TEXT", + "label": "Username", + "value": "john.doe@acme.com" + }, + { + "type": "SECURE_STRING", + "label": "Password", + "value": "MySecurePassword123!" + } + ], + "registrations": [ + { + "id": "reg_xyz789", + "type": "INCOME_TAX" + } + ] + } +} +``` + +### Create credential + +Add a new credential. + +```http +POST /credentials +``` + +**Request body** + +```json +{ + "name": "IRS e-Services", + "type": "CORPORATE_TAX_PORTAL", + "country": "US", + "jurisdiction": "FEDERAL", + "url": "https://www.irs.gov/e-services", + "blocks": [ + { + "type": "PLAIN_TEXT", + "label": "Username", + "value": "john.doe@acme.com" + }, + { + "type": "SECURE_STRING", + "label": "Password", + "value": "MySecurePassword123!" + }, + { + "type": "PLAIN_TEXT", + "label": "Account Number", + "value": "12-3456789" + } + ] +} +``` + +**Response** + +```json +{ + "credential": { + "id": "cred_abc123" + } +} +``` + +### Update credential + +Update an existing credential. + +```http +POST /credentials/:credentialId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `credentialId` | string | Credential ID | + +**Request body** + +```json +{ + "name": "IRS e-Services (Updated)", + "url": "https://www.irs.gov/e-services-new", + "blocks": [ + { + "type": "PLAIN_TEXT", + "label": "Username", + "value": "jane.smith@acme.com" + }, + { + "type": "SECURE_STRING", + "label": "Password", + "value": "NewPassword456!" + } + ] +} +``` + +**Response** + +```json +{ + "credential": { + "id": "cred_abc123" + } +} +``` + +### Delete credential + +Remove a credential. + +```http +DELETE /credentials/:credentialId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `credentialId` | string | Credential ID | + +**Response** + +Returns `204 No Content` on success. + +## Supported credentials + +### Get supported credential types + +Get all credential types available for a country. + +```http +GET /credentials/supportedCredentials +``` + +**Query parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `country` | string | ISO 3166-1 alpha-2 country code (optional) | + +**Response** + +```json +{ + "supportedCredentials": [ + { + "type": "CORPORATE_TAX_PORTAL", + "displayName": "Corporate Tax Portal", + "description": "Federal corporate income tax filing system", + "country": "US", + "jurisdiction": "FEDERAL", + "url": "https://www.irs.gov/e-services", + "blocks": [ + { + "type": "PLAIN_TEXT", + "label": "Username", + "required": true + }, + { + "type": "SECURE_STRING", + "label": "Password", + "required": true + } + ] + } + ], + "count": 1 +} +``` + +## Credential types + +### Corporate tax portals + +Federal/national income tax filing systems: +- **US**: IRS e-Services, state tax portals +- **UK**: HMRC online services +- **India**: Income Tax e-Filing portal +- **Canada**: CRA My Business Account +- **Singapore**: myTax Portal + +### Indirect tax portals + +VAT/GST/sales tax filing systems: +- **US**: State sales tax portals +- **UK**: HMRC VAT online +- **India**: GST portal +- **Singapore**: myTax GST +- **UAE**: Federal Tax Authority portal + +### Payroll tax portals + +Withholding and unemployment insurance systems: +- **US**: State withholding portals, SUTA portals +- **UK**: HMRC PAYE online +- **India**: ESIC, EPFO portals +- **Singapore**: CPF portal + +### Company secretarial portals + +Business registry filing systems: +- **US**: State Secretary of State portals +- **UK**: Companies House WebFiling +- **India**: MCA portal +- **Singapore**: BizFile+ + +### Social security portals + +Employee benefit systems: +- **US**: Social Security Business Services Online +- **India**: ESIC, EPFO +- **Singapore**: CPF Board + +### Banking portals + +Financial institution access: +- Bank online banking +- Payment processing portals +- Treasury management systems + +## Credential blocks + +Credentials consist of flexible blocks that can store different types of information: + +### Plain text blocks + +Store non-sensitive information: +- Usernames +- Account numbers +- Email addresses +- User IDs +- Reference numbers + +```json +{ + "type": "PLAIN_TEXT", + "label": "Username", + "value": "john.doe@acme.com" +} +``` + +### Secure string blocks + +Store sensitive information (encrypted at rest): +- Passwords +- PINs +- Access tokens +- API keys +- Security answers + +```json +{ + "type": "SECURE_STRING", + "label": "Password", + "value": "MySecurePassword123!" +} +``` + +### Custom blocks + +Add jurisdiction-specific fields as needed. The block structure is flexible to accommodate any credential format. + +## Linking credentials + +### Link to business entity + +Associate a credential with a business entity: + +```http +POST /business-entity/:businessEntityId/credentials/:credentialId +``` + +This makes the credential accessible when viewing the business entity. + +### Link to registration + +Associate a credential with a specific registration: + +```http +POST /business-entity/:businessEntityId/registrations/:registrationId/credential/:credentialId +``` + +This links the credential to a specific government registration, enabling automated filing workflows. + +## Security + +- **Encryption**: Secure string blocks are encrypted at rest using industry-standard encryption +- **Access control**: Credentials are only accessible to authorized users +- **Audit logging**: All credential access and modifications are logged +- **Sharing**: Credentials can be shared with accountants and service providers + +## Sharing with accountants + +Credentials can be shared with external accountants and service providers who need portal access for filing and compliance work. The sharing mechanism ensures proper authorization and audit trails. + +## Related resources + +- [Business Entity API](/engine/commendaos/business-entity) - Link credentials to entities +- [Registrations API](/engine/commendaos/registrations) - Link credentials to registrations From b6128359fc65f8ace4682cd4209bcfff90d0368f Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 15:29:38 +0530 Subject: [PATCH 31/45] Update engine/commendaos/documents.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- engine/commendaos/documents.mdx | 299 ++++++++++++++++++++++++++++++++ 1 file changed, 299 insertions(+) create mode 100644 engine/commendaos/documents.mdx diff --git a/engine/commendaos/documents.mdx b/engine/commendaos/documents.mdx new file mode 100644 index 000000000..96dbdc4b3 --- /dev/null +++ b/engine/commendaos/documents.mdx @@ -0,0 +1,299 @@ +--- +title: 'Documents API' +description: 'Manage business entity documents and files' +icon: 'file-text' +--- + +## Overview + +The Documents API manages business entity documents organized by category, including formation documents, tax certificates, compliance filings, financial records, and contracts. Documents support time-sensitive periods, version control, and service request associations. + +## Core endpoints + +### List documents + +Get all documents for a business entity. + +```http +GET /business-entity/:businessEntityId/documents +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Unique identifier for the business entity | + +**Response** + +```json +{ + "documents": [ + { + "id": 123, + "documentType": "FORMATION_DOCUMENT", + "documentSubType": "CertificateOfIncorporation", + "documentName": "Certificate of Incorporation", + "fileId": "file_abc123", + "fileName": "Certificate_of_Incorporation.pdf", + "effectiveStartDate": "2020-01-15", + "effectiveEndDate": null, + "serviceRequestId": null, + "createdAt": "2020-01-15T10:00:00Z" + } + ], + "count": 1 +} +``` + +### Create document + +Add a new document to a business entity. + +```http +POST /business-entity/:businessEntityId/documents +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | + +**Request body** + +```json +{ + "documentType": "FORMATION_DOCUMENT", + "documentSubType": "CertificateOfIncorporation", + "fileId": "file_abc123", + "effectiveStartDate": "2020-01-15", + "serviceRequestId": 456 +} +``` + +**Response** + +```json +{ + "document": { + "id": 123, + "documentType": "FORMATION_DOCUMENT", + "documentSubType": "CertificateOfIncorporation", + "fileId": "file_abc123" + } +} +``` + +### Update document + +Update an existing document. + +```http +POST /business-entity/:businessEntityId/documents/:documentId +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | +| `documentId` | integer | Document ID | + +**Request body** + +```json +{ + "effectiveStartDate": "2020-01-15", + "effectiveEndDate": "2025-12-31", + "serviceRequestId": 456 +} +``` + +**Response** + +Returns `200 OK` on success. + +## Supported documents + +### Get supported document types + +Get all document types available for a business entity. + +```http +GET /business-entity/:businessEntityId/documents/supported +``` + +**Path parameters** + +| Parameter | Type | Description | +|-----------|------|-------------| +| `businessEntityId` | integer | Business entity ID | + +**Response** + +```json +{ + "supportedDocumentTypes": [ + { + "documentName": "Certificate of Incorporation", + "documentType": "FORMATION_DOCUMENT", + "documentSubType": "CertificateOfIncorporation", + "country": "US", + "jurisdiction": null, + "corporationType": "C_CORP", + "isTimeSensitive": false, + "isUnique": true, + "canBeAddedByAddDocument": true + } + ] +} +``` + +## Document categories + +### Formation documents + +Company formation and incorporation documents: +- **Certificate of Incorporation**: Official incorporation certificate +- **Articles of Incorporation**: Corporate charter +- **Bylaws**: Corporate governance rules +- **Operating Agreement**: LLC governance document +- **Memorandum of Association**: Company constitution +- **Articles of Association**: Shareholder rights and obligations + +### Tax and compliance documents + +Tax registration and compliance certificates: +- **EIN Letter**: IRS Employer Identification Number confirmation +- **Tax Registration Certificate**: State/national tax registration +- **VAT Certificate**: VAT/GST registration certificate +- **PAYE Certificate**: Payroll tax registration +- **PF Registration**: Provident fund registration +- **ESIC Registration**: Employee insurance registration + +### Financial records + +Financial statements and accounting documents: +- **Balance Sheet**: Statement of financial position +- **Income Statement**: Profit and loss statement +- **Cash Flow Statement**: Cash flow analysis +- **Bank Statements**: Monthly bank account statements +- **Card Statements**: Credit card statements +- **Audit Reports**: Annual audit documents + +### Shareholder documents + +Shareholder and equity-related documents: +- **Share Certificates**: Stock ownership certificates +- **Share Purchase Agreement**: Equity transfer agreements +- **Board Resolutions**: Board meeting minutes +- **Shareholder Resolutions**: Shareholder meeting minutes +- **Stock Option Plans**: Employee equity plans + +### Contracts and agreements + +Business contracts and legal agreements: +- **Lease Agreement**: Office rental contracts +- **Service Agreements**: Vendor contracts +- **Employment Agreements**: Employee contracts +- **Partnership Agreements**: Business partnership documents + +### Miscellaneous + +Other business documents: +- **Utility Bills**: Proof of address documents +- **Office Photos**: Physical location verification +- **Director Identification**: Director ID documents +- **Company Profile**: Business information summaries + +## Document properties + +### Time-sensitive documents + +Some documents have effective date ranges: +- `effectiveStartDate`: When the document becomes valid +- `effectiveEndDate`: When the document expires (optional) + +Examples: Tax returns (fiscal year), financial statements (period), audit reports (year) + +### Unique documents + +Some document types can only exist once per entity: +- `isUnique: true`: Only one instance allowed (e.g., Certificate of Incorporation) +- `isUnique: false`: Multiple versions allowed (e.g., Board Resolutions) + +### Service request association + +Documents can be linked to service requests: +- `serviceRequestId`: Associates document with a specific service request +- Enables tracking of documents generated through compliance workflows + +## Jurisdiction-specific documents + +Document types vary by country and entity type: + +### United States (C-Corp, LLC) +- Certificate of Incorporation +- EIN Confirmation Letter +- State tax registration certificates +- Annual reports +- Franchise tax filings + +### India (Pvt Ltd, LLP) +- Certificate of Incorporation +- PAN Card +- GST Certificate +- TAN Document +- Annual audit reports + +### United Kingdom (Ltd) +- Certificate of Incorporation +- Memorandum of Association +- VAT Certificate +- PAYE Reference Letter +- HMRC UTR Letter + +### Singapore (Pte Ltd, LLP) +- Certificate of Incorporation +- GST Certificate +- CPF Activation Letter +- Articles of Association + +### Canada (Corporation) +- Certificate of Incorporation +- CRA Business Number Confirmation +- Articles of Incorporation +- Initial Return + +### UAE (Free Zone Company) +- Trade License Certificate +- TRN Letter +- Employer Establishment Card + +### Australia (Pty Ltd) +- Certificate of Incorporation +- Company Constitution +- Director's Consent + +### Germany (GmbH) +- Notarial Deed of Incorporation +- Commercial Register Extract +- Shareholder List + +### France (SAS) +- Extrait Kbis +- Articles of Association (Statuts) +- Shareholders' Agreement + +## File management + +Documents reference files stored in the Files API: +1. Upload file using Files API to get `fileId` +2. Create document record with `fileId` reference +3. Document metadata stored separately from file content + +## Related resources + +- [Business Entity API](/engine/commendaos/business-entity) - Manage parent business entities +- [Registrations API](/engine/commendaos/registrations) - Documents linked to registrations From ee55c8e5656a21d85b26d4553e286e9c40ae4b49 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Thu, 11 Dec 2025 15:30:22 +0530 Subject: [PATCH 32/45] Update docs.json Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs.json | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs.json b/docs.json index c00e660c0..8c81c2b48 100644 --- a/docs.json +++ b/docs.json @@ -16,7 +16,13 @@ { "group": "CommendaOS", "pages": [ - "engine/commendaos/overview" + "engine/commendaos/overview", + "engine/commendaos/business-entity", + "engine/commendaos/government-identifiers", + "engine/commendaos/registrations", + "engine/commendaos/locations", + "engine/commendaos/credentials", + "engine/commendaos/documents" ] }, { @@ -171,4 +177,4 @@ "github": "https://github.com/commenda-eng" } } -} \ No newline at end of file +} From 5a8992016ba6407bd8c2d8836de2eaab8f5ffcf3 Mon Sep 17 00:00:00 2001 From: Sam Suechting Date: Thu, 11 Dec 2025 16:00:31 +0530 Subject: [PATCH 33/45] Update Status link to Commenda status page --- .DS_Store | Bin 0 -> 8196 bytes docs.json | 4 ++-- 2 files changed, 2 insertions(+), 2 deletions(-) create mode 100644 .DS_Store diff --git a/.DS_Store b/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..dd7a08753139c8654e8e207710969050c0c335c1 GIT binary patch literal 8196 zcmeHM&2QX96n}3U5^vKsPMbg)fn;?rNKMlujjC1%b-PIfD?Sosqma;+t=Bto-FRnK zwv)7tBJCdl2e`wXD@V9+O4-s5} zET6x(V$q^88BR5-v;U|<8o*hy?bSIVs&-{q9L;<2UBa^$IMZ7HzYGRMKQ-y8l0jKPgo9^`C z;g$J?`Rg;@jm3qd8Sn7s!rY9vcy)&1a zoW9+3$I>7Xal9tdD2oK&zMB%;^^A4ud`HlX`^5BWR}Q6{EJ;b8z-(>%N#gU6)gIrA z{T7Q?c}--Q=txWHEf9PyVbar9M7rEd<9zVfbCT&QS;{`@EUnvq!fnQ3){ z3(m^rN_EW)IdBQ&I{ydcTqISn!bgCFV4RK}welvy6hl?|)`H4z`kfBId(%oI=xw zeXV2xR$TyOnmg Date: Thu, 11 Dec 2025 16:02:06 +0530 Subject: [PATCH 34/45] Nest CommendaOS APIs under collapsible menu --- docs.json | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/docs.json b/docs.json index 6e35cd835..e1f8560b7 100644 --- a/docs.json +++ b/docs.json @@ -17,12 +17,17 @@ "group": "CommendaOS", "pages": [ "engine/commendaos/overview", - "engine/commendaos/business-entity", - "engine/commendaos/government-identifiers", - "engine/commendaos/registrations", - "engine/commendaos/locations", - "engine/commendaos/credentials", - "engine/commendaos/documents" + { + "group": "APIs", + "pages": [ + "engine/commendaos/business-entity", + "engine/commendaos/government-identifiers", + "engine/commendaos/registrations", + "engine/commendaos/locations", + "engine/commendaos/credentials", + "engine/commendaos/documents" + ] + } ] }, { From 48b7d936c7d781824df8b4cdb96301b9f83e5394 Mon Sep 17 00:00:00 2001 From: Sam Suechting Date: Tue, 16 Dec 2025 10:11:30 +0530 Subject: [PATCH 35/45] Restructure Product tab: nest integrations under Indirect Tax, remove icons --- docs.json | 59 +++++++------------ integrations/shopify/overview.mdx | 1 - integrations/stripe/overview.mdx | 1 - integrations/woocommerce/setup.mdx | 3 +- .../incident-response-sop/overview.mdx | 14 +++++ 5 files changed, 35 insertions(+), 43 deletions(-) create mode 100644 product/indirect-tax/incident-response-sop/overview.mdx diff --git a/docs.json b/docs.json index e1f8560b7..60388edb7 100644 --- a/docs.json +++ b/docs.json @@ -78,48 +78,29 @@ ] }, { - "tab": "Integrations", + "tab": "Product", "groups": [ { - "group": "Stripe", - "pages": [ - "integrations/stripe/overview" - ] - }, - { - "group": "Shopify", - "pages": [ - "integrations/shopify/overview" - ] - }, - { - "group": "Xero", - "pages": [ - "integrations/xero/overview" - ] - }, - { - "group": "Zoho", - "pages": [ - "integrations/zoho/overview" - ] - }, - { - "group": "WooCommerce", - "pages": [ - "integrations/woocommerce/setup" - ] - }, - { - "group": "QuickBooks", - "pages": [ - "integrations/quickbooks/overview" - ] - }, - { - "group": "NetSuite", + "group": "Indirect Tax", "pages": [ - "integrations/netsuite/overview" + { + "group": "Incident Response SOP", + "pages": [ + "product/indirect-tax/incident-response-sop/overview" + ] + }, + { + "group": "Integrations", + "pages": [ + "integrations/stripe/overview", + "integrations/shopify/overview", + "integrations/xero/overview", + "integrations/zoho/overview", + "integrations/woocommerce/setup", + "integrations/quickbooks/overview", + "integrations/netsuite/overview" + ] + } ] } ] diff --git a/integrations/shopify/overview.mdx b/integrations/shopify/overview.mdx index b1eef4496..b7f971ed1 100644 --- a/integrations/shopify/overview.mdx +++ b/integrations/shopify/overview.mdx @@ -1,7 +1,6 @@ --- title: 'Shopify' description: 'Shopify integration' -icon: 'shopify' --- ## Overview diff --git a/integrations/stripe/overview.mdx b/integrations/stripe/overview.mdx index 62017ae44..45c25a8af 100644 --- a/integrations/stripe/overview.mdx +++ b/integrations/stripe/overview.mdx @@ -1,7 +1,6 @@ --- title: 'Stripe' description: 'Stripe integration' -icon: 'stripe-s' --- ## Overview diff --git a/integrations/woocommerce/setup.mdx b/integrations/woocommerce/setup.mdx index 4004df164..f9c7701be 100644 --- a/integrations/woocommerce/setup.mdx +++ b/integrations/woocommerce/setup.mdx @@ -1,7 +1,6 @@ --- -title: "WooCommerce integration" +title: "WooCommerce" description: "Learn how Rootfi integrates with WooCommerce to fetch e-commerce data" -icon: "wordpress" --- ## Overview diff --git a/product/indirect-tax/incident-response-sop/overview.mdx b/product/indirect-tax/incident-response-sop/overview.mdx new file mode 100644 index 000000000..cc3abbe04 --- /dev/null +++ b/product/indirect-tax/incident-response-sop/overview.mdx @@ -0,0 +1,14 @@ +--- +title: 'Incident Response SOP' +description: 'Standard operating procedures for handling indirect tax incidents' +icon: 'triangle-exclamation' +--- + +## Overview + +This document outlines the standard operating procedures for responding to incidents related to indirect tax operations. + +## Coming soon + +Detailed incident response procedures will be documented here. + From 1b0ab4287790835302309f81f0db03c94b5444b1 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Tue, 16 Dec 2025 10:33:02 +0530 Subject: [PATCH 36/45] Update product/indirect-tax/incident-response-sop/overview.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- .../incident-response-sop/overview.mdx | 114 +++++++++++++++++- 1 file changed, 111 insertions(+), 3 deletions(-) diff --git a/product/indirect-tax/incident-response-sop/overview.mdx b/product/indirect-tax/incident-response-sop/overview.mdx index cc3abbe04..fe3a5cb24 100644 --- a/product/indirect-tax/incident-response-sop/overview.mdx +++ b/product/indirect-tax/incident-response-sop/overview.mdx @@ -6,9 +6,117 @@ icon: 'triangle-exclamation' ## Overview -This document outlines the standard operating procedures for responding to incidents related to indirect tax operations. +This document outlines the standard operating procedures for responding to incidents related to indirect tax operations. These procedures ensure consistent, effective handling of tax calculation errors, service outages, and compliance issues. -## Coming soon +## Core principles -Detailed incident response procedures will be documented here. +### Always inform the customer + +As a service provider, always inform customers of issues that affect their tax calculations, regardless of dollar amount or visibility. Customers discovering issues after the fact undermines trust in the entire system. + +### Tax reimbursement is contractual + +Sales tax in the U.S. is a reimbursable tax. The buyer owes the tax to the jurisdiction, and the seller acts as a conduit to collect and remit it. When tax is under-collected, the liability remains with the buyer, not the seller. + +### Timeliness matters + +The customer's willingness to adjust tax reimbursement diminishes over time. Issues discovered and addressed within the same reporting period are significantly easier to resolve than those discovered years later. + +### We don't pay tax + +Commenda's liability is limited to service fees paid, not tax amounts. We provide support, documentation, and remediation assistance, but do not reimburse customers for tax liabilities. + +## When to use this SOP + +Use these procedures when: + +- Tax calculation errors are detected (over-collection, under-collection, or mis-sourcing) +- Service outages affect tax calculations +- Integration issues cause incorrect tax treatment +- Exemption certificate processing delays impact transactions +- Address hierarchy or sourcing logic produces incorrect results + +## Response framework + +All incidents follow a standard response framework: + +1. **Detect and classify** - Identify the issue type, scope, and severity +2. **Assess impact** - Determine financial exposure, compliance risk, and customer impact +3. **Execute remedy** - Follow the appropriate remediation playbook +4. **Communicate** - Notify affected customers with clear, actionable guidance +5. **Document** - Record root cause, resolution, and lessons learned + +## Incident classification + +Incidents are classified into five primary categories: + +### 1. Low-dollar, low-visibility issues + +Small amounts per transaction spread across many customers. Treated as audit risk rather than immediate remediation. + +### 2. Under-collection + +Tax under-charged to end customers. Requires customer to re-bill or obtain affidavits. + +### 3. Over-collection + +Tax over-charged to end customers. Requires refunds and potential amended returns. + +### 4. Wrong jurisdiction + +Tax collected and remitted to incorrect jurisdiction. Requires amendments in both jurisdictions. + +### 5. Tardy exemption certificate + +Late or delayed exemption application. Requires amended returns and billing adjustments. + +## Escalation thresholds + +### Account manager discretion + +- Single customer impact +- Exposure < $5,000 +- No filings affected +- Recent issue (within current reporting period) + +### Executive involvement required + +- Multiple customer impact +- Exposure > $10,000 +- Filed returns affected +- Issue spans multiple reporting periods +- Customer threatens legal action + +### SWAT team activation + +- Platform-wide impact +- Exposure > $100,000 +- Real-time reporting jurisdictions affected +- Cascading downstream effects +- Regulatory inquiry received + +## Service guarantees and limitations + +### What we provide + +- Root cause analysis and documentation +- Customer communication templates +- Remediation guidance and support +- Account credits for service fees (at discretion) +- Assistance with amended returns +- Customer tax recovery support (for key accounts) + +### What we don't provide + +- Direct payment of tax liabilities +- Payment of penalties or interest (except in specific guarantee scenarios) +- Legal representation +- Guarantee beyond service fees paid + +## Related documentation + +- [Scenario classification](/product/indirect-tax/incident-response-sop/scenarios) - Detailed breakdown of incident types +- [Remediation playbook](/product/indirect-tax/incident-response-sop/remediation) - Step-by-step procedures +- [Communication templates](/product/indirect-tax/incident-response-sop/templates) - Customer notification templates +- [Assessment framework](/product/indirect-tax/incident-response-sop/assessment) - Incident evaluation criteria From dacffc675c3d9fa089f071458d32296be98277f4 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Tue, 16 Dec 2025 10:34:34 +0530 Subject: [PATCH 37/45] Update product/indirect-tax/incident-response-sop/scenarios.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- .../incident-response-sop/scenarios.mdx | 424 ++++++++++++++++++ 1 file changed, 424 insertions(+) create mode 100644 product/indirect-tax/incident-response-sop/scenarios.mdx diff --git a/product/indirect-tax/incident-response-sop/scenarios.mdx b/product/indirect-tax/incident-response-sop/scenarios.mdx new file mode 100644 index 000000000..01c65eb49 --- /dev/null +++ b/product/indirect-tax/incident-response-sop/scenarios.mdx @@ -0,0 +1,424 @@ +--- +title: 'Scenario classification' +description: 'Detailed breakdown of incident types and patterns' +--- + +## Overview + +This page provides detailed classification of the five primary incident scenarios, including risk profiles, common patterns, and recommended remedies. + +## Scenario 1: Low-dollar, low-visibility issues + +### Pattern characteristics + +- Small under- or over-collections per transaction (typically a few dollars) +- Spread across many customers +- No amended returns filed yet +- Often invisible to tax authorities unless discovered on audit + +### Example situations + +- Rounding errors affecting multiple transactions +- Minor rate discrepancies in small jurisdictions +- Temporary calculation delays causing small under-collections +- Address resolution issues affecting low-value transactions + +### Risk profile + +**Aggregate exposure**: Can be non-trivial when summed across all transactions + +**Discovery likelihood**: Low - only found if specific taxpayer is audited + +**Customer recovery friction**: High - low yield relative to effort required + +**Compliance risk**: Low to moderate - depends on jurisdiction and audit patterns + +### Recommended remedy + +#### 1. Acknowledge and document internally + +Quantify total exposure and document: +- Root cause analysis +- Time window affected +- Number of transactions and customers +- Jurisdictions involved +- Whether issue is resolved + +#### 2. Inform the client + +Explain what happened, estimated exposure, and why customer tax recovery is impractical: + +- Frame as audit-risk issue, not current cash issue +- Emphasize low dollars per customer make recovery uneconomical +- Provide documentation for their records +- Confirm issue is resolved going forward + +#### 3. No proactive customer tax recovery + +Do not advise large-scale re-billing for trivial amounts. Position as: "We've corrected the issue; if this ever comes up on audit, we'll help support the position." + +#### 4. Support in event of audit + +Be prepared to provide: +- Detailed calculations and documentation +- Timeline of issue and resolution +- Supporting evidence for audit defense +- Fee credits per service agreement terms + +### Decision criteria + +Use this remedy when: +- Per-transaction exposure < $10 +- Total exposure < $5,000 +- No single customer exposure > $500 +- Issue is historical and resolved +- No filings affected yet + +## Scenario 2: Under-collection + +### Pattern characteristics + +- Engine, integration, or configuration issue causes under-collection of tax +- Liability ultimately still owed to the jurisdiction +- Often limited set of transactions, but dollars per transaction can be material +- Client failed to collect full tax reimbursement from their customer + +### Example situations + +- Address hierarchy logic error (billing used instead of shipping) +- Integration connector regression +- Nexus configuration error +- Product taxability mapping issue +- Rate table not updated timely +- Exemption logic misfiring + +### Risk profile + +**Client liability**: Client remains liable to jurisdiction even if they failed to collect from customer + +**Timing sensitivity**: Recent issues are easier to fix than ones discovered years later + +**Customer relationship impact**: Late tax charges can strain customer relationships + +**Audit exposure**: Moderate to high if filings already submitted + +### Recommended remedy + +#### 1. Have the client go back to their customers + +Advise client to re-bill end customers for under-collected tax, or request documentation that customer has self-reported the use tax (affidavit). + +#### 2. Provide a template notice + +Supply a letter/email template explaining: +- There was a tax calculation issue +- Sales tax is a reimbursable tax and remains the buyer's obligation +- The seller is a conduit obligated to collect and remit to the state +- The buyer can either: + - Pay the tax to the seller (who remits it), or + - Provide an affidavit that they have already paid the use tax directly + +#### 3. Use XYZ letter-style documentation + +Especially in California, leverage an "XYZ letter" style affidavit where buyer certifies whether they: +- Were exempt from the transaction +- Self-accrued and paid use tax +- Still owe the tax + +#### 4. Escalation based on materiality + +For larger exposures: +- Offer higher-touch support (calls with client and, if authorized, with their customer) +- Consider discounted/no-charge "customer tax recovery" services +- Help them reach out to customers and reduce net liability +- Provide detailed transaction lists and jurisdiction breakdowns + +### Decision criteria + +Use this remedy when: +- Per-transaction exposure > $50 +- Total exposure > $1,000 +- Limited number of customers affected (< 50) +- Issue is recent (within 2-3 months) +- Client has contractual right to re-bill + +### Special considerations + +#### No registrations filed yet + +If affected jurisdictions haven't been filed yet, you can adjust the narrative: + +"Our tax engine didn't collect tax because you weren't authorized to collect the tax at that time. Your customer still owes the tax. Now that we've determined you are required to collect the tax for that reporting period, your customer either needs to sign an affidavit that they paid the use tax, or be willing to be billed for the tax." + +This is technically accurate when registrations are being backdated. + +#### Multiple reporting periods + +If issue spans multiple reporting periods: +- Prioritize most recent period first +- Consider statute of limitations for older periods +- Assess whether older periods are worth pursuing + +## Scenario 3: Over-collection + +### Pattern characteristics + +- Tax engine or rule error leads to over-collecting from end customers +- Tax may have already been remitted to jurisdiction, or still sitting on client's books +- Customer complaints and potential reputational harm +- Operational friction of refunding customers and amending returns + +### Example situations + +- Rate table error (wrong rate applied) +- Exemption logic failure (exempt customer charged tax) +- Jurisdiction boundary error +- Product taxability error (non-taxable item taxed) +- Duplicate tax calculation + +### Risk profile + +**Customer complaints**: High - customers notice when overcharged + +**Reputational harm**: Moderate to high if not handled promptly + +**Regulatory scrutiny**: Low to moderate - depends on jurisdiction + +**Operational complexity**: High - refunding and amending is time-consuming + +### Recommended remedy + +#### 1. Explain obligations clearly to the client + +Over-collected tax generally must be: +- Refunded to the customer, or +- Remitted and managed via claim for refund, depending on jurisdiction rules + +#### 2. Assist with returning tax to customers + +Provide process guidance or, for key clients, hands-on support: +- Identifying impacted transactions +- Calculating over-collected tax per customer +- Generating lists/letters offering refunds or credits +- Determining whether to issue credits or cash refunds + +#### 3. Handle filings and amendments + +Where tax was already remitted: +- Assist with amended returns and claims for refund +- Flag that these processes can be slow and may increase audit visibility +- Provide supporting documentation and schedules +- Track refund status by jurisdiction + +#### 4. Differentiate by materiality + +**For small individual amounts across many customers:** +- Client may provide credits on future invoices +- Or, where allowed, decide not to pursue individual refunds but ensure they are not unjustly enriched (remit the tax to the state) + +**For large amounts or few customers:** +- Direct refunds are typically required +- More formal communication and documentation +- May require executive involvement + +### Decision criteria + +Use this remedy when: +- Any amount of over-collection is detected +- Customer complaints received +- Filings may or may not be affected +- Client has obligation to make customers whole + +### Special considerations + +#### Already remitted to jurisdiction + +If tax was already remitted, the process becomes more complex: +- File amended returns with claims for refund +- Process can take 3-6 months or longer +- Some jurisdictions require specific documentation +- May trigger audit or additional scrutiny + +#### Not yet remitted + +If tax hasn't been remitted yet: +- Simply refund customers and adjust reporting +- Much cleaner process +- Lower visibility to tax authorities + +## Scenario 4: Wrong jurisdiction + +### Pattern characteristics + +- Tax correctly calculated in aggregate, but collected and remitted to wrong jurisdiction +- Often caused by bad address sourcing or hierarchy logic +- One jurisdiction has money it shouldn't have; correct jurisdiction is shorted +- Visibility risk if/when either jurisdiction audits + +### Example situations + +- Address hierarchy logic error (billing address used when shipping should have been) +- Geocoding service error +- Jurisdiction boundary data error +- State vs. local misallocation +- Cross-state sourcing error + +### Risk profile + +**Dual jurisdiction exposure**: Both jurisdictions may have questions + +**Audit visibility**: Moderate to high - amendments draw attention + +**Operational complexity**: High - requires coordination across jurisdictions + +**Customer impact**: Low if net tax amount was correct + +### Recommended remedy + +#### 1. Reconstruct correct sourcing + +Identify affected transactions and where tax should have been sourced: +- Review address data used +- Verify correct sourcing rules +- Calculate correct jurisdiction for each transaction +- Quantify over/under remittance by jurisdiction + +#### 2. Two sets of amendments + +File: +- **Refund/amended returns** in the jurisdiction that incorrectly received the tax +- **Underpayment/amended returns** in the jurisdiction that should have received the tax + +#### 3. Minimize client friction + +Provide clear schedules and workpapers supporting: +- Original remittances by jurisdiction +- Corrected sourcing analysis +- Net effect by jurisdiction +- Timeline for amendments and refunds + +#### 4. Address root cause + +Review and fix: +- Address hierarchy logic +- Integration address mapping +- Geocoding service configuration +- Jurisdiction boundary data + +### Decision criteria + +Use this remedy when: +- Tax was calculated correctly but sourced to wrong jurisdiction +- Affects any dollar amount (all mis-sourcing should be corrected) +- May affect filed or unfiled returns +- Root cause is identified and fixed + +### Special considerations + +#### Timing of corrections + +- If returns not yet filed: Simply file correctly +- If returns already filed: Amendments required in both jurisdictions +- Consider statute of limitations for older periods + +#### Jurisdiction cooperation + +Some jurisdictions are more cooperative than others: +- Document all communications +- Provide clear audit trail +- Be prepared for questions from both jurisdictions + +## Scenario 5: Tardy exemption certificate + +### Pattern characteristics + +- Customer is (or claims to be) exempt, but exemption certificate is provided late +- Delay in uploading/applying exemption certificates in the system +- Transactions may have been billed tax-inclusive but never fully collected, and/or reported as taxable on prior returns + +### Example situations + +- Customer provides exemption certificate after invoice issued +- Exemption certificate received but not uploaded timely +- Integration delay in syncing exemption status +- Manual exemption application backlog +- Exemption certificate validation delays + +### Risk profile + +**Over-reporting of tax**: Tax reported but not actually due + +**Operational complexity**: Separating billing vs. reporting issues + +**Client expectations**: May expect Commenda to resolve when caused by our processing delays + +**Audit exposure**: Low - correcting over-reporting is generally welcomed + +### Recommended remedy + +#### 1. Clarify sequence of events + +Determine: +- When was the transaction taxed and reported? +- When was the exemption certificate received? +- When was it applied in the system? +- Was tax billed, collected, or just reported? + +#### 2. Correct prior filings where appropriate + +For certificates that are valid for the sale: +- File amended returns to remove the now-exempt tax from prior periods +- Provide supporting documentation (copy of exemption certificate) +- Track refund or credit from jurisdiction + +#### 3. Separate billing vs. reporting + +Distinguish: +- **Over-billing that was never collected but was reported**: Amend return only +- **Tax that was billed, collected, and reported**: Amend return and refund customer + +Adjust future invoices, issue credits, or refunds to reconcile. + +#### 4. Tighten exemption workflows + +Encourage clients to: +- Route exemption certificates through defined intake channel +- Minimize lag between receipt and application +- Set up automated exemption validation where possible +- Establish SLAs for exemption processing + +Where Commenda's processing delays contribute, consider service gestures (fee credits, prioritized support) depending on impact. + +### Decision criteria + +Use this remedy when: +- Valid exemption certificate received after transaction +- Tax was reported but customer was actually exempt +- Any dollar amount (all incorrect exemption treatment should be corrected) +- Certificate is valid for the transaction date + +### Special considerations + +#### Retroactive exemption certificates + +Some jurisdictions allow retroactive application, others don't: +- Verify jurisdiction rules +- Document certificate validity period +- Ensure certificate covers transaction date + +#### Partial period exemptions + +If customer became exempt mid-period: +- Separate exempt vs. taxable transactions +- Apply exemption only to qualifying transactions +- Document effective date of exemption + +## Summary comparison + +| Scenario | Core issue | Primary remedy | Urgency | +|----------|-----------|----------------|---------| +| **Low-dollar, low-visibility** | Trivial amounts per transaction, many txns | Document, inform client, treat as audit risk | Low | +| **Under-collection** | Tax under-billed/under-collected | Have client re-bill or get affidavits | High | +| **Over-collection** | Customer overcharged tax | Refund/credit customers, amend returns | High | +| **Wrong jurisdiction** | Tax remitted to wrong place | Amend in both jurisdictions | Moderate | +| **Tardy exemption** | Late/slow exemption application | Amend returns, align billing/collections | Moderate | From 88d7d30435b01070dc723c57e1a25348bf0e6a08 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Tue, 16 Dec 2025 10:36:13 +0530 Subject: [PATCH 38/45] Update product/indirect-tax/incident-response-sop/remediation.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- .../incident-response-sop/remediation.mdx | 605 ++++++++++++++++++ 1 file changed, 605 insertions(+) create mode 100644 product/indirect-tax/incident-response-sop/remediation.mdx diff --git a/product/indirect-tax/incident-response-sop/remediation.mdx b/product/indirect-tax/incident-response-sop/remediation.mdx new file mode 100644 index 000000000..403767291 --- /dev/null +++ b/product/indirect-tax/incident-response-sop/remediation.mdx @@ -0,0 +1,605 @@ +--- +title: 'Remediation playbook' +description: 'Step-by-step procedures for incident resolution' +--- + +## Overview + +This playbook provides detailed, step-by-step procedures for remediating each incident scenario. Follow these procedures to ensure consistent, effective incident resolution. + +## General response workflow + +All incidents follow this standard workflow: + +### 1. Initial detection and triage + +**Actions:** +- Document how issue was discovered (customer-reported, internal monitoring, filing review) +- Identify affected time window +- Determine if issue is ongoing or resolved +- Assess immediate containment needs + +**Outputs:** +- Incident ticket created +- Initial scope assessment +- Containment actions taken (if needed) + +### 2. Impact assessment + +**Actions:** +- Identify affected customers +- Calculate financial exposure +- Determine compliance lifecycle impact (pre-invoice, post-invoice, post-filing) +- Assess blast radius (single customer, multiple customers, platform-wide) +- Evaluate direction of error (under-collection, over-collection, mis-sourcing) + +**Outputs:** +- Affected customer list +- Financial exposure by customer and jurisdiction +- Compliance impact assessment +- Scenario classification + +### 3. Root cause analysis + +**Actions:** +- Identify technical root cause +- Determine contributing factors +- Document timeline of issue +- Verify issue is resolved or implement fix + +**Outputs:** +- Root cause documentation +- Fix verification +- Prevention recommendations + +### 4. Remediation execution + +**Actions:** +- Follow scenario-specific remediation steps (see below) +- Prepare customer communications +- Coordinate with affected teams (engineering, support, compliance) +- Execute technical corrections (amended returns, refunds, etc.) + +**Outputs:** +- Remediation actions completed +- Customer notifications sent +- Technical corrections filed + +### 5. Documentation and follow-up + +**Actions:** +- Document full incident timeline +- Record lessons learned +- Update monitoring/alerting if needed +- Schedule follow-up with affected customers +- Track resolution to completion + +**Outputs:** +- Incident post-mortem +- Process improvements identified +- Customer satisfaction confirmed + +## Scenario-specific procedures + +### Scenario 1: Low-dollar, low-visibility issues + +#### Step 1: Quantify and document + +**Actions:** +1. Calculate total exposure across all affected transactions +2. Identify number of customers and transactions affected +3. Calculate average exposure per customer +4. Document affected jurisdictions +5. Verify issue is resolved going forward + +**Documentation required:** +- Transaction-level detail (customer, date, amount, jurisdiction) +- Root cause analysis +- Fix verification +- Time window affected + +#### Step 2: Prepare customer notification + +**Actions:** +1. Draft notification email explaining: + - What happened + - Time window affected + - Total exposure for their account + - Why customer tax recovery is not recommended + - How issue is resolved + - What to do if audited +2. Include supporting documentation +3. Get approval from manager + +**Template:** See "Low-dollar issue notification" in communication templates + +#### Step 3: Notify customer + +**Actions:** +1. Send notification via email +2. Offer to schedule call if customer has questions +3. Provide documentation for their records +4. Confirm receipt and understanding + +**Follow-up:** +- Respond to questions within 24 hours +- Escalate if customer demands remediation +- Document customer response + +#### Step 4: Document for audit support + +**Actions:** +1. Prepare audit defense package: + - Detailed calculations + - Timeline of issue and resolution + - Supporting evidence + - Jurisdiction-specific considerations +2. Store in customer's account for future reference + +**Retention:** Keep for statute of limitations period (typically 3-4 years) + +### Scenario 2: Under-collection + +#### Step 1: Assess scope and timing + +**Actions:** +1. Identify all affected transactions +2. Calculate under-collected tax by customer and jurisdiction +3. Determine if any returns have been filed +4. Assess whether registrations are in place +5. Evaluate customer's ability to re-bill + +**Key questions:** +- How recent is the issue? (within current period vs. multiple periods) +- Have returns been filed? (pre-filing vs. post-filing) +- Are registrations in place? (registered vs. in-process) +- What is customer's contract with their buyers? (can they re-bill?) + +#### Step 2: Prepare customer notification and templates + +**Actions:** +1. Draft notification email to customer explaining: + - What happened and why + - Financial impact to their account + - Tax reimbursement principles + - Recommended next steps + - Support we'll provide +2. Prepare customer tax recovery template for them to send to their buyers +3. Prepare transaction detail spreadsheet +4. Get approval from manager (if exposure > $5,000, get executive approval) + +**Templates:** See "Under-collection notification" and "Customer tax recovery letter" in communication templates + +#### Step 3: Notify customer and provide support + +**Actions:** +1. Send notification email with: + - Explanation of issue + - Transaction detail spreadsheet + - Customer tax recovery template + - Offer to review their outreach before sending +2. Schedule call to walk through details (if exposure > $5,000) +3. Offer to participate in customer conversations (if exposure > $10,000) + +**Talking points:** +- Tax reimbursement is contractual between buyer and seller +- This is a timely issue (emphasize recency) +- We'll support them throughout the process +- We can provide documentation for their customers + +#### Step 4: Support customer tax recovery + +**Actions:** +1. Review customer's draft communication before they send +2. Provide jurisdiction-specific guidance +3. Prepare affidavit templates (XYZ letter style) +4. Track recovery progress +5. Assist with any buyer questions (if authorized) + +**For high-value accounts (exposure > $25,000):** +- Consider offering discounted/no-charge customer tax recovery service +- Direct outreach to top customers representing 80% of liability +- Executive involvement in key customer conversations + +#### Step 5: Handle filing implications + +**Actions:** + +**If returns not yet filed:** +1. Ensure correct amounts are reported on upcoming returns +2. Document under-collection and recovery efforts +3. Report actual collected amounts (not amounts that should have been collected) + +**If returns already filed:** +1. Assess whether amended returns are needed +2. If customer successfully recovers tax, file amended returns to report additional tax +3. If customer cannot recover tax, document efforts and maintain records for audit + +**Documentation:** +- Recovery efforts and results +- Customer communications +- Affidavits received +- Amended return support + +#### Step 6: Escalation procedures + +**If customer refuses to pursue recovery:** +1. Reiterate tax reimbursement principles +2. Emphasize their contractual rights +3. Explain audit risk if not addressed +4. Escalate to executive team +5. Review service agreement limitations +6. Consider fee credits (at discretion) + +**If customer demands Commenda pay the tax:** +1. Refer to service agreement limitations +2. Explain we don't pay tax, only support recovery +3. Offer fee credits up to service fees paid +4. Escalate to executive team +5. Involve legal if necessary + +### Scenario 3: Over-collection + +#### Step 1: Assess scope and refund obligations + +**Actions:** +1. Identify all affected transactions +2. Calculate over-collected tax by customer and jurisdiction +3. Determine if tax was remitted to jurisdictions +4. Assess customer's refund obligations to their buyers +5. Evaluate materiality per buyer + +**Key questions:** +- Has tax been remitted? (affects refund process) +- How much per buyer? (affects refund method) +- Are buyers complaining? (affects urgency) +- What is customer's refund policy? + +#### Step 2: Prepare customer notification and refund guidance + +**Actions:** +1. Draft notification email explaining: + - What happened and why + - Financial impact + - Customer's obligations to refund buyers + - Refund process options + - Support we'll provide +2. Prepare transaction detail spreadsheet +3. Prepare refund process guidance +4. Get approval from manager + +**Templates:** See "Over-collection notification" in communication templates + +#### Step 3: Notify customer and coordinate refund approach + +**Actions:** +1. Send notification email with: + - Explanation of issue + - Transaction detail spreadsheet + - Refund process guidance + - Offer to assist with refund logistics +2. Schedule call to discuss refund approach +3. Determine refund method: + - Credits on future invoices + - Direct refunds + - Combination approach + +**Refund method considerations:** +- **Credits**: Easier administratively, but only works for repeat customers +- **Direct refunds**: Required for one-time customers or large amounts +- **Materiality**: Small amounts (< $25) may warrant credits; larger amounts warrant refunds + +#### Step 4: Support refund execution + +**Actions:** +1. Help customer identify affected buyers +2. Provide refund notification templates +3. Assist with refund calculations +4. Track refund progress +5. Document refunds issued + +**For key accounts:** +- Offer hands-on support with refund logistics +- Help generate refund letters +- Provide buyer-specific calculations + +#### Step 5: Handle filing implications + +**Actions:** + +**If tax not yet remitted:** +1. Simply adjust reporting to reflect correct amounts +2. No amendments needed +3. Refund customers from over-collected amounts + +**If tax already remitted:** +1. File amended returns with claims for refund in affected jurisdictions +2. Provide supporting documentation: + - Original return + - Corrected calculations + - Refund documentation +3. Track refund status by jurisdiction +4. Coordinate timing: refund customers after receiving refund from jurisdiction (or before, depending on cash flow) + +**Amended return process:** +- Prepare amended return schedules +- Document reason for amendment +- Include supporting calculations +- Track refund claims (can take 3-6 months) +- Follow up on delayed refunds + +#### Step 6: Monitor and close + +**Actions:** +1. Track refund completion (both to customers and from jurisdictions) +2. Confirm customer satisfaction +3. Document lessons learned +4. Update monitoring to prevent recurrence + +### Scenario 4: Wrong jurisdiction + +#### Step 1: Reconstruct correct sourcing + +**Actions:** +1. Identify all affected transactions +2. Determine correct jurisdiction for each transaction +3. Calculate amounts by: + - Jurisdiction that incorrectly received tax + - Jurisdiction that should have received tax +4. Verify address data and sourcing logic +5. Document root cause + +**Analysis required:** +- Transaction-level detail with addresses +- Original jurisdiction assigned +- Correct jurisdiction +- Tax amount by jurisdiction +- Net over/under by jurisdiction + +#### Step 2: Prepare amendment strategy + +**Actions:** +1. Determine amendment approach by jurisdiction: + - Some jurisdictions allow cross-jurisdiction adjustments + - Others require separate refund and payment processes +2. Prepare amendment schedules for both jurisdictions +3. Calculate net impact to customer (usually zero if tax amount was correct) +4. Get approval from manager + +**Documentation:** +- Original returns filed +- Corrected sourcing analysis +- Amendment schedules +- Supporting workpapers + +#### Step 3: Notify customer + +**Actions:** +1. Draft notification email explaining: + - What happened (sourcing error) + - Why net impact is minimal (tax amount was correct) + - Amendment process required + - Timeline expectations + - Support we'll provide +2. Send notification with supporting documentation +3. Schedule call to walk through amendments + +**Templates:** See "Wrong jurisdiction notification" in communication templates + +**Key message:** "The good news is the tax amount was correct, we just need to move it from Jurisdiction A to Jurisdiction B." + +#### Step 4: File amendments + +**Actions:** + +**In jurisdiction that incorrectly received tax:** +1. File amended return showing reduction +2. Request refund or credit +3. Provide supporting documentation +4. Track refund/credit status + +**In jurisdiction that should have received tax:** +1. File amended return showing increase +2. Pay additional tax due (plus interest if applicable) +3. Provide supporting documentation +4. Confirm payment processed + +**Coordination:** +- Some jurisdictions allow offset (pay net difference) +- Others require separate processes +- Document all communications with both jurisdictions + +#### Step 5: Monitor resolution + +**Actions:** +1. Track refund from incorrect jurisdiction +2. Confirm payment to correct jurisdiction +3. Reconcile net impact to customer +4. Document resolution +5. Update address hierarchy/sourcing logic to prevent recurrence + +**Timeline expectations:** +- Refunds can take 3-6 months +- Some jurisdictions are faster than others +- Keep customer updated on status + +### Scenario 5: Tardy exemption certificate + +#### Step 1: Clarify sequence and validity + +**Actions:** +1. Determine timeline: + - When was transaction processed? + - When was exemption certificate received? + - When was it applied in system? +2. Verify exemption certificate validity: + - Covers transaction date? + - Correct jurisdiction? + - Properly completed? +3. Determine billing and reporting status: + - Was tax billed to buyer? + - Was tax collected from buyer? + - Was tax reported to jurisdiction? + +**Key questions:** +- Is certificate valid for the transaction date? +- Was tax actually collected or just reported? +- Which returns are affected? + +#### Step 2: Determine correction approach + +**Actions:** + +**Scenario A: Tax reported but not collected** +1. File amended returns to remove exempt tax +2. No customer refund needed +3. Track refund/credit from jurisdiction + +**Scenario B: Tax reported and collected** +1. File amended returns to remove exempt tax +2. Refund customer for tax collected +3. Track refund/credit from jurisdiction +4. Coordinate timing of customer refund + +**Scenario C: Tax not yet reported** +1. Simply report correctly on upcoming return +2. Refund customer if tax was collected +3. No amendments needed + +#### Step 3: Notify customer + +**Actions:** +1. Draft notification email explaining: + - Exemption certificate received + - Correction process required + - Timeline expectations + - Any refund due to their buyer +2. Send notification with: + - Copy of exemption certificate + - Transaction detail + - Amendment schedule (if applicable) +3. Coordinate refund to buyer (if applicable) + +**Templates:** See "Tardy exemption notification" in communication templates + +#### Step 4: File amendments and process refunds + +**Actions:** +1. File amended returns in affected jurisdictions +2. Provide copy of exemption certificate as support +3. Track refund/credit from jurisdictions +4. Coordinate customer refund to buyer (if applicable) +5. Update exemption status in system + +**Documentation:** +- Exemption certificate +- Original return +- Amended return +- Refund documentation + +#### Step 5: Process improvement + +**Actions:** +1. Review exemption certificate intake process +2. Identify delays in processing +3. Implement improvements: + - Automated exemption validation + - Faster upload process + - Better integration syncing + - SLAs for exemption processing +4. Document lessons learned + +**If Commenda processing delays contributed:** +- Consider fee credits +- Prioritize future exemption processing for this customer +- Implement monitoring to prevent recurrence + +## Escalation procedures + +### When to escalate to manager + +- Exposure > $5,000 +- Customer is upset or threatening +- Multiple customers affected +- Unclear how to proceed +- Customer demands Commenda pay tax + +### When to escalate to executive team + +- Exposure > $10,000 +- Multiple customers affected +- Filed returns impacted +- Customer threatens legal action +- Media or regulatory attention +- Platform-wide issue + +### When to activate SWAT team + +- Exposure > $100,000 +- Platform-wide impact +- Real-time reporting jurisdictions affected +- Cascading downstream effects +- Regulatory inquiry received +- Reputational risk + +## Service gestures and fee credits + +### Account manager discretion (up to $500) + +- Single customer impact +- Exposure < $5,000 +- Clear Commenda fault +- Customer relationship at risk + +### Manager approval required ($500-$2,500) + +- Multiple customers affected +- Exposure $5,000-$10,000 +- Significant customer impact +- Retention risk + +### Executive approval required (> $2,500) + +- Large exposure +- Multiple customers +- Significant business impact +- Strategic account + +### Customer tax recovery services + +**Standard offering (paid service):** +- Hourly rate for customer tax recovery +- Typically used during VDA process +- Helps minimize VDA liability + +**Discounted/free offering (incident response):** +- For key accounts with large under-collection exposure +- Focus on top customers representing 80% of liability +- Executive involvement +- Helps maintain customer relationship + +## Documentation requirements + +### All incidents require + +- Incident ticket with full timeline +- Root cause analysis +- Affected customer list +- Financial exposure calculation +- Customer communications +- Resolution documentation + +### Additional documentation for material incidents (> $10,000) + +- Executive briefing +- Detailed remediation plan +- Customer-by-customer status tracking +- Amended return support +- Post-mortem analysis +- Process improvement recommendations + +### Retention requirements + +- Keep all incident documentation for statute of limitations period (typically 3-4 years) +- Store in customer account for easy retrieval +- Include in audit defense package if needed From 8e280792831ce3fbd147b3540a57c5555b22bd0e Mon Sep 17 00:00:00 2001 From: samsuechting Date: Tue, 16 Dec 2025 10:38:10 +0530 Subject: [PATCH 39/45] Update product/indirect-tax/incident-response-sop/templates.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- .../incident-response-sop/templates.mdx | 620 ++++++++++++++++++ 1 file changed, 620 insertions(+) create mode 100644 product/indirect-tax/incident-response-sop/templates.mdx diff --git a/product/indirect-tax/incident-response-sop/templates.mdx b/product/indirect-tax/incident-response-sop/templates.mdx new file mode 100644 index 000000000..295e3f207 --- /dev/null +++ b/product/indirect-tax/incident-response-sop/templates.mdx @@ -0,0 +1,620 @@ +--- +title: 'Communication templates' +description: 'Customer notification and outreach templates' +--- + +## Overview + +This page provides email templates for notifying customers of incidents and supporting their remediation efforts. Customize these templates based on the specific situation while maintaining the core messaging principles. + +## Template usage guidelines + +### Customization points + +Each template includes placeholders in brackets `[like this]` that should be customized: +- `[Customer name]` - Customer's company name +- `[Contact name]` - Primary contact's first name +- `[Your name]` - Your full name +- `[Dollar amount]` - Specific financial figures +- `[Number]` - Transaction counts, time periods, etc. +- `[Jurisdiction]` - State, county, or city names +- `[Date]` - Specific dates or date ranges + +### Tone and messaging + +- **Be direct and transparent** - Explain what happened clearly +- **Lead with facts** - Provide specific numbers and timelines +- **Emphasize recency** - Highlight that issues were caught quickly +- **Offer support** - Make it clear you'll help them through the process +- **Avoid blame** - Focus on resolution, not fault + +### Approval requirements + +- **< $5,000 exposure**: Account manager approval +- **$5,000-$10,000 exposure**: Manager approval +- **> $10,000 exposure**: Executive approval + +## Template 1: Under-collection notification + +Use this template when tax was under-collected and customer needs to recover from their buyers. + +### Subject line + +``` +Follow-up on recent sales tax under-collection +``` + +### Email body + +``` +Hi [Contact name], + +We identified a recent issue that affected how sales tax was calculated on a [small/limited] number of your transactions. Due to [brief description of root cause, e.g., "an integration issue related to address mapping"], our tax engine under-collected tax on [number] invoices, representing approximately $[amount] in total sales tax. + +A few important points to keep in mind: + +As a reminder, under U.S. sales tax rules, the tax itself is owed by the buyer, not by [Customer name]. [Customer name]'s role is to remit that tax to the appropriate authorities on the buyer's behalf. When tax is under-collected at checkout, the remaining amount typically needs to be rebilled to the customer so it can be properly remitted. + +No previously filed returns have been impacted. All affected transactions are recent [or: occurred between [start date] and [end date]], and the relevant returns have not yet been filed, so this was identified within a relatively timely window. + +Our recommended next step is for [Customer name] to rebill the affected customers for the under-collected tax. To make this as straightforward as possible, we'll provide a template email you can use. In summary, that outreach will: + +• Explain that there was a temporary issue in the tax calculation logic that resulted in under-collection +• Clarify that the sales tax remains due to the taxing authorities, and that [Customer name] serves as the collector and remitter on the government's behalf +• Ask the customer to either: + - Pay the additional tax so it can be properly remitted, or + - Provide confirmation that they have already self-assessed and paid the applicable use tax + +We recognize that this is a sensitive customer communication, and we'll support you throughout the process: + +• We'll share a clear, auditor-defensible outreach template +• We've attached the exact list of affected invoices, amounts, and jurisdictions for your records +• If helpful, we're happy to review your final email or letter before it's sent +• [For large exposures: We're available to participate in conversations with your customers if that would be helpful] + +Please let us know who on your team should receive the customer outreach template, and whether you'd like to schedule a quick call to walk through the specifics. + +Best, +[Your name] +``` + +### Attachments to include + +1. **Transaction detail spreadsheet** with columns: + - Invoice number + - Invoice date + - Customer name + - Ship-to address + - Jurisdiction + - Taxable amount + - Tax that should have been collected + - Tax that was collected + - Under-collected amount + +2. **Customer tax recovery template** (see Template 6 below) + +## Template 2: Over-collection notification + +Use this template when tax was over-collected and customer needs to refund their buyers. + +### Subject line + +``` +Action required: Sales tax over-collection identified +``` + +### Email body + +``` +Hi [Contact name], + +We identified an issue that caused sales tax to be over-collected on [number] of your transactions. Due to [brief description of root cause], our tax engine over-collected approximately $[amount] in total sales tax between [start date] and [end date]. + +Here's what this means for [Customer name]: + +The over-collected tax needs to be returned to your customers. You have a few options for how to handle this: + +1. Issue credits on future invoices (works well for repeat customers) +2. Process direct refunds (required for one-time customers or large amounts) +3. A combination approach based on customer relationship and amount + +We've prepared a detailed breakdown of affected transactions to help you determine the best approach for each customer. + +Filing implications: + +[If tax not yet remitted:] +Since the affected returns haven't been filed yet, we'll simply report the correct amounts on your upcoming filings. No amendments are needed. + +[If tax already remitted:] +Since tax was already remitted to [jurisdiction(s)], we'll need to file amended returns with claims for refund. This process typically takes 3-6 months. We can coordinate the timing of customer refunds based on your cash flow preferences. + +Next steps: + +1. Review the attached transaction detail to understand the impact by customer +2. Decide on your refund approach (credits vs. direct refunds) +3. We'll provide refund notification templates for your customers +4. [If applicable: We'll prepare and file amended returns] +5. We'll track the process through completion + +We're here to support you through this process. Please let us know if you'd like to schedule a call to discuss the best approach for your business. + +Best, +[Your name] +``` + +### Attachments to include + +1. **Transaction detail spreadsheet** with columns: + - Invoice number + - Invoice date + - Customer name + - Jurisdiction + - Taxable amount + - Tax that should have been collected + - Tax that was collected + - Over-collected amount + +2. **Refund notification template** (see Template 7 below) + +## Template 3: Low-dollar, low-visibility issue notification + +Use this template when amounts are too small to warrant customer tax recovery. + +### Subject line + +``` +FYI: Minor sales tax calculation issue identified and resolved +``` + +### Email body + +``` +Hi [Contact name], + +We wanted to make you aware of a minor sales tax calculation issue that affected [Customer name]'s account between [start date] and [end date]. + +What happened: + +Due to [brief description of root cause], our tax engine [under-collected/over-collected] small amounts of tax across [number] transactions. The total exposure for your account is approximately $[amount], with an average of $[amount] per transaction. + +Why we're not recommending customer outreach: + +Given the small dollar amounts per transaction (averaging $[amount]), attempting to recover these amounts from your customers would be impractical and likely cost more in administrative time than the tax amounts involved. + +Instead, we recommend treating this as an audit-risk issue: + +• The issue has been fully resolved as of [date] +• The likelihood of discovery is low (would only surface if a specific customer is audited) +• We've documented everything for your records +• If this ever comes up on audit, we'll provide full support and documentation + +What we've prepared for you: + +• Detailed transaction-level documentation +• Root cause analysis +• Timeline of issue and resolution +• Audit defense package (if needed in the future) + +No action is required on your part. We're providing this information for transparency and your records. If you have any questions or concerns, please don't hesitate to reach out. + +Best, +[Your name] +``` + +### Attachments to include + +1. **Transaction detail spreadsheet** +2. **Root cause analysis document** +3. **Audit defense package** + +## Template 4: Wrong jurisdiction notification + +Use this template when tax was remitted to the wrong jurisdiction. + +### Subject line + +``` +Sales tax sourcing correction required +``` + +### Email body + +``` +Hi [Contact name], + +We identified an issue with how sales tax was sourced for [number] of your transactions between [start date] and [end date]. Due to [brief description of root cause, e.g., "an address hierarchy logic error"], tax was collected and remitted to [incorrect jurisdiction] when it should have been remitted to [correct jurisdiction]. + +The good news: + +The total tax amount collected was correct - we just need to move it from [incorrect jurisdiction] to [correct jurisdiction]. This means there's minimal net impact to your business. + +What needs to happen: + +We'll file two sets of amended returns: + +1. In [incorrect jurisdiction]: Amended return requesting refund of $[amount] +2. In [correct jurisdiction]: Amended return paying $[amount] (plus any applicable interest) + +Timeline expectations: + +• Amended returns will be filed within [timeframe] +• Refunds from [incorrect jurisdiction] typically take 3-6 months +• Payment to [correct jurisdiction] will be processed immediately +• We'll track both processes through completion + +Your involvement: + +Minimal - we'll handle the amendment process and keep you updated on status. You may need to approve the amended returns and payment, depending on your account setup. + +We've attached detailed documentation showing the original sourcing, corrected sourcing, and net impact by jurisdiction. Please let us know if you'd like to schedule a call to walk through the details. + +Best, +[Your name] +``` + +### Attachments to include + +1. **Sourcing analysis spreadsheet** with columns: + - Invoice number + - Invoice date + - Customer name + - Ship-to address + - Original jurisdiction assigned + - Correct jurisdiction + - Tax amount + - Net impact by jurisdiction + +2. **Amendment schedules** for both jurisdictions + +## Template 5: Tardy exemption certificate notification + +Use this template when an exemption certificate was applied late. + +### Subject line + +``` +Exemption certificate applied - amended return required +``` + +### Email body + +``` +Hi [Contact name], + +We've received and applied the exemption certificate for [customer name]. However, since the certificate was received after transactions were processed and reported, we need to file amended returns to correct the reporting. + +Transaction details: + +• [Number] transactions were processed as taxable between [start date] and [end date] +• Total tax reported: $[amount] +• Exemption certificate received: [date] +• Exemption certificate is valid for these transactions + +What needs to happen: + +[If tax was collected:] +1. File amended returns in [jurisdiction(s)] to remove the exempt tax +2. Refund $[amount] to [customer name] +3. Track refund/credit from [jurisdiction(s)] + +[If tax was not collected:] +1. File amended returns in [jurisdiction(s)] to remove the exempt tax +2. No customer refund needed +3. Track refund/credit from [jurisdiction(s)] + +Timeline: + +• Amended returns will be filed within [timeframe] +• [If applicable: Customer refund will be processed within [timeframe]] +• Refunds from jurisdictions typically take 3-6 months + +We've updated our system to ensure [customer name] is properly marked as exempt going forward. Please let us know if you have any questions. + +Best, +[Your name] +``` + +### Attachments to include + +1. **Copy of exemption certificate** +2. **Transaction detail** +3. **Amendment schedule** + +## Template 6: Customer tax recovery letter + +This template is provided to your customer for them to send to their buyers when tax was under-collected. + +### Subject line (for customer to use) + +``` +Important: Sales tax adjustment required +``` + +### Letter body (for customer to use) + +``` +Dear [Buyer name], + +We're writing to inform you of a sales tax adjustment required on your recent purchase(s) from [Customer name]. + +What happened: + +Due to a temporary issue with our tax calculation system, we under-collected sales tax on the following transaction(s): + +[Transaction details - invoice number, date, amount] + +Total additional tax due: $[amount] + +Important information about sales tax: + +Under U.S. sales tax law, sales tax is the buyer's obligation. [Customer name] serves as the collector and remitter of this tax on behalf of the government. When tax is under-collected at the time of sale, the buyer remains responsible for ensuring the tax is paid. + +Your options: + +1. Pay the additional tax to [Customer name] + We will remit this tax to [jurisdiction] on your behalf. Please remit $[amount] to [payment instructions]. + +2. Provide confirmation that you've already paid the use tax + If you've already self-assessed and paid use tax on this purchase to [jurisdiction], please provide us with an affidavit confirming payment, and no further action is needed. + +3. Pay the use tax directly to [jurisdiction] + You may choose to pay the use tax directly to [jurisdiction] and provide us with confirmation of payment. + +Timeline: + +Please respond by [date - typically 30 days] to let us know how you'd like to proceed. + +We apologize for any inconvenience this may cause. This was an isolated issue that has been fully resolved. If you have any questions, please contact [contact name] at [contact email/phone]. + +Sincerely, +[Customer name] +``` + +### Customization notes for your customer + +When providing this template to your customer, include these notes: + +``` +Customization notes: + +• Replace [Buyer name] with your customer's name +• Insert specific transaction details (invoice numbers, dates, amounts) +• Provide your payment instructions +• Set an appropriate response deadline (typically 30 days) +• Include your contact information + +We recommend: + +• Sending via email with read receipt +• Following up with phone call for amounts > $500 +• Keeping detailed records of all communications +• Providing us with copies of responses received + +We're here to support you through this process. If you'd like us to review your final letter before sending, or if you'd like us to participate in any customer conversations, please let us know. +``` + +## Template 7: Customer refund notification + +This template is provided to your customer for them to send to their buyers when tax was over-collected. + +### Subject line (for customer to use) + +``` +Sales tax refund due on your recent purchase +``` + +### Letter body (for customer to use) + +``` +Dear [Buyer name], + +We're writing to inform you that we over-collected sales tax on your recent purchase(s) from [Customer name]. + +What happened: + +Due to an issue with our tax calculation system, we over-collected sales tax on the following transaction(s): + +[Transaction details - invoice number, date, amount] + +Total refund due to you: $[amount] + +Your refund: + +[Option 1 - Credit:] +We've applied a credit of $[amount] to your account, which will be reflected on your next invoice. + +[Option 2 - Direct refund:] +We're processing a refund of $[amount] to [payment method]. Please allow [timeframe] for the refund to appear. + +[Option 3 - Choice:] +Please let us know your preference: +• Credit on your next invoice, or +• Direct refund to [payment method] + +No action is required on your part [or: Please respond by [date] with your refund preference]. + +We apologize for this error. This was an isolated issue that has been fully resolved. If you have any questions, please contact [contact name] at [contact email/phone]. + +Sincerely, +[Customer name] +``` + +### Customization notes for your customer + +``` +Customization notes: + +• Replace [Buyer name] with your customer's name +• Insert specific transaction details +• Choose the appropriate refund option (credit, direct refund, or choice) +• Provide timeline for refund processing +• Include your contact information + +We recommend: + +• Processing refunds promptly (within 30 days) +• Keeping detailed records of all refunds issued +• Providing us with confirmation of refunds completed + +If you need assistance with the refund process or have questions about the best approach for your business, please let us know. +``` + +## Template 8: XYZ letter / Use tax affidavit + +This template is used to request confirmation from buyers that they've paid use tax directly. + +### Subject line + +``` +Request for use tax payment confirmation +``` + +### Letter body + +``` +Dear [Buyer name], + +We're writing regarding sales tax on your purchase(s) from [Customer name]: + +[Transaction details - invoice number, date, amount] + +Our records indicate that sales tax was not collected on this transaction at the time of sale. Under [State] law, if sales tax was not collected, the buyer is responsible for self-assessing and paying use tax directly to the state. + +Please complete and return this affidavit: + +--- + +USE TAX AFFIDAVIT + +I, [Buyer name], hereby certify under penalty of perjury that with respect to the purchase(s) described above: + +☐ I have self-assessed and paid use tax to [State] on this purchase + Date paid: _______________ + Amount paid: $_______________ + +☐ I am exempt from sales/use tax on this purchase + Exemption certificate number: _______________ + Exemption certificate attached: ☐ Yes + +☐ The property was resold and sales tax was collected from my customer + +☐ Other (please explain): _________________________________ + +Signature: _____________________ +Name: _____________________ +Title: _____________________ +Date: _____________________ + +--- + +Please return this completed affidavit to [contact email] by [date - typically 30 days]. + +If you have not paid use tax and are not exempt, you may: +• Pay the use tax directly to [State], or +• Pay the tax to [Customer name] and we will remit it on your behalf + +If you have any questions, please contact [contact name] at [contact email/phone]. + +Sincerely, +[Customer name] +``` + +### Usage notes + +This template is particularly useful in California (where it's called an "XYZ letter") but can be adapted for any state. It provides a formal mechanism for buyers to confirm they've handled their tax obligations. + +## Template 9: Executive escalation notification + +Use this template when escalating to executive team for high-value or complex incidents. + +### Subject line + +``` +URGENT: Sales tax incident requiring executive attention +``` + +### Email body + +``` +[Executive name], + +I'm escalating a sales tax incident that requires executive attention and decision-making. + +Situation summary: + +• Issue: [Brief description] +• Root cause: [Brief description] +• Affected customers: [Number and names of key accounts] +• Financial exposure: $[amount] +• Time period: [Start date] to [end date] +• Filings impacted: [Yes/No and details] + +Customer impact: + +• [Customer name]: $[amount] exposure, [specific concerns] +• [Additional customers as needed] + +Current status: + +• Issue resolved: [Yes/No and when] +• Customer(s) notified: [Yes/No] +• Remediation plan: [Brief description] + +Decisions needed: + +1. [Specific decision point] +2. [Specific decision point] +3. [Specific decision point] + +Recommended approach: + +[Your recommendation with rationale] + +Risks: + +• [Key risk 1] +• [Key risk 2] +• [Key risk 3] + +I'm available to discuss immediately. Please advise on how you'd like to proceed. + +[Your name] +``` + +### Attachments to include + +1. **Detailed incident report** +2. **Financial impact analysis** +3. **Customer communication history** +4. **Proposed remediation plan** + +## Best practices for customer communications + +### Timing + +- **Notify promptly**: Don't delay notification while gathering every detail +- **Follow up regularly**: Keep customers updated on progress +- **Set expectations**: Provide realistic timelines for resolution + +### Tone + +- **Be professional**: Maintain composure even if customer is upset +- **Be empathetic**: Acknowledge the inconvenience +- **Be confident**: Project competence in handling the situation + +### Documentation + +- **Keep records**: Save all customer communications +- **Track responses**: Document customer reactions and decisions +- **Confirm understanding**: Summarize agreements in writing + +### Escalation signals + +Watch for these signals that indicate need for escalation: + +- Customer threatens legal action +- Customer demands Commenda pay the tax +- Customer refuses to follow recommended approach +- Customer is unresponsive after multiple attempts +- Media or regulatory attention +- Situation is deteriorating despite your efforts From f53d4384c2e21868b43a676b4a1d51c5c57d0141 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Tue, 16 Dec 2025 10:39:53 +0530 Subject: [PATCH 40/45] Update product/indirect-tax/incident-response-sop/assessment.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- .../incident-response-sop/assessment.mdx | 742 ++++++++++++++++++ 1 file changed, 742 insertions(+) create mode 100644 product/indirect-tax/incident-response-sop/assessment.mdx diff --git a/product/indirect-tax/incident-response-sop/assessment.mdx b/product/indirect-tax/incident-response-sop/assessment.mdx new file mode 100644 index 000000000..c1933442d --- /dev/null +++ b/product/indirect-tax/incident-response-sop/assessment.mdx @@ -0,0 +1,742 @@ +--- +title: 'Assessment framework' +description: 'Incident evaluation criteria and decision-making framework' +--- + +## Overview + +This framework provides structured criteria for assessing incidents and determining appropriate response levels. Use these dimensions to classify incidents and guide decision-making. + +## Assessment dimensions + +### 1. Scope of impact + +Determines how many customers are affected and whether the issue is isolated or systemic. + +#### 1.1 Single-customer impact + +**Characteristics:** +- Only one legal entity/customer affected +- Often customer-specific configuration or integration issue +- May be reproducible for other customers if triggered the same way + +**Examples:** +- Bad address payload from specific customer +- Customer-specific nexus configuration error +- Customer-specific product mapping issue +- Customer-specific exemption logic error + +**Response level:** Account manager handles with manager oversight + +**Key question:** Is this truly isolated or could it affect others? + +#### 1.2 Multi-customer partial impact + +**Characteristics:** +- Subset of customers affected +- Often tied to specific integration, jurisdiction, or feature +- Most dangerous because it looks isolated but is systemic + +**Examples:** +- Customers using specific integration (e.g., Shopify only) +- Customers in specific jurisdiction (e.g., CA sourcing rule bug) +- Customers using specific feature (MPU, marketplace logic, reverse charge) + +**Response level:** Manager involvement required; potential SWAT team + +**Key question:** What's the common factor? How many customers share it? + +#### 1.3 Global impact + +**Characteristics:** +- All customers or all transactions affected +- Platform-level issue +- Immediate escalation required + +**Examples:** +- Tax engine unavailable +- Core ruleset regression +- Address resolution failure +- Rate service failure + +**Response level:** Immediate SWAT team activation; executive involvement + +**Key question:** How quickly can we contain and resolve? + +### 2. Temporal nature + +Determines when the issue occurred and how long it persisted. + +#### 2.1 Hard downtime + +**Characteristics:** +- Tax calculation endpoint unavailable +- Timeouts/5xx errors +- Explicit fail-closed behavior + +**Risk profile:** +- Missed tax collection +- Missing invoice fields +- Customer operational blockage +- Highly visible to customers + +**Response level:** Immediate; P0 incident + +**Key question:** How long was service unavailable? + +#### 2.2 Soft downtime + +**Characteristics:** +- Calculations occur but are wrong +- More dangerous than hard downtime +- Often detected late + +**Examples:** +- Zero tax applied incorrectly +- Wrong jurisdiction sourced +- Wrong rate applied +- Exempt logic misfiring + +**Risk profile:** +- Historical correction required +- Compliance implications +- Customer trust impact +- May affect filed returns + +**Response level:** High priority; requires immediate investigation + +**Key question:** How long before we detected it? + +#### 2.3 Intermittent/partial failures + +**Characteristics:** +- Only some transactions fail +- Retry-dependent behavior +- Time-window specific + +**Risk profile:** +- Hardest to detect and explain +- Difficult to reproduce +- Customer confusion + +**Response level:** Moderate to high; requires detailed investigation + +**Key question:** Can we identify the pattern? + +### 3. Financial exposure magnitude + +Determines the dollar value at risk. + +#### 3.1 De minimis exposure + +**Threshold:** < $1,000 total misreported tax + +**Characteristics:** +- Low volume or test transactions +- No filings impacted yet +- Minimal customer impact + +**Response level:** Account manager handles; document and inform + +**Remedy approach:** Low-dollar, low-visibility (Scenario 1) + +#### 3.2 Material but contained exposure + +**Threshold:** $1,000 - $10,000 + +**Characteristics:** +- One or two jurisdictions +- May affect filed vs. unfiled boundary +- Moderate customer impact + +**Response level:** Manager oversight required + +**Remedy approach:** Standard remediation (Scenarios 2-5) + +#### 3.3 Material and reportable exposure + +**Threshold:** $10,000 - $100,000 + +**Characteristics:** +- Multiple jurisdictions +- Potential customer restatement or amended filings +- Significant customer impact + +**Response level:** Executive involvement required + +**Remedy approach:** Enhanced support; potential fee credits + +#### 3.4 Systemic financial risk + +**Threshold:** > $100,000 or growing without cap + +**Characteristics:** +- Exposure grows with every transaction +- No natural cap +- Time-sensitive to stop propagation + +**Response level:** SWAT team activation; executive leadership + +**Remedy approach:** All available resources; potential customer tax recovery services + +### 4. Compliance lifecycle impact + +Determines where in the tax lifecycle the error occurred. + +#### 4.1 Pre-invoice + +**Characteristics:** +- Checkout failures +- Draft invoices +- Quoting flows +- No compliance filing impact yet + +**Risk profile:** +- Customer operational impact +- Revenue blocking +- No regulatory exposure yet + +**Response level:** Moderate to high depending on customer impact + +**Remediation complexity:** Low - can be corrected before finalization + +#### 4.2 Post-invoice, pre-filing + +**Characteristics:** +- Incorrect tax on issued invoices +- Can be corrected via credit memos/re-invoicing +- Not yet reported to jurisdictions + +**Risk profile:** +- Customer relationship impact +- Billing corrections needed +- No regulatory exposure yet + +**Response level:** Moderate to high + +**Remediation complexity:** Moderate - requires customer coordination + +#### 4.3 Post-filing + +**Characteristics:** +- Returns already filed with incorrect data +- Triggers amendments, penalties, interest +- High reputational risk + +**Risk profile:** +- Regulatory visibility +- Potential penalties and interest +- Audit risk +- Significant remediation effort + +**Response level:** High to critical + +**Remediation complexity:** High - requires amended returns and jurisdiction coordination + +### 5. Direction of error + +Determines whether tax was over-collected, under-collected, or mis-sourced. + +#### 5.1 Under-collection + +**Characteristics:** +- Tax not charged when it should have been +- Customer absorbs liability or must recover from end customers +- Higher customer urgency + +**Risk profile:** +- Customer out-of-pocket +- Customer relationship strain +- Difficult recovery from end customers +- Audit exposure + +**Response level:** High - customer will escalate quickly + +**Remedy approach:** Scenario 2 (Under-collection) + +#### 5.2 Over-collection + +**Characteristics:** +- Excess tax charged +- Refund obligations +- Customer trust issue + +**Risk profile:** +- Customer complaints +- Refund processing required +- Lower regulatory risk +- Reputational impact + +**Response level:** High - customer complaints drive urgency + +**Remedy approach:** Scenario 3 (Over-collection) + +#### 5.3 Misclassification without immediate dollar impact + +**Characteristics:** +- Wrong tax code +- Wrong exemption tagging +- Latent risk that materializes later + +**Risk profile:** +- May not be immediately visible +- Audit risk +- Future compliance issues + +**Response level:** Moderate - depends on potential future impact + +**Remedy approach:** Varies based on specific misclassification + +### 6. Detectability and observability + +Determines how the issue was discovered. + +#### 6.1 Customer-reported + +**Characteristics:** +- Found via support ticket +- Often already escalated emotionally +- Customer may have already contacted their customers + +**Response level:** High - customer is already upset + +**Approach:** +- Acknowledge immediately +- Investigate urgently +- Provide frequent updates +- Escalate if needed + +#### 6.2 Internally detected (automated) + +**Characteristics:** +- Monitoring/anomaly detection +- Rate spikes, zero-tax anomalies, jurisdiction drift +- Caught before customer notices + +**Response level:** Moderate to high depending on impact + +**Approach:** +- Investigate thoroughly before notifying customer +- Prepare complete analysis +- Proactive notification +- Demonstrate competence + +#### 6.3 Latent/discovered during filing + +**Characteristics:** +- Found weeks later +- Highest remediation cost +- Customer may be surprised + +**Response level:** High - requires careful communication + +**Approach:** +- Complete investigation first +- Prepare comprehensive remediation plan +- Emphasize that we caught it before audit +- Provide full support + +### 7. Blast radius expansion risk + +Determines whether the issue is growing or contained. + +#### 7.1 Static + +**Characteristics:** +- Historical only +- No new transactions affected +- Issue is resolved + +**Response level:** Moderate - focus on remediation + +**Approach:** +- Quantify total impact +- Execute remediation plan +- Document lessons learned + +#### 7.2 Growing + +**Characteristics:** +- Every new transaction compounds exposure +- Issue is ongoing +- Urgent containment needed + +**Response level:** Critical - stop the bleeding first + +**Approach:** +- Immediate containment +- Halt affected processes if necessary +- Fix before full remediation +- Communicate status to customers + +#### 7.3 Cascading + +**Characteristics:** +- Downstream systems affected +- Reporting, filings, ledger exports impacted +- Multiple systems need correction + +**Response level:** Critical - SWAT team activation + +**Approach:** +- Map all affected systems +- Coordinate cross-functional response +- Prioritize containment +- Systematic remediation + +### 8. Customer operational dependence + +Determines how critical tax calculation is to customer's business flow. + +#### 8.1 Non-blocking + +**Characteristics:** +- Back-office reconciliation only +- Customer can continue operations +- Lower urgency + +**Response level:** Moderate + +**Approach:** +- Standard remediation timeline +- Regular updates +- Focus on accuracy over speed + +#### 8.2 Revenue-blocking + +**Characteristics:** +- Checkout or invoicing blocked +- Customer cannot process sales +- High urgency + +**Response level:** Critical - P0 incident + +**Approach:** +- Immediate response +- Workaround if possible +- Frequent updates (hourly if needed) +- Executive involvement + +#### 8.3 Regulator-facing + +**Characteristics:** +- Real-time e-invoicing +- SAF-T reporting +- Clearance models +- Regulatory deadline risk + +**Response level:** Critical - regulatory implications + +**Approach:** +- Immediate escalation +- Regulatory expertise involved +- Coordinate with customer's compliance team +- Document everything + +### 9. Regulatory sensitivity + +Determines jurisdiction-specific risk factors. + +#### High-sensitivity jurisdictions + +**Characteristics:** +- Real-time reporting requirements (e.g., Brazil, Italy, Mexico) +- High penalty severity +- Aggressive audit practices +- Short correction windows + +**Examples:** +- Brazil (NF-e) +- Italy (FatturaPA) +- Mexico (CFDI) +- California (aggressive audits) + +**Response level:** Elevated for these jurisdictions + +**Approach:** +- Involve jurisdiction specialists +- Prioritize these jurisdictions in remediation +- Extra documentation +- Consider local counsel + +#### Moderate-sensitivity jurisdictions + +**Characteristics:** +- Standard audit practices +- Reasonable correction windows +- Moderate penalties + +**Examples:** +- Most U.S. states +- Canada +- UK + +**Response level:** Standard + +**Approach:** +- Follow standard remediation procedures +- Document thoroughly +- Timely corrections + +#### Low-sensitivity jurisdictions + +**Characteristics:** +- Infrequent audits +- Low penalties +- Flexible correction processes + +**Response level:** Standard to low + +**Approach:** +- Standard remediation +- May prioritize other jurisdictions first + +### 10. Internal responsibility classification + +Determines accountability and response approach. + +#### Platform bug + +**Characteristics:** +- Core tax engine issue +- Affects multiple customers +- Commenda's responsibility + +**Response approach:** +- Full ownership +- Proactive notification +- Enhanced support +- Consider fee credits + +#### Content/rules bug + +**Characteristics:** +- Tax rate or rule error +- Often jurisdiction-specific +- Commenda's responsibility + +**Response approach:** +- Full ownership +- Verify with jurisdiction +- Proactive notification +- Standard support + +#### Integration bug + +**Characteristics:** +- Connector or API issue +- May be Commenda or third-party +- Shared responsibility + +**Response approach:** +- Determine root cause +- Coordinate with third party if needed +- Proactive notification +- Standard support + +#### Customer misconfiguration + +**Characteristics:** +- Customer setup error +- Customer's responsibility +- Commenda provides guidance + +**Response approach:** +- Educate customer +- Help correct configuration +- May charge for extensive support +- Document proper setup + +#### Third-party dependency failure + +**Characteristics:** +- External service issue +- Outside Commenda's control +- Shared impact + +**Response approach:** +- Coordinate with third party +- Keep customer informed +- Provide workarounds if possible +- Document for SLA purposes + +## Decision matrix + +Use this matrix to determine response level based on key factors: + +| Exposure | Customers | Filings | Response level | Approval needed | +|----------|-----------|---------|----------------|-----------------| +| < $1K | Single | None | Low | Account manager | +| < $5K | Single | None | Moderate | Manager | +| < $5K | Multiple | None | High | Manager | +| $5K-$10K | Single | None | High | Manager | +| $5K-$10K | Multiple | None | Critical | Executive | +| $10K-$100K | Any | None | Critical | Executive | +| > $100K | Any | Any | SWAT team | Executive | +| Any | Any | Filed | +1 level | +1 level | +| Any | Revenue-blocking | Any | Critical | Executive | + +## Assessment checklist + +Use this checklist when assessing any incident: + +### Initial assessment (within 1 hour) + +- [ ] How was issue detected? +- [ ] Is issue ongoing or resolved? +- [ ] How many customers affected? +- [ ] Estimated financial exposure? +- [ ] Are customers blocked from operations? +- [ ] Have any returns been filed? + +### Detailed assessment (within 4 hours) + +- [ ] Exact customer list identified? +- [ ] Precise financial exposure calculated? +- [ ] Root cause identified? +- [ ] Fix verified? +- [ ] Compliance lifecycle impact determined? +- [ ] Direction of error confirmed? +- [ ] Blast radius assessed? +- [ ] Regulatory sensitivity evaluated? +- [ ] Responsibility determined? + +### Remediation planning (within 8 hours) + +- [ ] Scenario classification determined? +- [ ] Remediation approach selected? +- [ ] Customer communications drafted? +- [ ] Approval obtained? +- [ ] Resources allocated? +- [ ] Timeline established? + +### Execution tracking (ongoing) + +- [ ] Customers notified? +- [ ] Remediation actions in progress? +- [ ] Customer responses tracked? +- [ ] Technical corrections completed? +- [ ] Documentation maintained? +- [ ] Lessons learned captured? + +## Escalation triggers + +Escalate immediately if any of these conditions are met: + +### To manager + +- Exposure > $5,000 +- Multiple customers affected +- Customer is upset or threatening +- Unclear how to proceed +- Issue is growing + +### To executive team + +- Exposure > $10,000 +- Filed returns impacted +- Customer threatens legal action +- Media attention +- Regulatory inquiry +- Platform-wide issue + +### To SWAT team + +- Exposure > $100,000 +- Real-time reporting jurisdictions affected +- Cascading downstream effects +- Reputational risk +- Multiple executives involved + +## Common assessment mistakes + +### Underestimating scope + +**Mistake:** Assuming issue is isolated when it's actually systemic + +**Prevention:** +- Always ask: "Could this affect other customers?" +- Check for common factors (integration, jurisdiction, feature) +- Review recent changes that could have broader impact + +### Overestimating urgency + +**Mistake:** Treating every issue as critical + +**Prevention:** +- Use decision matrix objectively +- Consider actual customer impact, not just dollar amount +- Distinguish between urgent and important + +### Delayed escalation + +**Mistake:** Trying to handle beyond your authority level + +**Prevention:** +- Escalate early when in doubt +- Use escalation triggers as guide +- Better to escalate unnecessarily than too late + +### Incomplete assessment + +**Mistake:** Starting remediation before full assessment + +**Prevention:** +- Complete assessment checklist +- Gather all facts first +- Don't rush to solutions + +### Poor documentation + +**Mistake:** Not documenting assessment and decisions + +**Prevention:** +- Document as you go +- Record key decisions and rationale +- Maintain audit trail + +## Assessment tools + +### Exposure calculator + +``` +Total Exposure = Σ (Transaction Amount × Tax Rate Difference) + +Where: +- Transaction Amount = Taxable amount per transaction +- Tax Rate Difference = |Correct Rate - Applied Rate| +- Σ = Sum across all affected transactions +``` + +### Customer impact score + +``` +Impact Score = (Exposure × Urgency × Relationship Value) / 1000 + +Where: +- Exposure = Dollar amount +- Urgency = 1 (low) to 5 (critical) +- Relationship Value = 1 (small) to 5 (strategic) + +Score > 50 = Executive involvement +Score 20-50 = Manager involvement +Score < 20 = Account manager handles +``` + +### Remediation complexity score + +``` +Complexity = (Customers × Jurisdictions × Filing Status × Direction) + +Where: +- Customers = Number affected +- Jurisdictions = Number affected +- Filing Status = 1 (pre-filing) or 3 (post-filing) +- Direction = 1 (over) or 2 (under) or 3 (wrong jurisdiction) + +Score > 50 = High complexity (SWAT team) +Score 20-50 = Moderate complexity (Manager + team) +Score < 20 = Low complexity (Account manager) +``` + +Use these tools as guides, not absolute rules. Apply judgment based on specific circumstances. From 428f3e29acc764d3a411f7455dd8e58f4edf9fed Mon Sep 17 00:00:00 2001 From: samsuechting Date: Tue, 16 Dec 2025 10:40:13 +0530 Subject: [PATCH 41/45] Update docs.json Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs.json | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs.json b/docs.json index 60388edb7..8206862ad 100644 --- a/docs.json +++ b/docs.json @@ -86,7 +86,11 @@ { "group": "Incident Response SOP", "pages": [ - "product/indirect-tax/incident-response-sop/overview" + "product/indirect-tax/incident-response-sop/overview", + "product/indirect-tax/incident-response-sop/scenarios", + "product/indirect-tax/incident-response-sop/remediation", + "product/indirect-tax/incident-response-sop/templates", + "product/indirect-tax/incident-response-sop/assessment" ] }, { From 23568919d4d508b13bc24df7e9ac7bc6742b0f18 Mon Sep 17 00:00:00 2001 From: samsuechting Date: Tue, 16 Dec 2025 11:40:07 +0530 Subject: [PATCH 42/45] Add service guarantees documentation (#12) * Update product/indirect-tax/guarantees.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * Update docs.json Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs.json | 1 + product/indirect-tax/guarantees.mdx | 511 ++++++++++++++++++++++++++++ 2 files changed, 512 insertions(+) create mode 100644 product/indirect-tax/guarantees.mdx diff --git a/docs.json b/docs.json index 8206862ad..00f186a27 100644 --- a/docs.json +++ b/docs.json @@ -83,6 +83,7 @@ { "group": "Indirect Tax", "pages": [ + "product/indirect-tax/guarantees", { "group": "Incident Response SOP", "pages": [ diff --git a/product/indirect-tax/guarantees.mdx b/product/indirect-tax/guarantees.mdx new file mode 100644 index 000000000..2bdea2939 --- /dev/null +++ b/product/indirect-tax/guarantees.mdx @@ -0,0 +1,511 @@ +--- +title: 'Service guarantees' +description: 'Accuracy and on-time filing guarantees for indirect tax services' +icon: 'shield-check' +--- + +## Overview + +Commenda provides two service guarantees for indirect tax services: the Accuracy Guarantee and the On-Time Filing Guarantee. These guarantees protect customers from financial exposure due to Commenda's errors, subject to specific conditions and caps. + +Both guarantees are capped at the **Rolling ACV** - the fees paid to Commenda for the Services during the twelve (12) months preceding the tax period at issue. + +## Accuracy guarantee + +### What's covered + +If you properly configure and use the Services and Commenda's tax calculation, rate, or taxability determination is inaccurate such that your return is filed incorrectly and a tax authority assesses uncollected sales tax, penalties, or interest (collectively, "Tax Shortfall"), Commenda will reimburse or credit you for the Tax Shortfall. + +### Coverage cap + +Reimbursement is capped at the **Rolling ACV** - the fees you paid to Commenda during the twelve (12) months preceding the tax period at issue. + +### How it works + +#### Step 1: Receive assessment notice + +You receive a notice from a tax authority assessing uncollected sales tax, penalties, or interest due to an inaccuracy in Commenda's tax calculation, rate, or taxability determination. + +#### Step 2: Notify Commenda (within 14 days) + +You must notify Commenda in writing within **fourteen (14) days** after receiving the first notice of assessment. + +**Required information:** +- Copy of the assessment notice +- Tax period(s) affected +- Jurisdiction(s) involved +- Amount assessed (tax, penalties, interest) +- Description of the transactions at issue + +**How to notify:** +- Email: [support contact] +- Subject line: "Accuracy Guarantee Claim - [Your Company Name]" +- Include all required documentation + +#### Step 3: Cooperate with investigation + +You must provide all relevant information and reasonably cooperate with Commenda's investigation and any effort to contest or mitigate the assessment. + +**This includes:** +- Transaction data and records +- Configuration settings used +- Communication with tax authority +- Supporting documentation requested by Commenda +- Participation in calls or meetings as needed +- Authorization for Commenda to communicate with tax authority (if needed) + +#### Step 4: Commenda investigates + +Commenda will: +- Review the assessment and underlying transactions +- Verify whether the error was due to Commenda's calculation, rate, or taxability determination +- Determine if all guarantee conditions are met +- Assess whether the assessment can be contested or mitigated +- Calculate the covered amount (up to Rolling ACV cap) + +#### Step 5: Resolution + +If the guarantee applies, Commenda will: +- Reimburse you for the covered Tax Shortfall, or +- Apply a credit to your account for the covered amount + +**Timeline:** Commenda will make a determination and provide reimbursement or credit within a reasonable timeframe after completing the investigation. + +### What's NOT covered + +The Accuracy Guarantee does not apply to errors caused by: + +#### 1. Customer's incorrect or incomplete data or configurations + +**Examples:** +- Wrong addresses provided +- Incorrect product taxability mappings +- Missing or invalid exemption certificates +- Incorrect nexus settings +- Wrong customer classifications +- Incomplete transaction data + +**Why it matters:** Commenda's calculations are only as accurate as the data provided. If you provide incorrect information or misconfigure the system, the guarantee doesn't apply. + +#### 2. Legal positions or classifications selected by customer + +**Examples:** +- Customer chooses to treat a product as non-taxable when it's actually taxable +- Customer selects a specific tax treatment based on their legal interpretation +- Customer decides not to collect tax in a jurisdiction where they have nexus +- Customer applies an exemption based on their legal position + +**Why it matters:** When you make legal or classification decisions, you own the outcome. Commenda provides tools and guidance, but ultimate responsibility for legal positions rests with you. + +#### 3. Changes in law after the transaction date + +**Examples:** +- Tax rate increases after transaction but before filing +- New taxability rules enacted retroactively +- Jurisdiction changes sourcing rules +- New exemption requirements imposed + +**Why it matters:** Commenda maintains current tax content, but cannot predict or be responsible for retroactive legal changes. + +#### 4. Events outside Commenda's reasonable control + +**Examples:** +- Third-party service failures (geocoding, address validation) +- Force majeure events +- Customer's system failures affecting data transmission +- Tax authority system errors +- Jurisdiction provides incorrect guidance + +**Why it matters:** Commenda cannot guarantee against events beyond our control. + +### Sole and exclusive remedy + +The remedies in the Accuracy Guarantee are your sole and exclusive remedies for inaccuracies in tax calculations or content. This means: + +- You cannot seek additional damages beyond the Rolling ACV cap +- You cannot pursue other legal remedies for covered inaccuracies +- The guarantee represents the full extent of Commenda's liability for calculation errors + +## On-time filing guarantee + +### What's covered + +If you have met all your obligations and Commenda fails to file a sales tax return by its statutory due date solely due to Commenda's error, Commenda will: + +1. **Complete and submit the delinquent filing** at no additional charge +2. **Waive or refund any service fee** for that return +3. **Pay any late-filing penalties and interest** imposed by the tax authority, up to the Rolling ACV cap + +### Coverage cap + +Payment of penalties and interest is capped at the **Rolling ACV** - the fees you paid to Commenda during the twelve (12) months preceding the tax period at issue. + +### How it works + +#### Step 1: Discover missed deadline + +You discover that a return was not filed by its statutory due date, or you receive a penalty notice from a tax authority for late filing. + +#### Step 2: Notify Commenda (within 10 days) + +You must notify Commenda within **ten (10) days** of discovering the missed deadline or receiving a penalty notice to qualify for the guarantee. + +**Required information:** +- Jurisdiction and tax type +- Filing period +- Statutory due date +- Date you discovered the issue or received penalty notice +- Copy of penalty notice (if applicable) + +**How to notify:** +- Email: [support contact] +- Subject line: "On-Time Filing Guarantee Claim - [Your Company Name]" +- Include all required documentation + +#### Step 3: Commenda investigates + +Commenda will: +- Verify the statutory due date +- Review the filing timeline and any communications +- Determine if the late filing was solely due to Commenda's error +- Verify that you met all your obligations +- Assess whether any exclusions apply + +#### Step 4: Resolution + +If the guarantee applies, Commenda will: +1. **Immediately file the delinquent return** (if not already filed) +2. **Waive or refund the service fee** for that return +3. **Pay the late-filing penalties and interest** (up to Rolling ACV cap) + +### Your obligations (Section 2 requirements) + +To qualify for the On-Time Filing Guarantee, you must have met all obligations, which typically include: + +#### Timely data provision + +- Provide complete and accurate transaction data by agreed-upon deadlines +- Respond to data quality issues or questions promptly +- Ensure data feeds or integrations are functioning properly + +#### Sufficient funds + +- Maintain sufficient funds in your account for tax payments +- Provide payment authorization in advance of due dates +- Respond to payment issues promptly + +#### Required tax accounts + +- Maintain active tax registration accounts in all required jurisdictions +- Provide Commenda with current login credentials or filing authorization +- Notify Commenda of any account status changes + +#### Timely approvals + +- Review and approve returns by agreed-upon deadlines +- Respond to questions or issues that require your input +- Provide necessary documentation when requested + +#### Accurate configuration + +- Maintain accurate nexus settings +- Keep product taxability mappings current +- Update exemption certificates as needed + +### What's NOT covered + +The On-Time Filing Guarantee does not apply to late filings caused by: + +#### 1. Customer's delayed or inaccurate data + +**Examples:** +- Transaction data provided after the deadline +- Incomplete or incorrect transaction data requiring correction +- Data quality issues that delay processing +- Integration failures on customer's side + +**Why it matters:** Commenda cannot file returns without complete, accurate data. Late data provision shifts responsibility to you. + +#### 2. Insufficient funds + +**Examples:** +- Insufficient balance for tax payment +- Payment authorization not provided +- Payment method declined or failed +- Customer delays payment approval + +**Why it matters:** Returns cannot be filed without payment. Ensuring sufficient funds is your responsibility. + +#### 3. Failure to maintain required tax accounts + +**Examples:** +- Tax registration account suspended or closed +- Login credentials expired or invalid +- Filing authorization revoked or expired +- Account locked due to prior issues + +**Why it matters:** Commenda cannot file to accounts that are not active and accessible. + +#### 4. Events outside Commenda's reasonable control + +**Examples:** +- Tax authority system outages on filing deadline +- Force majeure events +- Third-party service failures +- Jurisdiction changes filing requirements without notice + +**Why it matters:** Commenda cannot guarantee against events beyond our control. + +#### 5. Customer delays in approvals or responses + +**Examples:** +- Return approval delayed past internal deadline +- Questions or issues not addressed timely +- Required documentation not provided +- Customer unavailable during critical filing window + +**Why it matters:** Filing deadlines require timely customer participation. Delays on your end shift responsibility to you. + +## Guarantee comparison + +| Feature | Accuracy guarantee | On-time filing guarantee | +|---------|-------------------|-------------------------| +| **What's covered** | Tax Shortfall from inaccurate calculations | Late-filing penalties and interest | +| **Coverage cap** | Rolling ACV | Rolling ACV | +| **Notification deadline** | 14 days after first assessment notice | 10 days after discovering issue | +| **Additional remedies** | Reimbursement or credit | Delinquent filing + fee waiver + penalties | +| **Key exclusion** | Customer data/configuration errors | Customer delays or insufficient funds | +| **Cooperation required** | Yes - investigation and mitigation | Yes - meeting all obligations | + +## How to maximize guarantee protection + +### For accuracy guarantee + +#### 1. Provide complete, accurate data + +- Verify addresses are correct and complete +- Ensure product taxability mappings are accurate +- Keep exemption certificates current +- Maintain accurate nexus settings + +#### 2. Configure properly + +- Follow Commenda's configuration guidance +- Test configurations before going live +- Review configuration regularly +- Update settings when business changes + +#### 3. Document everything + +- Keep records of all transactions +- Save configuration settings and changes +- Document legal positions and decisions +- Maintain audit trail + +#### 4. Notify promptly + +- Monitor for assessment notices +- Notify Commenda within 14 days +- Provide complete documentation +- Respond to information requests quickly + +#### 5. Cooperate fully + +- Participate in investigation +- Provide requested information +- Authorize Commenda to communicate with tax authority +- Work collaboratively on mitigation + +### For on-time filing guarantee + +#### 1. Meet all deadlines + +- Provide data by agreed-upon deadlines +- Approve returns promptly +- Respond to questions quickly +- Don't delay critical decisions + +#### 2. Maintain account health + +- Keep sufficient funds available +- Maintain active tax accounts +- Keep credentials current +- Monitor account status + +#### 3. Ensure data quality + +- Validate data before submission +- Address data quality issues promptly +- Test integrations regularly +- Monitor data feeds + +#### 4. Communicate proactively + +- Notify Commenda of business changes +- Report issues immediately +- Respond to communications promptly +- Keep contact information current + +#### 5. Plan ahead + +- Build buffer time before deadlines +- Don't wait until last minute for approvals +- Address issues early +- Maintain backup payment methods + +## Common guarantee scenarios + +### Scenario 1: Inaccurate rate applied + +**Situation:** Commenda applied a 7% rate when the correct rate was 8%. Tax authority assesses $5,000 in uncollected tax plus $500 in penalties and interest. + +**Guarantee applies?** Yes, if: +- You provided correct address and transaction data +- You properly configured the system +- You notify within 14 days +- You cooperate with investigation + +**Covered amount:** $5,500 (tax + penalties + interest), up to Rolling ACV cap + +### Scenario 2: Wrong product taxability + +**Situation:** You classified a product as non-taxable based on your legal interpretation. Tax authority disagrees and assesses $10,000. + +**Guarantee applies?** No - this is a legal position selected by customer (exclusion #2) + +**Your responsibility:** You own the outcome of legal classification decisions + +### Scenario 3: Late filing due to customer data delay + +**Situation:** You provided transaction data 3 days late. Commenda filed the return 2 days after the due date. Tax authority assesses $200 in late-filing penalties. + +**Guarantee applies?** No - late filing was caused by customer's delayed data (exclusion #1) + +**Your responsibility:** You're responsible for penalties due to your data delay + +### Scenario 4: Late filing due to Commenda error + +**Situation:** You provided all data on time and approved the return 5 days before the due date. Commenda failed to submit the return due to an internal processing error. Tax authority assesses $300 in penalties. + +**Guarantee applies?** Yes, if: +- You met all obligations (timely data, approval, sufficient funds) +- You notify within 10 days +- Late filing was solely due to Commenda's error + +**Covered amount:** $300 in penalties + fee waiver for that return, up to Rolling ACV cap + +### Scenario 5: Incorrect address provided + +**Situation:** You provided a billing address instead of shipping address. Commenda calculated tax for the wrong jurisdiction. Tax authority assesses $3,000 in uncollected tax. + +**Guarantee applies?** No - this is customer's incorrect data (exclusion #1) + +**Your responsibility:** You're responsible for providing correct addresses + +### Scenario 6: Retroactive law change + +**Situation:** A jurisdiction retroactively changed a product's taxability. Commenda's calculation was correct at the time of transaction but is now deemed incorrect. Tax authority assesses $8,000. + +**Guarantee applies?** No - this is a change in law after the transaction date (exclusion #3) + +**Your responsibility:** Retroactive law changes are not covered by the guarantee + +## Frequently asked questions + +### What is "Rolling ACV"? + +Rolling ACV is the total fees you paid to Commenda for the Services during the twelve (12) months preceding the tax period at issue. This is the cap for both guarantees. + +**Example:** If the tax period at issue is Q2 2024, Rolling ACV is the fees you paid from Q2 2023 through Q1 2024. + +### Can I get more than Rolling ACV in coverage? + +No. Both guarantees are capped at Rolling ACV. This is your maximum recovery under either guarantee. + +### What if I disagree with Commenda's determination? + +If you believe the guarantee should apply but Commenda determines it doesn't, you should: +1. Request a detailed explanation of the determination +2. Provide any additional information that supports your position +3. Escalate to executive team if needed +4. Review your service agreement for dispute resolution procedures + +### Do the guarantees cover state income tax or other taxes? + +No. These guarantees specifically cover sales tax (indirect tax) services only. They do not cover income tax, payroll tax, or other tax types. + +### What if multiple issues occur in the same period? + +Each issue is evaluated separately. However, the total recovery across all issues is still capped at Rolling ACV for that period. + +### How long does the investigation take? + +Investigation timelines vary based on complexity. Commenda will: +- Acknowledge your claim within 2 business days +- Provide initial assessment within 10 business days +- Complete investigation within 30 days (for most cases) +- Communicate timeline if more time is needed + +### What if the tax authority is wrong? + +If Commenda believes the tax authority's assessment is incorrect, we will: +- Work with you to contest the assessment +- Provide supporting documentation and analysis +- Participate in appeals or protests (as appropriate) +- Help minimize or eliminate the assessment + +If the assessment is successfully reduced or eliminated, the guarantee covers only the final assessed amount. + +### Can I purchase additional coverage? + +The guarantees are included with your service agreement and cannot be increased beyond Rolling ACV. However, you may want to consider: +- Maintaining your own tax liability insurance +- Increasing your Rolling ACV by using more Commenda services +- Working with your insurance broker on additional coverage + +### What happens if Commenda goes out of business? + +The guarantees are only valid while Commenda is operating. Consider: +- Maintaining your own documentation and records +- Having backup tax service providers identified +- Maintaining tax liability insurance +- Keeping sufficient reserves for potential tax liabilities + +## Best practices for guarantee claims + +### Do's + +- **Notify promptly** - Don't wait until the deadline +- **Provide complete documentation** - Include everything requested +- **Cooperate fully** - Respond quickly to information requests +- **Document everything** - Keep records of all communications +- **Be professional** - Work collaboratively with Commenda +- **Follow up** - Check on status if you haven't heard back + +### Don'ts + +- **Don't delay notification** - Missing the deadline disqualifies your claim +- **Don't withhold information** - Full disclosure is required +- **Don't ignore requests** - Lack of cooperation can disqualify your claim +- **Don't make assumptions** - Ask questions if you're unsure +- **Don't escalate prematurely** - Give the process time to work +- **Don't agree to settlements** - Consult with Commenda before agreeing to anything with tax authority + +## Related documentation + +- [Incident Response SOP](/product/indirect-tax/incident-response-sop/overview) - How Commenda handles tax incidents +- [Scenario classification](/product/indirect-tax/incident-response-sop/scenarios) - Types of tax issues and remedies +- [Communication templates](/product/indirect-tax/incident-response-sop/templates) - Templates for customer communications + +## Contact information + +For guarantee claims or questions: + +- **Email:** [support contact] +- **Subject line format:** "Accuracy Guarantee Claim" or "On-Time Filing Guarantee Claim" +- **Include:** Your company name, account number, and brief description + +For general questions about guarantees: +- Review your service agreement +- Contact your account manager +- Email [support contact] From 75b0f4bbb163b903ccaffc08f525d1c26f5066bb Mon Sep 17 00:00:00 2001 From: Sam Suechting Date: Tue, 16 Dec 2025 12:01:02 +0530 Subject: [PATCH 43/45] Update guarantees.mdx: remove Section 2 language, replace 'pay' with 'reimburse', rewrite for internal audience, remove contact info, fix formatting --- product/indirect-tax/guarantees.mdx | 251 +++++++++++++--------------- 1 file changed, 120 insertions(+), 131 deletions(-) diff --git a/product/indirect-tax/guarantees.mdx b/product/indirect-tax/guarantees.mdx index 2bdea2939..31143ad83 100644 --- a/product/indirect-tax/guarantees.mdx +++ b/product/indirect-tax/guarantees.mdx @@ -1,34 +1,34 @@ --- title: 'Service guarantees' -description: 'Accuracy and on-time filing guarantees for indirect tax services' +description: 'Internal reference for accuracy and on-time filing guarantees' icon: 'shield-check' --- ## Overview -Commenda provides two service guarantees for indirect tax services: the Accuracy Guarantee and the On-Time Filing Guarantee. These guarantees protect customers from financial exposure due to Commenda's errors, subject to specific conditions and caps. +Commenda provides two service guarantees for indirect tax services: the **Accuracy Guarantee** and the **On-Time Filing Guarantee**. These guarantees protect customers from financial exposure due to Commenda errors, subject to specific conditions and caps. -Both guarantees are capped at the **Rolling ACV** - the fees paid to Commenda for the Services during the twelve (12) months preceding the tax period at issue. +Both guarantees are capped at the **Rolling ACV** — the fees the customer paid to Commenda for Services during the twelve (12) months preceding the tax period at issue. ## Accuracy guarantee ### What's covered -If you properly configure and use the Services and Commenda's tax calculation, rate, or taxability determination is inaccurate such that your return is filed incorrectly and a tax authority assesses uncollected sales tax, penalties, or interest (collectively, "Tax Shortfall"), Commenda will reimburse or credit you for the Tax Shortfall. +If the customer properly configures and uses the Services and Commenda's tax calculation, rate, or taxability determination is inaccurate such that the return is filed incorrectly and a tax authority assesses uncollected sales tax, penalties, or interest (collectively, "Tax Shortfall"), Commenda will reimburse or credit the customer for the Tax Shortfall. ### Coverage cap -Reimbursement is capped at the **Rolling ACV** - the fees you paid to Commenda during the twelve (12) months preceding the tax period at issue. +Reimbursement is capped at the **Rolling ACV** — the fees the customer paid to Commenda during the twelve (12) months preceding the tax period at issue. -### How it works +### Process -#### Step 1: Receive assessment notice +#### Step 1: Customer receives assessment notice -You receive a notice from a tax authority assessing uncollected sales tax, penalties, or interest due to an inaccuracy in Commenda's tax calculation, rate, or taxability determination. +Customer receives a notice from a tax authority assessing uncollected sales tax, penalties, or interest due to an inaccuracy in Commenda's tax calculation, rate, or taxability determination. -#### Step 2: Notify Commenda (within 14 days) +#### Step 2: Customer notifies Commenda (within 14 days) -You must notify Commenda in writing within **fourteen (14) days** after receiving the first notice of assessment. +Customer must notify Commenda in writing within **fourteen (14) days** after receiving the first notice of assessment. **Required information:** - Copy of the assessment notice @@ -37,14 +37,14 @@ You must notify Commenda in writing within **fourteen (14) days** after receivin - Amount assessed (tax, penalties, interest) - Description of the transactions at issue -**How to notify:** +**Notification channel:** - Email: [support contact] -- Subject line: "Accuracy Guarantee Claim - [Your Company Name]" -- Include all required documentation +- Subject line: "Accuracy Guarantee Claim - [Company Name]" +- All required documentation attached -#### Step 3: Cooperate with investigation +#### Step 3: Customer cooperation with investigation -You must provide all relevant information and reasonably cooperate with Commenda's investigation and any effort to contest or mitigate the assessment. +Customer must provide all relevant information and reasonably cooperate with Commenda's investigation and any effort to contest or mitigate the assessment. **This includes:** - Transaction data and records @@ -54,7 +54,7 @@ You must provide all relevant information and reasonably cooperate with Commenda - Participation in calls or meetings as needed - Authorization for Commenda to communicate with tax authority (if needed) -#### Step 4: Commenda investigates +#### Step 4: Commenda investigation Commenda will: - Review the assessment and underlying transactions @@ -66,8 +66,8 @@ Commenda will: #### Step 5: Resolution If the guarantee applies, Commenda will: -- Reimburse you for the covered Tax Shortfall, or -- Apply a credit to your account for the covered amount +- Reimburse the customer for the covered Tax Shortfall, or +- Apply a credit to the customer's account for the covered amount **Timeline:** Commenda will make a determination and provide reimbursement or credit within a reasonable timeframe after completing the investigation. @@ -85,7 +85,7 @@ The Accuracy Guarantee does not apply to errors caused by: - Wrong customer classifications - Incomplete transaction data -**Why it matters:** Commenda's calculations are only as accurate as the data provided. If you provide incorrect information or misconfigure the system, the guarantee doesn't apply. +**Rationale:** Commenda's calculations are only as accurate as the data provided. Incorrect information or misconfigured systems shift responsibility to the customer. #### 2. Legal positions or classifications selected by customer @@ -95,7 +95,7 @@ The Accuracy Guarantee does not apply to errors caused by: - Customer decides not to collect tax in a jurisdiction where they have nexus - Customer applies an exemption based on their legal position -**Why it matters:** When you make legal or classification decisions, you own the outcome. Commenda provides tools and guidance, but ultimate responsibility for legal positions rests with you. +**Rationale:** When customers make legal or classification decisions, they own the outcome. Commenda provides tools and guidance, but ultimate responsibility for legal positions rests with the customer. #### 3. Changes in law after the transaction date @@ -105,7 +105,7 @@ The Accuracy Guarantee does not apply to errors caused by: - Jurisdiction changes sourcing rules - New exemption requirements imposed -**Why it matters:** Commenda maintains current tax content, but cannot predict or be responsible for retroactive legal changes. +**Rationale:** Commenda maintains current tax content but cannot predict or be responsible for retroactive legal changes. #### 4. Events outside Commenda's reasonable control @@ -116,59 +116,59 @@ The Accuracy Guarantee does not apply to errors caused by: - Tax authority system errors - Jurisdiction provides incorrect guidance -**Why it matters:** Commenda cannot guarantee against events beyond our control. +**Rationale:** Commenda cannot guarantee against events beyond reasonable control. ### Sole and exclusive remedy -The remedies in the Accuracy Guarantee are your sole and exclusive remedies for inaccuracies in tax calculations or content. This means: +The remedies in the Accuracy Guarantee are the customer's sole and exclusive remedies for inaccuracies in tax calculations or content. This means: -- You cannot seek additional damages beyond the Rolling ACV cap -- You cannot pursue other legal remedies for covered inaccuracies +- Customer cannot seek additional damages beyond the Rolling ACV cap +- Customer cannot pursue other legal remedies for covered inaccuracies - The guarantee represents the full extent of Commenda's liability for calculation errors ## On-time filing guarantee ### What's covered -If you have met all your obligations and Commenda fails to file a sales tax return by its statutory due date solely due to Commenda's error, Commenda will: +If the customer has met all their obligations and Commenda fails to file a sales tax return by its statutory due date solely due to Commenda's error, Commenda will: 1. **Complete and submit the delinquent filing** at no additional charge 2. **Waive or refund any service fee** for that return -3. **Pay any late-filing penalties and interest** imposed by the tax authority, up to the Rolling ACV cap +3. **Reimburse any late-filing penalties and interest** imposed by the tax authority, up to the Rolling ACV cap ### Coverage cap -Payment of penalties and interest is capped at the **Rolling ACV** - the fees you paid to Commenda during the twelve (12) months preceding the tax period at issue. +Reimbursement of penalties and interest is capped at the **Rolling ACV** — the fees the customer paid to Commenda during the twelve (12) months preceding the tax period at issue. -### How it works +### Process -#### Step 1: Discover missed deadline +#### Step 1: Missed deadline discovered -You discover that a return was not filed by its statutory due date, or you receive a penalty notice from a tax authority for late filing. +Customer discovers that a return was not filed by its statutory due date, or receives a penalty notice from a tax authority for late filing. -#### Step 2: Notify Commenda (within 10 days) +#### Step 2: Customer notifies Commenda (within 10 days) -You must notify Commenda within **ten (10) days** of discovering the missed deadline or receiving a penalty notice to qualify for the guarantee. +Customer must notify Commenda within **ten (10) days** of discovering the missed deadline or receiving a penalty notice to qualify for the guarantee. **Required information:** - Jurisdiction and tax type - Filing period - Statutory due date -- Date you discovered the issue or received penalty notice +- Date customer discovered the issue or received penalty notice - Copy of penalty notice (if applicable) -**How to notify:** +**Notification channel:** - Email: [support contact] -- Subject line: "On-Time Filing Guarantee Claim - [Your Company Name]" -- Include all required documentation +- Subject line: "On-Time Filing Guarantee Claim - [Company Name]" +- All required documentation attached -#### Step 3: Commenda investigates +#### Step 3: Commenda investigation Commenda will: - Verify the statutory due date - Review the filing timeline and any communications - Determine if the late filing was solely due to Commenda's error -- Verify that you met all your obligations +- Verify that the customer met all their obligations - Assess whether any exclusions apply #### Step 4: Resolution @@ -176,11 +176,11 @@ Commenda will: If the guarantee applies, Commenda will: 1. **Immediately file the delinquent return** (if not already filed) 2. **Waive or refund the service fee** for that return -3. **Pay the late-filing penalties and interest** (up to Rolling ACV cap) +3. **Reimburse the late-filing penalties and interest** (up to Rolling ACV cap) -### Your obligations (Section 2 requirements) +### Customer obligations -To qualify for the On-Time Filing Guarantee, you must have met all obligations, which typically include: +To qualify for the On-Time Filing Guarantee, the customer must have met all obligations: #### Timely data provision @@ -190,9 +190,9 @@ To qualify for the On-Time Filing Guarantee, you must have met all obligations, #### Sufficient funds -- Maintain sufficient funds in your account for tax payments -- Provide payment authorization in advance of due dates -- Respond to payment issues promptly +- Maintain sufficient funds in account for tax remittance +- Provide remittance authorization in advance of due dates +- Respond to remittance issues promptly #### Required tax accounts @@ -203,7 +203,7 @@ To qualify for the On-Time Filing Guarantee, you must have met all obligations, #### Timely approvals - Review and approve returns by agreed-upon deadlines -- Respond to questions or issues that require your input +- Respond to questions or issues that require customer input - Provide necessary documentation when requested #### Accurate configuration @@ -224,17 +224,17 @@ The On-Time Filing Guarantee does not apply to late filings caused by: - Data quality issues that delay processing - Integration failures on customer's side -**Why it matters:** Commenda cannot file returns without complete, accurate data. Late data provision shifts responsibility to you. +**Rationale:** Commenda cannot file returns without complete, accurate data. Late data provision shifts responsibility to the customer. #### 2. Insufficient funds **Examples:** -- Insufficient balance for tax payment -- Payment authorization not provided -- Payment method declined or failed -- Customer delays payment approval +- Insufficient balance for tax remittance +- Remittance authorization not provided +- Remittance method declined or failed +- Customer delays remittance approval -**Why it matters:** Returns cannot be filed without payment. Ensuring sufficient funds is your responsibility. +**Rationale:** Returns cannot be filed without remittance. Ensuring sufficient funds is the customer's responsibility. #### 3. Failure to maintain required tax accounts @@ -244,7 +244,7 @@ The On-Time Filing Guarantee does not apply to late filings caused by: - Filing authorization revoked or expired - Account locked due to prior issues -**Why it matters:** Commenda cannot file to accounts that are not active and accessible. +**Rationale:** Commenda cannot file to accounts that are not active and accessible. #### 4. Events outside Commenda's reasonable control @@ -254,7 +254,7 @@ The On-Time Filing Guarantee does not apply to late filings caused by: - Third-party service failures - Jurisdiction changes filing requirements without notice -**Why it matters:** Commenda cannot guarantee against events beyond our control. +**Rationale:** Commenda cannot guarantee against events beyond reasonable control. #### 5. Customer delays in approvals or responses @@ -264,7 +264,7 @@ The On-Time Filing Guarantee does not apply to late filings caused by: - Required documentation not provided - Customer unavailable during critical filing window -**Why it matters:** Filing deadlines require timely customer participation. Delays on your end shift responsibility to you. +**Rationale:** Filing deadlines require timely customer participation. Delays on the customer's end shift responsibility to them. ## Guarantee comparison @@ -277,39 +277,39 @@ The On-Time Filing Guarantee does not apply to late filings caused by: | **Key exclusion** | Customer data/configuration errors | Customer delays or insufficient funds | | **Cooperation required** | Yes - investigation and mitigation | Yes - meeting all obligations | -## How to maximize guarantee protection +## Maximizing guarantee protection ### For accuracy guarantee -#### 1. Provide complete, accurate data +#### 1. Complete, accurate data - Verify addresses are correct and complete - Ensure product taxability mappings are accurate - Keep exemption certificates current - Maintain accurate nexus settings -#### 2. Configure properly +#### 2. Proper configuration - Follow Commenda's configuration guidance - Test configurations before going live - Review configuration regularly - Update settings when business changes -#### 3. Document everything +#### 3. Documentation - Keep records of all transactions - Save configuration settings and changes - Document legal positions and decisions - Maintain audit trail -#### 4. Notify promptly +#### 4. Prompt notification - Monitor for assessment notices - Notify Commenda within 14 days - Provide complete documentation - Respond to information requests quickly -#### 5. Cooperate fully +#### 5. Full cooperation - Participate in investigation - Provide requested information @@ -332,14 +332,14 @@ The On-Time Filing Guarantee does not apply to late filings caused by: - Keep credentials current - Monitor account status -#### 3. Ensure data quality +#### 3. Data quality - Validate data before submission - Address data quality issues promptly - Test integrations regularly - Monitor data feeds -#### 4. Communicate proactively +#### 4. Proactive communication - Notify Commenda of business changes - Report issues immediately @@ -351,84 +351,86 @@ The On-Time Filing Guarantee does not apply to late filings caused by: - Build buffer time before deadlines - Don't wait until last minute for approvals - Address issues early -- Maintain backup payment methods +- Maintain backup remittance methods ## Common guarantee scenarios ### Scenario 1: Inaccurate rate applied -**Situation:** Commenda applied a 7% rate when the correct rate was 8%. Tax authority assesses $5,000 in uncollected tax plus $500 in penalties and interest. +**Situation:** Commenda applied a 7% rate when the correct rate was 8%. The tax authority assesses: +- $5,000 in uncollected tax +- $500 in penalties and interest **Guarantee applies?** Yes, if: -- You provided correct address and transaction data -- You properly configured the system -- You notify within 14 days -- You cooperate with investigation +- Customer provided correct address and transaction data +- Customer properly configured the system +- Customer notified within 14 days +- Customer cooperated with investigation **Covered amount:** $5,500 (tax + penalties + interest), up to Rolling ACV cap ### Scenario 2: Wrong product taxability -**Situation:** You classified a product as non-taxable based on your legal interpretation. Tax authority disagrees and assesses $10,000. +**Situation:** Customer classified a product as non-taxable based on their legal interpretation. Tax authority disagrees and assesses $10,000. -**Guarantee applies?** No - this is a legal position selected by customer (exclusion #2) +**Guarantee applies?** No — this is a legal position selected by customer (exclusion #2) -**Your responsibility:** You own the outcome of legal classification decisions +**Responsibility:** Customer owns the outcome of legal classification decisions ### Scenario 3: Late filing due to customer data delay -**Situation:** You provided transaction data 3 days late. Commenda filed the return 2 days after the due date. Tax authority assesses $200 in late-filing penalties. +**Situation:** Customer provided transaction data 3 days late. Commenda filed the return 2 days after the due date. Tax authority assesses $200 in late-filing penalties. -**Guarantee applies?** No - late filing was caused by customer's delayed data (exclusion #1) +**Guarantee applies?** No — late filing was caused by customer's delayed data (exclusion #1) -**Your responsibility:** You're responsible for penalties due to your data delay +**Responsibility:** Customer is responsible for penalties due to their data delay ### Scenario 4: Late filing due to Commenda error -**Situation:** You provided all data on time and approved the return 5 days before the due date. Commenda failed to submit the return due to an internal processing error. Tax authority assesses $300 in penalties. +**Situation:** Customer provided all data on time and approved the return 5 days before the due date. Commenda failed to submit the return due to an internal processing error. Tax authority assesses $300 in penalties. **Guarantee applies?** Yes, if: -- You met all obligations (timely data, approval, sufficient funds) -- You notify within 10 days +- Customer met all obligations (timely data, approval, sufficient funds) +- Customer notified within 10 days - Late filing was solely due to Commenda's error **Covered amount:** $300 in penalties + fee waiver for that return, up to Rolling ACV cap ### Scenario 5: Incorrect address provided -**Situation:** You provided a billing address instead of shipping address. Commenda calculated tax for the wrong jurisdiction. Tax authority assesses $3,000 in uncollected tax. +**Situation:** Customer provided a billing address instead of shipping address. Commenda calculated tax for the wrong jurisdiction. Tax authority assesses $3,000 in uncollected tax. -**Guarantee applies?** No - this is customer's incorrect data (exclusion #1) +**Guarantee applies?** No — this is customer's incorrect data (exclusion #1) -**Your responsibility:** You're responsible for providing correct addresses +**Responsibility:** Customer is responsible for providing correct addresses ### Scenario 6: Retroactive law change **Situation:** A jurisdiction retroactively changed a product's taxability. Commenda's calculation was correct at the time of transaction but is now deemed incorrect. Tax authority assesses $8,000. -**Guarantee applies?** No - this is a change in law after the transaction date (exclusion #3) +**Guarantee applies?** No — this is a change in law after the transaction date (exclusion #3) -**Your responsibility:** Retroactive law changes are not covered by the guarantee +**Responsibility:** Retroactive law changes are not covered by the guarantee -## Frequently asked questions +## FAQ ### What is "Rolling ACV"? -Rolling ACV is the total fees you paid to Commenda for the Services during the twelve (12) months preceding the tax period at issue. This is the cap for both guarantees. +Rolling ACV is the total fees the customer paid to Commenda for the Services during the twelve (12) months preceding the tax period at issue. This is the cap for both guarantees. -**Example:** If the tax period at issue is Q2 2024, Rolling ACV is the fees you paid from Q2 2023 through Q1 2024. +**Example:** If the tax period at issue is Q2 2024, Rolling ACV is the fees paid from Q2 2023 through Q1 2024. -### Can I get more than Rolling ACV in coverage? +### Can the customer get more than Rolling ACV in coverage? -No. Both guarantees are capped at Rolling ACV. This is your maximum recovery under either guarantee. +No. Both guarantees are capped at Rolling ACV. This is the maximum recovery under either guarantee. -### What if I disagree with Commenda's determination? +### What if the customer disagrees with Commenda's determination? -If you believe the guarantee should apply but Commenda determines it doesn't, you should: -1. Request a detailed explanation of the determination -2. Provide any additional information that supports your position +If the customer believes the guarantee should apply but Commenda determines it doesn't: +1. Provide a detailed explanation of the determination +2. Request any additional information that supports their position 3. Escalate to executive team if needed -4. Review your service agreement for dispute resolution procedures +4. Review the service agreement for dispute resolution procedures ### Do the guarantees cover state income tax or other taxes? @@ -441,32 +443,32 @@ Each issue is evaluated separately. However, the total recovery across all issue ### How long does the investigation take? Investigation timelines vary based on complexity. Commenda will: -- Acknowledge your claim within 2 business days +- Acknowledge the claim within 2 business days - Provide initial assessment within 10 business days - Complete investigation within 30 days (for most cases) - Communicate timeline if more time is needed ### What if the tax authority is wrong? -If Commenda believes the tax authority's assessment is incorrect, we will: -- Work with you to contest the assessment +If Commenda believes the tax authority's assessment is incorrect: +- Work with the customer to contest the assessment - Provide supporting documentation and analysis - Participate in appeals or protests (as appropriate) - Help minimize or eliminate the assessment If the assessment is successfully reduced or eliminated, the guarantee covers only the final assessed amount. -### Can I purchase additional coverage? +### Can the customer purchase additional coverage? -The guarantees are included with your service agreement and cannot be increased beyond Rolling ACV. However, you may want to consider: -- Maintaining your own tax liability insurance -- Increasing your Rolling ACV by using more Commenda services -- Working with your insurance broker on additional coverage +The guarantees are included with the service agreement and cannot be increased beyond Rolling ACV. Options to consider: +- Maintaining their own tax liability insurance +- Increasing Rolling ACV by using more Commenda services +- Working with their insurance broker on additional coverage ### What happens if Commenda goes out of business? -The guarantees are only valid while Commenda is operating. Consider: -- Maintaining your own documentation and records +The guarantees are only valid while Commenda is operating. Customers should consider: +- Maintaining their own documentation and records - Having backup tax service providers identified - Maintaining tax liability insurance - Keeping sufficient reserves for potential tax liabilities @@ -475,37 +477,24 @@ The guarantees are only valid while Commenda is operating. Consider: ### Do's -- **Notify promptly** - Don't wait until the deadline -- **Provide complete documentation** - Include everything requested -- **Cooperate fully** - Respond quickly to information requests -- **Document everything** - Keep records of all communications -- **Be professional** - Work collaboratively with Commenda -- **Follow up** - Check on status if you haven't heard back +- **Notify promptly** — Don't wait until the deadline +- **Provide complete documentation** — Include everything requested +- **Cooperate fully** — Respond quickly to information requests +- **Document everything** — Keep records of all communications +- **Be professional** — Work collaboratively with Commenda +- **Follow up** — Check on status if there's no response ### Don'ts -- **Don't delay notification** - Missing the deadline disqualifies your claim -- **Don't withhold information** - Full disclosure is required -- **Don't ignore requests** - Lack of cooperation can disqualify your claim -- **Don't make assumptions** - Ask questions if you're unsure -- **Don't escalate prematurely** - Give the process time to work -- **Don't agree to settlements** - Consult with Commenda before agreeing to anything with tax authority +- **Don't delay notification** — Missing the deadline disqualifies the claim +- **Don't withhold information** — Full disclosure is required +- **Don't ignore requests** — Lack of cooperation can disqualify the claim +- **Don't make assumptions** — Ask questions if unsure +- **Don't escalate prematurely** — Give the process time to work +- **Don't agree to settlements** — Consult with Commenda before agreeing to anything with tax authority ## Related documentation -- [Incident Response SOP](/product/indirect-tax/incident-response-sop/overview) - How Commenda handles tax incidents -- [Scenario classification](/product/indirect-tax/incident-response-sop/scenarios) - Types of tax issues and remedies -- [Communication templates](/product/indirect-tax/incident-response-sop/templates) - Templates for customer communications - -## Contact information - -For guarantee claims or questions: - -- **Email:** [support contact] -- **Subject line format:** "Accuracy Guarantee Claim" or "On-Time Filing Guarantee Claim" -- **Include:** Your company name, account number, and brief description - -For general questions about guarantees: -- Review your service agreement -- Contact your account manager -- Email [support contact] +- [Incident Response SOP](/product/indirect-tax/incident-response-sop/overview) — How Commenda handles tax incidents +- [Scenario classification](/product/indirect-tax/incident-response-sop/scenarios) — Types of tax issues and remedies +- [Communication templates](/product/indirect-tax/incident-response-sop/templates) — Templates for customer communications From 0d2622c6d2f09ae3ca2e303904e08f446ba8d487 Mon Sep 17 00:00:00 2001 From: Aryan Kumar Date: Tue, 16 Dec 2025 22:01:16 +0530 Subject: [PATCH 44/45] Add Integration Guidelines documentation - Converted DOCX files to Markdown format - Created Integration Guidelines hub page with card-based navigation - Added Integration Checklist section (General Behaviors, Syncing, Calculation) - Added Existing Integration Behaviors for all integrations (Stripe, Shopify, Xero, NetSuite, QuickBooks, Zoho, WooCommerce) - Added standalone pages: Fallback Address Resolver, Sales Tax Address Resolution Hierarchy, Shipping Tax Calculations - Fixed markdown syntax issues and cleaned up anchor tag fragments - Updated navigation structure in docs.json to organize all pages under Integration Guidelines --- docs.json | 78 +++++++++++++++-- .../netsuite.mdx | 53 ++++++++++++ .../quickbooks.mdx | 24 ++++++ .../shopify.mdx | 24 ++++++ .../existing-integration-behaviors/stripe.mdx | 54 ++++++++++++ .../woocommerce.mdx | 44 ++++++++++ .../existing-integration-behaviors/xero.mdx | 36 ++++++++ .../existing-integration-behaviors/zoho.mdx | 24 ++++++ .../guidelines/fallback-address-resolver.mdx | 71 ++++++++++++++++ .../integration-checklist/calculation.mdx | 75 ++++++++++++++++ .../general-behaviors.mdx | 23 +++++ .../integration-checklist/syncing.mdx | 83 ++++++++++++++++++ integrations/guidelines/overview.mdx | 57 +++++++++++++ ...sales-tax-address-resolution-hierarchy.mdx | 61 +++++++++++++ .../guidelines/shipping-tax-calculations.mdx | 85 +++++++++++++++++++ 15 files changed, 785 insertions(+), 7 deletions(-) create mode 100644 integrations/guidelines/existing-integration-behaviors/netsuite.mdx create mode 100644 integrations/guidelines/existing-integration-behaviors/quickbooks.mdx create mode 100644 integrations/guidelines/existing-integration-behaviors/shopify.mdx create mode 100644 integrations/guidelines/existing-integration-behaviors/stripe.mdx create mode 100644 integrations/guidelines/existing-integration-behaviors/woocommerce.mdx create mode 100644 integrations/guidelines/existing-integration-behaviors/xero.mdx create mode 100644 integrations/guidelines/existing-integration-behaviors/zoho.mdx create mode 100644 integrations/guidelines/fallback-address-resolver.mdx create mode 100644 integrations/guidelines/integration-checklist/calculation.mdx create mode 100644 integrations/guidelines/integration-checklist/general-behaviors.mdx create mode 100644 integrations/guidelines/integration-checklist/syncing.mdx create mode 100644 integrations/guidelines/overview.mdx create mode 100644 integrations/guidelines/sales-tax-address-resolution-hierarchy.mdx create mode 100644 integrations/guidelines/shipping-tax-calculations.mdx diff --git a/docs.json b/docs.json index 00f186a27..bf2d2771d 100644 --- a/docs.json +++ b/docs.json @@ -97,13 +97,77 @@ { "group": "Integrations", "pages": [ - "integrations/stripe/overview", - "integrations/shopify/overview", - "integrations/xero/overview", - "integrations/zoho/overview", - "integrations/woocommerce/setup", - "integrations/quickbooks/overview", - "integrations/netsuite/overview" + { + "group": "Integration Guidelines", + "pages": [ + "integrations/guidelines/overview", + { + "group": "Integration Checklist", + "pages": [ + "integrations/guidelines/integration-checklist/general-behaviors", + "integrations/guidelines/integration-checklist/syncing", + "integrations/guidelines/integration-checklist/calculation" + ] + }, + { + "group": "Existing Integration Behaviors", + "pages": [ + "integrations/guidelines/existing-integration-behaviors/stripe", + "integrations/guidelines/existing-integration-behaviors/shopify", + "integrations/guidelines/existing-integration-behaviors/xero", + "integrations/guidelines/existing-integration-behaviors/netsuite", + "integrations/guidelines/existing-integration-behaviors/quickbooks", + "integrations/guidelines/existing-integration-behaviors/zoho", + "integrations/guidelines/existing-integration-behaviors/woocommerce" + ] + }, + "integrations/guidelines/fallback-address-resolver", + "integrations/guidelines/sales-tax-address-resolution-hierarchy", + "integrations/guidelines/shipping-tax-calculations" + ] + }, + { + "group": "Stripe", + "pages": [ + "integrations/stripe/overview" + ] + }, + { + "group": "Shopify", + "pages": [ + "integrations/shopify/overview" + ] + }, + { + "group": "Xero", + "pages": [ + "integrations/xero/overview" + ] + }, + { + "group": "Zoho", + "pages": [ + "integrations/zoho/overview" + ] + }, + { + "group": "WooCommerce", + "pages": [ + "integrations/woocommerce/setup" + ] + }, + { + "group": "QuickBooks", + "pages": [ + "integrations/quickbooks/overview" + ] + }, + { + "group": "NetSuite", + "pages": [ + "integrations/netsuite/overview" + ] + } ] } ] diff --git a/integrations/guidelines/existing-integration-behaviors/netsuite.mdx b/integrations/guidelines/existing-integration-behaviors/netsuite.mdx new file mode 100644 index 000000000..c0496e097 --- /dev/null +++ b/integrations/guidelines/existing-integration-behaviors/netsuite.mdx @@ -0,0 +1,53 @@ +--- +title: 'Netsuite' +description: 'Netsuite integration behaviors' +--- + +Netsuite supports both calculations and sync. + +Netsuite calculations are not implemented in the commenda logical backend, we built a plugin that each customer needs to install. + +## Sync: + +We sync the following data models (through Rootfi and logical backend, same as other integrations): + +**Netsuite Payment Vouchers: (**INVOICES, INVOICE_CREDIT_NOTES, CASH_REFUNDS, CASH_SALES) + +We follow the following hierarchy: + +- Invoice-level SHIPPING (extracted from Rootfi webhook payload) +- customer-level default shipping (retrieved via Rootfi passthrough) +- invoice-level BILLING (extracted from Rootfi webhook payload) +- customer-level default billing (retrieved from Rootfi passthrough) + +When extracting an address from the rootfi webhook payload, we discard the address if raw_data is not present on the payload, but we never actually use the raw_data field. + +If there is exactly one customer-level shipping address or customer-level billing address, we do not seem to consider them unless they are explicitly set to default. But test this to see how the integration actually works. + +**Customers**: CONTACTS + +We extract the customer-level shipping address and billing address from the webhook payload’s raw_data field. + +- If the shipping address is set, we set the contact shipping address to the webhook payload shipping address. +- If the billing address is set, we set the contact billing address to the webhook payload billing address +- If the billing address is set but the shipping address is not set, we set the contact shipping address to the webhook payload *billing *address + +## Calculations: + +Address resolution for calculations is both divergent from the Rootfi/ Commenda implementation, and contains several questionable implementation decisions that do not align with the sales tax API or with our best practices. + +The code is heavily dependent on netsuite internal details. + +We start by defining a ‘complete address’ as one with address line 1 and country set, where the country is not “IN”. + +We then try to extract the invoice shipping address with several different calls to netsuite internals that I don’t understand. These netsuite internals all need to be individually audited, because a lurking bug in any one would be unlikely to surface for any given customer. We pick the first non-null one of these addresses, regardless of whether it is a “complete address” as defined above. + +If the first non-null of the addresses is a “complete address”, we select it as our calculation address, otherwise we discard the other non-null shipping addresses and continue. + +We then do exactly the same for invoice billing address. + +If that also fails, we load the customer record and attempt to retrieve its billing address. If that succeeds, and is “complete”, we return it. + +Otherwise, we do a bunch of stuff I don’t understand to get a “fallback” address. + +![](data:image/png;base64,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IiIiIiIiSiYMUHwken+AkSebSraqpcXL9S48DVIaOG1MB9ZlqyljWjrltmvXrunw5NzZs04dERERERERUbJhgOIj0furTZMnT1aLFi1SrVu3duqIiIiIiIiIkg0DFB+J3h8RERERERER1Q0GKD4SvT8iIiIiIiIiqhsMUHwken9EREREREREVDcYoPhI9P6IiIiIiIiIqG4wQPGR6P0RERERERERUd1ggOIj0fsjIiIiIiIiorrBAMVHovdHRERERERERHWDAYqPRO+PiIiIiIiIiOoGAxQfid5fIslqnar+6UahWjWvrVNHRETkZcms1vrfjs4d4vtvI/5NuvlGd/Xnu73UX+4XqVGDMpw2RERERLFigOIj0fvzsvXOp2rFO2855abUJ9cwekmlWn/9mtr19V3NbhOrD052U//nxz6qX690p850+vRpdefOHac8qJ49e6oFCxZo06ZNU3l5eapBgwZOu5qaOHGiOn/+vPriiy+0oUOHOm3iZfHixerrr78OuXDhgtOGng/bt1epH374SXXv3sOpq0m7WHzyySfP9NkqLS0Nfedefvll1alTJ6dNTeHvQ3wPrl69GvrO2W3iCX/3mN+53r17O22S2dT+U9WDPQ/UwTkHw8pbpLdQMwfOjCozIzNQf6bC7o31vx2fnI3fZx6+eS9P9/vX74vUvUt56qW8Jk4bIiIiolgxQPGR6P152fPdN2rLrU+cctPIikVqz/1v1K6v7qrlb51XlWdfd9rEIrNlA/XfT/6j+m93ejp1tmvXrql79+455UHt3btXP96EG6Fly5Y5bWOFG0Pp75133lHnzp17ciPb3WkXL/369VO7du3ScN4PPvjAaWP6+OOPNbv8efX5559rdvlv0f79h9Xjxz+p/PxCp64m7WKBz/OzfG5u3LjhfOfwvgwbNsxpG6uFCxeG+nvzzTd1wGq3iacNGzbo75s8p0GDBjltxKxZs9SXX36p/7TrnlcLhy9UPx74UV1YGh649e/WX5dHU5JfEqg/2x8/KdT/hrRv29CpqykEJ+izYWo9p46IiIiophig+Ej0/rz0fnmcyi8Z4pSb1lx5XwcojTPiM6T50pEu+jd9C6aE//bRS3FxsZo0aZJTHpQEKPv371dTp05VO3bs0DeIKMPPdvtYrF27VvfzLNdXU0EClLr4DX0i+e677zS7/LcoaDAStF0s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) diff --git a/integrations/guidelines/existing-integration-behaviors/quickbooks.mdx b/integrations/guidelines/existing-integration-behaviors/quickbooks.mdx new file mode 100644 index 000000000..62fffbe57 --- /dev/null +++ b/integrations/guidelines/existing-integration-behaviors/quickbooks.mdx @@ -0,0 +1,24 @@ +--- +title: 'Quickbooks' +description: 'Quickbooks integration behaviors' +--- + +Quickbooks supports both calculations and sync. + +There are two different code paths for Quickbooks address resolution, one for calculations and one for sync. They are currently implemented differently in a way that may be error-prone, and this should be reviewed. + +## Sync: + +**Quickbooks Transactions**: INVOICES, INVOICE_CREDIT_NOTES, CASH_REFUNDS + +We use addresses directly from Rootfi. We use the invoice-level shipping address if present, if it is null, we fall back to the invoice-level billing address. We do not do any validation checks on the shipping address, so if it’s non-null but incomplete we will still propagate it forwards. + + Customer-level addresses are not considered. + +**Quickbooks Contacts: **CONTACTS + +We record the shipping and billing addresses on the contact, synced through Rootfi. + +## Calculations: + +We retrieve the transaction from rootfi’s passthrough API and then only consider the shipping address, calculating based on it no matter what. diff --git a/integrations/guidelines/existing-integration-behaviors/shopify.mdx b/integrations/guidelines/existing-integration-behaviors/shopify.mdx new file mode 100644 index 000000000..03f7f65c6 --- /dev/null +++ b/integrations/guidelines/existing-integration-behaviors/shopify.mdx @@ -0,0 +1,24 @@ +--- +title: 'Shopify' +description: 'Shopify integration behaviors' +--- + +Commenda does not support tax calculations in Shopify, the following doc refers only to their sync flow. + +**Shopify Transactions **(ECOMMERCE_TRANSACTIONS in Rootfi) + +We follow this hierarchy to pick the first non-null address (with no validity checks other than whether the address is null or not): + +- Shopify’s transaction shipping address (from raw data) +- Shopify’s transaction billing address (from raw data) + +We don’t seem to fall back to a customer-level address if those fields are missing + +**Shopify Customers** (ECOMMERCE_CUSTOMERS in rootfi) + +We follow this hierarchy to pick the first valid address: + +- Rootfi SHIPPING address +- Rootfi BILLING address + +We select exactly one of these addresses, geocode it, and sync it to the sales tax API. diff --git a/integrations/guidelines/existing-integration-behaviors/stripe.mdx b/integrations/guidelines/existing-integration-behaviors/stripe.mdx new file mode 100644 index 000000000..56056027f --- /dev/null +++ b/integrations/guidelines/existing-integration-behaviors/stripe.mdx @@ -0,0 +1,54 @@ +--- +title: 'Stripe' +description: 'Stripe integration behaviors' +--- + +We have a calculations flow which is somewhat broken and unused. The following documentation ignores that flow, and only refers to the sync flow, which is implemented in a totally separate way. The sync flow’s implementation should be merged with the calculation implementation - both should use the exact same code for processing invoices to identify and geocode the transaction address. + +**Invoices ** (PAYMENT_INVOICES in rootfi) + +We extract addresses from the raw_data field directly from Stripe, instead of relying on the Rootfi mapping. + +We follow this hierarchy to pick the first valid shipping address AND the first “Valid” billing address. + +1. Invoice-level shipping address +2. Invoice-level “Customer shipping address” +3. Customer-level shipping address +4. Invoice-level billing address (invoice.customer_address) +5. Customer-level billing address (customer.address) +6. Customer’s payment method billing address (payment_method.billing_details.address) + 1. only if the ‘fallbackToPaymentMethodAddressEnabled’ setting is set to true + +“Valid” is defined as having ANY field set - country, city, zip, address line 1, or state. + +We take the highest-ranked shipping and billing addresses in the above hierarchy. We select only one of those addresses - the shipping address, if available, otherwise the billing address. + +Then we geocode it → write it into the “Ship To …” columns of the Transactions CSV → upload that CSV to the Sales Tax API. + +Notes: + +invoice level 'customer address' field is not always the same as the customer-level 'address' field, it gets locked when the invoice is finalized + +Address is considered valid if any of its fields are set (if it has a street, OR a city, OR a zip, OR a country). + +**Stripe Customers** (PAYMENT_CUSTOMERS in rootfi) + +We follow this hierarchy to pick the first valid address: + +- Rootfi SHIPPING address +- Rootfi BILLING address +- Payment method billing address, retrieved via the pass-through API + - only if the ‘fallbackToPaymentMethodAddressEnabled’ setting is set to true + +We select exactly one of these addresses, geocode it, and sync it to the sales tax API. + +**Stripe Credit Notes **(PAYMENT_CREDIT_NOTES in rootfi) + +We follow this hierarchy to pick the first valid address: + +- Rootfi SHIPPING address +- Rootfi BILLING address +- Payment method billing address, retrieved via the pass-through API + - only if the ‘fallbackToPaymentMethodAddressEnabled’ setting is set to true + +We select exactly one of these addresses, geocode it, and sync it to the sales tax API. diff --git a/integrations/guidelines/existing-integration-behaviors/woocommerce.mdx b/integrations/guidelines/existing-integration-behaviors/woocommerce.mdx new file mode 100644 index 000000000..3f58cc736 --- /dev/null +++ b/integrations/guidelines/existing-integration-behaviors/woocommerce.mdx @@ -0,0 +1,44 @@ +--- +title: 'WooCommerce' +description: 'WooCommerce integration behaviors' +--- + +WooCommerce supports both calculations and sync. + +WooCommerce calculations are not implemented in the commenda logical backend, we built a plugin that each customer needs to install. + +WooCommerce sync is a work in progress, not launched yet. + +## Sync: + +**Transactions**: ECOMMERCE_ORDERS + +We extract the order-level shipping and billing addresses, if not null, and pass them along. + +If either one is missing, we retrieve the customer from the Rootfi pass-through API. + +If the order-level shipping address is missing and the customer has a shipping address, we pass along the customer-level shipping address instead. + +If the order-level billing address is missing and the customer has a billing address, we pass along the customer-level billing address instead. + +Finally, we pick the available shipping address, or the billing address if there is none. + +**Customers**: ECOMMERCE_CUSTOMERS + +We record the shipping and billing addresses on the contact, synced through Rootfi. + +## Calculations: + +The WooCommerce plugin has two code paths to calculate tax, one based on an in-progress cart (Before the order is complete) and the other based on an order. + +The two paths have different behaviors. + +The in-progress cart path calculates on the cart-level shipping address, if available, arbitrarily choosing the first shipping destination if there is more than one. Otherwise, it falls back to the customer-level billing address: + +Cart/checkout calculation (commenda_cart_tax) + +- Primary: first shipping package destination: WC()->shipping->get_packages()[0]['destination'] +- Fallback: customer billing fields from WC()->customer + +The order path calculates on the order-level shipping address, and will fall back to the customer shipping address if not set. Customer-level fields are ignored. + diff --git a/integrations/guidelines/existing-integration-behaviors/xero.mdx b/integrations/guidelines/existing-integration-behaviors/xero.mdx new file mode 100644 index 000000000..be9271f3e --- /dev/null +++ b/integrations/guidelines/existing-integration-behaviors/xero.mdx @@ -0,0 +1,36 @@ +--- +title: 'Xero' +description: 'Xero integration behaviors' +--- + +Xero supports both calculations and sync. + +We think Xero only has customer-level addresses, but Aryan thinks that Avalara has invoice-level address support for Xero. We need some more research here. + +There are two different code paths for Xero address resolution, one for calculations and one for sync. These should be merged so the implementations don’t diverge, which would lead to bugs that get caught when our back calcs don’t match forward calcs. + +## Sync: + +**Xero payment vouchers:** (INVOICES / INVOICE_CREDIT_NOTES / CASH_REFUNDS in Rootfi): + +Fetch the linked contact using the Rootfi passthrough API, and then check for: + +- Raw data STREET address → treated as shipping +- Raw data POBOX address → treated as billing + +We choose the shipping address if it’s non-null, and the billing address if the shipping address is null. + +**Xero contacts **(CONTACTS in rootfi): + +Read contact-level addresses from Raw Data (bypassing a Rootfi bug that switches STREET and POBOX addresses), and follow the following hierarchy: + +- Raw data STREET address → treated as shipping +- Raw data POBOX address → treated as billing + +We choose the shipping address if it’s non-null, and the billing address if the shipping address is null. + +## Calculations: + +This pipeline is mostly similar with one exception: It check whether any of the fields are set on the shipping address, and if not it falls back to the billing address. + +Like on Stripe invoices, an address is considered valid if any of its fields are set (if it has a street, OR a city, OR a zip, OR a country). diff --git a/integrations/guidelines/existing-integration-behaviors/zoho.mdx b/integrations/guidelines/existing-integration-behaviors/zoho.mdx new file mode 100644 index 000000000..e9d9fe721 --- /dev/null +++ b/integrations/guidelines/existing-integration-behaviors/zoho.mdx @@ -0,0 +1,24 @@ +--- +title: 'Zoho' +description: 'Zoho integration behaviors' +--- + +Zoho supports both calculations and sync. The address implementation looks identical to Quickbooks. + +There are two different code paths for Zoho address resolution, one for calculations and one for sync. They are currently implemented differently in a way that may be error-prone, and this should be reviewed. + +## Sync: + +**Zoho Transactions**: INVOICES, INVOICE_CREDIT_NOTES, CASH_REFUNDS + +We use addresses directly from Rootfi. We use the invoice-level shipping address if present, if it is null, we fall back to the invoice-level billing address. We do not do any validation checks on the shipping address, so if it’s non-null but incomplete we will still propagate it forwards. + + Customer-level addresses are not considered. + +**Zoho Contacts: **CONTACTS + +We record the shipping and billing addresses on the contact, synced through Rootfi. + +## Calculations: + +We retrieve the transaction from rootfi's passthrough API and then only consider the shipping address, calculating based on it no matter what. diff --git a/integrations/guidelines/fallback-address-resolver.mdx b/integrations/guidelines/fallback-address-resolver.mdx new file mode 100644 index 000000000..620c4ec3c --- /dev/null +++ b/integrations/guidelines/fallback-address-resolver.mdx @@ -0,0 +1,71 @@ +--- +title: 'Fallback Address Resolver' +description: 'Fallback address resolver documentation' +--- + +## __Enabling fallback Address resolver on Commenda Logical backend__ + +### __Current Behavior__ + +For each transaction, the system selects __only the first available address__ based on the defined hierarchy and sends it for geocoding. +If geocoding fails to resolve this address, the __entire transaction fails__ and is moved to the __holding pen__, even if other valid addresses are available for the transaction. + +### __Impact__ + +- Transactions get blocked unnecessarily + +- Valid fallback addresses are ignored + +- Increased manual intervention due to holding-pen accumulation + +## __Expected Behavior__ + +For each transaction, the system should __attempt calling a geocoding api using all available addresses in hierarchical order__, instead of failing immediately on the first failure. + +### __Address Resolution Logic__ + +1. Identify all available addresses for the transaction. + +2. Sort them according to the predefined hierarchy + + - Example hierarchy: + __Customer Shipping > Invoice Billing > Customer Billing > Card Information +__ +3. Attempt geocoding using the highest-priority address. + +4. If geocoding fails: + + - __Do not fail the transaction +__ + - Automatically attempt the __next address in the hierarchy +__ +5. Mark the transaction as failed __only if all available addresses fail to resolve__. + +## __Example__ + +__Available addresses:__ + +- Customer Shipping + +- Invoice Billing + +__Hierarchy: +__ Customer Shipping > Invoice Billing + +__Flow:__ + +1. Attempt geocoding with Customer Shipping address + +2. If it fails, retry using Invoice Billing address + +3. Transaction proceeds successfully if Invoice Billing resolves + +4. Transaction moves to holding pen __only if both addresses fail__ + +## __Acceptance Criteria__ + +- System iterates through all available addresses in hierarchical order + +- Transaction does __not__ fail on the first geocoding failure + +- Transaction is sent to holding pen only when __no address resolves successfully__ diff --git a/integrations/guidelines/integration-checklist/calculation.mdx b/integrations/guidelines/integration-checklist/calculation.mdx new file mode 100644 index 000000000..b011ec9c9 --- /dev/null +++ b/integrations/guidelines/integration-checklist/calculation.mdx @@ -0,0 +1,75 @@ +--- +title: 'Calculation' +description: 'Calculation behavior checklist for integrations' +--- + +__Calculation tab__ + +This tab will be used as the base source of truth for all the calculations behaviors for the supported integrations. + +1. Shipping (how to store shipping related taxes) +2. Handling (If it exists as a specific field), and how tax calculated on that will be stored. +3. Discount + 1. Calculating taxes when discount on line item + 2. Calculating taxes on Pro-rata when discount on line item level + 3. Tax calculation when discounts are applicable on line item as well as on invoice level +4. Vouchers + 1. Type of vouchers supported for calculation + 2. Refund vouchers + 3. Partial vouchers +5. What’s the trigger for calculating the taxes on the invoice in the real time +6. If an invoice is locked, will the tax amount be updated when updating the invoice, if not what we are flagging to the client and how +7. GL Account + 1. Tax amount should be mapped with the appropriate tax authority + 2. Tax amount should be mapped with the appropriate tax classes in case of marketplace. +8. Overwriting of Taxes + 1. Storing taxes in ERP (separate line item, on the line item, etc.) + 2. Negative amount handling + 3. Disable/enable tax calculation should work + 4. Adding the same SKU as different line items with different values should display different taxes at the line item level. + 5. Check if the calculation output is getting updated based on PTC. + 6. Tax calculated can get rounded by the ERP (like Netsuite), if it happens document it. + 7. Displaying Error message + 8. Updating a locked invoice: Behavior and how to reflect the error + 9. Wrong address has been passed or an empty string has been passed: Behavior and error message + 10. Which time zone Calculation start date is following + 11. Set the calculation start date as 1st january, create an invoice for 2nd jan, the tax should be calculated. Then update the calculation start date to 5st January, then we update the invoice we created on 2nd, what should happen in this case? + 12. What is the trigger to initiate the calculation on the invoices also what’s an average time for it to calculate + 13. The action if we manually override the tax rate or amount in the ERP + 14. How can a customer mark a line item as exempted. Same for marking the entire transaction as exempted. + + __For example:__ In NetSuite, TRX asked us to give a checkbox with, "mark as exempted", which when clicked, the tax rate for every line item should have 0% tax rate. Customers could also ask for a special tax code they can use to mark a line item as non taxable for a particular transaction. + + 15. Tax Calculation on the Fees and which PTC should we link the fees to + 16. Calculation of taxes should be triggered irrespective of the administrative access of ERP + +9. **Address** + + a. **Address fallback hierarchy** + + + The system follows this hierarchy when resolving addresses for calculations: + + **1.** Invoice Shipping + **↓** + **2.** Customer Shipping (default) + **↓** + **3.** Customer Shipping (any) + **↓** + **4.** Invoice Billing + **↓** + **5.** Customer Billing (default) + **↓** + **6.** Customer Billing (any) + **↓** + **7.** Payment Metadata address + **↓** + **8.** IP Address + + The system selects the first available address in this order. + + +10. **Customer Exemption** + 1. If applied, Pass the reason "Customer is exempted" + 2. Exemption work through our ECM portal and not the Exemption checkbox on the ERP portal (Flag it to customer as well) +11. How to identify and disable calculation of taxes on the marketplace sales. diff --git a/integrations/guidelines/integration-checklist/general-behaviors.mdx b/integrations/guidelines/integration-checklist/general-behaviors.mdx new file mode 100644 index 000000000..357df6fa1 --- /dev/null +++ b/integrations/guidelines/integration-checklist/general-behaviors.mdx @@ -0,0 +1,23 @@ +--- +title: 'General Behaviors' +description: 'General behavior checklist for integrations' +--- + +__General Behavior__ + +1. Testing should be enabled on: + 1. Staging + 2. Demo + 3. Dev + 4. Prod +2. Documentation for setting up the integration/plugin: + 1. Sync + 2. Calculation +3. Integration Connection Details: + 1. How long this connection will be valid for + 2. How often the sync runs + 3. Does Incremental sync works + 4. Any rate limit or exception we should be aware of + 5. Does the Sync status work + 6. Which integration versions we support (Xero US, XERO UK) + diff --git a/integrations/guidelines/integration-checklist/syncing.mdx b/integrations/guidelines/integration-checklist/syncing.mdx new file mode 100644 index 000000000..e5ba67b19 --- /dev/null +++ b/integrations/guidelines/integration-checklist/syncing.mdx @@ -0,0 +1,83 @@ +--- +title: 'Syncing' +description: 'Syncing behavior checklist for integrations' +--- + +__Syncing__ + +This tab provides the checklist required for checking all the syncing behavior for this integration. + +1. Shipping + 1. Syncing on Line item/Invoice level + 2. Syncing the taxes collected on the Shipping Value +2. Handling + 1. How to sync handling amounts + 2. How to sync tax calculated on that +3. Discounts + 1. Line item level discounts + 2. Invoice level discounts +4. Vouchers + 1. Type of vouchers supported for syncing + 2. Refund vouchers + 3. Partial vouchers +5. What’s the trigger for syncing the invoice (Like the status: like we don’t sync DRAFT invoices) +6. Order status updated for an invoice (Order status to Refund, define the behavior) + 1. LOCKED: Add a different Refund invoice + 2. UNLOCKED: Update the same invoice +7. Mapping on Commenda + 1. If we are able to map all the types of Invoices: One-time purchases, Recurring, etc. + 2. Is it possible to pass 0 quantity with positive amount and if yes, how to sync it + 3. How does the One-time good and Subscription items get synced + 4. Also allowing the sync for card address or IP address, if it’s a marketplace to get enough fallbacks to support + 5. Invoice number on Commenda should be same as Document ID on ERP + 6. What should be mapped if SKUs not available in that ERP + 7. Negative amount handling + 8. Syncing behavior for the Fees added and the tax calculated on it +8. **Address** + + a. **Address fallback hierarchy** + + + + The system follows this hierarchy when resolving addresses for syncing: + + **1.** Invoice Shipping + **↓** + **2.** Customer Shipping (default) + **↓** + **3.** Customer Shipping (any) + **↓** + **4.** Invoice Billing + **↓** + **5.** Customer Billing (default) + **↓** + **6.** Customer Billing (any) + **↓** + **7.** Payment Metadata address + **↓** + **8.** IP Address + + The system selects the first available address in this order. + + + b. **Updating the address on ERP** + + i. Behavior when the invoice is unlocked (Recorded): + + - It should update the address + - It should take it out of the Holding Pen + + ii. Behavior when the invoice is Locked + + c. **If the GeoEncoding fails to parse the address**, pass the next possible address + + d. **Some softwares** (like NetSuite and Stripe) will always populate the country code on the customer level by default. This will look like the address is actually populated on the code level but it isn't. Make sure we parse the next possible address if this address is not complete. Check [netsuite.handler.ts](http://netsuite.handler.ts) for more information around this. + +9. Product + 1. Handling behaviors where SKUs are absent especially accounting softwares + 2. SKU updated on the invoice in ERP should be synced in Commenda +10. How to identify and handle Marketplace sales. +11. Deletion of Invoices: + 1. When it is not Locked + 2. When it is Locked + diff --git a/integrations/guidelines/overview.mdx b/integrations/guidelines/overview.mdx new file mode 100644 index 000000000..8ad5d8ad8 --- /dev/null +++ b/integrations/guidelines/overview.mdx @@ -0,0 +1,57 @@ +--- +title: 'Guide' +description: 'Hub for integration testing, behaviors, and address/tax logic.' +--- + +## Integration Guidelines Guide + +Use this hub to jump into the most important integration docs: checklists, per‑integration behaviors, and address/tax logic. + + + + Baseline checklist to validate whether an integration is working end‑to‑end. + Start here when testing a new or updated integration. + + + + Stripe, Shopify, Xero, NetSuite, QuickBooks, and Zoho behavior notes: + how we sync, calculate, and resolve addresses today. + + + + How the logical backend walks through fallback addresses and how to + enable or adjust that behavior. + + + + The authoritative address hierarchy used for sales tax decisions + across integrations. + + + + How shipping charges and their taxes are calculated, stored, and + synced across systems. + + + + diff --git a/integrations/guidelines/sales-tax-address-resolution-hierarchy.mdx b/integrations/guidelines/sales-tax-address-resolution-hierarchy.mdx new file mode 100644 index 000000000..d8c4ce3a2 --- /dev/null +++ b/integrations/guidelines/sales-tax-address-resolution-hierarchy.mdx @@ -0,0 +1,61 @@ +--- +title: 'Sales Tax Address Resolution Hierarchy' +description: 'Sales tax address resolution hierarchy' +--- + +# Sales Tax Address Resolution Hierarchy + +## Purpose + +This document defines the __hierarchy for address resolution__ used by the Sales Tax Engine when determining the applicable tax jurisdiction for a transaction. + +The hierarchy ensures: - Deterministic and auditable address selection - Consistent behavior across integrations - Graceful fallback when preferred address data is unavailable + +The engine __must evaluate addresses strictly in the order defined below__ and select the __first available address__ encountered. If an address at a given level is unavailable or invalid, the engine proceeds to the next level. + +## Address Resolution Order (Highest → Lowest Priority) + +### 1. Invoice Shipping Address + +- Explicit shipping address provided at invoice level +- Considered the most accurate representation of where goods/services are delivered + +### 2. Customer Shipping Address (Default or Single) + +- Use the customer’s __default shipping address if available__ +- If no default is set, but __only one shipping address exists__, use that address +- If multiple shipping addresses exist and no default is defined, skip this level + +### 3. Invoice Billing Address + +- Billing address explicitly attached to the invoice + +### 4. Customer Shipping Address (Any – Arbitrary) + +- Select __any available shipping address__ +- Used only when no invoice-level or default shipping address is available but there are few shipping address associated with the customer, just take the first one. + +### 5. Customer Billing Address (Default or Single) + +- Use the customer’s __default billing address__ +- If no default is set, but __only one billing address exists__, use that address +- If multiple billing addresses exist and no default is defined, skip this level + +### 6. Payment Metadata Address + +__Source:__ Payment provider metadata + +- Address obtained from payment instruments (e.g., card billing address) +- Considered lower confidence due to potential mismatch with delivery location + +### 7. Customer Billing Address (Any – Arbitrary) + +__Source:__ Customer profile + +- Select __any available billing address __associated with the customer. + +### 8. IP Address (Geolocation) + +- Infer location via IP-based geolocation +- Lowest confidence signal +- Should be used __only when no explicit address data is availab__ diff --git a/integrations/guidelines/shipping-tax-calculations.mdx b/integrations/guidelines/shipping-tax-calculations.mdx new file mode 100644 index 000000000..d79d32f6f --- /dev/null +++ b/integrations/guidelines/shipping-tax-calculations.mdx @@ -0,0 +1,85 @@ +--- +title: 'Shipping Tax Calculations' +description: 'Shipping tax calculations' +--- + +__Assumptions:__ + +Shipping should not be done by the company itself. If the company is shipping the products themselves, then the tax applicability rules are very different. We will assume all the shipping is done through a common carrier. + +__Acceptable behaviors:__ + +- Shipping can be on the line item level +- Shipping can be on the invoice level + +__Unacceptable behaviors:__ + +- Shipping can’t be on both line item and invoice level + +__Calculation behaviors:__ + +1. __If the shipping is on the invoice level__ + 1. In such cases, the base rates 3* of the jurisdictions are applied to the shipping line item. Below are the exact steps. + 2. Treat shipping as a separate line item. This means while passing it to the sales tax backend, you will have to pass this as a separate line item with tax code “SRV_SHIPPING”. (Explicitly mentioning that we shouldn’t distribute this to every line item, that is wrong). + 3. First calculate taxable amounts for every other line item in the transaction. This should give you the total taxable amount and total non taxable amount on the invoice level. + 4. Check which product rules apply for `SRV_SHIPPING`. There are two possibilities + 1. EXEMPT : In which case the tax on this line item will be zero. + 2. PROPORTIONAL: There are a few steps to calculate proportional tax. Look below + 3. No product rule is present + 5. Calculate proportional tax on line item: + 1. Figure out the base adjustment factor. This is the “taxable amount / total amount”. + 2. Adjust the tax base for shipping. Adjusted base is “base adjustment factor * amount”. + 3. Calculate the tax. For this you can now pass the amount to the calculateTaxOnLineItem function with applyProductRules = false and applyTransactionRules = false. This way you will prevent reapplying the “EXEMPTION” and “PROPORTIONAL” rules as they are already applied. + 4. The resultant effective tax rate is the tax we should calculate on this shipping line item (invoice level shipping). + 6. If no product rule is present, then shipping is taxable as a normal line item. +2. __If the shipping is on the line item level__ + 1. First we will have to check what are the product rules applied on SRV_SHIPPING for this state. There are three possibilities + 1. EXEMPT + 2. PROPORTIONAL + 3. TAXABLE (This is when product rules are missing) + 2. EXEMPT : This is the easiest case. No matter if the line item is taxable or not, the shipping tax amount will be zero. + 3. PROPORTIONAL: In this case, we simply use the product rate to calculate the shipping tax amount. + 4. TAXABLE: In this case, there are two scenarios + 1. If the product rate is zero > Then use the base rates to calculate the shipping tax amount. + 2. If the product rates are non zero > Use the product rates to calculate the shipping tax amount. + 5. Calculate the tax on the line item without considering shipping. This should also give you the base rates for all the jurisdictions applicable on this line item. + 6. Add the shipping tax to the line item tax and then return the totals. + 1. NOTE: Now the tax rates will seem inflated. This is fine from a reporting perspective (Just confirmed this with Phani that none of the states asks for tax collected on shipping explicitly) . + 2. But we won’t be able to give accurate reasoning for this to the customer. It will just look like our rates are wrong. But maybe this is fine? The alternative is that just like “tax_type” we add another field on the tax breakdowns to reflect the extra charges collected by our engine. + 3. The third option is to give a separate column called “shipping_tax_amount” on the API response from the calculation engine. + +__Integration behaviors:__ + +1. __Allows invoice level shipping. __ + 1. Allows invoice level shipping tax amount + 1. This is the ideal case. You will pass SRV_SHIPPING as a separate line item. The tax engine will explicitly tell the tax amount on this line item. That tax amount will be applied on the invoice level shipping tax amount. + 2. Doesn’t allow invoice level shipping tax amount + 1. This is the common case. In such a case, we will pass SRV_SHIPPING as a separate line item on which the tax amount will be returned by the tax engine. Now there are two approaches + 1. Take the shipping tax amount and add it as a separate line item on the invoice. Label it as a tax item so we don’t calculate tax on it during re processing of the invoice. (This is a bad approach). + 2. Take the shipping tax amount and distribute it proportionally to all the physical positive non tax line items 1*. If no physical goods are found, then proportionally distribute the shipping tax amount among all the positive line items. + 1. Weird weird scenario : All the line items are negative. This shouldn’t happen. +2. __Allows line item level shipping__ + 1. Allows line item level shipping tax amount + 1. This case is very rare from an accounting software perspective. But right now the tax engine will give the shipping tax amount included in the line item tax amount. Right now we don’t support it. + 1. NEW FEATURE: Explicitly return the calculated shipping tax amount from the calculation engine. + 2. Doesn’t allow line item level shipping tax amount + 1. This is the real world case. This will work perfectly. The shipping tax amount will come included in the line item tax amount and that will be reflected on the only “tax amount” field available on the line item. + +__Shipping storage behavior on sales tax (integration -> logical backend -> sales tax):__ + +1. __Invoice level shipping__ + +If the shipping amount is on the invoice level we will create a new line item on the sales tax backend. This line item will have a tax code as “SRV_SHIPPING”. The amounts and taxes will act as they do on a normal line item. + +1. __Line item level shipping__ + +If the shipping amount is on the line item itself, we can pass the shipping amount simply to the sales tax backend. Right now the shipping will be available as an explicit field on the line item. Reminder that based on the current behavior, sub total is “unit price * quantity + shipping - discount”. And total is “sub total + tax collected”. + +__Glossary:__ + +1. Non-tax line items are all the line items except a line item that reflects “tax”. In quickbooks tax amount is added as a separate line item with certain code. +2. After looking at years of TRX data, we barely find invoices where the overall invoice is positive and individual line items are negative. In GAP accountants prefer to create a separate credit invoice to reflect negative line items. + +__Things to think about:__ + +1. If a line item has a shipping amount, Avalara will link a second record (probably a record called Taxes) that is linked to the original line item. This Tax record contains the tax type, in this case it will be shipping. But I think the original tax that is applicable on the line item level is also stored as a separate record on this Tax table. That means, the tax table will look like [{taxOn: “shipping”, taxAmount: $25, taxType: “sales_tax”, taxAuthority: “United States”}] From 74aeb9fc2fa645ddff3f9896f741aa5f4eed197d Mon Sep 17 00:00:00 2001 From: Aryan Kumar Date: Tue, 16 Dec 2025 22:41:59 +0530 Subject: [PATCH 45/45] Add Supported Integrations page - Added new Supported Integrations page with table showing all integrations - Shows syncing and calculation support status for each integration - Added to Integrations navigation as first item --- docs.json | 1 + integrations/supported-integrations.mdx | 17 +++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 integrations/supported-integrations.mdx diff --git a/docs.json b/docs.json index bf2d2771d..1d9abb636 100644 --- a/docs.json +++ b/docs.json @@ -97,6 +97,7 @@ { "group": "Integrations", "pages": [ + "integrations/supported-integrations", { "group": "Integration Guidelines", "pages": [ diff --git a/integrations/supported-integrations.mdx b/integrations/supported-integrations.mdx new file mode 100644 index 000000000..441b4d497 --- /dev/null +++ b/integrations/supported-integrations.mdx @@ -0,0 +1,17 @@ +--- +title: 'Supported Integrations' +description: 'Overview of integrations supported by Commenda' +--- + +## Integrations Supported by Commenda + +| Integration | Syncing | Calculation | Notes | +|---------------|-------------|---------------|-------| +| **Stripe** | Supported | Not supported | — | +| **Xero** | Supported | Supported | Xero UK | +| **QuickBooks** | Supported | Supported | — | +| **Zoho Books** | Supported | Supported | Calculation requires manual webhook setup | +| **Shopify** | Supported | Not supported | — | +| **NetSuite** | Supported | Supported | Calculation requires plugin installation | +| **WooCommerce**| Supported | Supported | Plugin supports both syncing and calculation | +