Aggiorna prodotto

Aggiorna un prodotto (il body POST è parziale). Richiede una chiave Write.

POST/products/{productId}

Autorizzazione

AuthorizationToken Bearer (chiave API) · headerobbligatorio

Chiave API dell'organizzazione.

Parametri path

productIdstringobbligatorio

Corpo della richiesta

obbligatorioapplication/json

namestring

min length 1

pricenumber

Prezzo in centesimi

taxCategorystring

Consentiti:8.12.63.80

supplierstring

categorystring

declarationsstring

barcodestring

Normalizzato in minuscolo.

barcodeAliasesobject[]

EAN aggiuntivi facoltativi. Un array vuoto rimuove il campo. 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 | null

Prezzo promo in centesimi. Null o stringa vuota rimuove il campo.

salePercentagenumber | null

Sconto promo in percentuale. Null o stringa vuota rimuove il campo.

salePriceDateFromstring<date-time> | null

Inizio della promo. Null o stringa vuota rimuove il campo.

salePriceDateTostring<date-time> | null

Fine della promo. Null o stringa vuota rimuove il campo.

costPricenumber

marginnumber

showOnScreenboolean

ageRestrictionboolean

showOnScaleboolean

saleStopboolean

deactivatedboolean

imageUrlstring

URL dell’immagine. Sostituirlo o svuotarlo (stringa vuota) elimina il file immagine precedente se è salvato da questa organizzazione.

indexnumber

deletedboolean

true elimina il prodotto (soft-delete), false lo ripristina.

Risposte

200

Aggiornato

successbooleanobbligatorio

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).

404

Nessun elemento con questo id.

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

Parametri

productIdpath*

Bodyapplication/json

Corpo della richiesta

Richiesta

curl -X POST 'https://dashboard.scango.ch/api/v1/products/string' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "price": 129,
  "saleStop": false
}'

const response = await fetch("https://dashboard.scango.ch/api/v1/products/string", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"price\": 129,\n  \"saleStop\": false\n}"
});

import requests

response = requests.post(
    "https://dashboard.scango.ch/api/v1/products/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"price\": 129,\n  \"saleStop\": false\n}",
)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://dashboard.scango.ch/api/v1/products/string',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_TOKEN',
    'Accept: application/json',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => '{
  "price": 129,
  "saleStop": false
}',
]);

$response = curl_exec($curl);

Risposta

{
  "success": true
}

{
  "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"
}

{
  "statusCode": 0,
  "message": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "path": "string"
}