finance-doc-scan

Extract structured fields from invoice, quotation, and receipt OCR text into JSON.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill finance-doc-scan-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finance-doc-scan
Source: https://github.com/tapway/shogun-os/tree/main/skills/finance/finance-doc-scan
Command: npx skills add https://github.com/tapway/shogun-os --skill finance-doc-scan-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually reading invoices, quotations, and receipts to record vendor names, amounts, dates, and line items is slow and error-prone. This Skill turns OCR text from finance documents into a structured JSON object with validated totals, ready for downstream processing. ## Core Features & Use Cases - Field Extraction: Pulls vendor, document number, dates, subtotal, tax, total, and every line item from OCR text of invoices, quotations, and receipts. - Total Validation: Verifies that subtotal plus tax equals the total and reports discrepancies in a validation block. - Strict JSON Output: Returns point-form structured data only, with no summary prose, making it safe to pipe into dashboards or storage endpoints. - Use Case: A user uploads a PDF invoice in the Finance dashboard; the backend runs OCR, passes the text through this Skill's DeepSeek prompt, and receives a JSON object like {"vendor": "ABC Supplies Sdn Bhd", "total": "RM 10,600.00"} for the scan endpoint to store. ## Quick Start Upload an invoice, quotation, or receipt in the Finance dashboard and ask the agent to extract all fields from the scanned document as JSON.

Frequently Asked Questions about finance-doc-scan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract fields from an invoice using OCR?

Run OCR on the invoice file (PDF, PNG, or JPG) in your backend first, then pass the extracted text through this Skill's DeepSeek prompt. It returns a JSON object with vendor, document number, dates, amounts, and line items.

What document types does finance document scanning support?

The Skill handles invoices, quotations, and receipts, classifying each as invoice, quotation, receipt, or other in the document_type field. It accepts PDF, PNG, and JPG files after backend OCR processing.

Does this skill summarize or store scanned documents?

No. It performs field extraction only and returns point-form JSON with no summary text. Storing results to gbrain is the responsibility of the Finance dashboard scan endpoint, not this Skill.

Can I use invoice scanning for legal contracts?

No. Legal documents and contracts are explicitly out of scope for this Skill. Use the estate-legal-scan skill instead, which is designed for legal document assessment.

How is invoice total accuracy validated after extraction?

The Skill checks whether subtotal plus tax equals the total and reports the result in a validation object with a valid flag and message. Any discrepancy is noted in the message field of the JSON output.