菜单
How to save, load, and manage tax filing records. Covers directory structure, summary.json schema, screenshot conventions, and annual totals. Used by agents that need to persist or read operation results.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Mandatory knowledge lookup protocol for all tax agents. Defines the 4-level search hierarchy (local → official → unofficial → unknown) that every agent must follow before answering any fiscal question.
Complete guide for navigating Marangatu portal (Paraguay tax system). Covers login, AngularJS sidebar navigation, form field mapping, invoice emission, and error recovery. Used by browser automation agents.
Legal framework, tax rules, exemption criteria, and filing procedures for Paraguayan fiscal obligations. Covers Ley 6380/2019, IVA treatment, IRP rules, progressive rates, and filing sequence. Used by all agents that make fiscal decisions.
Complete taxpayer and client data for fiscal operations. Contains identity, RUC, address, client details, tax treatment, and billing configuration. Used by agents that need to fill forms or verify taxpayer info.
| name | record-management |
| description | How to save, load, and manage tax filing records. Covers directory structure, summary.json schema, screenshot conventions, and annual totals. Used by agents that need to persist or read operation results. |
.user/records/
├── YYYY/
│ ├── MM/
│ │ └── YYYY-MM-DD/
│ │ ├── summary.json ← Operation data
│ │ ├── screenshots/ ← Evidence captures
│ │ └── pdfs/ ← Invoices and receipts
│ ├── IRP/
│ │ └── YYYY-MM-DD/ ← Annual IRP records
│ ├── health/
│ │ └── YYYY-MM-DD/ ← Health check reports
│ ├── profile/
│ │ └── latest.json ← Latest profile scrape
│ └── communications/
│ └── latest.json ← Latest communications check
See src/record.ts for the full TypeScript interface (TaxRecord).
Key fields:
date: ISO date of operation (YYYY-MM-DD)period: Fiscal period (YYYY-MM)type: "monthly" or "annual"gs_amount: Amount in guaranies (REQUIRED)invoice: Invoice details (number, timbrado, date, status)iva: IVA declaration details (form, amount_exempt, status)irp: IRP details (for annual records)Number screenshots sequentially with descriptive names:
01-bcp-exchange-rate.png
02-marangatu-login.png
03-invoice-form-before.png
04-invoice-form-filled.png
05-invoice-confirmation.png
06-iva-form-before.png
07-iva-form-filled.png
08-iva-confirmation.png
summary.json to .user/records/YYYY/MM/YYYY-MM-DD/.user/facturas/.user/records/YYYY/MM/YYYY-MM-DD/screenshots/.user/memory/MEMORY.md with the new declaration state| Script | Purpose |
|---|---|
npm run check-records | List all records with totals per year |
npm run irp-calc | Calculate annual IRP (supports -- YEAR --json) |
npm run exchange-rate | Get current BCP USD/PYG exchange rate |
npm run health-check | Automated Marangatu health check |
The TypeScript functions in src/record.ts:
listRecords() — all records sorted by dateloadRecord(period) — latest record for a YYYY-MM periodgetAnnualTotal(year) — sum of Gs amounts for a year (excludes annulled)getAnnualRecords(year) — all valid records for a yearisAnnulled(record) — check if invoice was cancelled