Changelog

Si ARCA autorizaba un comprobante pero su respuesta se perdía en el camino —un timeout, un corte de red—, el reintento con la misma Idempotency-Key podía emitir otro comprobante con el número siguiente. Ya no.

Ahora, antes de mandar cada comprobante a ARCA, arca.api registra qué número le va a pedir. Si la respuesta no llega, el reintento con la misma key le pregunta a ARCA por ese número y te devuelve el comprobante que había autorizado: mismo número, mismo CAE, y el mail y el link de cobro salen una sola vez.

• Si ARCA tampoco responde a esa consulta, el reintento devuelve 502 sin emitir. Seguí reintentando con la misma key.
• Aunque no reintentes, o no uses key, el comprobante aparece igual en tu historial: con tu próxima emisión en el mismo punto de venta y tipo, o como mucho en un día.
• Aplica a facturas, recibos, notas de crédito y débito, y Factura E; desde la API, el facturador web, Mercado Pago, la importación de ventas y el MCP.

La key es única por cuenta, no por CUIT: si emitís para varios clientes desde la misma cuenta, prefijala.

Si facturás en nombre de tus propios clientes, ya no hace falta entrar al dashboard cada vez que sumás uno. Con los nuevos endpoints de /api/cuits hacés todo el recorrido desde tu sistema: das de alta el CUIT, te devolvemos el CSR listo para que tu cliente lo pegue en ARCA, y cargás el .crt que ARCA le emite. Si tu cliente ya tenía su propio certificado, subís el par .crt + .key y listo.

Cada CUIT viene con su estado y un campo pasosPendientes que te dice qué le falta hacer a tu cliente en ARCA —cargar el certificado, delegar la constancia, habilitar un punto de venta, renovar—, así tu panel no tiene que adivinarlo. La guía trae un texto por cada paso, con la ruta exacta en ARCA, para que se lo muestres tal cual.

• Para saber qué certificados renovar: GET /api/cuits?estado=por_vencer,vencido.
• Las escrituras piden una API key con permisos de acceso completo, y el alta respeta el cupo de CUITs de tu plan.
• Nada de esto consume cuota.
• El servidor MCP suma cuits_listar y cuits_obtener, para que un agente pueda consultar el estado de tus CUITs.

Además, cuando das de baja un CUIT o un certificado —desde el dashboard o por API— descartamos su clave privada: conservamos los datos públicos del certificado, pero el material de clave deja de existir.

Cuando facturás desde el dashboard a alguien identificado con DNI o CUIT que todavía no está en tu agenda, ahora aparece la opción Guardar en mi agenda, marcada de entrada. Si la factura sale aprobada, guardamos al receptor con su nombre, documento, condición frente al IVA y el correo electrónico que hayas cargado. La próxima vez lo elegís de la lista, sin volver a buscarlo.

• Funciona en el facturador rápido y en el avanzado, en producción y en modo prueba.
• Si ya lo tenías guardado, no se duplica ni se modifican sus datos.
• Si no querés guardarlo, destildás la opción antes de emitir.

Ahora podés conectar ChatGPT y claude.ai a tu cuenta sin copiar ninguna API key. Pegás la URL del servidor MCP —https://arca.api.com.ar/api/mcp—, iniciás sesión en arca.api y elegís qué puede hacer el asistente: Sólo consultas o Consultas y emisión.

Y el asistente ya puede emitir comprobantes: facturas, recibos y notas de crédito o débito. Lo hace en dos pasos, para que nada salga sin que lo veas. Primero prepara el comprobante y te muestra una vista previa con el cliente, los ítems y los importes, sin tocar ARCA. Recién cuando confirmás, lo emite: exactamente ese, sin cambios.

• Si reintenta la emisión, devuelve el mismo comprobante: nunca emite dos veces.
• La cuota, los rechazos y el registro de uso funcionan igual que en la REST API.
• Las aplicaciones que conectes aparecen en API keys → Aplicaciones conectadas, donde las desconectás cuando quieras. No cuentan contra el límite de API keys de tu plan.
• Te recomendamos probar primero en homologación.

Si ya usás el servidor MCP con una API key de acceso completo, tu agente va a ver las dos tools nuevas de emisión. Si sólo querés que consulte, cambiale la key por una de solo lectura.

El detalle de cada comprobante ahora muestra su origen: si lo emitiste desde el facturador web, por la API, desde un asistente de IA, por la conciliación de Mercado Pago o con una importación de ventas. Cuando lo emitió un asistente conectado a tu cuenta, también ves cuál: por ejemplo, "Asistente de IA · ChatGPT".

• Los comprobantes que ya emitiste desde un asistente aparecen con su origen correcto.
• En la descarga de comprobantes, la columna Origen pasa a usar estos mismos nombres en lugar de los valores internos (api, web…). Si procesás ese archivo con una planilla o un script, revisá esa columna.

Si usás Fudo como punto de venta, ya no hace falta cargar una por una las ventas que te quedaron sin facturar. En Facturar → Importar ventas subís el .xlsx que exporta Fudo y cada venta se factura como un comprobante con sus ítems, a consumidor final.

Antes de emitir ves una vista previa venta por venta. Ahí elegís cuáles facturar y ves el total de lo seleccionado. Revisamos que el detalle de cada venta cuadre con el total que informa Fudo: la que no cuadra queda apartada, con el motivo, y no se emite. Los descuentos se reparten entre los ítems y los costos de envío entran como un ítem más; las propinas no se facturan.

La misma venta nunca se factura dos veces. El número de venta de Fudo queda registrado en el comprobante: si volvés a subir el mismo archivo, o uno que se pisa con el anterior, lo ya facturado aparece marcado con su número de comprobante y no se puede volver a elegir. Y si la emisión se corta a mitad de camino, reintentar sigue desde donde quedó, sin duplicar.

• Monotributistas emiten Factura C. Responsables inscriptos emiten Factura B: como Fudo no informa la alícuota de IVA, la elegís por categoría (21% por defecto).
• Los comprobantes salen con la fecha de hoy, no la de la venta: ARCA solo permite fechar una venta de productos hasta 5 días antes de emitirla.
• Cada comprobante descuenta cuota igual que una emisión normal, y el detalle del comprobante muestra de qué venta de Fudo salió.

Los comprobantes de un mismo punto de venta y tipo tienen que llevar fechas no decrecientes: una vez que ARCA autorizó uno con la fecha de hoy, ninguno de ese punto de venta y tipo puede salir con fecha de ayer. Es la trampa clásica al migrar un histórico, y hasta hoy cada intento se iba a ARCA para volver rechazado con el código 10016.

Ahora esa fecha la revisamos antes de llamar a ARCA. Si la cbteFch que mandás es anterior a la del último comprobante que emitimos y ARCA aprobó para ese punto de venta y tipo, la emisión responde 400 con un mensaje que nombra las dos fechas y qué hacer, sin salir hacia el organismo. Como nunca llegó a ARCA, no consume cuota, no avanza la numeración y no cuenta para el tope de rechazos por hora. Sólo miramos lo que emitiste por arca.api: si ese punto de venta también se factura desde otro sistema, el comprobante sale igual y lo decide ARCA.

Y cuando el 10016 sí llega de ARCA, el mensaje ahora te dice con qué número y con qué fecha se intentó emitir, explica la regla de las fechas y te indica cómo averiguar la fecha del último autorizado — la consulta de último comprobante devuelve el número, pero la fecha hay que pedirla consultando ese comprobante por número.

Si atendés por mostrador, hasta hoy el único PDF que te devolvíamos era de hoja: la plantilla oficial de ARCA, con su tabla de hasta siete columnas, pensada para A4. En 8 cm de papel térmico eso es ilegible.

Ahora el endpoint del PDF acepta un campo formato, con hoja (lo de siempre) o tique. El tique sale de 80 mm de ancho, en una sola columna, alto variable según el contenido y todo en blanco y negro puro, que es lo único que una térmica imprime limpio. Es una representación gráfica alternativa del mismo comprobante: una Factura B sigue siendo una Factura B, con su letra, su código, su CAE y su QR. También podés elegir el formato al descargar desde el dashboard, y previsualizarlo en Diseño de PDF.

El campo es opcional y su ausencia devuelve la hoja, así que tu integración actual no necesita tocar nada. Cada formato se cachea por separado: pedir el tique no toca el PDF de hoja que ya mandaste por correo.

Emitir la factura era la mitad del trabajo. La otra mitad —perseguir el pago— seguía siendo tuya.

Conectás tu cuenta de Mercado Pago una vez y cada comprobante que emitís lleva su propio link de pago, que además viaja en el email que le llega a tu cliente. Cuando paga, la notificación de Mercado Pago concilia sola: el comprobante pasa a cobrado, con el importe y la fecha de acreditación.

El dinero va directo a tu cuenta de Mercado Pago; nosotros no lo tocamos ni cobramos comisión por encima de la de ellos. Podés desconectar la cuenta cuando quieras.

Hasta hoy, un comprobante que ARCA rechazaba consumía una unidad de tu plan: había llegado al organismo, así que lo contábamos. Visto en la calle, la regla estaba mal: los rechazos se concentran mientras terminás de configurar el punto de venta o de acomodar la numeración, que es justo cuando menos sentido tiene cobrarte.

Desde ahora solo se cuentan las facturas que obtuvieron CAE. Un 422 —el rechazo de ARCA, o el error de regla de negocio previo— queda registrado en el historial, pero no descuenta nada del plan. Se cobra el resultado, no el intento.

El cambio es retroactivo sobre el período en curso: si tuviste rechazos este mes, tu consumo ya bajó solo. No cambia ningún status HTTP de la API, así que tu integración no necesita tocar nada.

La única contrapartida es un tope alto de rechazos por hora, para que una integración con un bug no quede reintentando el mismo error contra ARCA. Un uso normal no lo alcanza nunca; si lo cruzás, la API responde 429 y te lo explica.

El facturador web arrancó con lo más común. Ahora cubre el resto:

• Notas de crédito y débito, con la asociación al comprobante original resuelta por el panel: elegís qué factura estás ajustando y el resto se completa solo.
• Factura A y B según la condición del receptor frente al IVA, además de la C del monotributo.
• Exportación (WSFEX), con su moneda, su cotización y su permiso.

Todo lo que se podía hacer por la API se puede hacer ahora desde el panel.

Cada factura empezaba de cero: volver a escribir el CUIT del cliente, su razón social, su condición frente al IVA, el detalle del ítem y el precio. Ahora los guardás una vez y los reusás.

Los clientes y los productos viven en tu cuenta y están disponibles por las dos vías: al emitir desde el panel los elegís de una lista, y por la API los referenciás cuando armás el comprobante.

Hasta hoy, para emitir un comprobante había que integrar la API. Ahora hay un facturador web en el dashboard: elegís el CUIT emisor, el cliente y los ítems, y ARCA te devuelve el CAE.

Es el mismo motor de emisión que usa la API —los mismos controles, la misma validación, el mismo PDF y el mismo envío por email al cliente—, con una pantalla adelante. La API no va a ningún lado: ahora son dos puertas a lo mismo, y elegís la que te sirva.

El dashboard se instala en el escritorio o en el teléfono como una aplicación más, con su ícono y su propia ventana, sin barra de navegador. Y abre donde tiene que abrir: en tu panel, no en la página de venta.

Facturabas, bajabas el PDF, abrías el correo, adjuntabas y mandabas. Ahora agregás el campo email cuando emitís y el comprobante le llega solo a tu cliente, con el PDF adjunto.

Desde el dashboard seguís qué pasó con cada envío: si se entregó, si lo abrieron o si rebotó porque la dirección no existe.

Hay errores de ARCA que no se arreglan escribiendo código: si tu certificado no está delegado al web service en el Administrador de Relaciones, no hay reintento que sirva. Sumamos una página que explica, error por error, qué significa, por qué pasa y cómo se resuelve. Las tablas de cada endpoint enlazan directo al que te tocó.

El soporte dejó de ser un buzón de una sola vía. Cada pedido abre un hilo de conversación dentro del dashboard donde te contestamos, y te avisamos por email cuando hay novedades. El ida y vuelta queda todo en un mismo lugar.

Las consultas al Padrón se guardaban en caché hasta diez días, una ventana en la que la condición fiscal de un contribuyente puede cambiar tranquilamente. Acortamos ese plazo: lo que te devolvemos refleja mucho mejor lo que ARCA tiene hoy, sin que cambie nada de tu lado.

Los payloads que muestra el dashboard dejaron de ser una pared de texto monoespaciado: ahora se recorren como un árbol que se pliega, se despliega y se copia. El dato que fuiste a buscar —casi siempre una observación o un error de ARCA enterrado en un sub-array— aparece en un par de clics.

Las constancias de inscripción son las que más lo agradecen: traen tres bloques de datos, cada uno con sus propias listas de actividades, impuestos y regímenes adentro.

Claude Code, Cursor o Claude Desktop pueden consultar tu cuenta sin que escribas una línea de integración: comprobantes emitidos, situación de un CUIT en el padrón, tablas de parámetros, el PDF de una factura.

Son trece herramientas de solo lectura, sobre una API key que no puede emitir facturas ni notas de crédito contra ARCA. Ese límite lo garantiza la plataforma, no la buena conducta del agente.

Emitís y, además del CAE, te llevás el PDF: ítems, importes, el código QR de ARCA y el diseño que configurás desde el dashboard, con tu logo y tus datos. Es el papel que tu cliente final espera recibir.

En los comprobantes de mercado interno el nombre o razón social del receptor sale completo. ARCA sólo devuelve el tipo y número de documento del comprador, así que el nombre lo resolvemos contra el Padrón, sin que tengas que mandarlo vos.

A fin de mes la pregunta es siempre la misma: qué está empujando la factura. El gráfico del dashboard ahora reparte el consumo facturable entre tus API keys y separa facturación de padrón.

En la página de uso podés además filtrar por rango de fechas, endpoint y API key, y ver los totales de esa búsqueda —no los de la página que tenés a la vista.

Si algo no anda, falta o se puede hacer mejor, ahora lo contás desde el propio dashboard: hay un botón de soporte en la barra lateral. El pedido queda registrado y nos llega en el momento, así no depende de que alguien mire un mail.

Facturar contra ARCA venía siendo un problema de plomería antes que de negocio: SOAP, WSDL, certificados, tickets de acceso que vencen cada doce horas. Desde hoy es un POST con JSON y una API key, y te vuelve el CAE.

Salimos con facturación electrónica (facturas A, B y C, notas de crédito y débito), consultas al Padrón A10 y A13, la constancia de inscripción, y varios CUIT operando desde la misma cuenta: cargás los certificados que te emitió ARCA —se guardan encriptados— y listo. El dashboard te muestra tu consumo, tus API keys y tu plan.