Scontrino - Dati Estratti¶

Totale delle voci estratte da uno scontrino / ricevuta fiscale (supermercati, pet shop, farmacie, negozi retail, ecc.).

L’estrazione restituisce:

le informazioni generali del negozio e dello scontrino (receipt)
la lista completa dei prodotti (products)
opzionalmente, la classificazione automatica dei prodotti (categorized_products)

Esempio Response Completa¶

{
      "event": "document.processed",
      "created_at": "2025-09-01T15:37:36.467736+00:00",
      "document_id": "7f2b8f5b-1b27-4e7f-9b3b-9f6ac8b82c10",
      "application_id": "c3a058c3-2243-4f83-92ce-d6e4fd3e89ae",
      "status": "DONE",
      "applicant_reference": "USER-001",
      "document_type": "scontrino",
      "extracted_data": {
        "status": "ok",
        "message": "Elaborazione scontrino effettuata",
        "filename": "scontrino_arcaplanet_2025-10-01.jpg",
        "receipt": {
          "address": {
            "address": "Via Torino 123",
            "location": "Milano",
            "province": "MI",
            "zip": "20154",
            "area_nielsen": "1"
          },
          "amount": 89.90,
          "date": "01/10/2025",
          "number": "2170-0109",
          "payment": "Carta di credito",
          "sconto_scontrino": -5.00,
          "time": "18:42",
          "vatnum": "01234567890",
          "shop": "Arcaplanet",
          "nome_azienda": "ARCAPLANET S.P.A.",
          "channel": "negozio fisico",
          "rt": "RT1234567890"
        },
        "products": [
          {
            "description": "PAMPERS BABY-DRY X BD PEN MAX 124",
            "code": "8001480306783",
            "price": 45.39,
            "discount": [-18.40],
            "final_price": 26.99
          },
          {
            "description": "PAMPERS PROGRESSI PENTAPACK T4",
            "code": "8001480001234",
            "price": 39.99,
            "discount": [-10.00],
            "final_price": 29.99
          },
          {
            "description": "HUMANA 2 1100G LATTE IN POLVERE",
            "code": "8001234567890",
            "price": 22.50,
            "discount": [],
            "final_price": 22.50
          },
          {
            "description": "HERO POUCH MELA/BANANA",
            "code": "8410123456789",
            "price": 1.79,
            "discount": [-0.30],
            "final_price": 1.49
          },
          {
            "description": "DOLCEGUSTO BARISTA 30 CAPSULE",
            "code": "7610300012345",
            "price": 8.99,
            "discount": [],
            "final_price": 8.99
          }
        ],
        "categorized_products": [
          {
            "description": "PAMPERS BABY-DRY X BD PEN MAX 124",
            "category": "PAMPERS BABY-DRY"
          },
          {
            "description": "HUMANA 2 1100G LATTE IN POLVERE",
            "category": "LATTE IN POLVERE / FORMULA"
          },
          {
            "description": "HERO POUCH MELA/BANANA",
            "category": "OMOGENEIZZATO / POUCH FRUTTA"
          }
        ]
      }
    }

Informazioni di Base (receipt)¶

La sezione receipt contiene tutti i dati anagrafici e fiscali del negozio, oltre alle informazioni principali dello scontrino.

Dati Negozio¶

{
      "shop": "Arcaplanet",
      "nome_azienda": "ARCAPLANET S.P.A.",
      "vatnum": "01234567890",
      "address": {
        "address": "Via Torino 123",
        "location": "Milano",
        "province": "MI",
        "zip": "20154",
        "area_nielsen": "1"
      }
    }

Descrizione campi

Campo	Tipo	Descrizione
`shop`	string	Nome commerciale del punto vendita (insegna).
`nome_azienda`	string	Ragione sociale completa della società (con forma giuridica).
`vatnum`	string	Partita IVA (11 caratteri numerici).
`address.address`	string	Via e numero civico (es. `Via Torino 123`).
`address.location`	string	Città (es. `Milano`).
`address.province`	string	Sigla provincia (es. `MI`).
`address.zip`	string	CAP (es. `20154`).
`address.area_nielsen`	string	Area Nielsen, calcolata automaticamente in base alla regione (es. `1`).

Dati Scontrino¶

{
      "date": "01/10/2025",
      "time": "18:42",
      "number": "2170-0109",
      "amount": 89.90,
      "payment": "Carta di credito",
      "sconto_scontrino": -5.00,
      "channel": "negozio fisico",
      "rt": "RT1234567890"
    }

Descrizione campi

Campo	Tipo	Descrizione
`date`	string	Data dello scontrino in formato `GG/MM/AAAA` (es. `01/10/2025`).
`time`	string	Ora dello scontrino in formato `HH:MM` (es. `18:42`).
`number`	string	Numero scontrino (identificativo interno del negozio).
`amount`	number	Importo totale pagato, comprensivo di tasse e sconti applicati.
`payment`	string	Metodo di pagamento (es. `Contanti`, `Carta di credito`, `Bancomat`, `App`).
`sconto_scontrino`	number	Eventuale sconto complessivo a livello scontrino (valore negativo, es. `-5.00`).
`channel`	string	Canale di vendita (es. `negozio fisico`, `e-commerce`, `app`), se indicato.
`rt`	string	Codice RT del registratore telematico riportato in fondo allo scontrino (se presente).

Prodotti (products)¶

La sezione products contiene la lista completa dei prodotti presenti nello scontrino.
Ogni elemento rappresenta un singolo prodotto (no accorpamento di righe identiche).

Esempio singolo prodotto¶

{
      "description": "PAMPERS BABY-DRY X BD PEN MAX 124",
      "code": "8001480306783",
      "price": 45.39,
      "discount": [-18.40],
      "final_price": 26.99
    }

Descrizione campi

Campo	Tipo	Descrizione
`description`	string	Descrizione del prodotto così come appare sullo scontrino.
`code`	string	Codice a barre / SKU del prodotto (se presente).
`price`	number	Prezzo base del prodotto (prima dell’applicazione di eventuali sconti).
`discount`	number[]	Lista degli sconti associati a quel prodotto; ogni voce è un importo negativo (es. `-5.00`).
`final_price`	number	Prezzo finale dopo l’applicazione di tutti gli sconti presenti nella lista `discount`.

Se non ci sono sconti:

{
      "description": "HUMANA 2 1100G LATTE IN POLVERE",
      "code": "8001234567890",
      "price": 22.50,
      "discount": [],
      "final_price": 22.50
    }

Classificazione Prodotti (categorized_products)¶

Quando abilitata, la pipeline può restituire anche una sezione di classificazione dei prodotti, basata sulla mappa categories_mapping.

Esempio¶

{
      "categorized_products": [
        {
          "description": "PAMPERS BABY-DRY X BD PEN MAX 124",
          "category": "PAMPERS BABY-DRY"
        },
        {
          "description": "HUMANA 2 1100G LATTE IN POLVERE",
          "category": "LATTE IN POLVERE / FORMULA"
        },
        {
          "description": "HERO POUCH MELA/BANANA",
          "category": "OMOGENEIZZATO / POUCH FRUTTA"
        }
      ]
    }

Categorie Esempio¶

Le categorie vengono dedotte confrontando la descrizione del prodotto con gli esempi in categories_mapping. Alcune categorie previste:

PAMPERS BABY-DRY
PAMPERS PROGRESSI
PAMPERS MUTANDINO
PAMPERS SOLE E LUNA
PAMPERS SALVIETTINE
HUGGIES SOLE E LUNA
LATTE IN POLVERE / FORMULA
OMOGENEIZZATO / POUCH FRUTTA
OMOGENEIZZATO CARNE / PESCE
PASTA
BISCOTTI
CURA DEL BAMBINO
GIOCATTOLI
SEGGIOLINO AUTO
ACQUA MINERALE
ALIMENTARI VARI
BUSTA / SACCHETTO
ALTRO

Se non viene trovata una corrispondenza soddisfacente, viene utilizzata la categoria ALTRO.

Scontrino - Dati Estratti Esempio Response Completa Informazioni di Base ( )Dati Negozio Dati Scontrino Prodotti ( )Esempio singolo prodotto Classificazione Prodotti ( )Esempio Categorie Esempio