---
title: "Create a vehicle stock"
method: POST
path: "/v1/vehicle-stocks"
tags: ["Dealership"]
---

# Create a vehicle stock

`POST /v1/vehicle-stocks`

## Request

- Base URL: `https://api.officina.it`
- URL: `https://api.officina.it/v1/vehicle-stocks`
- Auth: HTTP bearer

## Request body

- object
  - `manufacturer_id` string, required: Marca del veicolo.
  - `model` string, required: Modello del veicolo.
  - `license` string, required: Targa; normalizzata in maiuscolo.
  - `vin` string, nullable: Numero di telaio.
  - `registered_at` string, date-time, nullable: Data di prima immatricolazione.
  - `purchase_date` string, date-time, required: Data di acquisto; non può essere nel futuro.
  - `supplier_id` string, nullable: Fornitore da cui è stato acquistato.
  - `sold_by` string, nullable: Collaboratore a cui è assegnata la vendita.
  - `comments` string, nullable: Note libere.
  - `vehicle_sale_price` number, nullable: Prezzo di vendita richiesto.
  - `line_items` object[], required: Voci di costo che compongono total_cost.
    - `category` 'purchase' | 'registration_fees' | 'bodywork' | 'refurbishment' | 'tires' | 'inspection' | 'transport' | 'cleaning' | 'commissions' | 'other', required
    - `description` string, required
    - `amount` number, required: Importo; non negativo.

## Response `201`

created

## Other responses

- `400`: Request body is unparseable or X-API-Version is missing.
- `401`: Missing, malformed, expired, or wrong-audience bearer token.
- `402`: The company has no active subscription, or its plan does not include API access. API access is included in the Business and Illimitato plans.
- `403`: The authenticated user lacks the required permission.
- `422`: A request field is missing or invalid (fast-fail).
- `500`: Unhandled server error. Detail is logged, not exposed.

---

[API](https://skmtc.dev/officina/apis/officina-it-api.md) · [All operations](https://skmtc.dev/officina/apis/officina-it-api/llms.txt) · [OpenAPI document](https://skmtc.dev/officina/apis/officina-it-api/revisions/7da3fccfe551?raw)