Búsqueda

Paso a paso para Certificación API Stock – Chileautos

  • Actualización

Antes de que un integrador pueda comenzar a publicar inventario en Chileautos a través de la API de stock, es necesario que estudie con detención la documentación para luego pasar por un proceso de certificación en ambiente de prueba. Este procedimiento asegura que los avisos cumplan con el estándar de calidad y estructura requerida por la plataforma.

A continuación, detallamos los 5 pasos que debe seguir el integrador para autenticar su conexión, enviar un aviso de prueba correctamente estructurado y completar la validación para obtener acceso a producción.

1. Autenticación – Obtener Token

El primer paso para integrarse con la API de Chileautos es obtener un token de autenticación utilizando las credenciales entregadas (Client ID y Secret Key). Este token permitirá autorizar las solicitudes posteriores a la plataforma en ambiente de prueba..

  • Client ID: 464f4235-8052-4832-a5ea-6738021263fe

  • Secret Key: Cen/5ic8fYtGbHMD4lU8VYHZ5/sJsU/N4qrl9V2DIzU=

-Solicitud POST a: 

https://id.s.core.csnglobal.net/connect/token

\ --header 'Content-Type: application/x-www-form-urlencoded' \ --

data-urlencode 'client_id=464f4235-8052-4832-a5ea-6738021263fe' \ --data-urlencode 'client_secret=Cen/5ic8fYtGbHMD4lU8VYHZ5/sJsU/N4qrl9V2DIzU=' \ --data-urlencode 'grant_type=client_credentials'

Ejemplo en Postman:

Header:

Body:

{ "access_token": "eyJ...xxx", "expires_in": 3600 (1 hora) }
 

 

2. Publicar un aviso para ser certificado

Con el token de autenticación ya generado, el siguiente paso es crear un Aviso en formato GUID, que se usará como InventoryIdentifier del aviso, hacer un POST al endpoint de publicación de vehículos. Luego, completa el header con Content-Type: application/json y Authorization: Bearer {token}. En el body del request debes incluir la estructura JSON del aviso con todos los campos requeridos para su certificación.

-Endpoint:

http://globalinventory-publicapi.stg.core.csnglobal.net/v1/vehicles/{InventoryIdentifier}

-Headers:

Content-Type: application/json

Authorization: Bearer {access_token}

Ejemplo en Postman:

*Enviar un aviso (Body)

Para que un aviso se publique correctamente en nuestro sitio y sea fácilmente encontrado por los usuarios mediante los distintos filtros de búsqueda, se deben informar los siguientes campos básicos:

{
"RecordType": "Autos, camionetas y 4x4",
"Make": "Volkswagen",
"Model": "Polo",
"ReleaseDate": {
"Year": 2020
},
"Title": "VOLKSWAGEN POLO 2020 DESIGN SOUND 1.6L L4 105HP TM",
"ShortTitle": "VOLKSWAGEN POLO 2020"
}

  • RecordType: Tipo de vehículo.

  • Make: Marca.

  • Model: Modelo.

  • ReleaseDate: Año del vehículo.

  • Title: Título completo del aviso.

  • ShortTitle: Título resumido.

*Cómo hacer que el aviso sea visible por el filtro de distintivo
Para que el aviso sea encontrado mediante el filtro de “Distintivo” en el sitio, es necesario incluir un atributo específico llamado Badge, que representa la versión del vehículo (por ejemplo: Platinum, Sport, XLT, etc.).

Este campo debe ir dentro del array "Attributes", con la siguiente estructura:

"Attributes": [
{
        "Name": "Badge",
        "Group": "Detalles",
        "DisplayName": "Versión",
        "Value": "Design",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
]

  • "Name": "Badge" Es obligatorio para que el sistema reconozca el distintivo.

  • "Group": "Detalles" Pestaña donde se mostrará (Detalle o Especificaciones).

  • "DisplayName": "Versión"Nombre del campo.

  • "Value": "Design" Debe contener el nombre exacto del distintivo tal como se quiere mostrar en el filtro (ej. "Design").

*Color

Para cada aviso, el color del vehículo debe informarse obligatoriamente en dos secciones del JSON, de forma complementaria y consistente:

Como atributo informativo dentro de "Specification.Attributes"
Como estructura normalizada dentro del nodo raíz Colours

*Como se agrega para informar color en "Specification.Attributes"

Ejemplo:


  "Name": "Color",
  "FeatureGroup": "Detalles",
  "DisplayName": "Color",
  "Value": "Blanco",
  "DisplayOnDetailsPage": true,
  "IsKeyAttribute": false,
  "IsDeleted": false
}

*Como se agrega para informar color en nodo raíz Colours

Ejemplo:


"Colours": [
  {
    "Location": "Exterior",
    "Generic": "Grey",
    "Name": "Gris"
  },
  {
    "Location": "Interior",
    "Generic": "Grey",
    "Name": "Gris"
  }
]

*Implementación: Tags de Productos
Para asignar servicios adicionales a un aviso, se utiliza el arreglo "Tags". Es fundamental definir correctamente el Name (producto) y el Value (modelo de facturación/duración).

*Tipos de Valores (Value)
"oneshot": Se utiliza para productos que tienen una duración fija y no se renuevan automáticamente (ej. un acelerador de ventas por 7 días).

"recurrente": Se utiliza para productos vinculados a una suscripción mensual que se renuevan hasta que se solicite la baja.

*Tabla de Mapeo de Productos

Producto (Name) Descripción Valores Soportados
premium Destaque superior a aviso estándar. Sin valor
topspot Ubicación en la parte superior. oneshot, recurrente
showcase Vitrina destacada. oneshot, recurrente
certified.ads Sello de aviso certificado. oneshot, recurrente
fb-price-tag Etiqueta de precio, descuento especial oneshot, recurrente
descuentosonline Etiqueta de oferta especial. oneshot, recurrente
Oportunidad0km Específico para  0km. oneshot, recurrente

*Ejemplo de estructura de tags en JSON
Aquí tienes cómo debería verse el bloque de un vehículo que tiene activado un Premium reutilizable, un TopSpot contratado como One-shot y Oportunidad0km contratado como recurrente.

"Tags": [
        {
            "Name": "premium",
            "Value": "" 
        },
        {
            "Name": "topspot",
            "Value": "oneshot"
        },
        {
            "Name": "Oportunidad0km",
            "Value": "recurrente"
        }
    ]
}

Uso del campo Group (pestaña Detalle y Equipamiento) en los atributos del vehículo:

El campo Group (o su equivalente FeatureGroup) dentro de Specification.Attributes define en qué sección de la ficha del vehículo se mostrará cada atributo, permitiendo clasificarlo ya sea en “Detalles” para información principal o en “Equipamiento” para elementos adicionales. Ambos nombres de campo son interpretados de forma equivalente por la API Global de Chileautos y determinan exclusivamente la ubicación visual del atributo en la ficha.

“Detalles” > Información principal del vehículo (Color, Combustible, Badge/Versión, Carrocería, etc.)
“Equipamiento” > Elementos adicionales (Aire acondicionado, ABS, Airbag, etc.)

Body (ejemplo completo):
El JSON del aviso de prueba debe tener la siguiente estructura:

{
  "PublishingDestinations": [
    {
      "Name": "ChileAutos"
    }
  ],
  "Media": {
    "Photos": [
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "1"
      },
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "2"
      },
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "3"
      },
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "4"
      },
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "5"
      },
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "6"
      },
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "7"
      },
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "8"
      },
      {
        "Url": "http://fotos.carplanet.mx/view/img/usedcars/hex99889/5fa300797e5ae/big/big_0.jpg",
        "Order": "9"
      }
    ]
  },
  "Seller": {
    "Identifier": "05e8ed1b-1355-4486-a6a2-a043959edff9"
  },
  "Specification": {
    "RecordType": "Autos, Camionetas y 4x4",
    "Make": "Peugeot",
    "Model": "2008",
    "ReleaseDate": {
      "Year": "2023"
    },
    "Title": "Peugeot 2008 2023 ACTIVE 1.2",
    "ShortTitle": "Peugeot 2008 2023",
    "Attributes": [
      {
        "Name": "Color",
        "Group": "Detalles",
        "DisplayName": "Color",
        "Value": "GRAFITO",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "DoorNumber",
        "Group": "Detalles",
        "DisplayName": "Puertas",
        "Value": "null",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "BodyStyle",
        "Group": "Detalles",
        "DisplayName": "Carrocería",
        "Value": "SUV",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "FuelType",
        "Group": "Detalles",
        "DisplayName": "Combustible",
        "Value": "Bencina",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "GearType",
        "Group": "Detalles",
        "DisplayName": "Transmisión",
        "Value": "Manual",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "Badge",
        "Group": "Detalles",
        "DisplayName": "Versión",
        "Value": "ACTIVE 1.2",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "TipoVehiculo",
        "Group": "Detalles",
        "DisplayName": "Tipo Vehiculo",
        "Value": "Autos, Camionetas y 4x4",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "TipoCategoria",
        "Group": "Detalles",
        "DisplayName": "Tipo Categoria",
        "Value": "Suv / Station Wagon",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "Aire Acondicionado",
        "Group": "Equipamiento",
        "DisplayName": "Aire Acondicionado",
        "Value": "SI",
        "DisplayOnDetailsPage": false,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "Airbag",
        "Group": "Equipamiento",
        "DisplayName": "Airbag",
        "Value": "SI",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "Radio",
        "Group": "Equipamiento",
        "DisplayName": "RADIO",
        "Value": "SI",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      },
      {
        "Name": "Cilindrada",
        "Group": "Equipamiento",
        "DisplayName": "Cilindrada",
        "Value": "0",
        "DisplayOnDetailsPage": true,
        "IsKeyAttribute": false,
        "IsDeleted": false
      }
    ]
  },
  "Identifier": "b4a1c5d7-0e92-4f68-8314-f5d62bfdc98e",
  "Type": "Car",
  "ListingType": "Usado",
  "SaleStatus": "In Stock",
  "Description": "Aviso de pruebas en ambiente STG",
  "ExtendedProperties": [
    {
      "Name": "WhatsApp",
      "Value": ""
    }
  ],
  "Registration": {
    "Number": "PRPR88"
  },
  "OdometerReadings": [
    {
      "Value": "32000",
      "UnitOfMeasure": "KM"
    }
  ],
  "PriceList": [
    {
      "Currency": "CLP",
      "Amount": "12490000"
    }
  ],
  "tags": []
}

*Asegúrate de:

  • Generar un Guid único para el aviso, como en el caso del ejemplo.
    "InventoryIdentifier": "0204139a-3015-42b1-9450-a5d951e8cf7b"

  • Definir el Seller.Identifier del dealer o automotora al que pertenece el aviso, en el caso del ejemplo:
    "Seller.Identifier": "05e8ed1b-1355-4486-a6a2-a043959edff9"

  • Incluir imágenes reales y accesibles.

Glosario:

GUID (Globally Unique Identifier): Es un identificador único global, generalmente en formato de cadena alfanumérica, que garantiza la unicidad a través de sistemas y bases de datos. Se utiliza para identificar de manera única un objeto o entidad.

InventoryIdentifier: Es un GUID que se usa para identificar de manera única un producto o ítem dentro de un inventario. Este identificador se mantiene consistente en todos los registros relacionados con ese producto.

SellerIdentifier: Es un identificador único asignado a una Automotora o Sucursal dentro del sistema. Este identificador permite distinguir a un dealer de otros.

 

-Las credenciales proporcionadas en la documentación, junto con los valores de InventoryIdentifier y SellerIdentifier, son exclusivamente para uso en el ambiente de pruebas. Para obtener credenciales productivas, es necesario completar el proceso de certificación.

 

3. Validar publicación

Una vez enviado el aviso, el integrador debe:

  • Confirmar que el aviso fue creado correctamente (respuesta HTTP 200).

  • Informar a Chileautos al correo soporte-dealer@chileautos.cl indicando el GUID del aviso creado (InventoryIdentifier) y el JSON completo que fue enviado.

 

  • IMPORTANTE:
    Enviar al equipo técnico de Chileautos el GUID y el JSON completo del aviso. Se validará que:

  • Los campos requeridos estén correctamente completos, según el ejemplo de referencia.

  • Las imágenes se visualicen correctamente y estén bien estructuradas en el JSON.

Esto es necesario para continuar con el proceso de validación técnica.

4. Modificar y Eliminar publicación

Modificación:

Para actualizar un aviso ya publicado, primero obtener el token de acceso. Luego, realiza una solicitud PATCH al endpoint correspondiente usando el InventoryIdentifier del aviso ejemplo:

Endpoint:

http://globalinventory-publicapi.stg.core.csnglobal.net/v1/vehicles/{InventoryIdentifier}

Recordando que el InventoryIdentifier de nuestro ejemplo es:

"InventoryIdentifier": "0204139a-3015-42b1-9450-a5d951e8cf7b"

Headers:

--header 'accept: */*' \
--header 'Content-Type: application/merge-patch+json' \
--header 'Authorization: Bearer {access_token}' \
--header 'x-seller-identifier: {seller_identifier}' \

 

Recordando que el seller_identifier de nuestro ejemplo:
"Seller.Identifier": "05e8ed1b-1355-4486-a6a2-a043959edff9"

En el (body) como RAW, debes incluir únicamente los campos que deseas modificar en formato JSON. Por ejemplo, si necesitas actualizar el kilometraje, puedes enviar:

{
"OdometerReadings":[
{
"Value":150000,
"UnitOfMeasure":"KM"
}
]
}

Esta modificación parcial permite editar datos específicos sin reemplazar toda la información del aviso.

  • IMPORTANTE:
    En este paso, por favor enviar a Chileautos al correo soporte-dealer@chileautos.cl el GUID del mismo aviso que se envió a publicar (InventoryIdentifier), junto con el JSON que contenga únicamente los campos modificados, para que el equipo técnico pueda validarlo. Esto es necesario para completar el proceso de certificación o revisión.

Eliminación:

Para eliminar un aviso, el primer paso es generar un token de autenticación mediante el endpoint de token. Una vez obtenido el access_token, debes crear una nueva solicitud con el método DELETE.

Endpoint:

http://globalinventory-publicapi.stg.core.csnglobal.net/v1/vehicles/{InventoryIdentifier}

Recordando que el InventoryIdentifier de nuestro ejemplo es:

"InventoryIdentifier": "0204139a-3015-42b1-9450-a5d951e8cf7b"

Headers:

--header 'accept: */*' \
--header 'Authorization: Bearer {access_token}' \
--header 'x-seller-identifier: {seller_identifier}' \

Recordando que el seller_identifier de nuestro ejemplo:
"Seller.Identifier": "05e8ed1b-1355-4486-a6a2-a043959edff9"

Si todo está correcto, recibirás una respuesta 200, lo que indica que el aviso fue eliminado exitosamente del inventario.

  • IMPORTANTE:

Notificar al equipo de Chileautos al correo soporte-dealer@chileautos.cl la eliminación del mismo aviso que anteriormente se publicó y modificó, para que puedan revisar si la eliminación se procesó correctamente y así dar paso a la certificación final.

 

5. Aprobación y certificación

Si todo está correcto, se notificará al integrador que la certificación ha sido exitosa. En ese mismo momento, se informará también al ejecutivo comercial de la cuenta correspondiente para que la propuesta comercial del cliente que solicitó la integración sea aceptada.
Una vez completado ese paso, las credenciales productivas serán enviadas directamente al cliente que contrató el servicio. Será responsabilidad del cliente compartir dichas credenciales con su integrador.
Por políticas de seguridad, el equipo de soporte no habilita ni entrega credenciales directamente a integradores (terceras partes).
Adicionalmente, en el caso de que el integrador sea un proveedor que presta servicio a múltiples clientes, las credenciales se generarán una única vez y serán enviadas únicamente al primer cliente que contrate el servicio con dicho proveedor. Estas mismas credenciales podrán ser utilizadas para los demás clientes que contraten posteriormente con ese proveedor, diferenciando el inventario y la operación de cada dealer mediante el sellerIdentifier, el cual corresponde a un dato único e identificador exclusivo de cada dealer.
 

  • El aviso debe representar un caso real y completo.

  • No omitir campos obligatorios: Make, Model, Año, Precio, KMs, Tipo, Imágenes, etc.

  • Usar imágenes válidas que no contengan logos ni marcas de agua para evitar que las elimine la IA.

  • Por último, algunas recomendaciones de como publicar en Chileautos > Como Publicar


La información contenida en esta página se proporciona únicamente como referencia. No constituye asesoría profesional ni experta y no sustituye dicho tipo de asesoría. El contenido puede no ser apropiado, exacto o suficiente para sus circunstancias particulares y no debe considerarse como el único fundamento para adoptar o abstenerse de adoptar decisiones.

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 0 de 0

¿Tiene más preguntas? Enviar una solicitud