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
Section titled “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).
Headers Requeridos
Section titled “Headers Requeridos”Debes incluir tu token de acceso en todas las peticiones HTTP mediante la cabecera personalizada x-api-token:
x-api-token: tu_token_aquiEjemplo de Petición (cURL)
Section titled “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
Section titled “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. |