Convalida dell'indirizzo

Domande frequenti sull'API

Plugins

Quali plugin sono disponibili?

Puoi trovare un elenco di plugin per Shopware, Magento, WooCommerce e altri nella pagina dedicata all'implementazione dell'API.

Perché devo pagare un extra per alcuni plugin?

I plugin gratuiti sono forniti "così come sono" senza assistenza. Poiché esistono molti plugin diversi per piattaforme diverse, far funzionare tutto insieme può essere una sfida. Il codice sorgente di alcuni plugin gratuiti è quindi liberamente accessibile per aiutare il più possibile i partner dedicati all'implementazione a sviluppare il sito come desiderano.

Le versioni a pagamento sono offerte da terze parti che forniscono assistenza per i propri plugin. Viene quindi stipulato un contratto tra due parti diverse: Postcode.nl per l'API e una terza parte per il plugin. Questi contratti sono indipendenti l'uno dall'altro.

Il tuo plugin non è presente nell'elenco?

Nessun problema, l'API può essere integrata anche utilizzando la documentazione tecnica.

Test-API

Come posso testare l'API?

Quando crei un account, questo è sempre il primo accesso di prova, quindi non stai ancora sottoscrivendo un abbonamento. Hai sei mesi di tempo per testare l'API e il numero di convalide che puoi eseguire nell'accesso di prova è limitato.

Dopo il test, è necessario che ci comunichi che hai terminato e che l'abbonamento può avere inizio. A quel punto potrai scegliere l'abbonamento che desideri sottoscrivere.

Più convalide che ordini

Perché nel mio account API vedo più accessi che ordini?

In pratica, il numero di richieste di indirizzi non corrisponde mai esattamente al numero di ordini in un negozio online. Ciò può dipendere da diversi fattori, come il plugin utilizzato o la propria implementazione.

I motivi più comuni sono:

• Gli stessi indirizzi vengono spesso richiesti più volte, ad esempio perché un utente inserisce lo stesso indirizzo più volte o perché il software del negozio online controlla l'indirizzo in più punti. Pertanto, un singolo comando può generare molte richieste. Memorizzando temporaneamente un indirizzo convalidato (ad esempio, fino a una settimana), si evita che lo stesso indirizzo venga raccolto inutilmente dal nostro servizio.
• Richieste con codici postali o numeri civici errati: queste richieste non daranno mai come risultato un indirizzo. Prima di avviare una query, verifica che il codice postale sia completo e nel formato corretto e che il numero civico inizi con delle cifre. Assicurati inoltre che l'indirizzo non possa essere verificato finché l'utente non ha terminato di digitare.

Superamento del limite di convalida

Cosa succede se supero il mio limite di livello attuale?

Prima di tutto, non preoccuparti: l'API non verrà disabilitata se superi il limite. Riteniamo importante che l'API continui a funzionare, in modo che i tuoi clienti possano continuare a effettuare ordini e i tuoi processi non subiscano interruzioni.

Per tenerti informato sul tuo utilizzo, ti vengono inviate delle notifiche via e-mail. Questo avviene al raggiungimento del 50%, dell'80% e del 100% del tuo limite.

Al raggiungimento del 100%, l'abbonamento viene automaticamente aggiornato al livello corretto e corrispondente. Il sistema esamina il numero di convalide nel periodo precedente durante il periodo di abbonamento corrente e formula una previsione sul numero di richieste previste per il resto del periodo di abbonamento.

Al fine di stabilire una stima corretta delle previsioni, l'aggiornamento non avverrà nel primo mese del periodo di abbonamento.

Supererai il livello 5?

In base alla previsione, il consumo previsto viene fatturato in blocchi del 10% del Livello 5 (ovvero 100 euro per Livello) e si applicano anche i prezzi unitari per convalida di tale Livello.

Il mio account API e il mio abbonamento

Come posso gestire il mio account API e il mio abbonamento?

Richiesta di credenziali

Quando accedi all'area di amministrazione con il tuo account amministratore, troverai una voce chiamata "Credenziali" nel menu.

Cliccandoci sopra, vedrai la chiave. Il segreto è stato inviato solo tramite e-mail al momento e non può essere recuperato. Nella stessa pagina, troverai un pulsante in alto a destra per creare una nuova chiave e un nuovo segreto. Questi saranno poi inviati automaticamente tramite e-mail.

Modifica i dettagli della fattura e/o dell'account

Purtroppo, non è ancora possibile farlo tramite l'ambiente di gestione. Per qualsiasi modifica, vi preghiamo di contattarci direttamente via e-mail.

Ripresa del contratto

Per riprendere e attivare un vecchio contratto, contattaci anche via e-mail.

Cancellazione dell'abbonamento

Le cancellazioni delle API possono essere effettuate accedendo all'area amministrativa, operazione che deve essere eseguita dall'amministratore dell'account.

Nel menu "Gestisci" è presente una sezione denominata "Abbonamento". Da qui è possibile cancellare l'abbonamento alla prima occasione utile.

API di completamento automatico degli indirizzi vs. API dei codici postali olandesi

Qual è la differenza tra l'API di completamento automatico degli indirizzi e l'API dei codici postali olandesi?

Utilizzando l'API Address Autocomplete, è possibile recuperare gli indirizzi di tutti i paesi disponibili. Questa API è più completa rispetto all'API dei codici postali olandesi in termini di funzionalità. Ad esempio, non solo è possibile completare gli indirizzi sulla base di un codice postale e di un numero civico, ma è anche possibile completarli utilizzando la funzione automatica "auto complete". Utile se vengono inseriti indirizzi di cui non si conosce il codice postale. L'API dei codici postali olandesi funziona basandosi esclusivamente su un codice postale e un numero civico per ottenere un indirizzo completo.

Posso usare solo un'API?

Naturalmente è possibile utilizzare le API contemporaneamente. Ad esempio, è possibile recuperare gli indirizzi di tutti i clienti utilizzando l'API Address Autocomplete e, specificatamente per i clienti olandesi, l'API Dutch Postcode. Alcuni plugin lo fanno automaticamente, scegliendo l'API giusta quando viene richiesta un'indirizzo.

Perché l'API di completamento automatico degli indirizzi è più costosa dell'API dei codici postali olandesi?

Gli indirizzi recuperati tramite l'API Address Autocomplete hanno un prezzo unitario più elevato, poiché questa API offre più funzionalità. Questa tariffa si applica anche quando un codice postale olandese e un numero civico vengono recuperati dall'API Address Autocomplete.