Requisitos para Certificación API Stock – Chileautos

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:

2. Publicar un aviso para certificación

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:

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":"Volkswagen",
"Model":"Polo",
"ReleaseDate":{
"Year":2020
},
"Title":"VOLKSWAGEN POLO 2020 DESING SOUND 1.6L L4 105HP TM",
"ShortTitle":"VOLKSWAGEN POLO 2020",
"Attributes":[
{
"Name":"Color",
"FeatureGroup":"Detalles",
"DisplayName":"Color",
"Value":"Blanco",
"DisplayOnDetailsPage":true,
"IsKeyAttribute":false,
"IsDeleted":false
},
{
"Name":"DoorNumber",
"FeatureGroup":"Detalles",
"DisplayName":"Puertas",
"Value":"4",
"DisplayOnDetailsPage":true,
"IsKeyAttribute":false,
"IsDeleted":false
},
{
"Name":"BodyStyle",
"FeatureGroup":"Detalles",
"Value":"SUV",
"DisplayOnDetailsPage":true,
"IsKeyAttribute":false,
"IsDeleted":false
},
{
"Name":"FuelType",
"FeatureGroup":"Detalles",
"Value":"Gas",
"DisplayOnDetailsPage":true,
"IsKeyAttribute":false,
"IsDeleted":false
},
{
"Name":"GearType",
"FeatureGroup":"Detalles",
"Value":"Autom\u00e1tica",
"DisplayOnDetailsPage":true,
"IsKeyAttribute":false,
"IsDeleted":false
},
{
"Name":"TipoVehiculo",
"FeatureGroup":"Detalles",
"DisplayName":"Tipo Vehiculo",
"Value":"Autos, Camionetas y 4x4",
"DisplayOnDetailsPage":true,
"IsKeyAttribute":false,
"IsDeleted":false
},
{
"Name":"TipoCategoria",
"FeatureGroup":"Detalles",
"DisplayName":"Tipo Categoria",
"Value":"Camioneta",
"DisplayOnDetailsPage":true,
"IsKeyAttribute":false,
"IsDeleted":false
},
{
"Name": "Aire Acondicionado",
"FeatureGroup": "Equipamiento",
"DisplayName": "Aire Acondicionado",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Espejos Electricos",
"FeatureGroup": "Equipamiento",
"DisplayName": "Espejos Electricos",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Frenos ABS",
"FeatureGroup": "Equipamiento",
"DisplayName": "Frenos ABS",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Airbag",
"FeatureGroup": "Equipamiento",
"DisplayName": "Airbag",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Cierre Centralizado",
"FeatureGroup": "Equipamiento",
"DisplayName": "Cierre Centralizado",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Catalítico",
"FeatureGroup": "Equipamiento",
"DisplayName": "Catalítico",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Llantas",
"FeatureGroup": "Equipamiento",
"DisplayName": "Llantas",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Alarma",
"FeatureGroup": "Equipamiento",
"DisplayName": "Alarma",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Radio",
"FeatureGroup": "Equipamiento",
"DisplayName": "Radio",
"Value": "SI",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
},
{
"Name": "Cilindrada",
"FeatureGroup": "Equipamiento",
"DisplayName": "Cilindrada",
"Value": "1500",
"DisplayOnDetailsPage": true,
"IsKeyAttribute": false,
"IsDeleted": false
}
]
},
"Identifier":"0204139a-3015-42b1-9450-a5d951e8cf7b",
"Type":"Car",
"ListingType":"Usado",
"SaleStatus":"In Stock",
"Registration": {
"Number": "zzzz28"
},
"Description":"",
"Colours":[
{
"Location":"Exterior",
"Generic":"Grey",
"Name":"Gris"
},
{
"Location":"Interior",
"Generic":"Grey",
"Name":"Gris"
}
],
"OdometerReadings":[
{
"Value":21968,
"UnitOfMeasure":"KM"
}
],
"PriceList":[
{
"Currency":"CLP",
"Amount":15000000
}
],
"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 el GUID del aviso creado (InventoryIdentifier) y el JSON completo que fue enviado.

• El equipo técnico de Chileautos validará que:

  • Los campos requeridos estén completos según el ejemplo.

  • Las imágenes se visualicen correctamente.

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.

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.

5. Aprobación y certificación

Si todo está correcto, se notificará al integrador que la certificación ha sido exitosa. En ese 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 compartirlas con su integrador.
Por políticas de seguridad, el equipo de soporte no habilita ni entrega credenciales directamente a integradores (terceras partes).

*Recomendaciones:

• 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