# CATALOGSET_REQUIRED

# CATALOGSET_REQUIRED

A new cart must be created against a specific catalog set; the request omitted `catalogSetId`.

## Summary

| Field | Value |
|---|---|
| HTTP status | `400` |
| `errorCategory` | `validation` |
| `retryable` | `false` |

## When This Fires

- **`POST /v1/marketfront/carts/add`** — the request omitted `catalogSetId` and no existing `cart` was supplied. Each cart is bound to one catalog set so subsequent line-item validation and pricing have a stable basis.

## Recommended Action

Resolve the `catalogSetId` from the store you are ordering from and include it on the request:

```bash
GET /v1/marketfront/stores/{storeId}
```

Use the returned `catalogSetId` on the next cart-add call:

```bash
POST /v1/marketfront/carts/add
Authorization: Bearer YOUR_SESSION_TOKEN
Content-Type: application/json

{
  "storeId": "{storeId}",
  "catalogSetId": "{catalogSetId}",
  "item": { ... }
}
```

## Example

```json
{
  "type": "https://developer.gett-tech.com/errors/CATALOGSET_REQUIRED",
  "title": "Bad Request",
  "status": 400,
  "detail": "CatalogSetId is required when creating a new cart",
  "instance": "/v1/marketfront/carts/add",
  "requestId": "req_abc123",
  "timestamp": "2026-04-27T14:30:00.000Z",
  "errorCode": "CATALOGSET_REQUIRED",
  "errorCategory": "validation",
  "retryable": false
}
```