Cómo empezar

Esta guía te lleva desde cero hasta emitir tu primera factura electrónica en menos de diez minutos. Asume que ya tienes una cuenta en Facturator y un plan que incluye acceso a la API.

1. Crea tu cuenta y elige un plan

Regístrate en /auth/register, completa el onboarding y contrata un plan que incluya acceso al API. Sin un plan activo, las llamadas serán rechazadas con HTTP 403.

2. Genera una API Key

Una vez dentro del panel, ve a Configuración → API Keys (/app/api-keys) y crea una clave nueva. La clave se mostrará una sola vez: cópiala y guárdala en tu gestor de secretos.

Whitelist de IPs (recomendado)

Al crear la clave puedes restringirla a una lista de direcciones IP. Si una llamada llega desde una IP fuera de la lista, la API responde HTTP 403.

3. Conoce la URL base

Todas las rutas listadas en esta documentación cuelgan del prefijo /api de la URL base de tu entorno:

Producción: https://www.factura-tor.com/api
Sandbox:    https://www.facturator.xyz/api

Ver Entornos y URL base para más detalle.

4. Tu primera llamada

El endpoint raíz devuelve un mensaje de prueba y sirve como health check para confirmar que tu API Key funciona:

curl -X GET https://www.factura-tor.com/api/ \
  -H "X-API-Key: tu_api_key_aqui" \
  -H "Accept: application/json"

Respuesta esperada (HTTP 200):

{
  "data": {
    "message": "API REST FULL de Facturación electrónica de One Soft"
  }
}

5. Próximos pasos

1. Importa la Colección Postman para probar los endpoints sin escribir código.
2. Lee Autenticación para entender los headers obligatorios.
3. Familiarízate con la Estructura de respuestas y con los códigos de error.
4. Sigue el flujo Onboarding del emisor para registrar tu negocio.
5. Cuando tu emisor esté listo, sigue Emisión de un comprobante.