Integrazione partner
Link diretto: proposte precompilate via API
Crea una proposta assicurativa precompilata con una richiesta POST e porta i tuoi clienti direttamente alla stipula. Basta una sola chiamata API.
Demo dal vivo
Imposta i parametri e guarda come appare la chiamata API corrispondente.
Comando cURL per queste impostazioni
curl -X POST https://karlbikes.com/api/v1/proposals/prepare \
-H "Content-Type: application/json" \
-d '{
"token": "YOUR_PARTNER_TOKEN",
"locale": "it-CZ"
}'Risposta dell’API (esempio)
{
"success": true,
"proposalId": "prop-a1b2c3d4",
"link": "https://karlbikes.com/it-CZ/proposals/prop-a1b2c3d4"
}Come funziona
1.Crea la proposta
Il tuo sistema invia una richiesta POST con il tuo token partner e i dati che conosce già.
2.Passa il link
La risposta contiene il link alla proposta precompilata. Reindirizza lì il tuo cliente o mandagli il link.
3.Il cliente stipula
Il tuo cliente controlla i dati, completa ciò che manca e stipula. Il contratto viene attribuito a te.
La richiesta
Una richiesta POST alla nostra API. La risposta contiene il link pronto per il tuo cliente.
cURL
La richiesta minima: serve solo il token partner.
curl -X POST https://karlbikes.com/api/v1/proposals/prepare \
-H "Content-Type: application/json" \
-d '{"token": "YOUR_PARTNER_TOKEN"}'JavaScript (fetch)
La richiesta completa con i dati della bici e del cliente.
const response = await fetch(
"https://karlbikes.com/api/v1/proposals/prepare",
{
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
token: "YOUR_PARTNER_TOKEN",
locale: "de-AT",
bike_desc: "Canyon Spectral 125 CF",
bike_value: 3499,
firstname: "Max",
lastname: "Mustermann",
email: "max@example.com",
}),
}
)
const { link } = await response.json()
// Redirect the customer to linkParametri dell’API
Tutti i campi nel corpo JSON della richiesta.
| Parametro | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|
| token | Sì | nessuno | Token partner che ti attribuisce i lead (ad es. “pdemo”). |
| locale | No | de-AT | Lingua dell’offerta. Supportate: de-AT, de-DE, de-IT, en-AT, en-DE, en-IT, it-AT, it-DE, it-IT, fr-AT, fr-DE, fr-IT, es-AT, es-DE, es-IT. I codici brevi (de, en, it, fr, es) sono accettati come alias del rispettivo *-AT. |
| bike_desc | No | nessuno | Descrizione della bici (ad es. marca e modello). |
| bike_value | No | nessuno | Valore della bici in EUR (0–100.000). |
| bike_frame | No | nessuno | Numero di telaio della bici. |
| firstname | No | nessuno | Nome del contraente. |
| lastname | No | nessuno | Cognome del contraente. |
| No | nessuno | Indirizzo e-mail del contraente. | |
| phone | No | nessuno | Numero di telefono. |
| address | No | nessuno | Via e numero civico. |
| address2 | No | nessuno | Indicazioni aggiuntive (ad es. piano, interno). |
| zip | No | nessuno | Codice postale. |
| city | No | nessuno | Località. |
| country | No | nessuno | Codice paese SEE in formato ISO 3166-1 alpha-2 (ad es. AT, DE, IT). Sono ammessi tutti i 30 Stati SEE. |
Controlla lo stato di un’offerta
Chiedi in qualsiasi momento lo stato attuale di un’offerta, ad esempio per mostrare o nascondere una sezione assicurativa nel tuo portale clienti. Non serve un token: basta l’ID dell’offerta ricevuto nella risposta.
Richiesta
Una richiesta GET con l’ID dell’offerta, nient’altro.
curl https://karlbikes.com/api/v1/proposals/PROPOSAL_ID/statusJavaScript (fetch)
Controlla lo stato e adatta la tua interfaccia di conseguenza.
const response = await fetch(
`https://karlbikes.com/api/v1/proposals/${proposalId}/status`,
)
const { status } = await response.json()
// Show the insurance section only once the policy is active
const showInsuranceSection = status === "BOUND"Risposta dell’API (esempio)
{
"proposalId": "550e8400-e29b-41d4-a716-446655440000",
"status": "BOUND"
}Valori di stato possibili
| Stato | Significato |
|---|---|
| PENDING | Offerta creata — il cliente non ha ancora compilato la proposta. |
| DRAFTED | Bozza di contratto creata — il cliente ha fornito i dati necessari. |
| ACCEPTED | Il cliente ha firmato il contratto. |
| REJECTED | L’offerta è stata rifiutata. |
| BOUND | Polizza emessa — l’assicurazione è attiva. |
Se l’ID dell’offerta è sconosciuto, l’API risponde con HTTP 404.
Cosa ottieni
Proposte precompilate
I dati della bici e del cliente sono già inseriti, i tuoi clienti devono scrivere meno.
Contratti attribuiti a te
Ogni contratto stipulato tramite il tuo link diretto viene attribuito automaticamente al tuo account partner.
Da qualsiasi sistema
Funziona da qualsiasi backend: con cURL, con fetch o lato server in qualsiasi linguaggio.
Altre strade
Karl entra nelle tue vendite anche in altri modi. Nel portale partner ti aspettano il tuo token e il codice pronto.
Calcolatore del premio sul tuo sito
Due righe di codice, e i tuoi clienti vedono il loro premio direttamente da te.
Vai alla guida del calcolatoreApp Karl per Shopify
L’assicurazione sulla pagina prodotto e dopo l’acquisto nel tuo negozio.
Vai alla guida ShopifyIl tuo token, il tuo codice
Nel portale partner trovi il tuo token partner e il codice del calcolatore, con il tuo token già inserito.
Vai alle integrazioni
Non hai ancora un accesso partner?
Scrivici e attiviamo il tuo accesso entro un giorno lavorativo.