Tu clave de API — Facturador Pulsando

Antes de empezar: hay dos claves, no una

Es la distinción más importante de esta guía, porque decide si tus documentos tienen valor tributario o no.

Clave	Va al ambiente	Tus documentos
`sk_test_...`	Certificación del SII (maullin)	No tienen validez tributaria. Sirven para integrar y probar.
`sk_live_...`	Producción del SII (palena)	Son documentos reales ante el SII.

Lo bueno: tu código no cambia entre una y otra. Es el prefijo de la clave el que decide el ambiente. Integras con sk_test, y el día que pasas a producción cambias la clave y nada más.

Toda empresa empieza en certificación Es el orden que exige el SII: primero pruebas, después producción. Por eso al principio solo vas a poder crear claves de prueba.

Paso 1 — Mira en qué etapa estás

Al entrar a tu panel, arriba de todo está tu avance de habilitación. Ahí ves exactamente qué pasos están listos y cuál sigue.

El recuadro de arriba muestra los 7 pasos hasta emitir en producción.

Los pasos son:

Datos de la empresa — RUT, giro, dirección.
Certificado digital — tu certificado del SII, cargado en el sistema.
Folios de certificación — folios de prueba.
Prueba en certificación — emitir de prueba cada tipo de documento que vas a usar.
Producción habilitada — cuando el SII te autoriza. Acá entra tu número de Resolución.
Folios de palena — tus folios reales.
Emitiendo en producción.

Paso 2 — Crea tu clave

En el menú lateral, Integraciones → API Keys, y luego el botón Nueva API Key.

Formulario de creación. El ambiente disponible depende de tu etapa.

Nombre descriptivo

Para ti, no para el sistema. Escribe dónde la vas a usar: "Integración Odoo", "Punto de venta sucursal centro". Cuando tengas varias y necesites revocar una, este nombre es lo único que te va a decir cuál.

Ambiente

Mientras estés en certificación, la única opción es Test. La opción Live aparece cuando el SII habilita tu producción.

Permisos

Elige el mínimo que necesites. Si la clave se filtra, el daño queda limitado a lo que ese permiso habilita.

Opción	Para qué sirve
IA / emisión recomendada	Emite y consulta sus propios documentos y folios. No ve tu registro de compras, tus proveedores ni tu RCV.
Contabilidad — solo lectura	Lee documentos y registros. No puede emitir nada.
Acceso completo	Todos los permisos. Úsala solo si de verdad los necesitas todos.
Personalizado	Eliges permiso por permiso.

La clave se muestra UNA sola vez Al crearla la vas a ver completa. Después queda enmascarada para siempre y no hay forma de recuperarla — ni nosotros la podemos ver, porque guardamos solo un hash. Cópiala y guárdala en un gestor de contraseñas o en las variables de entorno de tu sistema. Si la perdés, revocas esa y creas otra.

Paso 3 — Úsala

La clave viaja en el header X-Api-Key:

# Emitir una boleta electrónica
curl -X POST https://api.facturador.pulsandotech.cl/api/public/v1/dte \
  -H "X-Api-Key: sk_test_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_dte": 39,
    "fecha_emision": "2026-07-20",
    "items": [
      {"nombre":"Producto","cantidad":1,"precio_unitario":1190,"monto_item":1190}
    ],
    "totales": {"monto_neto":1000,"monto_iva":190,"monto_total":1190}
  }'

# Consultar el estado de un documento
curl https://api.facturador.pulsandotech.cl/api/public/v1/dte/123 \
  -H "X-Api-Key: sk_test_tu_clave"

El SII responde después, no en el momento La emisión te devuelve 201 con estado pendiente. El SII siempre contesta de forma asincrónica — ningún proveedor puede darte el veredicto en la misma llamada. Consultá el documento después, o configurá un webhook para que te avisemos cuando haya respuesta.

Nunca hagas esto

No pongas la clave en el navegador. Ni en JavaScript, ni en una app móvil, ni en un repositorio público. Cualquiera que la vea puede emitir documentos tributarios a nombre de tu empresa.
No la compartas por chat o correo. Si tuviste que mandarla, revócala y creá otra.
No uses una sola clave para todo. Una por sistema: así puedes revocar una sin dejar sin servicio a los demás.

Si sospechás que se filtró Revócala desde el panel. Deja de funcionar al instante y los documentos ya emitidos no se tocan. Después creas una nueva y actualizas tu sistema.

Preguntas que nos hacen seguido

¿Puedo tener varias claves?

Sí, y conviene. Una por sistema conectado.

Emití con la clave de prueba, ¿ese documento vale?

No. Los documentos de sk_test viven en el ambiente de certificación del SII y no tienen validez tributaria. Cuando pases a producción vas a emitir de nuevo, con folios reales.

¿Cuándo puedo crear una clave de producción?

Cuando el SII habilite tu empresa. Ese paso no depende de tu pago ni de nosotros: es el SII el que autoriza, y te entrega un número de Resolución que tenemos que cargar. En tu panel ves en qué etapa vas.

¿Alguien más puede ver mi clave?

No. Guardamos solo un hash, así que ni nuestro equipo puede leerla. Por eso también es que no te la podemos recuperar si la perdés.