Ottieni prodotto per ID
Ottieni un prodotto per id.
GET
/products/{productId}Autorizzazione
AutorizzazioneToken Bearer (API key) · headerobbligatorioChiave API dell'organizzazione.
Parametri path
productIdstringobbligatorioRisposte
200Dettagli del prodotto
dataProductobbligatorioProdotto. I campi monetari sono interi in centesimi.
Mostra proprietàNascondi proprietà
idstringId del documento prodotto
externalIdstringIdentificatore esterno opzionale
namestringpriceintegerPrezzo in centesimi.
supplierstringId del fornitore
taxCategorystringCodice categoria IVA svizzera
Consentiti:
8.12.63.80categorystringId della categoria
declarationsstringbarcodestringbarcodeAliasesobject[]Optional additional EANs. Absent when unused. Empty array is not persisted. Available when the barcode aliases feature is enabled for the organization.
Mostra proprietàNascondi proprietà
Array of
objectcodestringobbligatorioAdditional EAN, lowercased like barcode
quantitynumberBase units represented by this code. Defaults to 1.
priceintegerOptional pack price in cents
labelstringexternalIdstringOptional external article ID
depositProductintegerCauzione in centesimi.
depositProductLabelstringdescriptionstringsalePriceintegerPrezzo di vendita in centesimi.
salePercentagenumbersalePriceDateFromstring<date-time>salePriceDateTostring<date-time>costPriceintegerPrezzo di costo in centesimi.
marginnumbershowOnScreenbooleanageRestrictionbooleanshowOnScalebooleansaleStopbooleandeactivatedbooleanopenInputbooleanimageUrlstringURL dell'immagine. Impostare via create/update prodotto o POST /products/{productId}/image. Stringa vuota in update cancella il campo e gli oggetti storage dell'organizzazione.
indexintegerallowStorestring[]Id dei negozi consentiti (sola lettura).
hideStorestring[]Id dei negozi nascosti (sola lettura).
deletedbooleanSoft-delete quando true.
createdatestring<date-time>lastupdatestring<date-time>instancestringId dell'organizzazione se presente
403Non autorizzato
statusCodeintegerobbligatorioCodice di stato HTTP
messagestringobbligatorioMessaggio di errore leggibile
timestampstring<date-time>obbligatoriopathstringobbligatorioPercorso della richiesta
404Not found
statusCodeintegerobbligatorioCodice di stato HTTP
messagestringobbligatorioMessaggio di errore leggibile
timestampstring<date-time>obbligatoriopathstringobbligatorioPercorso della richiesta
Richiesta
curl -X GET "https://dashboard.scango.ch/api/v1/products/string" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://dashboard.scango.ch/api/v1/products/string", {
method: "GET",
headers: {
"Autorizzazione": "Bearer YOUR_TOKEN"
}
});Risposta
{
"data": {
"id": "string",
"externalId": "string",
"name": "string",
"price": 0,
"supplier": "string",
"taxCategory": "8.1",
"category": "string",
"declarations": "string",
"barcode": "string",
"barcodeAliases": [
{
"code": "string",
"quantity": 0,
"price": 0,
"label": "string",
"externalId": "string"
}
],
"depositProduct": 0,
"depositProductLabel": "string",
"description": "string",
"salePrice": 0,
"salePercentage": 0,
"salePriceDateFrom": "2019-08-24T14:15:22Z",
"salePriceDateTo": "2019-08-24T14:15:22Z",
"costPrice": 0,
"margin": 0,
"showOnScreen": true,
"ageRestriction": true,
"showOnScale": true,
"saleStop": true,
"deactivated": true,
"openInput": true,
"imageUrl": "string",
"index": 0,
"allowStore": [
"string"
],
"hideStore": [
"string"
],
"deleted": true,
"createdate": "2019-08-24T14:15:22Z",
"lastupdate": "2019-08-24T14:15:22Z",
"instance": "string"
}
}{
"statusCode": 0,
"message": "string",
"timestamp": "2019-08-24T14:15:22Z",
"path": "string"
}{
"statusCode": 0,
"message": "string",
"timestamp": "2019-08-24T14:15:22Z",
"path": "string"
}