Your First Smart Services Request

Learn how to make your first call to Smart Services with practical examples.

Example Request: Document Analysis

We will use the AI document analysis service to extract information from an invoice.

1. Preparation

Make sure you have:

• API credentials configured
• Base endpoint: https://tse.smart-api.teamsystem.cloud

2. Document search

curl -X POST \
  curl -X 'GET' \
  'https://tse.smart-api.teamsystem.cloud/api/tse10/v1/company/1/document/orders?fields=document-id%2Cregistry-date%2Cdocument-number%2Cdocument-date&model-id=CLI-ORDINE&document-number=00001&document-id=202600000128&document-date=2026-10-10&customer-supplier-id=10&sectional-code=00&pagecount=5&pageposition=0&orderby=document-number' \
  -H 'accept: application/json' \
  -H 'accept-language: it-IT'

Response:

{
  "document-id": "202600000128",
  "model-id": "CLI-ORDINE",
  "document-existing": false,
  "document-date": "2025-11-25",
  "registry-date": "2025-11-25",
  "document-number": 0,
  "customer-supplier-id": 1,
  "sectional-code": "00",
  "storage-code": "00",
  "payment-term-code": "201",
  "document-total": 1250.5,
  "rows": [
    {
      "row-number": 1,
      "row-type": 0,
      "item-code": "ART001",
      "item-variant-id": "",
      "description": "Product description",
      "delivery-date": "2025-12-15",
      "quantity": 1,
      "enable-price-discount-flexibility": false,
      "price": 100.5,
      "vat-code": "22"
    }
  ]
}

Error Handling

Common Error Codes

Code	Meaning	Solution
401	Unauthorized	Check API credentials
403	Access denied	Check your account permissions
429	Too many requests	Implement retry with backoff
500	Server error	Try again later or contact support

Error response sample

{
  "guid": "ddd8ee6c-03e6-4f84-bcdf-4ed007d06edd",
  "type": "Error",
  "code": 401,
  "message": "Unauthorized - Unauthorized to use Smart WebApi, token not setted or invalid !!",
  "dto-name": "",
  "dto-property-name": "",
}

Next Steps

Now that you've made your first request:

• 🔍 Explore other available services
• Download the [official SDKs](coming soon)