Integración

Para quien conecta RecommenderPro a un software de gestión o a una tienda online: el formato del archivo, las peticiones, la respuesta y las reglas que respetar. Si lo prefieres, de la conexión nos ocupamos nosotros.

Tres pasos, con ejemplos

1
Exportas el historial
Un archivo de texto sin cabecera. Cada fila es una compra: el cliente, un punto y coma, el producto.
```
C0042;cafe-grano-1kg
C0042;descalcificador
C0117;cafe-grano-1kg
C0117;juego-tazas-6
```
Lo cargas
Desde el Archivo de hechos de la aplicación web o desde la API. La importación se hace en segundo plano, en bloques de 5000 filas, y la sigues en «Importaciones recientes». Volver a cargar un archivo con el mismo nombre lo sustituye.
3
Tu sistema pide las sugerencias
Para un cliente hace una petición GET con su código. Para un carrito hace una petición POST con la lista de productos, como en el ejemplo de más abajo. La respuesta tiene siempre esta forma.
```
GET /api/suggestions/noratings/users/C0042/ventas?minscore=60&max=5

{
  "_count": 1,
  "items": [
    { "prod": "juego-tazas-6", "score": 72.5 }
  ]
}
```

Para un carrito

Tu sistema envía los productos que contiene el carrito. La respuesta tiene la misma forma que la de un cliente.

POST /api/suggestions/noratings/products/ventas?minscore=60&max=5

{ "products": ["cafe-grano-1kg", "descalcificador"] }

Parámetros

Parámetro	Significado	Valor por defecto
`minscore`	Puntuación mínima, de 0 a 100	60
`max`	Número máximo de productos devueltos, hasta 100	10

Cómo se calcula la puntuación lo encuentras en Cómo funciona.

Qué hace falta

Un archivo con dos columnas separadas por punto y coma. Las filas vacías y las que empiezan por # se ignoran. Un campo vacío provoca el rechazo del archivo, que se valida antes de cargarlo.
El nombre del archivo usa letras, cifras y guion bajo, empieza por una letra y tiene hasta 30 caracteres.
Los identificadores usados en las peticiones a la API contienen letras, cifras, guion y guion bajo, hasta 100 caracteres. No se admiten espacios.
Las peticiones de sugerencias necesitan un token de acceso.

¿Necesitas una mano?

De la conexión nos ocupamos nosotros, en bit Time Professionals: formación sobre la integración con el software que ya usas y asistencia. Lo hablamos después de la demo.

¿Quieres ver qué sugeriría a tus clientes?

Te mostramos la aplicación web y cómo se conecta a tu tienda online o a tu software de gestión. Si decides empezar, te acompañamos en la integración.

Solicitar una demo