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

# Ingests an 832 price/sales catalog into the partner's item master, bumping a

> per-item version only where attributes changed. Returns a created/updated/ unchanged summary.

per-item version only where attributes changed. Returns a created/updated/
unchanged summary.

### Path parameters

<ParamField path="partner_id" type="string" required>
  Partner ID
</ParamField>

### Request body

`Catalog832`

<ParamField body="catalog_number" type="string">
  BCT02 — catalog number / identifier.
</ParamField>

<ParamField body="description" type="string">
  BCT07 — catalog description, when present.
</ParamField>

<ParamField body="items" type="CatalogItem[]" required />

<ParamField body="purpose" type="string">
  BCT01 — catalog purpose code (e.g. `00` original, `01` cancel, `05` replace).
</ParamField>

### Response

`IngestSummary`

<ResponseField name="created" type="integer" required />

<ResponseField name="items" type="integer" required />

<ResponseField name="skipped" type="integer" required />

<ResponseField name="unchanged" type="integer" required />

<ResponseField name="updated" type="integer" required />

### Status codes

| Code  | Meaning                       |
| ----- | ----------------------------- |
| `200` | Ingest summary                |
| `403` | Not this credential's partner |

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://edi.stateset.com/v1/catalog/ingest/{partner_id}' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "catalog_number": "string",
    "description": "Two-person tent, green — replacement for damaged pole set.",
    "items": [
      {
        "description": "Two-person tent, green — replacement for damaged pole set.",
        "ids": [],
        "pack_size": "string",
        "prices": []
      }
    ],
    "purpose": "string"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "created": 1,
    "items": 1,
    "skipped": 1,
    "unchanged": 1,
    "updated": 1
  }
  ```
</ResponseExample>