Documentación · API v1

API de facturación electrónica ARCA

Una clave, un pedido HTTP por venta, y la factura sale con CAE y QR de ARCA. Sin certificados, sin WSAA, sin SOAP: de eso nos ocupamos nosotros.

Los endpoints

Autenticación

Las claves se crean en tu panel de tienda, sección Claves de API — una por integración, revocable sin tocar las demás, hasta 10 activas. El secreto se muestra una sola vez: guardamos solo su hash. Si se pierde, se revoca y se crea otra.

Authorization: Bearer tk_live_9f2a...

Con la clave mal puesta la API responde 401; si la cuenta apagó el modo tienda, 403; y si todavía le falta CUIT o punto de venta, 409. Los tres traen su código estable.

Tu primera factura

1. Activá el modo tienda en tramitito.app/tienda. La cuenta necesita su CUIT y su autorización en ARCA (se hace una sola vez).
2. Creá una clave y guardala donde guardás secretos: se muestra una sola vez.
3. Probala sin emitir nada: GET /api/v1/yo confirma que la clave anda y que la cuenta está lista.
4. Emití una factura de monto chico con el ejemplo de Emitir una factura y anulala con su nota de crédito. Es una factura fiscal de verdad: así se prueba.

WooCommerce

Lo más fácil es el plugin oficial: sin webhooks, con el resultado anotado en cada pedido, el campo DNI/CUIT en el checkout y el botón «facturar ahora».

1. Descargá tramitito-woocommerce.zip y subilo en Plugins → Añadir nuevo → Subir plugin. Activalo.
2. En tramitito.app/tienda, sección Claves de API, creá una clave.
3. En WooCommerce → Tramitito, pegá la clave y elegí cuándo facturar: Procesando (al acreditarse el pago) o Completado.

¿Sin plugin? Conexión WooCommerce en el panel (te da URL y secreto) y un webhook en WooCommerce → Ajustes → Avanzado → Webhooks: Activo, tema Pedido actualizado, API v3. Facturamos en Procesando o Completado; el resto se ignora.

Shopify

1. En Shopify: Configuración → Notificaciones → Webhooks. Al pie está el secreto de firma («Tus webhooks estarán firmados con...»). Es ese, no la clave de API.
2. En tu panel de tienda, Conectar tienda → Shopify: nombre y ese secreto. Te devuelve la URL del webhook.
3. En Shopify, Crear webhook: evento Pago de pedido (orders/paid), formato JSON, la URL de Tramitito.

Tiendanube

Pide tres datos: su aviso no trae el pedido, así que Tramitito lo lee de su API con el token de una aplicación de Tiendanube tuya, aunque sea privada.

1. Creá una aplicación en partners.tiendanube.com (puede ser privada). Anotá el Client ID y el Client Secret.
2. Instalala: entrá a https://www.tiendanube.com/apps/TU_CLIENT_ID/authorize, autorizá y copiá el parámetro code de la URL de retorno.
3. Canjeá ese código por el token:

   curl -X POST https://www.tiendanube.com/apps/authorize/token \
     -d 'client_id=TU_CLIENT_ID' \
     -d 'client_secret=TU_CLIENT_SECRET' \
     -d 'grant_type=authorization_code' \
     -d 'code=EL_CODE_DEL_PASO_2'

   La respuesta trae access_token y user_id: el ID de tu tienda (store_id).
4. En tu panel, Conectar tienda → Tiendanube: nombre, el ID de la tienda (user_id), el token (access_token) y el secreto (client_secret). Te devuelve la URL del webhook.
5. Registrá el webhook del evento order/paid apuntando a esa URL:

   curl -X POST https://api.tiendanube.com/v1/TU_STORE_ID/webhooks \
     -H 'Authentication: bearer TU_ACCESS_TOKEN' \
     -H 'Content-Type: application/json' \
     -d '{"url": "LA_URL_QUE_TE_DIO_TRAMITITO", "event": "order/paid"}'

¿Te suena a chino? Para un desarrollador son 15 minutos: pasale esta página. Si no tenés uno, escribinos por el chat de soporte.

Zapier, Make o tu propio sistema

Van por la API con clave: en el trigger «nueva venta pagada», un paso HTTP con POST a /api/v1/facturas, header Authorization: Bearer tu_clave y el body de Emitir una factura. No te olvides de idempotencia.

POST Emitir una factura

POST /api/v1/facturas

Un pedido por venta. La respuesta ya trae el CAE y el link al PDF.

curl -X POST https://tramitito.app/api/v1/facturas \
  -H "Authorization: Bearer tk_live_9f2a..." \
  -H "Content-Type: application/json" \
  -d '{
    "idempotencia": "pedido-1234",
    "doc": "20111111112",
    "nombre": "Juan Pérez",
    "items": [
      { "descripcion": "Zapatillas running", "importe": 80000 },
      { "descripcion": "Envío", "importe": 5000 }
    ]
  }'

const r = await fetch('https://tramitito.app/api/v1/facturas', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TRAMITITO_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    idempotencia: pedido.id,        // el id de TU sistema
    doc: cliente.cuit,              // sin doc: consumidor final
    items: pedido.lineas.map((l) => ({
      descripcion: l.nombre,
      importe: l.total,
    })),
  }),
});

// 202 = ARCA no responde: la factura ya existe y sale sola. No reintentes.
const { factura } = await r.json();
guardar(pedido.id, factura.cae, factura.urlPdf);

$ch = curl_init('https://tramitito.app/api/v1/facturas');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('TRAMITITO_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'idempotencia' => $pedido->id,
    'doc' => $cliente->cuit,
    'items' => [
      ['descripcion' => 'Plan mensual', 'importe' => 45000],
    ],
  ]),
]);

$factura = json_decode(curl_exec($ch), true)['factura'];
// $factura['cae'], $factura['numero'], $factura['urlPdf']

import os, requests

r = requests.post(
    "https://tramitito.app/api/v1/facturas",
    headers={"Authorization": f"Bearer {os.environ['TRAMITITO_KEY']}"},
    json={
        "idempotencia": pedido.id,
        "doc": cliente.cuit,
        "items": [{"descripcion": "Plan mensual", "importe": 45000}],
    },
    timeout=30,
)

# 202 = ARCA caído: queda en cola y se emite sola
factura = r.json()["factura"]

{
  "ok": true,
  "factura": {
    "id": "clx8y2m4k0001",
    "numero": 143,
    "cae": "75123456789012",
    "estado": "EMITIDA",
    "concepto": "Venta online (2 productos)",
    "urlPdf": "https://tramitito.app/facturas/clx8y2m4k0001/pdf"
  },
  "repetida": false,
  "error": null
}

Campos de la emisión

Todos opcionales, salvo que tenés que mandar al menos monto o items.

Items, descuentos y tributos

Cada item es un renglón del PDF: descripcion (hasta 200), importe (lo que se cobra, ya con el descuento aplicado) y, opcional, bonificacionPorc — el descuento del renglón en porcentaje, que se imprime en la columna «% Bonif».

Los tributos son percepciones o retenciones que le cobrás al comprador además del IVA (IIBB, municipales, internos). Se suman al total: el comprobante sale por monto + tributos.

{
  "idempotencia": "pedido-1235",
  "items": [
    { "descripcion": "Monitor 27\"", "importe": 405000, "bonificacionPorc": 10 }
  ],
  "tributos": [
    {
      "tipo": 2,
      "descripcion": "Percepción IIBB Córdoba",
      "baseImponible": 405000,
      "alicuota": 3,
      "importe": 12150
    }
  ]
}

Qué letra de factura sale

No se elige desde la API: la deciden la condición fiscal de la cuenta y el documento del comprador.

Estados del comprobante

POST Notas de crédito

POST /api/v1/facturas/{id}/nota-credito

ARCA no borra un comprobante con CAE: una devolución se anula con una nota de crédito.

curl -X POST https://tramitito.app/api/v1/facturas/clx8y2m4k0001/nota-credito \
  -H "Authorization: Bearer tk_live_9f2a..."

{
  "ok": true,
  "notaCredito": {
    "id": "clx9a1b2c0002",
    "letra": "NC-C",
    "numero": 12,
    "urlPdf": "https://tramitito.app/facturas/clx9a1b2c0002/pdf"
  }
}

No cuenta contra el tope del plan. Una factura no se anula dos veces, una nota de crédito no se anula, y una factura que todavía no salió (PENDIENTE) no se puede anular: cada caso devuelve 409 con su código.

GET Consultar comprobantes

# Por el id que devolvió la emisión
curl https://tramitito.app/api/v1/facturas/clx8y2m4k0001 \
  -H "Authorization: Bearer tk_live_9f2a..."

# Por número de pedido: sirve para reconciliar
curl "https://tramitito.app/api/v1/facturas?idempotencia=pedido-1234" \
  -H "Authorization: Bearer tk_live_9f2a..."

{
  "factura": {
    "id": "clx8y2m4k0001",
    "tipo": "Factura C",
    "numero": 143,
    "puntoVenta": 3,
    "concepto": "Venta online (2 productos)",
    "monto": 85000,
    "estado": "EMITIDA",
    "cae": "75123456789012",
    "caeVencimiento": "2026-09-01T00:00:00.000Z",
    "fecha": "2026-08-22T00:00:00.000Z",
    "anulada": false,
    "idempotencia": "pedido-1234",
    "error": null,
    "urlPdf": "https://tramitito.app/facturas/clx8y2m4k0001/pdf"
  }
}

urlPdf es null hasta que el comprobante esté EMITIDO. Si el pedido no se facturó, la búsqueda por idempotencia devuelve 404.

GET Padrón: datos del cliente

GET /api/v1/clientes/{doc}

Con el DNI (7 u 8 dígitos) o CUIT/CUIL (11) del comprador, el padrón de ARCA devuelve nombre, condición frente al IVA y domicilio fiscal. Sirve para autocompletar el checkout.

curl https://tramitito.app/api/v1/clientes/20111111112 \
  -H "Authorization: Bearer tk_live_9f2a..."

{
  "ok": true,
  "cliente": {
    "doc": "20111111112",
    "nombre": "PÉREZ JUAN",
    "condicionIva": "MONOTRIBUTO",
    "domicilio": "AV SIEMPRE VIVA 742, CÓRDOBA, CÓRDOBA, CP 5000"
  }
}

404 si no está en el padrón, 503 si el padrón de ARCA no responde. Límites: 30 por minuto y 600 por día (el padrón es lento; conviene cachear). Al emitir no hace falta llamarlo antes: nombre y domicilio se completan solos.

GET La cuenta

GET /api/v1/yo

Verifica la clave y el estado de la cuenta sin emitir nada: es el primer request que conviene hacer al configurar una integración.

{
  "cuenta": {
    "nombre": "Lucía Fernández",
    "cuit": "27222222223",
    "condicionFiscal": "MONOTRIBUTO",
    "puntoVenta": 3,
    "plan": "COMPLETO",
    "facturasPorMes": null,
    "listaParaFacturar": true
  },
  "topeConsumidorFinal": 10000000
}

facturasPorMes en null significa sin tope mensual. El topeConsumidorFinal es el monto de ARCA desde el que una venta exige identificar al comprador (ver Qué letra sale).

Errores

Todos los errores traen error (mensaje en castellano, pensado para mostrarse) y codigo (estable: tu integración puede ramificar sobre él sin parsear texto).

Límites

Si algo no anda

¿Otra cosa? Escribinos por el chat de soporte y lo vemos.