FactuCat CLI
FactuCat CLI operates FactuCat Cloud from the command line. It is specifically for Mexican CFDI 4.0 invoicing, not for generic invoicing or self-hosted deployments.
Use This Skill When
- - A user wants to install or update the FactuCat CLI
- A user needs to authenticate with a FactuCat API key
- An agent needs to create, edit, preview, or stamp CFDI drafts from the terminal
- A workflow needs unattended CLI execution with
--json and INLINECODE1 - A user wants to download XML or PDF artifacts for a stamped invoice
Operating Rules
- - Treat
https://factucat.com as the production service endpoint - Use Mexican CFDI and SAT terminology in explanations and examples
- Prefer interactive flows for humans in a TTY
- Prefer
--json and --no-input for agents, scripts, and deterministic automation - Use
factucat invoice show for the full preview before timbrado - When a task involves fiscal vocabulary or CFDI semantics, read references/mexico-cfdi-context.md
Workflow Guide
- 1. For installation, updates, and authentication, read references/install-and-auth.md
- For a human-operated invoice flow, read references/interactive-flows.md
- For agent or script execution, read references/unattended-flows.md
- If anything fails, read references/troubleshooting.md
Practical Notes
- -
factucat invoice create --customer "..." is a shortcut that creates a draft and tries to resolve a customer by name or RFC - INLINECODE7 can infer SAT product code, SAT unit code, IVA, and retained ISR if omitted
- INLINECODE8 can infer the official DOF exchange rate if
--exchange-rate is omitted - INLINECODE10 can be interactive and ask about sending the stamped invoice through registered customer contact channels
- For issued invoices, commands that accept an invoice reference can usually take either a UUID or folio
FactuCat CLI
FactuCat CLI 从命令行操作 FactuCat Cloud。它专门用于墨西哥 CFDI 4.0 发票开具，不适用于通用发票开具或自托管部署。
使用此技能的时机
- - 用户想要安装或更新 FactuCat CLI
- 用户需要使用 FactuCat API 密钥进行身份验证
- 代理需要从终端创建、编辑、预览或盖章 CFDI 草稿
- 工作流需要使用 --json 和 --no-input 进行无人值守的 CLI 执行
- 用户想要下载已盖章发票的 XML 或 PDF 文件
操作规则
- - 将 https://factucat.com 视为生产服务端点
- 在解释和示例中使用墨西哥 CFDI 和 SAT 术语
- 在 TTY 环境中优先使用面向人类的交互式流程
- 对于代理、脚本和确定性自动化，优先使用 --json 和 --no-input
- 在盖章前使用 factucat invoice show 进行完整预览
- 当任务涉及财务词汇或 CFDI 语义时，请阅读 references/mexico-cfdi-context.md
工作流指南
- 1. 对于安装、更新和身份验证，请阅读 references/install-and-auth.md
- 对于人工操作的发票流程，请阅读 references/interactive-flows.md
- 对于代理或脚本执行，请阅读 references/unattended-flows.md
- 如果出现任何问题，请阅读 references/troubleshooting.md
实用说明
- - factucat invoice create --customer ... 是一个快捷方式，可以创建草稿并尝试按名称或 RFC 查找客户
- factucat invoice add-item 如果省略，可以推断 SAT 产品代码、SAT 单位代码、IVA 和预扣的 ISR
- factucat invoice set-meta --currency USD 如果省略 --exchange-rate，可以推断官方的 DOF 汇率
- factucat invoice stamp 可以是交互式的，询问是否通过已注册的客户联系渠道发送已盖章的发票
- 对于已开具的发票，接受发票引用的命令通常可以使用 UUID 或流水号
