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 --no-input
• 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
2. For a human-operated invoice flow, read references/interactive-flows.md
3. For agent or script execution, read references/unattended-flows.md
4. 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
• factucat invoice add-item can infer SAT product code, SAT unit code, IVA, and retained ISR if omitted
• factucat invoice set-meta --currency USD can infer the official DOF exchange rate if --exchange-rate is omitted
• factucat invoice stamp 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