KeyCAE.ar Packages 🚀

Repositorio oficial de paquetes, SDKs, CLI y herramientas para integrar facturación electrónica de ARCA (ex AFIP) en Argentina con KeyCAE.ar.

Diseñado para developers humanos y agentes autónomos de IA (Cursor, Windsurf, Claude Code, Codex).

---

📦 Paquetes

Paquete	Directorio	Descripción	npm
keycae-ts	/keycae-ts	SDK oficial TypeScript/JavaScript (20 métodos, incluye API de Partners)
keycae-mcp	/keycae-mcp	MCP Server para AI agents (12 tools)
keycae-cli	/keycae-cli	CLI interactiva de terminal (12 comandos)
arca-agent-skills	/arca-agent-skills	MCP Server + System prompts para agentes IA (12 tools)	—
vibe-invoice-inbox	/vibe-invoice-inbox	Dashboard web de facturas (Next.js)	—

---

🔌 MCP Server (para AI Agents)

El más nuevo y potente. Un solo comando y tu AI agent puede emitir facturas:

npx keycae-mcp

Configuración en Claude Desktop / Cursor / Windsurf

Puedes usar la clave de sandbox pública para probar de inmediato:

{
  "mcpServers": {
    "keycae": {
      "command": "npx",
      "args": ["-y", "keycae-mcp"],
      "env": {
        "KEYCAE_API_KEY": "sk_test_public_sandbox_cuit_20999999999"
      }
    }
  }
}

(Nota: Para producción, reemplázalo por tu clave real sk_live_... obtenida al registrarte en keycae.ar)

Tools Disponibles (12)

Tool	Descripción
emit_invoice	Emitir factura (24 tipos: A/B/C/M/E + 5 NC + 5 ND + 9 FCE MiPyMEs)
get_invoice	Consultar factura por ID
list_invoices	Listar facturas recientes
list_credentials	Ver certificados digitales
create_credential	Generar keypair + CSR para ARCA
check_delegation	Verificar delegación ARCA
request_delegation	Solicitar delegación ARCA
lookup_taxpayer	Buscar contribuyente por CUIT
check_emission_capability	Verificar tipos de factura compatibles
get_billing_status	Estado del plan y consumo
list_puntos_de_venta	Listar puntos de venta habilitados
keycae_health	Health check

---

🚀 Guía de Inicio Rápido

Opción 1: MCP Server (Recomendada para AI Agents)

npx keycae-mcp

Opción 2: SDK de TypeScript

npm install keycae-ts

import { KeyCaeClient } from 'keycae-ts';

// Inicializar con la clave del Sandbox Público:
const client = new KeyCaeClient('sk_test_public_sandbox_cuit_20999999999');

// Consultar contribuyente de pruebas en el Sandbox:
const taxpayer = await client.getTaxpayer('20999999999');
console.log(`${taxpayer.nombre} | ${taxpayer.estado}`);

// Verificar compatibilidad de tipos de factura para el CUIT de pruebas:
const cap = await client.checkEmissionCapability('20999999999');
console.log(cap.recommendation);

// Emitir factura simulada en el Sandbox:
const invoice = await client.emitInvoice({
  cuit_emisor: '20999999999',
  punto_de_venta: 1,
  tipo_comprobante: 'C',
  receptor: { tipo_doc: 'DNI', nro_doc: '35123456' },
  conceptos: [{ descripcion: 'Servicios', precio: 15000 }]
}, 'order_123');

console.log(`CAE: ${invoice.cae} | PDF: ${invoice.url_pdf}`);

Opción 3: CLI

npm install -g keycae-cli
keycae init
keycae invoice-emit

---

📖 Modelos de Conexión

Modalidad A: Delegación Directa (Recomendada)

Sin certificados, sin llaves privadas. En minutos facturás.

Modalidad B: Bóvedas KMS

Generación segura de claves RSA y CSR.

Modalidad C: Importar Certificado

Subida directa de certificados (.crt) y llaves (.key).

---

⚠️ Requisito: Delegación en ARCA

Antes de facturar, debés delegar la facturación electrónica a KeyCAE en ARCA:

1. Ingresá a ARCA Clave Fiscal
2. Buscá el servicio "Facturación Electrónica" (ws://wsfe)
3. Delegá al CUIT: 20254459306 (Amilcar Waldemar Serra)

---

🤝 Integración para Partners (ERPs / SaaS)

¿Desarrollás un ERP o SaaS? Ofrecé facturación electrónica ARCA a tus clientes con tu propia marca:

• Enlace de onboarding co-brandeado: https://app.keycae.ar/login.html?partner=TU_ID — la pantalla de registro se adapta a tu logo y colores.
• Alta programática de subcuentas desde tu backend con tu API Key de partner (sk_partner_live_...).
• Facturación consolidada opcional: una sola factura mensual de KeyCAE por todos tus clientes.
• Precios especiales negociables del plan Unlimited para tus usuarios.

import { KeyCaeClient } from 'keycae-ts';

const partner = new KeyCaeClient('sk_partner_live_mi-erp_...');

// Dar de alta un cliente cuando activa facturación en tu ERP
const sub = await partner.createPartnerSubaccount({
  cuit: '20304567891',
  organization: 'Cliente S.A.',
  email: 'cliente@empresa.com'
});

// Ver todos tus clientes con su consumo
const { clients } = await partner.listPartnerSubaccounts();

📖 Guía completa: keycae.ar/docs/partners.md

---

📖 Documentación

• 📄 llms.txt — Para AI agents
• 🔌 MCP Server — Para Cursor/Claude
• 📘 SDK TypeScript — Para developers
• 💻 CLI — Para terminal

Licencia

MIT