> ## 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.

# Listados: imprime informes estándar de A3ERP por API

> Llama a POST /api/listado/{formato} para imprimir cualquier listado estándar de A3ERP pasando sus parámetros de impresión en formato JSON.

El endpoint de listados te permite lanzar cualquiera de los informes estándar de A3ERP de forma programática. Solo tienes que indicar el formato del listado en la ruta y pasar los parámetros de impresión en el cuerpo de la petición como JSON. Esto hace posible generar y descargar informes directamente desde tus integraciones, sin necesidad de abrir la aplicación de escritorio.

<Note>
  La lista completa de formatos de listado disponibles y sus parámetros de impresión está documentada en el archivo **"Listados desde A3ERPActivex.docx"**. Puedes obtener este documento a través de tu distribuidor de A3ERP.
</Note>

***

## POST — Imprimir listado

Genera el listado indicado aplicando los parámetros de impresión proporcionados en el cuerpo de la petición.

```http theme={null}
POST https://servidor:<puerto>/api/listado/{formato}
```

### Parámetros

<ParamField path="formato" type="string" required>
  El nombre del archivo del listado a imprimir, incluyendo su extensión. Por ejemplo: `ListadoClientes.lst`.
</ParamField>

<ParamField header="Authorization" type="string" required>
  Token de autenticación en formato `Bearer <JWT_token>`.
</ParamField>

<ParamField body="json" type="object">
  Objeto JSON que contiene los parámetros de impresión del listado. Los parámetros disponibles dependen del formato concreto que se esté llamando.

  <Expandable title="Propiedades">
    <ParamField body="CodIni" type="string">
      Código inicial del rango a listar.
    </ParamField>

    <ParamField body="CodFin" type="string">
      Código final del rango a listar.
    </ParamField>
  </Expandable>
</ParamField>

### Cuerpo de ejemplo

```json theme={null}
{
  "json": {
    "CodIni": "4",
    "CodFin": "11"
  }
}
```

### Respuesta

<ResponseField name="200">
  Devuelve la salida generada por el listado. El contenido exacto varía según el formato invocado.
</ResponseField>

***

## Ejemplo completo

```http theme={null}
POST https://servidor:5555/api/listado/ListadoClientes.lst
Authorization: Bearer <JWT_token>
Content-Type: application/json

{
  "json": {
    "CodIni": "4",
    "CodFin": "11"
  }
}
```