El SDK de Sales Layer está diseñado para ayudarte a conectar aplicaciones externas con tu cuenta de Sales Layer de forma práctica, utilizando el mismo servicio RESTful en el que se basa la API 1.18.

Es especialmente útil cuando quieres acelerar el desarrollo de integraciones y trabajar con clases listas para usar y scripts de ejemplo, en lugar de crear cada solicitud desde cero.

El SDK está disponible para PHP y permite la comunicación bidireccional con Sales Layer. Esto significa que puedes recuperar información del PIM y también enviar información de vuelta a él.

Qué puedes hacer con el SDK

Con el SDK puedes:

• Conectar sistemas externos con Sales Layer usando la API de una forma más sencilla.
• Trabajar con scripts de ejemplo para escenarios habituales de integración.
• Recuperar datos de Sales Layer.
• Importar datos en el PIM.
• Exportar datos a una base de datos en los escenarios compatibles.

En general, el SDK te ayuda a crear integraciones más rápido, ya que proporciona una capa práctica sobre la API para los flujos de trabajo más habituales.

Relación con la API 1.18

El SDK funciona con el mismo modelo de integración que la API 1.18. Utiliza el servicio REST de Sales Layer y está pensado para escenarios de extracción e inserción masiva de datos.

Si ya utilizas la API 1.18, el SDK te ofrece una forma más estructurada de trabajar con esas mismas solicitudes desde un entorno PHP.

Conectores

Igual que la API 1.18, el SDK utiliza los mismos conectores como mecanismo de integración.

A través de estos conectores, puedes definir cómo se estructura, se filtra y se intercambia la información entre Sales Layer y tu sistema externo.

Para trabajar con el SDK, necesitas configurar al menos uno de estos conectores:

• Un conector personalizado para la extracción de datos.
• Un conector de importación para la entrada de datos.

Al igual que con la API 1.18, los conectores deben protegerse con un token desde los parámetros del conector.

URL del servicio

El servicio está disponible a través de esta URL:

https://api.saleslayer.com

Formato de intercambio

Como el SDK funciona sobre un servicio web RESTful, la información se intercambia en JSON. Esto facilita la integración de Sales Layer con sistemas externos y mantiene el flujo de datos alineado con la configuración del conector.

Según la configuración del conector, el SDK trabajará con los datos que coincidan con la estructura y los filtros configurados.

Flujo de trabajo habitual

Un flujo de trabajo habitual con el SDK suele ser así:

1. Configurar el conector en Sales Layer.
2. Protegerlo con un token.
3. Utilizar las clases del SDK en PHP para conectar con el servicio de la API.
4. Recuperar o enviar datos según la configuración del conector.

En los procesos de salida, la primera sincronización suele devolver todos los ítems que coinciden con los filtros configurados. Después, el flujo puede centrarse en los ítems que se hayan modificado, según cómo esté configurada la integración.

Buenas prácticas

Antes de crear tu integración, asegúrate de que la estructura del conector coincide con los datos que quieres intercambiar. También es recomendable partir de uno de los ejemplos proporcionados con el SDK, especialmente si necesitas lógica de exportación, paginación o importación, ya que esto facilita mucho las pruebas y la adaptación.