Guías

¿Qué es una API?

Qué es una API explicado sin jerga, y qué significa que tu software emita facturas electrónicas por API con Timbre.

Una API es la forma en que dos programas se hablan sin que una persona tenga que estar en el medio. Si tu software ya cobra, agenda o vende, una API es lo que le permite, además, emitir la factura electrónica de esa venta por su cuenta.

La idea en una frase

Pensá en un salonero. Tu software le hace el pedido ("esta venta, a este cliente, por este monto"), el salonero lo lleva a la cocina, y vuelve con la respuesta. Tu software no necesita saber cómo funciona la cocina; solo tiene que pedir bien.

Con Timbre, la cocina es Hacienda. Tu software manda la venta, Timbre la convierte en un comprobante electrónico válido, lo presenta ante Hacienda y le avisa a tu software qué respondió.

Cómo se ve con una factura

Cuando se cierra una venta en tu producto, tu sistema le manda a Timbre qué se vendió, a quién y por cuánto. Al emitirla, recibe de vuelta la clave de 50 dígitos y el número consecutivo que identifican esa factura (Emitir).

Hacienda no resuelve al instante. Timbre sigue el documento hasta que Hacienda lo acepta o lo rechaza, y en ese momento le avisa a tu sistema con un mensaje firmado (Estados, Webhooks). Si Hacienda está lenta o caída un rato, Timbre reintenta solo.

Qué construye tu equipo y qué no

Lo que tu equipo construye:

Lo que tu equipo no construye: el XML, la firma digital, la numeración sin huecos, el cálculo del impuesto, la conversación con Hacienda ni los reintentos. Eso es lo que resuelve Timbre. Si querés ver la lista completa de lo que implica hacerlo por tu cuenta, está en ¿Por qué no conectarme directo a Hacienda?.

Lo que sí te toca una vez

Timbre firma en nombre de tu negocio, así que necesita dos cosas que solo Hacienda te puede dar: tu usuario y contraseña de Hacienda para facturación electrónica, y tu llave criptográfica (un archivo .p12 con su PIN). Se sacan desde el portal de Hacienda, una vez para el ambiente de pruebas y otra para producción. Credenciales de Hacienda muestra cada pantalla, y Configurar producción dice qué cambia al pasar a facturas reales.

Preguntas frecuentes

¿Necesito programadores para usar Timbre?
Sí, alguien que sepa conectar tu software a una API. Lo hace una vez, y no necesita conocer el formato XML ni las reglas de Hacienda: eso lo resuelve Timbre.
¿Qué pasa si mi sistema se cae justo cuando está facturando?
Tu sistema vuelve a mandar la misma venta con la misma llave de idempotencia, y Timbre le devuelve la factura que ya existía en lugar de emitir otra. Una venta nunca queda facturada dos veces.
Ya uso un sistema de facturación, ¿me sirve Timbre?
Timbre es para cuando la factura tiene que salir desde adentro de tu propio software, sin que nadie la haga a mano. Si tu negocio ya factura bien con otro sistema y no tenés un producto propio que conectar, probablemente no lo necesitás.