{
  "schemaVersion": "1.0",
  "item": {
    "slug": "quickbooks-online",
    "name": "Quickbooks-Agent",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/paulbudveit/quickbooks-online",
    "canonicalUrl": "https://clawhub.ai/paulbudveit/quickbooks-online",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/quickbooks-online",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=quickbooks-online",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/quickbooks-online"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/quickbooks-online",
    "agentPageUrl": "https://openagent3.xyz/skills/quickbooks-online/agent",
    "manifestUrl": "https://openagent3.xyz/skills/quickbooks-online/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/quickbooks-online/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "qb-cli — QuickBooks Online CLI",
        "body": "Manage QuickBooks Online from the command line. Designed for both human and AI agent use. Talks directly to Intuit's QuickBooks API — no third-party proxy. 164 commands across 29 groups covering AR, AP, chart of accounts, banking, reporting, imports, reconciliation, and month-end workflows."
      },
      {
        "title": "Setup",
        "body": "The tool runs in a Docker container at ~/skills/qb-cli/."
      },
      {
        "title": "Prerequisites",
        "body": "Create a QuickBooks developer account at https://developer.intuit.com\nCreate an app (Keys & OAuth section)\nNote your Client ID and Client Secret\nAdd http://localhost:8844/callback as a Redirect URI"
      },
      {
        "title": "Configuration",
        "body": "cp ~/skills/qb-cli/.env.example ~/skills/qb-cli/.env\n# Edit .env with your Client ID and Client Secret"
      },
      {
        "title": "Build (first time)",
        "body": "docker compose -f ~/skills/qb-cli/docker-compose.yml build"
      },
      {
        "title": "Authenticate (SSH / headless)",
        "body": "# Step 1: Get the auth URL\n~/skills/qb-cli/run.sh auth login --print-url\n\n# Step 2: Open the URL in any browser, authorize QuickBooks\n# Step 3: Copy the full redirect URL from browser address bar\n# Step 4: Paste it back\n~/skills/qb-cli/run.sh auth login --callback-url \"http://localhost:8844/callback?code=...&realmId=...\""
      },
      {
        "title": "Rule 1: ALWAYS Search Before Creating",
        "body": "Never create a customer, vendor, or item without first searching for duplicates.\n\n~/skills/qb-cli/run.sh customer search \"Meridian\"\n~/skills/qb-cli/run.sh vendor search \"Acme\"\n\nIf the search returns results, confirm with the user which one they mean. Do NOT assume."
      },
      {
        "title": "Rule 2: NEVER Create a Customer Without Complete Information",
        "body": "You MUST have ALL of the following before creating a customer record:\n\nDisplay name — Full legal name or business name\nCompany name — The legal business entity name (if applicable)\nBilling email address — Required for sending invoices electronically\nPhone number — Primary contact phone\nBilling address — Full street address, city, state, and zip code\n\nIf the user says something vague like \"send an invoice to Mike\" or \"bill Acme $500\":\n\nSTOP. Do not create anything.\nSearch for the customer: customer search \"Mike\" or customer search \"Acme\"\nIf no results, ask the user for: full name, company name, billing email, phone, and billing address.\nOnly proceed once you have all fields."
      },
      {
        "title": "Rule 3: Confirm Before Sending Invoices/POs",
        "body": "Never send an invoice or PO by email unless the user explicitly says to send it.\nCreating and sending are separate actions.\nAlways confirm the amount, customer/vendor, and line items before creating."
      },
      {
        "title": "Rule 4: Verify Payments Before Applying",
        "body": "Always confirm the customer, open invoices, and amounts before creating a payment.\nInclude the payment reference (check #, ACH trace, wire ref) when available.\nVerify the payment total equals the sum of the per-invoice amounts."
      },
      {
        "title": "Rule 5: Never Delete a Bill with Applied Payments",
        "body": "Before deleting a bill, check if bill-payments have been applied to it.\nDelete or void the bill-payment first, then delete the bill."
      },
      {
        "title": "Rule 6: Journal Entries Must Balance",
        "body": "Debits must equal credits. The CLI validates this before sending.\nAlways specify a memo/description for audit trail."
      },
      {
        "title": "Rule 7: Never Void Deposited Payments",
        "body": "If a payment has been grouped into a deposit, void/delete the deposit first.\nThen void/delete the individual payment."
      },
      {
        "title": "Rule 8: Reconciliation Is Read-Only",
        "body": "The reconcile commands are helpers only — they cannot mark transactions as reconciled in QB.\nUse them to identify matches, flag discrepancies, and generate reports.\nThe actual reconciliation click must happen in the QuickBooks UI."
      },
      {
        "title": "Usage",
        "body": "All commands: ~/skills/qb-cli/run.sh [resource] [action] [options]\n\nDefault output is JSON. Use -o table for human-readable or -o csv for export."
      },
      {
        "title": "Auth & Config",
        "body": "~/skills/qb-cli/run.sh auth login --print-url          # Get OAuth URL\n~/skills/qb-cli/run.sh auth login --callback-url \"...\"  # Complete OAuth\n~/skills/qb-cli/run.sh auth status                       # Check auth status\n~/skills/qb-cli/run.sh auth refresh                      # Force token refresh\n~/skills/qb-cli/run.sh auth logout                       # Remove tokens\n~/skills/qb-cli/run.sh config init                       # Initialize config\n~/skills/qb-cli/run.sh config show                       # Show config\n~/skills/qb-cli/run.sh company info                      # Company details"
      },
      {
        "title": "Customers (AR)",
        "body": "# Search (ALWAYS do this first!)\n~/skills/qb-cli/run.sh customer search \"Acme\"\n~/skills/qb-cli/run.sh customer search \"jane@example.com\"\n~/skills/qb-cli/run.sh customer search \"555-0199\"\n\n# List\n~/skills/qb-cli/run.sh customer list\n~/skills/qb-cli/run.sh customer list -o table\n~/skills/qb-cli/run.sh customer list --no-active-only\n\n# CRUD\n~/skills/qb-cli/run.sh customer get 123\n~/skills/qb-cli/run.sh customer create --name \"Jane Smith\" --company \"Smith LLC\" --email \"jane@smith.com\" --phone \"555-0199\"\n~/skills/qb-cli/run.sh customer update 123 --name \"Jane Smith-Jones\" --email \"new@email.com\"\n~/skills/qb-cli/run.sh customer delete 123   # soft-delete (Active=false)\n\n# Query\n~/skills/qb-cli/run.sh customer query \"Balance > '0'\""
      },
      {
        "title": "Invoices",
        "body": "~/skills/qb-cli/run.sh invoice list\n~/skills/qb-cli/run.sh invoice get 456\n~/skills/qb-cli/run.sh invoice create --customer-id 123 --amount 500 --due-date 2026-04-01\n~/skills/qb-cli/run.sh invoice create --customer-id 123 --line-json '[{\"Amount\":500,\"DetailType\":\"SalesItemLineDetail\",\"SalesItemLineDetail\":{\"ItemRef\":{\"value\":\"1\"},\"Qty\":2,\"UnitPrice\":250}}]'\n~/skills/qb-cli/run.sh invoice update 456 --json '{\"DueDate\": \"2026-05-01\"}'\n~/skills/qb-cli/run.sh invoice send 456                  # email to customer\n~/skills/qb-cli/run.sh invoice send 456 --email \"override@email.com\"\n~/skills/qb-cli/run.sh invoice void 456                  # zeros amounts, keeps record\n~/skills/qb-cli/run.sh invoice delete 456\n~/skills/qb-cli/run.sh invoice query \"CustomerRef = '123' AND Balance > '0'\""
      },
      {
        "title": "Payments",
        "body": "~/skills/qb-cli/run.sh payment list\n~/skills/qb-cli/run.sh payment get 182\n~/skills/qb-cli/run.sh payment create --customer-id 63 --amount 5000 --invoice-ids \"148,149\" --invoice-amounts \"3000,2000\" --ref \"ACH-12345\" --date \"2026-02-15\"\n~/skills/qb-cli/run.sh payment void 182\n~/skills/qb-cli/run.sh payment delete 182\n~/skills/qb-cli/run.sh payment query \"TxnDate > '2026-01-01'\""
      },
      {
        "title": "Estimates (Quotes/Proposals)",
        "body": "~/skills/qb-cli/run.sh estimate list\n~/skills/qb-cli/run.sh estimate get 789\n~/skills/qb-cli/run.sh estimate create --customer-id 123 --amount 1500 --expiration-date 2026-04-30\n~/skills/qb-cli/run.sh estimate update 789 --json '{\"ExpirationDate\": \"2026-05-31\"}'\n~/skills/qb-cli/run.sh estimate send 789\n~/skills/qb-cli/run.sh estimate to-invoice 789   # convert estimate to invoice\n~/skills/qb-cli/run.sh estimate delete 789\n~/skills/qb-cli/run.sh estimate query \"TxnStatus = 'Pending'\""
      },
      {
        "title": "Credit Memos",
        "body": "~/skills/qb-cli/run.sh credit-memo list\n~/skills/qb-cli/run.sh credit-memo create --customer-id 123 --amount 200\n~/skills/qb-cli/run.sh credit-memo send 456\n~/skills/qb-cli/run.sh credit-memo void 456\n~/skills/qb-cli/run.sh credit-memo delete 456\n~/skills/qb-cli/run.sh credit-memo query \"TotalAmt > '100'\""
      },
      {
        "title": "Sales Receipts (Cash Sales)",
        "body": "~/skills/qb-cli/run.sh sales-receipt list\n~/skills/qb-cli/run.sh sales-receipt create --customer-id 123 --amount 750 --deposit-to 35 --payment-method \"Cash\"\n~/skills/qb-cli/run.sh sales-receipt send 456\n~/skills/qb-cli/run.sh sales-receipt void 456\n~/skills/qb-cli/run.sh sales-receipt delete 456"
      },
      {
        "title": "Refund Receipts",
        "body": "~/skills/qb-cli/run.sh refund-receipt list\n~/skills/qb-cli/run.sh refund-receipt create --customer-id 123 --amount 200 --deposit-from 35\n~/skills/qb-cli/run.sh refund-receipt void 456\n~/skills/qb-cli/run.sh refund-receipt delete 456"
      },
      {
        "title": "Vendors (AP)",
        "body": "# Search (ALWAYS do this first!)\n~/skills/qb-cli/run.sh vendor search \"Office Depot\"\n\n# List\n~/skills/qb-cli/run.sh vendor list\n~/skills/qb-cli/run.sh vendor list --no-active-only\n\n# CRUD\n~/skills/qb-cli/run.sh vendor get 42\n~/skills/qb-cli/run.sh vendor create --name \"Office Depot\" --company \"Office Depot Inc\" --email \"ap@officedepot.com\" --phone \"800-555-1234\" --1099\n~/skills/qb-cli/run.sh vendor create --name \"John the Plumber\" --1099 --tax-id \"123-45-6789\"\n~/skills/qb-cli/run.sh vendor update 42 --email \"new@email.com\" --1099\n~/skills/qb-cli/run.sh vendor delete 42   # soft-delete\n~/skills/qb-cli/run.sh vendor query \"Balance > '0'\""
      },
      {
        "title": "Bills",
        "body": "~/skills/qb-cli/run.sh bill list\n~/skills/qb-cli/run.sh bill get 100\n~/skills/qb-cli/run.sh bill create --vendor-id 42 --amount 1500 --due-date 2026-03-15\n~/skills/qb-cli/run.sh bill create --vendor-id 42 --amount 800 --account-id 80 --memo \"Office supplies Jan\"\n~/skills/qb-cli/run.sh bill update 100 --json '{\"DueDate\": \"2026-04-01\"}'\n~/skills/qb-cli/run.sh bill delete 100\n~/skills/qb-cli/run.sh bill query \"VendorRef = '42' AND Balance > '0'\""
      },
      {
        "title": "Bill Payments",
        "body": "~/skills/qb-cli/run.sh bill-payment list\n~/skills/qb-cli/run.sh bill-payment get 200\n~/skills/qb-cli/run.sh bill-payment create --vendor-id 42 --amount 1500 --pay-type Check --account-id 35 --bill-ids \"100,101\" --bill-amounts \"1000,500\" --ref \"1042\"\n~/skills/qb-cli/run.sh bill-payment create --vendor-id 42 --amount 800 --pay-type CreditCard --account-id 41 --bill-ids \"102\"\n~/skills/qb-cli/run.sh bill-payment void 200\n~/skills/qb-cli/run.sh bill-payment delete 200\n~/skills/qb-cli/run.sh bill-payment query \"TxnDate >= '2026-01-01'\""
      },
      {
        "title": "Vendor Credits",
        "body": "~/skills/qb-cli/run.sh vendor-credit list\n~/skills/qb-cli/run.sh vendor-credit create --vendor-id 42 --amount 150 --account-id 80\n~/skills/qb-cli/run.sh vendor-credit delete 300\n~/skills/qb-cli/run.sh vendor-credit query \"VendorRef = '42'\""
      },
      {
        "title": "Purchase Orders",
        "body": "~/skills/qb-cli/run.sh purchase-order list\n~/skills/qb-cli/run.sh purchase-order create --vendor-id 42 --amount 5000 --item-id 10 --memo \"Q2 inventory\"\n~/skills/qb-cli/run.sh purchase-order send 500\n~/skills/qb-cli/run.sh purchase-order to-bill 500   # convert PO to bill\n~/skills/qb-cli/run.sh purchase-order update 500 --json '{\"POStatus\": \"Closed\"}'\n~/skills/qb-cli/run.sh purchase-order delete 500"
      },
      {
        "title": "Chart of Accounts",
        "body": "~/skills/qb-cli/run.sh account list\n~/skills/qb-cli/run.sh account list --type Bank           # filter by type\n~/skills/qb-cli/run.sh account list --type Expense\n~/skills/qb-cli/run.sh account get 35\n~/skills/qb-cli/run.sh account create --name \"Marketing\" --type Expense --sub-type AdvertisingPromotional\n~/skills/qb-cli/run.sh account create --name \"Business Checking\" --type Bank --sub-type Checking --acct-num \"1010\"\n~/skills/qb-cli/run.sh account update 35 --name \"Updated Name\" --description \"New description\"\n~/skills/qb-cli/run.sh account delete 35   # soft-delete (Active=false)\n~/skills/qb-cli/run.sh account query \"AccountType = 'Bank'\""
      },
      {
        "title": "Items (Products & Services)",
        "body": "~/skills/qb-cli/run.sh item list\n~/skills/qb-cli/run.sh item list --type Service\n~/skills/qb-cli/run.sh item list --type Inventory\n~/skills/qb-cli/run.sh item get 10\n~/skills/qb-cli/run.sh item create --name \"Consulting\" --type Service --income-account 1 --price 150 --description \"Hourly consulting\"\n~/skills/qb-cli/run.sh item create --name \"Widget\" --type Inventory --income-account 1 --expense-account 80 --asset-account 81 --price 29.99 --cost 12.50 --qty 100 --inv-start-date 2026-01-01\n~/skills/qb-cli/run.sh item update 10 --price 175 --name \"Senior Consulting\"\n~/skills/qb-cli/run.sh item delete 10   # soft-delete\n~/skills/qb-cli/run.sh item query \"Type = 'Service'\""
      },
      {
        "title": "Expenses (Purchases / Checks / CC Charges)",
        "body": "~/skills/qb-cli/run.sh expense list\n~/skills/qb-cli/run.sh expense get 400\n~/skills/qb-cli/run.sh expense create --account-id 35 --pay-type Check --vendor-id 42 --amount 250 --doc-number \"1042\" --memo \"Office supplies\"\n~/skills/qb-cli/run.sh expense create --account-id 41 --pay-type CreditCard --amount 99.99 --memo \"Software subscription\"\n~/skills/qb-cli/run.sh expense update 400 --json '{\"PrivateNote\": \"Updated memo\"}'\n~/skills/qb-cli/run.sh expense delete 400\n~/skills/qb-cli/run.sh expense query \"TxnDate >= '2026-01-01' AND TxnDate <= '2026-01-31'\""
      },
      {
        "title": "Journal Entries",
        "body": "~/skills/qb-cli/run.sh journal list\n~/skills/qb-cli/run.sh journal get 500\n~/skills/qb-cli/run.sh journal create --lines '[{\"account_id\":\"80\",\"amount\":500,\"type\":\"Debit\",\"description\":\"Depreciation exp\"},{\"account_id\":\"35\",\"amount\":500,\"type\":\"Credit\",\"description\":\"Accum depreciation\"}]' --date 2026-01-31 --memo \"Jan depreciation\"\n~/skills/qb-cli/run.sh journal delete 500\n~/skills/qb-cli/run.sh journal query \"TxnDate = '2026-01-31'\""
      },
      {
        "title": "Deposits",
        "body": "~/skills/qb-cli/run.sh deposit list\n~/skills/qb-cli/run.sh deposit get 600\n~/skills/qb-cli/run.sh deposit create --account-id 35 --payment-ids \"182,183,184\" --date 2026-02-15 --memo \"Week of 2/15 deposits\"\n~/skills/qb-cli/run.sh deposit delete 600\n~/skills/qb-cli/run.sh deposit query \"TxnDate >= '2026-02-01'\""
      },
      {
        "title": "Transfers",
        "body": "~/skills/qb-cli/run.sh transfer list\n~/skills/qb-cli/run.sh transfer get 700\n~/skills/qb-cli/run.sh transfer create --from 35 --to 36 --amount 10000 --date 2026-02-01 --memo \"Move to savings\"\n~/skills/qb-cli/run.sh transfer delete 700"
      },
      {
        "title": "Financial Reports",
        "body": "All reports support -o json (default), -o table, -o csv.\n\n# Income Statement\n~/skills/qb-cli/run.sh report profit-and-loss --start-date 2026-01-01 --end-date 2026-01-31\n~/skills/qb-cli/run.sh report profit-and-loss --period \"Last Month\"\n~/skills/qb-cli/run.sh report profit-and-loss --start-date 2026-01-01 --end-date 2026-12-31 --summarize-by Month\n~/skills/qb-cli/run.sh report profit-and-loss-detail --start-date 2026-01-01 --end-date 2026-01-31\n\n# Balance Sheet\n~/skills/qb-cli/run.sh report balance-sheet --date 2026-01-31\n~/skills/qb-cli/run.sh report balance-sheet --period \"This Fiscal Year\"\n\n# Cash Flow\n~/skills/qb-cli/run.sh report cash-flow --start-date 2026-01-01 --end-date 2026-01-31\n\n# Trial Balance\n~/skills/qb-cli/run.sh report trial-balance --date 2026-01-31\n\n# General Ledger\n~/skills/qb-cli/run.sh report general-ledger --start-date 2026-01-01 --end-date 2026-01-31 --account 35\n\n# AR/AP Aging\n~/skills/qb-cli/run.sh report ar-aging\n~/skills/qb-cli/run.sh report ar-aging-detail --customer 123\n~/skills/qb-cli/run.sh report ap-aging\n~/skills/qb-cli/run.sh report ap-aging-detail --vendor 42\n\n# Balance Reports\n~/skills/qb-cli/run.sh report customer-balance\n~/skills/qb-cli/run.sh report vendor-balance\n\n# Income/Expense Analysis\n~/skills/qb-cli/run.sh report customer-income --start-date 2026-01-01 --end-date 2026-12-31\n~/skills/qb-cli/run.sh report vendor-expenses --start-date 2026-01-01 --end-date 2026-12-31\n\n# Transaction List\n~/skills/qb-cli/run.sh report transaction-list --start-date 2026-01-01 --end-date 2026-01-31\n\n# Tax Summary\n~/skills/qb-cli/run.sh report tax-summary --start-date 2026-01-01 --end-date 2026-12-31"
      },
      {
        "title": "Bank Statement Import",
        "body": "# Preview a statement file (no changes to QB)\n~/skills/qb-cli/run.sh import preview /workspace/statement.ofx\n~/skills/qb-cli/run.sh import preview /workspace/statement.csv --date-col \"Trans Date\" --amount-col \"Amount\" --desc-col \"Description\"\n\n# Import and match (dry run first!)\n~/skills/qb-cli/run.sh import bank /workspace/statement.ofx --account-id 35 --dry-run\n~/skills/qb-cli/run.sh import bank /workspace/statement.ofx --account-id 35\n\n# CSV import with custom columns\n~/skills/qb-cli/run.sh import bank /workspace/statement.csv --account-id 35 --format csv --date-col \"Date\" --amount-col \"Amount\" --desc-col \"Payee\" --dry-run\n\nSupported formats: OFX, QFX, QBO, CSV (with configurable column mapping).\n\nMatching algorithm:\n\nExact match — same amount AND same date AND (matching FITID or check number) → skipped\nProbable match — same amount AND date within ±3 days → flagged for review\nNo match → created as Purchase (debit) or Deposit (credit)"
      },
      {
        "title": "Bank Reconciliation",
        "body": "# Start reconciliation session\n~/skills/qb-cli/run.sh reconcile start --account-id 35 --statement-date 2026-01-31 --statement-balance 45000.00\n\n# Check status\n~/skills/qb-cli/run.sh reconcile status --account-id 35\n\n# Match statement against QB\n~/skills/qb-cli/run.sh reconcile match --account-id 35 --statement-file /workspace/jan-statement.ofx\n\n# Generate reconciliation report\n~/skills/qb-cli/run.sh reconcile report --account-id 35 --start-date 2026-01-01 --end-date 2026-01-31\n\nNote: These are helper commands. QB has no reconciliation API — you cannot programmatically mark transactions as reconciled. Use these to identify matches and discrepancies, then complete the reconciliation in the QB UI."
      },
      {
        "title": "Bookkeeping Workflows",
        "body": "# Month-end close checklist\n~/skills/qb-cli/run.sh workflow month-close --month 2026-01 --check-only   # just run checks\n~/skills/qb-cli/run.sh workflow month-close --month 2026-01                # checks + generate reports\n\n# 1099 preparation\n~/skills/qb-cli/run.sh workflow 1099-prep --year 2025\n~/skills/qb-cli/run.sh workflow 1099-prep --year 2025 --threshold 600\n\n# AR follow-up (overdue invoices grouped by customer)\n~/skills/qb-cli/run.sh workflow ar-followup --days-overdue 30\n~/skills/qb-cli/run.sh workflow ar-followup --days-overdue 60\n\n# Undeposited funds check\n~/skills/qb-cli/run.sh workflow undeposited-funds\n\nMonth-end close runs these checks:\n\nUndeposited Funds balance (should be ~$0)\nOverdue AR (invoices past due before month start)\nOverdue AP (bills past due before month start)\nOpen invoices for the month\n\nThen generates P&L, Balance Sheet, and Trial Balance to /workspace/."
      },
      {
        "title": "Batch Operations",
        "body": "# Run batch operations from a JSON file (max 30 per batch, auto-chunks)\n~/skills/qb-cli/run.sh batch run --file /workspace/batch_ops.json\n\nBatch file format:\n\n[\n  {\"operation\": \"create\", \"entity\": \"Customer\", \"body\": {\"DisplayName\": \"New Customer\"}},\n  {\"operation\": \"query\", \"sql\": \"SELECT * FROM Invoice WHERE Balance > '0'\"},\n  {\"operation\": \"delete\", \"entity\": \"Invoice\", \"id\": \"123\", \"sync_token\": \"0\"}\n]"
      },
      {
        "title": "Company Preferences",
        "body": "~/skills/qb-cli/run.sh preferences show\n~/skills/qb-cli/run.sh preferences update --json '{\"AccountingInfoPrefs\": {\"BookCloseDate\": \"2025-12-31\"}}'"
      },
      {
        "title": "Tax",
        "body": "~/skills/qb-cli/run.sh tax codes\n~/skills/qb-cli/run.sh tax rates\n~/skills/qb-cli/run.sh tax summary --start-date 2026-01-01 --end-date 2026-12-31"
      },
      {
        "title": "Attachments",
        "body": "~/skills/qb-cli/run.sh attachment list --entity-type Invoice --entity-id 456\n~/skills/qb-cli/run.sh attachment get 800\n~/skills/qb-cli/run.sh attachment upload --entity-type Invoice --entity-id 456 --file /workspace/receipt.pdf\n~/skills/qb-cli/run.sh attachment note --entity-type Invoice --entity-id 456 --text \"Approved by CFO 2/15\"\n~/skills/qb-cli/run.sh attachment delete 800"
      },
      {
        "title": "Processing a Vendor Bill",
        "body": "1. vendor search \"Vendor Name\"           → find or create vendor\n2. bill create --vendor-id X --amount $  → record the bill\n3. bill-payment create --vendor-id X --amount $ --pay-type Check --account-id Y --bill-ids Z\n                                          → pay the bill when ready"
      },
      {
        "title": "Sending an Invoice",
        "body": "1. customer search \"Customer Name\"        → find existing customer\n2. invoice create --customer-id X --amount $ --due-date YYYY-MM-DD\n3. (confirm with user before sending)\n4. invoice send <id>                      → only if user explicitly requests"
      },
      {
        "title": "Converting Estimate to Invoice",
        "body": "1. estimate create --customer-id X --amount $ --expiration-date YYYY-MM-DD\n2. estimate send <id>                     → send to customer for review\n3. (once accepted)\n4. estimate to-invoice <id>               → creates linked invoice"
      },
      {
        "title": "Month-End Close",
        "body": "1. workflow month-close --month YYYY-MM --check-only    → review issues\n2. (fix any warnings: deposit undeposited funds, follow up on AR, etc.)\n3. journal create --lines '[...]' --date YYYY-MM-DD     → adjusting entries\n4. workflow month-close --month YYYY-MM                 → generate reports\n5. report profit-and-loss --start-date ... --end-date ...  → final P&L\n6. report balance-sheet --date YYYY-MM-DD               → final BS"
      },
      {
        "title": "Bank Reconciliation",
        "body": "1. import preview /workspace/statement.ofx              → inspect transactions\n2. import bank /workspace/statement.ofx --account-id X --dry-run  → preview matches\n3. import bank /workspace/statement.ofx --account-id X  → create unmatched\n4. reconcile start --account-id X --statement-date ... --statement-balance $\n5. reconcile match --account-id X --statement-file /workspace/statement.ofx\n6. (review matches, investigate discrepancies)\n7. reconcile report --account-id X --start-date ... --end-date ..."
      },
      {
        "title": "1099 Year-End Prep",
        "body": "1. workflow 1099-prep --year YYYY         → identify vendors over threshold\n2. (review missing TINs — flag them for user)\n3. vendor update <id> --tax-id \"XX-XXXXXXX\"  → add missing TINs\n4. (CSV exported to /workspace/1099_prep_YYYY.csv for filing software)"
      },
      {
        "title": "Agent Integration Notes",
        "body": "Exit codes:\n\n0 — Success\n1 — API error (bad request, server error)\n2 — Configuration error (missing config)\n3 — Authentication error (expired/invalid tokens)\n4 — Not found\n5 — Validation error (missing required arguments)\n\nError format:\n\n{\"error\": true, \"code\": 3, \"message\": \"Not authenticated\", \"hint\": \"qb auth login\"}\n\nKey behaviors:\n\nToken refresh is automatic — no manual refresh needed\nSyncToken is auto-fetched before update/delete operations\nAccount entity requires full update (not sparse) — handled automatically\nSoft-delete for name-list entities (customer, vendor, account, item) uses Active: false\nHard delete for transactions (invoice, bill, payment, etc.) uses operation=delete\nVoid for transactions zeros amounts but keeps the record\nQuickBooks uses SQL-like queries: SELECT * FROM Customer WHERE Balance > '0'\nQuery operators: =, LIKE, <, >, <=, >=, IN\nDate format: YYYY-MM-DD\nReports return hierarchical JSON with Header/Columns/Rows\nWorkspace directory at /workspace/ (mapped to ~/skills/qb-cli/workspace/ on host)\n\nCommand group count (29 groups, 164 commands):\nauth, config, company, customer, invoice, payment, estimate, credit-memo, sales-receipt, refund-receipt, vendor, bill, bill-payment, vendor-credit, purchase-order, account, item, expense, journal, deposit, transfer, report, import, reconcile, workflow, batch, preferences, tax, attachment\n\nQB query limitations:\n\nVendor1099 is not queryable via SQL — use vendor list and filter client-side\nOR is not supported — searches run multiple queries and deduplicate\nPhone fields are not indexable via LIKE — search falls back to client-side filter\nString values in queries must be single-quoted: WHERE Balance > '0'"
      }
    ],
    "body": "qb-cli — QuickBooks Online CLI\n\nManage QuickBooks Online from the command line. Designed for both human and AI agent use. Talks directly to Intuit's QuickBooks API — no third-party proxy. 164 commands across 29 groups covering AR, AP, chart of accounts, banking, reporting, imports, reconciliation, and month-end workflows.\n\nSetup\n\nThe tool runs in a Docker container at ~/skills/qb-cli/.\n\nPrerequisites\nCreate a QuickBooks developer account at https://developer.intuit.com\nCreate an app (Keys & OAuth section)\nNote your Client ID and Client Secret\nAdd http://localhost:8844/callback as a Redirect URI\nConfiguration\ncp ~/skills/qb-cli/.env.example ~/skills/qb-cli/.env\n# Edit .env with your Client ID and Client Secret\n\nBuild (first time)\ndocker compose -f ~/skills/qb-cli/docker-compose.yml build\n\nAuthenticate (SSH / headless)\n# Step 1: Get the auth URL\n~/skills/qb-cli/run.sh auth login --print-url\n\n# Step 2: Open the URL in any browser, authorize QuickBooks\n# Step 3: Copy the full redirect URL from browser address bar\n# Step 4: Paste it back\n~/skills/qb-cli/run.sh auth login --callback-url \"http://localhost:8844/callback?code=...&realmId=...\"\n\nCRITICAL AGENT RULES — READ BEFORE DOING ANYTHING\nRule 1: ALWAYS Search Before Creating\n\nNever create a customer, vendor, or item without first searching for duplicates.\n\n~/skills/qb-cli/run.sh customer search \"Meridian\"\n~/skills/qb-cli/run.sh vendor search \"Acme\"\n\n\nIf the search returns results, confirm with the user which one they mean. Do NOT assume.\n\nRule 2: NEVER Create a Customer Without Complete Information\n\nYou MUST have ALL of the following before creating a customer record:\n\nDisplay name — Full legal name or business name\nCompany name — The legal business entity name (if applicable)\nBilling email address — Required for sending invoices electronically\nPhone number — Primary contact phone\nBilling address — Full street address, city, state, and zip code\n\nIf the user says something vague like \"send an invoice to Mike\" or \"bill Acme $500\":\n\nSTOP. Do not create anything.\nSearch for the customer: customer search \"Mike\" or customer search \"Acme\"\nIf no results, ask the user for: full name, company name, billing email, phone, and billing address.\nOnly proceed once you have all fields.\nRule 3: Confirm Before Sending Invoices/POs\nNever send an invoice or PO by email unless the user explicitly says to send it.\nCreating and sending are separate actions.\nAlways confirm the amount, customer/vendor, and line items before creating.\nRule 4: Verify Payments Before Applying\nAlways confirm the customer, open invoices, and amounts before creating a payment.\nInclude the payment reference (check #, ACH trace, wire ref) when available.\nVerify the payment total equals the sum of the per-invoice amounts.\nRule 5: Never Delete a Bill with Applied Payments\nBefore deleting a bill, check if bill-payments have been applied to it.\nDelete or void the bill-payment first, then delete the bill.\nRule 6: Journal Entries Must Balance\nDebits must equal credits. The CLI validates this before sending.\nAlways specify a memo/description for audit trail.\nRule 7: Never Void Deposited Payments\nIf a payment has been grouped into a deposit, void/delete the deposit first.\nThen void/delete the individual payment.\nRule 8: Reconciliation Is Read-Only\nThe reconcile commands are helpers only — they cannot mark transactions as reconciled in QB.\nUse them to identify matches, flag discrepancies, and generate reports.\nThe actual reconciliation click must happen in the QuickBooks UI.\nUsage\n\nAll commands: ~/skills/qb-cli/run.sh [resource] [action] [options]\n\nDefault output is JSON. Use -o table for human-readable or -o csv for export.\n\nAuth & Config\n~/skills/qb-cli/run.sh auth login --print-url          # Get OAuth URL\n~/skills/qb-cli/run.sh auth login --callback-url \"...\"  # Complete OAuth\n~/skills/qb-cli/run.sh auth status                       # Check auth status\n~/skills/qb-cli/run.sh auth refresh                      # Force token refresh\n~/skills/qb-cli/run.sh auth logout                       # Remove tokens\n~/skills/qb-cli/run.sh config init                       # Initialize config\n~/skills/qb-cli/run.sh config show                       # Show config\n~/skills/qb-cli/run.sh company info                      # Company details\n\nCustomers (AR)\n# Search (ALWAYS do this first!)\n~/skills/qb-cli/run.sh customer search \"Acme\"\n~/skills/qb-cli/run.sh customer search \"jane@example.com\"\n~/skills/qb-cli/run.sh customer search \"555-0199\"\n\n# List\n~/skills/qb-cli/run.sh customer list\n~/skills/qb-cli/run.sh customer list -o table\n~/skills/qb-cli/run.sh customer list --no-active-only\n\n# CRUD\n~/skills/qb-cli/run.sh customer get 123\n~/skills/qb-cli/run.sh customer create --name \"Jane Smith\" --company \"Smith LLC\" --email \"jane@smith.com\" --phone \"555-0199\"\n~/skills/qb-cli/run.sh customer update 123 --name \"Jane Smith-Jones\" --email \"new@email.com\"\n~/skills/qb-cli/run.sh customer delete 123   # soft-delete (Active=false)\n\n# Query\n~/skills/qb-cli/run.sh customer query \"Balance > '0'\"\n\nInvoices\n~/skills/qb-cli/run.sh invoice list\n~/skills/qb-cli/run.sh invoice get 456\n~/skills/qb-cli/run.sh invoice create --customer-id 123 --amount 500 --due-date 2026-04-01\n~/skills/qb-cli/run.sh invoice create --customer-id 123 --line-json '[{\"Amount\":500,\"DetailType\":\"SalesItemLineDetail\",\"SalesItemLineDetail\":{\"ItemRef\":{\"value\":\"1\"},\"Qty\":2,\"UnitPrice\":250}}]'\n~/skills/qb-cli/run.sh invoice update 456 --json '{\"DueDate\": \"2026-05-01\"}'\n~/skills/qb-cli/run.sh invoice send 456                  # email to customer\n~/skills/qb-cli/run.sh invoice send 456 --email \"override@email.com\"\n~/skills/qb-cli/run.sh invoice void 456                  # zeros amounts, keeps record\n~/skills/qb-cli/run.sh invoice delete 456\n~/skills/qb-cli/run.sh invoice query \"CustomerRef = '123' AND Balance > '0'\"\n\nPayments\n~/skills/qb-cli/run.sh payment list\n~/skills/qb-cli/run.sh payment get 182\n~/skills/qb-cli/run.sh payment create --customer-id 63 --amount 5000 --invoice-ids \"148,149\" --invoice-amounts \"3000,2000\" --ref \"ACH-12345\" --date \"2026-02-15\"\n~/skills/qb-cli/run.sh payment void 182\n~/skills/qb-cli/run.sh payment delete 182\n~/skills/qb-cli/run.sh payment query \"TxnDate > '2026-01-01'\"\n\nEstimates (Quotes/Proposals)\n~/skills/qb-cli/run.sh estimate list\n~/skills/qb-cli/run.sh estimate get 789\n~/skills/qb-cli/run.sh estimate create --customer-id 123 --amount 1500 --expiration-date 2026-04-30\n~/skills/qb-cli/run.sh estimate update 789 --json '{\"ExpirationDate\": \"2026-05-31\"}'\n~/skills/qb-cli/run.sh estimate send 789\n~/skills/qb-cli/run.sh estimate to-invoice 789   # convert estimate to invoice\n~/skills/qb-cli/run.sh estimate delete 789\n~/skills/qb-cli/run.sh estimate query \"TxnStatus = 'Pending'\"\n\nCredit Memos\n~/skills/qb-cli/run.sh credit-memo list\n~/skills/qb-cli/run.sh credit-memo create --customer-id 123 --amount 200\n~/skills/qb-cli/run.sh credit-memo send 456\n~/skills/qb-cli/run.sh credit-memo void 456\n~/skills/qb-cli/run.sh credit-memo delete 456\n~/skills/qb-cli/run.sh credit-memo query \"TotalAmt > '100'\"\n\nSales Receipts (Cash Sales)\n~/skills/qb-cli/run.sh sales-receipt list\n~/skills/qb-cli/run.sh sales-receipt create --customer-id 123 --amount 750 --deposit-to 35 --payment-method \"Cash\"\n~/skills/qb-cli/run.sh sales-receipt send 456\n~/skills/qb-cli/run.sh sales-receipt void 456\n~/skills/qb-cli/run.sh sales-receipt delete 456\n\nRefund Receipts\n~/skills/qb-cli/run.sh refund-receipt list\n~/skills/qb-cli/run.sh refund-receipt create --customer-id 123 --amount 200 --deposit-from 35\n~/skills/qb-cli/run.sh refund-receipt void 456\n~/skills/qb-cli/run.sh refund-receipt delete 456\n\nVendors (AP)\n# Search (ALWAYS do this first!)\n~/skills/qb-cli/run.sh vendor search \"Office Depot\"\n\n# List\n~/skills/qb-cli/run.sh vendor list\n~/skills/qb-cli/run.sh vendor list --no-active-only\n\n# CRUD\n~/skills/qb-cli/run.sh vendor get 42\n~/skills/qb-cli/run.sh vendor create --name \"Office Depot\" --company \"Office Depot Inc\" --email \"ap@officedepot.com\" --phone \"800-555-1234\" --1099\n~/skills/qb-cli/run.sh vendor create --name \"John the Plumber\" --1099 --tax-id \"123-45-6789\"\n~/skills/qb-cli/run.sh vendor update 42 --email \"new@email.com\" --1099\n~/skills/qb-cli/run.sh vendor delete 42   # soft-delete\n~/skills/qb-cli/run.sh vendor query \"Balance > '0'\"\n\nBills\n~/skills/qb-cli/run.sh bill list\n~/skills/qb-cli/run.sh bill get 100\n~/skills/qb-cli/run.sh bill create --vendor-id 42 --amount 1500 --due-date 2026-03-15\n~/skills/qb-cli/run.sh bill create --vendor-id 42 --amount 800 --account-id 80 --memo \"Office supplies Jan\"\n~/skills/qb-cli/run.sh bill update 100 --json '{\"DueDate\": \"2026-04-01\"}'\n~/skills/qb-cli/run.sh bill delete 100\n~/skills/qb-cli/run.sh bill query \"VendorRef = '42' AND Balance > '0'\"\n\nBill Payments\n~/skills/qb-cli/run.sh bill-payment list\n~/skills/qb-cli/run.sh bill-payment get 200\n~/skills/qb-cli/run.sh bill-payment create --vendor-id 42 --amount 1500 --pay-type Check --account-id 35 --bill-ids \"100,101\" --bill-amounts \"1000,500\" --ref \"1042\"\n~/skills/qb-cli/run.sh bill-payment create --vendor-id 42 --amount 800 --pay-type CreditCard --account-id 41 --bill-ids \"102\"\n~/skills/qb-cli/run.sh bill-payment void 200\n~/skills/qb-cli/run.sh bill-payment delete 200\n~/skills/qb-cli/run.sh bill-payment query \"TxnDate >= '2026-01-01'\"\n\nVendor Credits\n~/skills/qb-cli/run.sh vendor-credit list\n~/skills/qb-cli/run.sh vendor-credit create --vendor-id 42 --amount 150 --account-id 80\n~/skills/qb-cli/run.sh vendor-credit delete 300\n~/skills/qb-cli/run.sh vendor-credit query \"VendorRef = '42'\"\n\nPurchase Orders\n~/skills/qb-cli/run.sh purchase-order list\n~/skills/qb-cli/run.sh purchase-order create --vendor-id 42 --amount 5000 --item-id 10 --memo \"Q2 inventory\"\n~/skills/qb-cli/run.sh purchase-order send 500\n~/skills/qb-cli/run.sh purchase-order to-bill 500   # convert PO to bill\n~/skills/qb-cli/run.sh purchase-order update 500 --json '{\"POStatus\": \"Closed\"}'\n~/skills/qb-cli/run.sh purchase-order delete 500\n\nChart of Accounts\n~/skills/qb-cli/run.sh account list\n~/skills/qb-cli/run.sh account list --type Bank           # filter by type\n~/skills/qb-cli/run.sh account list --type Expense\n~/skills/qb-cli/run.sh account get 35\n~/skills/qb-cli/run.sh account create --name \"Marketing\" --type Expense --sub-type AdvertisingPromotional\n~/skills/qb-cli/run.sh account create --name \"Business Checking\" --type Bank --sub-type Checking --acct-num \"1010\"\n~/skills/qb-cli/run.sh account update 35 --name \"Updated Name\" --description \"New description\"\n~/skills/qb-cli/run.sh account delete 35   # soft-delete (Active=false)\n~/skills/qb-cli/run.sh account query \"AccountType = 'Bank'\"\n\nItems (Products & Services)\n~/skills/qb-cli/run.sh item list\n~/skills/qb-cli/run.sh item list --type Service\n~/skills/qb-cli/run.sh item list --type Inventory\n~/skills/qb-cli/run.sh item get 10\n~/skills/qb-cli/run.sh item create --name \"Consulting\" --type Service --income-account 1 --price 150 --description \"Hourly consulting\"\n~/skills/qb-cli/run.sh item create --name \"Widget\" --type Inventory --income-account 1 --expense-account 80 --asset-account 81 --price 29.99 --cost 12.50 --qty 100 --inv-start-date 2026-01-01\n~/skills/qb-cli/run.sh item update 10 --price 175 --name \"Senior Consulting\"\n~/skills/qb-cli/run.sh item delete 10   # soft-delete\n~/skills/qb-cli/run.sh item query \"Type = 'Service'\"\n\nExpenses (Purchases / Checks / CC Charges)\n~/skills/qb-cli/run.sh expense list\n~/skills/qb-cli/run.sh expense get 400\n~/skills/qb-cli/run.sh expense create --account-id 35 --pay-type Check --vendor-id 42 --amount 250 --doc-number \"1042\" --memo \"Office supplies\"\n~/skills/qb-cli/run.sh expense create --account-id 41 --pay-type CreditCard --amount 99.99 --memo \"Software subscription\"\n~/skills/qb-cli/run.sh expense update 400 --json '{\"PrivateNote\": \"Updated memo\"}'\n~/skills/qb-cli/run.sh expense delete 400\n~/skills/qb-cli/run.sh expense query \"TxnDate >= '2026-01-01' AND TxnDate <= '2026-01-31'\"\n\nJournal Entries\n~/skills/qb-cli/run.sh journal list\n~/skills/qb-cli/run.sh journal get 500\n~/skills/qb-cli/run.sh journal create --lines '[{\"account_id\":\"80\",\"amount\":500,\"type\":\"Debit\",\"description\":\"Depreciation exp\"},{\"account_id\":\"35\",\"amount\":500,\"type\":\"Credit\",\"description\":\"Accum depreciation\"}]' --date 2026-01-31 --memo \"Jan depreciation\"\n~/skills/qb-cli/run.sh journal delete 500\n~/skills/qb-cli/run.sh journal query \"TxnDate = '2026-01-31'\"\n\nDeposits\n~/skills/qb-cli/run.sh deposit list\n~/skills/qb-cli/run.sh deposit get 600\n~/skills/qb-cli/run.sh deposit create --account-id 35 --payment-ids \"182,183,184\" --date 2026-02-15 --memo \"Week of 2/15 deposits\"\n~/skills/qb-cli/run.sh deposit delete 600\n~/skills/qb-cli/run.sh deposit query \"TxnDate >= '2026-02-01'\"\n\nTransfers\n~/skills/qb-cli/run.sh transfer list\n~/skills/qb-cli/run.sh transfer get 700\n~/skills/qb-cli/run.sh transfer create --from 35 --to 36 --amount 10000 --date 2026-02-01 --memo \"Move to savings\"\n~/skills/qb-cli/run.sh transfer delete 700\n\nFinancial Reports\n\nAll reports support -o json (default), -o table, -o csv.\n\n# Income Statement\n~/skills/qb-cli/run.sh report profit-and-loss --start-date 2026-01-01 --end-date 2026-01-31\n~/skills/qb-cli/run.sh report profit-and-loss --period \"Last Month\"\n~/skills/qb-cli/run.sh report profit-and-loss --start-date 2026-01-01 --end-date 2026-12-31 --summarize-by Month\n~/skills/qb-cli/run.sh report profit-and-loss-detail --start-date 2026-01-01 --end-date 2026-01-31\n\n# Balance Sheet\n~/skills/qb-cli/run.sh report balance-sheet --date 2026-01-31\n~/skills/qb-cli/run.sh report balance-sheet --period \"This Fiscal Year\"\n\n# Cash Flow\n~/skills/qb-cli/run.sh report cash-flow --start-date 2026-01-01 --end-date 2026-01-31\n\n# Trial Balance\n~/skills/qb-cli/run.sh report trial-balance --date 2026-01-31\n\n# General Ledger\n~/skills/qb-cli/run.sh report general-ledger --start-date 2026-01-01 --end-date 2026-01-31 --account 35\n\n# AR/AP Aging\n~/skills/qb-cli/run.sh report ar-aging\n~/skills/qb-cli/run.sh report ar-aging-detail --customer 123\n~/skills/qb-cli/run.sh report ap-aging\n~/skills/qb-cli/run.sh report ap-aging-detail --vendor 42\n\n# Balance Reports\n~/skills/qb-cli/run.sh report customer-balance\n~/skills/qb-cli/run.sh report vendor-balance\n\n# Income/Expense Analysis\n~/skills/qb-cli/run.sh report customer-income --start-date 2026-01-01 --end-date 2026-12-31\n~/skills/qb-cli/run.sh report vendor-expenses --start-date 2026-01-01 --end-date 2026-12-31\n\n# Transaction List\n~/skills/qb-cli/run.sh report transaction-list --start-date 2026-01-01 --end-date 2026-01-31\n\n# Tax Summary\n~/skills/qb-cli/run.sh report tax-summary --start-date 2026-01-01 --end-date 2026-12-31\n\nBank Statement Import\n# Preview a statement file (no changes to QB)\n~/skills/qb-cli/run.sh import preview /workspace/statement.ofx\n~/skills/qb-cli/run.sh import preview /workspace/statement.csv --date-col \"Trans Date\" --amount-col \"Amount\" --desc-col \"Description\"\n\n# Import and match (dry run first!)\n~/skills/qb-cli/run.sh import bank /workspace/statement.ofx --account-id 35 --dry-run\n~/skills/qb-cli/run.sh import bank /workspace/statement.ofx --account-id 35\n\n# CSV import with custom columns\n~/skills/qb-cli/run.sh import bank /workspace/statement.csv --account-id 35 --format csv --date-col \"Date\" --amount-col \"Amount\" --desc-col \"Payee\" --dry-run\n\n\nSupported formats: OFX, QFX, QBO, CSV (with configurable column mapping).\n\nMatching algorithm:\n\nExact match — same amount AND same date AND (matching FITID or check number) → skipped\nProbable match — same amount AND date within ±3 days → flagged for review\nNo match → created as Purchase (debit) or Deposit (credit)\nBank Reconciliation\n# Start reconciliation session\n~/skills/qb-cli/run.sh reconcile start --account-id 35 --statement-date 2026-01-31 --statement-balance 45000.00\n\n# Check status\n~/skills/qb-cli/run.sh reconcile status --account-id 35\n\n# Match statement against QB\n~/skills/qb-cli/run.sh reconcile match --account-id 35 --statement-file /workspace/jan-statement.ofx\n\n# Generate reconciliation report\n~/skills/qb-cli/run.sh reconcile report --account-id 35 --start-date 2026-01-01 --end-date 2026-01-31\n\n\nNote: These are helper commands. QB has no reconciliation API — you cannot programmatically mark transactions as reconciled. Use these to identify matches and discrepancies, then complete the reconciliation in the QB UI.\n\nBookkeeping Workflows\n# Month-end close checklist\n~/skills/qb-cli/run.sh workflow month-close --month 2026-01 --check-only   # just run checks\n~/skills/qb-cli/run.sh workflow month-close --month 2026-01                # checks + generate reports\n\n# 1099 preparation\n~/skills/qb-cli/run.sh workflow 1099-prep --year 2025\n~/skills/qb-cli/run.sh workflow 1099-prep --year 2025 --threshold 600\n\n# AR follow-up (overdue invoices grouped by customer)\n~/skills/qb-cli/run.sh workflow ar-followup --days-overdue 30\n~/skills/qb-cli/run.sh workflow ar-followup --days-overdue 60\n\n# Undeposited funds check\n~/skills/qb-cli/run.sh workflow undeposited-funds\n\n\nMonth-end close runs these checks:\n\nUndeposited Funds balance (should be ~$0)\nOverdue AR (invoices past due before month start)\nOverdue AP (bills past due before month start)\nOpen invoices for the month\n\nThen generates P&L, Balance Sheet, and Trial Balance to /workspace/.\n\nBatch Operations\n# Run batch operations from a JSON file (max 30 per batch, auto-chunks)\n~/skills/qb-cli/run.sh batch run --file /workspace/batch_ops.json\n\n\nBatch file format:\n\n[\n  {\"operation\": \"create\", \"entity\": \"Customer\", \"body\": {\"DisplayName\": \"New Customer\"}},\n  {\"operation\": \"query\", \"sql\": \"SELECT * FROM Invoice WHERE Balance > '0'\"},\n  {\"operation\": \"delete\", \"entity\": \"Invoice\", \"id\": \"123\", \"sync_token\": \"0\"}\n]\n\nCompany Preferences\n~/skills/qb-cli/run.sh preferences show\n~/skills/qb-cli/run.sh preferences update --json '{\"AccountingInfoPrefs\": {\"BookCloseDate\": \"2025-12-31\"}}'\n\nTax\n~/skills/qb-cli/run.sh tax codes\n~/skills/qb-cli/run.sh tax rates\n~/skills/qb-cli/run.sh tax summary --start-date 2026-01-01 --end-date 2026-12-31\n\nAttachments\n~/skills/qb-cli/run.sh attachment list --entity-type Invoice --entity-id 456\n~/skills/qb-cli/run.sh attachment get 800\n~/skills/qb-cli/run.sh attachment upload --entity-type Invoice --entity-id 456 --file /workspace/receipt.pdf\n~/skills/qb-cli/run.sh attachment note --entity-type Invoice --entity-id 456 --text \"Approved by CFO 2/15\"\n~/skills/qb-cli/run.sh attachment delete 800\n\nAgent Workflow Guides\nProcessing a Vendor Bill\n1. vendor search \"Vendor Name\"           → find or create vendor\n2. bill create --vendor-id X --amount $  → record the bill\n3. bill-payment create --vendor-id X --amount $ --pay-type Check --account-id Y --bill-ids Z\n                                          → pay the bill when ready\n\nSending an Invoice\n1. customer search \"Customer Name\"        → find existing customer\n2. invoice create --customer-id X --amount $ --due-date YYYY-MM-DD\n3. (confirm with user before sending)\n4. invoice send <id>                      → only if user explicitly requests\n\nConverting Estimate to Invoice\n1. estimate create --customer-id X --amount $ --expiration-date YYYY-MM-DD\n2. estimate send <id>                     → send to customer for review\n3. (once accepted)\n4. estimate to-invoice <id>               → creates linked invoice\n\nMonth-End Close\n1. workflow month-close --month YYYY-MM --check-only    → review issues\n2. (fix any warnings: deposit undeposited funds, follow up on AR, etc.)\n3. journal create --lines '[...]' --date YYYY-MM-DD     → adjusting entries\n4. workflow month-close --month YYYY-MM                 → generate reports\n5. report profit-and-loss --start-date ... --end-date ...  → final P&L\n6. report balance-sheet --date YYYY-MM-DD               → final BS\n\nBank Reconciliation\n1. import preview /workspace/statement.ofx              → inspect transactions\n2. import bank /workspace/statement.ofx --account-id X --dry-run  → preview matches\n3. import bank /workspace/statement.ofx --account-id X  → create unmatched\n4. reconcile start --account-id X --statement-date ... --statement-balance $\n5. reconcile match --account-id X --statement-file /workspace/statement.ofx\n6. (review matches, investigate discrepancies)\n7. reconcile report --account-id X --start-date ... --end-date ...\n\n1099 Year-End Prep\n1. workflow 1099-prep --year YYYY         → identify vendors over threshold\n2. (review missing TINs — flag them for user)\n3. vendor update <id> --tax-id \"XX-XXXXXXX\"  → add missing TINs\n4. (CSV exported to /workspace/1099_prep_YYYY.csv for filing software)\n\nAgent Integration Notes\n\nExit codes:\n\n0 — Success\n1 — API error (bad request, server error)\n2 — Configuration error (missing config)\n3 — Authentication error (expired/invalid tokens)\n4 — Not found\n5 — Validation error (missing required arguments)\n\nError format:\n\n{\"error\": true, \"code\": 3, \"message\": \"Not authenticated\", \"hint\": \"qb auth login\"}\n\n\nKey behaviors:\n\nToken refresh is automatic — no manual refresh needed\nSyncToken is auto-fetched before update/delete operations\nAccount entity requires full update (not sparse) — handled automatically\nSoft-delete for name-list entities (customer, vendor, account, item) uses Active: false\nHard delete for transactions (invoice, bill, payment, etc.) uses operation=delete\nVoid for transactions zeros amounts but keeps the record\nQuickBooks uses SQL-like queries: SELECT * FROM Customer WHERE Balance > '0'\nQuery operators: =, LIKE, <, >, <=, >=, IN\nDate format: YYYY-MM-DD\nReports return hierarchical JSON with Header/Columns/Rows\nWorkspace directory at /workspace/ (mapped to ~/skills/qb-cli/workspace/ on host)\n\nCommand group count (29 groups, 164 commands): auth, config, company, customer, invoice, payment, estimate, credit-memo, sales-receipt, refund-receipt, vendor, bill, bill-payment, vendor-credit, purchase-order, account, item, expense, journal, deposit, transfer, report, import, reconcile, workflow, batch, preferences, tax, attachment\n\nQB query limitations:\n\nVendor1099 is not queryable via SQL — use vendor list and filter client-side\nOR is not supported — searches run multiple queries and deduplicate\nPhone fields are not indexable via LIKE — search falls back to client-side filter\nString values in queries must be single-quoted: WHERE Balance > '0'"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/paulbudveit/quickbooks-online",
    "publisherUrl": "https://clawhub.ai/paulbudveit/quickbooks-online",
    "owner": "paulbudveit",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/quickbooks-online",
    "downloadUrl": "https://openagent3.xyz/downloads/quickbooks-online",
    "agentUrl": "https://openagent3.xyz/skills/quickbooks-online/agent",
    "manifestUrl": "https://openagent3.xyz/skills/quickbooks-online/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/quickbooks-online/agent.md"
  }
}