[{"data":1,"prerenderedAt":152},["ShallowReactive",2],{"doc-\u002Fdocs\u002Fguides\u002Fexpenses-and-receipts":3,"github-stars":149},{"id":4,"title":5,"body":6,"description":139,"extension":140,"meta":141,"navigation":142,"order":143,"path":144,"section":145,"seo":146,"stem":147,"__hash__":148},"docs\u002Fdocs\u002Fguides\u002Fexpenses-and-receipts.md","Expenses & receipts",{"type":7,"value":8,"toc":130},"minimark",[9,13,23,28,48,52,59,67,79,83,94,98,101],[10,11,5],"h1",{"id":12},"expenses-receipts",[14,15,16,17,22],"p",{},"Expenses are the other half of the money picture: the costs that sit against\nyour income when Clerq works out profit. Log them as they happen, attach the\nreceipt, and they flow straight into the ",[18,19,21],"a",{"href":20},"\u002Fdocs\u002Fguides\u002Freports","profit report",".",[24,25,27],"h2",{"id":26},"log-an-expense","Log an expense",[14,29,30,31,35,36,39,40,43,44,47],{},"Create an expense with a description, an amount and currency, and a date. You\ncan also record the ",[32,33,34],"strong",{},"vendor",", a ",[32,37,38],{},"category",", and free-text ",[32,41,42],{},"notes",". Attach\nthe ",[32,45,46],{},"receipt"," as a PNG, JPEG or PDF - it is stored inline in the database\nalongside the expense, so there is no object store to run and nothing to lose\ntrack of.",[24,49,51],{"id":50},"scan-a-receipt-with-ai","Scan a receipt with AI",[14,53,54,55,58],{},"Rather than copy the numbers off a receipt by hand, attach the image and press\n",[32,56,57],{},"Scan with AI",". A vision model reads the receipt and pre-fills the\ndescription, amount, currency, vendor, category and notes for you to check and\nadjust before saving.",[14,60,61,62,66],{},"The button only appears when the instance is configured with a Groq API key -\nsee ",[18,63,65],{"href":64},"\u002Fdocs\u002Fself-hosting\u002Fenvironment-variables#optional-ai-receipt-scanning","AI receipt scanning","\nfor the one variable it needs. On Clerq Cloud it is ready to use.",[68,69,70],"blockquote",{},[14,71,72,75,76,78],{},[32,73,74],{},"Privacy."," The receipt image is sent to the AI provider only at the moment\nyou click ",[32,77,57],{}," - never automatically, and never if scanning is not\nconfigured. PDFs are turned into an image in your browser first, so only a\nsingle page image ever leaves the instance. Scanning fills in the form; it\nnever saves the expense for you.",[24,80,82],{"id":81},"paid-unpaid","Paid & unpaid",[14,84,85,86,89,90,93],{},"Mark an expense ",[32,87,88],{},"paid"," when the money actually leaves, or ",[32,91,92],{},"unpaid"," if you\nrecorded it early. The status feeds the two bases in the profit report: unpaid\nexpenses count on the accrued basis, paid ones on the cash basis.",[24,95,97],{"id":96},"find-an-expense","Find an expense",[14,99,100],{},"The expenses list has a search box that filters by description, vendor or\ncategory as you type. The term lives in the page URL, so a filtered view is a\nlink you can bookmark or share.",[68,102,103],{},[14,104,105,106,110,111,115,116,115,119,115,122,125,126,129],{},"Expenses are fully scriptable over the ",[18,107,109],{"href":108},"\u002Fdocs\u002Fai\u002Fmcp-server","MCP server",":\n",[112,113,114],"code",{},"list_expenses",", ",[112,117,118],{},"create_expense",[112,120,121],{},"mark_expense_paid",[112,123,124],{},"mark_expense_unpaid","\nand ",[112,127,128],{},"delete_expense",". Uploading a receipt file stays a web-app action.",{"title":131,"searchDepth":132,"depth":132,"links":133},"",3,[134,136,137,138],{"id":26,"depth":135,"text":27},2,{"id":50,"depth":135,"text":51},{"id":81,"depth":135,"text":82},{"id":96,"depth":135,"text":97},"Record business costs, attach a receipt, and let AI read it for you - so expenses land in your profit numbers with almost no typing.","md",{},true,4,"\u002Fdocs\u002Fguides\u002Fexpenses-and-receipts","Guides",{"title":5,"description":139},"docs\u002Fguides\u002Fexpenses-and-receipts","KP-5sangh5DavJut1uALx4KO70e8kbItxA7iy5uMVpQ",{"stars":150,"repo":151},0,"PunterDigital\u002Fclerq",1784716910868]