shortcutxl 0.2.0

package/skills/integrations/visible-alpha.md

@@ -0,0 +1,320 @@
+**Visible Alpha Excel Formula Guide**
+
+**Intro**
+You have full access to Visible Alpha consensus estimates data through the native Excel Add-in, but you should only pull Visible Alpha data **when the user explicitly tells you to**. Visible Alpha aggregates detailed analyst estimates from sell-side research, providing granular consensus data for revenue segments, KPIs, and financial metrics. You can retrieve any data point by writing VA formulas directly in Excel cells.
+
+**IMPORTANT:** Before completing a task involving Visible Alpha, you must verify:
+1. Your VAData and VAdetail formulas do not return errors.
+2. All values should seem reasonable and make intuitive sense based on your general knowledge of analyst estimates.
+3. Use cell references for tickers and parameters when possible as opposed to hardcoded values.
+4. Be aware that coverage varies by company - large caps have more detail than small caps.
+5. Some custom line items may require user help to identify correct field IDs.
+
+You should essentially gut check every value that shows up. If there are any errors or the values seem wrong, you likely wrote the formula syntax incorrectly or are using invalid line item IDs. Please correct the formula until it outputs the proper value.
+
+**Note:** Visible Alpha is a Pattern B integration. While most standard metrics work directly, some company-specific or custom fields may require the user to look up field IDs in the Visible Alpha platform.
+
+---
+
+**Visible Alpha Excel Functions Overview**
+
+Visible Alpha provides these main Excel functions:
+
+| Function | Purpose | Use Case |
+|----------|---------|----------|
+| VAData | Consensus estimates | Line item data for any period |
+| VAdetail | Estimate details | Contributor-level data, high/low/mean |
+| VACompany | Company information | Metadata about coverage |
+| VAContributor | Broker details | Information about contributing analysts |
+
+---
+
+**1. VAData - Consensus Estimates**
+
+Returns consensus estimate data for a specific line item and period.
+
+**Syntax:** =VAData("Ticker", "Period", "LineItem", "Source", "DataType")
+
+**Parameters:**
+| Parameter | Description | Required |
+|-----------|-------------|----------|
+| Ticker | Stock ticker symbol | Yes |
+| Period | Time period (see Period section) | Yes |
+| LineItem | Line item ID or name | Yes |
+| Source | Data source (Consensus, Custom, broker) | No (default: Consensus) |
+| DataType | STD (standardized) or NMV (native) | No (default: STD) |
+
+**Examples:**
+=VAData("AAPL", "Q0", "190", "Consensus", "STD")
+-> Apple's current quarter consensus revenue.
+
+=VAData("MSFT", "Y0", "217", "Consensus", "STD")
+-> Microsoft's current year consensus net income.
+
+=VAData("GOOGL", "Q+1", "219")
+-> Alphabet's next quarter consensus diluted EPS.
+
+**Using Cell References:**
+=VAData(A1, "Y0", "190")
+-> Revenue for ticker in cell A1.
+
+=VAData("AAPL", B1, "190")
+-> Apple revenue for period in cell B1.
+
+---
+
+**2. VAdetail - Estimate Details**
+
+Returns detailed estimate information including contributor-level data.
+
+**Syntax:** =VAdetail("Property", "Ticker", "Source", "Period")
+
+**Properties:**
+| Property | Description |
+|----------|-------------|
+| Mean | Average estimate |
+| Median | Median estimate |
+| High | Highest estimate |
+| Low | Lowest estimate |
+| StdDev | Standard deviation |
+| NumEst | Number of estimates |
+| LastUpdate | Last update date |
+
+**Examples:**
+=VAdetail("High", "AAPL", "Consensus", "Y0")
+-> Highest estimate for Apple current year.
+
+=VAdetail("Low", "MSFT", "Consensus", "Q+1")
+-> Lowest estimate for Microsoft next quarter.
+
+=VAdetail("NumEst", "GOOGL", "Consensus", "Y0")
+-> Number of analysts covering Google.
+
+---
+
+**3. Period Specification**
+
+**Relative Periods:**
+| Period | Description |
+|--------|-------------|
+| Q0 | Current fiscal quarter |
+| Q+1 | Next fiscal quarter |
+| Q+2 | Two quarters ahead |
+| Q-1 | Prior fiscal quarter |
+| Y0 | Current fiscal year |
+| Y+1 | Next fiscal year |
+| Y+2 | Two years ahead |
+| Y-1 | Prior fiscal year |
+
+**Absolute Periods:**
+| Period | Description |
+|--------|-------------|
+| Q1-2024 | Q1 of fiscal 2024 |
+| Q2-2024 | Q2 of fiscal 2024 |
+| 3QFY-2024 | Third quarter of FY2024 |
+| FY-2024 | Fiscal year 2024 |
+
+**Semi-Annual:**
+| Period | Description |
+|--------|-------------|
+| H1-2024 | First half 2024 |
+| H2-2024 | Second half 2024 |
+
+---
+
+**4. Standardized Line Item IDs**
+
+Visible Alpha uses numeric IDs for standardized line items. These work across all covered companies.
+
+**Income Statement:**
+| ID | Line Item |
+|----|-----------|
+| 190 | Total Revenue |
+| 191 | Product Revenue |
+| 192 | Service Revenue |
+| 193 | Other Revenue |
+| 194 | Gross Profit |
+| 195 | Cost of Goods Sold |
+| 200 | Operating Expenses |
+| 201 | R&D Expense |
+| 202 | SG&A Expense |
+| 204 | Operating Income (EBIT) |
+| 205 | EBITDA |
+| 210 | Interest Expense |
+| 211 | Interest Income |
+| 215 | Pre-tax Income |
+| 216 | Tax Expense |
+| 217 | Net Income |
+| 218 | EPS (Basic) |
+| 219 | EPS (Diluted) |
+
+**Profitability:**
+| ID | Line Item |
+|----|-----------|
+| 4250 | EBITDA |
+| 4251 | Adjusted EBITDA |
+| 4260 | EBIT |
+| 4261 | Adjusted EBIT |
+| 4441 | Free Cash Flow |
+| 4442 | Operating Cash Flow |
+
+**Per Share:**
+| ID | Line Item |
+|----|-----------|
+| 218 | EPS Basic |
+| 219 | EPS Diluted |
+| 220 | Adjusted EPS |
+| 230 | Dividends Per Share |
+| 231 | Book Value Per Share |
+
+**Margins (as %):**
+| ID | Line Item |
+|----|-----------|
+| 300 | Gross Margin |
+| 301 | Operating Margin |
+| 302 | EBITDA Margin |
+| 303 | Net Margin |
+
+**Balance Sheet:**
+| ID | Line Item |
+|----|-----------|
+| 500 | Total Assets |
+| 501 | Cash & Equivalents |
+| 510 | Total Debt |
+| 520 | Shareholders' Equity |
+| 530 | Net Debt |
+
+**Cash Flow:**
+| ID | Line Item |
+|----|-----------|
+| 600 | Operating Cash Flow |
+| 610 | Capital Expenditures |
+| 620 | Free Cash Flow |
+| 630 | Dividends Paid |
+
+---
+
+**5. Data Source Options**
+
+| Source | Description |
+|--------|-------------|
+| Consensus | Aggregated estimate from all contributors |
+| Custom | User's custom model (if configured) |
+| [Broker Name] | Specific broker's estimate (e.g., "Goldman Sachs") |
+
+---
+
+**6. Example Formulas by Use Case**
+
+**Revenue Estimates:**
+=VAData("AAPL", "Q0", "190")
+-> Apple current quarter revenue consensus.
+
+=VAData("MSFT", "Y+1", "190")
+-> Microsoft next year revenue estimate.
+
+=VAData("AMZN", "Q+1", "191")
+-> Amazon next quarter product revenue.
+
+**Earnings Estimates:**
+=VAData("AAPL", "Y0", "219")
+-> Apple current year diluted EPS consensus.
+
+=VAData("GOOGL", "Q0", "217")
+-> Google current quarter net income.
+
+=VAData("META", "Y+1", "220")
+-> Meta next year adjusted EPS.
+
+**EBITDA & Profitability:**
+=VAData("NVDA", "Y0", "4250")
+-> NVIDIA current year EBITDA.
+
+=VAData("TSLA", "Y0", "302")
+-> Tesla EBITDA margin estimate.
+
+**Estimate Ranges:**
+=VAdetail("High", "AAPL", "Consensus", "Y0")
+-> Apple highest estimate.
+
+=VAdetail("Low", "AAPL", "Consensus", "Y0")
+-> Apple lowest estimate.
+
+=VAdetail("High", "AAPL", "Consensus", "Y0") - VAdetail("Low", "AAPL", "Consensus", "Y0")
+-> Apple estimate spread.
+
+**Analyst Coverage:**
+=VAdetail("NumEst", "AAPL", "Consensus", "Y0")
+-> Number of analysts covering Apple.
+
+=VAdetail("LastUpdate", "MSFT", "Consensus", "Y0")
+-> Date of last estimate update.
+
+**Multi-Period Analysis:**
+=VAData("AAPL", "Y0", "190") / VAData("AAPL", "Y-1", "190") - 1
+-> Apple YoY revenue growth estimate.
+
+**Segment Revenue (if available):**
+=VAData("AAPL", "Y0", "191")
+-> Apple product revenue estimate.
+
+=VAData("AAPL", "Y0", "192")
+-> Apple services revenue estimate.
+
+---
+
+**7. Company-Specific Line Items**
+
+Beyond standardized line items, Visible Alpha tracks company-specific KPIs and segment data. These vary by company and may require looking up the field ID in the platform.
+
+**Common Company-Specific Metrics:**
+| Type | Examples |
+|------|----------|
+| Segment Revenue | iPhone, Mac, iPad, Services (Apple) |
+| KPIs | Monthly Active Users, ARPU, Subscribers |
+| Unit Economics | Gross Merchandise Value, Take Rate |
+| Operating Metrics | Store Count, Same-Store Sales |
+
+**To find custom field IDs:**
+1. Open Visible Alpha platform
+2. Navigate to company page
+3. Find the line item in the estimates table
+4. Note the field ID or use the Excel Field Picker
+
+---
+
+**8. Error Handling**
+
+**Common Errors:**
+| Error | Cause | Solution |
+|-------|-------|----------|
+| #VALUE! | Invalid ticker | Verify ticker symbol |
+| #N/A | No coverage | Company may not be covered |
+| #REF! | Invalid line item | Check line item ID exists |
+| 0 or blank | No estimate | Period may not have estimates yet |
+| Wrong value | Wrong data type | Try STD vs NMV parameter |
+
+**Debugging Tips:**
+1. Verify company coverage on Visible Alpha platform
+2. Check line item ID is valid (use standardized IDs first)
+3. Ensure period format is correct (Q0, Y0, Q1-2024, etc.)
+4. For company-specific fields, look up ID in platform
+5. Try Consensus source before specific brokers
+
+---
+
+**Final Checklist:**
+- Is the ticker covered by Visible Alpha?
+- What line item is needed? (Use standardized ID if possible)
+- What period? (Current Q0/Y0, future Q+1/Y+1, absolute Q1-2024)
+- Is this consensus or a specific broker's estimate?
+- For custom/segment data, do you have the correct field ID?
+- Is the Visible Alpha add-in connected?
+
+---
+
+**Additional Resources:**
+- Visible Alpha Platform: https://www.visiblealpha.com/
+- Excel Add-in Guide: https://support.visiblealpha.com/hc/en-us/articles/115000909168
+- API Documentation: https://www.visiblealpha.com/api-documentation
+- Field Reference: Available within Visible Alpha platform

package/skills/integrations/xero.md

@@ -0,0 +1,393 @@
+**Xero Excel Formula Guide**
+
+**Intro**
+You have full access to Xero accounting data through Scott's Add-in for Excel, but you should only pull Xero data **when the user explicitly tells you to**. Scott's Add-in provides direct Excel formulas to retrieve general ledger balances, contacts, invoices, bills, bank transactions, and more. You can retrieve any data point by writing SCOTT formulas directly in Excel cells.
+
+**IMPORTANT:** Before completing a task involving Xero, you must verify:
+1. Your SCOTT formulas do not return errors.
+2. All values should seem reasonable and make intuitive sense based on your general knowledge of accounting.
+3. Use cell references for account codes and parameters when possible as opposed to hardcoded values.
+4. Be aware that Xero API has rate limits; avoid excessive formula refreshes.
+5. Account codes must match exactly as configured in Xero chart of accounts.
+
+You should essentially gut check every value that shows up. If there are any errors or the values seem wrong, you likely wrote the formula syntax incorrectly or are using invalid account codes. Please correct the formula until it outputs the proper value.
+
+---
+
+**Scott's Add-in Functions Overview**
+
+Scott's Add-in provides several Excel functions for Xero:
+
+| Function | Purpose | Use Case |
+|----------|---------|----------|
+| SCOTT.GL | General Ledger | Account balances, names, types |
+| SCOTT.CONTACTS | Contacts | Customer and supplier information |
+| SCOTT.INVOICES | Invoices | Sales invoice data |
+| SCOTT.BILLS | Bills | Purchase bill data |
+| SCOTT.BANKBALANCE | Bank | Bank account balances |
+| SCOTT.BANKTRANSACTIONS | Bank | Bank transaction details |
+| SCOTT.PAYMENTS | Payments | Payment records |
+| SCOTT.QUOTES | Quotes | Sales quote data |
+| SCOTT.PURCHASEORDERS | Purchase Orders | PO data |
+| SCOTT.ITEMS | Items | Inventory items |
+| SCOTT.TRACKING | Tracking | Tracking category data |
+
+---
+
+**1. SCOTT.GL - General Ledger**
+
+Returns general ledger account data including balances.
+
+**Syntax:** =SCOTT.GL("AccountCode", "Field")
+
+**Fields:**
+| Field | Description |
+|-------|-------------|
+| Balance | Current account balance |
+| Name | Account name |
+| Code | Account code |
+| Type | Account type (REVENUE, EXPENSE, etc.) |
+| Class | Account class (ASSET, LIABILITY, EQUITY, REVENUE, EXPENSE) |
+| Status | ACTIVE or ARCHIVED |
+| Description | Account description |
+| TaxType | Default tax type |
+| YTDBalance | Year-to-date balance |
+| ReportingCode | Reporting code for financial statements |
+
+**Examples:**
+=SCOTT.GL("200", "Balance")
+-> Balance for account code 200.
+
+=SCOTT.GL("200", "Name")
+-> Name of account 200.
+
+=SCOTT.GL("400", "YTDBalance")
+-> Year-to-date balance for account 400.
+
+**Using Cell References:**
+=SCOTT.GL(A1, "Balance")
+-> Balance for account code in cell A1.
+
+=SCOTT.GL("200", B1)
+-> Field specified in cell B1 for account 200.
+
+---
+
+**2. SCOTT.CONTACTS - Contacts**
+
+Returns customer and supplier contact information.
+
+**Syntax:** =SCOTT.CONTACTS("Field1", "Field2", ..., [FilterField], [FilterValue])
+
+**Fields:**
+| Field | Description |
+|-------|-------------|
+| ContactID | Unique contact identifier |
+| Name | Contact/company name |
+| FirstName | First name |
+| LastName | Last name |
+| EmailAddress | Primary email |
+| AccountNumber | Account reference number |
+| ContactStatus | ACTIVE or ARCHIVED |
+| IsSupplier | TRUE if supplier |
+| IsCustomer | TRUE if customer |
+| DefaultCurrency | Default currency code |
+| Phone | Primary phone number |
+| Fax | Fax number |
+| Mobile | Mobile phone |
+| Website | Website URL |
+| TaxNumber | Tax/VAT number |
+| BankAccountDetails | Bank account info |
+| BalanceDue | Outstanding balance |
+| OverdueAmount | Overdue amount |
+
+**Examples:**
+=SCOTT.CONTACTS("Name", "EmailAddress", "Phone")
+-> List all contacts with name, email, and phone.
+
+=SCOTT.CONTACTS("Name", "BalanceDue", "IsCustomer", TRUE)
+-> All customers with outstanding balances.
+
+=SCOTT.CONTACTS("Name", "OverdueAmount", "IsSupplier", TRUE)
+-> All suppliers with overdue amounts.
+
+---
+
+**3. SCOTT.INVOICES - Sales Invoices**
+
+Returns sales invoice data.
+
+**Syntax:** =SCOTT.INVOICES("Field1", "Field2", ..., [FilterField], [FilterValue])
+
+**Fields:**
+| Field | Description |
+|-------|-------------|
+| InvoiceID | Unique invoice identifier |
+| InvoiceNumber | Invoice reference number |
+| ContactName | Customer name |
+| Date | Invoice date |
+| DueDate | Payment due date |
+| Status | DRAFT, SUBMITTED, AUTHORISED, PAID, VOIDED |
+| SubTotal | Subtotal before tax |
+| TotalTax | Total tax amount |
+| Total | Invoice total |
+| AmountDue | Remaining balance |
+| AmountPaid | Amount paid |
+| AmountCredited | Credits applied |
+| CurrencyCode | Currency |
+| Reference | Reference field |
+| LineItems | Line item details |
+
+**Examples:**
+=SCOTT.INVOICES("InvoiceNumber", "ContactName", "Total", "AmountDue")
+-> All invoices with key fields.
+
+=SCOTT.INVOICES("InvoiceNumber", "ContactName", "AmountDue", "Status", "AUTHORISED")
+-> Unpaid authorized invoices.
+
+=SCOTT.INVOICES("ContactName", "Total", "Date", "DueDate", "AmountDue", "Status", "AUTHORISED")
+-> Detailed AR report for authorized invoices.
+
+---
+
+**4. SCOTT.BILLS - Purchase Bills**
+
+Returns accounts payable bill data.
+
+**Syntax:** =SCOTT.BILLS("Field1", "Field2", ..., [FilterField], [FilterValue])
+
+**Fields:**
+| Field | Description |
+|-------|-------------|
+| InvoiceID | Unique bill identifier |
+| InvoiceNumber | Bill/reference number |
+| ContactName | Supplier name |
+| Date | Bill date |
+| DueDate | Payment due date |
+| Status | DRAFT, SUBMITTED, AUTHORISED, PAID, VOIDED |
+| SubTotal | Subtotal before tax |
+| TotalTax | Total tax amount |
+| Total | Bill total |
+| AmountDue | Remaining balance |
+| AmountPaid | Amount paid |
+| CurrencyCode | Currency |
+| Reference | Reference field |
+
+**Examples:**
+=SCOTT.BILLS("InvoiceNumber", "ContactName", "Total", "AmountDue")
+-> All bills with key fields.
+
+=SCOTT.BILLS("ContactName", "DueDate", "AmountDue", "Status", "AUTHORISED")
+-> Unpaid bills with due dates.
+
+---
+
+**5. SCOTT.BANKBALANCE - Bank Balances**
+
+Returns current bank account balances.
+
+**Syntax:** =SCOTT.BANKBALANCE("AccountCode")
+
+**Example:**
+=SCOTT.BANKBALANCE("090")
+-> Current balance for bank account 090.
+
+---
+
+**6. SCOTT.BANKTRANSACTIONS - Bank Transactions**
+
+Returns bank transaction details.
+
+**Syntax:** =SCOTT.BANKTRANSACTIONS("Field1", "Field2", ..., [FilterField], [FilterValue])
+
+**Fields:**
+| Field | Description |
+|-------|-------------|
+| BankTransactionID | Unique transaction ID |
+| Type | RECEIVE, SPEND, RECEIVE-OVERPAYMENT, etc. |
+| ContactName | Contact name |
+| Date | Transaction date |
+| Status | AUTHORISED, DELETED |
+| SubTotal | Amount before tax |
+| TotalTax | Tax amount |
+| Total | Total amount |
+| Reference | Reference field |
+| IsReconciled | TRUE if reconciled |
+| BankAccountCode | Bank account code |
+
+**Examples:**
+=SCOTT.BANKTRANSACTIONS("Date", "Type", "ContactName", "Total", "Reference")
+-> All bank transactions with key fields.
+
+=SCOTT.BANKTRANSACTIONS("Date", "ContactName", "Total", "Type", "RECEIVE")
+-> Money received transactions only.
+
+---
+
+**7. SCOTT.PAYMENTS - Payments**
+
+Returns payment records.
+
+**Syntax:** =SCOTT.PAYMENTS("Field1", "Field2", ..., [FilterField], [FilterValue])
+
+**Fields:**
+| Field | Description |
+|-------|-------------|
+| PaymentID | Unique payment ID |
+| Date | Payment date |
+| Amount | Payment amount |
+| Reference | Reference field |
+| PaymentType | ACCRECPAYMENT, ACCPAYPAYMENT, etc. |
+| Status | AUTHORISED, DELETED |
+| InvoiceNumber | Related invoice number |
+| ContactName | Contact name |
+
+---
+
+**8. Xero Account Types Reference**
+
+**Account Classes:**
+| Class | Description |
+|-------|-------------|
+| ASSET | Assets (bank, receivables, inventory, fixed assets) |
+| LIABILITY | Liabilities (payables, loans, accruals) |
+| EQUITY | Equity (capital, retained earnings) |
+| REVENUE | Income accounts |
+| EXPENSE | Expense accounts |
+
+**Account Types:**
+| Type | Class | Description |
+|------|-------|-------------|
+| BANK | ASSET | Bank accounts |
+| CURRENT | ASSET | Current assets (receivables, inventory) |
+| FIXED | ASSET | Fixed assets |
+| PREPAYMENT | ASSET | Prepaid expenses |
+| CURRLIAB | LIABILITY | Current liabilities |
+| TERMLIAB | LIABILITY | Long-term liabilities |
+| EQUITY | EQUITY | Equity accounts |
+| REVENUE | REVENUE | Sales/income accounts |
+| DIRECTCOSTS | EXPENSE | Cost of goods sold |
+| EXPENSE | EXPENSE | Operating expenses |
+| OVERHEADS | EXPENSE | Overhead expenses |
+
+---
+
+**9. Standard Xero Account Codes**
+
+**Common Default Codes (may vary by organization):**
+| Code | Account Name | Type |
+|------|-------------|------|
+| 090 | Business Bank Account | BANK |
+| 091 | Business Savings Account | BANK |
+| 200 | Sales | REVENUE |
+| 260 | Other Revenue | REVENUE |
+| 300 | Purchases | DIRECTCOSTS |
+| 310 | Cost of Goods Sold | DIRECTCOSTS |
+| 400 | Advertising | EXPENSE |
+| 404 | Bank Fees | EXPENSE |
+| 408 | Cleaning | EXPENSE |
+| 412 | Consulting & Accounting | EXPENSE |
+| 420 | Entertainment | EXPENSE |
+| 429 | General Expenses | EXPENSE |
+| 449 | Office Expenses | EXPENSE |
+| 461 | Printing & Stationery | EXPENSE |
+| 469 | Rent | EXPENSE |
+| 473 | Subscriptions | EXPENSE |
+| 477 | Telephone & Internet | EXPENSE |
+| 489 | Travel | EXPENSE |
+| 493 | Wages & Salaries | EXPENSE |
+| 500 | Accounts Receivable | CURRENT |
+| 610 | Accounts Payable | CURRLIAB |
+| 800 | Owner's Capital | EQUITY |
+| 820 | Retained Earnings | EQUITY |
+
+---
+
+**10. Example Formulas by Use Case**
+
+**Financial Position:**
+=SCOTT.GL("090", "Balance")
+-> Main bank account balance.
+
+=SCOTT.GL("500", "Balance")
+-> Accounts receivable balance.
+
+=SCOTT.GL("610", "Balance")
+-> Accounts payable balance.
+
+**Revenue & Expenses:**
+=SCOTT.GL("200", "YTDBalance")
+-> Year-to-date sales revenue.
+
+=SCOTT.GL("493", "YTDBalance")
+-> Year-to-date wages expense.
+
+**Accounts Receivable:**
+=SCOTT.INVOICES("InvoiceNumber", "ContactName", "Date", "DueDate", "AmountDue", "Status", "AUTHORISED")
+-> AR aging report (unpaid invoices).
+
+=SCOTT.CONTACTS("Name", "BalanceDue", "OverdueAmount", "IsCustomer", TRUE)
+-> Customer balances with overdue amounts.
+
+**Accounts Payable:**
+=SCOTT.BILLS("InvoiceNumber", "ContactName", "Date", "DueDate", "AmountDue", "Status", "AUTHORISED")
+-> AP aging report (unpaid bills).
+
+=SCOTT.CONTACTS("Name", "BalanceDue", "OverdueAmount", "IsSupplier", TRUE)
+-> Supplier balances with overdue amounts.
+
+**Cash Flow:**
+=SCOTT.BANKTRANSACTIONS("Date", "Type", "ContactName", "Total", "Type", "RECEIVE")
+-> Cash receipts.
+
+=SCOTT.BANKTRANSACTIONS("Date", "Type", "ContactName", "Total", "Type", "SPEND")
+-> Cash payments.
+
+=SCOTT.PAYMENTS("Date", "ContactName", "Amount", "InvoiceNumber")
+-> Payment details with invoice references.
+
+**Contact Management:**
+=SCOTT.CONTACTS("Name", "EmailAddress", "Phone", "BalanceDue")
+-> Contact list with balances.
+
+=SCOTT.CONTACTS("Name", "AccountNumber", "DefaultCurrency", "IsCustomer", TRUE)
+-> Customer master list.
+
+---
+
+**11. Error Handling**
+
+**Common Errors:**
+| Error | Cause | Solution |
+|-------|-------|----------|
+| #VALUE! | Invalid account code | Verify code exists in Xero chart of accounts |
+| #NAME? | Function not recognized | Check Scott's Add-in is installed and enabled |
+| #N/A | No data found | Verify filter values, check data exists |
+| Connection error | Not authenticated | Re-authenticate in Scott's Add-in menu |
+| Rate limit | Too many requests | Reduce formula refresh frequency |
+
+**Debugging Tips:**
+1. Test account codes in Xero first to verify they exist
+2. Start with simple formulas before adding filters
+3. Check Scott's Add-in connection status
+4. Verify field names are spelled correctly (case-sensitive)
+5. For contacts, ensure IsCustomer/IsSupplier filter matches data
+
+---
+
+**Final Checklist:**
+- What Xero data is needed? (GL balances? Invoices? Contacts? Bank?)
+- What account code(s) are involved? (Verify in Xero chart of accounts)
+- What fields are required for the output?
+- Is a filter needed? (Status, contact type, date range)
+- Are account codes and field names spelled correctly?
+- Is the Scott's Add-in connected and authenticated?
+- Are rate limits being respected?
+
+---
+
+**Additional Resources:**
+- Scott's Add-ins for Xero: https://www.scottsaddins.com/xero-excel-add-in/
+- Scott's Add-in Documentation: https://www.scottsaddins.com/documentation/
+- Xero Chart of Accounts: https://central.xero.com/s/article/Set-up-your-chart-of-accounts
+- Xero API Reference: https://developer.xero.com/documentation/api/accounting/overview