Novedades en las tiendas online OpenTiendas: versión 4.115.11

↔️ Obtener los clientes y suscriptores a través de la API

Se introduce el nuevo recurso contacts en la API, que unifica en una sola entidad tanto clientes como suscriptores. Esto permite trabajar con los datos de los clientes de forma independiente a los pedidos y acceder también a los suscriptores.

Nuevo endpoint: Get contact detail

Nuevo endpoint para obtener un contacto concreto: GET /api/v1/contacts/{id}.

Permite recuperar toda la información asociada, incluyendo datos personales, estado de registro, estado de suscripción a comunicaciones, etc. 

Este endpoint refleja el modelo unificado, donde un contacto puede existir por distintos motivos (pedido, registro, suscripción o importación) y puede estar registrado o no. Un contacto puede ser cliente, suscriptor o ambos.

Nuevo endpoint: List contacts

Nuevo endpoint para obtener listados de contactos:

GET /api/v1/contacts?view=customers
GET /api/v1/contacts?view=subscribers

El parámetro view es obligatorio y permite definir el subconjunto de contactos a recuperar (clientes o suscriptores).

Permite consultar clientes y suscriptores de forma independiente a los pedidos, con soporte de filtros avanzados y ordenación. Entre otros, es posible filtrar por email, estado de registro, tipo de cliente (B2B), estado de suscripción a comunicaciones o fechas de creación y último acceso.

↔️ Más control sobre variantes de producto desde la API

Nuevo endpoint List product variants para obtener la lista completa y paginada de combinaciones de un producto: GET /api/v1/products/{id}/variants complementado al endpoint Get product detail, que solo devuelve una vista previa limitada de las combinaciones. 

Además, como este endpoint devuelve directamente recursos de tipo variant, el parámetro fields permite seleccionar los campos propios de la combinación que se quieren incluir en la respuesta.