Aprende cómo crear y gestionar API Keys en SiFactura

¿Cómo crear y gestionar API Keys en SiFactura?

1. ¿Qué es la API de SiFactura?

La API de SiFactura permite integrar tu propio sistema con nuestra plataforma. La autenticación se realiza mediante API Keys.

2. Requisitos previos

Para poder crear API Keys necesitas:

  • Tener una cuenta activa en SiFactura. Si todavía no la tienes, primero debes registrarte.
  • Contar con los roles api key create y api key delete asignados en tu cuenta.
Roles API activos

3. Crear una API Key

  1. Ir a Ajustes > Api.
  2. Hacer clic en + Crear API Key.
  3. Completar los siguientes campos:
    • Nombre: identificador interno para reconocer la key (por ejemplo, el nombre de tu sistema o empresa).
    • Ambiente: selecciona Test para pruebas o Producción para uso real.
    • Scopes: selecciona los permisos que necesita la integración. Los disponibles son:
      • factura:create — crear facturas
      • factura:read — leer facturas
      • producto:create — crear productos
      • producto:read — leer productos
      • cliente:create — crear clientes
      • cliente:read — leer clientes
      • remito:create — crear remitos
      • remito:read — leer remitos
  4. Hacer clic en Guardar.
Info
Al guardar, el sistema mostrará una única vez la API Key y el API Secret. Cópialos y guárdalos en un lugar seguro antes de cerrar esta ventana. El API Secret no se volverá a mostrar.
Desde esta ventana también puedes hacer clic en Exportar Keys para descargarlos.

4. Ambientes de prueba y producción

Para evitar mezclar facturas de prueba con facturas reales, se recomienda crear dos cuentas separadas en SiFactura: una para testing y otra para producción.

Cuenta de testing:

  • Utilizala exclusivamente para desarrollar y probar la integración.
  • Crea la API Key con ambiente Test.
  • Crea un punto de venta con un número que no sea habitual en tu operatoria (por ejemplo, 300), para que sea fácilmente identificable como punto de venta de pruebas y no se confunda con los de producción. Este punto de venta no requiere darse de alta en ARCA, pero sí debe crearse dentro de SiFactura desde Ajustes > Puntos de venta.

Cuenta de producción:

  • Utilizala una vez que la integración esté lista y probada.
  • Crea la API Key con ambiente Producción.
  • Configura los puntos de venta reales desde Ajustes > Puntos de venta.
Info
Se recomienda crear el punto de venta de testing con un número que no sea habitual en tu operatoria (por ejemplo, 300), para que sea fácilmente identificable como punto de venta de pruebas y no se confunda con los de producción.

5. Gestionar las API Keys

Desde el listado en Ajustes > Api puedes ver para cada key: nombre, ambiente, estado de habilitación, rate limit, scopes, fecha de expiración, fecha de creación y último uso.

Desde Acciones puedes:

  • Rotar la key: deshabilita la API Key anterior y genera una nueva con la misma cuenta, ambiente, scopes y límites. El nuevo API Secret se muestra solo en esta respuesta.
  • Eliminar la key.
Info
 Las API Keys tienen una vigencia de 30 días. Pasado ese plazo expiran y deben rotarse o crearse nuevamente.
Idea
La gestión de API Keys (creación, rotación, habilitación/deshabilitación y eliminación) también puede realizarse a través de la API. Consultá la documentación técnica para más detalles: 🔗 Documentación API SiFactura

5. Próximos pasos para el desarrollador

Con la API Key y el API Secret, el desarrollador puede comenzar a realizar llamadas a la API en el ambiente Test para probar la integración antes de pasar a Producción.