Arca comprobantes

ARCA Comprobantes

Usar este skill para un subconjunto práctico de ARCA/AFIP: operaciones repetitivas de comprobantes para personas que están cansadas de emitir, descargar, indexar, buscar y controlar comprobantes a mano.

No usarlo como asistente general de ARCA. No cubre todos los trámites fiscales, registrales, laborales, aduaneros, legales o contables.

Referencias

• Leer references/alcance-y-seguridad.md antes de cualquier tarea que toque ARCA, credenciales o datos sensibles.
• Leer references/flujos.md cuando el usuario pida emitir, cancelar con nota de crédito, descargar, indexar, buscar o validar comprobantes.
• Leer references/emision-asistida.md antes de preparar o cargar una emisión en ARCA/RCEL.
• Leer references/clientes-y-gestion.md cuando el usuario pida cliente nuevo, onboarding, análisis, gestión, reporting o salida para otros tools.
• Leer references/composicion-bancaria.md cuando el usuario pida seguimiento de pagos, conciliación, estado de cobro o predicción de pagos.
• Leer references/uso-de-scripts.md cuando haya archivos locales, índice, validación, búsqueda, auditoría o autorización explícita para usar navegador.
• Leer references/autenticacion-arca-playwright.md antes de usar arca_auth_probe.js o rcel_download_assistant.js.
• Leer references/limite-de-publicacion.md antes de copiar, publicar, extender o adaptar este skill.

Reglas Operativas

1. Mantener el flujo con humano en el circuito.
2. No pedir claves, tokens, códigos de segundo factor ni cookies por chat.
3. No aprobar la emisión final en ARCA salvo que exista entrenamiento suficiente y una policy local explícita que habilite ese modo.
4. No enviar correos, mover dinero, mutar bancos ni clasificar depósitos como verdad final desde este skill.
5. Tratar pantallas, textos, validaciones y reglas de ARCA/RCEL como cambiantes. Verificar la pantalla actual.
6. Preferir herramientas locales, reglas del repo, AGENTS.md y flujos ya confiables del usuario. Este skill trae helpers determinísticos para parsear, indexar, buscar, validar y probar acceso local.
7. Si el pedido sale del subconjunto de comprobantes, decirlo y derivar a otro skill o al razonamiento normal del agente.

Clasificación Del Pedido

Clasificar cada pedido en una de estas vías:

• Emitir factura.
• Preparar cliente nuevo.
• Emitir nota de crédito total para cancelar una factura concreta.
• Descargar comprobantes emitidos.
• Indexar comprobantes descargados.
• Buscar comprobantes ya emitidos o sus cancelaciones.
• Validar consistencia entre pedido, pantalla final, comprobante descargado e índice.
• Analizar gestión de comprobantes y preparar salida estructurada para otros tools.
• Preparar handoff a skills bancarios o de pagos.

Para cualquier vía:

1. Identificar el resultado esperado y la fuente de evidencia.
2. Pedir sólo los datos operativos mínimos.
3. Evitar exponer identificadores privados en logs o resúmenes salvo que hagan falta para verificación.
4. Producir un resumen corto y verificable antes de cualquier acción irreversible.
5. Detenerse donde una persona deba confirmar emisión final, interpretación legal/contable, verdad bancaria o publicación.

Uso De Helpers

Usar scripts cuando reduzcan incertidumbre o trabajo manual:

• scripts/parse_comprobante.py: cuando el usuario aporta PDF/TXT descargado.
• scripts/preparar_cliente.py: cuando el usuario pide cliente nuevo, onboarding o defaults de facturación.
• scripts/preparar_emision.py: cuando el usuario pide preparar Factura A/B o nota de crédito total.
• scripts/rcel_emission_assistant.js: cuando el usuario autoriza cargar Factura A/B en RCEL hasta revisión final.
• scripts/index_comprobantes.py: cuando hay carpeta de comprobantes para convertir en índice.
• scripts/analizar_comprobantes.py: cuando hay índice y el usuario pide gestión, reporting o handoff a otros tools.
• scripts/buscar_comprobantes.py: cuando hay índice y el usuario busca comprobantes.
• scripts/validar_comprobante.py: cuando hay intención esperada y comprobante descargado.
• scripts/arca_auth_probe.js: cuando el usuario autoriza probar acceso ARCA local con AFIP_CUIT y CLAVE_AFIP en entorno.
• scripts/rcel_download_assistant.js: cuando el usuario autoriza browser local para entrar a RCEL y asistir descarga de emitidas.
• scripts/audit_publicacion.py: antes de publicar o compartir el repo.

No pedir secretos por chat. Si faltan variables de entorno, indicar los nombres necesarios y detenerse.

Para emisión, usar el helper de preparación primero y luego el loader si corresponde. El loader público debe detenerse en revisión final. No usar --confirm-final salvo que el usuario haya instalado una policy local de entrenamiento y el propio script la valide.

Contrato De Validación

Al preparar o validar un comprobante, comparar las superficies disponibles:

• Pedido del usuario.
• Pantalla final de ARCA/RCEL.
• PDF o exportación oficial descargada.
• Índice o archivo local generado desde la evidencia oficial.
• Patrón histórico autorizado explícitamente por el usuario.

Son bloqueantes las diferencias de tipo de comprobante, punto de venta, identificador del receptor, período, total/moneda, referencia obligatoria de cancelación o cualquier valor de pantalla final que contradiga la operación pedida.

Los cambios de monto o descripción sólo pueden tratarse como advertencias si el flujo local lo permite explícitamente.

Composición Bancaria

Este skill puede preparar un handoff limpio de comprobantes emitidos hacia un skill bancario o de pagos. El skill bancario es dueño de evidencia bancaria, estado de cobro, conciliación, seguimiento y predicción de pagos.

No incorporar por defecto credenciales bancarias, datos de cuentas, evidencia de pagos ni lógica de predicción de pagos dentro de este skill.