Primeros pasos

Factulit API v1 esta pensada para integraciones server-side que sincronizan datos de comercio con Factulit.

Base URL y entornos

Factulit expone dos entornos independientes. No comparten datos, y una clave emitida para uno no es valida en el otro.

Entorno	Base URL	Prefijo de clave	Destino de los registros
Pruebas	https://api.sandbox-factulit.es/api/v1	factulit_test_	Preproduccion de la AEAT (Preportal). Sin efectos fiscales.
Produccion	https://api.factulit.es/api/v1	factulit_live_	Servicio real de la AEAT. Los registros tienen efectos fiscales.

Desarrolla y prueba contra el entorno de pruebas. El prefijo de la clave decide a que entorno pertenece: enviar una clave factulit_test_ a la base URL de produccion devuelve 401, y al reves tambien. Produccion todavia no esta abierta a nuevas altas, asi que hoy el entorno de pruebas es el punto de partida de cualquier integracion.

Primera peticion

Usa claves ficticias en ejemplos y guarda las claves reales solo en configuracion server-side.

curl https://api.sandbox-factulit.es/api/v1/status/paid \
  -H "Accept: application/json" \
  -H "X-API-KEY: factulit_test_example_key"

Recursos principales

Recurso	Uso
client	Crear o actualizar clientes asociados a la integracion autenticada.
status	Crear o actualizar estados externos de pedido e indicar cuales son finales.
order	Sincronizar pedidos, lineas, cliente e intencion de ciclo fiscal.
key	Validar, rotar o actualizar credenciales API del negocio autenticado.

Flujo de integracion

1. Configura la API key en tu integracion server-side.
2. Sincroniza los estados de pedido de tu plataforma.
3. Sincroniza clientes cuando se creen o actualicen.
4. Sincroniza pedidos cuando cambie su estado fiscal, incluyendo pagos, cancelaciones y reembolsos.
5. Trata los 422 de validacion o cuota como errores de negocio, no como fallos transitorios.