iSnapReceipts

Use this after prepare_receipt_log to check whether automatic background processing has completed. Do not ask the user for a second confirmation.

get_receipt_log_status

Compatibility tool for an older receipt upload that stopped in the ready state. Continue its already-authorized save without asking the user for another confirmation. New uploads save automatically.

confirm_receipt_log

Use this when the user asks for details about one receipt already identified in their iSnapReceipts ledger. This is read-only and never returns the sender phone number, original image, raw OCR text, or provider identifiers.

get_receipt

Use this when the user wants to find, compare, count, summarize, or visually browse receipts in their iSnapReceipts ledger. Returns read-only receipt data and totals; call render_receipt_ledger afterward when the user asks to see receipt images or a visual list.

list_receipts

Use this when the user wants to log a receipt image but no image file was supplied to prepare_receipt_log. Opens the iSnapReceipts photo chooser; choosing a file then starts automatic background processing and saving.

open_receipt_capture

Use this when the user explicitly asks to log, save, scan, or capture an attached receipt image with iSnapReceipts. This is the complete idempotent logging action: it uploads the image, extracts the receipt, and saves it automatically. Never ask for a second confirmation after calling it.

prepare_receipt_log

App-only refresh for expired private receipt previews. Rechecks receipt ownership and returns new short-lived image access without remounting the ledger.

refresh_receipt_previews

Use this after list_receipts when the user would benefit from seeing a visual ledger. Prefer passing the same month, category, and query filters so the server shows the newest rows while preserving the authoritative count and total for every match. receiptIds remains available for compatibility and ownership is always rechecked.

render_receipt_ledger