> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tp.sima.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# Depósitos

> Cómo consultar Depósitos — ubicaciones de almacenamiento referenciadas en líneas de supply de OTs

## Resumen

Warehouses are storage locations (depósitos) where agrochemical inputs are stored. They can be referenced in Work Order supply lines to track which depot a product was drawn from.

<Info>
  Warehouses are **read-only** from the Third-Party API. They are created and managed in SIMA directly. If your system needs warehouses to exist in SIMA, they must be created via the web app first.
</Info>

***

## Endpoints

### List Warehouses

```
GET /api/v2/third_party/warehouses
```

**Filters:**

| Parameter       | Type     | Description                                                            |
| --------------- | -------- | ---------------------------------------------------------------------- |
| `search`        | string   | Search by name                                                         |
| `id`            | int      | Filter by specific warehouse ID                                        |
| `updated_from`  | datetime | Change detection (note: v2 uses `updated_from`, not `updated_at_from`) |
| `page` / `size` | int      | Pagination                                                             |

**Response:**

```json theme={null}
{
  "items": [
    {
      "id": 6342,
      "name": "El Galpón",
      "description": null,
      "date_modified": "2022-04-08T15:35:48-03:00"
    }
  ],
  "current_page": 1,
  "next_page": null,
  "total_pages": 1,
  "total_items": 1
}
```

### Get Warehouse detail

```
GET /api/v2/third_party/warehouses/{id}
```

Returns a single warehouse by ID.

***

## Uso en Órdenes de Trabajo

When creating a Work Order supply line, you can optionally reference a warehouse:

```json theme={null}
"supplies": [
  {
    "cultivation": { "local_id": 243405 },
    "formulated": { "local_id": 8844 },
    "total_applied": 59.999,
    "area_applied": 37,
    "warehouse": { "local_id": 6342 }
  }
]
```

If no warehouse applies, set `"warehouse": null`.

***

## Frecuencia de sincronización recomendada

Warehouses change infrequently. Sync them once on startup and refresh weekly using `updated_from`.

***

## Próximos pasos

<Card title="Work Orders" icon="clipboard-list" href="/guides/work-orders">
  Reference warehouse IDs in Work Order supply lines
</Card>