Registrá tu empresa
← Centro de ayuda

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.
Llave .p12 + PINtu firma digitalFIRMAel comprobanteprueba que lo emitiste vosUsuario + clave APItu llave de entradaTRANSMITEa HaciendaHaciendaacepta o rechazalas dos son gratis, de TRIBU-CR

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.

TRIBU-CRingresás con tu cédula y tu claveComprobantes electrónicosla misma sección de la llaveGenerar credenciales del APIelegí el ambiente de PRODUCCIÓNUsuario y clavecopialos completos, sin espacios

Cargalas en Taxo

Entrá a Configurar facturación y pegá el usuario y la clave junto con tu llave. Se guardan cifradas, igual que la llave.

Paso 1 de Configurar facturación: la zona para soltar el archivo .p12, el campo del PIN de la llave y, debajo, el usuario y la clave del API, con el botón Guardar y continuar.
Las cuatro cosas van en la misma pantalla. Se guardan cifradas: ni nosotros las vemos.
  1. El archivo .p12 que bajaste de TRIBU-CR.
  2. El PIN de esa llave, el que elegiste al generarla.
  3. El «Usuario del API»: empieza con cpf- y NO es tu correo. Ahí se traba casi todo el mundo.
  4. La clave del API, que TRIBU-CR muestra una sola vez.

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.

El último paso de Configurar facturación: la prueba que abre la llave con el PIN y se autentica contra Hacienda sin emitir nada.
El último paso de Configurar facturación: la prueba que abre la llave con el PIN y se autentica contra Hacienda sin emitir nada.

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 →