Portal de Desarrolladores

Autenticación

La API de SIVEC utiliza API Keys para autorizar las solicitudes. Podés generar y administrar tus claves en el panel de desarrollador en tu cuenta.

Límites y Quotas

Los límites de velocidad varían según el plan contratado. Al exceder las quotas, los endpoints devolverán una respuesta con código 429 Too Many Requests.

Códigos de Error

La API de SIVEC utiliza códigos HTTP estándar. Todas las respuestas fallidas devuelven un JSON estructurado para facilitar la depuración técnica.

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "La API Key provista es inválida o ha expirado.",
    "documentation_url": "https://sivec.com.ar/docs#errors"
  },
  "meta": {
    "api_version": "1.1",
    "timestamp": "2026-07-15T13:00:00Z"
  }
}

Devuelve una lista paginada de todos los vehículos (autos y motos) activos y en stock de tu concesionaria. Ideal para poblar tu catálogo web de cara al público.

Parámetros Query

Respuesta Ejemplo

{
  "success": true,
  "data": {
    "vehicles": [
      {
        "id": 509,
        "make": "Volkswagen",
        "model": "Amarok",
        "version": "3.0 V6 Highline 4x4",
        "year": 2024,
        "mileage": 12000,
        "color": "Gris Oscuro",
        "price_usd": 42000,
        "status": "En stock",
        "image_urls": ["https://cdn.sivec.com.ar/img_01.jpg"]
      }
    ],
    "pagination": {
      "total": 12,
      "limit": 20,
      "offset": 0,
      "has_more": false
    }
  },
  "meta": {
    "api_version": "1.1",
    "timestamp": "2026-07-15T13:00:00Z"
  }
}

Devuelve la ficha técnica detallada de un vehículo en particular utilizando su ID. Útil para renderizar páginas de detalles de producto en tu web.

Respuesta Ejemplo

{
  "success": true,
  "data": {
    "id": 509,
    "make": "Volkswagen",
    "model": "Amarok",
    "version": "3.0 V6 Highline 4x4",
    "year": 2024,
    "mileage": 12000,
    "color": "Gris Oscuro",
    "price_usd": 42000,
    "status": "En stock",
    "description": "Excelente estado, única mano. Service oficial recién realizado.",
    "doors": 4,
    "fuel_type": "Diesel",
    "transmission": "Automática",
    "image_urls": ["https://cdn.sivec.com.ar/img_01.jpg"]
  }
}

Obtiene los datos de contacto y sucursales públicas de tu concesionaria para mostrarlos dinámicamente en el footer u hojas de contacto de tu sitio.

Respuesta Ejemplo

{
  "success": true,
  "data": {
    "name": "Autos del Sur S.A.",
    "email": "ventas@autosdelsur.com.ar",
    "phone": "+54 11 4567-8900",
    "address": "Av. Corrientes 1234, CABA",
    "sucursales": [
      {
        "name": "Sucursal La Plata",
        "address": "Calle 44 Nro 560, La Plata",
        "phone": "+54 221 481-7563"
      }
    ]
  }
}

Envía un lead interesado desde el formulario de tu sitio web directamente al embudo de ventas (CRM Kanban) de SIVEC.

Parámetros del Body (JSON)

Ejemplo Body & Respuesta

// Solicitud POST
{
  "name": "Carlos Rossi",
  "email": "carlos@rossi.com",
  "phone": "+5491199887766",
  "vehicle_id": 509,
  "message": "Me interesa entregar mi usado en permuta..."
}

// Respuesta 200 OK
{
  "success": true,
  "data": {
    "lead_id": "lead_a1b2c3d4",
    "status": "ingresado"
  }
}

EnterpriseRegistra e ingresa una nueva unidad al stock interno de SIVEC de forma remota (por ejemplo, al recibir una permuta o compra a fábrica).

Parámetros del Body (JSON)

Ejemplo Body & Respuesta

// Solicitud POST
{
  "make": "Ford",
  "model": "Ranger",
  "version": "3.0 V6 Limited",
  "year": 2025,
  "mileage": 0,
  "color": "Azul",
  "price_usd": 48000,
  "status": "En stock"
}

// Respuesta 201 Created
{
  "success": true,
  "data": {
    "id": 510,
    "status": "En stock",
    "registered_at": "2026-07-15T13:40:00Z"
  }
}

EnterpriseActualiza de forma parcial o total la información de un vehículo (por ejemplo, cambiar su precio de venta, ajustar el millaje o cambiar su estado a Reservado).

Ejemplo Solicitud (Actualizar precio y estado)

// Solicitud PUT a /v1/management/vehicles/510
{
  "price_usd": 46500,
  "status": "Reservado"
}

// Respuesta 200 OK
{
  "success": true,
  "message": "Los datos de la unidad ID 510 han sido actualizados.",
  "data": {
    "id": 510,
    "price_usd": 46500,
    "status": "Reservado"
  }
}

EnterpriseArchiva de manera permanente o elimina una unidad de tu stock de SIVEC, removiéndola de todos los canales de venta.

Ejemplo Respuesta

// Respuesta 200 OK de DELETE a /v1/management/vehicles/510
{
  "success": true,
  "message": "La unidad ID 510 ha sido archivada correctamente de la base de datos."
}

Eventos en tiempo real mediante callbacks HTTP POST directos a tu servidor. Disponible próximamente para automatizar tu facturación y flujos de trabajo.