La tua prima richiesta Smart Services

Impara a effettuare la tua prima chiamata ai Smart Services con esempi pratici.

Richiesta di esempio: Gestione articoli di magazzino

Utilizzeremo il servizio di gestione degli articoli di magazzino per inserire, recuperare le informazioni ed eventualmente modificare i dati corrispondenti ad uno o più articolo di magazzino.

1. Preparazione

Assicurati di avere:

• Credenziali API configurate
• Endpoint base: https://tse.smart-api.teamsystem.cloud

2. Inserimento articolo di magazzino

curl -X POST \
  https://tsec-smartwebapi-app.azurewebsites.net/api/tse10/v1/company/1/warehouse/items \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \

Request Body:

{
    "code": "Art01",
    "description": "Articolo Smart DOC",
    "vatcode": "22",
    "um": "PZ",
    "barcode": "9863214752190",
    "stockstoragecode": "00"
}

Response:

{
  "code": "Art01",
  "links": [
    {
      "href": {
        "link": "api/tse10/v1/company/1/warehouse/items/1"
      },
      "rel": "string",
      "type": {
        "method": "get"
      },
      "message": {
        "message": "All additional informations with relevant value"
      }
    }
  ]
}

3. Recupero dati

curl -X GET \
  https://tse.smart-api.teamsystem.cloud/v1/warehouse/item \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
    "code": "DOC",
    "description": "Articolo Smart DOC",
    "vatcode": "22",
    "um": "PZ",
    "barcode": "9863214752190",
    "stockstoragecode": "00"
}

Esempio con JavaScript

Gestione degli errori

Codici di errore comuni

Codice	Significato	Soluzione
401	Non autorizzato	Verifica le credenziali API
403	Accesso negato	Controlla i permessi del tuo account
429	Troppi richieste	Implementa retry con backoff
500	Errore server	Riprova più tardi o contatta il supporto

Esempio gestione errori

try {
  const result = await client.ai.analyzeItem(params);
} catch (error) {
  switch (error.status) {
    case 401:
      console.error('Credenziali non valide');
      break;
    case 429:
      console.log('Rate limit raggiunto, riprovo tra 60s');
      setTimeout(() => analyzeItem), 60000);
      break;
    default:
      console.error('Errore:', error.message);
  }
}

Prossimi passi

Ora che hai effettuato la tua prima richiesta:

• 🔍 Esplora altri servizi AI disponibili
• Scarica gli SDK ufficiali
• Configura automazioni e workflow