Integración para socios
Enlace directo: solicitudes prerrellenadas por API
Crea una solicitud de seguro prerrellenada con una petición POST y lleva a tus clientes directamente a la contratación. Basta una sola llamada a la API.
Demo en vivo
Ajusta los parámetros y mira cómo queda la llamada a la API.
Comando cURL para estos ajustes
curl -X POST https://karlbikes.com/api/v1/proposals/prepare \
-H "Content-Type: application/json" \
-d '{
"token": "YOUR_PARTNER_TOKEN",
"locale": "es-ES"
}'Respuesta de la API (ejemplo)
{
"success": true,
"proposalId": "prop-a1b2c3d4",
"link": "https://karlbikes.com/es-ES/proposals/prop-a1b2c3d4"
}Cómo funciona
1.Crea la solicitud
Tu sistema envía una petición POST con tu token de socio y los datos que ya conoce.
2.Pasa el enlace
La respuesta contiene el enlace a la solicitud prerrellenada. Redirige allí a tu cliente o envíale el enlace.
3.El cliente contrata
Tu cliente revisa los datos, completa lo que falta y contrata. La contratación se te atribuye a ti.
La petición
Una petición POST a nuestra API. La respuesta contiene el enlace listo para tu cliente.
cURL
La petición mínima: solo hace falta el token de socio.
curl -X POST https://karlbikes.com/api/v1/proposals/prepare \
-H "Content-Type: application/json" \
-d '{"token": "YOUR_PARTNER_TOKEN"}'JavaScript (fetch)
La petición completa con los datos de la bici y 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 linkParámetros de la API
Todos los campos del cuerpo JSON de la petición.
| Parámetro | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|
| token | Sí | ninguno | Token de socio que te atribuye los leads (p. ej. «pdemo»). |
| locale | No | de-AT | Idioma de la oferta. Compatibles: 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. Los códigos cortos (de, en, it, fr, es) se aceptan como alias del *-AT correspondiente. |
| bike_desc | No | ninguno | Descripción de la bici (p. ej. marca y modelo). |
| bike_value | No | ninguno | Valor de la bici en EUR (0–100.000). |
| bike_frame | No | ninguno | Número de cuadro de la bici. |
| firstname | No | ninguno | Nombre del tomador del seguro. |
| lastname | No | ninguno | Apellido del tomador del seguro. |
| No | ninguno | Correo electrónico del tomador del seguro. | |
| phone | No | ninguno | Número de teléfono. |
| address | No | ninguno | Calle y número. |
| address2 | No | ninguno | Información adicional de la dirección (p. ej. piso, puerta). |
| zip | No | ninguno | Código postal. |
| city | No | ninguno | Localidad. |
| country | No | ninguno | Código de país del EEE en formato ISO 3166-1 alfa-2 (p. ej. AT, DE, IT). Se admiten los 30 Estados del EEE. |
Consultar el estado de una oferta
Consulta en cualquier momento el estado actual de una oferta, por ejemplo para mostrar u ocultar una sección de seguro en tu portal de clientes. No necesitas token: basta con el ID de la oferta que recibes en la respuesta.
Petición
Una petición GET con el ID de la oferta, nada más.
curl https://karlbikes.com/api/v1/proposals/PROPOSAL_ID/statusJavaScript (fetch)
Consulta el estado y adapta tu propia interfaz.
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"Respuesta de la API (ejemplo)
{
"proposalId": "550e8400-e29b-41d4-a716-446655440000",
"status": "BOUND"
}Valores de estado posibles
| Estado | Significado |
|---|---|
| PENDING | Oferta creada — el cliente aún no ha rellenado la solicitud. |
| DRAFTED | Borrador de contrato creado — el cliente ha facilitado los datos necesarios. |
| ACCEPTED | El cliente ha firmado el contrato. |
| REJECTED | La oferta ha sido rechazada. |
| BOUND | Póliza emitida — el seguro está activo. |
Si el ID de la oferta es desconocido, la API responde con HTTP 404.
Qué obtienes
Solicitudes prerrellenadas
Los datos de la bici y del cliente ya están puestos, tus clientes escriben menos.
Contrataciones para ti
Cada contratación hecha con tu enlace directo se atribuye automáticamente a tu cuenta de socio.
Desde cualquier sistema
Funciona desde cualquier backend: con cURL, con fetch o en el servidor en cualquier lenguaje.
Otras vías
Karl también encaja de otras formas en tus ventas. En el portal de socios te esperan tu token y el código listo.
Calculadora de primas en tu web
Dos líneas de código, y tus clientes ven su prima directamente en tu web.
Ir a la guía de la calculadoraApp de Karl para Shopify
El seguro en la página de producto y después de la compra en tu tienda.
Ir a la guía de ShopifyTu token, tu código
En el portal de socios encuentras tu token de socio y el código de la calculadora, con tu token ya incluido.
Ir a Integraciones
¿Aún no tienes acceso de socio?
Escríbenos y configuramos tu acceso en un día laborable.