Il programma di supporto jtl-bridge
jtl-bridge legge JTL-Wawi (database o API REST) nella rete aziendale e carica i dati crittografati su allverto. Comandi, opzioni e sicurezza.
jtl-bridge è un piccolo programma a riga di comando per la migrazione. Gira su un computer della tua rete aziendale – dove JTL-Wawi e il suo SQL Server sono raggiungibili –, legge i dati e li carica su allverto tramite una connessione crittografata. Così non devi esporre su internet né il tuo database né il server REST della Wawi.
Come jtl-bridge ottiene le credenziali
Inserisci server, utente e password oppure indirizzo e chiave API nella procedura guidata di migrazione. jtl-bridge si autentica presso allverto con il token di importazione e recupera questi dati in forma crittografata. In alternativa imposti password e chiave API solo in locale (JTL_DB_PASSWORD, JTL_API_KEY).
Il token di importazione lo generi nella procedura guidata con Genera token di importazione. Viene mostrato una sola volta e vale 30 giorni, al massimo fino alla conclusione della migrazione. Con Prolunga di 30 giorni lo estendi da oggi, con Nuovo token di importazione il vecchio diventa non valido. Il token vale inoltre solo finché la persona che lo ha generato o prolungato per ultima è attiva e può «Eseguire la migrazione da JTL-Wawi».
Comandi
| Comando | A cosa serve |
|---|---|
jtl-bridge check --url <allverto-Adresse> --token <Import-Token> | Verificare connessione e struttura del database, contare le quantità – non carica nulla. |
jtl-bridge upload --url <allverto-Adresse> --token <Import-Token> | Leggere e caricare i dati. |
jtl-bridge register --api-url http://wawi-server:<port>/api/eazybusiness | Registrare allverto come app nella Wawi e recuperare la chiave API (vedi Configurare l'API REST). |
Il comando upload adatto con il tuo indirizzo lo mostra la procedura guidata nel riquadro Programma di supporto jtl-bridge – con un pulsante per copiarlo. (<allverto-Adresse> = indirizzo di allverto, <Import-Token> = token di importazione.)
Opzioni importanti
| Opzione | Significato |
|---|---|
--source db, --source api | forzare il canale (altrimenti vale l'origine impostata in allverto) |
--fill-from-db | con il canale API: integrare dal database ciò che l'API non fornisce |
--until JJJJ-MM-TT | solo documenti fino a questo giorno (data di passaggio; formato AAAA-MM-GG) |
--entities a,b,c | solo determinati tipi di dati |
--no-pdfs | non recuperare i PDF delle fatture |
--db-host, --db-instance, --db-port, --db-name, --db-user, --db-encrypt | sovrascrivere in locale i dati del database |
--api-url | sovrascrivere in locale l'indirizzo del server REST |
Sicurezza
- jtl-bridge carica solo tramite HTTPS e altrimenti si interrompe («Nur HTTPS ist erlaubt (Daten verlassen das Firmennetz).» – è consentito solo HTTPS, i dati lasciano la rete aziendale).
- Oltre alla connessione HTTPS, i dati sono crittografati con una chiave derivata dal token di importazione.
- Del token di importazione allverto salva solo un'impronta, mai il token stesso.
- Dopo dieci token non validi dallo stesso indirizzo, allverto blocca ulteriori tentativi per alcuni minuti.
- Dopo Completa il passaggio il token non è più valido e i dati JTL memorizzati temporaneamente vengono eliminati.
Procedura tipica
jtl-bridge check …– è tutto a posto?jtl-bridge upload …– caricare i dati.- In allverto: Assegnazioni → Prova → Migrazione.
- Prima della data di passaggio di nuovo
uploade in allverto Avvia esecuzione delta.