Depositi

Gli endpoint sotto /api/v1/integrations/warehouses espongono solo i campi anagrafici del deposito: nome, tipo, indirizzo e località. Non sono inclusi configurazioni WMS, corrieri collegati né flag operativi interni. Ogni operazione richiede lo scope dedicato (warehouses:read, warehouses:create, warehouses:update, warehouses:delete). Consulta la tabella scope per il mapping completo.

Tipi deposito

Il campo typeId accetta solo i valori dell’enum fisso sottostante.

`typeId`	Nome	Note
`1`	Principale	`isPrincipal` in risposta è `true`
`2`	Logistica	Deposito logistico secondario
`3`	Drop Shipping	Magazzino per evasione drop shipping
`4`	Secondario	Deposito secondario generico

In risposta, warehouseType contiene { id, name }.

Flusso consigliato

Elenca i depositi

GET /api/v1/integrations/warehouses con scope warehouses:read.

Crea un deposito

POST /api/v1/integrations/warehouses con name, typeId e indirizzo completo. Scope warehouses:create.

Aggiorna o elimina

Usa PATCH /api/v1/integrations/warehouses/{id} (scope warehouses:update) o DELETE (scope warehouses:delete).

L’eliminazione di un deposito è definitiva. Verifica che il deposito non sia ancora referenziato da ordini o prodotti prima di chiamare DELETE.

Campi request e response

Create / update

Campo	Tipo	Obbligatorio (create)	Descrizione
`name`	string	Sì	Nome del deposito
`typeId`	integer	Sì	Tipo da tabella tipi
`address`	string	Sì	Via e numero civico
`postalCode`	string	Sì	CAP
`city`	string	Sì	Comune
`state`	string	Sì	Provincia o stato
`country`	string	Sì	Codice paese ISO alpha-2 (es. `IT`)

In PATCH tutti i campi sono opzionali ma almeno uno deve essere inviato.

Response

Oltre ai campi anagrafici, la risposta include:

Campo	Descrizione
`id`	ID numerico del deposito
`isPrincipal`	`true` se `typeId === 1`
`warehouseType`	Oggetto `{ id, name }` dall’enum
`createdAt`, `updatedAt`	Timestamp ISO

companyId e campi operativi interni non sono mai esposti.

Esempio di creazione

{
  "name": "Magazzino centrale",
  "typeId": 1,
  "address": "Via Roma 1",
  "postalCode": "10121",
  "city": "Torino",
  "state": "TO",
  "country": "IT"
}

Esempio di risposta

{
  "id": 42,
  "name": "Magazzino centrale",
  "typeId": 1,
  "address": "Via Roma 1",
  "postalCode": "10121",
  "city": "Torino",
  "state": "TO",
  "country": "IT",
  "isPrincipal": true,
  "warehouseType": {
    "id": 1,
    "name": "Principale"
  },
  "createdAt": "2024-06-01T10:00:00.000Z",
  "updatedAt": "2024-06-01T10:00:00.000Z"
}

Introduzione

Health

Marketplaces

Carriers

Indirizzi

Spedizioni

Webhook

Depositi

Tipi deposito

Flusso consigliato

Campi request e response

Create / update

Response

Esempio di creazione

Esempio di risposta

​Tipi deposito

​Flusso consigliato

​Campi request e response

​Create / update

​Response

​Esempio di creazione

​Esempio di risposta

Tipi deposito

Flusso consigliato

Campi request e response

Create / update

Response

Esempio di creazione

Esempio di risposta