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#
| Permiso | Para qué sirve | Tipo |
|---|---|---|
productos:leer | Consultar productos | lectura |
productos:escribir | Crear y actualizar productos | escritura |
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ámetro | Descripción |
|---|---|
q | texto a buscar en el nombre |
referencia_externa | solo el producto con esa referencia |
limite | hasta 100 (25 por defecto) |
pagina | nú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)#
| Campo | Descripción |
|---|---|
referencia_externa | obligatorio: tu identificador estable del producto (hasta 80 caracteres: letras, números y : _ . -), por ejemplo plan:inicial |
nombre | obligatorio, hasta 200 caracteres |
precio | obligatorio: número mayor o igual a 0 |
descripcion | opcional, hasta 5000 caracteres |
categoria | opcional: nombre de la categoría (se crea si no existe; «Productos» por defecto) |
activo | opcional: 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);