Inicio

API Endpoint SANDBOX
https://sandbox.apiceinder.com/api/v1

API Endpoint PRODUCCION
https://prod.apiceinder.com/api/v1
            

El API CEINDER permite operar desde tus propios sistemas para reducir los tiempos de Ingreso de Solicitudes, revisión de Ordenes de Compra, status de Despacho, incluso, es posible obtener información relevante del proceso de compra útil para responder a tus clientes.
* Algunos servicios sólo disponibles bajo solicitud

Para operar es necesario solicitar un CLIENT ID. Escribe a integraciones@ceinder.com para obtener tu propio CLIENT ID.

Login

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/auth/74f-95ss-47b-beb-bc75/login
                
# Ejemplo del payload
                
{
  userId: "usuario@compañia.cl",
  password: "secretpassword"
}
                                
            

Para iniciar la operación es necesario obtener un token_access y su respectivo token_refresh. Con el token_refresh podrás revalidar tu acceso cada 24H.

METHOD: POST
https://API_ENDPOINT/auth/CLIENT ID/login

# Ejemplo del resultado

{
  status: "Success",
  credentials: {
    access: {
        token: "token_access",
        expiresIn: 1644890555367
    },
    refresh: {
        token: "token_refresh",
        expiresIn: 1660442555369
    }
  }
}
                

PARAMETROS EN URL

PARAMETROS EN PAYLOAD

Refresh Token

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/auth/74f-95ss-47b-beb-bc75/refresh
                
# No necesita payload              
            

Usa el token_refresh obtene nuevo token_access y continua con la operación.

METHOD: POST
HEADER: ceinder-refresh-token: token_refresh
https://API_ENDPOINT/auth/CLIENT ID/refresh

# Ejemplo del resultado

{
  status: "Success",
  credentials: {
    access: {
        token: "token_access",
        expiresIn: 1644890555367
    },
    refresh: {
        token: "token_refresh",
        expiresIn: 1660442555369
    }
  }
}
                

PARAMETROS EN URL

NUEVA SOLICITUD

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/solicitud/74f-95ss-47b-beb-bc75/new
                         

# Ejemplo del payload 

{
  codInterno: "135265555-6",
  siniestro: "12345657890SDF",
  liquidador: {
    login: "liquidador009",
    nombre: "Nombre Apellido"
    email: "liquidador@cia.com",
    rut: "1995899-9"
  },
  taller: {
    razonSocial: "AGS Y COMPAÑÍA LTDA (VIÑA)",
    rut: "78532260-6",
    ubicacion: {
      calle: "Avenida San Martin",
      numero: "199",
      comuna: "Viña del Mar",
      ciudad: "Viña del Mar",
      region: "Valparaiso",
      lat: "-33.018752668107965",
      long: "-71.56013104442408",
      email: "desabolladura@agspeugeot.cl",
      telefono: "+56999999989"
    }
  },
  repuestos: [
    {
      nombre: "GUARDAFANGO",
      id: 656525541,
      cantidad: 1,
      zona: "Otra",
      tipoTrabajo: "CAMBIAR",
      calidad: "Original Importación D"
    },
    {
      nombre: "CARTER",
      id: 656525542,
      cantidad: 1,
      zona: "Parte Delantera",
      tipoTrabajo: "CAMBIAR",
      calidad: "ORIGINAL CASA MATRIZ"
    }
  ],
  vehiculo: {
    tipoVehiculo: "SEDAN",
    modelo: "YARIS",
    marca: "TOYOTA",
    yearVehiculo: 2022,
    puertas: 4,
    patente: "JKLD16",
    vin: "1HGBH41JXMN1069186",
    fotos: [
      {
        zona: "OTRA",
        url: "https://tinyurl.com/yc75y3d7" o "Base64 string"
      }
    ]
  }
}
      
            

Inserta una solicitud en el flujo de trabajo de ceinder.com.

METHOD: POST
HEADER: ceinder-access-token: token_access
https://API_ENDPOINT/solicitud/CLIENT ID/new

# Ejemplo del resultado

{
  status: "Success",
  idSolicitud: 105619281,
  at: 1644841097436
}

                

PARAMETROS EN URL

PARAMETROS EN PAYLOAD

ACTUALIZAR SOLICITUD

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/solicitud/74f-95ss-47b-beb-bc75/update/105619281
                         

# Ejemplo del payload 

{
  codInterno: "135265555-6",
  siniestro: "12345657890SDF",
  liquidador: {
    login: "liquidador009",
    nombre: "Nombre Apellido"
    email: "liquidador@cia.com",
    rut: "1995899-9"
  },
  taller: {
    razonSocial: "AGS Y COMPAÑÍA LTDA (VIÑA)",
    rut: "78532260-6",
    ubicacion: {
      calle: "Avenida San Martin",
      numero: "199",
      comuna: "Viña del Mar",
      ciudad: "Viña del Mar",
      region: "Valparaiso",
      lat: "-33.018752668107965",
      long: "-71.56013104442408",
      email: "desabolladura@agspeugeot.cl",
      telefono: "+56999999989"
    }
  },
  repuestos: [
    {
      nombre: "GUARDAFANGO",
      id: 656525541,
      cantidad: 1,
      zona: "Otra",
      tipoTrabajo: "CAMBIAR",
      calidad: "Original Importación D"
    },
    {
      nombre: "CARTER",
      id: 656525542,
      cantidad: 1,
      zona: "Parte Delantera",
      tipoTrabajo: "CAMBIAR",
      calidad: "ORIGINAL CASA MATRIZ"
    }
  ],
  vehiculo: {
    tipoVehiculo: "SEDAN",
    modelo: "YARIS",
    marca: "TOYOTA",
    yearVehiculo: 2022,
    puertas: 4,
    patente: "JKLD16",
    vin: "1HGBH41JXMN1069186",
    fotos: [
      {
        zona: "OTRA",
        url: "https://tinyurl.com/yc75y3d7" o "Base64 string"
      }
    ]
  }
}
      
            

Actuliza una solicitud en el flujo de trabajo de ceinder.com.
Sólo disponible hasta antes de que la solicitud sea publicada.
Para realizar esta operación será se debe enviar la actualización de la solicitud completa, es decir, todos los campos que se enviaron en la creación de la solicitud reemplazando lo que se necesita actualizar.

METHOD: PATCH
HEADER: ceinder-access-token: token_access
https://API_ENDPOINT/solicitud/CLIENT ID/update/idSolicitud

# Ejemplo del resultado

{
  status: "Success",
  idSolicitud: 105619281,
  at: 1644841097436
}

                

PARAMETROS EN URL

PARAMETROS PERMITIDOS EN PAYLOAD

Solicitudes vs Ordenes

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/reports/74f-95ss-47b-beb-bc75/solxoc/2023/all
                
# No necesita payload              
            

Permite obtener la cantidad de Solicitudes vs Ordenes de compra para un año especifico agrupado por mes.

METHOD: GET
HEADER: ceinder-access-token: token_access
https://API_ENDPOINT/reports/CLIENT ID/solxoc/:year/:liquidador

# Ejemplo del resultado

{
 "status": "Success",
 "code": "x200",
 "datos": {
   "solicitudes": [
     {
      "cantidad": 60,
      "monthName": "January",
      "monthId": 1
     }
   ],
   "ordenes": [
     {
      "cantidad": 65,
      "monthName": "January",
      "monthId": 1
     }
   ],
 },
 "at": 1676577470063
}
                

PARAMETROS EN URL

Promedio días de compra

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/reports/74f-95ss-47b-beb-bc75/promDiasCompra/2023/all
                
# No necesita payload              
            

Permite obtener el promedio de dias entre la solicitud de repuestos y la compra respectiva para un año específico agrupado por mes.

METHOD: GET
HEADER: ceinder-access-token: token_access
https://API_ENDPOINT/reports/CLIENT ID/promDiasCompra/:year/:liquidador

# Ejemplo del resultado

{
 "status": "Success",
 "code": "x200",
 "datos": [
    {
        "valor": 1.089873,
        "mes": "January",
        "idMes": 1
    },
    {
        "valor": 1.054814,
        "mes": "February",
        "idMes": 2
    }
 ],
 "at": 1676577470063
}
                

PARAMETROS EN URL

Promedio días de entrega

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/reports/74f-95ss-47b-beb-bc75/promEntrega/2023/all
                
# No necesita payload              
            

Permite obtener el promedio de entrega en dias para un año específico agrupado por mes.

METHOD: GET
HEADER: ceinder-access-token: token_access
https://API_ENDPOINT/reports/CLIENT ID/promEntrega/:year/:proveedor

# Ejemplo del resultado

{
 "status": "Success",
 "code": "x200",
 "datos": [
    {
        "valor": 1.089873,
        "mes": "January",
        "idMes": 1
    },
    {
        "valor": 1.054814,
        "mes": "February",
        "idMes": 2
    }
 ],
 "at": 1676577470063
}
                

PARAMETROS EN URL

Promedio valor marca

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/reports/74f-95ss-47b-beb-bc75/promMarca?year=2023&marca=CHEVROLET&calidad=original
                
# No necesita payload              
            

Permite obtener el valor promedio de una marca para un año específico agrupado por mes.

METHOD: GET
HEADER: ceinder-access-token: token_access
https://API_ENDPOINT/reports/CLIENT ID/promMarca&year=2023&calidad=original

# Ejemplo del resultado

{
 "status": "Success",
 "code": "x200",
 "datos": [
 {
   "marca": "(*) CHEVROLET",
   "data": [
     {
       "valor": 136278,
       "idMes": 2
      }
   ]
 }
],
 "at": 1676577470063
}
                

PARAMETROS EN URL. Year, Marca y Calidad deben ser en formato queryString (nombreParam=valorParam)

Ratio de Ordenes/Solicitud

                
# Ejemplo de url
https://sandbox.apiceinder.com/api/v1/reports/74f-95ss-47b-beb-bc75/ratio-orden-solicitud/2023/all
                
# No necesita payload              
            

Permite obtener el Ratio de conversion Ordenes/Solicitudes para un año específico agrupado por mes.

METHOD: GET
HEADER: ceinder-access-token: token_access
https://API_ENDPOINT/reports/CLIENT ID/ratio-orden-solicitud/2023/all

# Ejemplo del resultado

{
 "status": "Success",
 "code": "x200",
 "data": [
 {
    "monthId": 9,
    "monthName": "September",
    "ratio": "0.91"
 }
],
 "at": 1676577470063
}
                

PARAMETROS EN URL

Errores

Posibles errores en API CEINDER: