28 endpoints de ARCA · un solo login

Navegá por ARCA con Noé.

Emití facturas, bajá comprobantes, consultá el padrón. Una API y un login en lugar de mantener SOAP, certificados y alguien que sepa de AFIP.

Pegá esto en tu agente

Pedí tu acceso en la consola de Arcanoe (/app/keys) y conseguí tu key test. Leé https://api.arcanoe.com.ar/api/v2/openapi.json como fuente de verdad del contrato y probá el primer 200 antes de cablear nada. La clave fiscal viaja cifrada por request y nunca se persiste: frená antes de lo fiscal.

Pegalo en

Sacá tu key Ver la doc →

Entrás con GitHub o Google y emitís tu key en la consola. Hoy está abierto para pruebas y no se cobra; más adelante se cobra por request.

https://api.arcanoe.com.ar/api/v2OpenAPI 3.1.0

POST /ws/wsfe/vouchers201

Facturación electrónica

CAE

74012345678901

cae_fch_vto 20260928 · numero 11

Reintentás con la misma Idempotency-Key y vuelve con replay: true: la factura ya estaba emitida y no se emite dos veces.

{
  "servicio": "wsfe",
  "ambiente": "homologacion",
  "numero": 11,
  "cae": "74012345678901",
  "idempotency_key": "orden-12345",
  "replay": false
}

GET /jobs/{job_id}200

Mis Comprobantes · extracción masiva

declarado: 400
obtenido: 363

El motivo no se esconde: guardia_conteo — la clave fiscal se transmitió una sola vez.

{
  "estado": "parcial",
  "login": { "estado": "ok",
             "transmisiones_de_clave": 1 },
  "servicios": [
    { "servicio": "mc_recibidos",
      "estado": "fallido",
      "motivo": "guardia_conteo",
      "conteo": { "declarado": 400,
                  "obtenido": 363 } }
  ]
}

Respuestas reales de POST /api/v2/ws/wsfe/vouchers y GET /api/v2/jobs/{job_id}, según spec/openapi.yaml. Valores de una corrida de ejemplo; WSFE corre siempre en homologacion.

Nadie conoce ARCA como Noé

Lo que ARCA te da, sin que lo mantengas.

Emitir, extraer, consultar. La misma API y la misma key para los seis servicios, y la verdad escrita cuando algo no sale.

Emitir facturas sin duplicarlas

La emisión es idempotente y hace reconciliación previa. Si reintentás con la misma Idempotency-Key, vuelve replay: true en vez de emitir un segundo comprobante.

Un solo login

La clave fiscal se transmite una vez por corrida, cifrada con RSA-OAEP-SHA256. No custodianos contraseñas.

28 endpoints, 6 servicios

Una API y una key para todo: mc_*, wsfe, padrón, granos, hacienda y carta de porte. Sumar un servicio no es sumar una integración nueva.

Extracción masiva, con el número real

Arrastramos los comprobantes del período que pidas. Y si el conteo no cierra, la corrida queda parcial con el motivo escrito: nunca un «listo» mentiroso.

La integración la escribe tu agente

El contrato se sirve a sí mismo. Pegás la URL en tu agente y sale el cliente.

Encolás y no bloqueás

La extracción es asincrónica: POST /jobs devuelve 202 con un job_id al instante. Tu request no espera a ARCA; el resultado lo consultás cuando está.

Y cuando algo sale mal no adivinás: los 21 motivos de error están publicados con su descripción en spec/openapi.yaml — 9 en la taxonomía de la extracción y 12 en la de la superficie WS. Las dos son cerradas; la de la extracción resuelve lo que no encaja en ninguna con interno.

Primeros 5 minutos

De la key al primer 200.

Tres pasos, en este orden. El primero depende de vos; los otros dos son copiar y pegar.

1
Sacá la key
Entrás con GitHub o Google y emitís la key en la consola. Se muestra una sola vez, así que copiala en ese momento: si la perdés se rota y no se recupera.
Ir a la consola →
2
Hacé el primer request
Contra el endpoint de liveness. Nunca lee credenciales y no emite comprobantes: sirve para ver que la key viaja bien y que el servidor de ARCA te contesta.
GET /api/v2/ws/status
```
export ARCA_KEY="la key que copiaste"
curl -sS -w "\nHTTP %{http_code}\n" "https://api.arcanoe.com.ar/api/v2/ws/status" \
  -H "Authorization: Bearer $ARCA_KEY"
```
Vuelve 200 con cinco campos, todos requeridos por el contrato:
servicio
el servicio que contestó
ambiente
homologacion con una key de test, produccion con una de live
app_server
AppServer informado por AFIP
db_server
DbServer informado por AFIP
auth_server
AuthServer informado por AFIP
3
Leé el contrato, o pegalo en tu agente
La referencia endpoint por endpoint está en la doc. Y si la integración la escribe un agente, el spec en vivo es la fuente de verdad: se lo pasás y trabaja contra el contrato, no contra este texto.

La doc completa vive en /docs y el contrato en vivo se sirve en https://api.arcanoe.com.ar/api/v2/openapi.json.