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.


    • Related Articles

    • ¿Cómo gestionar usuarios y roles en SiFactura?

      Introducción Desde Usuarios y Roles podés administrar quiénes tienen acceso a tu cuenta de SiFactura y qué pueden hacer dentro del sistema. Cada usuario puede tener permisos distintos según el módulo en el que trabaje, lo que te permite controlar ...

    • ¿Cómo crear la cuenta en SiFactura?

      1. Acceder a la página de registro Ingresa a la página de registro según tu país: Para usuarios de Argentina: https://sifactura.com.ar/app/registrarme Para usuarios de Chile: https://www.sifactura.cl/app/registrarme Desde esta página podrás ...

    • ¿Cómo crear una cuenta en el Plan de Cuenta de SiFactura?

      Cómo crear una cuenta en el Plan de Cuentas de SiFactura El Plan de Cuentas en SiFactura permite organizar las cuentas contables de tu empresa. Para crear una nueva cuenta, sigue estos pasos: 1. Accede a la sección Plan de Cuentas Ingresa a tu cuenta ...

    • ¿Cómo crear una subcuenta en el Plan de Cuenta de SiFactura?

      Cómo crear una subcuenta en el Plan de Cuentas Podés crear subcuentas dentro de una cuenta principal para tener un mayor nivel de detalle en tu contabilidad. 1. Ingresa al Plan de Cuentas Accede a Contable > Plan de Cuenta. Ubica la cuenta principal ...

    • ¿Cómo crear un cliente del extranjero SiFactura?

      1. Accede a la sección correspondiente En el menú lateral, dirígete a la sección “Base de datos” > “Cliente”. Haz clic en el botón “Crear cliente”. A continuación, se abrirá una ventana emergente con un formulario dividido en secciones. Botón para ...