Crea prodotto

Crea un prodotto. Richiede una chiave Write.

POST/products

Autorizzazione

AuthorizationToken Bearer (chiave API) · headerobbligatorio

Chiave API dell'organizzazione.

Corpo della richiesta

obbligatorioapplication/json

namestringobbligatorio

min length 1

pricenumberobbligatorio

Prezzo in centesimi

taxCategorystringobbligatorio

Consentiti:8.12.63.80

supplierstring

categorystring

declarationsstring

barcodestring

Normalizzato in minuscolo; se vuoto diventa l'id del documento

barcodeAliasesobject[]

EAN aggiuntivi facoltativi. Omettere se non usati. Disponibile se la funzione alias dei codici a barre è attiva per l’organizzazione; altrimenti 403 Feature not available.

Mostra proprietà

Array di object

codestringobbligatorio

quantitynumber

priceinteger

Prezzo facoltativo della confezione in centesimi

labelstring

externalIdstring

Id articolo esterno facoltativo

externalIdstring

depositProductnumber

Cauzione in centesimi

depositProductLabelstring

descriptionstring

salePricenumber

salePercentagenumber

salePriceDateFromstring<date-time>

salePriceDateTostring<date-time>

costPricenumber

marginnumber

showOnScreenboolean

ageRestrictionboolean

showOnScaleboolean

saleStopboolean

deactivatedboolean

imageUrlstring

URL dell’immagine, salvato così com’è. Per caricare un file usa POST /products/{productId}/image.

indexnumber

Risposte

200

Prodotto creato

successbooleanobbligatorio

idstringobbligatorio

400

Parametri o body non validi.

statusCodeintegerobbligatorio

Codice di stato HTTP

messagestringobbligatorio

Messaggio di errore leggibile

timestampstring<date-time>obbligatorio

Momento dell’errore (UTC).

pathstringobbligatorio

URL della richiesta (percorso e query string).

403

Chiave API mancante, sconosciuta o inattiva, oppure chiave Read su un’operazione di scrittura.

statusCodeintegerobbligatorio

Codice di stato HTTP

messagestringobbligatorio

Messaggio di errore leggibile

timestampstring<date-time>obbligatorio

Momento dell’errore (UTC).

pathstringobbligatorio

URL della richiesta (percorso e query string).

Prova

Server

URL di baseURL di base personalizzatoSostituisce il server selezionato se impostato.

Autorizzazione

Token Bearer (chiave API)Ricorda su questo dispositivoUsa i miei valori negli esempi

Bodyapplication/json

Corpo della richiesta

Richiesta

curl -X POST 'https://dashboard.scango.ch/api/v1/products' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Succo d'\''arancia 1L",
  "price": 349,
  "taxCategory": "2.6",
  "description": "Succo d'\''arancia fresco",
  "supplier": "sup_01",
  "category": "cat_beverages",
  "barcode": "7610800009999",
  "externalId": "sku-oj-1l",
  "showOnScreen": true,
  "ageRestriction": false,
  "showOnScale": false,
  "saleStop": false
}'

const response = await fetch("https://dashboard.scango.ch/api/v1/products", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"Succo d'arancia 1L\",\n  \"price\": 349,\n  \"taxCategory\": \"2.6\",\n  \"description\": \"Succo d'arancia fresco\",\n  \"supplier\": \"sup_01\",\n  \"category\": \"cat_beverages\",\n  \"barcode\": \"7610800009999\",\n  \"externalId\": \"sku-oj-1l\",\n  \"showOnScreen\": true,\n  \"ageRestriction\": false,\n  \"showOnScale\": false,\n  \"saleStop\": false\n}"
});

import requests

response = requests.post(
    "https://dashboard.scango.ch/api/v1/products",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"Succo d'arancia 1L\",\n  \"price\": 349,\n  \"taxCategory\": \"2.6\",\n  \"description\": \"Succo d'arancia fresco\",\n  \"supplier\": \"sup_01\",\n  \"category\": \"cat_beverages\",\n  \"barcode\": \"7610800009999\",\n  \"externalId\": \"sku-oj-1l\",\n  \"showOnScreen\": true,\n  \"ageRestriction\": false,\n  \"showOnScale\": false,\n  \"saleStop\": false\n}",
)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://dashboard.scango.ch/api/v1/products',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_TOKEN',
    'Accept: application/json',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => '{
  "name": "Succo d\'arancia 1L",
  "price": 349,
  "taxCategory": "2.6",
  "description": "Succo d\'arancia fresco",
  "supplier": "sup_01",
  "category": "cat_beverages",
  "barcode": "7610800009999",
  "externalId": "sku-oj-1l",
  "showOnScreen": true,
  "ageRestriction": false,
  "showOnScale": false,
  "saleStop": false
}',
]);

$response = curl_exec($curl);

Risposta

{
  "success": true,
  "id": "newProductId"
}

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

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