# Wallet

Come funziona l’esportazione da Wallet, dal collegamento alla soluzione dei problemi.

## Collegare

Prema «Collega» accanto a Wallet nella home di Exporter, poi «Apri la cartella Passes». Il pannello si apre nella cartella dove macOS tiene le sue carte, `~/Library/Passes`: prema «Seleziona questa cartella». Poi scelga dove vanno i file e prema «Usa questa cartella».

Prenda la cartella Passes stessa, non la cartella `Cards` al suo interno. Exporter legge le carte da `Cards`, e `passes23.sqlite` accanto per una cosa sola: il giorno in cui una carta è stata firmata, l’unica data che molte carte più vecchie hanno.

## Dove finiscono i file

Un file Markdown per carta, in un’unica cartella, chiamato con la sua data e con ciò che la carta è: `2026-09-17 united airlines SFO-EWR.md`, `2026-09-11 the sf database meetup.md`. Una carta senza alcuna data porta solo il suo nome (`apple store.md`). Una cartella direttamente nella sua cartella Inizio, come `~/Documents`, riceve dentro una cartella `wallet-export`; una più profonda, come `~/Documents/wallet`, è usata così com’è.

## Che cosa viene esportato

Ogni carta selezionata sulla scheda: carte d’imbarco, biglietti del treno e del bus, biglietti per eventi, carte fedeltà, coupon e carte generiche. Le pillole filtrano solo l’elenco: carte (tutte), voli (compresi treni e bus), eventi e carte fedeltà.

Due carte che darebbero lo stesso nome di file ricevono ciascuna un breve suffisso dal proprio id, così nessuna sovrascrive l’altra. Deselezionare una carta ne rimuove il file alla sincronizzazione successiva; riselezionarla lo riporta.

## Formato

Sempre Markdown: il front matter della carta, un titolo e una riga con il dove e il quando, poi i campi esattamente come li disegna la carta, il retro sotto un titolo `Back` e il numero del codice a barre.

## Il file

| chiave | contiene |
| --- | --- |
| `title`, `id` | come si chiama la carta e l’id che Wallet le dà |
| `kind` | `flight`, `transit`, `event`, `card` o `other` |
| `date`, `date_source` | quando la carta conta, e se è la data dell’emittente, la sua scadenza o il giorno della firma |
| `organization`, `pass_type` | l’emittente e il suo identificatore di tipo |
| `expires`, `voided` | quando scade, e se Wallet l’ha segnata come usata |
| `coordinates` | il punto del luogo, quando la carta ne porta uno |

Una sezione `Details` porta i campi tipizzati di Apple che la carta non mostra già: terminal, il gate d’arrivo, i fusi orari, la classe tariffaria. Una sezione `Where` nomina il luogo. Un codice a barre il cui messaggio è binario lo dichiara, invece di scrivere caratteri di controllo nel file.

```markdown
---
title: "United Airlines SFO-EWR"
kind: flight
date: 2026-09-17T18:20:00
date_source: relevant
organization: "United Airlines"
---
# United Airlines SFO-EWR

San Francisco (SFO) → Newark (EWR) · 17 Sep 2026

- FLIGHT: UA 274
- GATE: F19
- SEAT: 34D

## Back

- CONFIRMATION: GGCLMQ
```

## Le date, anche senza data

Una carta è archiviata nel suo giorno, nel fuso orario scritto dall’emittente: un volo che parte da Denver alle 23:25 è quel giorno a Denver, non il successivo dove lo sta leggendo. I biglietti per eventi più vecchi spesso non hanno alcuna data; quelli sono archiviati al giorno della firma, e `date_source: signed` lo dice nel file.

## Carte in altre lingue

Una carta può tenere le sue parole in un file `pass.strings` dentro il bundle e mettere nella carta solo le chiavi. Exporter le risolve nella lingua del suo Mac, così un biglietto riporta il nome dell’evento e non `EVENT_NAME`.

## Gratis e sbloccato

Le sue 20 carte più recenti sono gratis e restano tali. Sbloccare Wallet esporta il resto ([prezzi](https://exporter.dev/pricing)).

## Sincronizzazione e risincronizzazione completa

Dopo il primo «Sincronizza ora», Exporter riscrive il file di una carta quando quella carta cambia, al massimo una volta al minuto. Gate, posti e orari d’imbarco cambiano il giorno del viaggio, e ogni cambiamento riscrive solo il file di quella carta.

«Risincronizzazione completa» chiede prima, poi rimuove i file delle carte scritti da Exporter e riscrive ogni carta selezionata. Tutto il resto nella cartella resta.

## Problemi e soluzioni

- «nessuna carta in quella cartella (scelga la cartella Passes nella sua Libreria)»: prema di nuovo «Collega» e selezioni la cartella in cui si apre il pannello
- manca una carta: è deselezionata sulla scheda, oppure le 20 gratuite sono finite. Sblocchi Wallet e prema «Sincronizza ora»
- una carta non ha la data nel nome: non ne porta una e il database di Wallet non è stato letto. Colleghi `~/Library/Passes` invece di `Cards`
- i numeri delle carte di pagamento non ci sono: non sono sul Mac. Wallet tiene le carte di pagamento nel Secure Element, ed Exporter non le vede mai

## Related

- [Wallet](https://exporter.dev/it/wallet): Ogni carta come file Markdown
- [Per iniziare](https://exporter.dev/it/docs/getting-started): Installare, collegare, prima esportazione
- [Server MCP](https://exporter.dev/it/docs/mcp): Collegare Claude e altri agenti

---

human version: https://exporter.dev/it/docs/wallet
every page: https://exporter.dev/llms.txt