Bill Ballou
357d1aadc8
Introduces templates/ directory with pre-built record structures that only include writable fields, preventing 400 errors from formula column writes. Templates: - bill-paid-credit-card.json: Invoice paid by business credit card - bill-paid-owner.json: Invoice paid by owner (reimbursement) - bill-paid-checking.json: Invoice paid from checking account - bill-unpaid.json: Invoice recorded but not yet paid - pay-existing-bill.json: Payment for existing open bill - direct-expense.json: Bank fees and minor expenses Also adds references/templates.md usage guide and updates SKILL.md with template references and formula column warnings.
120 lines
3.9 KiB
JSON
120 lines
3.9 KiB
JSON
{
|
|
"_meta": {
|
|
"name": "Pay Existing Bill",
|
|
"description": "Record payment for a bill that was previously entered as unpaid",
|
|
"scenario": "Bill was recorded earlier with Status='Open', now recording the payment",
|
|
"prerequisite": "Bill must already exist with EntryTransaction linked"
|
|
},
|
|
"_variables": {
|
|
"bill_id": "integer - Existing Bill record ID",
|
|
"payment_date_timestamp": "integer - Unix timestamp for payment date",
|
|
"amount": "number - Payment amount (usually matches Bill.AmountDue)",
|
|
"payment_account_id": "integer - Payment source: 14=Checking, 19=Credit Card, 22=Due to Owner",
|
|
"payment_account_name": "string - Account name for transaction memo",
|
|
"payment_reference": "string - Check number, confirmation code, etc.",
|
|
"vendor_name": "string - Vendor name for transaction description"
|
|
},
|
|
"_sequence": [
|
|
"1. Verify bill exists and has AmountDue > 0",
|
|
"2. Create payment Transaction → get payment_txn_id",
|
|
"3. Create payment TransactionLines (Dr AP, Cr Payment Account)",
|
|
"4. Create BillPayment record",
|
|
"5. Update Bill.Status → 'Paid' (if fully paid)",
|
|
"6. Upload Receipt attachment if available",
|
|
"7. Run audit checks"
|
|
],
|
|
"_pre_check": {
|
|
"_doc": "Verify bill status before proceeding",
|
|
"query": "SELECT id, BillNumber, Amount, AmountDue, Status FROM Bills WHERE id = {{bill_id}}",
|
|
"expected": "AmountDue > 0 and Status = 'Open'"
|
|
},
|
|
"records": {
|
|
"payment_transaction": {
|
|
"_doc": "Step 2: Create payment transaction header.",
|
|
"_table": "Transactions",
|
|
"_operation": "add_records",
|
|
"payload": {
|
|
"Date": "{{payment_date_timestamp}}",
|
|
"Description": "Payment to {{vendor_name}}",
|
|
"Reference": "{{payment_reference}}",
|
|
"Status": "Cleared"
|
|
}
|
|
},
|
|
"payment_transaction_lines": {
|
|
"_doc": "Step 3: Create payment transaction lines. Debit AP, credit payment account.",
|
|
"_table": "TransactionLines",
|
|
"_operation": "add_records",
|
|
"_requires": ["payment_txn_id"],
|
|
"payload": [
|
|
{
|
|
"Transaction": "{{payment_txn_id}}",
|
|
"Account": 4,
|
|
"Debit": "{{amount}}",
|
|
"Credit": 0,
|
|
"Memo": "Accounts Payable"
|
|
},
|
|
{
|
|
"Transaction": "{{payment_txn_id}}",
|
|
"Account": "{{payment_account_id}}",
|
|
"Debit": 0,
|
|
"Credit": "{{amount}}",
|
|
"Memo": "{{payment_account_name}}"
|
|
}
|
|
]
|
|
},
|
|
"bill_payment": {
|
|
"_doc": "Step 4: Create BillPayment linking bill to payment transaction.",
|
|
"_table": "BillPayments",
|
|
"_operation": "add_records",
|
|
"_requires": ["bill_id", "payment_txn_id"],
|
|
"payload": {
|
|
"Bill": "{{bill_id}}",
|
|
"Transaction": "{{payment_txn_id}}",
|
|
"Amount": "{{amount}}",
|
|
"PaymentDate": "{{payment_date_timestamp}}"
|
|
}
|
|
},
|
|
"mark_paid": {
|
|
"_doc": "Step 5: Update Bill status to Paid (only if AmountDue becomes 0).",
|
|
"_table": "Bills",
|
|
"_operation": "update_records",
|
|
"_requires": ["bill_id"],
|
|
"_condition": "Only if Bill.AmountDue = 0 after payment",
|
|
"payload": {
|
|
"id": "{{bill_id}}",
|
|
"fields": {
|
|
"Status": "Paid"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"journal_entries": {
|
|
"_doc": "Journal entry created by this template",
|
|
"payment": {
|
|
"description": "Record payment clearing accounts payable",
|
|
"debits": [{"account": "Accounts Payable (2000)", "amount": "{{amount}}"}],
|
|
"credits": [{"account": "Payment Account", "amount": "{{amount}}"}]
|
|
}
|
|
},
|
|
"payment_account_options": {
|
|
"checking": {
|
|
"id": 14,
|
|
"code": "1001",
|
|
"name": "Checking Account",
|
|
"type": "Asset"
|
|
},
|
|
"credit_card": {
|
|
"id": 19,
|
|
"code": "2101",
|
|
"name": "Business Credit Card",
|
|
"type": "Liability"
|
|
},
|
|
"owner_paid": {
|
|
"id": 22,
|
|
"code": "2203",
|
|
"name": "Due to Owner",
|
|
"type": "Liability"
|
|
}
|
|
}
|
|
}
|