# Buscar SKUs (https://docs.pulsarml.com/es/v1/api-reference/skus/post-skus-filters)

Busca en el catálogo de productos, o recórrelo página por página con `{}`.

Los filtros van por separado, no como una búsqueda combinada: `skus` busca en el código del SKU y también acepta `include` / `exclude` por ID, mientras que `names`, `description` y `unit` son cada uno su propio filtro aproximado. Los SKUs archivados son parte del catálogo y no se excluyen automáticamente.

## `POST /v1/skus/filters`

Base URLs:
- `https://draco.prod.pulsarml.com` — Producción
- `https://draco.dev.pulsarml.com` — Desarrollo (sandbox)

Authentication: send your API key in the `x-api-key` header.

### Request body (`application/json`, required)

Type: object (`GetSkusByFiltersRequestV1`)

- `page` (integer, optional, default `1`, > 0, e.g. `1`) — El número de página
- `limit` (integer, optional, default `10`, > 0, e.g. `10`) — La cantidad de elementos por página
- `skus` (object, optional, nullable) — Criterios de filtro para SKUs
  - `search` (string, optional, nullable) — Término de búsqueda para SKUs
  - `include` (array of string, optional, nullable) — Elementos a incluir, por ID
  - `exclude` (array of string, optional, nullable) — Elementos a excluir, por ID
- `names` (object, optional, nullable) — Criterios de filtro para nombres
  - `search` (string, optional, nullable) — Término de búsqueda
- `description` (object, optional, nullable) — Criterios de filtro para la descripción
  - `search` (string, optional, nullable) — Término de búsqueda
- `unit` (object, optional, nullable) — Criterios de filtro para la unidad
  - `search` (string, optional, nullable) — Término de búsqueda

### Responses

#### 200 — Una página de SKUs, con el total de resultados y de páginas

Type: object (`GetSkusByFiltersResponseV1`)

- `totalCount` (integer, optional, default `100`) — La cantidad total de elementos
- `totalPages` (integer, optional, default `10`) — La cantidad total de páginas
- `currentPage` (integer, optional, default `1`) — La página actual
- `skus` (array of object, required)
  - `id` (string (uuid4), required, e.g. `"36f7b519-d93e-4ec8-8245-7f4b8c123456"`) — El identificador único del SKU.
  - `company` (object, required) — La empresa asociada al SKU.
    - `id` (integer, required, e.g. `1`) — El identificador único de la empresa.
    - `name` (string, required, e.g. `"company 1"`) — El nombre de la empresa.
  - `sku` (string, required, e.g. `"sku 1"`) — El código del SKU.
  - `name` (string, required, nullable, e.g. `"sku 1"`) — El nombre del SKU.
  - `description` (string, required, nullable, e.g. `"sku 1"`) — La descripción del SKU.
  - `unit` (string, required, nullable, e.g. `"pcs"`) — La unidad del SKU.
  - `archived` (boolean, required, e.g. `false`) — Si el SKU está archivado.
  - `createdAt` (string (date-time), required, e.g. `"2024-01-01T00:00:00.000Z"`) — La fecha y hora en que se creó el SKU.
  - `updatedAt` (string (date-time), required, e.g. `"2024-01-01T00:00:00.000Z"`) — La fecha y hora de la última actualización del SKU.
  - `deletedAt` (string (date-time), optional, nullable, e.g. `"2024-01-02T00:00:00.000Z"`) — La fecha y hora en que se eliminó el SKU, si aplica.

#### 422 — Error de validación

Type: object (`HTTPValidationError`)

- `detail` (array of object, optional)
  - `loc` (array of string | integer, required)
  - `msg` (string, required)
  - `type` (string, required)

### Example request

```bash
curl -X POST 'https://draco.prod.pulsarml.com/v1/skus/filters' \
  -H 'x-api-key: <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 1,
    "limit": 10,
    "skus": {
      "exclude": [
        "9ce2c6b4-a1f4-4bf2-b5c8-10436d1018cc"
      ],
      "include": [
        "9d02ab43-0100-4af6-a73c-e05abbd72648"
      ],
      "search": "sku 1"
    },
    "names": {
      "search": "sku 1"
    },
    "description": {
      "search": "a simple description"
    },
    "unit": {
      "search": "kgs"
    }
  }'
```