---
search:
  tags:
    - Negozi
    - POST
seo:
  description: >-
    Crea una sede. Richiede una chiave Write. In un'organizzazione name è spesso
    il brand; usa city (o indirizzo) per distinguere le sedi. Le credenziali
    del…
sidebar:
  label: Crea negozio
  badge: POST
title: Crea negozio
type: openapi-operation
---
Crea una sede. Richiede una chiave Write. In un'organizzazione `name` è spesso il brand; usa `city` (o indirizzo) per distinguere le sedi. Le credenziali del provider di pagamento (Zahls) si configurano nel dashboard, non tramite questa API.

`POST /stores`

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

- `name` (string, required)
- `address` (string)
- `zipCode` (string)
- `city` (string) — Etichetta leggibile del negozio all’interno dell’organizzazione
- `vatNumber` (string)
- `paymentCash` (boolean)
- `paymentPaytec` (boolean)
- `paymentZahls` (boolean)
- `paymentZahlsOffline` (boolean)
- `paymentCashOffline` (boolean)
- `showSupplier` (boolean)
- `hideTextStart` (boolean)
- `generalMargin` (number)
- `customMessage` (string)
- `backgroundImageCart` (string | object)
- `backgroundImage` (string | object)
- `backgroundColor` (string)
- `backgroundFontColor` (string)
- `playSound` (boolean)
- `standardSound` (string)
- `adminMail` (string)
- `showInfoButton` (boolean)
- `showPictures` (boolean)
- `showPicturesScale` (boolean)
- `deleteCountdown` (number)
- `logoUrl` (string)
- `languageMulti` (boolean)
- `languageMain` (string)
- `languageSelector` (string[])
- `translations` (object)

Request body example:

```json
{
  "name": "Negozio principale",
  "city": "Zürich",
  "address": "Bahnhofstrasse 1",
  "zipCode": "8001"
}
```

**Responses**

- `200` — Negozio creato
- `400` — Parametri o body non validi.
- `403` — Chiave API mancante, sconosciuta o inattiva, oppure chiave Read su un’operazione di scrittura.

Response example, 200:

```json
{
  "success": true,
  "id": "newStoreId"
}
```

Response example, 400:

```json
{
  "statusCode": 400,
  "message": "Validation failed for Field: name, Error: Required",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/suppliers"
}
```

Response example, 403:

```json
{
  "statusCode": 403,
  "message": "Unknown Error",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/products"
}
```