{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LedgerSync","description":"Connect your users' bank accounts and pull their transactions, statements, and balances through one uniform API.","colors":{"primary":"#0891B2","light":"#22D3EE","dark":"#0E7490"},"logo":{"light":"https://mintcdn.com/ledgersync/NVbCdX0lsP_TgYmH/logo/ledgersync-wordmark.png?fit=max\u0026auto=format\u0026n=NVbCdX0lsP_TgYmH\u0026q=85\u0026s=b149d57dc2f40804f937b11e31060496","dark":"https://mintcdn.com/ledgersync/NVbCdX0lsP_TgYmH/logo/ledgersync-wordmark.png?fit=max\u0026auto=format\u0026n=NVbCdX0lsP_TgYmH\u0026q=85\u0026s=b149d57dc2f40804f937b11e31060496"},"favicon":"https://mintcdn.com/ledgersync/NVbCdX0lsP_TgYmH/favicon.png?fit=max\u0026auto=format\u0026n=NVbCdX0lsP_TgYmH\u0026q=85\u0026s=223187cbc5ee95ae162ffd35e5935db1","navbar":{"links":[{"href":"mailto:support@ledgersync.com","label":"Support"}],"primary":{"type":"button","label":"Request access","href":"https://portal.ledgersyncappv2.com"}},"footer":{"socials":{"website":"https://ledgersync.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ledgersync","hasAudioNarration":false,"actualSubdomain":"ledgersync","customDomains":["docs.ledgersyncappv2.com"],"gitSource":{"type":"github","owner":"ledgersync-app","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6add29d60504bfbbf7e80db6"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afbad798b50e0bba2c4120a","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API Reference","count":59},{"language":"default","tag":"v2 API (legacy)","count":50},{"language":"default","tag":"LedgerSync MCP","count":35},{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"Connections","count":9},{"language":"default","tag":"account-api","count":9},{"language":"default","tag":"Clients","count":8},{"language":"default","tag":"client-api","count":8},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Webhooks","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"ai-connector.css","content":".lsai-page{--lsai-green: #1b7a52;--lsai-green-dark: #155f40;--lsai-fill: #1b7a52;--lsai-fill-hover: #155f40;--lsai-green-soft: #e8f5ee;--lsai-green-line: #c9e3d5;--lsai-ink: #1f2937;--lsai-muted: #6b7280;--lsai-line: #e3e8ec;--lsai-card: #ffffff;--lsai-gray-soft: #f3f5f7;--lsai-yellow-soft: #fdf6dd;--lsai-yellow-line: #efd78f;--lsai-red-soft: #fdecec;--lsai-red-line: #f3b9b9;--lsai-bg: rgb(var(--background-light, 255 255 255));max-width:880px;margin:0 auto;padding:32px 24px 48px;color:var(--lsai-ink);font-size:16px;line-height:1.6}.dark .lsai-page{--lsai-green: #3fb27f;--lsai-green-dark: #57c592;--lsai-green-soft: #12291f;--lsai-green-line: #24513a;--lsai-ink: #e5e7eb;--lsai-muted: #9ca3af;--lsai-line: #2b3138;--lsai-card: #14181c;--lsai-gray-soft: #1a1f24;--lsai-yellow-soft: #2a2412;--lsai-yellow-line: #5c4c1c;--lsai-red-soft: #2c1717;--lsai-red-line: #6a2c2c;--lsai-bg: rgb(var(--background-dark, 10 13 16))}.lsai-title{font-size:2rem;line-height:1.2;font-weight:700;margin:0 0 8px;color:var(--lsai-ink)}.lsai-subtitle{font-size:1.05rem;color:var(--lsai-muted);margin:0 0 20px}.lsai-page h2{font-size:1.3rem;font-weight:700;margin:28px 0 12px;color:var(--lsai-ink)}.lsai-page h3{font-size:1.1rem;font-weight:700;margin:20px 0 8px;color:var(--lsai-ink)}.lsai-page p,.lsai-page span[data-as=\"p\"]{display:block;margin:0 0 10px}.lsai-step-text>span[data-as=\"p\"]:last-child,.lsai-note>span[data-as=\"p\"]:last-child,.lsai-choice-text>span[data-as=\"p\"]:last-child,.lsai-box-text>span[data-as=\"p\"]:last-child,.lsai-test-more>span[data-as=\"p\"]:last-child{margin-bottom:0}.lsai-page a:not(.lsai-btn):not(.lsai-thumb){color:var(--lsai-green);font-weight:600;text-decoration:none}.lsai-page a:not(.lsai-btn):not(.lsai-thumb):hover{text-decoration:underline}.lsai-page ul,.lsai-page ol:not(.lsai-progress){margin:4px 0 10px;padding-left:22px}.lsai-page li{margin:2px 0}.lsai-page ul li{list-style:disc}.lsai-page .prose li{list-style:none}.lsai-page ol:not(.lsai-progress) li{list-style:decimal}.lsai-page code:not(.lsai-copy-text){font-size:0.9em;background:var(--lsai-gray-soft);border-radius:4px;padding:1px 5px}.lsai-page table{width:100%;border-collapse:collapse;margin:8px 0 16px;font-size:0.95rem}.lsai-page th{text-align:left;background:var(--lsai-gray-soft);font-weight:700;padding:8px 10px;border-bottom:1px solid var(--lsai-line)}.lsai-page td{padding:8px 10px;border-bottom:1px solid var(--lsai-line);vertical-align:top}.lsai-head{display:flex;flex-wrap:wrap;align-items:flex-start;justify-content:space-between;gap:12px 20px}.lsai-head-text{flex:1 1 420px;min-width:0}.lsai-video-button{display:flex;flex:0 0 auto;align-items:center;gap:10px;width:max-content;max-width:100%;cursor:pointer;border:1px solid var(--lsai-line);border-radius:12px;padding:10px 16px 10px 10px;background:var(--lsai-card);box-shadow:0 1px 2px rgba(0, 0, 0, 0.06);font:inherit;color:var(--lsai-ink);text-align:left}.lsai-video-button:hover{border-color:var(--lsai-green)}.lsai-video-button:focus-visible{outline:3px solid var(--lsai-green);outline-offset:2px}.lsai-video-play{display:inline-flex;align-items:center;justify-content:center;width:36px;height:36px;border-radius:50%;background:var(--lsai-fill);color:#ffffff;font-size:0.85rem;padding-left:2px}.lsai-video-label{display:flex;flex-direction:column;line-height:1.25;font-size:0.85rem;color:var(--lsai-muted)}.lsai-video-label strong{color:var(--lsai-ink);font-size:0.95rem}.lsai-lightbox.lsai-video-box{cursor:default}.lsai-video-box .lsai-lightbox-note{pointer-events:none}.lsai-video-player{display:block;width:min(1100px, 100%);max-height:calc(100vh - 120px);border-radius:8px;background:#000000;box-shadow:0 12px 40px rgba(0, 0, 0, 0.45)}.lsai-progress{display:grid;grid-template-columns:repeat(5, 1fr);gap:6px;list-style:none;margin:0 0 24px;padding:0}.lsai-progress-item{list-style:none;margin:0}.lsai-progress-bar{display:block;height:4px;border-radius:2px;background:var(--lsai-line);margin-bottom:6px}.lsai-progress-label{display:flex;align-items:center;gap:6px;font-size:0.8rem;color:var(--lsai-muted);line-height:1.3}.lsai-done .lsai-progress-bar{background:var(--lsai-green-line)}.lsai-done .lsai-progress-label{color:var(--lsai-green)}.lsai-current .lsai-progress-bar{background:var(--lsai-green)}.lsai-current .lsai-progress-label{color:var(--lsai-ink);font-weight:700}.lsai-progress-now{display:none;font-size:0.85rem;font-weight:700;color:var(--lsai-ink);margin:-14px 0 20px}.lsai-step{display:flex;gap:16px;align-items:flex-start;padding:18px 0;border-bottom:1px solid var(--lsai-line)}.lsai-step-num{flex:none;width:32px;height:32px;border-radius:50%;background:var(--lsai-fill);color:#ffffff;font-weight:700;display:flex;align-items:center;justify-content:center;margin-top:2px}.lsai-step-main{flex:1;min-width:0}.lsai-step-label{font-size:0.72rem;letter-spacing:0.08em;text-transform:uppercase;color:var(--lsai-muted);font-weight:600}.lsai-step-title{font-size:1.1rem;font-weight:700;margin:2px 0 6px}.lsai-step-text p:last-child{margin-bottom:0}.lsai-thumbs{flex:none;width:190px;display:flex;flex-direction:column;gap:10px}.lsai-thumb{width:100%;text-decoration:none;display:block;cursor:zoom-in}.lsai-lightbox{position:fixed;inset:0;z-index:1000;background:rgba(15, 23, 42, 0.86);display:flex;flex-direction:column;align-items:center;justify-content:center;gap:12px;padding:24px;cursor:zoom-out}.lsai-lightbox img{max-width:min(1280px, 100%);max-height:calc(100vh - 90px);border-radius:8px;box-shadow:0 12px 40px rgba(0, 0, 0, 0.45);background:#ffffff}.lsai-lightbox-note{color:#ffffff;font-size:0.95rem}.lsai-lightbox-close{position:absolute;top:16px;right:16px;background:#ffffff;color:#111827;border:0;border-radius:6px;padding:8px 16px;font-weight:700;font-size:0.95rem;cursor:pointer}.lsai-page td code{white-space:nowrap}.lsai-page div[class*=\"--page-padding:20px\"]{margin-top:4px!important;margin-bottom:8px!important;padding-top:0!important;padding-bottom:0!important}.lsai-route #topbar-cta-button,.lsai-route a[href=\"https://portal.ledgersyncappv2.com\"].whitespace-nowrap,.lsai-route li:has(>a[href=\"https://portal.ledgersyncappv2.com\"].whitespace-nowrap),.lsai-route li.whitespace-nowrap>a[href=\"https://portal.ledgersyncappv2.com\"]{display:none!important}.lsai-thumb img{display:block;width:100%;height:auto;border:1px solid var(--lsai-line);border-radius:6px;margin:0;box-shadow:0 1px 2px rgba(0, 0, 0, 0.06)}.lsai-thumb:hover img{border-color:var(--lsai-green)}.lsai-page a.lsai-thumb,.lsai-page a.lsai-thumb:hover{text-decoration:none!important;border-bottom:0!important}.lsai-page a.lsai-thumb .lsai-thumb-caption{color:var(--lsai-muted)!important;font-weight:400!important;text-decoration:none!important}.lsai-thumb-caption{display:block;font-size:0.75rem;color:var(--lsai-muted);text-align:center;margin-top:4px}.lsai-btn{display:inline-block;background:var(--lsai-fill);color:#ffffff!important;font-weight:600;font-size:0.9rem;border:1px solid var(--lsai-green);border-radius:6px;padding:6px 14px;text-decoration:none!important;cursor:pointer;line-height:1.4}.lsai-btn:hover{background:var(--lsai-fill-hover);border-color:var(--lsai-green-dark)}.lsai-btn-outline{background:transparent;color:var(--lsai-green)!important}.lsai-btn-outline:hover{background:var(--lsai-green-soft)}.lsai-buttons{display:flex;flex-wrap:wrap;gap:8px;margin:8px 0}.lsai-grid-2{display:grid;grid-template-columns:repeat(2, 1fr);gap:12px;margin:0 0 8px}.lsai-grid-3{display:grid;grid-template-columns:repeat(3, 1fr);gap:12px;margin:0 0 8px}@media (min-width: 1024px) and (max-width: 1099px){.lsai-grid-3{grid-template-columns:1fr}}.lsai-choice{display:flex;flex-direction:column;border:1px solid var(--lsai-green-line);border-radius:10px;padding:16px;background:var(--lsai-card)}.lsai-choice-title{font-weight:700;font-size:1.02rem;margin-bottom:4px}.lsai-choice-text{color:var(--lsai-muted);font-size:0.93rem;flex:1}.lsai-choice-text p{margin:0 0 6px}.lsai-choice-action{margin-top:12px}.lsai-note{border-left:4px solid #c3ccd4;background:var(--lsai-gray-soft);border-radius:6px;padding:12px 14px;margin:12px 0;font-size:0.95rem}.lsai-note p:last-child{margin-bottom:0}.lsai-note-green{border-left-color:var(--lsai-green);background:var(--lsai-green-soft)}.lsai-note-yellow{border-left-color:var(--lsai-yellow-line);background:var(--lsai-yellow-soft)}.lsai-note-red{border-left-color:var(--lsai-red-line);background:var(--lsai-red-soft)}.lsai-step-text .lsai-note{margin:8px 0 0;font-size:0.9rem}.lsai-copy{margin:0 0 16px}.lsai-copy-label{font-size:0.85rem;color:var(--lsai-muted);margin-bottom:4px}.lsai-copy-row{display:flex;align-items:center;gap:8px;border:1px solid var(--lsai-line);border-radius:8px;background:var(--lsai-gray-soft);padding:6px 6px 6px 12px}.lsai-copy-text{flex:1;min-width:0;font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;font-size:0.95rem;overflow-wrap:anywhere;background:transparent;padding:0}.lsai-copy-button{flex:none;background:var(--lsai-fill);color:#ffffff;border:0;border-radius:6px;padding:6px 14px;font-weight:600;font-size:0.9rem;cursor:pointer}.lsai-copy-button:hover{background:var(--lsai-fill-hover)}.lsai-prompt .lsai-copy-row{align-items:flex-start}.lsai-prompt .lsai-copy-text{white-space:pre-wrap;line-height:1.5}.lsai-test{display:flex;align-items:center;gap:12px;border:1px solid var(--lsai-green-line);background:var(--lsai-green-soft);border-radius:10px;padding:14px 16px;margin:20px 0}.lsai-test-main{flex:1;min-width:0}.lsai-test-title{font-weight:700}.lsai-test-text{font-style:italic}.lsai-test-more{font-size:1rem;color:var(--lsai-ink);margin-top:6px}.lsai-test-more p:last-child{margin-bottom:0}.lsai-test-button{flex:none}.lsai-box{border:1px solid var(--lsai-line);background:var(--lsai-gray-soft);border-radius:10px;padding:16px;margin:16px 0}.lsai-box-title{font-weight:700;margin-bottom:4px}.lsai-box-text p:last-child{margin-bottom:0}.lsai-page [id]{scroll-margin-top:128px}.lsai-box-thumb{max-width:220px;margin-top:12px}.lsai-badge{display:inline-block;font-size:0.75rem;font-weight:700;line-height:1;padding:4px 8px;border-radius:999px;background:var(--lsai-green-soft);color:var(--lsai-green);vertical-align:middle;margin-left:6px}.lsai-grid-2 .lsai-box{margin:0;background:var(--lsai-card)}.lsai-stuck{border-top:1px solid var(--lsai-line);margin-top:28px;padding-top:14px;font-size:0.88rem;color:var(--lsai-muted)}@media (max-width: 760px){.lsai-page{padding:20px 16px 40px}.lsai-title{font-size:1.6rem}.lsai-grid-2,.lsai-grid-3{grid-template-columns:1fr}.lsai-progress-label{display:none}.lsai-progress-now{display:block}.lsai-step{flex-wrap:wrap}.lsai-step-main{flex-basis:calc(100% - 48px)}.lsai-thumbs{width:calc(100% - 48px);margin-left:48px;max-width:360px}.lsai-test{flex-direction:column;align-items:flex-start}}@media (min-width: 1024px) and (min-height: 600px){.lsai-page.lsai-page-pinned{--lsai-nav-h: calc(var(--mintlify-slot-header-height, calc(4rem + var(--topbar-tabs-height, 3rem))) + var(--banner-height, 0px));padding-top:20px}.lsai-page-pinned .lsai-top{position:sticky;top:var(--lsai-nav-h);z-index:20;margin:0 0 12px;padding:12px 0 11px;background:var(--lsai-bg);border-bottom:1px solid var(--lsai-line)}.lsai-page-pinned .lsai-head{flex-wrap:nowrap}.lsai-page-pinned .lsai-progress{margin-bottom:0}.lsai-page-pinned .lsai-top.lsai-top-stuck{padding-top:8px}.lsai-page-pinned .lsai-top-stuck .lsai-subtitle{display:none}.lsai-page-pinned .lsai-top-stuck .lsai-title{font-size:1.5rem;margin-bottom:0}.lsai-page-pinned .lsai-top-stuck .lsai-head{align-items:center;margin-bottom:8px}.lsai-page-pinned .lsai-top-stuck .lsai-video-button{padding:6px 12px 6px 6px}.lsai-page-pinned .lsai-top-stuck .lsai-video-play{width:28px;height:28px}html:has(.lsai-page-pinned){scroll-padding-top:calc(var(--mintlify-slot-header-height, calc(4rem + var(--topbar-tabs-height, 3rem))) + var(--banner-height, 0px) + var(--lsai-pinned-h, 110px) + 12px)}.lsai-page.lsai-page-pinned [id]{scroll-margin-top:0}.lsai-page-pinned .lsai-top-stuck .lsai-video-button{scroll-margin-top:calc(-1 * (var(--lsai-pinned-h, 110px) + 12px))}html:has(.lsai-page-pinned) :is(#navbar,#sidebar) :is(a,button,input,[tabindex]){scroll-margin-top:calc(-1 * (var(--mintlify-slot-header-height, calc(4rem + var(--topbar-tabs-height, 3rem))) + var(--banner-height, 0px) + var(--lsai-pinned-h, 110px) + 12px))}}"}],"page":{"pagePath":"ai/developers","slug":"/ai/developers","pageMetadata":{"title":"For developers","description":"The LedgerSync MCP for developers and admins: sandbox, access, tools, limits and error codes.","mode":"frame","href":"/ai/developers"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The LedgerSync MCP for developers and admins: sandbox, access, tools, limits and error codes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const AiStuck=()=>_jsxs(`div`,{className:`lsai-stuck`,children:[`Stuck? `,_jsx(`a`,{href:`https://ledgersync.com/book-a-demo`,target:`_blank`,rel:`noopener noreferrer`,children:`Book a call with our team`}),` and we'll help you, or email`,` `,_jsx(`a`,{href:`mailto:support@ledgersync.com`,children:`support@ledgersync.com`}),` with the step and what the screen says. Never send passwords or card numbers.`]});const AiCopy=({label,text})=>{const[copied,setCopied]=useState(false);const copy=()=>{if(navigator.clipboard){navigator.clipboard.writeText(text).then(()=>{setCopied(true);setTimeout(()=>setCopied(false),1600)}).catch(()=>{})}};return _jsxs(`div`,{className:`lsai-copy`,children:[label\u0026\u0026_jsx(`div`,{className:`lsai-copy-label`,children:label}),_jsxs(`div`,{className:`lsai-copy-row`,children:[_jsx(`code`,{className:`lsai-copy-text`,children:text}),_jsx(`button`,{type:`button`,className:`lsai-copy-button`,onClick:copy,children:copied?`Copied`:`Copy`})]})]})};const AiBox=({id,title,img,caption,children})=>{const _components={a:`a`,..._provideComponents()};const[open,setOpen]=useState(false);const closeRef=useRef(null);const openerRef=useRef(null);useEffect(()=>{if(!open)return undefined;const root=document.documentElement;const overflow=root.style.overflow;root.style.overflow=`hidden`;if(closeRef.current)closeRef.current.focus({preventScroll:true});return()=>{root.style.overflow=overflow;if(openerRef.current)openerRef.current.focus({preventScroll:true})}},[open]);return _jsxs(`div`,{className:`lsai-box`,id,children:[title\u0026\u0026_jsx(`div`,{className:`lsai-box-title`,children:title}),_jsx(`div`,{className:`lsai-box-text`,children}),img\u0026\u0026_jsxs(_components.a,{className:`lsai-thumb lsai-box-thumb`,href:img,title:`Click to see it larger`,onClick:e=>{e.preventDefault();openerRef.current=e.currentTarget;setOpen(true)},children:[_jsx(`img`,{src:img,alt:``,loading:`lazy`}),_jsxs(`span`,{className:`lsai-thumb-caption`,children:[caption?caption+` · `:``,`click to enlarge`]})]}),open\u0026\u0026_jsxs(`div`,{className:`lsai-lightbox`,role:`dialog`,\"aria-modal\":`true`,\"aria-label\":caption||title,onClick:e=>{if(e.detail\u003c2)setOpen(false)},onKeyDown:e=>{if(e.key===`Escape`)setOpen(false);if(e.key===`Tab`)e.preventDefault()},children:[_jsx(`button`,{ref:closeRef,type:`button`,className:`lsai-lightbox-close`,onClick:()=>setOpen(false),children:`Close`}),_jsx(`img`,{src:img,alt:caption||title}),_jsxs(`span`,{className:`lsai-lightbox-note`,children:[caption?caption+` · `:``,`Click anywhere to close`]})]})]})};const AiPage=({title,subtitle,video,poster,stage,children})=>{const[playing,setPlaying]=useState(false);const[current,setCurrent]=useState(stage);const pageRef=useRef(null);const markRef=useRef(null);const topRef=useRef(null);const watchRef=useRef(null);const closeRef=useRef(null);useEffect(()=>{if(!stage||!topRef.current||!pageRef.current)return undefined;const page=pageRef.current;const top=topRef.current;let frame=0;const update=()=>{frame=0;const css=getComputedStyle(top);const stuck=css.position===`sticky`\u0026\u0026markRef.current.getBoundingClientRect().top\u003c(parseFloat(css.top)||0);if(stuck!==top.classList.contains(`lsai-top-stuck`)){const root=document.documentElement;root.style.overflowAnchor=`none`;requestAnimationFrame(()=>requestAnimationFrame(()=>{root.style.overflowAnchor=``}));if(stuck){const before=top.offsetHeight;const margin=parseFloat(css.marginBottom)||0;top.style.marginBottom=margin+before+`px`;top.classList.add(`lsai-top-stuck`);top.style.marginBottom=margin+before-top.offsetHeight+`px`}else{top.classList.remove(`lsai-top-stuck`);top.style.marginBottom=``}}const atEnd=window.innerHeight+window.scrollY>=document.documentElement.scrollHeight-8;const line=atEnd?Infinity:top.getBoundingClientRect().bottom+120;if(stuck){const height=top.offsetHeight+`px`;if(document.documentElement.style.getPropertyValue(`--lsai-pinned-h`)!==height){document.documentElement.style.setProperty(`--lsai-pinned-h`,height)}}let next=stage;page.querySelectorAll(`[data-stage]`).forEach(el=>{if(el.getBoundingClientRect().top\u003cline)next=Number(el.getAttribute(`data-stage`))});setCurrent(next)};const schedule=()=>{if(!frame)frame=requestAnimationFrame(update)};const reset=()=>{top.classList.remove(`lsai-top-stuck`);top.style.marginBottom=``;schedule()};const observer=typeof ResizeObserver===`undefined`?null:new ResizeObserver(schedule);if(observer){observer.observe(top,{box:`border-box`});observer.observe(page)}window.addEventListener(`scroll`,schedule,{passive:true});window.addEventListener(`resize`,reset);update();return()=>{document.documentElement.style.removeProperty(`--lsai-pinned-h`);if(observer)observer.disconnect();window.removeEventListener(`scroll`,schedule);window.removeEventListener(`resize`,reset);if(frame)cancelAnimationFrame(frame)}},[stage,title]);useEffect(()=>{if(!playing)return undefined;const root=document.documentElement;const overflow=root.style.overflow;root.style.overflow=`hidden`;if(closeRef.current)closeRef.current.focus({preventScroll:true});return()=>{root.style.overflow=overflow;if(watchRef.current)watchRef.current.focus({preventScroll:true})}},[playing]);const stages=[`Get ready`,`Add it to your AI`,`Sign in`,`Click Allow`,`Ask a question`];return _jsxs(`div`,{ref:pageRef,className:stage?`lsai-page lsai-page-pinned`:`lsai-page`,children:[_jsx(`div`,{ref:markRef,className:`lsai-top-mark`,\"aria-hidden\":`true`}),_jsxs(`div`,{ref:topRef,className:`lsai-top`,children:[_jsxs(`div`,{className:`lsai-head`,children:[_jsxs(`div`,{className:`lsai-head-text`,children:[_jsx(`h1`,{className:`lsai-title`,children:title}),subtitle\u0026\u0026_jsx(`p`,{className:`lsai-subtitle`,children:subtitle})]}),video\u0026\u0026_jsxs(`button`,{ref:watchRef,type:`button`,className:`lsai-video-button`,onClick:()=>setPlaying(true),children:[_jsx(`span`,{className:`lsai-video-play`,\"aria-hidden\":`true`,children:`▶`}),_jsxs(`span`,{className:`lsai-video-label`,children:[_jsx(`strong`,{children:`Watch it first`}),_jsx(`span`,{children:`Short setup video`})]})]})]}),stage\u0026\u0026_jsxs(`div`,{className:`lsai-progress-wrap`,children:[_jsx(`ol`,{className:`lsai-progress`,\"aria-label\":`Setup progress`,children:stages.map((label,i)=>{const n=i+1;const state=n\u003ccurrent?`lsai-done`:n===current?`lsai-current`:`lsai-todo`;return _jsxs(`li`,{className:`lsai-progress-item `+state,\"aria-current\":n===current?`step`:undefined,children:[_jsx(`span`,{className:`lsai-progress-bar`}),_jsx(`span`,{className:`lsai-progress-label`,children:label})]},label)})}),_jsx(`div`,{className:`lsai-progress-now`,children:stages[current-1]})]})]}),playing\u0026\u0026_jsxs(`div`,{className:`lsai-lightbox lsai-video-box`,role:`dialog`,\"aria-modal\":`true`,\"aria-label\":title+`: setup video`,tabIndex:-1,onClick:e=>{if(e.target===e.currentTarget)setPlaying(false)},onKeyDown:e=>{if(e.key===`Escape`)setPlaying(false);if(e.key===`Tab`){e.preventDefault();const close=e.currentTarget.querySelector(`button`);(document.activeElement===close?e.currentTarget.querySelector(`video`):close).focus({preventScroll:true})}},children:[_jsx(`button`,{ref:closeRef,type:`button`,className:`lsai-lightbox-close`,onClick:()=>setPlaying(false),children:`Close`}),_jsx(`video`,{className:`lsai-video-player`,controls:true,autoPlay:true,playsInline:true,tabIndex:0,poster,src:video}),_jsx(`span`,{className:`lsai-lightbox-note`,children:`Click Close when you are done`})]}),children]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,h2:`h2`,li:`li`,p:`p`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Table,_MdxComponentBoundary}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Table)_missingMdxReference(`Table`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsx(_MdxComponentBoundary,{name:`AiPage`,children:_jsxs(AiPage,{title:`For developers`,subtitle:_jsxs(_components.span,{children:[`Reference for developers and admins. Accountants setting up their firm don't need this page: go to `,_jsx(_components.a,{href:`/ai/start-here`,children:`Start here`}),`.`]}),children:[_jsx(_MdxComponentBoundary,{name:`AiCopy`,children:_jsx(AiCopy,{label:`Live connector (64 tools)`,text:`https://api.ledgersyncappv2.com/mcp`})}),_jsxs(`div`,{className:`lsai-grid-2`,children:[_jsx(_MdxComponentBoundary,{name:`AiBox`,children:_jsx(AiBox,{title:`Sandbox`,children:_jsxs(_components.p,{children:[`Add `,_jsx(_components.code,{children:`https://api-sandbox.ledgersyncappv2.com/mcp`}),` as a second connector. Test with `,_jsx(_components.strong,{children:`FinBank`}),`, `,_jsx(_components.strong,{children:`MX Bank`}),`\nor `,_jsx(_components.strong,{children:`Ledgersync Bank`}),` and the test sign-ins in `,_jsx(_components.a,{href:`/guides/testing`,children:`Testing in sandbox`}),`. Desktop app tools\nare live only, and the four W-9 request tools are sandbox only for now. A QuickBooks push on sandbox really\nposts, to the Intuit sandbox QuickBooks company the client is connected to.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiBox`,children:_jsx(AiBox,{title:`Who can connect`,children:_jsxs(_components.p,{children:[`Firms that use the LedgerSync app (the owner, administrators and employees, each with their own app login)\nand approved developer accounts. A firm new to LedgerSync signs up in the LedgerSync app first. Claude Team\nand Enterprise Owners add it under `,_jsx(_components.strong,{children:`Organization settings`}),` first.`]})})})]}),_jsx(Accordion,{title:`Who can connect: the details`,id:`who-can-connect-the-details`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Firms that use the LedgerSync app: the owner, administrators and employees each sign in with their own\nLedgerSync app login (email or username, password, and the two-step code if the login has one). Each sees\nonly what they see in the app: an employee sees the clients assigned to them.`}),`\n`,_jsxs(_components.li,{children:[`Firms new to LedgerSync sign up in the LedgerSync app first\n(`,_jsx(_components.a,{href:`https://ledgersyncappv2.com/sign-up`,children:`ledgersyncappv2.com/sign-up`}),`), then connect like any other firm. Until\nour team has checked a new firm, `,_jsx(_components.code,{children:`ledgersync_create_connect_link`}),` answers `,_jsx(_components.code,{children:`firm_under_review`}),` and\n`,_jsx(_components.code,{children:`ledgersync_get_account_status`}),` adds the same sentence; every other tool works.`]}),`\n`,_jsx(_components.li,{children:`Approved developer accounts: type the developer portal email on the LedgerSync sign-in page. It sends you\nto the developer portal sign-in. The account must be approved for that environment; live also needs the\npayment step. An application still waiting for its first approval cannot connect yet.`}),`\n`,_jsxs(_components.li,{children:[`Sub-account (firm) logins and their employees cannot connect yet; they get `,_jsx(_components.strong,{children:`Connecting an AI assistant is\nnot available for sub-account logins yet.`}),` Client logins, support sessions and logins with access days and\nhours cannot connect.`]}),`\n`,_jsxs(_components.li,{children:[`ChatGPT: since 2026-11-11 the live connector is a plugin in ChatGPT’s plugin directory,\n`,_jsx(_components.a,{href:`https://chatgpt.com/plugins/plugin_asdk_app_6ae388df146c819191650a15919c8776`,children:`LedgerSync by LedgerSync Inc.`}),`\n(`,_jsx(_components.code,{children:`plugin_asdk_app_6ae388df146c819191650a15919c8776`}),`). Install it from `,_jsx(_components.strong,{children:`Plugins`}),` (search `,_jsx(_components.strong,{children:`LedgerSync`}),`, then\n`,_jsx(_components.strong,{children:`Install plugin`}),`) on chatgpt.com or the ChatGPT desktop app; once installed it also works in the phone app. On\nChatGPT Business, Enterprise or Edu, the workspace admin sets who can install it (`,_jsx(_components.strong,{children:`Admin console`}),`, then\n`,_jsx(_components.strong,{children:`Plugins`}),`). See `,_jsx(_components.a,{href:`/ai/setup-chatgpt`,children:`Set up in ChatGPT`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Added by hand (the sandbox address, or a ChatGPT that can’t install it from the directory), ChatGPT works on any\nplan, even the free one, in the web version on chatgpt.com. Add it from\n`,_jsx(_components.strong,{children:`Plugins`}),`: `,_jsx(_components.strong,{children:`Add`}),`, then `,_jsx(_components.strong,{children:`Add custom MCP server`}),` (older screens: `,_jsx(_components.strong,{children:`Create MCP\nApp`}),`). If neither is there, turn on `,_jsx(_components.strong,{children:`Developer mode`}),` (`,_jsx(_components.strong,{children:`Settings`}),`, then `,_jsx(_components.strong,{children:`Security and login`}),`). On\nChatGPT Business, Enterprise or Edu, only the workspace admin can add it for everyone.`]}),`\n`,_jsxs(_components.li,{children:[`On Claude Team and Enterprise, an Owner first adds it under `,_jsx(_components.strong,{children:`Organization settings > Connectors`}),` (`,_jsx(_components.strong,{children:`Add`}),`,\nthen `,_jsx(_components.strong,{children:`Custom`}),`, then `,_jsx(_components.strong,{children:`Web`}),`). Members then open `,_jsx(_components.strong,{children:`Connectors`}),`, find LedgerSync and click `,_jsx(_components.strong,{children:`Connect`}),`. The\nClaude Free plan allows one custom connector. Once added, it also works in Claude Desktop, the Claude\nmobile apps, and Claude Code signed in with the same account.`]}),`\n`,_jsxs(_components.li,{children:[`Grok works on any Grok plan, even the free one, on grok.com in a web browser: open\n`,_jsx(_components.a,{href:`https://grok.com/connectors`,children:`grok.com/connectors`}),`, click `,_jsx(_components.strong,{children:`New Connector`}),`, then `,_jsx(_components.strong,{children:`Custom`}),`, and enter the\naddress. On Grok Business and Enterprise, xAI’s docs say a team admin first adds it in the xAI console\n(`,_jsx(_components.a,{href:`https://console.x.ai`,children:`console.x.ai`}),`: `,_jsx(_components.strong,{children:`Grok Business`}),`, then `,_jsx(_components.strong,{children:`Connectors`}),`); each member then connects\ntheir own account at grok.com/connectors. In our check, Grok called a tool that changes data\n(`,_jsx(_components.code,{children:`ledgersync_create_client`}),`) without asking first. Claude and ChatGPT ask before they change something.`]}),`\n`,_jsxs(_components.li,{children:[`Grok Bot, Grok’s agent, adds LedgerSync when you ask it to: “Add a custom remote MCP server named LedgerSync\nwith URL `,_jsx(_components.a,{href:`https://api.ledgersyncappv2.com/mcp`,children:`https://api.ledgersyncappv2.com/mcp`}),`”. It signs in with Cursor’s client id\n(`,_jsx(_components.code,{children:`https://cursor.com/oauth/mcp-client.json`}),`), so the sign-in asks you to allow `,_jsx(_components.strong,{children:`Cursor`}),`. Every app that\nsigns in with that id, Cursor’s own included, is approved too. See `,_jsx(_components.a,{href:`/ai/setup-grok-bot`,children:`Set up in Grok Bot`}),`.`]}),`\n`,_jsx(_components.li,{children:`Other AI apps are not supported yet (they are blocked): only Claude, ChatGPT, Grok and apps that sign in\nwith Cursor’s client id are approved. Ask support if you need one.`}),`\n`]})}),_jsxs(_components.h2,{children:[`Tools `,_jsx(`span`,{className:`lsai-badge`,children:`64`})]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`What it does`}),_jsx(_components.th,{children:`Changes data`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_account_status`})}),_jsx(_components.td,{children:`Which firm and login it is connected as; is the connection ready; sandbox or live; refreshes left`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_find_clients`})}),_jsx(_components.td,{children:`Finds clients by name or email, and the firm’s own accounts, each with the id and the name the other client tools take together; says how many clients match in all and, with no search, how many have banks connected and how many need attention`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_client_snapshot`})}),_jsx(_components.td,{children:`One call to start work on a client: its accounting ledger, whether QuickBooks is connected and the date its books are closed through, its first accounts with each one’s latest statement, how many entries each review check flagged today, and the playbooks that fit; on sandbox for now, also its open W-9 requests`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_run_review_report`})}),_jsx(_components.td,{children:`One review check on a client’s QuickBooks books for a period: entries waiting for a category, expenses with no payee, entries on parent accounts, entries coded differently than the vendor’s usual account, or entries above an amount, each with why it was flagged and a suggested fix where one is clear`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_vendor_coding_history`})}),_jsx(_components.td,{children:`How a client has coded one vendor’s entries over the last months: the accounts used, most used first, with how often, when last and the average amount. Takes the vendor, or the text of a bank row`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_compare_statement_to_books`})}),_jsx(_components.td,{children:`Why a bank or card statement does not reconcile: LedgerSync’s copy of the statement against the client’s QuickBooks register for its period, the difference on its last day split into parts that add up to it, and the rows on each side that nothing matched`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_financials`})}),_jsx(_components.td,{children:`One financial report of a client straight from QuickBooks Online: profit and loss, balance sheet, cash flow, trial balance, A/R aging or A/P aging, for one period (one day for the as-of reports) or compared with another, each line with its change and the big changes flagged`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_drill_account`})}),_jsx(_components.td,{children:`One account of a client’s QuickBooks Online books broken down by the payees on its entries, for one period or compared with another: each payee’s amount and entries, which payees are new and which stopped. Starts from an account line of a financial report`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_run_diagnostic`})}),_jsx(_components.td,{children:`A new client’s QuickBooks Online books checked before a cleanup is priced, over the last 12 full months: entries per month, the bank and card accounts with how long since an entry was reconciled, entries waiting in Uncategorized and Ask My Accountant accounts, suspense balances, unused accounts, and receivables and bills over 90 days. Figures only, never hours or a price`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_create_client`})}),_jsx(_components.td,{children:`Adds a client, checking for duplicates first`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_client`})}),_jsxs(_components.td,{children:[`A client’s details as the app’s `,_jsx(_components.strong,{children:`Edit Client`}),` screen shows them: its name, its main email and whether the client signs in with it, its main phone number (the one LedgerSync texts), and its extra emails and phone numbers`]}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_update_client`})}),_jsxs(_components.td,{children:[`Changes a client’s name, main email, main phone number, or extra emails and phone numbers, as the app’s `,_jsx(_components.strong,{children:`Edit Client`}),` screen does; moves the client’s sign-in to a new email only when asked`]}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_create_connect_link`})}),_jsx(_components.td,{children:`Secure page where the account holder picks a bank and what to connect: transactions, statements, check images`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_search_institutions`})}),_jsx(_components.td,{children:`Is a bank supported; does it give check images; does it need the desktop app`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_connections`})}),_jsx(_components.td,{children:`A client’s bank connections and last refresh`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_connection`})}),_jsx(_components.td,{children:`Checks one bank connection`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_connections_needing_attention`})}),_jsx(_components.td,{children:`Broken connections across all clients, and the firm’s own`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_accounts`})}),_jsx(_components.td,{children:`A client’s accounts with balances`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_transactions`})}),_jsxs(_components.td,{children:[`An account’s transactions (last 30 days by default), leaving out the ones on LedgerSync’s Excluded list unless the user asks for them (`,_jsx(_components.code,{children:`include_excluded`}),`, which marks each one `,_jsx(_components.code,{children:`excluded`}),`); for a Manual or QuickBooks Online client, how many of its transactions have no rule yet, leaving out accounts hidden in LedgerSync`]}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_statements`})}),_jsx(_components.td,{children:`An account’s statements`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_statement_download_link`})}),_jsx(_components.td,{children:`One-time link to a statement PDF`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_check_images`})}),_jsx(_components.td,{children:`A client’s check images, newest first: each check’s date, number, amount, payee and memo as read from the check, its bank and account, and the bank transaction LedgerSync matched it to. Never the images themselves`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_check_images_download_link`})}),_jsx(_components.td,{children:`One-time links to a client’s check images as files: one check as its image, more as a ZIP (up to 200 a link) with each image named the way you ask and a CSV of their details`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_create_statement_upload_link`})}),_jsx(_components.td,{children:`Secure page where you upload a bank statement PDF to turn it into transactions`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_statement_conversion`})}),_jsx(_components.td,{children:`Has a statement conversion finished; its transactions, a page at a time`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_conversion_download_link`})}),_jsx(_components.td,{children:`One-time link to a converted statement as a CSV, Excel, QuickBooks or OFX file`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_refresh_connection`})}),_jsx(_components.td,{children:`Asks the bank for the latest data`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_operation_status`})}),_jsx(_components.td,{children:`Has a refresh finished`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_fix_link`})}),_jsx(_components.td,{children:`Secure page to fix a broken connection`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_preview_client_message`})}),_jsx(_components.td,{children:`Who would get your email or text (a reconnect message, an invitation, or a clarification request asking clients about some of their transactions), who is skipped and why, and a sample`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_send_client_message`})}),_jsx(_components.td,{children:`Sends a previewed email or text, each with that client’s own link`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_message_templates`})}),_jsx(_components.td,{children:`Your firm’s saved Issue, Invitation and Clarification templates, email and text`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_save_message_template`})}),_jsx(_components.td,{children:`Saves a message as a new firm template`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_clarification_answers`})}),_jsx(_components.td,{children:`What a client answered about the transactions LedgerSync asked them about, and which ones are still waiting for an answer`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_quickbooks_setup`})}),_jsx(_components.td,{children:`Is QuickBooks connected for a client; which QuickBooks bank account each account posts to; the client’s QuickBooks bank and credit card accounts`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_transactions_to_categorize`})}),_jsx(_components.td,{children:`One account’s transactions waiting on the For review list, with LedgerSync’s suggestions`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_quickbooks_categories`})}),_jsx(_components.td,{children:`A client’s QuickBooks categories`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_search_quickbooks_payees`})}),_jsx(_components.td,{children:`Finds a client’s QuickBooks vendors, customers and employees`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_preview_quickbooks_push`})}),_jsx(_components.td,{children:`Checks up to 100 transactions with the categories and payees the AI picked, and shows what would be posted to QuickBooks`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_push_to_quickbooks`})}),_jsx(_components.td,{children:`Posts a previewed set of transactions into the client’s QuickBooks`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_quickbooks_push_status`})}),_jsx(_components.td,{children:`What a QuickBooks push posted, skipped or failed, and why`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_rules_setup`})}),_jsx(_components.td,{children:`Can a client’s rules be set up (Manual and QuickBooks Online clients); counts of its categories, vendors, rules and waiting transactions (accounts hidden in LedgerSync left out); for a QuickBooks client, its QuickBooks connection and the transactions waiting for a link; can you make global rules; the limits; the client’s last setups`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_setup_categories`})}),_jsx(_components.td,{children:`A client’s categories or the firm’s global categories, with GL codes (Manual), links, a suggested link for each global category the client does not link, and the LS-AI mark`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_setup_vendors`})}),_jsx(_components.td,{children:`A client’s vendors (and, for a QuickBooks client, its customers) or the firm’s global vendors, with the LS-AI mark`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_rules`})}),_jsx(_components.td,{children:`A client’s rules or the firm’s global rules, with conditions, category, payee and the LS-AI mark`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_rule`})}),_jsx(_components.td,{children:`One of a client’s rules or the firm’s global rules in full: every condition, every category line of a client rule, its payee, whether it is on, and the rules just before and after it`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_uncategorized_transactions`})}),_jsx(_components.td,{children:`A client’s waiting transactions that no rule fills, grouped by bank text, largest groups first, and, at a QuickBooks client, the groups a global rule would file once a category is linked. Accounts hidden in LedgerSync are left out`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_preview_rules_setup`})}),_jsx(_components.td,{children:`Checks up to 100 rules with their new categories, links and vendors, and up to 50 changes to existing rules (edit, turn off, turn on, move, delete), and counts what each rule would fill and what each change would put back, keep or fill, for the client and at the firm’s other clients (never counting an account hidden in LedgerSync); at a QuickBooks client, also what waits for a link and which other clients need one`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_preview_category_links`})}),_jsx(_components.td,{children:`For one global category, proposes the category to link at every client that has none linked to it yet (only the clients you can see), with the totals, a summary by category and, at QuickBooks clients, how many waiting transactions the firm’s global rules would file once it is linked; a page at a time`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_apply_rules_setup`})}),_jsxs(_components.td,{children:[`Saves a previewed rules setup, makes its changes to existing rules and fills the waiting transactions, in the background; for a QuickBooks client, it first creates the new categories and vendors in the client’s QuickBooks; it also saves the links `,_jsx(_components.code,{children:`ledgersync_preview_category_links`}),` previewed, client by client`]}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_rules_setup_status`})}),_jsx(_components.td,{children:`How a rules setup is going; what it created (in QuickBooks too), changed and filled, never counting an account hidden in LedgerSync; what failed and why`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_undo_rules_setup`})}),_jsx(_components.td,{children:`Shows what undoing a rules setup would remove, put back and keep, never counting an account hidden in LedgerSync (what it created in QuickBooks stays); after a yes, undoes it`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_categorized_export_link`})}),_jsx(_components.td,{children:`How many of the Manual clients’ categorized transactions are not exported yet, and a 24-hour link to them as the LedgerSync app’s Default or ACS export file`}),_jsxs(_components.td,{children:[`No (pressing `,_jsx(_components.strong,{children:`Download`}),` on the link’s page marks them Synced)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_1099_summary`})}),_jsx(_components.td,{children:`The vendors a QuickBooks client paid at or over the 1099 threshold in a tax year, with each one’s QuickBooks 1099 flag, whether a tax ID and an email are on file (never the tax ID itself), a suggested next step and advice from the expense accounts its payments were booked to; card and payment app payments left out by default; can count only the accounts the accountant chooses; on sandbox for now, each vendor’s W-9 request too`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_preview_ledger_changes`})}),_jsx(_components.td,{children:`Checks marking up to 100 of a QuickBooks client’s vendors for 1099, or unmarking them: each vendor’s 1099 flag before and after, and the vendors it would leave as they are, with the reason`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_apply_ledger_changes`})}),_jsx(_components.td,{children:`Marks the previewed vendors for 1099 in the client’s QuickBooks, in the background, changing nothing else on them`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_ledger_changes_status`})}),_jsx(_components.td,{children:`How marking vendors went: which were changed, which were left as they were and why, and how an undo went`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_undo_ledger_changes`})}),_jsx(_components.td,{children:`Shows which vendors’ 1099 flags would go back and which would stay; after a yes, puts them back`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_preview_w9_requests`})}),_jsx(_components.td,{children:`Checks sending W-9 requests to up to 50 of a QuickBooks client’s vendors, picked from the 1099 list: the address each email would go to, the vendors it would leave out and why, and the email as the vendor would read it; also reminders, a corrected address, asking a vendor again and cancelling; can also save each W-9 to QuickBooks once the vendor signs (sandbox only for now)`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_send_w9_requests`})}),_jsx(_components.td,{children:`Emails the previewed W-9 requests from LedgerSync’s address in the firm’s name, each with the vendor’s own secure link to fill in and sign the form (sandbox only for now)`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_w9_requests`})}),_jsx(_components.td,{children:`A client’s W-9 requests: whether each vendor’s was sent, opened, completed, expired, cancelled, replaced by a newer one or bounced, with its dates and whether a tax ID came in, never the tax ID itself, and how each W-9’s save to QuickBooks went when it was chosen (sandbox only for now)`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_w9_download_link`})}),_jsx(_components.td,{children:`One-time link, good for 10 minutes, to a vendor’s completed W-9 as the official IRS form in PDF (sandbox only for now)`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_review_transactions`})}),_jsx(_components.td,{children:`One Manual or QuickBooks Online client’s transactions in the Rules Engine’s For review or Categorized tab, as the LedgerSync app shows them, each with its category and GL code, payee and the rule that filed it`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_preview_accept_transactions`})}),_jsx(_components.td,{children:`Checks accepting the For review transactions of 1 to 10 clients, by default the ones an inclusion rule filed, leaving out the categories you name: what would move to Categorized (an exclusion rule’s to Excluded), what LedgerSync would refuse and why, and what would stay and why`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_accept_transactions`})}),_jsx(_components.td,{children:`Accepts the previewed transactions, client by client, as the LedgerSync app’s Accept does; posts nothing to QuickBooks`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_undo_accept_transactions`})}),_jsx(_components.td,{children:`Shows which accepted transactions would go back to For review and which would stay (synced, exported or changed since); after a yes, moves them back`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_desktop_app_status`})}),_jsx(_components.td,{children:`Is the desktop app linked and connected (live only)`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_pair_desktop_app`})}),_jsx(_components.td,{children:`Links the desktop app with its 7-character code (live only)`}),_jsx(_components.td,{children:`Yes`})]})]})]}),_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Tool details: each client named with its id, ids sealed to their client, refreshes left, which firm and login, counting clients, the firm's own accounts, duplicates, reading and changing a client's details, client messages, invitations and clarification requests, the desktop app, statement conversions, the client snapshot, QuickBooks bookkeeping, rules setup, categorized export, the 1099 list and marking vendors for 1099, W-9 requests, accepting For review transactions and checking rules against them`,id:`tool-details-each-client-named-with-its-id-ids-sealed-to-their-client-refreshes-left-which-firm-and-login-counting-clients-the-firms-own-accounts-duplicates-reading-and-changing-a-clients-details-client-messages-invitations-and-clarification-requests-the-desktop-app-statement-conversions-the-client-snapshot-quickbooks-bookkeeping-rules-setup-categorized-export-the-1099-list-and-marking-vendors-for-1099-w-9-requests-accepting-for-review-transactions-and-checking-rules-against-them`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Every tool that works on a client names it twice: by its id and by its name. `,_jsx(_components.code,{children:`client_name`}),` goes right after\n`,_jsx(_components.code,{children:`client_id`}),`, and `,_jsx(_components.code,{children:`client_names`}),` after `,_jsx(_components.code,{children:`client_ids`}),`, one name for each id in the same order, as\n`,_jsx(_components.code,{children:`ledgersync_find_clients`}),` lists them in the same chat. The name is the client’s name, not its email or id.\nBefore the tool runs, LedgerSync checks that each id is a client the person sees and that the name is that\nclient. When it is not, nothing is read or changed: an id the person does not see answers `,_jsx(_components.code,{children:`not_found`}),`, and a\nmissing name (except in the older reads below) or a name of another client answers `,_jsx(_components.code,{children:`invalid_request`}),`, with a\n`,_jsx(_components.code,{children:`next_step`}),` that tells the AI to find the client again in this chat. For a name of another client, the error\nalso gives `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` (the client that id really is) and `,_jsx(_components.code,{children:`given_client_name`}),`. A call that names\nseveral clients is refused whole when one of them is wrong.`]}),`\n`,_jsxs(_components.li,{children:[`An AI app that still holds LedgerSync’s tool list from before October 30, 2026, when names began, sends client\nids without names: a ChatGPT copy added by hand keeps that list until you click `,_jsx(_components.strong,{children:`Refresh tools`}),`. The tools that read one client and\nexisted then still answer such a call: the id must be a client the person sees, a name it does give must be\nthat client, other ids must be the client’s, and the answer names the client. Those are the list, get and status\ntools of connections, accounts, transactions, statements, rules, rules setup, For review transactions,\nQuickBooks and the 1099 list. Previews, the categorized export link (its Download marks the transactions\nSynced), refreshes, fix and connect links, changes and every tool added since still need the name, and their\n`,_jsx(_components.code,{children:`next_step`}),` says how to load the new tool list.`]}),`\n`,_jsxs(_components.li,{children:[`A name copied from `,_jsx(_components.code,{children:`ledgersync_find_clients`}),` always matches. So does the same name in another order or\nspacing, and, for a client named with a code, the code alone or the rest of its name alone (`,_jsx(_components.code,{children:`ACME1234`}),` or\n`,_jsx(_components.code,{children:`Acme Plumbing`}),` for `,_jsx(_components.code,{children:`ACME1234 - Acme Plumbing`}),`). A shorter name matches only when no other client the person\nsees has all its words. Capitals, accents and punctuation do not count, `,_jsx(_components.code,{children:`\u0026`}),` reads as “and”, and a Dr, Mr, Mrs\nor Ms the client’s name lacks is ignored. Two clients with exactly the same name cannot be told apart by name:\nthe check proves the id and the name agree, and the answer shows the name.`]}),`\n`,_jsxs(_components.li,{children:[`LedgerSync’s instructions, tool descriptions and steps tell the AI to find each client with\n`,_jsx(_components.code,{children:`ledgersync_find_clients`}),` in the chat where it uses it, and never to reuse a client id from an earlier chat or\nfrom memory.`]}),`\n`,_jsxs(_components.li,{children:[`Every answer names each client it carries: `,_jsx(_components.code,{children:`client_name`}),` right after each `,_jsx(_components.code,{children:`client_id`}),`. An answer about one\nclient that shows no client id starts with both. A name LedgerSync cannot read just then is `,_jsx(_components.code,{children:`null`}),` or left\nout, and never turns a change that went through into an error.`]}),`\n`,_jsxs(_components.li,{children:[`Every other id a tool takes must belong to the named client. Another client’s connection, account, statement,\nrefresh operation, rule, rules setup, QuickBooks push or 1099 change set answers `,_jsx(_components.code,{children:`not_found`}),`; in a preview, it\nis refused like any id that is not the client’s. A list filtered by another client’s `,_jsx(_components.code,{children:`connection_id`}),`,\n`,_jsx(_components.code,{children:`account_id`}),` or `,_jsx(_components.code,{children:`rule_id`}),` answers `,_jsx(_components.code,{children:`not_found`}),` instead of an empty list. `,_jsx(_components.code,{children:`ledgersync_get_operation_status`}),`\nanswers only for a refresh of the connection it names.`]}),`\n`,_jsxs(_components.li,{children:[`Ids that only mean something inside one client’s books come sealed to that client: QuickBooks categories,\npayees, bank accounts and vendors, the accounts on a financial report’s lines and in the new-client check, and\nthe client’s own\ncategories, vendors and customers in rules setup (`,_jsx(_components.code,{children:`cat_c_...`}),`, `,_jsx(_components.code,{children:`ven_c_...`}),`, `,_jsx(_components.code,{children:`cus_c_...`}),`). A sealed id is the\nid, a dot and 8 more characters. A tool takes it back only for the client, and the kind of id, it was given\nfor: one from another client’s list, or one with no seal (as LedgerSync gave ids before), is refused with\n`,_jsx(_components.code,{children:`invalid_request`}),`, and the `,_jsx(_components.code,{children:`next_step`}),` tells the AI to list this client’s again. An `,_jsx(_components.code,{children:`account_id`}),` from a\nfinancial report line or the new-client check is taken only by `,_jsx(_components.code,{children:`ledgersync_drill_account`}),`: another tool’s\ninput refuses it with words that name that tool.\nThe firm’s ids (`,_jsx(_components.code,{children:`cat_f_...`}),`, `,_jsx(_components.code,{children:`ven_f_...`}),`), rule ids, and ids no tool takes back, such as a pushed transaction’s\nQuickBooks id, stay as they are.`]}),`\n`,_jsxs(_components.li,{children:[`A change that runs a preview’s confirmation names the same clients, with their names, as the preview did:\n`,_jsx(_components.code,{children:`ledgersync_push_to_quickbooks`}),`, `,_jsx(_components.code,{children:`ledgersync_apply_rules_setup`}),` and `,_jsx(_components.code,{children:`ledgersync_apply_ledger_changes`}),` take its\n`,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),`, `,_jsx(_components.code,{children:`ledgersync_accept_transactions`}),` and `,_jsx(_components.code,{children:`ledgersync_send_client_message`}),` its\n`,_jsx(_components.code,{children:`client_ids`}),` and `,_jsx(_components.code,{children:`client_names`}),`, and the second call of `,_jsx(_components.code,{children:`ledgersync_undo_accept_transactions`}),` the same clients\nas its first. Other clients are refused with `,_jsx(_components.code,{children:`invalid_request`}),`, and nothing changes. A confirmation that named\nno client (the links of `,_jsx(_components.code,{children:`ledgersync_preview_category_links`}),`, or a reconnect message chosen by bank or for every\nconnection needing attention) takes none.`]}),`\n`,_jsxs(_components.li,{children:[`An id of a client’s data (such as a `,_jsx(_components.code,{children:`cli_`}),`, `,_jsx(_components.code,{children:`con_`}),` or `,_jsx(_components.code,{children:`acc_`}),` id, or a sealed id) in an input that does not take\nit, such as a search text, is refused with `,_jsx(_components.code,{children:`invalid_request`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_account_status`}),` also says whether the connection is full or read-only. Refreshes left\nis your firm’s shared daily budget, not the per-app cap.`]}),`\n`,_jsxs(_components.li,{children:[`When `,_jsx(_components.code,{children:`access.status`}),` is `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`ledgersync_get_account_status`}),` also names the firm and the login the\nconnection uses, in `,_jsx(_components.code,{children:`account`}),`: `,_jsx(_components.code,{children:`firm_name`}),`, `,_jsx(_components.code,{children:`signed_in_as`}),` (the login’s email) and `,_jsx(_components.code,{children:`role`}),` (`,_jsx(_components.code,{children:`owner`}),`, `,_jsx(_components.code,{children:`admin`}),` or `,_jsx(_components.code,{children:`employee`}),`).\nA name LedgerSync could not read is left out.`]}),`\n`,_jsxs(_components.li,{children:[`An active status also has a `,_jsx(_components.code,{children:`next_step`}),`: greet the user by `,_jsx(_components.code,{children:`account.firm_name`}),`, say sandbox or live and full\nor read-only, find each client in the chat where it is used and pass its `,_jsx(_components.code,{children:`client_name`}),` with its `,_jsx(_components.code,{children:`client_id`}),`,\nand end with one offer. Until the connection has run another tool that worked, it also has\n`,_jsx(_components.code,{children:`suggested_questions`}),`, a short menu of what this connection can ask: reads only for a read-only connection,\nand, for a firm still under review, adding a client and converting a statement PDF (finding a client when\nread-only). Both menus of a reviewed firm ask which vendors need a 1099, since the 1099 list is a read, to\nreview a client’s books for last month, since the review only reads too, why a client’s bank account won’t\nreconcile for last month, since the reconciliation check only reads as well, to pull last month’s P\u0026L or\nbalance sheet for a client, a read too, and to check a new client’s books before pricing the cleanup, a read\nas well.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_find_clients`}),` returns 25 clients by default (up to 50) and `,_jsx(_components.code,{children:`total`}),`, how many clients match in\nall, so the AI can say how many clients the firm has without listing them; the firm’s own accounts entry is\nnever counted. `,_jsx(_components.code,{children:`next_cursor`}),` gets the next page of the same search. With no search, the first page also has\n`,_jsx(_components.code,{children:`clients_with_banks`}),`, how many of those clients have at least one bank connected in LedgerSync, working or\nnot, and `,_jsx(_components.code,{children:`clients_needing_attention`}),`, how many of them have a bank connection that needs attention, judged as\n`,_jsx(_components.code,{children:`ledgersync_list_connections_needing_attention`}),` judges it. An employee’s numbers cover the clients assigned\nto them. `,_jsx(_components.code,{children:`cursor`}),` is a new input, so an AI app that kept an older copy of the tools reloads them before it can\npage (see Tool updates below); `,_jsx(_components.code,{children:`total`}),` and the counts reach every app at once.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_find_clients`}),` also returns the firm’s own accounts: the banks connected on the firm owner’s\nown LedgerSync login rather than for a client, as the LedgerSync app’s client list shows them. They come\nback as one entry, first in the list, whose name ends in “(the firm’s own accounts)”, marked\n`,_jsx(_components.code,{children:`firm_own: true`}),` and with no email. Only the owner and administrators get it, never employees, and only\nwhen the owner’s login holds a bank connection and the search is blank or matches the firm’s name or the\nowner’s name, username or email.`]}),`\n`,_jsxs(_components.li,{children:[`The firm’s own entry’s id works with the other client tools, except client messages and client details:\nLedgerSync never messages the firm itself, so a reconnect preview leaves out the firm’s own connections and\nan invitation cannot go to it. The entry is not a client and has no client details, so `,_jsx(_components.code,{children:`ledgersync_get_client`}),`\nand `,_jsx(_components.code,{children:`ledgersync_update_client`}),` answer `,_jsx(_components.code,{children:`not_found`}),` for it; the firm’s own details change in the LedgerSync app.`]}),`\n`,_jsxs(_components.li,{children:[`The firm’s own entry’s id goes with its name as listed. The firm’s name alone, or “the firm’s own accounts”\nalone, also works as its `,_jsx(_components.code,{children:`client_name`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_create_client`}),` checks for an existing client with the same name or email first. A client\nadded through the AI is like a client added in the app: they can sign in to LedgerSync, and a bank they\nconnect brings your firm’s usual number of past statements. It takes no phone number: once it creates the\nclient, its `,_jsx(_components.code,{children:`next_step`}),` tells the AI to add the phone number, or any other detail, with\n`,_jsx(_components.code,{children:`ledgersync_update_client`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_client`}),` returns a client’s details as the LedgerSync app’s `,_jsx(_components.strong,{children:`Edit Client`}),` screen shows them,\nin `,_jsx(_components.code,{children:`details`}),`: `,_jsx(_components.code,{children:`email`}),` (the main email), `,_jsx(_components.code,{children:`email_is_sign_in`}),` (whether the client signs in to LedgerSync with\nit), `,_jsx(_components.code,{children:`phone`}),` (the main number, the one LedgerSync texts, shown as (431) 432-4232), `,_jsx(_components.code,{children:`extra_emails`}),` (a list of\naddresses) and `,_jsx(_components.code,{children:`extra_phones`}),` (each a `,_jsx(_components.code,{children:`phone`}),` and, when it has one, a `,_jsx(_components.code,{children:`label`}),`). `,_jsx(_components.code,{children:`email`}),` and `,_jsx(_components.code,{children:`phone`}),` are\n`,_jsx(_components.code,{children:`null`}),` when the client has none, as for a client added through the AI without an email. LedgerSync emails every address\nlisted. It changes nothing and needs `,_jsx(_components.code,{children:`read:clients`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_update_client`}),` changes those details as the `,_jsx(_components.strong,{children:`Edit Client`}),` screen does, in one call with no\npreview: the tool tells the AI to say exactly what will change and get the user’s yes first. Give only what\nchanges: `,_jsx(_components.code,{children:`name`}),` (at most 64 characters), `,_jsx(_components.code,{children:`email`}),` (the main email), `,_jsx(_components.code,{children:`phone`}),` (the main number) or\n`,_jsx(_components.code,{children:`remove_phone: true`}),`, `,_jsx(_components.code,{children:`add_emails`}),` (extra emails, up to 10), and `,_jsx(_components.code,{children:`add_phones`}),` (each a `,_jsx(_components.code,{children:`phone`}),` and an optional\n`,_jsx(_components.code,{children:`label`}),`, such as Cell or Office) and `,_jsx(_components.code,{children:`remove_phones`}),` (extra numbers). A client has at most 4 extra numbers.\nExtra numbers are added or removed one by one, never replaced as a list, so a call never drops one the AI did\nnot know about. Adding a number already listed changes only its label.`]}),`\n`,_jsx(_components.li,{children:`Extra emails can be added but not removed through the AI yet, and an extra email cannot become the main\nemail; for a client that signs in with its email, moving the sign-in to an extra address works.`}),`\n`,_jsxs(_components.li,{children:[`A phone number must be a US or Canadian number with its area code, such as 431 432 4232 (a +1 in front,\nspaces, dots, dashes, slashes and brackets are fine). It is saved as its 10 digits and shown as\n(431) 432-4232. Any other number, or one with an extension, is refused with `,_jsx(_components.code,{children:`invalid_request`}),`, and so is an\nemail address that is not valid; nothing is changed.`]}),`\n`,_jsxs(_components.li,{children:[`A number in `,_jsx(_components.code,{children:`remove_phones`}),` that is not on file comes back in `,_jsx(_components.code,{children:`not_on_file`}),`, and the rest is saved. The main\nemail is replaced with `,_jsx(_components.code,{children:`email`}),`, never removed, and the main number is replaced with `,_jsx(_components.code,{children:`phone`}),` or removed with\n`,_jsx(_components.code,{children:`remove_phone`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`If the client signs in to LedgerSync with its main email (`,_jsx(_components.code,{children:`email_is_sign_in`}),`), changing that email also needs\n`,_jsx(_components.code,{children:`move_login: true`}),`. It moves the client’s sign-in to the new email, as `,_jsx(_components.strong,{children:`Change login email`}),` does in the app:\nLedgerSync emails a sign-in link to the new address and a notice to the old one, and the client’s old\npassword, two-step sign-in and phone app sign-ins stop working. The tool tells the AI to set it only after the\nuser agrees. Without it, the change is refused with `,_jsx(_components.code,{children:`invalid_request`}),`, nothing is saved, and the `,_jsx(_components.code,{children:`next_step`}),`\ntells the AI to explain this to the user. A move to an email another LedgerSync account signs in with, or used\nbefore, is refused, with nothing changed.`]}),`\n`,_jsxs(_components.li,{children:[`The move goes first. Once it is done, the rest of the call is saved under the new sign-in; if that rest\nfails, the error’s `,_jsx(_components.code,{children:`next_step`}),` says the sign-in did move. At a firm whose own API integration finds its\nclients by their login, a client’s sign-in never moves: `,_jsx(_components.code,{children:`move_login`}),` is refused there, and the email changes\nwithout it while the client keeps signing in as before.`]}),`\n`,_jsxs(_components.li,{children:[`The answer gives `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` (after a rename, the new name, which the AI passes from then on),\n`,_jsx(_components.code,{children:`changed`}),` (any of `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`sign_in`}),`, `,_jsx(_components.code,{children:`phone`}),`, `,_jsx(_components.code,{children:`extra_emails`}),` and `,_jsx(_components.code,{children:`extra_phones`}),`), `,_jsx(_components.code,{children:`sign_in_moved`}),`\n(only when the sign-in moved), `,_jsx(_components.code,{children:`not_on_file`}),` (only when something was not on file) and the client’s\n`,_jsx(_components.code,{children:`details`}),` after the change, read back from LedgerSync as `,_jsx(_components.code,{children:`ledgersync_get_client`}),` gives them. When a main\nnumber was added or changed, its `,_jsx(_components.code,{children:`next_step`}),` offers to text the client an invitation to connect its bank\nwith `,_jsx(_components.code,{children:`ledgersync_preview_client_message`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Both tools work through the LedgerSync app’s own client routes, as the signed-in person: an employee reads\nand changes only the clients assigned to them. `,_jsx(_components.code,{children:`ledgersync_update_client`}),` counts toward its daily limit only\nwhen it has something to change. The same call again finds the change already made and answers that nothing\nchanged, and a change back to an earlier value is saved again. It needs `,_jsx(_components.code,{children:`write:clients`}),`: a read-only\nconnection gets `,_jsx(_components.code,{children:`insufficient_scope`}),`. It is marked as changing data, so Claude and ChatGPT ask before it\nruns. In Grok, ask it to wait for your yes.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_create_connect_link`}),` creates a secure page where the account holder picks their bank and\nwhat to connect (transactions, statements, check images), then signs in. It is the LedgerSync app’s own\nbank picker: the same bank list as the app’s `,_jsx(_components.strong,{children:`Add Bank Connection`}),` screen, and the same choice of\nconnections. `,_jsx(_components.code,{children:`ledgersync_get_fix_link`}),` creates one where they sign in to their bank again to fix a broken\nconnection. On both, the sign-in happens on LedgerSync’s page or on the bank-data partner’s secure page\nit opens, depending on the bank.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_fix_link`}),` takes the connection’s `,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),` with its `,_jsx(_components.code,{children:`connection_id`}),`. A\nconnection of another client answers `,_jsx(_components.code,{children:`not_found`}),`, and no link is made. Its answer gives the `,_jsx(_components.code,{children:`client_id`}),` and\n`,_jsx(_components.code,{children:`client_name`}),` too.`]}),`\n`,_jsx(_components.li,{children:`When what they pick needs more than one connection, for example Regions Bank statements and checks, the\npage goes through them one at a time, and each sign-in opens in a new tab.`}),`\n`,_jsxs(_components.li,{children:[`To email or text a client, the AI is pointed to `,_jsx(_components.code,{children:`ledgersync_preview_client_message`}),` and\n`,_jsx(_components.code,{children:`ledgersync_send_client_message`}),`, never to your own email app: LedgerSync sends the message itself,\nwith its own link for that client.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_create_connect_link`}),` with `,_jsx(_components.code,{children:`for_check_images: true`}),` makes the same link with Checks already\nticked. Check images come only through LedgerSync’s own connection, so for many banks they need one\nsign-in for it and another for transactions or statements. That connection is created as soon as the\naccount holder confirms it on the page; if they stop before signing in, use `,_jsx(_components.code,{children:`ledgersync_get_fix_link`}),` on\nthat connection instead of a new link. The images show in the LedgerSync app, and\n`,_jsx(_components.code,{children:`ledgersync_list_check_images`}),` lists them once they arrive with the statements.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_check_images`}),` lists a client’s check images, newest first, 50 a page (`,_jsx(_components.code,{children:`limit`}),` up to 100,\n`,_jsx(_components.code,{children:`cursor`}),` for more): each check’s `,_jsx(_components.code,{children:`check_id`}),`, `,_jsx(_components.code,{children:`date`}),` (the day it cleared), `,_jsx(_components.code,{children:`check_number`}),`, `,_jsx(_components.code,{children:`amount`}),`\n(negative for a check the client wrote; positive for one they deposited or, at some banks, one they\nwrote), `,_jsx(_components.code,{children:`payee`}),` and `,_jsx(_components.code,{children:`memo`}),` as read from\nthe check, `,_jsx(_components.code,{children:`check_date`}),` (written on the check), `,_jsx(_components.code,{children:`bank`}),`, `,_jsx(_components.code,{children:`account_id`}),`, `,_jsx(_components.code,{children:`account`}),` and, when LedgerSync matched\nthe check to a bank transaction, its `,_jsx(_components.code,{children:`transaction_id`}),`. Narrow it with `,_jsx(_components.code,{children:`account_id`}),`, `,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),`. Check\nimages come only from a bank’s Statements \u0026 Images connection: for another account, or a client without\none, the `,_jsx(_components.code,{children:`next_step`}),` says so.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_check_images_download_link`}),` gives links to the image files, never the images in the chat.\nIt takes the same `,_jsx(_components.code,{children:`account_id`}),`, `,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),`, or up to 200 `,_jsx(_components.code,{children:`check_ids`}),` from the list, and a\n`,_jsx(_components.code,{children:`file_name_pattern`}),` built from your naming convention with `,_jsx(_components.code,{children:`{date}`}),`, `,_jsx(_components.code,{children:`{year}`}),`, `,_jsx(_components.code,{children:`{month}`}),`, `,_jsx(_components.code,{children:`{day}`}),`,\n`,_jsx(_components.code,{children:`{check_number}`}),`, `,_jsx(_components.code,{children:`{payee}`}),`, `,_jsx(_components.code,{children:`{amount}`}),`, `,_jsx(_components.code,{children:`{memo}`}),`, `,_jsx(_components.code,{children:`{account}`}),`, `,_jsx(_components.code,{children:`{bank}`}),` and `,_jsx(_components.code,{children:`{check_date}`}),` (the default\nis `,_jsx(_components.code,{children:`{date}_{check_number}_{payee}_{amount}`}),`; the answer shows an `,_jsx(_components.code,{children:`example_file_name`}),`). One check downloads\nas its image; more as a ZIP of up to 200 images with `,_jsx(_components.code,{children:`check-images.csv`}),` (each check’s details and its\nfile) and, when some could not be included, `,_jsx(_components.code,{children:`checks-not-included.txt`}),`. More than 200 checks come as\nseveral links, newest first, up to 10 (2,000 checks); more is refused with a step to ask for a shorter\nperiod. Both tools need `,_jsx(_components.code,{children:`read:checks`}),`, which every connection holds, read-only ones too.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_search_institutions`}),` also says whether a bank gives transactions, statements and check\nimages. When a bank in the answer gives check images, the result adds a `,_jsx(_components.code,{children:`check_images_note`}),` on how to\nconnect them. `,_jsx(_components.code,{children:`ledgersync_list_connections`}),` also gives each connection’s status.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_connections_needing_attention`}),` lists the connections that are not working, across all\nyour clients, the ones that need the account holder first. For the owner and administrators it also lists\nthe ones on the firm’s own accounts, marked `,_jsx(_components.code,{children:`firm_own: true`}),`, with the firm’s own entry’s id as\n`,_jsx(_components.code,{children:`client_id`}),`. Each connection names its client: `,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),`, the name\n`,_jsx(_components.code,{children:`ledgersync_find_clients`}),` shows.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_preview_client_message`}),` comes first. It finds the clients whose bank connection needs\nattention: all of them, the ones at a bank you name (for example American Express), or the connections\nyou pick. It says how many messages will go out, who is skipped and why, and which link each client\ngets, and shows a sample. It sends nothing and creates no link.`]}),`\n`,_jsxs(_components.li,{children:[`When the AI picks the connections (`,_jsx(_components.code,{children:`connection_ids`}),`), it also names the clients they belong to, in\n`,_jsx(_components.code,{children:`client_ids`}),` and `,_jsx(_components.code,{children:`client_names`}),`. A connection of a client it does not name is refused with\n`,_jsx(_components.code,{children:`invalid_request`}),`, and nothing is sent.`]}),`\n`,_jsxs(_components.li,{children:[`Each message carries that client’s own link where the text says `,_jsx(_components.code,{children:`#LS_URL#`}),`: a link to fix the\nconnection or, for a bank LedgerSync now connects through MX (such as American Express), a link to\nconnect that bank again through MX. A client with several broken connections at such a bank gets one\nmessage. At any other bank, a client gets one message for each connection that needs attention, each\nwith that connection’s own link. When some clients get a fix link and others an MX link, the preview\nsays so, so you can word the message to fit both.`]}),`\n`,_jsxs(_components.li,{children:[`Messages can also use `,_jsx(_components.code,{children:`#CLIENT_NAME#`}),`, `,_jsx(_components.code,{children:`#BANK_NAME#`}),`, `,_jsx(_components.code,{children:`#COMPANY_NAME#`}),` (your firm’s name) and\n`,_jsx(_components.code,{children:`#EMPLOYEE_FIRST_NAME#`}),` (the first name of the person sending). An email without a subject gets one\nlike “Acme CPA needs you to reconnect your bank”, with your firm’s name.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_preview_client_message`}),` with `,_jsx(_components.code,{children:`purpose: \"invite\"`}),` prepares an invitation instead, for the\nclients you name in `,_jsx(_components.code,{children:`client_ids`}),` (up to 200), with their `,_jsx(_components.code,{children:`client_names`}),`, rather than for connections or a\nbank. Any client you see\ncan be invited, even one with banks already connected: the preview shows how many connections each one\nhas. Like a reconnect preview, it sends nothing and creates no link.`]}),`\n`,_jsxs(_components.li,{children:[`Each invitation carries that client’s own sign-in link where the text says `,_jsx(_components.code,{children:`#LS_URL#`}),`. It signs the\nclient in to their LedgerSync account with nothing to type, and they connect their bank there. The link\nworks for 6 days.`]}),`\n`,_jsxs(_components.li,{children:[`An invitation can use `,_jsx(_components.code,{children:`#CLIENT_NAME#`}),`, `,_jsx(_components.code,{children:`#COMPANY_NAME#`}),`, `,_jsx(_components.code,{children:`#EMPLOYEE_FIRST_NAME#`}),` and\n`,_jsx(_components.code,{children:`#ACCOUNTANT_NAME#`}),` (the full name of the person sending), but not `,_jsx(_components.code,{children:`#BANK_NAME#`}),`: an invitation is not\nabout one bank. An invitation email without a subject gets one like “Acme CPA invites you to connect\nyour bank”. Invitations count toward the same daily limit as other client messages.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_preview_client_message`}),` with `,_jsx(_components.code,{children:`purpose: \"clarification\"`}),` prepares a clarification request: it\nasks the clients you name in `,_jsx(_components.code,{children:`client_ids`}),` (up to 200), with their `,_jsx(_components.code,{children:`client_names`}),`, about some of their\ntransactions, named in `,_jsx(_components.code,{children:`transaction_ids`}),` (up to 200) by the `,_jsx(_components.code,{children:`txn_`}),` ids a transaction list gave, such as\n`,_jsx(_components.code,{children:`ledgersync_list_review_transactions`}),` or `,_jsx(_components.code,{children:`ledgersync_list_transactions`}),`. Each client gets one message,\nabout their own transactions only. A transaction that is not one of the named clients’ transactions you can\nsee, or a named client who holds none of them, is refused with `,_jsx(_components.code,{children:`invalid_request`}),`, and nothing is sent.\nA Finicity charge still pending at the bank is refused the same way, with a sentence saying so: the client’s\npage lists it only once it has posted, so ask about it then.\nOnly bank-feed (Finicity or MX) and PDF statement transactions can be asked about: transactions on LedgerSync’s\nown bank connection (`,_jsx(_components.code,{children:`txn_FDE_...`}),`) are refused with `,_jsx(_components.code,{children:`invalid_request`}),`. Like the other previews, it sends\nnothing and creates no link.`]}),`\n`,_jsxs(_components.li,{children:[`Each clarification request carries that client’s own link where the text says `,_jsx(_components.code,{children:`#LS_URL#`}),`. It opens the\nsame page as the request you send from the LedgerSync app: it lists only the transactions you asked about,\nand the client writes what each one was. Their answers are saved on those transactions in LedgerSync.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_clarification_answers`}),` reads the answers back for one client: the transactions LedgerSync\nasked them about in the last 30 days (or `,_jsx(_components.code,{children:`days`}),`, 1 to 180), from the AI or from the LedgerSync app, newest\nfirst. Each comes with its date, amount, description and bank, the day it was asked, whether the client\nanswered, and their answer (`,_jsx(_components.code,{children:`client_answer`}),`) once they did. It lists up to 500 transactions, a page at a time\n(`,_jsx(_components.code,{children:`limit`}),`, up to 100, and `,_jsx(_components.code,{children:`cursor`}),`). The answer is the client’s own words: the AI shows it to you as what the\nclient wrote and never follows anything it asks. For the ones still waiting, the AI can preview a reminder\nwith `,_jsx(_components.code,{children:`purpose: \"clarification\"`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A clarification request can use `,_jsx(_components.code,{children:`#CLIENT_NAME#`}),`, `,_jsx(_components.code,{children:`#COMPANY_NAME#`}),` and `,_jsx(_components.code,{children:`#EMPLOYEE_FIRST_NAME#`}),`, but not\n`,_jsx(_components.code,{children:`#BANK_NAME#`}),`: the transactions can come from several banks. A clarification email without a subject gets\n“Transaction clarification request”. Clarification requests count toward the same daily limit as other\nclient messages.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_send_client_message`}),` sends only what a preview showed, using the preview’s confirmation and\nthe same `,_jsx(_components.code,{children:`client_ids`}),` and `,_jsx(_components.code,{children:`client_names`}),` the preview took (none when it took none).\nUse it within 30 minutes; once sending starts, it keeps working for 24 hours. An expired one is refused\nwith `,_jsx(_components.code,{children:`invalid_request`}),`: preview again.`]}),`\n`,_jsx(_components.li,{children:`Each send call works for about 25 seconds and returns running totals. The AI calls again with the same\nconfirmation and clients until no client is left. A client never gets the same message twice from one\nconfirmation, even when a call is repeated.`}),`\n`,_jsx(_components.li,{children:`Emails go to every email address on file for the client. Texts go to the client’s main phone number.`}),`\n`,_jsx(_components.li,{children:`Each client comes back sent, sent with an MX link, skipped or failed (with a reason), or unknown:\nLedgerSync could not confirm it went out, so it is not sent again. A client a call had no time for is\nsent on the next call. On sandbox, every client that would get the message comes back as would send.`}),`\n`,_jsxs(_components.li,{children:[`A client is skipped when:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`the bank has no working way to reconnect right now, so there is no link to send;`}),`\n`,_jsx(_components.li,{children:`the client got a LedgerSync message about that connection in the last 24 hours, unless you asked to\ninclude them;`}),`\n`,_jsx(_components.li,{children:`the AI connector cannot reach the client’s record;`}),`\n`,_jsxs(_components.li,{children:[`for an email, the client has no email address (a client added through the AI without an email has\nnone until one is added with `,_jsx(_components.code,{children:`ledgersync_update_client`}),`);`]}),`\n`,_jsxs(_components.li,{children:[`for a text, texts are turned off for the client, there is no phone number (a client added through the\nAI has none until one is added with `,_jsx(_components.code,{children:`ledgersync_update_client`}),`), the client replied STOP (texts start\nagain when they reply START), it is outside the client’s texting hours, or LedgerSync’s assistant is\ntexting with the client right now;`]}),`\n`,_jsx(_components.li,{children:`for an invitation, the client was already invited through the AI in the last 24 hours (unless you\nasked to include them), is not one you can see in the LedgerSync app, or signs in through your firm’s\nown integration instead of the LedgerSync app;`}),`\n`,_jsx(_components.li,{children:`for a clarification request, the client was already asked about some of the same transactions through the\nAI in the last 24 hours (unless you asked to include them, for example to send a text after an email). A\nclarification email or text the email or text service refused outright does not count, and neither does a\nrequest sent from the LedgerSync app.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`When a client is skipped for having no phone number or no email address, the preview’s `,_jsx(_components.code,{children:`next_step`}),` tells the\nAI to add the number or address the user gives with `,_jsx(_components.code,{children:`ledgersync_update_client`}),`, after the user’s yes, and\nthen preview again. An AI app that has not loaded that tool yet is told to reconnect LedgerSync, or to make\nthe change in the LedgerSync app meanwhile; `,_jsx(_components.code,{children:`ledgersync_create_client`}),`’s `,_jsx(_components.code,{children:`next_step`}),` says the same.`]}),`\n`,_jsx(_components.li,{children:`A client fails when something changed since the preview (the client was removed, the connection no\nlonger needs attention, or it is no longer one you can see), when the client’s link could not be\ncreated, or when the email or text service refused the message or could not confirm a text went out. A\nclarification request also fails for a client when one of its transactions is no longer that client’s.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_message_templates`}),` lists your firm’s Issue templates (for reconnect messages),\nInvitation templates (for invitations) and Clarification templates (for clarification requests), email and\ntext, and flags (`,_jsx(_components.code,{children:`breaks_rules`}),`) any that uses a placeholder its kind of message does not allow.\n`,_jsx(_components.code,{children:`ledgersync_save_message_template`}),` saves a new one, an Invitation template with `,_jsx(_components.code,{children:`purpose: \"invite\"`}),` or a\nClarification template with `,_jsx(_components.code,{children:`purpose: \"clarification\"`}),`, and never changes an existing one. They are the same\ntemplates as in the Communication Center of the LedgerSync app, shared with your whole firm. A preview\ncan start from a saved template of its kind (an invitation from an Invitation template, a clarification\nrequest from a Clarification template); editing the template later does not change that preview. Only the\nAI uses a template’s email subject for now.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_desktop_app_status`}),` checks the app live and returns the Windows and Mac download links\nand the setup steps.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_pair_desktop_app`}),` replaces any computer linked before, so LedgerSync tells the AI to ask you to\nconfirm first.`]}),`\n`,_jsxs(_components.li,{children:[`A bank or connection that needs the desktop app for refreshes carries `,_jsx(_components.code,{children:`requires_desktop_app: true`}),` in\nthe search, connection and refresh-status results; the field is left out otherwise. A connection that is\nnot working on such a bank also gets a `,_jsx(_components.code,{children:`next_step`}),` that says so.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_create_statement_upload_link`}),` returns a secure LedgerSync page where the user uploads one bank\nstatement PDF (up to 30 MB), and a `,_jsx(_components.code,{children:`conversion_id`}),` (`,_jsx(_components.code,{children:`cnv_...`}),`). The AI cannot pass a file to LedgerSync,\neven one attached to the chat. LedgerSync reads it with the same reader as the PDF Converter in the app\nand `,_jsx(_components.code,{children:`POST /v3/statements/extract`}),`; nothing is added to a client. See\n`,_jsx(_components.a,{href:`/ai/convert-statement`,children:`Turn a bank statement PDF into transactions`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_statement_conversion`}),` says `,_jsx(_components.code,{children:`waiting_for_upload`}),` (with `,_jsx(_components.code,{children:`upload_problem`}),` when an upload was\nrefused, in words the AI can repeat), `,_jsx(_components.code,{children:`in_progress`}),`, `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`expired`}),` or `,_jsx(_components.code,{children:`deleted`}),` (the\nperson deleted it on the PDF Converter page in the app, so it has no transactions or file). A completed one\ngives the page count, the number of transactions, whether they match the statement’s balances and why not\n(`,_jsx(_components.code,{children:`validated`}),`; `,_jsx(_components.code,{children:`validation_status`}),`: `,_jsx(_components.code,{children:`balanced`}),`, `,_jsx(_components.code,{children:`balance_mismatch`}),`, `,_jsx(_components.code,{children:`totals_mismatch`}),` or `,_jsx(_components.code,{children:`balance_missing`}),`;\n`,_jsx(_components.code,{children:`validation_message`}),`, in words the AI can repeat; a conversion with no transactions has none of these) and\nthe transactions, 50 at a time by default (up to 200): pass `,_jsx(_components.code,{children:`next_cursor`}),` for more.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_conversion_download_link`}),` makes a link to the file the LedgerSync app’s PDF Converter\nmakes: `,_jsx(_components.code,{children:`csv`}),`, `,_jsx(_components.code,{children:`xlsx`}),` (Excel), `,_jsx(_components.code,{children:`qbo`}),` (a QuickBooks bank file) or `,_jsx(_components.code,{children:`ofx`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A conversion belongs to the person who made the upload link: the owner, an administrator or an employee.\nIt also shows on that person’s `,_jsx(_components.strong,{children:`PDF Converter`}),` page in the LedgerSync app, where it can be exported\nagain.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_client_snapshot`}),` starts work on one client in a single call. It returns the client’s `,_jsx(_components.code,{children:`ledger`}),`\n(`,_jsx(_components.code,{children:`quickbooks_online`}),`, `,_jsx(_components.code,{children:`zoho_books`}),`, `,_jsx(_components.code,{children:`xero`}),` or `,_jsx(_components.code,{children:`none`}),`) and `,_jsx(_components.code,{children:`quickbooks`}),`: its `,_jsx(_components.code,{children:`state`}),` (`,_jsx(_components.code,{children:`connected`}),`,\n`,_jsx(_components.code,{children:`not_connected`}),`, or `,_jsx(_components.code,{children:`broken`}),` with `,_jsx(_components.code,{children:`broken_reason`}),`) and, while connected, `,_jsx(_components.code,{children:`closing_date`}),`. That is the date the\nclient’s books are closed through in QuickBooks, `,_jsx(_components.code,{children:`none_set`}),` when QuickBooks has none, or `,_jsx(_components.code,{children:`unavailable`}),` when\nQuickBooks did not answer this time (call again; it never means none is set).`]}),`\n`,_jsxs(_components.li,{children:[`It also returns the client’s first accounts, written as `,_jsx(_components.code,{children:`ledgersync_list_accounts`}),` writes them (accounts on\nLedgerSync’s own connection included), each with `,_jsx(_components.code,{children:`last_statement`}),` (`,_jsx(_components.code,{children:`statement_id`}),` and `,_jsx(_components.code,{children:`statement_date`}),`, as\n`,_jsx(_components.code,{children:`ledgersync_list_statements`}),` gives them), and `,_jsx(_components.code,{children:`accounts_total`}),`. It names the `,_jsx(_components.code,{children:`recommended_playbooks`}),` that fit:\n`,_jsx(_components.code,{children:`month_end_review`}),` while QuickBooks works, `,_jsx(_components.code,{children:`explain_rec_difference`}),` while QuickBooks works and one of the\naccounts it returns has a `,_jsx(_components.code,{children:`last_statement`}),` and is not a loan, `,_jsx(_components.code,{children:`flux_and_summary`}),` while QuickBooks works,\n`,_jsx(_components.code,{children:`form_1099_season`}),` from November 1 to February 15 while QuickBooks works, and `,_jsx(_components.code,{children:`quickbooks_bookkeeping`}),` when an\naccount can post to QuickBooks. It never names `,_jsx(_components.code,{children:`prospect_diagnostic`}),`, since it cannot tell a new client from one\nthe firm has kept for years. `,_jsx(_components.code,{children:`data_as_of`}),` says when it was read. On the sandbox connector for now, it also\nreturns `,_jsx(_components.code,{children:`open_w9_requests`}),`, how many of the client’s W-9 requests are still open (sent or opened): the\nrequests `,_jsx(_components.code,{children:`ledgersync_list_w9_requests`}),` lists with `,_jsx(_components.code,{children:`status: open`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Its `,_jsx(_components.code,{children:`next_step`}),` ends with one or two offers, the first two of: the month-end review (until a review of last\nmonth finished today), the 1099 check in its season, bookkeeping, connecting a bank when the client has no\naccounts yet, and a dashboard of the client’s status.`]}),`\n`,_jsxs(_components.li,{children:[`The answer stays under 3,000 characters: when the client has more accounts than fit, it shows fewer, never counts\nfewer, and its `,_jsx(_components.code,{children:`next_step`}),` points to `,_jsx(_components.code,{children:`ledgersync_list_accounts`}),`. It reads the client’s QuickBooks once, for the\nclosing date, and changes nothing.`]}),`\n`,_jsxs(_components.li,{children:[`When a review check already read the client’s books for last month today and the client’s QuickBooks connection\nworks, the snapshot also returns `,_jsx(_components.code,{children:`reviews`}),`:\nthe `,_jsx(_components.code,{children:`period`}),`, its `,_jsx(_components.code,{children:`data_as_of`}),`, and `,_jsx(_components.code,{children:`counts`}),`, how many rows each review report flagged (`,_jsx(_components.code,{children:`uncategorized`}),`,\n`,_jsx(_components.code,{children:`no_payee`}),`, `,_jsx(_components.code,{children:`parent_account`}),`, `,_jsx(_components.code,{children:`expense_inconsistency`}),`, `,_jsx(_components.code,{children:`over_amount`}),` at 1,000.00). It never reads QuickBooks\nfor them, and leaves `,_jsx(_components.code,{children:`reviews`}),` out when there was no such read today.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_run_review_report`}),` runs one review check on a QuickBooks Online client’s books for a period (`,_jsx(_components.code,{children:`from`}),`\nand `,_jsx(_components.code,{children:`to`}),`, `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`, at most 366 days; the last full calendar month by default). `,_jsx(_components.code,{children:`report`}),` is `,_jsx(_components.code,{children:`uncategorized`}),`\n(entries waiting in an Uncategorized or Ask My Accountant account), `,_jsx(_components.code,{children:`no_payee`}),` (expenses, checks and card\ncharges with no payee), `,_jsx(_components.code,{children:`parent_account`}),` (entries on an account that has sub-accounts), `,_jsx(_components.code,{children:`expense_inconsistency`}),`\n(a vendor’s entries coded to an account it rarely uses: under 10% of the vendor’s lines on regular accounts, not\nUncategorized, Ask My Accountant or parent accounts, over the last 12 months, the entry’s own line counted, while\nits most-used regular account holds at least half of them and is still active) or `,_jsx(_components.code,{children:`over_amount`}),` (entries above\n`,_jsx(_components.code,{children:`amount_threshold`}),`, 1,000.00 by default, the largest first). For a month-end review, run them in that order:\neach answer’s `,_jsx(_components.code,{children:`next_step`}),` offers the next one, and the last (`,_jsx(_components.code,{children:`over_amount`}),`) ends with what the review does not\ncheck (bill payments, customer payments, invoices, sales receipts, refund receipts, credit memos, estimates,\ntime entries, voided entries and balances left in suspense accounts), then offers a dashboard of the five counts or\nthe same review for the firm’s other clients.`]}),`\n`,_jsxs(_components.li,{children:[`The instructions on `,_jsx(_components.a,{href:`/ai/review-my-client`,children:`Review a client’s books`}),` are also an MCP prompt, `,_jsx(_components.code,{children:`month_end_review`}),`\n(“Review a client’s books for the month”), with optional `,_jsx(_components.code,{children:`client`}),` and `,_jsx(_components.code,{children:`month`}),` arguments. Claude Code lists it as\na command.`]}),`\n`,_jsxs(_components.li,{children:[`An `,_jsx(_components.code,{children:`expense_inconsistency`}),` row’s `,_jsx(_components.code,{children:`reason`}),` reads like `,_jsx(_components.em,{children:`“Home Depot coded to Job Supplies 212 of 214 times since\n2025-11; Meals 1 time”`}),`, and its `,_jsx(_components.code,{children:`suggested_fix`}),` is the vendor’s usual account. An unusual account is not always\na mistake, so the AI asks before suggesting the change.`]}),`\n`,_jsxs(_components.li,{children:[`A `,_jsx(_components.code,{children:`no_payee`}),` row’s suggested payee comes first from the bank rows LedgerSync sent to the client’s QuickBooks with\nthe same text, then from the payees’ names in the text.`]}),`\n`,_jsxs(_components.li,{children:[`Each row gives the entry (`,_jsx(_components.code,{children:`qbo_ref`}),`, and `,_jsx(_components.code,{children:`line_id`}),` for a line), its `,_jsx(_components.code,{children:`date`}),`, its `,_jsx(_components.code,{children:`amount`}),` with its sign, its\n`,_jsx(_components.code,{children:`payee`}),` and `,_jsx(_components.code,{children:`account`}),`, a `,_jsx(_components.code,{children:`reason`}),` saying why it is flagged, and a `,_jsx(_components.code,{children:`suggested_fix`}),` (a category or a payee) where\nthe client’s history or the entry’s text makes one clear. A parent account row without a fix lists the\n`,_jsx(_components.code,{children:`choices`}),` to pick from. Every row also has a `,_jsx(_components.code,{children:`decision_key`}),` and a `,_jsx(_components.code,{children:`fingerprint`}),`. `,_jsx(_components.code,{children:`summary`}),` counts and totals\nevery row, not only the page.`]}),`\n`,_jsxs(_components.li,{children:[`LedgerSync reads the period from QuickBooks once and keeps it for the day, so every report and threshold on\nthat period reuses it. A large client’s first call can answer `,_jsx(_components.code,{children:`status: running`}),`: the same call about 30\nseconds later answers the report. `,_jsx(_components.code,{children:`refresh`}),` reads again, unless the last read is under 5 minutes old\n(`,_jsx(_components.code,{children:`data_as_of`}),` says when it was read).`]}),`\n`,_jsxs(_components.li,{children:[`It pages with `,_jsx(_components.code,{children:`next_cursor`}),` (25 rows by default, up to 100), and each answer stays under 15,000 characters. It\nchanges nothing: the user makes the fixes in QuickBooks. A client on Zoho Books or Xero is refused with\n`,_jsx(_components.code,{children:`invalid_request`}),`, and so is a period with more entries than one read keeps (on `,_jsx(_components.code,{children:`from`}),`: choose a shorter one).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_vendor_coding_history`}),` shows how a QuickBooks Online client has coded one payee’s expenses,\nchecks, card charges, bills and vendor credits over the last full months (`,_jsx(_components.code,{children:`months`}),`, 1 to 12, 12 by default,\ncounted back from last month; `,_jsx(_components.code,{children:`window`}),` gives the dates). Give `,_jsx(_components.code,{children:`payee_id`}),` with `,_jsx(_components.code,{children:`payee_type`}),` (from a review report\nrow, `,_jsx(_components.code,{children:`ledgersync_get_1099_summary`}),` or `,_jsx(_components.code,{children:`ledgersync_search_quickbooks_payees`}),`), or `,_jsx(_components.code,{children:`bank_text`}),`, the text of a bank\nrow (at most 200 characters).`]}),`\n`,_jsxs(_components.li,{children:[`Bank text is matched to one payee the way a `,_jsx(_components.code,{children:`no_payee`}),` fix is: the bank rows LedgerSync sent with that text\nfirst (`,_jsx(_components.code,{children:`resolved_from: sent_bank_rows`}),`), then the payees’ names (`,_jsx(_components.code,{children:`payee_name`}),`, `,_jsx(_components.code,{children:`words_in_text`}),`). Text that\nmatches several payees returns them as `,_jsx(_components.code,{children:`candidates`}),` for the user to pick; text that matches none says to find\nthe payee with `,_jsx(_components.code,{children:`ledgersync_search_quickbooks_payees`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`top_categories`}),` lists up to 10 accounts, the most used first, each with its `,_jsx(_components.code,{children:`account`}),`, `,_jsx(_components.code,{children:`count`}),`,\n`,_jsx(_components.code,{children:`share_percent`}),`, `,_jsx(_components.code,{children:`last_used`}),` and `,_jsx(_components.code,{children:`average_amount`}),` (with its sign: a vendor credit takes off), and `,_jsx(_components.code,{children:`waiting`}),`,\n`,_jsx(_components.code,{children:`parent`}),` or `,_jsx(_components.code,{children:`inactive`}),` when the account is one. `,_jsx(_components.code,{children:`total_lines`}),` counts every line; `,_jsx(_components.code,{children:`other_accounts`}),` and\n`,_jsx(_components.code,{children:`other_lines`}),` count the rest. A bill with three lines counts three times.`]}),`\n`,_jsxs(_components.li,{children:[`It uses the same read of last month as the review reports, so a large client’s first call can answer\n`,_jsx(_components.code,{children:`status: running`}),`: call again in about 30 seconds. It changes nothing.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_compare_statement_to_books`}),` compares one LedgerSync statement of a bank or card account with the\nclient’s QuickBooks Online register for the account it is linked to, over the statement’s period. Give\n`,_jsx(_components.code,{children:`account_id`}),` and, for a statement other than the account’s newest, `,_jsx(_components.code,{children:`statement_id`}),` (from\n`,_jsx(_components.code,{children:`ledgersync_list_statements`}),`, of the same source as the account). A statement that covers several accounts is\ncompared on the account’s own part of it.`]}),`\n`,_jsxs(_components.li,{children:[`It returns the `,_jsx(_components.code,{children:`statement`}),` (its `,_jsx(_components.code,{children:`period`}),`, `,_jsx(_components.code,{children:`opening`}),` and `,_jsx(_components.code,{children:`closing`}),` balances, `,_jsx(_components.code,{children:`row_count`}),`, and `,_jsx(_components.code,{children:`statement_check`}),`:\n`,_jsx(_components.code,{children:`adds_up`}),`, or `,_jsx(_components.code,{children:`does_not_add_up`}),` with the `,_jsx(_components.code,{children:`statement_gap`}),` when the statement’s own rows do not add up to its\nbalances), the `,_jsx(_components.code,{children:`books`}),` balance before the period and on the statement’s last day (`,_jsx(_components.code,{children:`confirmed`}),` when QuickBooks’\nbalance sheet agrees, and `,_jsx(_components.code,{children:`balance_sheet_at_end`}),` when it does not), and the `,_jsx(_components.code,{children:`difference`}),`: the statement’s\nclosing balance minus the books balance on its last day. Balances read as the statement states them: money held\nfor a bank account, the amount owed for a card. Row amounts carry the bank’s sign: money into the account is\npositive.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`parts`}),` split the difference into amounts that always add up to it: `,_jsx(_components.code,{children:`from_before_this_statement`}),` (items still\nopen from earlier statements, or an earlier error), `,_jsx(_components.code,{children:`on_statement_not_in_books`}),`, `,_jsx(_components.code,{children:`in_books_not_on_statement`}),`,\n`,_jsx(_components.code,{children:`dated_after_statement_end_in_books`}),` and `,_jsx(_components.code,{children:`statement_gap`}),`. Items not yet at the bank, such as a check not cashed\nyet, are timing, not errors.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`likely_causes`}),` name what made the difference, the strongest first. Each gives its `,_jsx(_components.code,{children:`cause`}),`\n(`,_jsx(_components.code,{children:`statement_incomplete`}),`, `,_jsx(_components.code,{children:`sign_flip`}),`, `,_jsx(_components.code,{children:`transposed_digits`}),`, `,_jsx(_components.code,{children:`duplicate`}),`, `,_jsx(_components.code,{children:`missing_fee_or_interest`}),`, `,_jsx(_components.code,{children:`date_shift`}),`,\n`,_jsx(_components.code,{children:`missing_in_books`}),`, `,_jsx(_components.code,{children:`opening_difference`}),` or `,_jsx(_components.code,{children:`not_yet_at_bank`}),`), its `,_jsx(_components.code,{children:`confidence`}),` (`,_jsx(_components.code,{children:`high`}),`, `,_jsx(_components.code,{children:`medium`}),` or `,_jsx(_components.code,{children:`low`}),`), its\n`,_jsx(_components.code,{children:`effect`}),` (its signed share of the difference; the effects of every cause found add up to the difference), its\n`,_jsx(_components.code,{children:`evidence`}),` (one sentence with dates, amounts and names) and the rows it names in `,_jsx(_components.code,{children:`statement_rows`}),` and\n`,_jsx(_components.code,{children:`books_rows`}),`, with `,_jsx(_components.code,{children:`more_rows`}),` counting the ones not shown. Each unmatched row goes to one cause at most. The\nstatement’s own `,_jsx(_components.code,{children:`statement_incomplete`}),` comes first; then, at each confidence, mistakes come before timing\n(`,_jsx(_components.code,{children:`date_shift`}),`, `,_jsx(_components.code,{children:`opening_difference`}),`, `,_jsx(_components.code,{children:`not_yet_at_bank`}),`). The summary shows up to 10 causes, fewer when the answer\nruns long, and `,_jsx(_components.code,{children:`counts.likely_causes`}),` counts them all. An entry the bank has not shown that QuickBooks marks\nreconciled or cleared stays `,_jsx(_components.code,{children:`not_yet_at_bank`}),`, with the mark named in the evidence. When the entries still open\nfrom before this statement cancel each other out, the `,_jsx(_components.code,{children:`opening_difference`}),` evidence says so.`]}),`\n`,_jsxs(_components.li,{children:[`The summary lists the first rows of `,_jsx(_components.code,{children:`on_statement_not_in_books`}),` (statement rows nothing in the books matched) and\n`,_jsx(_components.code,{children:`in_books_not_on_statement`}),` (books entries of the period that neither this statement nor the previous one\nshows), and `,_jsx(_components.code,{children:`counts`}),` counts every row of each list. `,_jsx(_components.code,{children:`list`}),` pages one list at a time\n(`,_jsx(_components.code,{children:`on_statement_not_in_books`}),`, `,_jsx(_components.code,{children:`in_books_not_on_statement`}),` or `,_jsx(_components.code,{children:`matched`}),`) with `,_jsx(_components.code,{children:`next_cursor`}),`, 25 rows by default and\nup to 100. A books row gives its `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`amount`}),`, `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`payee`}),`, `,_jsx(_components.code,{children:`memo`}),`, `,_jsx(_components.code,{children:`quickbooks_cleared`}),`\n(QuickBooks’ own cleared mark, when the row has one) and `,_jsx(_components.code,{children:`qbo_ref`}),`. `,_jsx(_components.code,{children:`previous_statement_id`}),` names the account’s\nstatement before this one.`]}),`\n`,_jsx(_components.li,{children:`Rows are matched as LS Close matches them: the same amount within 4 days, 10 days for a card and 21 for a check\nwhose bank text starts “CHECK #”, then combinations of rows. Rows of one date and one amount that nothing tells\napart (two 105.00 deposits on one day, say) are paired in the statement’s order, where LS Close’s own screen\nleaves them to you. The previous statement and the one before it, when LedgerSync holds them, are matched as well,\nso an entry that cleared on either is not named as still open.`}),`\n`,_jsxs(_components.li,{children:[`An account with no QuickBooks account to compare with (not linked, or linked to one that is gone, inactive or not\na bank or card account) answers `,_jsx(_components.code,{children:`status: needs_quickbooks_account`}),` with the client’s bank and card accounts in\n`,_jsx(_components.code,{children:`choices`}),`. The AI asks the user which one, then calls again with its id as `,_jsx(_components.code,{children:`qbo_bank_account_id`}),`, which is used\nfor that comparison only and never saved.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`warnings`}),` names `,_jsx(_components.code,{children:`kinds_differ`}),` (the statement, the bank and QuickBooks disagree on whether the account holds\nmoney or is owed money), `,_jsx(_components.code,{children:`shared_link`}),` (another LedgerSync account of the client posts to the same QuickBooks\naccount, listed in `,_jsx(_components.code,{children:`shared_with`}),`), `,_jsx(_components.code,{children:`books_balance_unconfirmed`}),` and `,_jsx(_components.code,{children:`combinations_cut`}),` (some combinations of rows\nwere not tried).`]}),`\n`,_jsxs(_components.li,{children:[`LedgerSync compares in the background and keeps the comparison for the day, so a large account’s first call can\nanswer `,_jsx(_components.code,{children:`status: running`}),`: the same call about 30 seconds later answers it. `,_jsx(_components.code,{children:`refresh`}),` compares again, unless the\nlast comparison is under 5 minutes old (`,_jsx(_components.code,{children:`data_as_of`}),` says when QuickBooks was read). Each answer stays under\n15,000 characters. It changes nothing.`]}),`\n`,_jsxs(_components.li,{children:[`Every ready answer’s `,_jsx(_components.code,{children:`next_step`}),` ends with one or two offers: the list of fixes when there are causes; the\nprevious statement (`,_jsx(_components.code,{children:`previous_statement_id`}),`) when part of the difference started before this statement and no\nentry explains it, or else the client’s other accounts when the statement and the books agree; and a dashboard of\nthe reconciliation while fewer than two apply.`]}),`\n`,_jsxs(_components.li,{children:[`The instructions on `,_jsx(_components.a,{href:`/ai/explain-my-reconciliation`,children:`Explain my reconciliation`}),` are also an MCP prompt,\n`,_jsx(_components.code,{children:`explain_rec_difference`}),` (“Explain why an account does not reconcile”), with optional `,_jsx(_components.code,{children:`client`}),`, `,_jsx(_components.code,{children:`account`}),` and\n`,_jsx(_components.code,{children:`month`}),` arguments. Claude Code lists it as a command. The tool’s description carries the same steps for AI apps\nthat do not show prompts.`]}),`\n`,_jsxs(_components.li,{children:[`It refuses with `,_jsx(_components.code,{children:`invalid_request`}),` and a step, on the argument concerned: a statement converted from an uploaded\nPDF, a loan or mortgage account, an account with no statement in the last 24 months, a statement missing its\nbalances or rows, a statement of several accounts whose part for this account LedgerSync cannot tell, and a\nQuickBooks account kept in another currency than the company’s. A client on Zoho Books or Xero is refused too.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_financials`}),` reads one financial report of a QuickBooks Online client straight from QuickBooks.\n`,_jsx(_components.code,{children:`report`}),` is `,_jsx(_components.code,{children:`profit_and_loss`}),`, `,_jsx(_components.code,{children:`balance_sheet`}),`, `,_jsx(_components.code,{children:`cash_flow`}),`, `,_jsx(_components.code,{children:`trial_balance`}),`, `,_jsx(_components.code,{children:`ar_aging`}),` or `,_jsx(_components.code,{children:`ap_aging`}),`. The P\u0026L\nand the cash flow cover a period (`,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),`, both or neither; default: last month). The other reports are\nas of one day (`,_jsx(_components.code,{children:`to`}),`; default: the last day of last month), and `,_jsx(_components.code,{children:`from`}),` is not used there. Dates are YYYY-MM-DD,\nnot before 2000-01-01 and not after today.`]}),`\n`,_jsxs(_components.li,{children:[`To compare, give `,_jsx(_components.code,{children:`compare_from`}),` and `,_jsx(_components.code,{children:`compare_to`}),` (`,_jsx(_components.code,{children:`compare_to`}),` alone for the balance sheet); the trial balance\nand the aging reports are not compared. Each line then has `,_jsx(_components.code,{children:`compare_amount`}),`, `,_jsx(_components.code,{children:`change`}),` (a blank counts as 0) and\n`,_jsx(_components.code,{children:`change_pct`}),` (none when the compare amount is blank or zero), as QuickBooks’ own previous-period columns count\nthem. `,_jsx(_components.code,{children:`flagged`}),` lists up to 10 account lines whose change is at least `,_jsx(_components.code,{children:`flag_amount`}),` and at least `,_jsx(_components.code,{children:`flag_percent`}),`\n(default 1,000.00 and 10; an account with no compare amount is flagged on the amount alone), the largest change\nfirst, each with its evidence, and `,_jsx(_components.code,{children:`flagged_count`}),` counts them all.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`basis`}),` is `,_jsx(_components.code,{children:`accrual`}),` or `,_jsx(_components.code,{children:`cash`}),` for the P\u0026L, the balance sheet and the trial balance, by default the client’s\nQuickBooks report setting (`,_jsx(_components.code,{children:`basis_source`}),` says which). The cash flow is QuickBooks’ standard statement\n(`,_jsx(_components.code,{children:`basis_source: standard`}),`), and the aging reports have no basis.`]}),`\n`,_jsxs(_components.li,{children:[`The answer gives `,_jsx(_components.code,{children:`summary`}),` (the report’s headline totals, such as total income, gross profit and net income on\nthe P\u0026L), `,_jsx(_components.code,{children:`lines`}),` in QuickBooks’ order with QuickBooks’ own amounts, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`data_as_of`}),` and `,_jsx(_components.code,{children:`notes`}),` (for\nexample, QuickBooks has nothing for these dates, or an input the report does not use). Each line has its\n`,_jsx(_components.code,{children:`label`}),`, `,_jsx(_components.code,{children:`level`}),` and `,_jsx(_components.code,{children:`kind`}),`: `,_jsx(_components.code,{children:`heading`}),`, `,_jsx(_components.code,{children:`account`}),`, `,_jsx(_components.code,{children:`line`}),` (a row with no account, such as net income) or\n`,_jsx(_components.code,{children:`total`}),`. The trial balance gives `,_jsx(_components.code,{children:`debit`}),` and `,_jsx(_components.code,{children:`credit`}),`, and the aging reports `,_jsx(_components.code,{children:`current`}),`, `,_jsx(_components.code,{children:`days_1_30`}),`,\n`,_jsx(_components.code,{children:`days_31_60`}),`, `,_jsx(_components.code,{children:`days_61_90`}),`, `,_jsx(_components.code,{children:`days_91_and_over`}),` and `,_jsx(_components.code,{children:`total`}),`. Amounts are strings with 2 decimals, and a blank\namount is left out.`]}),`\n`,_jsxs(_components.li,{children:[`On the P\u0026L, the balance sheet, the cash flow and the trial balance, each `,_jsx(_components.code,{children:`account`}),` line also has its\n`,_jsx(_components.code,{children:`account_id`}),`, sealed to the client, for `,_jsx(_components.code,{children:`ledgersync_drill_account`}),`; the aging reports’ lines have none. The\n`,_jsx(_components.code,{children:`next_step`}),` says which dates to drill with on each report: the report’s own over a period, and from the day\nafter `,_jsx(_components.code,{children:`compare_as_of`}),` to `,_jsx(_components.code,{children:`as_of`}),` for a balance sheet’s change. A balance on one day is not activity over a\nperiod, so there the AI asks the user which period.`]}),`\n`,_jsxs(_components.li,{children:[`Each answer stays under 15,000 characters, its whole text included (the sentence before the JSON and the\nclient’s name): the first page carries the summary and the flagged lines, then the\nlines, and a long report gives `,_jsx(_components.code,{children:`next_cursor`}),` for the next page. Each page reads QuickBooks again, so a cursor is\nrefused when the period, the basis or the client’s books changed since.`]}),`\n`,_jsxs(_components.li,{children:[`LedgerSync reads QuickBooks while the call waits, usually a few seconds, and stores nothing. When QuickBooks is\nbusy for the client, the call answers `,_jsx(_components.code,{children:`upstream_unavailable`}),`: try again in a few minutes. A report QuickBooks\ncuts short is refused with `,_jsx(_components.code,{children:`invalid_request`}),` on `,_jsx(_components.code,{children:`from`}),`, or on `,_jsx(_components.code,{children:`to`}),` for the as-of reports. A client on Zoho Books\nor Xero is refused too. It changes nothing.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_drill_account`}),` breaks one account of a QuickBooks Online client down by the payees on its entries\n(vendors, customers and anyone else QuickBooks names), straight from QuickBooks. `,_jsx(_components.code,{children:`account_id`}),` is an account\nline’s `,_jsx(_components.code,{children:`account_id`}),` from `,_jsx(_components.code,{children:`ledgersync_get_financials`}),`, a category id from `,_jsx(_components.code,{children:`ledgersync_list_quickbooks_categories`}),`\nor a review report, or a QuickBooks bank account id from `,_jsx(_components.code,{children:`ledgersync_get_quickbooks_setup`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The period is `,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),` (both or neither; default: last month), and `,_jsx(_components.code,{children:`compare_from`}),` and `,_jsx(_components.code,{children:`compare_to`}),`\ncompare it with another; each period is at most 366 days. It lists a period’s activity, never a balance.\n`,_jsx(_components.code,{children:`basis`}),` is `,_jsx(_components.code,{children:`accrual`}),` or `,_jsx(_components.code,{children:`cash`}),`, by default the client’s QuickBooks report setting: pass the report’s basis so\nthe total matches its line.`]}),`\n`,_jsxs(_components.li,{children:[`By default the total is the account’s own entries, the figure on its own report line;\n`,_jsx(_components.code,{children:`include_sub_accounts: true`}),` counts its sub-accounts’ entries too, the figure on a parent’s Total line. The\n`,_jsx(_components.code,{children:`summary`}),` always says what sits in the sub-accounts, and an account with no entries of its own says so and\noffers to read its sub-accounts.`]}),`\n`,_jsxs(_components.li,{children:[`Each row of `,_jsx(_components.code,{children:`payees`}),` has its `,_jsx(_components.code,{children:`amount`}),` and `,_jsx(_components.code,{children:`entries`}),` in the period and, with a comparison, `,_jsx(_components.code,{children:`compare_amount`}),`,\n`,_jsx(_components.code,{children:`compare_entries`}),`, `,_jsx(_components.code,{children:`change`}),`, `,_jsx(_components.code,{children:`change_pct`}),` and `,_jsx(_components.code,{children:`status`}),`: `,_jsx(_components.code,{children:`new`}),` (entries in the period and none in the compare\nperiod), `,_jsx(_components.code,{children:`stopped`}),` (the reverse) or `,_jsx(_components.code,{children:`continuing`}),`, by entries, not amounts. The largest changes come first (with\none period, the largest amounts), each row with its `,_jsx(_components.code,{children:`evidence`}),`. Entries with no payee are one row, marked\n`,_jsx(_components.code,{children:`no_payee`}),`, last and never counted as a payee. The first `,_jsx(_components.code,{children:`limit`}),` payees are listed one by one (default 15, at\nmost 50), and the rest are summed in `,_jsx(_components.code,{children:`others`}),`, so the rows and `,_jsx(_components.code,{children:`others`}),` always add up to the total.`]}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.code,{children:`summary`}),` gives the amount and entries in each period, the change, how many payees, how many are new with\ntheir amount, and how many stopped with their compare amount. Amounts are strings with 2 decimals. Each answer\nstays under 15,000 characters, its whole text included (the sentence before the JSON and the client’s name):\nwhen long names would pass that, the last payees are summed in `,_jsx(_components.code,{children:`others`}),` too, and a note says so.`]}),`\n`,_jsxs(_components.li,{children:[`LedgerSync reads QuickBooks while the call waits, usually a few seconds, and stores nothing. When QuickBooks is\nbusy for the client, the call answers `,_jsx(_components.code,{children:`upstream_unavailable`}),`: try again in a few minutes. A ledger QuickBooks\ncuts short, or takes too long to read over more than a month, is refused with `,_jsx(_components.code,{children:`invalid_request`}),` on `,_jsx(_components.code,{children:`from`}),` or\n`,_jsx(_components.code,{children:`compare_from`}),`: pick a shorter period. A client on Zoho Books or Xero is refused too. It changes nothing.`]}),`\n`,_jsxs(_components.li,{children:[`The instructions on `,_jsx(_components.a,{href:`/ai/what-changed`,children:`What changed this month`}),` are also an MCP prompt, `,_jsx(_components.code,{children:`flux_and_summary`}),`\n(“Explain what changed between two periods”), with optional `,_jsx(_components.code,{children:`client`}),`, `,_jsx(_components.code,{children:`period`}),` and `,_jsx(_components.code,{children:`compare_with`}),` arguments:\nthe report for two periods, the payees behind its largest flagged lines (five at most), then a summary in plain\nwords. Claude Code lists it as a command. The descriptions of `,_jsx(_components.code,{children:`ledgersync_get_financials`}),` and\n`,_jsx(_components.code,{children:`ledgersync_drill_account`}),` name it for AI apps that do not show prompts.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_run_diagnostic`}),` checks a QuickBooks Online client’s books before a cleanup is priced, straight\nfrom QuickBooks, and takes only the client. It reads the last 12 full calendar months (`,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),`), with\nbalances, aging and the Reconciled search as of today (`,_jsx(_components.code,{children:`as_of`}),`), and answers a `,_jsx(_components.code,{children:`summary`}),` for a dashboard, then\nthe details.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`volume`}),`: the entries that post, per month (`,_jsx(_components.code,{children:`months`}),`), with `,_jsx(_components.code,{children:`average_per_month`}),`, `,_jsx(_components.code,{children:`busiest_month`}),` and `,_jsx(_components.code,{children:`by_type`}),`\n(QuickBooks’ own type names, at most 10, the rest as “Other”). Delayed charges, billable expense charges and\ntime charges post nothing and are left out.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`bank_and_card_accounts`}),`: each active bank and card account with its `,_jsx(_components.code,{children:`balance`}),`, its newest entry QuickBooks\nmarks Reconciled (`,_jsx(_components.code,{children:`newest_reconciled_on`}),`, searched back 36 months, from `,_jsx(_components.code,{children:`reconciled_search_from`}),`) and\n`,_jsx(_components.code,{children:`months_since_reconciled`}),`. An idle account, with no entry in the 12 months and a zero balance, is listed but\nnot counted in `,_jsx(_components.code,{children:`not_reconciled_account_count`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`waiting_accounts`}),`: the Uncategorized and Ask My Accountant accounts with entries or a balance, each with its\n`,_jsx(_components.code,{children:`entry_count`}),` and `,_jsx(_components.code,{children:`amount`}),` over the 12 months, counted as the review report’s uncategorized list counts them:\nno voided or zero entries, no item lines, no money moved out of the account. `,_jsx(_components.code,{children:`suspense_accounts`}),`: accounts\nwith Suspense in their name, with their `,_jsx(_components.code,{children:`balance`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`chart`}),`: the active and inactive accounts, the inactive ones with entries, and the unused ones (no entry in the\n12 months and no balance, in the account or any account under it), the first 25 by name. QuickBooks’ own\naccounts (Retained Earnings, Opening Balance Equity, Undeposited Funds and the Unapplied Cash accounts) are\nnever unused.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`receivables`}),` and `,_jsx(_components.code,{children:`payables`}),`: the open total, the amount over 90 days (QuickBooks’ own, net of old credits),\nhow many customers or vendors are over 90 days (`,_jsx(_components.code,{children:`over_90_customer_count`}),` on `,_jsx(_components.code,{children:`receivables`}),`,\n`,_jsx(_components.code,{children:`over_90_vendor_count`}),` on `,_jsx(_components.code,{children:`payables`}),`: customers and vendors, not invoices or bills), and the old credits, then\n`,_jsx(_components.code,{children:`evidence`}),` in words, for example “7,440.14 over 90 days: 7,925.94 owed to 2 vendors, less 4 old credits of\n485.80” or “nothing over 90 days”; then `,_jsx(_components.code,{children:`undeposited_funds`}),` and `,_jsx(_components.code,{children:`opening_balance_equity`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Each account row carries its `,_jsx(_components.code,{children:`account_id`}),`, sealed to the client, for `,_jsx(_components.code,{children:`ledgersync_drill_account`}),` with the\ncheck’s `,_jsx(_components.code,{children:`from`}),`, `,_jsx(_components.code,{children:`to`}),` and basis `,_jsx(_components.code,{children:`accrual`}),`, and its `,_jsx(_components.code,{children:`evidence`}),`. Amounts are strings with 2 decimals. Each answer\nstays under 15,000 characters, its whole text included (the sentence before the JSON and the client’s name):\npast that, the unused names drop first, then the waiting accounts with the\nfewest entries are summed in `,_jsx(_components.code,{children:`waiting_others`}),`, then the bank, card and suspense rows that do not fit are\ncounted, each step with a note.`]}),`\n`,_jsxs(_components.li,{children:[`LedgerSync gives figures only, never hours or a price: the AI asks the user for their firm’s rates and uses\nonly those. The `,_jsx(_components.code,{children:`next_step`}),` offers a dashboard, then the next useful step: the waiting entries one by one\n(`,_jsx(_components.code,{children:`ledgersync_run_review_report`}),`), why an account does not reconcile (`,_jsx(_components.code,{children:`ledgersync_compare_statement_to_books`}),`),\na bank connect link when the books hold no entries, or the month-end review.`]}),`\n`,_jsxs(_components.li,{children:[`LedgerSync reads QuickBooks while the call waits, usually about 15 seconds, and stores nothing. When QuickBooks takes too\nlong for the entries list or the whole ledger, that part is left out with a note and the rest still answers.\nWhen LedgerSync is busy with other checks, the call answers `,_jsx(_components.code,{children:`upstream_unavailable`}),` with a step to try again in\na minute. A client on Zoho Books or Xero is refused too. It changes nothing.`]}),`\n`,_jsxs(_components.li,{children:[`The instructions on `,_jsx(_components.a,{href:`/ai/new-client-check`,children:`Check a new client’s books`}),` are also an MCP prompt,\n`,_jsx(_components.code,{children:`prospect_diagnostic`}),` (“Check a new client’s books before pricing a cleanup”), with an optional `,_jsx(_components.code,{children:`client`}),`\nargument: the check, the firm’s own rates (asked before any hours, never made up), then the scope with its\nhours. Claude Code lists it as a command. The check’s description names it for AI apps that do not show\nprompts.`]}),`\n`,_jsxs(_components.li,{children:[`QuickBooks bookkeeping is for clients whose bank transactions do not come into QuickBooks through a\nQuickBooks bank feed. The AI categorizes the client’s transactions waiting in LedgerSync and, after the user\napproves a preview, LedgerSync posts them into the client’s QuickBooks Online. See\n`,_jsx(_components.a,{href:`/ai/quickbooks-bookkeeping`,children:`Bookkeeping into QuickBooks`}),`. Accounts on LedgerSync’s own connection\n(`,_jsx(_components.code,{children:`acc_FDE_...`}),`) are not supported yet and are refused with `,_jsx(_components.code,{children:`invalid_request`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_quickbooks_setup`}),` says whether QuickBooks is `,_jsx(_components.code,{children:`connected`}),`, `,_jsx(_components.code,{children:`not_connected`}),` or `,_jsx(_components.code,{children:`broken`}),` (with\nthe reason) for a client. It lists the client’s accounts with the QuickBooks bank account each posts to, and\nthe client’s active QuickBooks Bank and Credit Card accounts. Its `,_jsx(_components.code,{children:`next_step`}),` tells the AI to ask the user\nwhich QuickBooks account an account without one posts to, and to confirm those QuickBooks accounts have no\nQuickBooks bank feed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_transactions_to_categorize`}),` lists one account’s transactions that are on the For review\nlist, posted (not pending), not yet sent to QuickBooks and not excluded by a rule, 50 at a time by default\n(up to 100; pass `,_jsx(_components.code,{children:`next_cursor`}),` for more), between optional `,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),` dates. Each carries LedgerSync’s\nsuggestion when it has one (category, payee, the rule that made it), `,_jsx(_components.code,{children:`possible_duplicate`}),` when LedgerSync\nflagged it as possibly in QuickBooks already, and, on Finicity accounts, `,_jsx(_components.code,{children:`possible_transfer`}),`. A row one of the\nfirm’s global rules matched but could not file, because the client has no QuickBooks category mapped to the\nrule’s global category, carries `,_jsx(_components.code,{children:`pending_global_rule`}),` (`,_jsx(_components.code,{children:`rule_name`}),`, `,_jsx(_components.code,{children:`global_category`}),`). The tool’s\n`,_jsx(_components.code,{children:`next_step`}),` tells the AI to keep LedgerSync’s suggestions and to ask the user about those rows.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_quickbooks_categories`}),` lists the client’s active QuickBooks categories from LedgerSync’s\ncopy of the client’s chart of accounts, a page at a time, narrowed by `,_jsx(_components.code,{children:`query`}),`.\n`,_jsx(_components.code,{children:`ledgersync_search_quickbooks_payees`}),` finds active vendors (from LedgerSync’s copy), customers and\nemployees (read from QuickBooks), 50 by default and up to 200, by `,_jsx(_components.code,{children:`query`}),` and `,_jsx(_components.code,{children:`type`}),` (`,_jsx(_components.code,{children:`vendor`}),`, `,_jsx(_components.code,{children:`customer`}),`\nor `,_jsx(_components.code,{children:`employee`}),`), and says when more matched (`,_jsx(_components.code,{children:`truncated`}),`). A category or vendor added in QuickBooks shows\nafter `,_jsx(_components.strong,{children:`Sync QuickBooks Data`}),` in the LedgerSync app.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_preview_quickbooks_push`}),` takes the `,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),`, up to 100 `,_jsx(_components.code,{children:`rows`}),` (`,_jsx(_components.code,{children:`transaction_id`}),`,\n`,_jsx(_components.code,{children:`category_id`}),`, and `,_jsx(_components.code,{children:`payee_id`}),` with `,_jsx(_components.code,{children:`payee_type`}),` or a `,_jsx(_components.code,{children:`new_payee_name`}),`) and up to 5 `,_jsx(_components.code,{children:`account_mappings`}),`\n(`,_jsx(_components.code,{children:`account_id`}),`, `,_jsx(_components.code,{children:`qbo_bank_account_id`}),`). The `,_jsx(_components.code,{children:`category_id`}),`, `,_jsx(_components.code,{children:`payee_id`}),` and `,_jsx(_components.code,{children:`qbo_bank_account_id`}),` are the sealed\nids this client’s lists gave (`,_jsx(_components.code,{children:`ledgersync_list_quickbooks_categories`}),`, `,_jsx(_components.code,{children:`ledgersync_search_quickbooks_payees`}),`,\n`,_jsx(_components.code,{children:`ledgersync_get_quickbooks_setup`}),` or a row’s suggestion). It checks every row and mapping and writes nothing. It returns the totals (money in,\nmoney out), the totals by category, the new payees, the QuickBooks accounts used, every refused row with\nits reason, a sample of up to 20 rows, a warning for each QuickBooks account used asking to confirm it has\nno bank feed, and, when at least one row can be posted, a `,_jsx(_components.code,{children:`confirmation_id`}),` and its `,_jsx(_components.code,{children:`expires_at`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A row is refused when it is not this client’s, already categorized, sent or excluded, still pending,\nexcluded by a rule, flagged as a possible duplicate, on an unknown or inactive category or payee, without a\npayee, a deposit with an employee as payee, or on an account with no QuickBooks bank account. A row whose\ncategorization in LedgerSync already has a split, or a line with a class, its own amount or a billable\ncustomer, is refused as `,_jsx(_components.code,{children:`has_split_or_class`}),`, because the push would replace it with one line; accept it in\nthe LedgerSync app. A vendor name longer than 80 characters (a new payee name, or an existing vendor’s name in\nLedgerSync’s copy) is refused as `,_jsx(_components.code,{children:`payee_name_too_long`}),`: use a shorter new name, or shorten the vendor’s name\nin QuickBooks and click `,_jsx(_components.strong,{children:`Sync QuickBooks Data`}),` in the LedgerSync app before previewing again. A new payee\nname that matches an existing payee uses that payee. A mapping is refused when the QuickBooks account is not\nan active Bank or Credit Card account, or another of the client’s accounts already posts to it: each\nQuickBooks bank account goes with one account in LedgerSync.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_push_to_quickbooks`}),` takes the `,_jsx(_components.code,{children:`confirmation_id`}),` with the same `,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),` as the\npreview, and posts exactly what the preview accepted. It saves the new account mappings, creates the new payees in QuickBooks as vendors, writes the\ncategory and payee on each transaction, moves it to Categorized, and queues the same upload to QuickBooks\nas the LedgerSync app’s sync. As in the app, a new account mapping also goes on that account’s other\ntransactions, and a new payee on the client’s other transactions not yet in QuickBooks that carry that\nname as a suggested payee (no payee id). A transaction that changed since the preview is refused. It\nreturns a `,_jsx(_components.code,{children:`push_id`}),` (`,_jsx(_components.code,{children:`qbp_...`}),`), a status (`,_jsx(_components.code,{children:`queued`}),`, `,_jsx(_components.code,{children:`nothing_to_push`}),` or `,_jsx(_components.code,{children:`already_queued`}),`), the number\nqueued, the refused transactions and the payees it created. Calling it again with the same confirmation\nreturns the same answer and never posts twice.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_quickbooks_push_status`}),` takes the `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` and the `,_jsx(_components.code,{children:`push_id`}),` and says `,_jsx(_components.code,{children:`in_progress`}),`,\n`,_jsx(_components.code,{children:`finished`}),` or `,_jsx(_components.code,{children:`failed`}),`, with counts and, for each transaction, `,_jsx(_components.code,{children:`synced`}),` (with its QuickBooks id), `,_jsx(_components.code,{children:`failed`}),`\n(with the reason), `,_jsx(_components.code,{children:`skipped_possible_duplicate`}),`, `,_jsx(_components.code,{children:`skipped_not_posted`}),`, `,_jsx(_components.code,{children:`pending`}),` or `,_jsx(_components.code,{children:`not_pushed`}),`, a page at\na time.`]}),`\n`,_jsxs(_components.li,{children:[`The instructions on `,_jsx(_components.a,{href:`/ai/quickbooks-bookkeeping`,children:`Bookkeeping into QuickBooks`}),` are also an MCP prompt,\n`,_jsx(_components.code,{children:`quickbooks_bookkeeping`}),` (“Bookkeeping into QuickBooks”), with optional `,_jsx(_components.code,{children:`client`}),` and `,_jsx(_components.code,{children:`period`}),` arguments.\nClaude Code lists it as a command.`]}),`\n`,_jsxs(_components.li,{children:[`Rules setup lets the AI create a client’s categorization rules in LedgerSync, with the new categories,\ncategory links and vendors they need, and change the rules that exist, after the user approves a preview. It\nworks for Manual and QuickBooks Online clients. For a client on another accounting app, such as Zoho Books,\n`,_jsx(_components.code,{children:`ledgersync_get_rules_setup`}),` answers `,_jsx(_components.code,{children:`supported: false`}),` with the reason in its `,_jsx(_components.code,{children:`next_step`}),`, and a preview is\nrefused with `,_jsx(_components.code,{children:`invalid_request`}),`. See\n`,_jsx(_components.a,{href:`/ai/rules-setup`,children:`Set up rules for a client`}),`. An AI app connected before these tools came out must load the\nnew tool list first: reconnect in Claude, click `,_jsx(_components.strong,{children:`Refresh`}),` in ChatGPT (a copy added by hand) or reauthenticate in Grok, then start a\nnew chat (see Tool updates below).`]}),`\n`,_jsxs(_components.li,{children:[`The AI offers rules without being asked. For a Manual or QuickBooks Online client, the first page of\n`,_jsx(_components.code,{children:`ledgersync_list_transactions`}),` also answers `,_jsx(_components.code,{children:`transactions_without_rule`}),`: how many of the client’s transactions\nno rule and nobody filled yet (all of its accounts and dates, the transactions rules setup works on), when\nthere are any. Its `,_jsx(_components.code,{children:`next_step`}),` then tells the AI to offer rules and, after the user’s yes, to call\n`,_jsx(_components.code,{children:`ledgersync_get_rules_setup`}),`. `,_jsx(_components.code,{children:`ledgersync_list_transactions_to_categorize`}),` offers the same after a push, when\na transaction it lists has no rule and no `,_jsx(_components.code,{children:`pending_global_rule`}),`. Neither offers on a read-only connection. In\na setup, the AI picks client or global for each rule itself and proposes each rule by name for a yes or no.`]}),`\n`,_jsxs(_components.li,{children:[`For a QuickBooks client, a client rule files to one of the client’s QuickBooks categories and pays one of its\nQuickBooks vendors or customers, never an employee. A global rule files to a firm category through the\nclient’s category linked to it: without a link, its transactions wait with the “map this category” badge. The\nclient’s new categories and vendors are created in its QuickBooks when the setup runs, after the yes. A\ncategory or vendor QuickBooks already has with that name is used instead (a category only when it has the same\nfull name, so the same parent, and the same type), and a deactivated one is never turned back on. A new client\ncategory needs an `,_jsx(_components.code,{children:`account_type`}),` (a QuickBooks account type, such as `,_jsx(_components.code,{children:`Expense`}),`) and is created at the top level,\nor as a sub-account of the existing category in its `,_jsx(_components.code,{children:`parent`}),`, whose type it takes when it has no\n`,_jsx(_components.code,{children:`account_type`}),`. It may also have a `,_jsx(_components.code,{children:`detail_type`}),`: QuickBooks’ detail type (AccountSubType), one LedgerSync\nknows for its account type or, under a parent, the parent’s own. A sub-account without one takes its parent’s.\nA top-level one without one would get QuickBooks’ default for its type (`,_jsx(_components.code,{children:`Travel`}),` for an Expense account), so\na preview that keeps one says in its `,_jsx(_components.code,{children:`next_step`}),` to propose a `,_jsx(_components.code,{children:`detail_type`}),` and preview again.\nLedgerSync keeps no GL codes for QuickBooks: a `,_jsx(_components.code,{children:`gl_code`}),` sent with a new category is ignored.`]}),`\n`,_jsxs(_components.li,{children:[`A new category’s `,_jsx(_components.code,{children:`parent`}),` is read live from the client’s QuickBooks at the preview, and again when the apply\nchecks the items. It must be there and active, have the account type given (if one is), sit above the fifth\nlevel (QuickBooks nests accounts 5 levels deep at most), and not have one of the six detail types QuickBooks\nkeeps sub-accounts off: `,_jsx(_components.code,{children:`OpeningBalanceEquity`}),`, `,_jsx(_components.code,{children:`UndepositedFunds`}),`, `,_jsx(_components.code,{children:`RetainedEarnings`}),`, `,_jsx(_components.code,{children:`CashReceiptIncome`}),`,\n`,_jsx(_components.code,{children:`CashExpenditureExpense`}),` and `,_jsx(_components.code,{children:`ExchangeGainOrLoss`}),`. A `,_jsx(_components.code,{children:`detail_type`}),` matches any spelling QuickBooks shows, with\ncase and every character other than letters and digits ignored and `,_jsx(_components.code,{children:`\u0026`}),` read as nothing or as “and”\n(`,_jsx(_components.code,{children:`Office/General Administrative Expenses`}),` is `,_jsx(_components.code,{children:`OfficeGeneralAdministrativeExpenses`}),`, `,_jsx(_components.code,{children:`Rent \u0026 lease home office`}),` is\n`,_jsx(_components.code,{children:`RentAndLeaseHomeOffice`}),`), and QuickBooks’ screen labels worded otherwise match too (`,_jsx(_components.code,{children:`Communication`}),` is\n`,_jsx(_components.code,{children:`Communications`}),`); under a parent it cannot be one of those six. The new account’s full\nname, `,_jsx(_components.code,{children:`Parent:Name`}),` (the parent’s full name, a colon and its `,_jsx(_components.code,{children:`name`}),`), decides whether its name is taken: an\naccount with that full name is used instead, a top-level account with the same name does not block it, and two\nnew categories of one preview may share a name under different parents. A sub-account is named by its full name\nin the preview’s `,_jsx(_components.code,{children:`items`}),`, the status’s `,_jsx(_components.code,{children:`created_in_quickbooks`}),` and the undo, and its item shows the\n`,_jsx(_components.code,{children:`detail_type`}),` it gets.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_rules_setup`}),` takes the `,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),` and returns the client’s `,_jsx(_components.code,{children:`platform`}),`, whether rules setup is\n`,_jsx(_components.code,{children:`supported`}),` for it, `,_jsx(_components.code,{children:`counts`}),` (the client’s and the firm’s categories and how many have a GL code, their\nvendors and rules, and the client’s waiting transactions: all of them, the ones no rule holds, and the ones\nan existing rule matches), `,_jsx(_components.code,{children:`can_create_global_rules`}),`, the `,_jsx(_components.code,{children:`limits`}),` and the client’s last setups (`,_jsx(_components.code,{children:`setup_id`}),`,\n`,_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`created_at`}),`). Its `,_jsx(_components.code,{children:`next_step`}),` gives the AI the next steps, or says why the client is not\nsupported. `,_jsx(_components.code,{children:`counts`}),` also says how many global categories the client does not link\n(`,_jsx(_components.code,{children:`firm_categories_not_linked`}),`) and how many waiting transactions a global rule matches but cannot file for\nlack of a link (`,_jsx(_components.code,{children:`waiting_on_link`}),`, always 0 for a Manual client). For a QuickBooks client,\n`,_jsx(_components.code,{children:`quickbooks_connection`}),` says whether its QuickBooks connection works (`,_jsx(_components.code,{children:`connected`}),` or `,_jsx(_components.code,{children:`broken`}),`). When it is\nbroken, the `,_jsx(_components.code,{children:`next_step`}),` says to reconnect QuickBooks.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_setup_categories`}),` lists the client’s categories (`,_jsx(_components.code,{children:`kind: \"client\"`}),`, ids `,_jsx(_components.code,{children:`cat_c_...`}),`, with\ntheir `,_jsx(_components.code,{children:`gl_code`}),` and the global category each is linked to, `,_jsx(_components.code,{children:`firm_category`}),`) or the firm’s global categories\n(`,_jsx(_components.code,{children:`kind: \"firm\"`}),`, ids `,_jsx(_components.code,{children:`cat_f_...`}),`, with their `,_jsx(_components.code,{children:`gl_code`}),`, the client’s category linked to it, `,_jsx(_components.code,{children:`mapped_here`}),`, and\nhow many clients link it, `,_jsx(_components.code,{children:`clients_mapped`}),`), narrowed by `,_jsx(_components.code,{children:`query`}),` (a name or GL code), 50 at a time by default\n(up to 100).`]}),`\n`,_jsxs(_components.li,{children:[`A QuickBooks client’s categories are its active QuickBooks categories, each with its `,_jsx(_components.code,{children:`account_type`}),`, its\n`,_jsx(_components.code,{children:`full_name`}),` when that differs from its name (a sub-account’s includes its parents), and no GL code. A new\nclient category’s `,_jsx(_components.code,{children:`parent`}),` takes the `,_jsx(_components.code,{children:`id`}),` of one of them. A link on a deactivated category still shows in\n`,_jsx(_components.code,{children:`mapped_here`}),`, flagged with `,_jsx(_components.code,{children:`active: false`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Global categories come in this order: the ones the client does not link that its waiting transactions wait\non, then the ones the firm’s enabled global rules use (`,_jsx(_components.code,{children:`used_by_enabled_global_rules`}),` counts those rules), then\nthe other ones it does not link, then the linked ones. At a QuickBooks client, each one the client does not\nlink has `,_jsx(_components.code,{children:`waiting_on_link`}),`: how many of its waiting transactions a global rule matches but cannot file until\nthat link exists (0 included). Each one the client does not link carries a suggested link, `,_jsx(_components.code,{children:`link_suggestion`}),`: a `,_jsx(_components.code,{children:`level`}),` (`,_jsx(_components.code,{children:`a`}),`:\nthe client’s booked transactions decide it; `,_jsx(_components.code,{children:`b`}),`: a best guess from the same name, or from the name the\nfirm’s other clients link it to, with how many clients; `,_jsx(_components.code,{children:`c`}),`: nothing to go on), up to 5 `,_jsx(_components.code,{children:`candidates`}),` and the\nclient’s categories that cannot take the link, `,_jsx(_components.code,{children:`unavailable`}),`. A candidate has its `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`full_name`}),`,\n`,_jsx(_components.code,{children:`account_type`}),` and `,_jsx(_components.code,{children:`level`}),`, and its evidence: `,_jsx(_components.code,{children:`booked_rows`}),` (with up to 3 `,_jsx(_components.code,{children:`examples`}),`), `,_jsx(_components.code,{children:`same_name`}),` (`,_jsx(_components.code,{children:`exact`}),`,\n`,_jsx(_components.code,{children:`leaf`}),` or `,_jsx(_components.code,{children:`contains`}),`) and `,_jsx(_components.code,{children:`firm_clients_linking_same_name`}),`. An unavailable category has a `,_jsx(_components.code,{children:`reason`}),`:\n`,_jsx(_components.code,{children:`linked_elsewhere`}),` (to the global category in `,_jsx(_components.code,{children:`linked_to_firm_category`}),`) or `,_jsx(_components.code,{children:`inactive`}),`. A candidate whose\n`,_jsx(_components.code,{children:`same_name`}),` is `,_jsx(_components.code,{children:`contains`}),` is only an option, unless the client’s booked transactions or the firm’s links at\nits other clients make it the suggestion: the first candidate at level `,_jsx(_components.code,{children:`a`}),` or `,_jsx(_components.code,{children:`b`}),`. This works for Manual\nclients too. A page too long for one answer leaves out the examples first, then all but the first candidate,\ncounting the rest in `,_jsx(_components.code,{children:`more_candidates`}),` and `,_jsx(_components.code,{children:`more_unavailable`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`At a QuickBooks client, a global category nothing else decides a link for (level `,_jsx(_components.code,{children:`c`}),`) can take one from how\nthe client’s QuickBooks booked its expenses and deposits of the last 12 months (lines on bank and credit card\naccounts and the entries LedgerSync pushed itself left out): when the category’s global rules match at least 3\nof them, and at least 8 in 10 were booked to one free category of the client, that one becomes the first\ncandidate at level `,_jsx(_components.code,{children:`a`}),`, with `,_jsx(_components.code,{children:`booked_in_quickbooks`}),` (how many) and examples from those. When another suggestion\nof the page proposes that category, or another level `,_jsx(_components.code,{children:`c`}),` category has more lines on it, it stays level `,_jsx(_components.code,{children:`c`}),` with\nthat category as its first option. As for the client’s booked transactions, a category whose type contradicts\nevery way the rules go (an expense category for money that only comes in) is never offered, and one another\nglobal category holds is listed under `,_jsx(_components.code,{children:`unavailable`}),`.\nA level `,_jsx(_components.code,{children:`b`}),` guess stays first: its candidate carries `,_jsx(_components.code,{children:`booked_in_quickbooks`}),` when QuickBooks agrees, and the\ncategory QuickBooks points to comes next when it does not. The page’s `,_jsx(_components.code,{children:`quickbooks_history`}),` says how that read\nwent: `,_jsx(_components.code,{children:`read`}),`, `,_jsx(_components.code,{children:`reading`}),` (not finished in time: call again shortly), `,_jsx(_components.code,{children:`unavailable`}),` (try later), `,_jsx(_components.code,{children:`broken`}),`\n(reconnect QuickBooks) or `,_jsx(_components.code,{children:`busy`}),` (LedgerSync was reading other clients’ QuickBooks: call again shortly). LedgerSync reads one client at a time, only when a page needs it, and keeps the read\nfor an hour.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_setup_vendors`}),` lists the client’s vendors (`,_jsx(_components.code,{children:`kind: \"client\"`}),`, ids `,_jsx(_components.code,{children:`ven_c_...`}),`) or the firm’s\nglobal vendors (`,_jsx(_components.code,{children:`kind: \"firm\"`}),`, ids `,_jsx(_components.code,{children:`ven_f_...`}),`, with their `,_jsx(_components.code,{children:`aliases`}),`), narrowed by `,_jsx(_components.code,{children:`query`}),`, a page at a\ntime. For a QuickBooks client, `,_jsx(_components.code,{children:`kind: \"client\"`}),` also lists its QuickBooks customers (ids `,_jsx(_components.code,{children:`cus_c_...`}),`), read\nlive from QuickBooks. Each row has a `,_jsx(_components.code,{children:`type`}),`: `,_jsx(_components.code,{children:`vendor`}),` or `,_jsx(_components.code,{children:`customer`}),`. When QuickBooks cannot be read, for\nexample because the connection is broken, the answer says the customers are missing\n(`,_jsx(_components.code,{children:`customers_unavailable: true`}),`). Its `,_jsx(_components.code,{children:`next_step`}),` then says to reconnect QuickBooks only when\n`,_jsx(_components.code,{children:`quickbooks_connection`}),` is broken, and otherwise to list them again in a few minutes.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_rules`}),` lists the client’s rules (`,_jsx(_components.code,{children:`scope: \"client\"`}),`, ids `,_jsx(_components.code,{children:`rul_c_...`}),`) or the firm’s global\nrules (`,_jsx(_components.code,{children:`scope: \"global\"`}),`, ids `,_jsx(_components.code,{children:`rul_g_...`}),`), narrowed by `,_jsx(_components.code,{children:`query`}),`, a page at a time. Each rule has `,_jsx(_components.code,{children:`enabled`}),`,\n`,_jsx(_components.code,{children:`priority`}),`, `,_jsx(_components.code,{children:`direction`}),` (`,_jsx(_components.code,{children:`money_in`}),`, `,_jsx(_components.code,{children:`money_out`}),` or `,_jsx(_components.code,{children:`both`}),`), `,_jsx(_components.code,{children:`match`}),` (`,_jsx(_components.code,{children:`all`}),` or `,_jsx(_components.code,{children:`any`}),`), `,_jsx(_components.code,{children:`rule_type`}),`\n(`,_jsx(_components.code,{children:`inclusion`}),` or `,_jsx(_components.code,{children:`exclusion`}),`), `,_jsx(_components.code,{children:`conditions`}),` (`,_jsx(_components.code,{children:`field`}),`, `,_jsx(_components.code,{children:`operator`}),`, `,_jsx(_components.code,{children:`value`}),`), `,_jsx(_components.code,{children:`category`}),` (`,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`name`}),`,\n`,_jsx(_components.code,{children:`gl_code`}),`), `,_jsx(_components.code,{children:`payee`}),` (`,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`type`}),`) and `,_jsx(_components.code,{children:`ai_generated`}),`. A payee’s `,_jsx(_components.code,{children:`type`}),` is `,_jsx(_components.code,{children:`vendor`}),`, `,_jsx(_components.code,{children:`customer`}),` or\n`,_jsx(_components.code,{children:`employee`}),` (an employee has no `,_jsx(_components.code,{children:`id`}),`).\nA QuickBooks client rule split across several categories shows its first one, and how many more lines it has\n(`,_jsx(_components.code,{children:`more_lines`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`Each category, vendor and rule that a rules setup created or linked carries `,_jsx(_components.code,{children:`ai`}),` (`,_jsx(_components.code,{children:`setup_id`}),`, `,_jsx(_components.code,{children:`reviewed`}),`):\nthe LS-AI mark.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_rule`}),` takes the `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` and a `,_jsx(_components.code,{children:`rule_id`}),` (`,_jsx(_components.code,{children:`rul_c_...`}),` or `,_jsx(_components.code,{children:`rul_g_...`}),`) and shows one rule in\nfull: the `,_jsx(_components.code,{children:`rule`}),` as `,_jsx(_components.code,{children:`ledgersync_list_rules`}),` lists it, its `,_jsx(_components.code,{children:`transaction_type`}),`, a client rule’s categorization\n`,_jsx(_components.code,{children:`lines`}),` (each with its `,_jsx(_components.code,{children:`category`}),`: `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`gl_code`}),` and `,_jsx(_components.code,{children:`full_name`}),` when it differs from the name; its\n`,_jsx(_components.code,{children:`class`}),`, `,_jsx(_components.code,{children:`customer`}),`, `,_jsx(_components.code,{children:`amount`}),` and `,_jsx(_components.code,{children:`allocation_type`}),`: `,_jsx(_components.code,{children:`percentage`}),` or `,_jsx(_components.code,{children:`amount`}),`), and the rules just before and\nafter it in its list (`,_jsx(_components.code,{children:`neighbours`}),`: `,_jsx(_components.code,{children:`before`}),` and `,_jsx(_components.code,{children:`after`}),`, each with `,_jsx(_components.code,{children:`id`}),` and `,_jsx(_components.code,{children:`name`}),`). Its `,_jsx(_components.code,{children:`next_step`}),` says how\nto change the rule and what a rules setup cannot change on it: a rule split over several lines keeps its\ncategory. For a global rule, it says that every change works for it and applies at every client of the firm,\nso the AI tells the user what the preview says happens at the other clients. A change keeps the rule’s\n`,_jsx(_components.code,{children:`rule_type`}),`. A `,_jsx(_components.code,{children:`rule_id`}),` that is not one of the client’s rules, or not one of the firm’s global rules on the\nclient’s platform, answers `,_jsx(_components.code,{children:`not_found`}),`. It changes nothing.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_uncategorized_transactions`}),` lists the client’s waiting transactions that no rule holds and\nnobody categorized (not pending, not excluded, and not on an account hidden in LedgerSync, which the\nLedgerSync app does not show either), grouped by bank text, largest groups first, 50 groups at a\ntime by default (up to 100), between optional `,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),` dates, and only money in or money out when\n`,_jsx(_components.code,{children:`direction`}),` is given. Each group has the bank text (`,_jsx(_components.code,{children:`description`}),`), `,_jsx(_components.code,{children:`count`}),`, `,_jsx(_components.code,{children:`money_in`}),`, `,_jsx(_components.code,{children:`money_out`}),`,\n`,_jsx(_components.code,{children:`total`}),`, `,_jsx(_components.code,{children:`first_date`}),`, `,_jsx(_components.code,{children:`last_date`}),`, `,_jsx(_components.code,{children:`sources`}),`, up to 3 `,_jsx(_components.code,{children:`examples`}),` and, when an existing rule would already\nfill it, `,_jsx(_components.code,{children:`matched_by_rule`}),`. `,_jsx(_components.code,{children:`total_groups`}),` and `,_jsx(_components.code,{children:`total_rows`}),` count everything. At a QuickBooks client, a group\nthat a global rule matches but cannot file, because the client has no category linked to the rule’s global\ncategory, says so in `,_jsx(_components.code,{children:`waiting_on_link`}),` and names that global category (`,_jsx(_components.code,{children:`firm_category_id`}),`,\n`,_jsx(_components.code,{children:`firm_category_name`}),`). It has no `,_jsx(_components.code,{children:`firm_category_id`}),` when the global rule has no global category: no link\nhelps then, only fixing that rule in the LedgerSync app or a new rule.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_preview_rules_setup`}),` takes the `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` and up to 100 `,_jsx(_components.code,{children:`rules`}),`, 50 `,_jsx(_components.code,{children:`firm_categories`}),`, 50\n`,_jsx(_components.code,{children:`client_categories`}),`, 100 `,_jsx(_components.code,{children:`mappings`}),`, 100 `,_jsx(_components.code,{children:`vendors`}),` and 50 `,_jsx(_components.code,{children:`changes`}),` (see below). The AI gives each new rule, category and vendor a\n`,_jsx(_components.code,{children:`ref`}),` (lowercase letters, digits, `,_jsx(_components.code,{children:`_`}),` or `,_jsx(_components.code,{children:`-`}),`, up to 32 characters, unique in the preview). An item points at\nan existing object with `,_jsx(_components.code,{children:`{\"id\": \"...\"}`}),`, or at a new one in the same preview with `,_jsx(_components.code,{children:`{\"ref\": \"...\"}`}),`. An existing\ncategory, vendor or customer of the client goes by the sealed id this client’s lists give. A rule\nhas a `,_jsx(_components.code,{children:`scope`}),` (client or global), a `,_jsx(_components.code,{children:`name`}),`, a `,_jsx(_components.code,{children:`direction`}),`, a `,_jsx(_components.code,{children:`match`}),` (all or any), 1 to 5 `,_jsx(_components.code,{children:`conditions`}),` on\nthe bank text or the amount (an `,_jsx(_components.code,{children:`operator`}),` and a `,_jsx(_components.code,{children:`value`}),`), a `,_jsx(_components.code,{children:`category`}),` and an optional `,_jsx(_components.code,{children:`payee`}),`: a client category and a\nclient vendor (or, at a QuickBooks client, a customer, `,_jsx(_components.code,{children:`cus_c_...`}),`) for a client rule, a global category and\nvendor for a global rule. A rule may also have a `,_jsx(_components.code,{children:`rule_type`}),`: `,_jsx(_components.code,{children:`inclusion`}),` (the default) or `,_jsx(_components.code,{children:`exclusion`}),`. An\nexclusion rule marks the transactions it matches for exclusion instead of filing them: they wait on For review\nand move to Excluded when the user accepts them. It still needs a `,_jsx(_components.code,{children:`category`}),`, and its `,_jsx(_components.code,{children:`payee`}),` is optional. Any\nother `,_jsx(_components.code,{children:`rule_type`}),` is refused with `,_jsx(_components.code,{children:`invalid_request`}),` on `,_jsx(_components.code,{children:`rules[i].rule_type`}),`. A new client category has a\n`,_jsx(_components.code,{children:`ref`}),`, a `,_jsx(_components.code,{children:`name`}),` (its own name, without its parent’s), an `,_jsx(_components.code,{children:`account_type`}),` (required at a QuickBooks client unless\nit has a `,_jsx(_components.code,{children:`parent`}),`, optional at a Manual one), a `,_jsx(_components.code,{children:`gl_code`}),` (Manual clients only) and an optional `,_jsx(_components.code,{children:`firm_category`}),`\nto link it to. At a QuickBooks client it may also have a `,_jsx(_components.code,{children:`parent`}),`, the existing client category it goes under,\nas `,_jsx(_components.code,{children:`{\"id\": \"cat_c_...\"}`}),`, and a `,_jsx(_components.code,{children:`detail_type`}),` (up to 100 characters). A `,_jsx(_components.code,{children:`parent`}),` takes an `,_jsx(_components.code,{children:`id`}),` only: a category\nnew in the same preview cannot be a parent, and anything else there, such as a `,_jsx(_components.code,{children:`ref`}),`, is refused before the\npreview runs. If LedgerSync cannot take a `,_jsx(_components.code,{children:`parent`}),` or `,_jsx(_components.code,{children:`detail_type`}),` just then, the preview is\nrefused with `,_jsx(_components.code,{children:`invalid_request`}),` on that field and stores nothing. A mapping links a firm (global)\ncategory to a client category: up to 100 in one preview, so all of a client’s missing links can go in one. A\nvendor has a `,_jsx(_components.code,{children:`scope`}),` too.`]}),`\n`,_jsxs(_components.li,{children:[`The preview writes nothing. It returns the client’s `,_jsx(_components.code,{children:`platform`}),` (`,_jsx(_components.code,{children:`manual`}),` or `,_jsx(_components.code,{children:`quickbooks`}),`). For each rule it\nreturns whether it is OK or refused, its `,_jsx(_components.code,{children:`rule_type`}),` (`,_jsx(_components.code,{children:`inclusion`}),` or `,_jsx(_components.code,{children:`exclusion`}),`), how many waiting\ntransactions it fills for this client (`,_jsx(_components.code,{children:`fills_here`}),`, with `,_jsx(_components.code,{children:`examples`}),`) and at the firm’s other clients on the\nsame platform, Manual or QuickBooks\n(`,_jsx(_components.code,{children:`fills_other_clients`}),`, at `,_jsx(_components.code,{children:`other_clients`}),` clients), and its `,_jsx(_components.code,{children:`warnings`}),` (`,_jsx(_components.code,{children:`code`}),`, `,_jsx(_components.code,{children:`message`}),`). It also returns\nthe categories, links and vendors it keeps, in `,_jsx(_components.code,{children:`items`}),` (`,_jsx(_components.code,{children:`ref`}),`, `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`name`}),` and `,_jsx(_components.code,{children:`action`}),`: `,_jsx(_components.code,{children:`create`}),`, `,_jsx(_components.code,{children:`link`}),`\nor `,_jsx(_components.code,{children:`reuse`}),`, with `,_jsx(_components.code,{children:`existing_id`}),` for one it reuses, and on a QuickBooks client category the `,_jsx(_components.code,{children:`detail_type`}),` it\ngets, its parent’s when none was given), every refused item with its `,_jsx(_components.code,{children:`name`}),`, code and reason (and,\nfor a name that is taken, `,_jsx(_components.code,{children:`existing_id`}),`: the id of the category, vendor or rule that has it), the totals and,\nwhen at least one item is OK, a `,_jsx(_components.code,{children:`confirmation_id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`For an exclusion rule, `,_jsx(_components.code,{children:`fills_here`}),` and `,_jsx(_components.code,{children:`fills_other_clients`}),` count the transactions it would mark for\nexclusion. The totals count them too: `,_jsx(_components.code,{children:`excluded_by_new_rules`}),` is the part of `,_jsx(_components.code,{children:`filled_by_new_rules`}),`, and\n`,_jsx(_components.code,{children:`excludes_other_clients`}),` the part of `,_jsx(_components.code,{children:`fills_other_clients`}),`, that the new exclusion rules would mark. Each is\nleft out when it is 0. A changed exclusion rule’s marks, the ones it keeps and the ones it fills, count only\nwith its change: in its `,_jsx(_components.code,{children:`changes`}),` entry and in the totals’ `,_jsx(_components.code,{children:`restamped_here`}),` and `,_jsx(_components.code,{children:`filled_by_changed_rules`}),`,\nnever in `,_jsx(_components.code,{children:`excluded_by_new_rules`}),` or `,_jsx(_components.code,{children:`excludes_other_clients`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`At a QuickBooks client, each global rule also says how many of its transactions would wait for a link here\n(`,_jsx(_components.code,{children:`waiting_on_link_here`}),`) and at the firm’s other QuickBooks clients (`,_jsx(_components.code,{children:`waiting_on_link_other_clients`}),`), and how\nmany other clients need a link (`,_jsx(_components.code,{children:`clients_needing_link_count`}),`, named or not). Each is left out when it is 0.\nThose clients are named once for the whole preview, not per rule, in `,_jsx(_components.code,{children:`clients_needing_link`}),`, one entry per\nglobal category: its `,_jsx(_components.code,{children:`firm_category`}),` (the `,_jsx(_components.code,{children:`id`}),`, or the `,_jsx(_components.code,{children:`ref`}),` and `,_jsx(_components.code,{children:`name`}),` of a new one), the `,_jsx(_components.code,{children:`rules`}),` (refs)\nthat need the link, the `,_jsx(_components.code,{children:`changes`}),` (refs of the changes whose global rule needs it once changed: the global\ncategory an edit gives it, or else its own; `,_jsx(_components.code,{children:`rules`}),` or `,_jsx(_components.code,{children:`changes`}),` is left out when empty) and the `,_jsx(_components.code,{children:`clients`}),`\n(`,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),`), only clients the person can see, up to 20 per global category (fewer when the answer is\ntrimmed), the names left out of that list counted in `,_jsx(_components.code,{children:`more_named`}),`. LedgerSync names at most 20 clients per rule\nor change, so a client that no rule or change names (past those 20, or one the person cannot see) is counted\nonly in the rules’ and changes’ `,_jsx(_components.code,{children:`clients_needing_link_count`}),`, not in `,_jsx(_components.code,{children:`more_named`}),`. A link in\n`,_jsx(_components.code,{children:`items`}),` has `,_jsx(_components.code,{children:`fills_here`}),`: how many waiting transactions the firm’s existing global rules would fill here once\nit is saved.\n`,_jsx(_components.code,{children:`summary.create_in_quickbooks`}),` counts the new categories and vendors the client’s QuickBooks would get.`]}),`\n`,_jsx(_components.li,{children:`A rule’s warnings say when it fills nothing here or elsewhere, when some of its transactions go to a stronger\nrule it names (an existing rule, an earlier proposed rule or, for a global rule, any proposed client rule),\nwhen it shares transactions with other proposed rules, when its words\nare found inside longer words, when it fills more than half of the client’s waiting transactions or more\nthan 200 at other clients, when its category has no GL code (Manual clients only), and, for a global rule,\nwhen this client has no category linked to the global category. At a Manual client, the global category’s GL\ncode is then used. At a QuickBooks client, the transactions wait with the “map this category” badge, and a rule\nwhose transactions only wait for a link is not reported as filling nothing. For an exclusion rule, the\nwarning that every transaction it matches goes to another rule, and the warning that it is broad, say what it\nmarks for exclusion instead of what it fills.`}),`\n`,_jsxs(_components.li,{children:[`An item is refused when: it is global and the login lacks the `,_jsx(_components.strong,{children:`Manage Global Rules`}),` permission; a `,_jsx(_components.code,{children:`ref`}),` is\nrepeated or unknown; an `,_jsx(_components.code,{children:`id`}),` is unknown or not the client’s or the firm’s; a name is empty, too long, already\ntaken (a category or vendor whose name is taken comes back with `,_jsx(_components.code,{children:`existing_id`}),`, the id of the one that already\nhas it, so the AI can use it instead; a rule whose name is taken needs another name) or twice in the preview;\na global category is named like a GL code the firm already uses; a GL code is too long; a rule uses the wrong\nkind of category or vendor; a link clashes with an existing one; a condition is invalid, or none of them looks\nfor words; LedgerSync’s rule checks block the rule (the message says why); or it depends on a refused item.\nRefused rules are left out of the counts. At a Manual client, a new category with a `,_jsx(_components.code,{children:`parent`}),` or a\n`,_jsx(_components.code,{children:`detail_type`}),` is refused (`,_jsx(_components.code,{children:`parent_invalid`}),` or `,_jsx(_components.code,{children:`detail_type_invalid`}),`): they are QuickBooks only.`]}),`\n`,_jsxs(_components.li,{children:[`At a QuickBooks client, an item is also refused when: a new name belongs to a deactivated category or vendor,\nto a category of another type or under another category, or to one of the client’s customers (a new\ncategory’s name counts with its parent’s, as its full name); a new category has no QuickBooks account type and\nno `,_jsx(_components.code,{children:`parent`}),` to take one from, or `,_jsx(_components.code,{children:`:`}),` in its name (its parent goes in `,_jsx(_components.code,{children:`parent`}),`); its `,_jsx(_components.code,{children:`parent`}),` is not one of the\nclient’s QuickBooks accounts, is deactivated, has another type than its `,_jsx(_components.code,{children:`account_type`}),`, is on the fifth level,\nor has one of the six detail types above (`,_jsx(_components.code,{children:`parent_invalid`}),`); its `,_jsx(_components.code,{children:`detail_type`}),` is not one LedgerSync knows for\nits account type (or, under a parent, the parent’s own), the message naming a few that are, or is one of\nthose six under a parent (`,_jsx(_components.code,{children:`detail_type_invalid`}),`); a rule or a link uses a deactivated category; a\nclient rule pays a deactivated vendor; a bank text holds `,_jsx(_components.code,{children:`%`}),`, `,_jsx(_components.code,{children:`_`}),` or `,_jsx(_components.code,{children:`\\\\`}),`; a payee is an employee, or a\ncustomer on a global rule; or it needs QuickBooks (a new client category, a new client vendor or a customer\npayee) while QuickBooks cannot be reached (`,_jsx(_components.code,{children:`quickbooks_broken`}),`): the connection is broken, or QuickBooks could\nnot be read just now, and the message says which. The `,_jsx(_components.code,{children:`next_step`}),` says to reconnect QuickBooks only for a\nbroken connection, and otherwise to preview again in a few minutes.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`changes`}),` change rules that exist, one change per rule, next to new items or on their own. Each has a `,_jsx(_components.code,{children:`ref`}),`\n(as for new items), an `,_jsx(_components.code,{children:`action`}),` (`,_jsx(_components.code,{children:`edit`}),`, `,_jsx(_components.code,{children:`turn_off`}),`, `,_jsx(_components.code,{children:`turn_on`}),`, `,_jsx(_components.code,{children:`move`}),` or `,_jsx(_components.code,{children:`delete`}),`) and the rule’s `,_jsx(_components.code,{children:`rule_id`}),`\n(`,_jsx(_components.code,{children:`rul_c_...`}),` or `,_jsx(_components.code,{children:`rul_g_...`}),`, from `,_jsx(_components.code,{children:`ledgersync_list_rules`}),` or `,_jsx(_components.code,{children:`ledgersync_get_rule`}),`). An `,_jsx(_components.code,{children:`edit`}),` gives the parts\nit changes, any of `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`direction`}),`, `,_jsx(_components.code,{children:`match`}),`, `,_jsx(_components.code,{children:`conditions`}),`, `,_jsx(_components.code,{children:`category`}),` and `,_jsx(_components.code,{children:`payee`}),`: a part left out stays as\nit is, `,_jsx(_components.code,{children:`conditions`}),` replace all of the rule’s, and `,_jsx(_components.code,{children:`category`}),` and `,_jsx(_components.code,{children:`payee`}),` take the same ids and refs as a new\nrule of the same scope. A `,_jsx(_components.code,{children:`move`}),` gives a `,_jsx(_components.code,{children:`position`}),`: a `,_jsx(_components.code,{children:`place`}),`, `,_jsx(_components.code,{children:`before`}),` or `,_jsx(_components.code,{children:`after`}),` another rule of the same\nlist (its `,_jsx(_components.code,{children:`rule_id`}),`), or `,_jsx(_components.code,{children:`first`}),` or `,_jsx(_components.code,{children:`last`}),`. Every action works for a global rule too, and a change to a global\nrule applies at every client of the firm on the client’s platform. A change has no `,_jsx(_components.code,{children:`rule_type`}),`: it keeps the\nrule’s type, so an exclusion rule changes like any rule and stays an exclusion rule, and the transactions it\nkeeps or fills are marked for exclusion.`]}),`\n`,_jsxs(_components.li,{children:[`Conditions, in new rules and in edits, look at the bank text (`,_jsx(_components.code,{children:`contains`}),`, `,_jsx(_components.code,{children:`doesnt_contain`}),`, `,_jsx(_components.code,{children:`is_exactly`}),`) or\nat the amount (`,_jsx(_components.code,{children:`equals`}),`, `,_jsx(_components.code,{children:`doesnt_equal`}),`, `,_jsx(_components.code,{children:`is_greater_than`}),`, `,_jsx(_components.code,{children:`is_less_than`}),`). An amount `,_jsx(_components.code,{children:`value`}),` is a plain\namount: up to 9 digits and 2 decimals, with no sign, currency symbol or thousands separator, such as\n`,_jsx(_components.code,{children:`1200.50`}),`. Any other is refused with `,_jsx(_components.code,{children:`invalid_request`}),` before the preview is counted, naming the plain amount\nit meant when there is one (`,_jsx(_components.code,{children:`$1,200.50`}),` is `,_jsx(_components.code,{children:`1200.50`}),`). Amounts are compared without their sign: the rule’s\n`,_jsx(_components.code,{children:`direction`}),` says money in or out. A rule still needs a `,_jsx(_components.code,{children:`contains`}),` or `,_jsx(_components.code,{children:`is_exactly`}),` condition, and amount\nconditions that could never match, or that repeat each other, are refused.`]}),`\n`,_jsxs(_components.li,{children:[`A change is refused when: its rule is not one of the client’s rules, or not one of the firm’s global rules on\nthe client’s platform; the proposal changes the rule twice (`,_jsx(_components.code,{children:`conflicting_changes`}),`); an edit gives a new\ncategory to a rule that splits a transaction over several lines (`,_jsx(_components.code,{children:`split_rule`}),`); it would leave the rule as it\nis, such as turning on a rule that is on (`,_jsx(_components.code,{children:`no_change`}),`); a move’s place is not valid (`,_jsx(_components.code,{children:`move_anchor_invalid`}),`) or\nlies among rules that share a priority (`,_jsx(_components.code,{children:`priority_ties`}),`); some of the global rules between where a global rule\nis and where its move puts it, or just next to them, share a priority (`,_jsx(_components.code,{children:`priority_ties`}),`); a global rule to delete\nshares its priority with another (`,_jsx(_components.code,{children:`priority_ties`}),`); or it is global and the login lacks `,_jsx(_components.strong,{children:`Manage Global Rules`}),`.\nThe order of global rules that share a priority is not certain, so the message of a global `,_jsx(_components.code,{children:`priority_ties`}),`\nsays to make that change in the LedgerSync app, and the `,_jsx(_components.code,{children:`next_step`}),` offers another place for a move. An edit is\nchecked like a new rule (name, conditions, category, payee): a problem it brings in refuses it, and one the rule\nalready had is only a warning. A payee can be set or replaced, never removed.`]}),`\n`,_jsxs(_components.li,{children:[`With `,_jsx(_components.code,{children:`changes`}),`, the preview also answers `,_jsx(_components.code,{children:`changes`}),`, one entry per change, refused ones too: its `,_jsx(_components.code,{children:`ref`}),`,\n`,_jsx(_components.code,{children:`rule_id`}),`, `,_jsx(_components.code,{children:`scope`}),`, `,_jsx(_components.code,{children:`action`}),`, the rule’s `,_jsx(_components.code,{children:`name`}),`, its `,_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`ok`}),`, or `,_jsx(_components.code,{children:`refused`}),` with the `,_jsx(_components.code,{children:`code`}),`; the reason\nis in `,_jsx(_components.code,{children:`refused`}),`), the rule `,_jsx(_components.code,{children:`before`}),` and `,_jsx(_components.code,{children:`after`}),` the change (as `,_jsx(_components.code,{children:`ledgersync_list_rules`}),` shows a rule, with its\n`,_jsx(_components.code,{children:`neighbours`}),`; no `,_jsx(_components.code,{children:`after`}),` for a delete), and what it does to the client’s waiting transactions:\n`,_jsx(_components.code,{children:`released_here`}),` (put back, for the client’s other rules to file again; `,_jsx(_components.code,{children:`taken_by`}),` names those rules, with how\nmany each takes, and `,_jsx(_components.code,{children:`released_waiting`}),` counts the ones left waiting), `,_jsx(_components.code,{children:`restamped_here`}),` (kept by an edited\nrule, stamped again with it), `,_jsx(_components.code,{children:`fills_here`}),` and `,_jsx(_components.code,{children:`kept_for_person_edit`}),` (the rule’s transactions a person\nchanged, left as they are). For a global rule it adds `,_jsx(_components.code,{children:`released_other_clients`}),`, `,_jsx(_components.code,{children:`restamped_other_clients`}),`,\n`,_jsx(_components.code,{children:`fills_other_clients`}),`, `,_jsx(_components.code,{children:`other_clients`}),` and `,_jsx(_components.code,{children:`badges_cleared`}),` (the “map this category” badges a turned-off,\ndeleted or edited rule takes off, at every client), each left out when it is 0. At a QuickBooks client, a\nglobal rule that a change edits or turns on also says how many of the transactions it matches would wait for a\nlink instead, with the badge, here (`,_jsx(_components.code,{children:`waiting_on_link_here`}),`) and at the firm’s other QuickBooks clients\n(`,_jsx(_components.code,{children:`waiting_on_link_other_clients`}),`), and how many other clients need that link (`,_jsx(_components.code,{children:`clients_needing_link_count`}),`), as\na new global rule does. Each is left out when it is 0, and those clients are named in `,_jsx(_components.code,{children:`clients_needing_link`}),`\n(see above). A change also has its `,_jsx(_components.code,{children:`warnings`}),` and `,_jsx(_components.code,{children:`examples`}),` (each with an `,_jsx(_components.code,{children:`effect`}),`: `,_jsx(_components.code,{children:`released`}),`, `,_jsx(_components.code,{children:`restamped`}),` or\n`,_jsx(_components.code,{children:`filled`}),`). `,_jsx(_components.code,{children:`summary.change`}),` counts the kept changes by action, with\n`,_jsx(_components.code,{children:`changes_ok`}),` and `,_jsx(_components.code,{children:`changes_refused`}),`, and the totals add `,_jsx(_components.code,{children:`released_here`}),`, `,_jsx(_components.code,{children:`restamped_here`}),`,\n`,_jsx(_components.code,{children:`filled_by_changed_rules`}),` and `,_jsx(_components.code,{children:`kept_for_person_edit`}),`. If LedgerSync cannot take changes just then, a preview\nwith `,_jsx(_components.code,{children:`changes`}),` is refused with `,_jsx(_components.code,{children:`internal_error`}),` and stores nothing: preview the new items without `,_jsx(_components.code,{children:`changes`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A change touches only the transactions its rule owns: stamped by that rule and no other, still for review\n(not accepted into Categorized), not posted, with the category lines and payee the rule gives. The rule’s\ntransactions still for review and not posted that a person changed, or that carry another rule’s stamp too,\nare counted in `,_jsx(_components.code,{children:`kept_for_person_edit`}),` and left as they are. Ones accepted into Categorized or posted are left\nas they are too, and not counted. A transaction a person moved to Excluded under an exclusion rule’s mark is\nleft as it is too, and not counted. One a person excluded while it carries an inclusion rule’s stamp, by hand\nor with its bank account, is owned, counted and changed like a waiting one: it stays in Excluded, and once put\nback no rule files it again (it counts in `,_jsx(_components.code,{children:`released_waiting`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`The preview’s answer fits in 20,000 characters. When it would not, the preview leaves out the examples\nfirst, then all but 5 of the clients named for each global category (counted in `,_jsx(_components.code,{children:`more_named`}),`), then the\nwarning messages (the codes stay), then the refused items’ messages (the codes stay), then those names\naltogether, then, in the changes other than edits, the parts of the rule `,_jsx(_components.code,{children:`after`}),` the change that stay as\nbefore, then some of the rules, changes, items and refused items (counted in `,_jsx(_components.code,{children:`more_rules`}),`, `,_jsx(_components.code,{children:`more_changes`}),`,\n`,_jsx(_components.code,{children:`more_items`}),` and `,_jsx(_components.code,{children:`more_refused`}),`), and says what it left out. The summary, the totals and each rule’s and\nchange’s counts always cover everything.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_apply_rules_setup`}),` takes the `,_jsx(_components.code,{children:`confirmation_id`}),` with the same `,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),` as the\npreview, and saves what the preview accepted, in the background. It returns a `,_jsx(_components.code,{children:`setup_id`}),` (`,_jsx(_components.code,{children:`rsu_...`}),`) and the status. LedgerSync first checks every item again: an\nitem that is no longer valid fails with its reason, and a category or vendor whose name now exists is used\ninstead of a new one. Then it fills the client’s waiting transactions that no rule holds and nobody\ncategorized, with the same rule order as for new transactions (the client’s rules first, existing ones before\nnew ones). When the setup made global rules, it also fills the waiting transactions at the firm’s other\nclients on the same platform that one of those rules now wins. Calling it again with the same confirmation\nnever applies twice: it returns `,_jsx(_components.code,{children:`existing: true`}),` with the setup’s status now, or with the status it was first\nsent with when LedgerSync cannot read that status at the moment.`]}),`\n`,_jsxs(_components.li,{children:[`With changes, the apply first checks that each rule it changes is still as the preview showed it. If one\nchanged or was deleted since, nothing is saved: the apply is refused with `,_jsx(_components.code,{children:`invalid_request`}),` (“These rules\nchanged since the preview: … Preview again.”). The setup then writes the changes, checking each rule again\nfirst: a change whose rule changed or was deleted meanwhile fails with `,_jsx(_components.code,{children:`rule_changed`}),` or `,_jsx(_components.code,{children:`rule_gone`}),`, and when\nthat is found before anything was written, the whole setup fails and writes nothing. A global move or deletion\nis checked for rules that share a priority again when it is written, and fails with `,_jsx(_components.code,{children:`priority_ties`}),` when some\ndo by then. Then it puts back the transactions a turned-off, deleted or edited rule owns (an edited rule keeps\nthe ones it still matches, stamped again; a QuickBooks global rule only at the clients that link its global\ncategory), and each client’s other rules decide them again at once, as for new transactions; for a changed\nglobal rule, at the firm’s other clients on the same platform too. A QuickBooks global rule turned off, deleted\nor edited also loses its “map this category” badges at every client, and those transactions are decided again\nat once by the rules on file there, an edited rule included: it badges the ones it matches at a client that\nlinks no category to its global category. A changed rule gets an entry in its Rule History in the LedgerSync\napp, not the LS-AI mark (a deleted rule has no page to open its history from). An edited QuickBooks global rule\nalso gets a finished run with 0 categorized transactions on the app’s `,_jsx(_components.strong,{children:`Apply Status`}),` tab, which stops any\napply run the app was still making with the rule as it was. A QuickBooks global rule the app is still applying\n(a run of it still processing on that tab) is deleted only once that run ends: the setup stays running and\ntries again about every 3 minutes, 5 runs in all, and on the last one that deletion fails with `,_jsx(_components.code,{children:`write_failed`}),`\nwhile the rest of the setup is saved, so the setup ends done with some failed items. A Manual global rule never\nwaits.`]}),`\n`,_jsxs(_components.li,{children:[`For a QuickBooks client, the setup first creates the client’s new categories and vendors in its QuickBooks,\nthen saves the links and rules. A sub-account is created under its parent, with its own detail type or else its\nparent’s. At the firm’s other QuickBooks clients that do not link a new global rule’s\ncategory, the transactions it matches get the “map this category” badge. When QuickBooks does not answer or\nthe connection is broken, the setup stays running and tries again every few minutes, 5 runs in all. Then\nwhat still needs QuickBooks fails, with `,_jsx(_components.code,{children:`quickbooks_broken`}),` when the connection is broken or refused, or\n`,_jsx(_components.code,{children:`write_failed`}),` when QuickBooks did not answer, and the setup ends done with some failed items. When QuickBooks\nanswers and refuses a new category or vendor itself (a validation error, or `,_jsx(_components.code,{children:`6190`}),` while the client’s\nQuickBooks subscription has ended or has a billing problem), that item fails at once with `,_jsx(_components.code,{children:`quickbooks_refused`}),`:\nits message says why QuickBooks refused it or, for `,_jsx(_components.code,{children:`6190`}),`, to renew the subscription or fix the billing in\nQuickBooks and run the setup again. A name QuickBooks says is taken, without LedgerSync finding what holds it,\nfails with `,_jsx(_components.code,{children:`name_taken`}),`. What uses a failed item, such as a rule or a link, fails with `,_jsx(_components.code,{children:`depends_on_refused`}),`, the\nrest of the setup is saved, and the `,_jsx(_components.code,{children:`next_step`}),` says it was QuickBooks, not LedgerSync, that refused them.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_rules_setup_status`}),` takes the `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` and the `,_jsx(_components.code,{children:`setup_id`}),` and says where the setup is\n(queued, running, done, done with some failed items, failed, being undone, undone, or undo failed), with its\nphase and progress. A finished setup also gives what it created by type, how many transactions it filled for\nthe client, how many the existing rules filled, how many it filled at other clients and at how many clients,\nand each failed item with its reason. Its `,_jsx(_components.code,{children:`result`}),` also says how many of the filled transactions its new\nexclusion rules marked for exclusion: `,_jsx(_components.code,{children:`excluded_here`}),`, part of `,_jsx(_components.code,{children:`filled_here`}),`, and `,_jsx(_components.code,{children:`excluded_other_clients`}),`, part\nof `,_jsx(_components.code,{children:`filled_other_clients`}),`, each left out when it is 0. It also gives the setup’s `,_jsx(_components.code,{children:`platform`}),`. For a QuickBooks\nclient, its `,_jsx(_components.code,{children:`result`}),` also lists the categories and vendors it created in QuickBooks (`,_jsx(_components.code,{children:`created_in_quickbooks`}),`,\neach with its `,_jsx(_components.code,{children:`type`}),` and `,_jsx(_components.code,{children:`name`}),`), how many transactions the firm’s existing global rules filled through its\nnew links (`,_jsx(_components.code,{children:`filled_through_links`}),`) and how many other clients still need a link (`,_jsx(_components.code,{children:`other_clients_needing_link`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_undo_rules_setup`}),` takes the `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),`, the `,_jsx(_components.code,{children:`setup_id`}),` and an optional `,_jsx(_components.code,{children:`undo_id`}),`. Without an\n`,_jsx(_components.code,{children:`undo_id`}),`, it writes nothing: it says how many rules it would delete, how many waiting transactions it would\nclear and at how many clients, how many links it would put back, and which created items it would delete or\nkeep (in use, or made in QuickBooks). It also says how many of those transactions a person moved to Excluded\nbecause of the setup’s exclusion rules (`,_jsx(_components.code,{children:`excluded_rows_to_restore`}),`, part of `,_jsx(_components.code,{children:`rows_to_reset`}),`, left out when it\nis 0). It returns an `,_jsx(_components.code,{children:`undo_id`}),` that works for 15 minutes, only for the person and the AI app that asked.\nCalled again with that `,_jsx(_components.code,{children:`undo_id`}),`, it undoes the setup: it deletes the setup’s rules and clears only the For\nreview transactions they hold, puts the links back, then deletes the created vendors and categories that\nnothing uses. Categorized transactions are never touched. The transactions a person moved to Excluded because\nof the setup’s exclusion rules go back from Excluded to For review. A setup can be undone once it has stopped:\ndone, done with some failed items, or failed (the undo then removes what it saved before it stopped), and\nagain after a failed undo. While another setup of the firm is running or being undone, the call with the\n`,_jsx(_components.code,{children:`undo_id`}),` is refused with `,_jsx(_components.code,{children:`invalid_request`}),`: try it again when that one finishes.`]}),`\n`,_jsxs(_components.li,{children:[`For a QuickBooks client, the categories and vendors the setup created in QuickBooks are always kept, in\nQuickBooks and in LedgerSync, and the undo names them: nothing is deleted in QuickBooks. The links the setup\nmade, including the link it gave a category it created, are taken back. The For review transactions the\nfirm’s global rules filed through those links, even after the setup, are reset and decided again, so the “map\nthis category” badge comes back where no other rule takes them; the check says how many\n(`,_jsx(_components.code,{children:`link_filled_rows_to_reset`}),`). A kept item’s `,_jsx(_components.code,{children:`reason`}),` is `,_jsx(_components.code,{children:`in_quickbooks`}),` when it was made in QuickBooks, or\n`,_jsx(_components.code,{children:`in_use`}),`. The badges the setup’s global rules left are cleared.`]}),`\n`,_jsxs(_components.li,{children:[`For a setup with changes, the status’s `,_jsx(_components.code,{children:`result.changes`}),` says what they did: how many rules it `,_jsx(_components.code,{children:`edited`}),`,\n`,_jsx(_components.code,{children:`turned_off`}),`, `,_jsx(_components.code,{children:`turned_on`}),`, `,_jsx(_components.code,{children:`moved`}),` and `,_jsx(_components.code,{children:`deleted`}),`, then the transactions the changes `,_jsx(_components.code,{children:`released`}),` (put back for\nthe other rules to decide again) and `,_jsx(_components.code,{children:`restamped`}),`, the ones the changed rules filled (`,_jsx(_components.code,{children:`filled_here`}),` and\n`,_jsx(_components.code,{children:`filled_other_clients`}),`), `,_jsx(_components.code,{children:`badges_cleared`}),` and `,_jsx(_components.code,{children:`kept_for_person_edit`}),`. Each of these counts this client’s and\nthe firm’s other clients’ transactions together, except `,_jsx(_components.code,{children:`filled_here`}),` and `,_jsx(_components.code,{children:`filled_other_clients`}),`. When a\nchanged QuickBooks global rule left transactions waiting for a link with the badge, it adds\n`,_jsx(_components.code,{children:`waiting_on_link_here`}),` and `,_jsx(_components.code,{children:`waiting_on_link_other_clients`}),` (those transactions, here and at the firm’s other\nclients) and `,_jsx(_components.code,{children:`other_clients_needing_link`}),` (those other clients), each left out when it is 0, and the\n`,_jsx(_components.code,{children:`next_step`}),` tells the AI to tell the user, who can link the rule’s global category with a rules setup for that\nclient.\n`,_jsx(_components.code,{children:`other_clients`}),` counts the other clients where the changes put back, stamped again or filled at least one\ntransaction, so it does not say where the fills are. The changed rules’ fills are counted only in\n`,_jsx(_components.code,{children:`result.changes`}),`, never in the result’s own `,_jsx(_components.code,{children:`filled_here`}),`, `,_jsx(_components.code,{children:`filled_by_existing_rules`}),`, `,_jsx(_components.code,{children:`filled_other_clients`}),`,\n`,_jsx(_components.code,{children:`excluded_here`}),` or `,_jsx(_components.code,{children:`excluded_other_clients`}),`: a changed exclusion rule’s fills, and the ones it keeps, are the\ntransactions it marked for exclusion. For such a setup, the undo check adds `,_jsx(_components.code,{children:`restore`}),` (the changes it reverts,\nlatest first: `,_jsx(_components.code,{children:`ref`}),`, `,_jsx(_components.code,{children:`type`}),` `,_jsx(_components.code,{children:`client_rule_change`}),` or `,_jsx(_components.code,{children:`global_rule_change`}),`, `,_jsx(_components.code,{children:`name`}),` and `,_jsx(_components.code,{children:`action`}),`) and\n`,_jsx(_components.code,{children:`rows_to_restore`}),`. The undo puts each changed rule back as it was (a deleted rule comes back with its old id),\nand each transaction the setup wrote back as it was before the setup, only while it still holds what the setup\nleft; the transactions of the rules the setup created go back the same way. For a global rule, that is at every\nclient of the firm. A deleted global rule’s earlier runs on the app’s `,_jsx(_components.strong,{children:`Apply Status`}),` tab are not put back, and\nundoing an edited QuickBooks global rule adds one more finished run there. When the rules around a moved or\ndeleted rule changed since, it goes back as close to its old place as it can, and its `,_jsx(_components.code,{children:`restore`}),` entry then has a\n`,_jsx(_components.code,{children:`placement`}),`: `,_jsx(_components.code,{children:`between_neighbours`}),` (between the same two rules, at another priority number) or, for a deleted\nrule, `,_jsx(_components.code,{children:`before_successor`}),` (just before the rule that came after it), `,_jsx(_components.code,{children:`after_predecessor`}),` (just after the rule\nthat came before it) or `,_jsx(_components.code,{children:`last`}),` (after every other rule of its list). What it leaves is in `,_jsx(_components.code,{children:`keep`}),`, with a\n`,_jsx(_components.code,{children:`reason`}),`: `,_jsx(_components.code,{children:`changed_since`}),` (the rule changed since), `,_jsx(_components.code,{children:`order_changed`}),` (the rules around a moved rule moved),\n`,_jsx(_components.code,{children:`category_gone`}),` (the category it used before was deleted) or `,_jsx(_components.code,{children:`touched_since`}),` (some of its transactions changed\nsince). An undone setup’s `,_jsx(_components.code,{children:`undo`}),` adds `,_jsx(_components.code,{children:`changes_restored`}),`, `,_jsx(_components.code,{children:`rows_restored`}),`, `,_jsx(_components.code,{children:`rows_kept`}),` and\n`,_jsx(_components.code,{children:`restored_elsewhere`}),`, the moved or deleted rules it put back but not exactly where they were (`,_jsx(_components.code,{children:`ref`}),`, `,_jsx(_components.code,{children:`type`}),`,\n`,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`placement`}),`). `,_jsx(_components.code,{children:`more_restore`}),` and `,_jsx(_components.code,{children:`more_restored_elsewhere`}),` count the entries left out to fit one\nanswer. While a later setup that changed the same rules or transactions is still in place, the undo is\nrefused with `,_jsx(_components.code,{children:`invalid_request`}),`, naming that setup: undo it first. Undoing changes to global rules needs\n`,_jsx(_components.strong,{children:`Manage Global Rules`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_preview_category_links`}),` links one global category at every client that lacks it, in one\npreview. It takes the global category’s `,_jsx(_components.code,{children:`firm_category_id`}),` (`,_jsx(_components.code,{children:`cat_f_...`}),`) and covers every client of the firm\non its platform, Manual or QuickBooks, that has no category linked to it. It writes nothing. For each client it\nproposes a category the way `,_jsx(_components.code,{children:`link_suggestion`}),` does: the first candidate at level `,_jsx(_components.code,{children:`a`}),` or `,_jsx(_components.code,{children:`b`}),`, none at level\n`,_jsx(_components.code,{children:`c`}),`. Each client in `,_jsx(_components.code,{children:`clients`}),` has its `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` and `,_jsx(_components.code,{children:`status`}),`: `,_jsx(_components.code,{children:`link`}),` (with the `,_jsx(_components.code,{children:`client_category`}),`\nand its `,_jsx(_components.code,{children:`basis`}),`: `,_jsx(_components.code,{children:`a`}),` or `,_jsx(_components.code,{children:`b`}),` for the level, or `,_jsx(_components.code,{children:`picked`}),` by the user), `,_jsx(_components.code,{children:`ask`}),` (with the options to pick from), `,_jsx(_components.code,{children:`refused`}),` (with\nthe reason) or `,_jsx(_components.code,{children:`skipped`}),`. The ones that need a decision, `,_jsx(_components.code,{children:`refused`}),` and `,_jsx(_components.code,{children:`ask`}),`, come first. At a QuickBooks\nclient, a `,_jsx(_components.code,{children:`link`}),` row’s `,_jsx(_components.code,{children:`fills_here`}),` says how many waiting transactions the firm’s global rules would file once\nit is saved. `,_jsx(_components.code,{children:`totals`}),` counts every client, and `,_jsx(_components.code,{children:`by_account`}),` sums up the links by the client category’s name,\nmost clients first.`]}),`\n`,_jsxs(_components.li,{children:[`It names only the clients the person can see: for an employee, the clients assigned to them. The others are\nonly counted (`,_jsx(_components.code,{children:`not_visible`}),` in `,_jsx(_components.code,{children:`totals`}),`). One preview names up to 1,000 clients, the ones the user changed\nfirst. The rest are counted in `,_jsx(_components.code,{children:`totals`}),`, with a warning, and a new preview covers them once the setup is done.\nWhen the global category’s rules have too many conditions to read every client’s booked transactions in time,\nthe clients not read keep levels `,_jsx(_components.code,{children:`b`}),` and `,_jsx(_components.code,{children:`c`}),` only: `,_jsx(_components.code,{children:`history_not_read`}),` counts them, with a warning.`]}),`\n`,_jsxs(_components.li,{children:[`The answer comes a page at a time, each up to 20,000 characters. Every page has the `,_jsx(_components.code,{children:`totals`}),` and `,_jsx(_components.code,{children:`by_account`}),`,\nand `,_jsx(_components.code,{children:`next_cursor`}),` points to the next one. The next pages come from the stored preview, so they do not count as\npreviews. To change clients, the AI calls the tool again with `,_jsx(_components.code,{children:`overrides`}),` (up to 500, each a `,_jsx(_components.code,{children:`client_id`}),` with\nits `,_jsx(_components.code,{children:`client_name`}),` and the `,_jsx(_components.code,{children:`client_category`}),` to link there, as this preview lists it for that client) and\n`,_jsx(_components.code,{children:`skip_client_ids`}),` with their `,_jsx(_components.code,{children:`skip_client_names`}),` (up to 500). Every client is checked again, with a\nnew `,_jsx(_components.code,{children:`confirmation_id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_apply_rules_setup`}),` takes that `,_jsx(_components.code,{children:`confirmation_id`}),`, with no `,_jsx(_components.code,{children:`client_id`}),` or `,_jsx(_components.code,{children:`client_name`}),`, and starts one setup for all the links, in the\nbackground, with a `,_jsx(_components.code,{children:`setup_id`}),` that starts with `,_jsx(_components.code,{children:`rsl_`}),`. LedgerSync first checks each link again: a client the\nperson no longer sees, one that linked the category since, or an account that can no longer be linked there\nfails with its reason. Then it links the category client by client, each link marked LS-AI. At a QuickBooks\nclient, the firm’s global rules on that category then file the waiting transactions they now win, and take off\ntheir “map this category” badge. Transactions another rule holds, or that a person categorized, stay as they\nare. A client that fails does not stop the others. While the setup runs, the firm’s other setups wait.\nCalling it again with the same `,_jsx(_components.code,{children:`confirmation_id`}),` never links twice: it returns `,_jsx(_components.code,{children:`existing: true`}),` with the\nsetup’s status now, or with the status it was first sent with when LedgerSync cannot read that status at the\nmoment.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_rules_setup_status`}),` and `,_jsx(_components.code,{children:`ledgersync_undo_rules_setup`}),` take an `,_jsx(_components.code,{children:`rsl_`}),` `,_jsx(_components.code,{children:`setup_id`}),` without a\n`,_jsx(_components.code,{children:`client_id`}),`. The status counts the clients done (`,_jsx(_components.code,{children:`clients_done`}),` of `,_jsx(_components.code,{children:`clients_total`}),`), and its `,_jsx(_components.code,{children:`firm_links`}),` block\ncounts the links made (`,_jsx(_components.code,{children:`linked`}),`) and the transactions filed through them (`,_jsx(_components.code,{children:`filled_through_links`}),`), and lists\nthe clients whose link failed, with the reason (`,_jsx(_components.code,{children:`failed_clients`}),`, each with its `,_jsx(_components.code,{children:`client_id`}),` and\n`,_jsx(_components.code,{children:`client_name`}),`). The undo takes back every link of the setup\nstill in place, so it needs a person who sees every client it linked at. At a QuickBooks client, the transactions filed through the link go back to waiting, with\nthe badge where no other rule takes them. A link a person changed since stays. Links need no\n`,_jsx(_components.strong,{children:`Manage Global Rules`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A rules setup apply or undo that got no clear answer from LedgerSync comes back as `,_jsx(_components.code,{children:`upstream_unknown`}),`,\nnaming the setup: check `,_jsx(_components.code,{children:`ledgersync_get_rules_setup_status`}),` before trying again.`]}),`\n`,_jsxs(_components.li,{children:[`The instructions on `,_jsx(_components.a,{href:`/ai/rules-setup`,children:`Set up rules for a client`}),` are also an MCP prompt, `,_jsx(_components.code,{children:`rules_setup`}),`\n(“Set up rules for a client”), with optional `,_jsx(_components.code,{children:`client`}),` and `,_jsx(_components.code,{children:`focus`}),` arguments. Claude Code lists it as a\ncommand.`]}),`\n`,_jsxs(_components.li,{children:[`Categorized export gives a firm’s Manual clients’ categorized transactions that are not exported yet (the\nLedgerSync app’s `,_jsx(_components.strong,{children:`Categorized`}),` list with `,_jsx(_components.strong,{children:`Not Synced`}),`) as a file: the one the app’s\n`,_jsx(_components.strong,{children:`Export Transactions`}),` makes, Default or ACS. Claude’s own scheduled tasks call it (ChatGPT’s are not\nconfirmed yet); LedgerSync stores no schedule. See\n`,_jsx(_components.a,{href:`/ai/categorized-export`,children:`Export categorized transactions on a schedule`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_categorized_export_link`}),` takes a `,_jsx(_components.code,{children:`format`}),`, `,_jsx(_components.code,{children:`default_csv`}),` (the app’s Default export, a CSV\nfile) or `,_jsx(_components.code,{children:`acs_xlsx`}),` (its ACS export, an Accounting CS Excel file), and an optional `,_jsx(_components.code,{children:`client_id`}),` with its\n`,_jsx(_components.code,{children:`client_name`}),`. Without one,\nit covers every Manual client the person manages (an employee, the clients assigned to them). Clients with a\nQuickBooks, Zoho Books or other accounting connection are left out and counted in `,_jsx(_components.code,{children:`clients_left_out`}),`. A\nnamed client with one is refused with `,_jsx(_components.code,{children:`invalid_request`}),` and a `,_jsx(_components.code,{children:`next_step`}),`, and so is a login that manages\nno Manual client.`]}),`\n`,_jsxs(_components.li,{children:[`It returns `,_jsx(_components.code,{children:`ready_transactions`}),`, `,_jsx(_components.code,{children:`manual_clients`}),`, `,_jsx(_components.code,{children:`clients_left_out`}),` and, when at least one transaction is\nready, `,_jsx(_components.code,{children:`download_url`}),` and `,_jsx(_components.code,{children:`expires_at`}),`. Its `,_jsx(_components.code,{children:`next_step`}),` tells the AI to hand over the link without opening\nit. With nothing waiting there is no link. With more than 10,000 waiting the tool refuses, and its\n`,_jsx(_components.code,{children:`next_step`}),` says to export once in the app or to name one client.`]}),`\n`,_jsxs(_components.li,{children:[`The call changes nothing, so the tool is annotated read-only, and a scheduled task with approval set to Auto\nruns it without asking. It still needs `,_jsx(_components.code,{children:`write:accounting`}),`, because the link’s `,_jsx(_components.strong,{children:`Download`}),` marks the\ntransactions: a read-only connection gets `,_jsx(_components.code,{children:`insufficient_scope`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The link works for 24 hours. Opening it shows a LedgerSync page and changes nothing; its `,_jsx(_components.strong,{children:`Download`}),` button\nsends a POST. The first press checks the connection again, takes the transactions waiting at that moment,\nbuilds the file with the app’s own export code and file name, and marks them Synced, with the same mark as\nthe app’s Manual export. Later presses within 24 hours return the same transactions under the same file\nname and mark nothing new. Nothing spends the link.`]}),`\n`,_jsx(_components.li,{children:`If marking fails, the file is still returned, the transactions stay Not Synced, and the next press on that\nlink tries again. An export from the app marks the same transactions, so the next link leaves them out.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_1099_summary`}),` lists the vendors a QuickBooks Online client paid at or over the 1099-NEC\nthreshold in a tax year: 600.00 for 2025 and 2,000.00 for 2026 by default; for another year, pass\n`,_jsx(_components.code,{children:`threshold`}),`. `,_jsx(_components.code,{children:`tax_year`}),` defaults to the year that just ended until February 15, then the current year. It\ncounts expenses and checks to a vendor and bill payments, by payment date. Payments by card or through a\npayment app (PayPal, Venmo, Square, Stripe, Cash App) are left out by default, since they go on a 1099-K;\n`,_jsx(_components.code,{children:`exclude_card_payments: false`}),` keeps them in.`]}),`\n`,_jsxs(_components.li,{children:[`Each vendor comes with `,_jsx(_components.code,{children:`total_paid`}),`, `,_jsx(_components.code,{children:`card_and_app_paid`}),` and `,_jsx(_components.code,{children:`reportable`}),` (money as text with two decimals),\n`,_jsx(_components.code,{children:`qbo_1099_flag`}),`, `,_jsx(_components.code,{children:`has_tin`}),` and `,_jsx(_components.code,{children:`has_email`}),` (true or false only: a tax ID never reaches the AI),\n`,_jsx(_components.code,{children:`w9_status`}),` (“not tracked yet” on live; on the sandbox connector, the vendor’s W-9 request, below), a\n`,_jsx(_components.code,{children:`suggested_action`}),` (`,_jsx(_components.code,{children:`mark_for_1099`}),`, `,_jsx(_components.code,{children:`get_tax_id`}),`, `,_jsx(_components.code,{children:`review`}),` or `,_jsx(_components.code,{children:`ok`}),`) and\nits `,_jsx(_components.code,{children:`evidence`}),`, plus `,_jsx(_components.code,{children:`advice`}),` and `,_jsx(_components.code,{children:`advice_reason`}),` (below). The answer also has the counts,\n`,_jsx(_components.code,{children:`total_reportable`}),`, `,_jsx(_components.code,{children:`excluded_card_and_app_total`}),` and `,_jsx(_components.code,{children:`data_as_of`}),`, when the payments were read; the vendors\ncome a page at a time (`,_jsx(_components.code,{children:`limit`}),`, 15 by default and at most 100, and `,_jsx(_components.code,{children:`cursor`}),`). Every answer stays under 15,000\ncharacters: a page cut to fit says so with `,_jsx(_components.code,{children:`truncated`}),` and the `,_jsx(_components.code,{children:`limit`}),` to call again with.`]}),`\n`,_jsxs(_components.li,{children:[`LedgerSync reads a year’s payments from QuickBooks once and keeps them for the rest of the day; each vendor’s\nflags are read again on every call. A large client’s first call can answer `,_jsx(_components.code,{children:`status: running`}),`: call it again\nwith the same arguments in about 30 seconds. `,_jsx(_components.code,{children:`refresh: true`}),` reads the payments again, unless today’s read\nis under 5 minutes old.`]}),`\n`,_jsxs(_components.li,{children:[`Each vendor’s `,_jsx(_components.code,{children:`advice`}),` comes from the expense accounts its payments were booked to (for a bill payment, the\naccounts on the bills it paid). An account leans by its name first, then its QuickBooks detail type, then its\naccount type: services and legal fees toward a 1099-NEC, rent toward a 1099-MISC, goods, travel, utilities,\nwages, taxes and the like away, and repairs, advertising and catch-all accounts in question. Goods, travel or\nreimbursements on a payment or bill that also has a services or legal fees line (a line toward a 1099-NEC)\ncount as in question, since parts supplied with the work count. The advice is `,_jsx(_components.code,{children:`points_to_1099`}),` when the\n1099-NEC part or the 1099-MISC part alone reaches the threshold, `,_jsx(_components.code,{children:`ask`}),` when one of them reaches it only with\nthe part in question or the two reach it only together, and `,_jsx(_components.code,{children:`points_away`}),` otherwise. `,_jsx(_components.code,{children:`advice_reason`}),` (at most\n200 characters) names up to two accounts with their amounts, and `,_jsx(_components.code,{children:`counts.advice`}),` counts `,_jsx(_components.code,{children:`points_to_1099`}),`,\n`,_jsx(_components.code,{children:`points_away`}),` and `,_jsx(_components.code,{children:`ask`}),`. A vendor is listed when its total reaches the threshold, or when one form’s part\nalone does.`]}),`\n`,_jsxs(_components.li,{children:[`The first page carries `,_jsx(_components.code,{children:`expense_accounts`}),`: up to 10 accounts the vendors at or over the threshold were paid\nthrough, the largest first, each with `,_jsx(_components.code,{children:`account_id`}),` (absent for a part that is not an account, such as a bill\npayment not applied to a bill), `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`lean`}),` (`,_jsx(_components.code,{children:`1099`}),`, `,_jsx(_components.code,{children:`no_1099`}),` or `,_jsx(_components.code,{children:`ask`}),`), `,_jsx(_components.code,{children:`form`}),` (`,_jsx(_components.code,{children:`1099-NEC`}),` or\n`,_jsx(_components.code,{children:`1099-MISC`}),`, only when `,_jsx(_components.code,{children:`lean`}),` is `,_jsx(_components.code,{children:`1099`}),`), `,_jsx(_components.code,{children:`why`}),`, `,_jsx(_components.code,{children:`reportable`}),` and `,_jsx(_components.code,{children:`vendors`}),`; `,_jsx(_components.code,{children:`expense_accounts_more`}),` says how\nmany more there are. The form is suggested from the account’s name: QuickBooks does not share its own 1099\nsetup’s mapping of accounts to boxes through its API.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`count_only_account_ids`}),` (1 to 100 QuickBooks account ids, digits only, from `,_jsx(_components.code,{children:`expense_accounts`}),` or\n`,_jsx(_components.code,{children:`ledgersync_list_quickbooks_categories`}),`) counts only payments booked to those accounts and the accounts under\nthem, the way QuickBooks’ own 1099 setup counts its mapped accounts. The chosen accounts are then the 1099\npart: one that leans rent counts toward a 1099-MISC, any other toward a 1099-NEC. The answer adds\n`,_jsx(_components.code,{children:`counted_account_ids`}),` (the ids applied), `,_jsx(_components.code,{children:`unknown_account_ids`}),` (ids the client’s QuickBooks does not have),\n`,_jsx(_components.code,{children:`left_out_by_choice`}),` (what the vendors listed without the choice were paid through other accounts),\n`,_jsx(_components.code,{children:`dropped_by_choice`}),` (how many of them drop off) and, on `,_jsx(_components.code,{children:`expense_accounts`}),`, `,_jsx(_components.code,{children:`counted`}),`. A choice naming none of\nthe client’s accounts answers `,_jsx(_components.code,{children:`invalid_request`}),` on `,_jsx(_components.code,{children:`count_only_account_ids`}),`. Nothing is saved: the AI asks\nagain next time. A cursor works only with the choice it came from.`]}),`\n`,_jsxs(_components.li,{children:[`Marking vendors for 1099 takes three steps and a yes. `,_jsx(_components.code,{children:`ledgersync_preview_ledger_changes`}),` takes `,_jsx(_components.code,{children:`client_id`}),`,\n`,_jsx(_components.code,{children:`client_name`}),` and `,_jsx(_components.code,{children:`changes`}),`: 1 to 100 of `,_jsx(_components.code,{children:`type`}),` `,_jsx(_components.code,{children:`update_vendor`}),`, a `,_jsx(_components.code,{children:`vendor_id`}),` from `,_jsx(_components.code,{children:`ledgersync_get_1099_summary`}),`\n(sealed: as that list gave it for this client) and\n`,_jsx(_components.code,{children:`is_1099`}),` (`,_jsx(_components.code,{children:`true`}),` to mark, `,_jsx(_components.code,{children:`false`}),` to unmark). It reads each vendor from QuickBooks and answers `,_jsx(_components.code,{children:`changes`}),`\n(each vendor’s `,_jsx(_components.code,{children:`qbo_1099_flag_before`}),` and `,_jsx(_components.code,{children:`qbo_1099_flag_after`}),`), `,_jsx(_components.code,{children:`refused`}),` (with a `,_jsx(_components.code,{children:`reason`}),`: `,_jsx(_components.code,{children:`not_found`}),`,\n`,_jsx(_components.code,{children:`inactive`}),`, `,_jsx(_components.code,{children:`already_marked`}),`, `,_jsx(_components.code,{children:`already_unmarked`}),` or `,_jsx(_components.code,{children:`duplicate`}),`), `,_jsx(_components.code,{children:`to_mark`}),`, `,_jsx(_components.code,{children:`to_unmark`}),`, `,_jsx(_components.code,{children:`data_as_of`}),` and\na `,_jsx(_components.code,{children:`confirmation_id`}),` that works for 30 minutes. It changes nothing, so it is annotated read-only; it needs\n`,_jsx(_components.code,{children:`write:accounting`}),`. QuickBooks refuses any change to an inactive vendor, so make it active there first.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_apply_ledger_changes`}),` takes the `,_jsx(_components.code,{children:`confirmation_id`}),` with the same `,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),` as\nthe preview, after the user’s yes, and answers a\n`,_jsx(_components.code,{children:`change_set_id`}),` (`,_jsx(_components.code,{children:`lcs_...`}),`). LedgerSync marks the vendors one at a time in the background and sends QuickBooks\nonly each vendor’s 1099 flag: nothing else on the vendor changes, and a tax ID is never read or written. A\nvendor someone changed in QuickBooks since the preview is left as it is (`,_jsx(_components.code,{children:`changed_since_preview`}),`). Calling it\nagain with the same `,_jsx(_components.code,{children:`confirmation_id`}),` never marks twice: it returns `,_jsx(_components.code,{children:`existing: true`}),` with the change set’s\nstatus now, or with the status it was first sent with when LedgerSync cannot read that status at the moment.\nAn apply that got no clear answer comes back as\n`,_jsx(_components.code,{children:`upstream_unknown`}),`: check `,_jsx(_components.code,{children:`ledgersync_get_ledger_changes_status`}),` before trying again.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_ledger_changes_status`}),` takes `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` and `,_jsx(_components.code,{children:`change_set_id`}),`. It answers `,_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`queued`}),`,\n`,_jsx(_components.code,{children:`running`}),`, `,_jsx(_components.code,{children:`done`}),`, `,_jsx(_components.code,{children:`partial`}),`, `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`undoing`}),`, `,_jsx(_components.code,{children:`undone`}),` or `,_jsx(_components.code,{children:`undo_failed`}),`), the counts, the AI app the\nchanges were approved from (`,_jsx(_components.code,{children:`app`}),`) and, a page at a time, each vendor’s flag before and after with its\n`,_jsx(_components.code,{children:`result`}),` and `,_jsx(_components.code,{children:`reason`}),`, and after an undo its `,_jsx(_components.code,{children:`undo`}),` and `,_jsx(_components.code,{children:`undo_reason`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_undo_ledger_changes`}),` takes the `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`client_name`}),` and `,_jsx(_components.code,{children:`change_set_id`}),`, in two calls. The\nfirst, without `,_jsx(_components.code,{children:`undo_id`}),`, changes nothing: it lists the\nvendors whose flag goes back (`,_jsx(_components.code,{children:`revert`}),`) and the ones left as they are (`,_jsx(_components.code,{children:`keep`}),`, with the reason: changed in\nQuickBooks since, inactive, no longer in QuickBooks, or already back), with an `,_jsx(_components.code,{children:`undo_id`}),` that works for 15\nminutes. The second, with that `,_jsx(_components.code,{children:`undo_id`}),`, starts the undo. Only vendors nobody changed in QuickBooks since\ngo back. An undo that could not put a vendor back (`,_jsx(_components.code,{children:`undo_failed`}),`) can be run again.`]}),`\n`,_jsxs(_components.li,{children:[`Marking vendors for 1099 is open to every firm. On the sandbox connector it is still limited to test firms:\nevery firm sees the tools, and for any other firm there, the preview and the apply answer\n`,_jsx(_components.code,{children:`access_not_active`}),` while the 1099 list still works. The status and the undo work for any change a firm made. LedgerSync keeps who approved each change\nand from which AI app.`]}),`\n`,_jsxs(_components.li,{children:[`Every ready answer of `,_jsx(_components.code,{children:`ledgersync_get_1099_summary`}),`, an empty list too, ends its `,_jsx(_components.code,{children:`next_step`}),` with what the\nlist does not cover (royalties, gross proceeds paid to attorneys, medical and health care payments, and which\n1099 form and box each payment goes in) and says the firm files its 1099s through its own 1099 service, before\nthe offers. With the advice, it first asks about the `,_jsx(_components.code,{children:`ask`}),` vendors and points out marked vendors that point\naway, and its marking offer (or, where marking is not open, its pointer to QuickBooks’ own 1099 tracking)\ncounts only the vendors not marked that point to a 1099. On the first page, when some vendors are in question\nor point away, it then offers `,_jsx(_components.code,{children:`count_only_account_ids`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The instructions on `,_jsx(_components.a,{href:`/ai/1099-vendors`,children:`Find who needs a 1099`}),` are also an MCP prompt, `,_jsx(_components.code,{children:`form_1099_season`}),`\n(“Find who needs a 1099”), with optional `,_jsx(_components.code,{children:`client`}),` and `,_jsx(_components.code,{children:`tax_year`}),` arguments. Claude Code lists it as a\ncommand. The connector’s instructions also tell the AI to preview 1099 marks first and apply them only after\nthe user’s yes.`]}),`\n`,_jsxs(_components.li,{children:[`W-9 requests are on the sandbox connector only for now, for test firms: every other firm there gets\n`,_jsx(_components.code,{children:`access_not_active`}),` from the preview and the send. `,_jsx(_components.code,{children:`ledgersync_preview_w9_requests`}),` takes `,_jsx(_components.code,{children:`client_id`}),`,\n`,_jsx(_components.code,{children:`client_name`}),`, `,_jsx(_components.code,{children:`vendors`}),` (1 to 50, each a `,_jsx(_components.code,{children:`vendor_id`}),` from `,_jsx(_components.code,{children:`ledgersync_get_1099_summary`}),` or\n`,_jsx(_components.code,{children:`ledgersync_list_w9_requests`}),`, with an optional `,_jsx(_components.code,{children:`action`}),`: `,_jsx(_components.code,{children:`send`}),`, `,_jsx(_components.code,{children:`remind`}),`, `,_jsx(_components.code,{children:`correct_address`}),`, `,_jsx(_components.code,{children:`request_again`}),`\nor `,_jsx(_components.code,{children:`cancel`}),`; an optional `,_jsx(_components.code,{children:`email`}),`; and, to ask again, a `,_jsx(_components.code,{children:`reason`}),` the vendor reads), an optional `,_jsx(_components.code,{children:`note`}),` and an\noptional `,_jsx(_components.code,{children:`save_to_quickbooks`}),` (below), which the answer repeats when a vendor will be emailed. It\nreads each vendor from QuickBooks and answers each vendor’s `,_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`will_email`}),`, `,_jsx(_components.code,{children:`will_cancel`}),` or `,_jsx(_components.code,{children:`skipped`}),`\nwith its `,_jsx(_components.code,{children:`skip_reason`}),`), the address each email goes to, the emails as the vendor reads them (the link shown as\n`,_jsx(_components.code,{children:`[secure link]`}),`), `,_jsx(_components.code,{children:`to_email`}),`, `,_jsx(_components.code,{children:`to_cancel`}),`, `,_jsx(_components.code,{children:`skipped`}),`, `,_jsx(_components.code,{children:`data_as_of`}),` and a `,_jsx(_components.code,{children:`confirmation_id`}),` that works for 30\nminutes. A preview too long for one answer shows the first vendors that fit and lists the others in\n`,_jsx(_components.code,{children:`not_shown_vendor_ids`}),`: they are not in its confirmation, so preview them after the send, with the same\nchoices and note. It changes nothing and needs `,_jsx(_components.code,{children:`write:accounting`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_send_w9_requests`}),` takes the `,_jsx(_components.code,{children:`confirmation_id`}),` with the same `,_jsx(_components.code,{children:`client_id`}),` and `,_jsx(_components.code,{children:`client_name`}),`, after the\nuser’s yes. LedgerSync emails each vendor from its own address as “(firm) via LedgerSync”, replies reach the\nperson who sent it, and each email carries the vendor’s own link, which works for 30 days. One call sends for up\nto about 25 seconds, 10 vendors at a time, and answers `,_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`in_progress`}),`, `,_jsx(_components.code,{children:`done`}),`, `,_jsx(_components.code,{children:`limit_reached`}),` or\n`,_jsx(_components.code,{children:`stopped_unknown`}),`), the running totals and this call’s results; while it is `,_jsx(_components.code,{children:`in_progress`}),`, call it again with\nthe same arguments. When QuickBooks does not answer, nothing is sent for those vendors and the same\nconfirmation works again a few minutes later. No vendor gets the same request twice from one confirmation. A\nfirm sends up to 300 W-9 emails a day on live and 100 on sandbox, first emails and reminders together, counted\nfrom midnight UTC; a cancel emails nobody and is never counted.`]}),`\n`,_jsxs(_components.li,{children:[`The vendor fills in the form on a secure LedgerSync page, one step at a time in the official form’s words, and\nsigns by typing their name. The tax ID is stored encrypted and never reaches the AI.\n`,_jsx(_components.code,{children:`ledgersync_list_w9_requests`}),` lists each vendor’s latest request, or every request with `,_jsx(_components.code,{children:`include_history`}),`, with\nits `,_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`sent`}),`, `,_jsx(_components.code,{children:`opened`}),`, `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`expired`}),`, `,_jsx(_components.code,{children:`cancelled`}),`, `,_jsx(_components.code,{children:`superseded`}),` or `,_jsx(_components.code,{children:`failed`}),`; `,_jsx(_components.code,{children:`open`}),` means sent\nor opened), its dates, `,_jsx(_components.code,{children:`reminder_count`}),` and `,_jsx(_components.code,{children:`tax_id_received`}),`, never the tax ID itself.`]}),`\n`,_jsxs(_components.li,{children:[`With `,_jsx(_components.code,{children:`save_to_quickbooks`}),` on the preview, LedgerSync also saves each W-9 to QuickBooks shortly after the vendor\nsigns: it marks the vendor for 1099 and saves their tax ID, unless QuickBooks has a different tax ID for them,\nwhich it leaves as it is (a W-9 asked again replaces the tax ID of the W-9 it replaced). It is off when left\nout, and open only to firms that may mark vendors for 1099 from an AI app; any other firm gets\n`,_jsx(_components.code,{children:`access_not_active`}),` and can preview without it. A reminder keeps the choice its request was first sent with.\n`,_jsx(_components.code,{children:`ledgersync_list_w9_requests`}),` then shows `,_jsx(_components.code,{children:`save_to_quickbooks`}),` and `,_jsx(_components.code,{children:`quickbooks_save`}),`: its `,_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`waiting`}),`\nfor the vendor, `,_jsx(_components.code,{children:`saving`}),`, `,_jsx(_components.code,{children:`saved`}),`, `,_jsx(_components.code,{children:`marked_only`}),` when QuickBooks kept a different tax ID, `,_jsx(_components.code,{children:`not_saved`}),` with the\nreason in `,_jsx(_components.code,{children:`message`}),`, or `,_jsx(_components.code,{children:`undone`}),`) and its `,_jsx(_components.code,{children:`change_set_id`}),`, which `,_jsx(_components.code,{children:`ledgersync_get_ledger_changes_status`}),` and\n`,_jsx(_components.code,{children:`ledgersync_undo_ledger_changes`}),` take. The undo puts back the 1099 mark only; QuickBooks keeps the tax ID. The\ntax ID goes from the encrypted W-9 to QuickBooks and never through the AI.`]}),`\n`,_jsxs(_components.li,{children:[`On the sandbox connector, `,_jsx(_components.code,{children:`ledgersync_get_1099_summary`}),` shows each vendor’s W-9 request: `,_jsx(_components.code,{children:`w9_status`}),` is the\nstatus `,_jsx(_components.code,{children:`ledgersync_list_w9_requests`}),` shows for that vendor by default (`,_jsx(_components.code,{children:`sent`}),`, `,_jsx(_components.code,{children:`opened`}),`, `,_jsx(_components.code,{children:`completed`}),`,\n`,_jsx(_components.code,{children:`expired`}),`, `,_jsx(_components.code,{children:`cancelled`}),` or `,_jsx(_components.code,{children:`failed`}),`), or `,_jsx(_components.code,{children:`not requested`}),` for a vendor never asked, with `,_jsx(_components.code,{children:`w9_completed_at`}),` once\nit is completed. `,_jsx(_components.code,{children:`counts.w9_requests`}),` has `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`open`}),` (sent or opened) and `,_jsx(_components.code,{children:`needed`}),` (no tax ID on file\nand no request open or completed). Its `,_jsx(_components.code,{children:`next_step`}),` offers W-9 requests to the `,_jsx(_components.code,{children:`needed`}),` vendors (pointing to the\npreview, for a firm W-9 requests are open to), points to the open ones and offers the completed W-9s. Step 6 of\n`,_jsx(_components.code,{children:`form_1099_season`}),` there offers the W-9 requests too, and `,_jsx(_components.code,{children:`ledgersync_get_client_snapshot`}),` returns\n`,_jsx(_components.code,{children:`open_w9_requests`}),`. On live, `,_jsx(_components.code,{children:`w9_status`}),` stays “not tracked yet” until W-9 requests open there.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_get_w9_download_link`}),` takes a `,_jsx(_components.code,{children:`request_id`}),` (`,_jsx(_components.code,{children:`w9r_...`}),`) whose status is `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`superseded`}),`\nand gives a link that works once, within 10 minutes. It opens a page with a `,_jsx(_components.strong,{children:`Download`}),` button. The PDF is the\nofficial IRS Form W-9 with the vendor’s entries and typed signature, and it never passes through the chat.`]}),`\n`,_jsxs(_components.li,{children:[`Accepting For review transactions moves a Manual or QuickBooks Online client’s transactions in the Rules\nEngine from For review to Categorized, as the LedgerSync app’s `,_jsx(_components.strong,{children:`Accept`}),` does, after the user approves a\npreview. A transaction an exclusion rule filed moves to Excluded instead. Nothing is posted to QuickBooks: a\nQuickBooks client’s Categorized transactions are synced in the app, and a Manual client’s go in its next export\n(`,_jsx(_components.code,{children:`ledgersync_get_categorized_export_link`}),`). See `,_jsx(_components.a,{href:`/ai/accept-transactions`,children:`Accept For review transactions`}),`.\nTransactions on LedgerSync’s own bank connection (`,_jsx(_components.code,{children:`txn_FDE_...`}),`) are left out: LedgerSync cannot accept them.\nFor a client on another accounting app, such as Zoho Books, the tools answer `,_jsx(_components.code,{children:`invalid_request`}),` with a\n`,_jsx(_components.code,{children:`next_step`}),` to accept in the app; the preview gives it as that client’s `,_jsx(_components.code,{children:`error`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_list_review_transactions`}),` takes a `,_jsx(_components.code,{children:`client_id`}),` with its `,_jsx(_components.code,{children:`client_name`}),`, `,_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`for_review`}),`, the default, or\n`,_jsx(_components.code,{children:`categorized`}),`) and, optionally, `,_jsx(_components.code,{children:`rule_id`}),` (only the transactions that rule filed: `,_jsx(_components.code,{children:`rul_c_...`}),` or `,_jsx(_components.code,{children:`rul_g_...`}),`,\nfrom `,_jsx(_components.code,{children:`ledgersync_list_rules`}),`), `,_jsx(_components.code,{children:`rule_type`}),` (`,_jsx(_components.code,{children:`inclusion`}),` or `,_jsx(_components.code,{children:`exclusion`}),`), `,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),` (posted dates),\n`,_jsx(_components.code,{children:`limit`}),` (50 by default, up to 200) and `,_jsx(_components.code,{children:`cursor`}),`. It lists the transactions as the app’s Rules Engine shows\nthem, each with `,_jsx(_components.code,{children:`transaction_id`}),` (`,_jsx(_components.code,{children:`txn_\u003cSOURCE>_...`}),`), `,_jsx(_components.code,{children:`account_id`}),`, `,_jsx(_components.code,{children:`account_name`}),`, `,_jsx(_components.code,{children:`date`}),` (the posted date),\n`,_jsx(_components.code,{children:`amount`}),` (signed as the app shows it), `,_jsx(_components.code,{children:`description`}),` and `,_jsx(_components.code,{children:`bank_payee`}),` (the bank’s text), `,_jsx(_components.code,{children:`category`}),` and\n`,_jsx(_components.code,{children:`split_categories`}),` (each a `,_jsx(_components.code,{children:`name`}),` and `,_jsx(_components.code,{children:`gl_code`}),`, with no id), `,_jsx(_components.code,{children:`payee`}),` (`,_jsx(_components.code,{children:`name`}),`, and `,_jsx(_components.code,{children:`type`}),`: `,_jsx(_components.code,{children:`vendor`}),`,\n`,_jsx(_components.code,{children:`customer`}),` or `,_jsx(_components.code,{children:`employee`}),`), `,_jsx(_components.code,{children:`rule`}),` (`,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`scope`}),`: `,_jsx(_components.code,{children:`client`}),` or `,_jsx(_components.code,{children:`global`}),`, and `,_jsx(_components.code,{children:`rule_type`}),`; left out when\nno rule filed it), and `,_jsx(_components.code,{children:`synced`}),` (in QuickBooks) or `,_jsx(_components.code,{children:`exported`}),` (taken by a Manual export), each only when true.\nThe answer also has the client’s `,_jsx(_components.code,{children:`platform`}),` (`,_jsx(_components.code,{children:`manual`}),` or `,_jsx(_components.code,{children:`quickbooks`}),`), `,_jsx(_components.code,{children:`total`}),`, `,_jsx(_components.code,{children:`has_more`}),` and\n`,_jsx(_components.code,{children:`next_cursor`}),`. A page that does not fit in 20,000 characters is cut, and its `,_jsx(_components.code,{children:`next_step`}),` says to call again\nwith a smaller `,_jsx(_components.code,{children:`limit`}),` and the same `,_jsx(_components.code,{children:`cursor`}),`. It changes nothing and needs `,_jsx(_components.code,{children:`read:accounting`}),`. A `,_jsx(_components.code,{children:`rule_id`}),`\nthe client does not have, read as `,_jsx(_components.code,{children:`ledgersync_get_rule`}),` reads it, answers `,_jsx(_components.code,{children:`not_found`}),` instead of an empty list.`]}),`\n`,_jsxs(_components.li,{children:[`Its `,_jsx(_components.code,{children:`next_step`}),` also tells the AI how to check rules against the transactions they filed: read each rule with\n`,_jsx(_components.code,{children:`ledgersync_get_rule`}),`, compare its conditions on the bank text and the amount, its category and its payee with\neach transaction, tell the user about every mismatch, and propose a fix with `,_jsx(_components.code,{children:`ledgersync_preview_rules_setup`}),`\nonly after the user agrees.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_preview_accept_transactions`}),` takes `,_jsx(_components.code,{children:`client_ids`}),` (1 to 10, from `,_jsx(_components.code,{children:`ledgersync_find_clients`}),`) with\ntheir `,_jsx(_components.code,{children:`client_names`}),` in the same order,\n`,_jsx(_components.code,{children:`rule_type`}),` (`,_jsx(_components.code,{children:`inclusion`}),`, the default: the rules that file transactions; `,_jsx(_components.code,{children:`exclusion`}),`: the rules whose\ntransactions move to Excluded; or `,_jsx(_components.code,{children:`any`}),`), `,_jsx(_components.code,{children:`only_rule_filed`}),` (`,_jsx(_components.code,{children:`true`}),` by default; `,_jsx(_components.code,{children:`false`}),` also takes the\ntransactions no rule filed, such as ones categorized by hand), `,_jsx(_components.code,{children:`leave_out_categories`}),` (up to 20 GL codes or\nnames, each up to 100 characters: a transaction stays when its category, or any split line’s, has that GL code\nor name, or a name that starts with it followed by a space or a dash) and `,_jsx(_components.code,{children:`from`}),` and `,_jsx(_components.code,{children:`to`}),` (posted dates). For\nexample, “move the transactions with rules to Categorized, except exclusion rules and those coded to 8001 or\n8002” is `,_jsx(_components.code,{children:`rule_type`}),` `,_jsx(_components.code,{children:`inclusion`}),` with `,_jsx(_components.code,{children:`leave_out_categories`}),` `,_jsx(_components.code,{children:`[\"8001\", \"8002\"]`}),`. It changes nothing, so it is\nannotated read-only; it needs `,_jsx(_components.code,{children:`write:accounting`}),`. Two ids of the same client are refused with\n`,_jsx(_components.code,{children:`invalid_request`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`For each client it answers `,_jsx(_components.code,{children:`platform`}),`, `,_jsx(_components.code,{children:`for_review_total`}),`, `,_jsx(_components.code,{children:`will_accept`}),` (`,_jsx(_components.code,{children:`count`}),`, `,_jsx(_components.code,{children:`to_categorized`}),`,\n`,_jsx(_components.code,{children:`to_excluded`}),` and the rows, each with `,_jsx(_components.code,{children:`transaction_id`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`amount`}),`, `,_jsx(_components.code,{children:`description`}),`, `,_jsx(_components.code,{children:`category`}),`, `,_jsx(_components.code,{children:`gl_code`}),`,\n`,_jsx(_components.code,{children:`split_categories`}),`, `,_jsx(_components.code,{children:`payee`}),`, `,_jsx(_components.code,{children:`rule`}),` and `,_jsx(_components.code,{children:`move_to`}),`: `,_jsx(_components.code,{children:`categorized`}),` or `,_jsx(_components.code,{children:`excluded`}),`), `,_jsx(_components.code,{children:`will_refuse`}),` (rows with the\n`,_jsx(_components.code,{children:`reason`}),` the accept would give: `,_jsx(_components.code,{children:`missing_payee`}),`, `,_jsx(_components.code,{children:`missing_category`}),` or, at a QuickBooks client,\n`,_jsx(_components.code,{children:`missing_bank_account_mapping`}),`) and `,_jsx(_components.code,{children:`left_out`}),` (counts by `,_jsx(_components.code,{children:`no_rule`}),`, `,_jsx(_components.code,{children:`other_rule_type`}),` and\n`,_jsx(_components.code,{children:`left_out_category`}),`, a `,_jsx(_components.code,{children:`total`}),`, and up to 20 rows with their `,_jsx(_components.code,{children:`reason`}),`). A client LedgerSync cannot preview (for\nexample, one on another accounting app) gets an `,_jsx(_components.code,{children:`error`}),` (`,_jsx(_components.code,{children:`code`}),`, `,_jsx(_components.code,{children:`message`}),`) while the others are previewed; when\nnone can be, the first one’s error is the tool’s. An id that is not a client the person sees, or a name that is\nnot that client, refuses the whole call before any client is previewed. The answer also has the `,_jsx(_components.code,{children:`criteria`}),`, the `,_jsx(_components.code,{children:`totals`}),` and, when at\nleast one transaction would move, a `,_jsx(_components.code,{children:`confirmation_id`}),` with its `,_jsx(_components.code,{children:`expires_at`}),`, 30 minutes on.`]}),`\n`,_jsxs(_components.li,{children:[`With nothing to move, or with more than 500 to move across the clients (a client with more than 500 alone has\n`,_jsx(_components.code,{children:`over_cap`}),` and `,_jsx(_components.code,{children:`matching_total`}),`), the preview keeps no confirmation, and its `,_jsx(_components.code,{children:`next_step`}),` says why: with too\nmany, preview again with a shorter date range or fewer clients. The answer fits in 20,000 characters: when it\nwould not, each list is cut to 40 rows, then fewer, counted in `,_jsx(_components.code,{children:`more_rows`}),`. The counts always cover every\ntransaction, and the confirmation keeps them all.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_accept_transactions`}),` takes the `,_jsx(_components.code,{children:`confirmation_id`}),` with the same `,_jsx(_components.code,{children:`client_ids`}),` and `,_jsx(_components.code,{children:`client_names`}),` as\nthe preview, after the user’s yes, and sends the clients\nof the preview to LedgerSync one at a time. LedgerSync checks each transaction again as the signed-in person and\naccepts the ones that still match; the others come back in `,_jsx(_components.code,{children:`changed`}),` (`,_jsx(_components.code,{children:`no_longer_for_review`}),` or\n`,_jsx(_components.code,{children:`no_longer_matches`}),`), and the ones the accept refuses in `,_jsx(_components.code,{children:`refused`}),`, with the `,_jsx(_components.code,{children:`reason`}),`. It answers an\n`,_jsx(_components.code,{children:`accept_id`}),`, the `,_jsx(_components.code,{children:`totals`}),` (`,_jsx(_components.code,{children:`moved_to_categorized`}),`, `,_jsx(_components.code,{children:`moved_to_excluded`}),`, `,_jsx(_components.code,{children:`refused`}),`, `,_jsx(_components.code,{children:`changed`}),`,\n`,_jsx(_components.code,{children:`refused_at_preview`}),` and `,_jsx(_components.code,{children:`left_out`}),`) and, for each client, a `,_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`done`}),`, `,_jsx(_components.code,{children:`nothing_to_accept`}),`,\n`,_jsx(_components.code,{children:`upstream_unknown`}),`, `,_jsx(_components.code,{children:`not_reached`}),`, `,_jsx(_components.code,{children:`not_started`}),`, or `,_jsx(_components.code,{children:`refused`}),` with its `,_jsx(_components.code,{children:`error`}),`), `,_jsx(_components.code,{children:`accepted_at`}),`, `,_jsx(_components.code,{children:`moved`}),`\n(`,_jsx(_components.code,{children:`to_categorized`}),`, `,_jsx(_components.code,{children:`to_excluded`}),` and the rows, each with the `,_jsx(_components.code,{children:`category`}),` it was accepted with and `,_jsx(_components.code,{children:`moved_to`}),`),\n`,_jsx(_components.code,{children:`refused`}),`, `,_jsx(_components.code,{children:`changed`}),`, and what the preview left in For review (`,_jsx(_components.code,{children:`refused_at_preview`}),` and `,_jsx(_components.code,{children:`left_out`}),`).\nLedgerSync records each accept with who approved it and from which AI app.`]}),`\n`,_jsxs(_components.li,{children:[`Calling it again with the same `,_jsx(_components.code,{children:`confirmation_id`}),` answers from what it kept, for 24 hours, and never accepts\ntwice. A call starts no new client after 30 seconds: the clients left answer `,_jsx(_components.code,{children:`not_started`}),`. The next\ncall with the same `,_jsx(_components.code,{children:`confirmation_id`}),` sends them, and the clients that answered `,_jsx(_components.code,{children:`not_reached`}),` or\n`,_jsx(_components.code,{children:`upstream_unknown`}),` (LedgerSync did not confirm that client’s accept): LedgerSync keeps each client’s accept\nunder its own key, so none is accepted twice. One call runs at a time for a confirmation: another one meanwhile\ngets `,_jsx(_components.code,{children:`idempotency_conflict`}),`. When no client is done, the call answers an error instead: `,_jsx(_components.code,{children:`upstream_unknown`}),`\nfirst, then `,_jsx(_components.code,{children:`upstream_unavailable`}),`, then the refusal.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ledgersync_undo_accept_transactions`}),` takes the `,_jsx(_components.code,{children:`accept_id`}),` with `,_jsx(_components.code,{children:`client_ids`}),` and `,_jsx(_components.code,{children:`client_names`}),`: every client\nthe accept moved transactions for (status `,_jsx(_components.code,{children:`done`}),` in its answer), and only those. A call that names other\nclients is refused with `,_jsx(_components.code,{children:`invalid_request`}),` and shows nothing. It works in two calls. The first, without\n`,_jsx(_components.code,{children:`undo_id`}),`, changes nothing: for every client of the accept the person manages, it lists the transactions that\nwould go back to For review (`,_jsx(_components.code,{children:`revert`}),`, each with `,_jsx(_components.code,{children:`from`}),`: `,_jsx(_components.code,{children:`categorized`}),` or `,_jsx(_components.code,{children:`excluded`}),`) and the ones that would\nstay (`,_jsx(_components.code,{children:`keep`}),`, with a `,_jsx(_components.code,{children:`reason`}),`: `,_jsx(_components.code,{children:`synced`}),`, `,_jsx(_components.code,{children:`exported`}),` or `,_jsx(_components.code,{children:`changed`}),`), with `,_jsx(_components.code,{children:`totals`}),` and, when something would go\nback, an `,_jsx(_components.code,{children:`undo_id`}),` that works for 15 minutes. The second, with that `,_jsx(_components.code,{children:`undo_id`}),` and the same clients, moves them back and answers what\nwent back and what stayed (`,_jsx(_components.code,{children:`dry_run`}),` is `,_jsx(_components.code,{children:`false`}),`). Only transactions still as the accept left them go back. An\nundo that got no clear answer comes back as `,_jsx(_components.code,{children:`upstream_unknown`}),`: call it again without `,_jsx(_components.code,{children:`undo_id`}),` to see what has\nnot gone back yet. An `,_jsx(_components.code,{children:`accept_id`}),` LedgerSync has no record of, among the clients the person manages, answers\n`,_jsx(_components.code,{children:`not_found`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The steps on `,_jsx(_components.a,{href:`/ai/accept-transactions`,children:`Accept For review transactions`}),` are not an MCP prompt: the four tools’\ndescriptions and `,_jsx(_components.code,{children:`next_step`}),`s carry them.`]}),`\n`]})}),_jsx(Accordion,{title:`Security: a tool acts only on the client the user named, bank sign-ins never in the chat, 72-hour connect links, 10-minute one-use statement and check image links, 6-day invitation sign-in links, client messages carry only LedgerSync links, QuickBooks posts only after a preview, rules saved only after a preview, 24-hour export links that export only on Download, vendors marked for 1099 only after a preview, tax IDs never shown, For review transactions accepted only after a preview`,id:`security-a-tool-acts-only-on-the-client-the-user-named-bank-sign-ins-never-in-the-chat-72-hour-connect-links-10-minute-one-use-statement-and-check-image-links-6-day-invitation-sign-in-links-client-messages-carry-only-ledgersync-links-quickbooks-posts-only-after-a-preview-rules-saved-only-after-a-preview-24-hour-export-links-that-export-only-on-download-vendors-marked-for-1099-only-after-a-preview-tax-ids-never-shown-for-review-transactions-accepted-only-after-a-preview`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A tool acts only on the client the user named. Each client id comes with the client’s name, and LedgerSync\nchecks they are the same client, and one the person sees, before it reads or changes anything. An id that is\nanother client than the name, such as one the AI remembered from an earlier chat, is refused, and so is a\nQuickBooks or rules setup id taken from another client’s list. Each answer names the clients it is about.`}),`\n`,_jsx(_components.li,{children:`Bank sign-ins never happen in the chat. The account holder picks the bank on a LedgerSync page and signs\nin there, or on the bank-data partner’s secure page it opens for some banks. Connect links expire after\n72 hours.`}),`\n`,_jsx(_components.li,{children:`Statement download links expire after 10 minutes and work once; if a download fails, ask for a new link.`}),`\n`,_jsx(_components.li,{children:`Check image download links expire after 10 minutes and work once too. The images never enter the chat,\nand the address where LedgerSync stores them never leaves LedgerSync: the link’s page reads the client’s\nchecks again as the person who asked for it and serves only the checks it names.`}),`\n`,_jsx(_components.li,{children:`Statement upload links work for 24 hours and take one PDF. Converted-file links expire after 10 minutes\nand work once. Both stop working when the connection does: when it is disconnected or made read-only\n(uploads only), when the person’s LedgerSync login can no longer connect, or when the connector is turned\noff.`}),`\n`,_jsx(_components.li,{children:`Invitation links sign the client in to their LedgerSync account with nothing to type and expire\nafter 6 days.`}),`\n`,_jsx(_components.li,{children:`A clarification request’s link opens only the transactions it asks about, and the client can answer only\nthose.`}),`\n`,_jsx(_components.li,{children:`The AI reads a client’s answers only for a client you can see in the LedgerSync app.`}),`\n`,_jsx(_components.li,{children:`The connector cannot see or change API keys, webhooks or account settings.`}),`\n`,_jsx(_components.li,{children:`Firms that sign in with the LedgerSync app login: changing the LedgerSync password, or turning off\ntwo-step sign-in, turns off every AI app connected with that login within a minute.`}),`\n`,_jsxs(_components.li,{children:[`Developer accounts: open `,_jsx(_components.a,{href:`https://portal.ledgersyncappv2.com`,children:`portal.ledgersyncappv2.com`}),` on a computer,\nclick `,_jsx(_components.strong,{children:`Connected apps`}),`, then `,_jsx(_components.strong,{children:`Disconnect`}),` next to each app. It cuts the app off at once; adding it\nagain signs in fresh. The page lists only the apps of the environment picked in the portal’s\n`,_jsx(_components.strong,{children:`Sandbox`}),` / `,_jsx(_components.strong,{children:`Live`}),` switch, so pick `,_jsx(_components.strong,{children:`Live`}),` to see the live connector’s apps. Anyone with the\naccount’s LedgerSync login can add it again. To turn it off for good, email support: support turns off\nthe account’s access for that environment, which stops every connected app and, on live, the account’s\nAPI keys too.`]}),`\n`,_jsxs(_components.li,{children:[`The only link a client message can carry is that client’s own LedgerSync link, which LedgerSync puts\nwhere the text says `,_jsx(_components.code,{children:`#LS_URL#`}),`. A message with any other web address is refused; email addresses are\nfine. A message that breaks a rule is refused with `,_jsx(_components.code,{children:`invalid_request`}),` and a sentence naming the problem.\nThe same rules apply when saving a template.`]}),`\n`,_jsx(_components.li,{children:`An email shows your text as written, with the names and link filled in and your line breaks kept. HTML\nin the text shows as plain text.`}),`\n`,_jsx(_components.li,{children:`Nothing is sent without a preview: LedgerSync tells the AI to show you who gets the message and a sample,\nand to ask you before it sends. Claude and ChatGPT do. In Grok, ask it to show you the message first: in\nour check, Grok tried to add a client without asking for approval. A preview’s confirmation works only for\nthe person and the AI app that made it.`}),`\n`,_jsx(_components.li,{children:`Each person messages only the clients they see in the LedgerSync app: an employee, the clients assigned\nto them.`}),`\n`,_jsx(_components.li,{children:`On the sandbox connector, client messages are never delivered and no link is created for them: the send\nshows what would be sent (would send).`}),`\n`,_jsx(_components.li,{children:`Linking the desktop app needs the code the app shows, and LedgerSync tells the AI to ask you to confirm\nfirst. The code is never logged or repeated back.`}),`\n`,_jsx(_components.li,{children:`The desktop app is linked to the firm owner’s LedgerSync login. Only the owner can link it; a teammate’s\nAI can check whether it is connected.\nLinking a computer replaces any computer linked before: only one computer is connected at a time.\nEvery link is recorded and the LedgerSync team is alerted at once.`}),`\n`,_jsxs(_components.li,{children:[`Nothing reaches QuickBooks without a preview. `,_jsx(_components.code,{children:`ledgersync_push_to_quickbooks`}),` takes only the preview’s\n`,_jsx(_components.code,{children:`confirmation_id`}),`, with the client that preview named, which works for 30 minutes and only for the person and the AI app that made it, and posts\nonly what the preview accepted. It is marked as changing data, so Claude and ChatGPT ask before it runs. In\nGrok, ask it to wait for your yes.`]}),`\n`,_jsx(_components.li,{children:`Each person posts to QuickBooks only for the clients they see in the LedgerSync app: an employee, the\nclients assigned to them.`}),`\n`,_jsxs(_components.li,{children:[`Nothing is saved by a rules setup without a preview, and nothing is created in a client’s QuickBooks without\none. `,_jsx(_components.code,{children:`ledgersync_apply_rules_setup`}),` takes only the preview’s `,_jsx(_components.code,{children:`confirmation_id`}),`, with the client that preview\nnamed, which works for 30 minutes and\nonly for the person and the AI app that made it, and saves only what the preview accepted. It and `,_jsx(_components.code,{children:`ledgersync_undo_rules_setup`}),` are marked as changing data, so Claude\nand ChatGPT ask before they run. In Grok, ask it to wait for your yes.`]}),`\n`,_jsxs(_components.li,{children:[`Each person sets up rules only for the clients they see in the LedgerSync app: an employee, the clients\nassigned to them. Global rules, global categories and global vendors also need the `,_jsx(_components.strong,{children:`Manage Global Rules`}),`\npermission.`]}),`\n`,_jsxs(_components.li,{children:[`Categorized export links work for 24 hours. Opening one only shows a page: the file is built, and the\ntransactions are marked Synced, only when a person presses `,_jsx(_components.strong,{children:`Download`}),` there, so a link preview cannot do it.\nEach press checks the connection again. The link stops working when the connection is disconnected or made\nread-only, when the person’s LedgerSync login can no longer connect, or when the connector is turned off.`]}),`\n`,_jsx(_components.li,{children:`Anyone with an export link can download its file while the link works, so the tool tells the AI to hand it\nover without opening it. Each link takes 5 presses a minute, and each person exports only the clients they\nsee in the LedgerSync app: an employee, the clients assigned to them.`}),`\n`,_jsxs(_components.li,{children:[`Vendors are marked for 1099 in a client’s QuickBooks only after a preview and a yes.\n`,_jsx(_components.code,{children:`ledgersync_apply_ledger_changes`}),` takes only the preview’s `,_jsx(_components.code,{children:`confirmation_id`}),`, with the client that preview\nnamed, which works for 30 minutes and\nonly for the person and the AI app that made it. It and `,_jsx(_components.code,{children:`ledgersync_undo_ledger_changes`}),` are marked as\nchanging data, so Claude and ChatGPT ask before they run. In Grok, ask it to wait for your yes.`]}),`\n`,_jsx(_components.li,{children:`LedgerSync changes only a vendor’s 1099 flag, and only while the vendor is as the preview saw it; the undo\nputs back only vendors nobody changed since. A tax ID is never read into the chat, shown or changed: the\n1099 list says only whether one is on file.`}),`\n`,_jsxs(_components.li,{children:[`For review transactions are accepted only after a preview and a yes. `,_jsx(_components.code,{children:`ledgersync_accept_transactions`}),` takes\nonly the preview’s `,_jsx(_components.code,{children:`confirmation_id`}),`, with the clients that preview named, which works for 30 minutes and only for the person and the AI app that\nmade it, and accepts only the transactions that preview counted, and only while they still match. It and\n`,_jsx(_components.code,{children:`ledgersync_undo_accept_transactions`}),` are marked as changing data, so Claude and ChatGPT ask before they run.\nIn Grok, ask it to wait for your yes.`]}),`\n`,_jsx(_components.li,{children:`Accepting posts nothing to QuickBooks, and the undo puts back only transactions still as the accept left them:\none synced to QuickBooks, exported or changed since stays. Each person accepts only for the clients they see in\nthe LedgerSync app: an employee, the clients assigned to them.`}),`\n`]})}),_jsx(Accordion,{title:`Refreshes and limits: 50 AI refreshes a day on live, 20 on sandbox, 300 client messages a day per firm on live, 60 QuickBooks pushes a day per AI app, 30 rules setups a day per AI app, 30 export links an hour per AI app, 30 sets of 1099 marks a day per AI app, 60 accepts of For review transactions a day per AI app, per-minute and per-hour caps`,id:`refreshes-and-limits-50-ai-refreshes-a-day-on-live-20-on-sandbox-300-client-messages-a-day-per-firm-on-live-60-quickbooks-pushes-a-day-per-ai-app-30-rules-setups-a-day-per-ai-app-30-export-links-an-hour-per-ai-app-30-sets-of-1099-marks-a-day-per-ai-app-60-accepts-of-for-review-transactions-a-day-per-ai-app-per-minute-and-per-hour-caps`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`LedgerSync refreshes every working connection about once a day. A refresh you ask for takes a few\nminutes; see `,_jsx(_components.a,{href:`/guides/data-freshness`,children:`Keeping data fresh`}),`.`]}),`\n`,_jsx(_components.li,{children:`A connection refreshed in the last 30 minutes is skipped unless you ask for a new pull anyway.`}),`\n`,_jsx(_components.li,{children:`Each AI app can start 50 refreshes a day on live (20 on sandbox). They also count against your firm’s\ndaily budget of 500 on live (100 on sandbox), shared with API keys, which is the number the AI shows as\nrefreshes left.`}),`\n`,_jsx(_components.li,{children:`Per connected AI app: 50 new clients a day, 100 changes to client details a day, 30 connect links an hour,\n60 message previews an hour, 30 saved templates a day, and 120 tool calls a minute on sandbox (60 on live).`}),`\n`,_jsx(_components.li,{children:`Statement conversions: 3 at a time and 500 a day per firm on live (2 and 50 on sandbox), shared with\nthe firm’s API keys, in UTC days. Each AI app can make 30 upload links an hour. The upload page takes 5\ntries a minute per link, and a link stops after 3 failed uploads. Every conversion is a real OCR read, on\nsandbox too.`}),`\n`,_jsx(_components.li,{children:`Long lists of connections, accounts, transactions and statements come back in pages.`}),`\n`,_jsx(_components.li,{children:`Client messages: 300 a day per firm on live (100 on sandbox), counted across everyone at the firm and\nevery AI app, in UTC days. Skipped and failed messages do not count. When the limit is reached, sending\nstops and the AI says so.`}),`\n`,_jsx(_components.li,{children:`A client who got a LedgerSync message about the same connection in the last 24 hours is skipped, unless\nyou ask the AI to include them.`}),`\n`,_jsx(_components.li,{children:`A client invited through the AI in the last 24 hours is skipped, unless you ask the AI to include them.`}),`\n`,_jsx(_components.li,{children:`A client asked about some of the same transactions through the AI in the last 24 hours is skipped, unless you\nask the AI to include them. A message the email or text service refused outright does not count.`}),`\n`,_jsx(_components.li,{children:`Texts go out only between 11 am and 9 pm US Eastern time, unless the client has their own texting\nhours on file: then only within those hours, in their time zone, never before 8 am or after 9 pm. A\nclient outside those hours is skipped; ask again later.`}),`\n`,_jsx(_components.li,{children:`An email can be up to 5,000 characters and a text up to 600, with the names and link filled in. An\nemail subject can be up to 150 characters.`}),`\n`,_jsx(_components.li,{children:`A preview looks at up to 200 connections that need attention. When more match, it says so: name a bank\nor pick the connections to narrow it.`}),`\n`,_jsx(_components.li,{children:`An invitation names up to 200 clients; a longer list is refused.`}),`\n`,_jsx(_components.li,{children:`A clarification request names up to 200 clients and up to 200 transactions; a longer list is refused.`}),`\n`,_jsx(_components.li,{children:`Reading answers covers one client and up to 180 days, and lists at most the 500 transactions asked about most\nrecently.`}),`\n`,_jsxs(_components.li,{children:[`A refresh stopped by the desktop app (`,_jsx(_components.code,{children:`desktop_app_required`}),` or `,_jsx(_components.code,{children:`desktop_app_route_choice`}),`) never\nreached the bank. It counts against neither daily refresh limit, and the 30-minute skip does not block\ntrying again.`]}),`\n`,_jsx(_components.li,{children:`Linking the desktop app: 10 tries an hour and 20 a day per LedgerSync account (UTC hours and days),\nwhether the code works or not. A code that is not 7 letters or digits is refused without counting.`}),`\n`,_jsx(_components.li,{children:`QuickBooks bookkeeping: one preview or push takes up to 100 transactions, 10 new payees and 5 new account\nmappings. Per connected AI app: 120 previews an hour and 60 pushes a day; a push counts only when it reaches\nLedgerSync. A preview’s confirmation works for 30 minutes, and a push’s answer is kept for 24 hours.`}),`\n`,_jsxs(_components.li,{children:[`QuickBooks pushes: LedgerSync sends a few at a time, shared by every firm. A push past that is refused as\nbusy (`,_jsx(_components.code,{children:`rate_limit_exceeded`}),`, “Another push is running; try again in a minute.”), is not counted, and can be\nsent again a minute later with the same `,_jsx(_components.code,{children:`confirmation_id`}),`.`]}),`\n`,_jsx(_components.li,{children:`Rules setup: one preview takes up to 100 rules, 50 new global categories, 50 new client categories, 100\ncategory links, 100 new vendors (client and firm vendors together) and 50 changes to existing rules, one per\nrule. Per connected AI app: 60 previews an hour, 30 applies a day and 10 undos a day; an apply counts only\nwhen it reaches LedgerSync. A preview’s\nconfirmation works for 30 minutes, an apply’s answer is kept for 24 hours, and an undo check works for 15\nminutes.`}),`\n`,_jsx(_components.li,{children:`Rules setup conditions and names: a rule has 1 to 5 conditions, at least one of them contains or is exactly.\nA condition looks at the bank text, 1 to 200 characters, or at the amount, a plain amount of up to 9 digits and\n2 decimals with no sign, currency symbol or thousands separator, compared without its sign. Names: a client\nrule up to 100 characters, a global rule 64, a global category 100, a client category 64, a client vendor 80, a\nglobal vendor 64 and a GL code 64.`}),`\n`,_jsxs(_components.li,{children:[`Rules setup changes: one change per rule. The category of a rule split over several lines cannot be changed; a\npayee can be set or replaced but not removed; and a global rule cannot move across or next to global rules\nthat share a priority, or be deleted while it shares its own (`,_jsx(_components.code,{children:`priority_ties`}),`). A change keeps the rule’s type:\nan exclusion rule changes like any rule and stays an exclusion rule.`]}),`\n`,_jsxs(_components.li,{children:[`Rules setup applies: LedgerSync takes a few at a time, shared by every firm. An apply past that is refused as\nbusy, is not counted, and can be sent again a minute later with the same `,_jsx(_components.code,{children:`confirmation_id`}),`. A firm runs one\nsetup at a time; the next one waits until the one before it finishes. An undo does not wait: while another\nsetup of the firm is running or being undone, it is refused with `,_jsx(_components.code,{children:`invalid_request`}),`, and can be sent again when\nthat one finishes.`]}),`\n`,_jsxs(_components.li,{children:[`Linking one global category at every client: one preview covers up to 1,000 clients and takes up to 500\n`,_jsx(_components.code,{children:`overrides`}),` and 500 `,_jsx(_components.code,{children:`skip_client_ids`}),`. It counts as one preview toward the 60 an hour, however many pages it\nhas. Its apply and undo count like any rules setup’s.`]}),`\n`,_jsxs(_components.li,{children:[`Categorized export: one file holds up to 10,000 transactions. Per connected AI app: 30 export links an hour;\na call that could not reach LedgerSync is not counted. A link works for 24 hours and takes 5 presses of\n`,_jsx(_components.strong,{children:`Download`}),` a minute. A firm’s downloads run one at a time; a press that waits more than a minute gets a\npage that says to try again.`]}),`\n`,_jsxs(_components.li,{children:[`Marking vendors for 1099: one preview takes up to 100 vendors. Per connected AI app: 60 previews an hour,\n30 applies a day and 10 undos a day; an apply or an undo counts only when it reaches LedgerSync. A preview’s\nconfirmation works for 30 minutes, an apply’s answer is kept for 24 hours, and an undo check works for 15\nminutes. A client’s changes run one set at a time: while another set of the client is being made or undone,\nan undo is refused as busy (`,_jsx(_components.code,{children:`rate_limit_exceeded`}),`) and can be sent again a minute later.`]}),`\n`,_jsxs(_components.li,{children:[`Accepting For review transactions: one preview takes 1 to 10 clients and up to 20 categories to leave out, and\none accept moves up to 500 transactions across its clients. Per connected AI app: 120 previews an hour, 60\naccepts a day and 30 undos a day; an accept or an undo counts only when it reaches LedgerSync, and the undo’s\nfirst call is not counted. LedgerSync sends a few accepts at a time, shared by every firm: one past that is\nrefused as busy (`,_jsx(_components.code,{children:`rate_limit_exceeded`}),`, “Other transactions are being accepted; try again in a minute.”), is\nnot counted, and can be sent again a minute later with the same `,_jsx(_components.code,{children:`confirmation_id`}),`. A preview’s confirmation\nworks for 30 minutes, an accept’s answer is kept for 24 hours, and an undo check works for 15 minutes.`]}),`\n`]})}),_jsx(Accordion,{title:`Tool updates: Claude and ChatGPT keep a copy of the tool list, and Grok may too`,id:`tool-updates-claude-and-chatgpt-keep-a-copy-of-the-tool-list-and-grok-may-too`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Claude and ChatGPT keep their own copy of the connector’s tools: names, descriptions and settings. After\nLedgerSync adds a tool or a setting (for example `,_jsx(_components.code,{children:`for_check_images`}),` on 2026-10-07), reconnect in Claude\nor click `,_jsx(_components.strong,{children:`Refresh`}),` in ChatGPT (a copy added by hand), then start a new chat. See\n`,_jsx(_components.a,{href:`/ai/troubleshooting#after-an-update`,children:`After a LedgerSync update`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The plugin from ChatGPT’s plugin directory (since 2026-11-11) has no `,_jsx(_components.strong,{children:`Refresh tools`}),` button. OpenAI scans the\nlive connector every day: a new tool reaches users once it passes OpenAI’s automated checks, a changed tool keeps\nits previous definition until the new one passes, and a removed tool goes at the next scan. So a new tool can\ntake a day or more to show up there. On ChatGPT Business, Enterprise or Edu, the workspace admin’s `,_jsx(_components.strong,{children:`New tools`}),`\n(or `,_jsx(_components.strong,{children:`New actions`}),`) setting decides whether tools added later are allowed.`]}),`\n`,_jsxs(_components.li,{children:[`In Grok, load an update by connecting again: open `,_jsx(_components.a,{href:`https://grok.com/connectors`,children:`grok.com/connectors`}),`, click\n`,_jsx(_components.strong,{children:`LedgerSync`}),`, then `,_jsx(_components.strong,{children:`Reauthenticate`}),`. Then start a new chat.`]}),`\n`,_jsxs(_components.li,{children:[`On 2026-10-30 every tool that works on a client gained `,_jsx(_components.code,{children:`client_name`}),` next to `,_jsx(_components.code,{children:`client_id`}),` (`,_jsx(_components.code,{children:`client_names`}),` next\nto `,_jsx(_components.code,{children:`client_ids`}),`), `,_jsx(_components.code,{children:`ledgersync_get_fix_link`}),` gained `,_jsx(_components.code,{children:`client_id`}),`, and the confirmed changes gained the clients\nof their preview. An AI app that kept the older copy sends no name, so LedgerSync refuses the call with\n`,_jsx(_components.code,{children:`invalid_request`}),`, and its `,_jsx(_components.code,{children:`next_step`}),` says to reload LedgerSync’s tools once (Claude: reconnect; ChatGPT:\n`,_jsx(_components.strong,{children:`Refresh tools`}),` on a copy added by hand, while the plugin from ChatGPT’s plugin directory gets new tools on its\nown after OpenAI’s daily check; Grok: `,_jsx(_components.strong,{children:`Reauthenticate`}),`) and start a new chat.`]}),`\n`,_jsx(_components.li,{children:`What a tool returns always comes from the live server, so new result fields and messages work at once.`}),`\n`]})}),_jsxs(Accordion,{title:`Error codes: 15 codes, what each means and what to do`,id:`error-codes-15-codes-what-each-means-and-what-to-do`,children:[_jsxs(_components.p,{children:[`Every error has a `,_jsx(_components.code,{children:`code`}),`, the same as the API’s (see `,_jsx(_components.a,{href:`/guides/errors`,children:`Errors`}),`). Access errors (except\n`,_jsx(_components.code,{children:`firm_under_review`}),`, whose message is the whole sentence), desktop app errors and the per-minute limit\nalso carry a `,_jsx(_components.code,{children:`next_step`}),` sentence the AI reads out. So does a connection\nor refresh stopped by the desktop app, in its result.`]}),_jsxs(_components.p,{children:[`The 15 codes you are most likely to see are listed below. The connector can also answer\n`,_jsx(_components.code,{children:`invalid_request`}),`, `,_jsx(_components.code,{children:`internal_error`}),`, `,_jsx(_components.code,{children:`idempotency_conflict`}),` or `,_jsx(_components.code,{children:`upstream_unavailable`}),` (LedgerSync could not\nbe reached or could not check the firm just now; try again in a minute. After saving a template, list the\ntemplates first: it may already be saved). A QuickBooks push that got no clear answer from LedgerSync comes\nback as `,_jsx(_components.code,{children:`upstream_unknown`}),`, with its `,_jsx(_components.code,{children:`push_id`}),`: check `,_jsx(_components.code,{children:`ledgersync_get_quickbooks_push_status`}),` before pushing\nagain. A rules setup apply or undo that got no clear answer comes back as `,_jsx(_components.code,{children:`upstream_unknown`}),` too, naming the\nsetup: check `,_jsx(_components.code,{children:`ledgersync_get_rules_setup_status`}),` before trying again. So does a 1099 marking apply or undo:\ncheck `,_jsx(_components.code,{children:`ledgersync_get_ledger_changes_status`}),` before trying again. An accept of For review transactions that\nLedgerSync did not confirm comes back as `,_jsx(_components.code,{children:`upstream_unknown`}),` too: call `,_jsx(_components.code,{children:`ledgersync_accept_transactions`}),` again with\nthe same `,_jsx(_components.code,{children:`confirmation_id`}),`, which never accepts twice. For its undo, call `,_jsx(_components.code,{children:`ledgersync_undo_accept_transactions`}),`\nwithout `,_jsx(_components.code,{children:`undo_id`}),` to see what has not gone back yet. A change to a client’s details that LedgerSync did not\nconfirm comes back as `,_jsx(_components.code,{children:`upstream_unavailable`}),`: read the client with `,_jsx(_components.code,{children:`ledgersync_get_client`}),` before trying again.`]}),_jsxs(_components.p,{children:[`The client check adds no new codes. A client id with no name or with another client’s name, an id sealed to\nanother client or with no seal, a confirmed change that names other clients than its preview, or a client’s id\nin an input that does not take it answers `,_jsx(_components.code,{children:`invalid_request`}),`, and nothing is read or changed. LedgerSync records\nwhich one in its request log: `,_jsx(_components.code,{children:`client_name_missing`}),`, `,_jsx(_components.code,{children:`client_name_mismatch`}),`, `,_jsx(_components.code,{children:`sealed_id_foreign`}),`,\n`,_jsx(_components.code,{children:`confirmation_clients_mismatch`}),` or `,_jsx(_components.code,{children:`undeclared_id`}),`. A client id the person does not see answers `,_jsx(_components.code,{children:`not_found`}),`. If\nLedgerSync cannot check the client’s name just then, the call answers `,_jsx(_components.code,{children:`upstream_unavailable`}),`: try again in a\nminute.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`What it means`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`access_not_active`})}),_jsx(_components.td,{children:`This sign-in has no working LedgerSync account yet: it is not set up, the sign-up is not finished, it is being checked, we need an answer, it was not approved, it closed, or it was turned off. For a firm that signs in with its app login: the login cannot connect (a sub-account login), the person’s login or the firm’s account is locked, the firm owner turned off AI assistants for the person, the login has access days and hours, the person no longer has access to the firm, LedgerSync is not active for the firm, or connecting AI assistants is turned off for the firm.`}),_jsxs(_components.td,{children:[`Follow the step the AI reads out. Firms: `,_jsx(_components.a,{href:`/ai/troubleshooting#connect-again`,children:`connect again`}),` and sign in with the LedgerSync app login. Developers apply at `,_jsx(_components.a,{href:`https://portal.ledgersyncappv2.com`,children:`portal.ledgersyncappv2.com`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`access_request_not_approved`})}),_jsx(_components.td,{children:`This sign-in has a LedgerSync account, but not for this environment yet: its application is still being reviewed, needs more information, or has not finished the payment step. Or its access for this environment was turned off.`}),_jsx(_components.td,{children:`Follow the step the AI reads out: wait for the review, answer the question in the portal, or finish the payment step. If access was turned off, email support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`billing_not_configured`})}),_jsx(_components.td,{children:`Live access is approved, but no card is on file (the payment step was not completed).`}),_jsx(_components.td,{children:`Complete the payment step in the portal.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`connector_app_pending_approval`})}),_jsx(_components.td,{children:`This AI app is not supported yet. Only Claude, ChatGPT and Grok are, Grok Bot included (it signs in with Cursor’s client id, which is approved too).`}),_jsx(_components.td,{children:`Use Claude, ChatGPT or Grok, or email support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`connector_access_revoked`})}),_jsx(_components.td,{children:`This AI app was disconnected from your LedgerSync account, or the person who connected it changed their LedgerSync password or turned off two-step sign-in after it connected.`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/ai/troubleshooting#connect-again`,children:`Connect again`}),` and sign in.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`firm_under_review`})}),_jsx(_components.td,{children:`A new firm is still being reviewed by our team. It can add clients; bank connections open after the review.`}),_jsx(_components.td,{children:`Add clients now and connect banks after the review.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`insufficient_scope`})}),_jsx(_components.td,{children:`This connection is read-only, or lacks permission for what you asked.`}),_jsx(_components.td,{children:`Ask for something the connection may do, or email support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rate_limit_exceeded`})}),_jsx(_components.td,{children:`A limit was reached.`}),_jsx(_components.td,{children:`Try again when the AI says you can, or tomorrow for a daily limit.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`not_found`})}),_jsxs(_components.td,{children:[`No client, connection, account, statement, conversion or rule matches, or it belongs to another account. A connection, account, statement, refresh, rule, rules setup, QuickBooks push or 1099 change set of another client than the one named is not found either. A conversion belongs to the person who made its upload link. A client rule (`,_jsx(_components.code,{children:`rul_c_...`}),`) is found only for its own client, and a global rule (`,_jsx(_components.code,{children:`rul_g_...`}),`) only for the firm’s clients on its accounting platform; a deleted rule is not found.`]}),_jsxs(_components.td,{children:[`Ask the AI to find the client first, then try again. For a conversion, use the `,_jsx(_components.code,{children:`conversion_id`}),` from an upload link you made yourself. For a rule, list the rules again and use a `,_jsx(_components.code,{children:`rule_id`}),` from there.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`desktop_app_required`})}),_jsx(_components.td,{children:`This bank needs the LedgerSync desktop app for refreshes, and the app is not connected right now. The bank was not called.`}),_jsx(_components.td,{children:`Open the desktop app on the computer it is set up on, then refresh again. The account holder has nothing to do.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`desktop_app_route_choice`})}),_jsx(_components.td,{children:`The refresh is waiting for someone to choose whether LedgerSync reaches the bank through the desktop app. The bank was not called.`}),_jsx(_components.td,{children:`The AI gives you a fix link for the account holder. They make the choice on that LedgerSync page. Then refresh again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pairing_code_invalid`})}),_jsx(_components.td,{children:`The desktop app code did not work: it is wrong, expired or already used.`}),_jsxs(_components.td,{children:[`Get a new code in the desktop app (`,_jsx(_components.strong,{children:`Settings`}),`, `,_jsx(_components.strong,{children:`Connect with: AI chat`}),`) and tell it to the AI.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`desktop_app_session_closed`})}),_jsx(_components.td,{children:`The desktop app that showed the code is not open anymore.`}),_jsx(_components.td,{children:`Open the desktop app, get a new code and tell it to the AI.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`desktop_service_unavailable`})}),_jsx(_components.td,{children:`LedgerSync could not reach the desktop app service. Nothing you did is wrong.`}),_jsx(_components.td,{children:`Try again in a few minutes. If it keeps failing, email support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pairing_rate_limited`})}),_jsx(_components.td,{children:`Too many tries to link the desktop app. The AI says how many minutes to wait.`}),_jsx(_components.td,{children:`Wait that long, then try again with a new code.`})]})]})]})]})]}),_jsx(_MdxComponentBoundary,{name:`AiStuck`,children:_jsx(AiStuck,{})})]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{AiStuck,AiCopy,AiBox,AiPage,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"For developers","description":"The LedgerSync MCP for developers and admins: sandbox, access, tools, limits and error codes.","mode":"frame","href":"/ai/developers"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[117,132,"Copy=()=>null;const AiBox=()=>null;const AiPage=()=>null;const AiStuck=()=>_jsxs"],[519,7474,""],[278038,278078,"Copy,AiBox,AiPage,AiStuck,default:MDXCon"]]},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ledgersync/6ae4be936c1d0f9f/ai-connector.js"],"subdomain":"ledgersync","siteName":"LedgerSync","title":"For developers - LedgerSync","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T19:08:00.963Z","originalFileLocation":"ai/developers.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The LedgerSync MCP for developers and admins: sandbox, access, tools, limits and error codes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LedgerSync\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"For developers - LedgerSync\">\u003cmeta data-mint-head property=\"og:description\" content=\"The LedgerSync MCP for developers and admins: sandbox, access, tools, limits and error codes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LedgerSync\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ledgersyncappv2.com/ai/developers\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ledgersync.mintlify.site/_mintlify/api/og/v2?division=Developers\u0026amp;title=For+developers\u0026amp;description=The+LedgerSync+MCP+for+developers+and+admins%3A+sandbox%2C+access%2C+tools%2C+limits+and+error+codes.\u0026amp;theme=bcd469bc79d7c9d0510611ec\u0026amp;signature=27e0d3e43c40f7a0bb8225f15552b5564ee0e671dfc91dabb276d6bb8364f3c4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"For developers - LedgerSync\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The LedgerSync MCP for developers and admins: sandbox, access, tools, limits and error codes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ledgersync.mintlify.site/_mintlify/api/og/v2?division=Developers\u0026amp;title=For+developers\u0026amp;description=The+LedgerSync+MCP+for+developers+and+admins%3A+sandbox%2C+access%2C+tools%2C+limits+and+error+codes.\u0026amp;theme=bcd469bc79d7c9d0510611ec\u0026amp;signature=27e0d3e43c40f7a0bb8225f15552b5564ee0e671dfc91dabb276d6bb8364f3c4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LedgerSync\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0891B2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ledgersyncappv2.com/ai/developers\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai/developers.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ledgersyncappv2.com/#organization\",\"name\":\"LedgerSync\",\"url\":\"https://docs.ledgersyncappv2.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ledgersync/NVbCdX0lsP_TgYmH/logo/ledgersync-wordmark.png?fit=max\u0026auto=format\u0026n=NVbCdX0lsP_TgYmH\u0026q=85\u0026s=b149d57dc2f40804f937b11e31060496\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ledgersyncappv2.com#website\",\"name\":\"LedgerSync\",\"url\":\"https://docs.ledgersyncappv2.com\",\"publisher\":{\"@id\":\"https://docs.ledgersyncappv2.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ledgersyncappv2.com/ai/developers#webpage\",\"url\":\"https://docs.ledgersyncappv2.com/ai/developers\",\"name\":\"For developers\",\"description\":\"The LedgerSync MCP for developers and admins: sandbox, access, tools, limits and error codes.\",\"dateModified\":\"2026-11-13T19:08:00.963Z\",\"isPartOf\":{\"@id\":\"https://docs.ledgersyncappv2.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ledgersyncappv2.com/ai/developers#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ledgersyncappv2.com/ai/developers#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"LedgerSync\",\"item\":\"https://docs.ledgersyncappv2.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"For developers\",\"item\":\"https://docs.ledgersyncappv2.com/ai/developers\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ledgersyncappv2.com/ai/developers#article\",\"headline\":\"For developers\",\"name\":\"For developers\",\"description\":\"The LedgerSync MCP for developers and admins: sandbox, access, tools, limits and error codes.\",\"url\":\"https://docs.ledgersyncappv2.com/ai/developers\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ledgersyncappv2.com/ai/developers#webpage\"},\"dateModified\":\"2026-11-13T19:08:00.963Z\",\"publisher\":{\"@id\":\"https://docs.ledgersyncappv2.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ledgersyncappv2.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LedgerSync\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"LedgerSync\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ai/developers.md","siteName":"LedgerSync","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"LedgerSync MCP","groups":[{"group":"LedgerSync MCP","pages":[{"title":"Use LedgerSync in Claude, ChatGPT or Grok","sidebarTitle":"Start here","mode":"frame","href":"/ai/start-here"},{"title":"Set up in Claude","mode":"frame","href":"/ai/setup-claude"},{"title":"Set up in ChatGPT","mode":"frame","href":"/ai/setup-chatgpt"},{"title":"Set up in Grok","mode":"frame","href":"/ai/setup-grok"},{"title":"Set up in Grok Bot","mode":"frame","href":"/ai/setup-grok-bot"},{"title":"Turn a bank statement PDF into transactions","sidebarTitle":"Convert a statement PDF","mode":"frame","href":"/ai/convert-statement"},{"title":"Bookkeeping into QuickBooks","mode":"frame","href":"/ai/quickbooks-bookkeeping"},{"title":"Set up rules for a client","mode":"frame","href":"/ai/rules-setup"},{"title":"Accept For review transactions","mode":"frame","href":"/ai/accept-transactions"},{"title":"Export categorized transactions on a schedule","sidebarTitle":"Export categorized transactions","mode":"frame","href":"/ai/categorized-export"},{"title":"Find who needs a 1099","mode":"frame","href":"/ai/1099-vendors"},{"title":"Review a client's books","mode":"frame","href":"/ai/review-my-client"},{"title":"Explain my reconciliation","mode":"frame","href":"/ai/explain-my-reconciliation"},{"title":"What changed this month","mode":"frame","href":"/ai/what-changed"},{"title":"Check a new client's books","mode":"frame","href":"/ai/new-client-check"},{"title":"Troubleshooting","mode":"frame","href":"/ai/troubleshooting"},{"title":"Banks that need the LedgerSync desktop app","sidebarTitle":"Banks that need the desktop app","description":"Set up the LedgerSync desktop app once, for the few banks that need it.","mode":"frame","href":"/ai/desktop-app"}]},{"group":"Developers","pages":[{"title":"For developers","mode":"frame","href":"/ai/developers"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"v2 API (legacy)","pages":[{"title":"v2 API (legacy)","href":"/v2/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"For developers - LedgerSync","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}