Panoramica
Per poter utilizzare le funzioni BDTA di Herdy -- importazione, notifiche, gestione delle marche auricolari ed estivazione -- dovete collegare Herdy una sola volta al vostro account agate.ch. Successivamente collegate la vostra azienda con il numero BDTA corrispondente.
Le impostazioni BDTA si trovano in BDTA > Impostazioni nel menu principale. La pagina mostra tre sezioni: connessione Agate, azienda collegata e stato di sincronizzazione.
Collegare l'account Agate
La connessione ad agate.ch avviene tramite OAuth -- venite reindirizzati direttamente alla pagina di accesso di agate.ch e non dovete inserire la vostra password in Herdy.
Guida passo passo
- Navigate a BDTA > Impostazioni.
- Cliccate su Connetti con Agate.
- Venite reindirizzati ad agate.ch. Accedete con le vostre credenziali.
- Dopo l'accesso riuscito venite reindirizzati a Herdy.
- Herdy mostra una conferma: il vostro account Agate è collegato.
Dopo la connessione vedete il vostro ID esterno Agate, l'ID di accesso e la data di connessione.
Rinnovare la connessione
La sessione Agate ha una validità limitata. Herdy vi avvisa in tempo utile quando la sessione sta per scadere. Cliccate su Rinnova ora per accedere nuovamente ad agate.ch.
Se la sessione è già scaduta, appare un avviso. Cliccate su Riconnetti per ripristinare la connessione.
Disconnettere
Se volete disconnettere la connessione Agate:
- Navigate a BDTA > Impostazioni.
- Cliccate su Disconnetti.
- Confermate l'azione.
Dopo la disconnessione le funzioni BDTA (importazione, notifiche, marche auricolari, estivazione) non sono più disponibili finché non vi riconnettete.
Collegare l'azienda
Dopo la connessione Agate dovete stabilire quale azienda BDTA viene collegata al vostro account Herdy.
Primo collegamento
Quando vi connettete per la prima volta con Agate, Herdy vi reindirizza automaticamente alla selezione dell'azienda:
- Herdy carica le aziende associate al vostro account Agate.
- Selezionate l'azienda desiderata (vengono mostrati numero BDTA, nome e sede).
- Cliccate su Collega azienda.
- Herdy mostra un dialogo di conferma: "È questa la vostra azienda?" -- con l'avviso che l'azienda non può più essere cambiata dopo la prima sincronizzazione.
- Confermate con Sì, collega azienda.
Cambiare azienda (prima della prima sincronizzazione)
Finché non avete ancora sincronizzato animali, potete modificare l'azienda collegata:
- Navigate a BDTA > Impostazioni.
- Sull'azienda collegata cliccate su Cambia azienda.
- Confermate l'avviso.
- Selezionate la nuova azienda dall'elenco.
- Cliccate su Accetta azienda.
L'azienda è bloccata (dopo la prima sincronizzazione)
Non appena avete sincronizzato o importato animali dalla BDTA per la prima volta, l'azienda viene bloccata definitivamente. Il simbolo del lucchetto e l'indicazione "Bloccata" lo segnalano.
Questo blocco garantisce che i dati degli animali sincronizzati rimangano sempre associati all'azienda corretta. Non potete più cambiare l'azienda in seguito.
Suggerimento: Se gestite più aziende, create un account Herdy separato (team) per ogni azienda tramite la vostra panoramica aziendale. Ogni azienda ottiene così il proprio collegamento BDTA.
Stato di sincronizzazione
In BDTA > Impostazioni vedete lo stato di sincronizzazione attuale:
- Ultima sincronizzazione -- Data e ora dell'ultima sincronizzazione riuscita.
- Mai sincronizzato -- Se non è ancora stata eseguita nessuna sincronizzazione.
Cliccate su Aggiorna dalla BDTA per avviare una sincronizzazione manuale. In questo modo i vostri animali e le marche auricolari vengono confrontati con la BDTA.
Storico delle sincronizzazioni
Herdy registra tutte le sincronizzazioni. Potete consultare lo storico per capire quando sono state apportate quali modifiche. Per ogni sincronizzazione vedete:
- Attivatore -- Manuale, automatico o alla prima connessione.
- Stato -- Completato, parzialmente completato o fallito.
- Riepilogo -- Quanti animali sono stati aggiunti, aggiornati o sincronizzati.
Cliccate su Mostra dettagli per vedere le singole modifiche di una sincronizzazione (ad es. quali animali sono stati importati o aggiornati).
A cosa serve la connessione Agate?
La vostra connessione Agate abilita le seguenti funzioni:
| Funzione | Descrizione |
|---|---|
| Importa mandria | Carica il vostro patrimonio animale attuale dalla BDTA |
| Invia notifiche BDTA | Trasmette le notifiche di nascita, entrata, uscita, morte e macellazione |
| Sincronizza marche auricolari | Confronta il vostro stock di marche auricolari con la BDTA |
| Estivazione | Crea notifiche collettive per la salita e discesa dall'alpe |
Senza connessione Agate potete comunque utilizzare Herdy per la gestione degli animali, ma il collegamento diretto alla BDTA non è disponibile.
Sicurezza
- La connessione avviene tramite OAuth -- Herdy non salva la vostra password agate.ch.
- I token di accesso vengono salvati in modo crittografato (tramite Supabase Vault).
- Herdy utilizza i token esclusivamente per la comunicazione con l'interfaccia BDTA.
- Potete disconnettere la connessione in qualsiasi momento.
Problemi frequenti
"Connessione Agate scaduta"
La sessione Agate ha una validità limitata. Cliccate su Riconnetti e accedete nuovamente ad agate.ch.
"Nessuna azienda trovata"
- Assicuratevi che al vostro account agate.ch sia associata almeno un'azienda.
- Per domande contattate il vostro servizio veterinario cantonale o identitas.ch.
L'azienda non può essere cambiata
Non appena gli animali sono stati sincronizzati, l'azienda è bloccata. Se avete effettivamente collegato l'azienda sbagliata, contattate il supporto Herdy.
Suggerimento: Conservate le vostre credenziali di accesso ad agate.ch in luogo sicuro -- non solo per Herdy, ma anche nel caso in cui dobbiate accedere direttamente ad agate.ch.