Que tu tienda facture sola

Empezar

1. Activá el modo tienda. Entrá a tramitito.app/tienda con tu cuenta y activalo con un clic.
2. Creá una clave. Una por integración, así podés cortar el acceso de una sin tocar las demás. El secreto se muestra una sola vez: guardalo ahí mismo.
3. Probala sin emitir nada. Un GET /api/v1/yo te devuelve el estado de la cuenta y confirma que la clave anda.

Autenticación

Todos los pedidos llevan la clave en el header Authorization. Guardamos solo su hash: si la perdés, no se puede recuperar — se revoca y se crea otra.

Authorization: Bearer tk_live_9f2a...

Conectá tu plataforma, paso a paso

Para las tres plataformas el circuito es el mismo: creás la conexión en tu panel de tienda, el panel te da una URL de webhook y un secreto, y los pegás en tu plataforma. Desde ahí, cada venta pagada se factura sola. Lo que cambia entre plataformas es dónde se pegan y de dónde sale el secreto.

WooCommerce

La forma más fácil es el plugin oficial: no tocás webhooks y suma extras (el resultado anotado en cada pedido, el campo DNI/CUIT en el checkout y el botón "facturar ahora" para reintentos).

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. Se muestra una sola vez: copiala ahí mismo.
3. En WooCommerce → Tramitito, pegá la clave y elegí cuándo facturar: Procesando (apenas se acredita el pago) o Completado (cuando marcás el pedido como terminado).
4. Listo. La próxima venta queda facturada y anotada en el pedido, con el link al PDF.

¿Preferís el webhook nativo de Woo, sin plugin? En el panel creá la conexión WooCommerce (te da URL y secreto) y en WordPress andá a WooCommerce → Ajustes → Avanzado → Webhooks → Añadir webhook: estado Activo, tema Pedido actualizado, la URL en "URL de entrega", el secreto en "Secreto", versión de la API v3. Facturamos cuando el pedido está en Procesando o Completado; el resto de los estados se ignora.

Shopify

1. En tu admin de Shopify: Configuración → Notificaciones → Webhooks. Al pie de esa pantalla está el secreto de firma ("Tus webhooks estarán firmados con..."). Copialo — ojo: es ese, no la clave de API de Shopify.
2. En tu panel de tienda, Conectar tienda → Shopify: poné un nombre y pegá ese secreto. Te devuelve la URL del webhook.
3. De vuelta en Shopify, Crear webhook: evento Pago de pedido (orders/paid), formato JSON, y pegá la URL de Tramitito. Guardá.

Tiendanube

Es la única que pide tres datos, y hay una razón: el aviso de Tiendanube no trae el pedido (solo el número), así que Tramitito tiene que leerlo de su API con un token de tu tienda. Ese token sale de una aplicación de Tiendanube, aunque sea privada y solo tuya.

1. Creá una aplicación en partners.tiendanube.com (puede ser privada, para tu propia tienda). Anotá el Client ID y el Client Secret.
2. Instalala en tu tienda: entrá a https://www.tiendanube.com/apps/TU_CLIENT_ID/authorize, autorizá, y de la URL de retorno copiá el parámetro code.
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. Ese user_id es 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"}'

Si esto te suena a chino: es un trámite de 15 minutos para cualquier desarrollador — pasale esta página. Y si no tenés uno, escribinos por el chat de soporte y te acompañamos.

Zapier, Make o tu propio sistema

No usan conexiones: usan la API con clave. Creá la clave en el panel y armá un paso HTTP con el trigger "nueva venta pagada" de tu tienda: método POST a /api/v1/facturas, header Authorization: Bearer tu_clave y el body de la sección Emitir una factura. No te olvides de idempotencia con el número de pedido.

¿Qué pasa después de conectar?

• La primera venta pagada sale con factura en segundos. La ves en tu panel con su PDF.
• Si ARCA está caído, la factura queda en cola y se emite sola cuando vuelve.
• Si una venta no se puede facturar (por ejemplo, supera el tope de consumidor final y no vino el DNI), te avisamos por WhatsApp con el motivo y podés emitirla a mano.
• Las devoluciones se resuelven con la nota de crédito, desde el panel o por API.

Emitir una factura

Un pedido por venta. La respuesta ya trae el CAE y el link al PDF: no hay que esperar nada ni consultar después.

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 }
    ]
  }'

Respuesta

{
  "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
}

Qué significa cada respuesta

Qué letra de factura sale

No se elige desde la API: sale de la condición fiscal de la cuenta cruzada con el documento del comprador.

Devoluciones

ARCA no permite borrar un comprobante que ya tiene CAE. Una devolución se factura al revés: con una nota de crédito que anula la original.

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

Respuesta

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

La nota de crédito no cuenta contra el tope mensual del plan. Una factura no se puede anular dos veces, y una nota de crédito no se anula.

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..."

Devuelven el comprobante con su estado, el CAE, si está anulado y el link al PDF. Si el pedido todavía no se facturó, la búsqueda por idempotencia da 404.

Datos del cliente por DNI o CUIT

Con el documento del comprador, el padrón de ARCA devuelve quién es: nombre, condición frente al IVA y domicilio fiscal. Sirve para autocompletar el checkout o mostrar a quién le estás facturando. Acepta DNI (7 u 8 dígitos) o CUIT/CUIL (11).

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

Respuesta

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

404 si el documento no está en el padrón. Límite: 30 consultas por minuto (el padrón de ARCA es lento; conviene cachear del lado de la tienda). Al emitir la factura no hace falta llamar antes a este endpoint: el nombre y el domicilio se completan solos.

Campos de la emisión

Todos son opcionales salvo que mandes al menos monto o items.

También aceptamos fechaComprobante, servicioDesde y servicioHasta para casos donde la fecha de la venta no es la de hoy o estás facturando un período de servicio.

Límites

• 120 pedidos por minuto. Una tienda normal factura decenas por hora: el límite está para frenar un bucle de webhooks mal configurado antes de que llegue a ARCA.
• El tope del plan. Se aplica igual que en el bot y el panel. Una cuenta Gratis emite 5 facturas por mes y después recibe 422.
• Hasta 10 claves activas por cuenta, y 50 items por factura.

Si algo no anda

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

Preguntas frecuentes