Al contenuto

Per i fornitori

Pubblichi le Sue offerte come file in questo formato. Il nostro controllo mensile, in preparazione, lo cercherà a quell’indirizzo e nel Suo llms.txt.

Che cosa pubblicare

Un file con le Sue offerte attuali, a un indirizzo stabile qualsiasi: CSV o JSON con i campi indicati sotto, oppure gli stessi dati come markup schema.org sulle pagine delle Sue offerte. Lo metta in /.well-known/meconomy-offers.json sul Suo sito, oppure lo indichi con un link nel Suo llms.txt. Questi sono l’indirizzo e il formato che meconomy.ch consulterà.

Non c’è alcun obbligo, nessun link in cambio e nessun pagamento. Per un fornitore che non pubblica alcun file continuiamo a consultare le sue pagine pubbliche (MEconomyBot). È prevista un’API dei dati, vedere /about/api.

I campi

Una riga o un oggetto per offerta. CSV: UTF-8, separato da virgole, con una riga di intestazione con questi nomi. Le date seguono ISO 8601. Sono necessari soltanto offer_id, name, price_regular, currency e url. Lasci vuoto ogni altro campo quando non si applica o quando non lo indica; mostriamo allora «non indicato», mai una stima.

Campi del feed delle offerte
CampoTipoSignificato
offer_idtestoIl Suo identificativo dell’offerta. Resta lo stesso finché l’offerta esiste.
nametestoIl nome dell’offerta come lo scrive Lei.
categorytestoDi che cosa si tratta, per esempio mobile, internet, tv, phone, bank_account o credit_card.
price_regularnumeroIl prezzo per periodo di fatturazione senza promozione, con il punto come separatore decimale.
price_promonumeroIl prezzo promozionale per periodo di fatturazione. Vuoto quando non c’è alcuna promozione.
promo_valid_fromdataPrimo giorno della promozione, come 2026-11-01.
promo_valid_untildataUltimo giorno della promozione, come 2026-12-31.
promo_conditionstestoChe cosa richiede la promozione, per esempio «solo nuovi clienti».
price_after_promonumeroIl prezzo per periodo di fatturazione al termine della promozione.
min_term_monthsnumero interoLa durata minima del contratto in mesi. 0 quando non ce n’è.
setup_feenumeroIl costo unico all’inizio. 0 quando non ce n’è.
billing_periodtestomonth o year: il periodo a cui si riferiscono i prezzi sopra.
currencytestoIl codice ISO 4217, per esempio CHF.
urlindirizzoLa pagina pubblica dell’offerta sul Suo sito.
last_modifieddata e oraQuando questa riga è stata modificata l’ultima volta, come 2026-10-26T08:00:00+01:00.

Esempio JSON

Un’offerta inventata, per mostrare la struttura. Un file JSON contiene un elenco offers.

{
  "offers": [
    {
      "offer_id": "example-mobile-m",
      "name": "Example Mobile M",
      "category": "mobile",
      "price_regular": 39.9,
      "price_promo": 29.9,
      "promo_valid_from": "2026-11-01",
      "promo_valid_until": "2026-12-31",
      "promo_conditions": "New customers only",
      "price_after_promo": 39.9,
      "min_term_months": 0,
      "setup_fee": 0,
      "billing_period": "month",
      "currency": "CHF",
      "url": "https://www.example.ch/mobile/m",
      "last_modified": "2026-10-26T08:00:00+01:00"
    }
  ]
}

Oppure markup schema.org sulle pagine delle offerte

Se le pagine delle Sue offerte contengono già il markup schema.org Product e Offer, viene consultato allo stesso modo. Indichi il prezzo promozionale con priceValidUntil e il prezzo dopo la promozione come seconda UnitPriceSpecification che inizia il giorno successivo. Il markup deve trovarsi nell’HTML inviato dal Suo server, non essere aggiunto in seguito da uno script.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example Mobile M",
  "sku": "example-mobile-m",
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.ch/mobile/m",
    "price": "29.90",
    "priceCurrency": "CHF",
    "priceValidUntil": "2026-12-31",
    "priceSpecification": [
      {
        "@type": "UnitPriceSpecification",
        "price": "29.90",
        "priceCurrency": "CHF",
        "unitCode": "MON",
        "validThrough": "2026-12-31"
      },
      {
        "@type": "UnitPriceSpecification",
        "price": "39.90",
        "priceCurrency": "CHF",
        "unitCode": "MON",
        "validFrom": "2027-01-01"
      }
    ]
  }
}

Come lo consulteremo

  • Quando il nostro controllo mensile sarà in funzione (è in preparazione), cercheremo il file a quell’indirizzo e nel Suo llms.txt, una volta al mese su ogni sito che consultiamo. Un file che troviamo viene confrontato con i campi indicati sopra; finché il lettore automatico non è attivo, una persona ne imposta la consultazione.
  • Richiameremo il file al massimo una volta all’ora e lo faremo con If-Modified-Since, così un file invariato Le costa una sola risposta breve.
  • Un feed sarà consultato come una pagina. Conserviamo il suo indirizzo, il momento in cui lo abbiamo consultato e un’impronta del file, e un prezzo proveniente da un feed è mostrato con la stessa fonte e la stessa data di qualsiasi altro prezzo.
  • I nostri controlli si applicheranno anche a esso come a ogni prezzo: una cifra che sembra errata viene trattenuta finché una persona non ha controllato.
  • Ci identificheremo quando lo richiameremo, con lo user agent MEconomyBot/1.0 (+https://meconomy.ch/about/bot).

Per fermarci o per una domanda

Quando il lettore sarà attivo, rimuovere il file pone fine alla consultazione. Per ogni altra cosa scriva a hello@meconomy.ch o usi la pagina di contatto.