Con Connectif puedes registrar las compras que tus clientes realicen en tus tiendas físicas para registrarlas en su ficha de contacto y disponer de un historial unificado entre sus acciones online y offline. De esta forma, podrás utilizar esa información para personalizar tus estrategias utilizando el historial completo de compras de cada cliente, independientemente del canal en el que las haya realizado.
En este artículo aprenderás cómo integrar compras de tiendas físicas mediante la API de Connectif para que estas queden registradas en la ficha de cada contacto.
Para hacer uso de la integración mediante API, necesitarás de un experto con conocimientos de programación. Si necesitas más información, revisa la documentación de la API de Connectif.
Antes de empezar
Para poder realizar esta integración, deberás tener los siguientes aspectos cubiertos:
- Email como clave primaria: el contacto debe existir en tu base de Contactos de Connectif, con un email asociado como clave primaria. Aunque la API admite otros identificadores (como DNI o teléfono), utilizarlos como identificador principal provocaría la creación de contactos duplicados.
- Catálogo y productos sincronizados: todos los productos que incluya la compra offline deben existir en tu catálogo de Connectif. Si un artículo se vende exclusivamente en tiendas físicas y no forma parte de la web, deberás crearlo en Connectif con el estado Descontinuado para poder vincularla venta offline.
- Información de los productos: es recomendable enviar la información completa de los productos incluidos en la compra, especialmente el atributo categories. Con ello podrás crear segmentos de producto y usar esa información en tus estrategias automatizadas.
- Estructura estricta de la petición: la petición solo puede incluir los atributos admitidos por el modelo de la API. No es posible enviar campos personalizados o atributos adicionales dentro del JSON.
Aprende cómo funciona la API de Connectif en este artículo.
PASO 1. Preparación de contactos en Connectif
(En este apartado se explica cómo preparar tus contactos en Connectif para que puedan relacionarse correctamente a la compra offline).
Puedes añadir los contactos a Connectif mediante una importación de archivo o a través de la API.
Al registrar una compra offline mediante la API, Connectif asociará la información enviada a los contactos y productos existentes. La API no los creará durante el proceso, por lo que deberás comprobar previamente que estén creados en Connectif.
1. Comprueba que el contacto ya existe en Connectif con su email registrado. En caso de no existir, créalo previamente para poder vincular la actividad correctamente.
2. En el buscador, introduce el email del contacto para comprobar su existencia. Si el contacto no existe, deberás crearlo para poder asociar la compra a su historial.
Aprende cómo importar contactos en este artículo.
PASO 2. Preparación de productos en Connectif
(En este apartado se explica cómo preparar tus productos en Connectif para que puedan relacionarse correctamente a la compra offline).
Puedes añadir los productos a Connectif mediante una importación de archivo o a través de la API.
3. Accede a "E-commerce > Catálogo" y haz clic en el botón de opciones .
4. Si alguno de los artículos asociados a la compra offline no existe en Connectif, créalo antes de importar la compra, para ello:
-
Haz clic en Crear producto.
-
Completa, como mínimo, los campos obligatorios del producto (nombre, ID, Url de detalle y precio).
- Si el producto solo se vende en tiendas físicas, asígnale el estado Descontinuado,para que la compra offline se pueda registrar pero el producto no se muestre en la tienda online.
La Url de detalle es obligatoria, aunque el producto no exista en la web o esté marcado como Descontinuado. En estos casos, incluye una URL que utilice el mismo dominio registrado en tu tienda de Connectif para evitar errores de validación. Por ejemplo, si el dominio de tu tienda es https://www.midominio.com, puedes utilizar como Url de detalle: https://www.midominio.com/productos/SKU-12345.
PASO 3. Creación de la clave API
5. Accede a la Configuración de tienda en el menú lateral izquierdo de Connectif.
6. En el selector de pestaña, ve a "API y accesos IP" y haz clic en API Keys.
7. Haz clic en el botón Crear nueva API Key.
8. En la sección Compras del panel de creación, habilita los permisos para Leer, Escribir y Borrar de forma masiva.
Si también vas a gestionar contactos y productos mediante la API, habilita los permisos correspondientes en las secciones Contactos y Productos.
9. Guarda la clave API y cópiala para utilizarla posteriormente en tu script de automatización.
PASO 4. Registro de la compra mediante la API
(En este apartado se explica cómo preparar el envío de la información de la compra a Connectif mediante API).
Para registrar una compra offline, deberás realizar una petición HTTP POST que enviará la información de la compra a Connectif en formato JSON.
10. Crea el script de automatización desde tu sistema e incluye en él la API Key generada en el paso anterior
11. Configura en el script una petición HTTP POST para registrar la compra en Connectif: https://api.connectif.cloud/purchases/
En la petición, indica:
- La API Key para autenticar la llamada.
- El tipo de contenido application/json.
- La información de la compra en el cuerpo de la petición.
12. Crea la información de la compra a enviar y verifica que cumpla las siguientes condiciones:
- Incluye los atributos obligatorios de la compra: cartId, products, purchaseDate, purchaseId, totalPrice y totalQuantity.
- Identifica al contacto mediante contactEmail.
- Para cada producto incluido en products, completa los atributos obligatorios: name, price, productDetailUrl, productId, quantity y unitPrice.
- Para registrar la compra como procedente de una tienda física, configura sourceType con el valor point-of-sale e indica la tienda o sucursal en sourceName.
- Asegúrate de que purchaseId está como identificador único de la compra.
Aprende cómo elaborar la estructura completa de la petición en la documentación de la API.
Ejemplo
Una vez creada, la petición tendrá un aspecto similar a este:
const apiKey = "TU_API_KEY";
const url = "https://api.connectif.cloud/purchases/";
const purchase = {
contactEmail: "cliente@ejemplo.com",
purchaseId: "POS-20260804-001",
cartId: "POS-20260804-001",
purchaseDate: "2026-08-04T15:30:00Z",
sourceType: "point-of-sale",
sourceName: "Tienda Centro",
products: [
{
productId: "SKU-12345",
name: "Zapatilla Running",
categories: ["Calzado/Running"],
quantity: 2,
unitPrice: 39.95,
price: 79.90,
productDetailUrl: "https://www.midominio.com/productos/SKU-12345"
}
],
totalQuantity: 2,
totalPrice: 79.90
};
async function main() {
const response = await fetch(url, {
method: "POST",
headers: {
"Authorization": `apiKey ${apiKey}`,
"Content-Type": "application/json"
},
body: JSON.stringify(purchase)
});
const result = await response.json();
console.log(result);
}
main();
El script registra una compra realizada en una tienda física y la asocia al contacto indicado en el atributo contactEmail. Los atributos sourceType y sourceName identifican el punto de venta físico y el nombre de origen de donde se realizó.
¡Éxito!
La importación de compras de las tiendas físicas ya está lista.
¡Sigue aprendiendo!
Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:
- Integraciones vía API, para administrar eventos como registros de compras o altas de contactos.
- Integración personalizada para enviar datos desde Connectif, para enviar información en tiempo real mediante Webhooks.
- Importación de contactos, para importar contactos a Connectif de forma manual.
- Exportación de contactos y actividades, para exportar contactos y eventos desde Connectif.