Credenciales del API y activar producción
Primeros pasos · 4 min de lectura
El usuario y la clave con los que tus comprobantes viajan a Hacienda, y cómo dejás la empresa lista para facturar.
Por qué son dos cosas distintas
Mucha gente confunde la llave con las credenciales, y son cosas separadas que hacen trabajos separados:
- La llave criptográfica (
.p12+ PIN) firma el comprobante. Es lo que prueba que lo emitiste vos. - Las credenciales del API (un usuario y una clave) transmiten el comprobante ya firmado a Hacienda. Son la puerta por la que entra.
Necesitás las dos. Las dos son gratis y salen de TRIBU-CR.
Generá las credenciales en TRIBU-CR
En el portal, buscá la sección de comprobantes electrónicos y generá el usuario y la clave del API. El usuario es un correo largo con un dominio de Hacienda; la clave es una cadena de caracteres.
Fijate en qué ambiente las generás. Las de producción son las que emiten documentos con validez fiscal real; las de pruebas no sirven para facturar de verdad. Si te equivocás, los comprobantes van a rebotar.
Cargalas en Guaba
Entrá a Configurar facturación y pegá el usuario y la clave junto con tu llave. Se guardan cifradas, igual que la llave.
Activá producción
Al guardar, hacemos una prueba real: abrimos tu llave con el PIN y nos autenticamos contra Hacienda, sin emitir nada. Si las dos cosas funcionan, tu empresa queda activa y ya podés facturar.
Esa validación existe para que descubras un problema de credenciales ahora y no con tu primer cliente esperando la factura.
Si la validación falla
- Error de PIN — el archivo y el PIN no son pareja. Volvé a la guía de la llave.
- Usuario o clave rechazados — casi siempre es un espacio de más al copiar y pegar, o credenciales del ambiente equivocado.
- Hacienda no responde — a veces sus servicios se caen. No es tu configuración; probá de nuevo en un rato.
Lo que sigue
Con la empresa activa, ya podés emitir tu primera factura.
Sigue
Tu primera factura →