Crea una cuenta

Todo empieza en app.stackin.io — regístrate e inicia sesión. No existe una cuenta "de desarrollador" separada: el mismo login se usa en el dashboard donde administras empresas, keys y facturación.

Antes de crear una key, registra una empresa — no se puede saltar este paso, es la identidad bajo la cual se emite cada documento (identificación fiscal, dirección, régimen tributario). Una cuenta puede tener varias empresas, cada una con sus propias keys y su propio saldo de créditos.

En la pantalla Settings → API key de la empresa, crea una key y elige el contexto: sdk si vas a usar una de las bibliotecas cliente oficiales, o api si vas a llamar a la API REST directamente con un token Bearer. El contexto queda fijo durante toda la vida de la key y decide qué superficie autentica — una key con contexto sdk no funciona como header Authorization de API cruda, y viceversa.

Elige también el entorno de la key — homologation o production, por defecto homologation — fijado en la creación junto con el contexto. Una empresa puede tener hasta 3 keys en total, cualquier combinación de contexto y entorno. Ver Entornos para cómo esa elección afecta cada solicitud.

Copia la key de inmediato después de crearla — se muestra una sola vez, en el momento de la creación, y no se puede recuperar después. Si se pierde, la solución es revocarla y crear otra, no intentar buscarla más tarde.

Algo que la key sola no habilita: emitir un documento de verdad requiere que el certificado digital de la empresa (.pfx/.p12) ya esté subido, ya que es lo que firma el documento para el autorizador del gobierno. La key puede crearse y usarse para llamadas de solo lectura antes de eso, pero la emisión fallará sin el certificado.