Ir al contenido
Documentación de Connecto
connecto.lat
API para desarrolladoresReferencia

Productos

Consulta el catálogo de productos y crea o actualiza productos desde otro sistema, identificándolos con una referencia propia (por ejemplo, los planes de Connecto como productos).

Permisos#

PermisoPara qué sirveTipo
productos:leerConsultar productoslectura
productos:escribirCrear y actualizar productosescritura

Endpoints#

GET /productos/consultar#

Lista los productos del catálogo (nombre, descripción, precio, si está activo, categoría y su referencia externa). Filtros opcionales.

Permiso: productos:leer · lectura

Parámetros de la consulta#

ParámetroDescripción
qtexto a buscar en el nombre
referencia_externasolo el producto con esa referencia
limitehasta 100 (25 por defecto)
paginanúmero de página
Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/productos/consultar?q=valor" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/productos/consultar?q=valor", {
  method: "GET",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY }
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/productos/consultar?q=valor");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY")],
]);
$datos = json_decode(curl_exec($ch), true);

POST /productos/sincronizar#

Crea el producto si no existe uno con esa «referencia_externa» y, si existe, lo actualiza (nombre, descripción, precio, categoría y si está activo). Responde 201 al crear y 200 al actualizar. No toca imágenes, campos personalizados ni adicionales.

Permiso: productos:escribir · escritura

Cuerpo (JSON)#

CampoDescripción
referencia_externaobligatorio: tu identificador estable del producto (hasta 80 caracteres: letras, números y : _ . -), por ejemplo plan:inicial
nombreobligatorio, hasta 200 caracteres
precioobligatorio: número mayor o igual a 0
descripcionopcional, hasta 5000 caracteres
categoriaopcional: nombre de la categoría (se crea si no existe; «Productos» por defecto)
activoopcional: true (por defecto) o false
Ejemplo de cuerpo
{
  "referencia_externa": "plan:inicial",
  "nombre": "Inicial",
  "precio": 39,
  "descripcion": "Para equipos que empiezan",
  "categoria": "Planes",
  "activo": true
}
Ejemplo en curl
curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/productos/sincronizar" \
  -H "Authorization: Bearer cnx_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"referencia_externa":"plan:inicial","nombre":"Inicial","precio":39,"descripcion":"Para equipos que empiezan","categoria":"Planes","activo":true}'
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/productos/sincronizar", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "referencia_externa": "plan:inicial",
    "nombre": "Inicial",
    "precio": 39,
    "descripcion": "Para equipos que empiezan",
    "categoria": "Planes",
    "activo": true
})
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/productos/sincronizar");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(array (
  'referencia_externa' => 'plan:inicial',
  'nombre' => 'Inicial',
  'precio' => 39,
  'descripcion' => 'Para equipos que empiezan',
  'categoria' => 'Planes',
  'activo' => true,
)),
]);
$datos = json_decode(curl_exec($ch), true);
¿Te fue útil esta página?
Última actualización: 14/11/2026