> ## Documentation Index
> Fetch the complete documentation index at: https://a3erpapi.appcloud.es/llms.txt
> Use this file to discover all available pages before exploring further.

# A3ERP API: documentación oficial de la integración REST

> Integra A3ERP con cualquier aplicación mediante su API REST. Gestiona maestros, documentos, stock, producción y cartera con llamadas HTTP autenticadas.

La **A3ERP API** es un servicio REST que te permite integrar cualquier aplicación externa con tu instancia de A3ERP. Puedes leer y escribir maestros, crear y gestionar documentos de venta y compra, controlar el stock, gestionar órdenes de producción, operar sobre la cartera y mucho más, todo mediante llamadas HTTP estándar autenticadas con JWT.

<CardGroup cols={2}>
  <Card title="Inicio Rápido" icon="rocket" href="/inicio-rapido/configuracion-inicial">
    Configura e instala la API en tu servidor en minutos
  </Card>

  <Card title="Autenticación" icon="key" href="/conceptos/autenticacion">
    Obtén tu token JWT y aprende a autenticar todas tus llamadas
  </Card>

  <Card title="Referencia API" icon="code" href="/api/api-general">
    Explora todos los endpoints disponibles con ejemplos de petición y respuesta
  </Card>

  <Card title="Historial de versiones" icon="clock-rotate-left" href="/versiones">
    Consulta los cambios y novedades de cada versión
  </Card>
</CardGroup>

## ¿Cómo funciona?

La A3ERP API actúa como puente entre tu aplicación y la base de datos de A3ERP. Una vez instalada y configurada en tu servidor, expone endpoints REST que puedes invocar desde cualquier lenguaje o herramienta (Postman, curl, Python, JavaScript, etc.).

<Steps>
  <Step title="Configura el archivo Config.ini">
    Edita los parámetros de conexión a la base de datos, el puerto de escucha y las rutas de logs y ficheros temporales usando el programa **CfgAPI.exe**.
  </Step>

  <Step title="Instala el servicio Windows">
    Ejecuta `Instalar.bat` para registrar la API como servicio de Windows e inícialo desde el Administrador de servicios.
  </Step>

  <Step title="Obtén tu token JWT">
    Llama a `POST /api/login` con tus credenciales en Base64. Recibirás un token JWT que debes incluir en la cabecera `Authorization: Bearer` de todas las peticiones.
  </Step>

  <Step title="Empieza a llamar a la API">
    Ya puedes consultar maestros, crear documentos, gestionar stock y mucho más. Consulta la [Referencia API](/api/api-general) para ver todos los endpoints disponibles.
  </Step>
</Steps>

## Áreas principales

<CardGroup cols={3}>
  <Card title="Maestros" icon="database" href="/api/maestro">
    Clientes, proveedores, artículos, almacenes y cualquier maestro de A3ERP
  </Card>

  <Card title="Documentos" icon="file-invoice" href="/api/documento">
    Ofertas, pedidos, albaranes, facturas y toda la cadena documental
  </Card>

  <Card title="Stock" icon="boxes-stacked" href="/api/stock">
    Consulta y gestiona el inventario por almacén, artículo, lote y ubicación
  </Card>

  <Card title="Producción" icon="industry" href="/api/produccion/ordenes-de-produccion">
    Órdenes de producción, fases, componentes, máquinas y operarios
  </Card>

  <Card title="Cartera" icon="coins" href="/api/cartera">
    Anticipos, vencimientos, remesas y domiciliaciones bancarias
  </Card>

  <Card title="Informes" icon="chart-bar" href="/api/fastreport">
    Genera PDFs con FastReport, listados y vistas personalizadas
  </Card>
</CardGroup>

## Requisitos

<Note>
  La A3ERP API requiere **a3ERP versión 14** o superior y el diccionario **JNCAPI** instalado en tu instancia.
</Note>