¿Qué es Timbre?

Timbre es una API de facturación electrónica. Le mandás un JSON describiendo qué vendiste —código CAByS, cantidad, precio unitario— y se ocupa de todo lo fiscal hasta que Hacienda dicta un veredicto: aceptado, rechazado, o el motivo exacto por el que no pasó.

Lo que hace con esa venta

Entre el JSON que mandás y el veredicto de Hacienda, Timbre:

• Deriva el IVA de cada línea del catálogo CAByS —tarifa general, reducidas y exoneraciones del comprador cuando aplican— y calcula los totales.
• Valida el documento contra las reglas de la versión 4.4.
• Asigna el consecutivo oficial y arma la clave de 50 dígitos.
• Genera el XML, lo valida contra los XSD de Hacienda y lo firma con tu certificado.
• Lo presenta, lo sigue hasta que Hacienda dicta un veredicto, y te avisa con un webhook firmado.
• Si Hacienda lo acepta, dibuja también la representación en PDF.

Todos los artefactos que produjo por el camino —XML firmado, respuesta de Hacienda, PDF— quedan descargables y verificables por hash. Nada de eso lo hacés vos, y nada de eso lo ves hasta que lo pedís: la API responde con un estado, no con una interfaz.

Por qué existe

Emitir Factura Electrónica no es una decisión de producto para quien factura en Costa Rica: lo exige Hacienda, con una especificación —hoy la v4.4, antes la 4.3— que cambia cuando Hacienda decide y que cualquier empresa que factura tiene que implementar igual de bien, sin que eso la diferencie en nada de la empresa de al lado.

Timbre existe para ser esa implementación una sola vez, bien hecha, y exponerla como API en vez de que cada quien la repita puertas adentro. El motivo completo —y por qué eso sale mejor que construirlo vos— está en ¿Por qué Timbre?.

Lo que Timbre no hace

No maneja usuarios, planes ni facturación de tu negocio —eso vive en el control plane, no en el motor fiscal. No deriva impuestos específicos (los que no son IVA), y rechaza una línea a la tarifa transitoria del 8 %, que hoy no tiene código legal para una factura.

El PDF que sí genera no es el documento legal —eso es el XML firmado— y solo existe para documentos que Hacienda aceptó: uno rechazado no produce ninguno. Artefactos tiene el detalle.

Documentamos lo que existe. Si algo no aparece acá, no está.

Seguí