Autenticación API

Para interactuar con la API de FEL System, es obligatorio incluir un token de acceso válido en cada petición. Este token identifica a la sucursal y el punto de venta asociado.

Para más detalles sobre los ambientes disponibles, consulta la guía de Endpoints y Entornos.

Cómo Obtener tu Token de Acceso

Para solicitar tu token de acceso, sigue estos pasos:

Ingresa al Portal: Visita la plataforma oficial en refacture.rewarestudios.com para iniciar el proceso de solicitud.
Contacto con Desarrolladores: Ponte en contacto con el equipo de soporte y desarrollo a través del portal. Te solicitarán la información fiscal y legal obligatoria de acuerdo con las regulaciones de facturación electrónica.
Costo de Registro: La inscripción y configuración inicial del servicio tiene un costo único de $20.00 USD.
Configuración del Entorno de Pruebas: El equipo gestionará el registro de tu empresa/sucursal en el ambiente de pruebas del Ministerio de Hacienda.
Emisión de Credenciales: Una vez completado el registro, recibirás tus claves de facturación electrónica junto con tu token único de acceso (x-api-token).

Autenticación usando el SDK

Si estás integrando desde Node.js o TypeScript, no necesitas preocuparte por configurar cabeceras manuales en cada petición. El SDK oficial se encarga de esto de forma automática al inicializar el cliente:

import { FELSystem } from "@rewarestudios/fel-system";

const fel = new FELSystem({
  apiKey: "tu_token_aqui",
  environment: "test" // o "production"
});
// Todas las llamadas subsiguientes (ej. fel.facturas.crear) irán autenticadas automáticamente.

Para más detalles sobre la inicialización, visita la Guía del SDK de Node.js.

Ejemplo de Petición (cURL)

curl -X GET "https://felsystemapitest.rewarestudios.com/api/dte/information" \
     -H "x-api-token: 1234567890abcdef" \
     -H "Content-Type: application/json"

Respuestas de Error Comunes

Código	Mensaje	Descripción
401	`API Token requerido`	No se envió ningún token en los headers.
403	`API Token inválido o expirado`	El token enviado no existe, ha sido revocado o ya expiró.
429	`Límite mensual alcanzado`	La sucursal ha llegado al límite de documentos permitidos por su plan.