Emisión de Factura C para monotributistas directo contra los web services de ARCA (WSAA + WSFEv1), sin pasar por el portal ni por intermediarios.
uv sync
cp .env.example .env # completar con tus datosRequiere ahoy (brew install ahoy).
-
ahoy csrgenera la clave privada y el CSR usando elARCA_CUITdel.env. -
En el portal de ARCA, entrar a Administrador de Certificados Digitales, crear un alias y subir el
.csr. Descargar el certificado y guardarlo enARCA_CERT_PATH(defaultcerts/arca.crt). -
En Administrador de Relaciones de Clave Fiscal, autorizar ese alias para DOS servicios:
- Facturación Electrónica (
wsfe) - Consulta de Constancia de Inscripción (
ws_sr_constancia_inscripcion)
- Facturación Electrónica (
-
Para cada uno de esos servicios:
- Nueva Relación
- En "Servicio" tocar Buscar (aparecen los logos de organismos)
- Logo de ARCA
- Rama WebServices (no "Servicios Interactivos")
- Elegir el servicio en la lista alfabética
- En "Representante" elegir Computador Fiscal y el alias del certificado
Sin la segunda relación,
facturarypadronfallan con "Computador no autorizado a acceder al servicio". -
Dar de alta un punto de venta para web services (Comprobantes en línea, ABM de puntos de venta) y ponerlo en
ARCA_PUNTO_VENTA. -
ahoy verify-certchequea que el certificado corresponda a la clave y muestra el vencimiento; despuésahoy statusvalida contra ARCA.
Para el ambiente de homologación (ARCA_ENV=homo) el certificado se gestiona en el portal de homologación y no emite facturas reales. Probá ahí primero.
uv run arca status # verifica conectividad, auth y último comprobante
uv run arca facturar # emite una Factura C (pregunta lo que falte)
uv run arca facturar --cuit 30111222333 --importe 150000
uv run arca historial # facturas emitidas, guardadas localmente
uv run arca sync # trae de ARCA las facturas que faltan en el historial local
uv run arca padron 30111222333 # tabla con la situación tributaria del CUIT (condición de IVA, domicilio, actividades, impuestos)
uv run arca recibidas --desde 2026-01-01 # trae de Mis Comprobantes lo que nos emitieron y guarda lo nuevo
uv run arca historial --recibidas # comprobantes recibidos guardados localmente
uv run arca emitidas --desde 2026-01-01 # lo emitido por cualquier punto de venta o medio, completa el historial
uv run arca balance # facturado vs gastos por mes, según el historial localsync consulta comprobante por comprobante (FECompConsultar) desde el último guardado hasta el último autorizado en ARCA, así el historial incluye también lo emitido por otros medios (portal, Facturante, etc.). --todo reconsulta desde el 1 y actualiza los ya guardados.
facturar muestra un resumen (número, receptor, concepto, importe, ambiente) y pide confirmación antes de emitir; --si la saltea para uso scripteado. Cachea la situación tributaria del receptor por 30 días en data/arca.sqlite3 (gitignoreado); --refresh fuerza la reconsulta al padrón, y padron también actualiza ese cache.
Las facturas que te emiten a vos no tienen web service: viven en "Mis Comprobantes", una app del portal con clave fiscal. recibidas replica lo que hace esa página (los endpoints ajax.do que llenan la grilla), pero el login necesita un browser, así que corre en un container con Playwright (docker/mcmp-login) que deja las cookies en data/mcmp_cookies.json. Hace falta Docker andando y ARCA_CLAVE_FISCAL en .env.
- La primera vez pide
--desde. Después arranca solo desde la última fecha guardada menos 7 días, para absorber comprobantes cargados con fecha anterior.--hastaes opcional (default hoy). - Si no hay cookies o el portal responde HTML en vez de JSON (sesión vencida), levanta el container y se loguea de nuevo, una vez.
- Si el login falla (clave incorrecta, captcha, cambio del portal) queda
data/mcmp_login_error.pngy.htmlcon la página en la que se trabó. --jsonenrecibidasimprime solo los comprobantes nuevos, y enhistorial --recibidastodos, para encadenar con otros scripts.emitidases el espejo (pestaña Emitidos): trae lo facturado por cualquier punto de venta o medio, quesyncno ve porque solo consulta el punto de venta de web services. Guarda enfacturassolo lo que falta, sin pisar lo que trajo WSFE (que tiene concepto y vencimiento de CAE; el portal no los da).balancecruza ambas tablas por mes. Es tan completo como lo que hayas traído conemitidas,syncyrecibidas.
uv run pytest
ARCA_CLAVE_FISCAL=... uv run pytest -m live # login y consulta reales contra el portalLos tests son unitarios y no tocan la red: la firma WSAA se prueba con un certificado self-signed generado en el momento.