Nuevo-Logo-CM-150x150
  • Productos
    • ClearMechanic One Solution
    • Auto Prospección
    • ClearMechanic
    • Planeador de Taller
  • Casos de éxito
    • Agencias o Concesionarias
    • Talleres
    • Por país
      • Bolivia
      • Chile
      • Colombia
      • Costa Rica
      • Ecuador
      • El Salvador
      • Guatemala
      • Honduras
      • México
      • Nicaragua
      • Panamá
      • Paraguay
      • Perú
      • República Dominicana
    • Calculadora de ingresos
  • Nosotros
  • Desarrolladores
Menu
  • Productos
    • ClearMechanic One Solution
    • Auto Prospección
    • ClearMechanic
    • Planeador de Taller
  • Casos de éxito
    • Agencias o Concesionarias
    • Talleres
    • Por país
      • Bolivia
      • Chile
      • Colombia
      • Costa Rica
      • Ecuador
      • El Salvador
      • Guatemala
      • Honduras
      • México
      • Nicaragua
      • Panamá
      • Paraguay
      • Perú
      • República Dominicana
    • Calculadora de ingresos
  • Nosotros
  • Desarrolladores
Solicita un demo

Recepción de vehículos

  • GET /appointments
  • GET /orders
  • GET /appointments/{appointmentId}
  • GET /appointments/{appointmentId}/jobs
  • POST /orders
  • GET /orders/{orderId}
  • PUT /orders/{orderId}
  • GET /customers/{customerId}
  • GET /vehicles/{vin}
  • GET /vehicles/{vin}/warranties
  • GET /vehicles/{vin}/campaigns
  • GET /technicians
  • GET /advisors
  • GET /orderTypes
  • GET /offers
  • GET /dealerships

Cotizaciones

  • POST /orders/{orderId}/estimates
  • GET /orders/{orderId}/estimates
  • PUT /orders/{orderId}/estimates
  • GET /inventoryItems
  • GET /inventoryItems/{itemId}

Facturación

  • POST /invoices

Categoría de documentos: Recepción de vehículos

Obtiene el detalle de un vehículo en específico

GET

/vehicles/{vin}

Al llamado de este recurso se deben obtener datos relacionados al vehículo de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
vin
REQUERIDO

(path)

Número de identificación vehicular.

93482
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": {
    "vehicleId": "93482",
    "vin": "38JD930KPC0278DJ90E",
    "brand": "Mazda",
    "model": "Mazda 3",
    "year": "2020",
    "licensePlate": "UVV3381",
    "kilometers": "20000",
    "idClient": "290839",
    "firstName": "Diana",
    "lastName": "Carranza",
    "mainPhone": "5567231398",
    "mobile": "5519345472",
    "email": "dca_mo92@hotmail.com"
  }
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*{
description:

Representa el conjunto de vehículos que cumplan con los criterios proporcionados en culquiera de los parámetros

vehicleId*string

Identificador único del vehículo

vin*string

Número de Identificación del Vehículo

brand*string

Marca del vehículo

model*string

Modelo del vehículo

year*string

Año del vehículo

licensePlate*string

Placas del vehículo

kilometers*string

Kilometraje del vehículo

customerId*string

Identificador único del cliente

firstName*string

Nombre del cliente

lastName*string

Apellido del cliente

mainPhone*string

Número telefónico fijo del cliente

mobile*string

Número télefonico de celular del cliente

email*string

Correo electrónico del cliente

 
}
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de las garantías de un vehículo

GET

/vehicles/{vin}/warranties

Al llamado de este recurso se deben obtener datos relacionados a las garantías de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
vin
REQUERIDO

(path)

Número de identificación vehicular.

93482
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": "",
  "data": [
    {
      "warrantyId": "83A389",
      "kilometers": "10000",
      "description": "Garantia de los 10000 kilometros",
      "status": "Aprobada",
      "repairDate": ""
    },
    {
      "warrantyId": "2HD90",
      "kilometers": "40000",
      "description": "Garantia de los 40000 kilometros",
      "status": "",
      "repairDate": ""
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de garantías cumplan con los criterios proporcionados en culquiera de los parámetros

{
warrantyId*string

Identificador único de garantía

kilometers*string

Kilometraje del vehículo(si y solo si aplica)

description*string
example: Garantía de los 10000 km, Garantía de los 20000 km

Nombre de la garantía

status*string
example: APROBADO, RECHAZADO

Estado en el que se encuentra la garantía

repairDate*string($YYYY-MM-DDThh:mm:ss.SSSZ)

Fecha en que se aplicó la garantía

 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de las campañas de un vehículo

GET

/vehicles/{vin}/campaigns

Al llamado de este recurso se deben obtener datos relacionados a las campañas de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

 

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
vin
REQUERIDO

(path)

Número de identificación vehicular.

93482
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": [
    {
      "campaignId": "27SHI8",
      "description": "Campaña ejemplo 1"
    },
    {
      "campaignId": "203EDO83",
      "description": "Campaña ejemplo 2"
    },
    {
      "campaignId": "DH2839",
      "description": "Campaña ejemplo 3"
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de campañas cumplan con los criterios proporcionados en culquiera de los parámetros

{
campaignId*string

Identificador único de la campaña

description*string
example: 60E1, Destape de válvulas de desagüe

Nombre de la campaña

 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de Técnicos

GET

/technicians

Al llamado de este recurso se deben obtener datos relacionados a los Técnicos de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": [
    {
      "technicianId": "123",
      "firstName": "Fabian",
      "lastName": "Ibarra",
      "email": "elfabs@gmail.com"
    },
    {
      "technicianId": "246",
      "firstName": "Kevin",
      "lastName": "López",
      "email": "k-lo91@gmail.com"
    },
    {
      "technicianId": "369",
      "firstName": "Bryan",
      "lastName": "Martínez",
      "email": "el_bryan@gmail.com"
    },
    {
      "technicianId": "148",
      "firstName": "Javier",
      "lastName": "Montes",
      "email": "javimontes92@gmail.com"
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de Técnicos que cumplan con los criterios proporcionados en culquiera de los parámetros

{
technicianId*string

Identificador único del Técnico

firstName*string

Nombre del Técnico

lastName*string

Apellido del Técnico

email*string

Correo electrónico del Técnicos

 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de los Asesores de Servicio

GET

/advisors

Al llamado de este recurso se deben obtener datos relacionados a los Asesores de Servicio de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": [
    {
      "advisorId": "321",
      "firstName": "Mario",
      "lastName": "Gomez",
      "email": "Magomez@gmail.com",
      "mobile": "3315649782"
    },
    {
      "advisorId": "642",
      "firstName": "Karina",
      "lastName": "Platas",
      "email": "karina.platas@gmail.com",
      "mobile": "3316497845"
    },
    {
      "advisorId": "963",
      "firstName": "Pedro",
      "lastName": "Claro",
      "email": "3365984812@gmail.com",
      "phone": ""
    },
    {
      "advisorId": "841",
      "firstName": "Angel",
      "lastName": "Cruz",
      "email": "Angel.cruz@gmail.com",
      "mobile": "3368974412"
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de Asesores de Servicio que cumplan con los criterios proporcionados en culquiera de los parámetros

{
advisorId*string

Identificador único del Asesor de Servicio

firstName*string

Nombre del Asesor de Servicio

lastName*string

Apellido del Asesor de Servicio

email*string

Correo electrónico del Asesor de Servicio

mobile*string

Teléfono del Asesor de Servicio

 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de los tipos de Órdenes de Reparación

GET

/orderTypes

Al llamado de este recurso se deben obtener datos relacionados a los tipos de ordenes de acuerdo a los valores proporcionados a través en los parámetros de la llamada.

 

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": [
    {
      "key": "YE67",
      "description": "Cliente",
      "subTypes": [
        {
          "key": "YE67-01",
          "description": "Interno"
        },
        {
          "key": "YE67-02",
          "description": "Garantia"
        }
      ]
    },
    {
      "key": "527I",
      "description": "CAMPAÑAS"
    },
    {
      "key": "3489",
      "description": "Mantenimiento",
      "subTypes": [
        {
          "key": "3489-01",
          "description": "Mantenimiento preventivo"
        },
        {
          "key": "3489-02",
          "description": "Mantenimiento correctivo"
        }
      ]
    },
    {
      "key": "DIAG83",
      "description": "DIAGNOSTICO"
    },
    {
      "key": "037400",
      "description": "OTRO TIPO DE SERVICIO"
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de tipo de Órdenes de Reparación que cumplan con los criterios proporcionados en culquiera de los parámetros

{
key*string

Identificador único del tipo de orden

description*string
example: SINIESTROS, GARANTIAS, CAMPAÑAS

Descripción del tipo de orden

subTypes[

Este atributo representa los subtipos de ordenes, si el DMS o ERP en cuestión no maneja subtipos de ordenes, este atributo podrá no estar presente en la respuesta

{
keystring

Identificador único del subtipo de orden

descriptionstring
example: INTERNA, EXTERNA

Descripción del subtipo de orden

 
}
]
 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de las ofertas de la agencia o taller

GET

/offers

Al llamado de este recurso se deben obtener datos relacionados a las ofertas de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": [
    {
      "offerId": "VH83J9",
      "title": "Oferta por apertura de agencia",
      "description": "Esta es una oferta que se creo por apertura de nueva agencia",
      "price": ""
    },
    {
      "offerId": "IS934",
      "title": "Oferta para nuevos clientes",
      "description": "Se hara una oferta del 20% en el enganche a los nuevos clientes",
      "price": ""
    },
    {
      "offerId": "38HD9",
      "title": "Oferta para empleados",
      "description": "Esta es una oferta que se aplica a los empleados que adquieran una nueva unidad",
      "price": ""
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”. / Server error. Its advised to detail the error through the “message” attribute.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de las agencias o talleres

GET

/dealerships

Al llamado de este recurso se deben obtener datos relacionados a las agencias de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
Sin datos
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": [
    {
      "dealershipId": "939",
      "name": "Ford Insurgentes",
      "prefix": "FOIN"
    },
    {
      "dealershipId": "2905",
      "name": "Hyundai Azcapotzalco",
      "prefix": "HYAZ"
    },
    {
      "dealershipId": "9204",
      "name": "Honda Galerias",
      "prefix": ""
    },
    {
      "dealershipId": "2834",
      "name": "Volks Wagen Hermosillo",
      "prefix": "VWHE"
    },
    {
      "dealershipId": "4940",
      "name": "Honda Coatzacoalcos",
      "prefix": null
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de agencias o talleres que hagan uso del DMS o ERP en cuestión, y que cumplan con los criterios proporcionados en culquiera de los parámetros

{
dealershipId*string

Identificador único de la agencia o taller

name*string

Nombre de la agencia o taller

prefixstring

Prefijo de la agencia o taller

 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de la(s) cita(s)

GET

/appointments

Al llamado de este recurso se deben obtener datos relacionados a la(s) cita(s) de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
dateFrom
REQUERIDO

(query)

Fecha de inicio que se usará para filtrar la información.

2021-09-22
dateTo
REQUERIDO

(query)

Fecha de fin que se usará para filtrar la información.

2021-09-22
arrived
REQUERIDO

(query)

(query)
Estatus de las citas u Órdenes de Reparación que hace referencia a si el cliente ya se presentó o no a la agencia o taller. Si no se incluye, se devuelven todas las citas u Órdenes de Reparación.

true
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": [
    {
      "appointmentId": "639503",
      "orderId": null,
      "status": "Pending",
      "clientId": "738949",
      "firstName": "Ricardo",
      "lastName": "Gamboa Torres",
      "address": "Av de los Insurgente 6400, Colonia del Valle, CDMX, CP 03100",
      "mainPhone": "5534456006",
      "secondaryPhone": null,
      "mobile": "5584982090",
      "email": "rgamboatorres@gmail.com",
      "serviceAdvisorId": "28494",
      "vin": "3KPC24B54KE019325",
      "licensePlate": "UHN5647",
      "brand": "Honda",
      "model": "Accord",
      "year": "2019",
      "date": "2021-09-21T12:30:00.000Z",
      "promisedDate": null,
      "confirmed": true,
      "socialName": null,
      "comments": "Cliente pide descuento en servicio",
      "preOrderId": null,
      "orderTypeId": "1",
      "orderType": "MANTENIMIENTO",
      "serviceType": "20000 km",
      "isService": true,
      "isRepair": false,
      "isDiagnostic": false,
      "mainType": "Service",
      "secondType": null,
      "thirdType": null,
      "appointmentPersonId": "014"
    },
    {
      "appointmentId": "639123",
      "orderId": null,
      "status": "No Show",
      "clientId": "918239",
      "firstName": "Carlos",
      "lastName": "Estrada García",
      "address": "Av de los Laureles 1234, Colonia del Valle, CDMX, CP 03110",
      "mainPhone": "5533982928",
      "secondaryPhone": null,
      "mobile": "5533982928",
      "email": "carlosega@gmail.com",
      "serviceAdvisorId": "124",
      "vin": "3KPC24BPO91819325",
      "licensePlate": "UMN1982",
      "brand": "Honda",
      "model": "CR-V",
      "year": "2018",
      "date": "2021-09-21T12:00:00.000Z",
      "promisedDate": null,
      "confirmed": false,
      "socialName": null,
      "comments": null,
      "preOrderId": null,
      "orderTypeId": "1",
      "orderType": "DIAGNÓSTICO",
      "serviceType": "Revisión de Frenos",
      "isService": false,
      "isRepair": false,
      "isDiagnostic": true,
      "mainType": "diagnostic",
      "secondType": null,
      "thirdType": null,
      "appointmentPersonId": "011"
    },
    {
      "appointmentId": "640010",
      "orderId": null,
      "status": "Arrive",
      "clientId": "8726182",
      "firstName": "Angel",
      "lastName": "Viveros Ruiz",
      "address": "Av Central 8172, Colonia del Prado, CDMX, CP 03100",
      "mainPhone": "3388117722",
      "secondaryPhone": null,
      "mobile": "3388117722",
      "email": "angelviruz@gmail.com",
      "serviceAdvisorId": "124",
      "vin": "3KPC24BPO918MKSJAS",
      "licensePlate": "JKV9019",
      "brand": "Honda",
      "model": "Civic",
      "year": "2020",
      "date": "2021-09-21T11:30:00.000Z",
      "promisedDate": null,
      "confirmed": true,
      "socialName": null,
      "comments": null,
      "preOrderId": null,
      "orderTypeId": "1",
      "orderType": "MANTENIMIENTO",
      "serviceType": "10000 km",
      "isService": true,
      "isRepair": false,
      "isDiagnostic": false,
      "mainType": "service",
      "secondType": null,
      "thirdType": null,
      "appointmentPersonId": "014"
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de citas que cumplan con los criterios proporcionados en cualquiera de los parámetros

{
appointmentId*string

Identificador único de la cita

orderId*string

Identificador único de la orden relacionada a la cita

status*string
example: PENDING, ARRIVE, NO SHOW, NO SETTLED

Estado en el que se encuentra la cita

clientId*string

Identificador único del cliente relacionado a la cita

firstName*string

Nombre del cliente

lastName*string

Apellido del cliente

address*string

Dirección del cliente

mainPhone*string

Número telefónico del cliente

secondaryPhonestring

Número alternativo del cliente

mobile*string

Número celular del cliente

email*string

Correo electrónico del cliente

serviceAdvisorId*string

Identificador único del Asesor de Servicio relacionado a la cita

vin*string

Número de Identificación del Vehículo relacionado a la cita

licensePlate*string

Placas del vehículo relacionado a la cita

brand*string

Marca del vehículo relacionado a la cita

model*string

Modelo del vehículo relacionado a la cita

year*string

Año del vehículo relacionado a la cita

date*string($date-time)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha y hora de la cita

promisedDate*string($date-time)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha y hora promesa de entrega del vehículo

confirmed*boolean

Indica si la cita se confirmó con el cliente final.

socialNamestring

Razón social del cliente

commentsstring

Observaciones de la cita o información adicional del vehículo, distintos comentarios deben ir separados por comas.

preOrderIdstring

Identificador único de la pre orden relacionado a la cita, si y solo si la agencia maneja pre ordenes

orderTypeIdstring

Identificador único del tipo de orden relacionado a la cita

orderType*string

Tipo de orden relacionado a la cita

serviceType*string

Tipo de servicio relacionado a la cita

isService*boolean

Valor que indica si la cita esta relacionada a un trabajo de tipo servicio

isRepair*boolean

Valor que indica si la cita esta relacionada a un trabajo de tipo reparación

isDiagnostic*boolean

Valor que indica si la cita esta relacionada a un trabajo de tipo diagnóstico

mainType*string
example: service, repair, diagnostic

Valor que indica cuál es el trabajo principal que se le hará al vehículo.

secondTypestring
example: service, repair, diagnostic

Valor que indica cuál es el trabajo secundario que se le hará al vehículo.

thirdTypestring
example: service, repair, diagnostic

Valor que indica cuál es el trabajo terciario que se le hará al vehículo.

appointmentsPersonId*string
example: 167

Identificador único de la persona que agendó la cita.

 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}

				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de las Órdenes de Reparación

GET

/orders

Al llamado de este recurso se deben obtener datos relacionados a las Órdenes de Reparación de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
vin

(query)

Número de identificación vehícular.

vin
dateFrom

(query)

Fecha de inicio que se usará para filtrar la información.

2021-08-25
dateTo

(query)

Fecha de fin que se usará para filtrar la información.

2021-08-30
arrived

(query)

Estatus de las citas u Órdenes de Reparación que hace referencia a si el cliente ya se presentó o no a la agencia o taller. Si no se incluye, se devuelven todas las citas u Órdenes de Reparación.

true
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": null,
  "data": [
    {
      "appointmentId": "639503",
      "orderId": null,
      "status": "Pending",
      "clientId": "738949",
      "firstName": "Ricardo",
      "lastName": "Gamboa Torres",
      "address": "Av de los Insurgente 6400, Colonia del Valle, CDMX, CP 03100",
      "mainPhone": "5534456006",
      "secondaryPhone": null,
      "mobile": "5584982090",
      "email": "rgamboatorres@gmail.com",
      "serviceAdvisorId": "28494",
      "vin": "3KPC24B54KE019325",
      "licensePlate": "UHN5647",
      "brand": "Honda",
      "model": "Accord",
      "year": "2019",
      "date": "2021-09-21T12:30:00.000Z",
      "promisedDate": null,
      "confirmed": true,
      "socialName": null,
      "comments": "Cliente pide descuento en servicio",
      "preOrderId": null,
      "orderTypeId": "1",
      "orderType": "MANTENIMIENTO",
      "serviceType": "20000 km",
      "isService": true,
      "isRepair": false,
      "isDiagnostic": false,
      "mainType": "Service",
      "secondType": null,
      "thirdType": null,
      "appointmentPersonId": "014"
    },
    {
      "appointmentId": "639123",
      "orderId": null,
      "status": "No Show",
      "clientId": "918239",
      "firstName": "Carlos",
      "lastName": "Estrada García",
      "address": "Av de los Laureles 1234, Colonia del Valle, CDMX, CP 03110",
      "mainPhone": "5533982928",
      "secondaryPhone": null,
      "mobile": "5533982928",
      "email": "carlosega@gmail.com",
      "serviceAdvisorId": "124",
      "vin": "3KPC24BPO91819325",
      "licensePlate": "UMN1982",
      "brand": "Honda",
      "model": "CR-V",
      "year": "2018",
      "date": "2021-09-21T12:00:00.000Z",
      "promisedDate": null,
      "confirmed": false,
      "socialName": null,
      "comments": null,
      "preOrderId": null,
      "orderTypeId": "1",
      "orderType": "DIAGNÓSTICO",
      "serviceType": "Revisión de Frenos",
      "isService": false,
      "isRepair": false,
      "isDiagnostic": true,
      "mainType": "diagnostic",
      "secondType": null,
      "thirdType": null,
      "appointmentPersonId": "011"
    },
    {
      "appointmentId": "640010",
      "orderId": null,
      "status": "Arrive",
      "clientId": "8726182",
      "firstName": "Angel",
      "lastName": "Viveros Ruiz",
      "address": "Av Central 8172, Colonia del Prado, CDMX, CP 03100",
      "mainPhone": "3388117722",
      "secondaryPhone": null,
      "mobile": "3388117722",
      "email": "angelviruz@gmail.com",
      "serviceAdvisorId": "124",
      "vin": "3KPC24BPO918MKSJAS",
      "licensePlate": "JKV9019",
      "brand": "Honda",
      "model": "Civic",
      "year": "2020",
      "date": "2021-09-21T11:30:00.000Z",
      "promisedDate": null,
      "confirmed": true,
      "socialName": null,
      "comments": null,
      "preOrderId": null,
      "orderTypeId": "1",
      "orderType": "MANTENIMIENTO",
      "serviceType": "10000 km",
      "isService": true,
      "isRepair": false,
      "isDiagnostic": false,
      "mainType": "service",
      "secondType": null,
      "thirdType": null,
      "appointmentPersonId": "014"
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de Órdenes de Reparación que cumplan con los criterios proporcionados en cualquiera de los parámetros

{
orderId*string

Identificador único de la orden en la base de datos

orderNumber*string

Número de orden en el sistema

serviceAdvisorId*string

Identificador único del Asesor de Servicio

orderDate*string($date-time)

Fecha de la orden

orderType*string
example: Garantía

Tipo de orden

serviceTypestring
example: Mantenimiento

Describe el tipo de servicio en la Orden de Reparación

status*string
example: Lavado, Revisión de calidad

Algunos DMS o ERP incluyen otros estatus adicionales

total*string
example: Lavado, Revisión de calidad

La factura total de la Orden de Reparación, es decir, el costo total del servicio que será pagado por el cliente.

openDatestring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha cuando la Orden de Reparación es abierta.

closeDatestring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha cuando la Orden de Reparación es cerrada

checkinstring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha de ingreso del vehículo

checkoutstring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha de salida del vehículo

vin*string

Número de Indentificación del Vehículo

brand*string

Marca del vehículo relacionado a la orden

licensePlate*string

Placas del vehículo relacionado a la orden

model*string

Modelo del vehículo relacionado a la orden

year*string

Año del vehículo relacionado a la orden

kilometers*string

Kilometraje del vehículo

customerPartsstring

Costo total en refacciones de la Orden de Reparación

customerLaborstring

Costo total en mano de obra de la Orden de Reparación.

customerMiscstring

Costo total de los articulos diversos (misceláneos) en la factura de la Orden de Reparación

totsCoststring

Costo total de trabajos en otro taller en la factura de la Orden de Reparación.

gogCoststring

Costo de gasolina, aceite y grasa

totalBeforeTaxesstring

Costo total sin impuestos

invoiceDatestring

Fecha de factura

insuranceData
technicianIdstring

Identificador único del Técnico, conocido como el ID del empleado o ID del DMS o ERP

towerNumberstring

Número del cono u objeto puesto sobre cada vehículo en el que se trabaja

utsSoldstring

Unidades de tiempo vendidas (UTS)

commentsstring

Comentarios realizados por el Asesor de Servicio

laborHoursstring

Horas de Mano de obra en la Orden de Reparación

promisedDate*string($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha y hora promesa de la entrega del vehículo

clientId*string

Identificador único del cliente

firstName*string

Nombre del cliente

lastName*string

Apellido del cliente

addressstring

Direccion del cliente

citystring

Ciudad en la dirección del cliente

statestring

Estado en la dirección del cliente

zipstring

Codigo postal de la dirección del cliente

mainPhone*string

Teléfono fijo del cliente

mobilestring

Teléfono celular del cliente

email*string

Correo electrónico del cliente

 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el detalle de una cita en específico.

GET

/appointments/{appointmentId}

Al llamado de este recurso se deben obtener datos relacionados a la cita de acuerdo al valor proporcionado a través del parámetro(path).

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
appointmentId
REQUERIDO

(header)

Identificador único de la cita.

639503
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": {
    "appointmentId": "639503",
    "orderId": null,
    "status": "Ingresada",
    "clientId": "738949",
    "firstName": "Ricardo",
    "lastName": "Gamboa Torres",
    "address": "Av de los Insurgente 6400, Colonia del Valle, CDMX, CP 03100",
    "mainPhone": "5534456006",
    "secondaryPhone": null,
    "mobile": "5584982090",
    "email": "rgamboatorres@gmail.com",
    "serviceAdvisorId": "28494",
    "vin": "3KPC24B54KE019325",
    "licensePlate": "UHN5647",
    "brand": "Honda",
    "model": "Accord",
    "year": "2019",
    "date": "2021-09-21T12:30:00.000Z",
    "promisedDate": null,
    "confirmed": false,
    "socialName": null,
    "comments": null,
    "preOrderId": null,
    "orderTypeId": "1",
    "orderType": "MANTENIMIENTO",
    "serviceType": "20000 km",
    "isService": true,
    "isRepair": false,
    "isDiagnostic": false,
    "mainType": "Service",
    "secondType": null,
    "thirdType": null,
    "appointmentPersonId": "014"
  }
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*{
description:

Representa la cita que cumpla con los criterios proporcionados en cualquiera de los parámetros

appointmentId*string

Identificador único de la cita

orderId*string

Identificador único de la orden relacionada a la cita

status*string
example: PENDING, ARRIVE, NO_SHOW, NO_SETTLED

Estado en el que se encuentra la cita

clientId*string

Identificador único del cliente relacionado a la cita

firstName*string

Nombre del cliente

lastName*string

Apellido del cliente

address*string

Dirección del cliente

mainPhone*string

Número telefónico del cliente

secondaryPhonestring

Número alternativo del cliente

mobile*string

Número celular del cliente

email*string

Correo electrónico del cliente

serviceAdvisorId*string

Identificador único del Asesor de Servicio relacionado a la cita

vin*string

Número de Identificación del Vehículo relacionado a la cita

licensePlate*string

Placas del vehículo relacionado a la cita

brand*string

Marca del vehículo relacionado a la cita

model*string

Modelo del vehículo relacionado a la cita

year*string

Año del vehículo relacionado a la cita

date*string($date-time)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha y hora de la cita

promisedDate*string($date-time)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha y hora promesa de entrega del vehículo

confirmed*boolean

Indica si la cita esta confirmada o no

socialNamestring

Razón social del cliente

commentsstring

Observaciones de la cita o información adicional del vehículo, distintos comentarios deben ir separados por comas.

preOrderIdstring

Identificador único de la pre orden relacionado a la cita, si y solo si la agencia maneja pre ordenes

orderTypeIdstring

Identificador único del tipo de orden relacionado a la cita

orderType*string

Tipo de orden relacionado a la cita

serviceType*string

Tipo de servicio relacionado a la cita

isService*boolean

Valor que indica si la cita esta relacionada a un trabajo de tipo servicio

isRepair*boolean

Valor que indica si la cita esta relacionada a un trabajo de tipo reparación

isDiagnostic*boolean

Valor que indica si la cita esta relacionada a un trabajo de tipo diagnóstico

mainType*string
example: service, repair, diagnostic

Valor que indica cuál es el trabajo principal que se le hará al vehículo.

secondTypestring
example: service, repair, diagnostic

Valor que indica cuál es el trabajo secundario que se le hará al vehículo.

thirdTypestring
example: service, repair, diagnostic

Valor que indica cuál es el trabajo terciario que se le hará al vehículo.

appointmentsPersonId*string
example: 167

Identificador único de la persona que agendó la cita.

 
}
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el listado de los trabajos de una cita en específico

GET

/appointments/{appointmentId}/jobs

Al llamado de este recurso se deben obtener datos relacionados a los trabajos de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
appointmentId
REQUERIDO

(path)

Identificador único de la cita.

639503
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": [
    {
      "source": "Cliente reporta",
      "technician": "Sin asignar",
      "work": "Es el cuarto servicio de mantenimiento",
      "time": 3
    },
    {
      "source": "Asesor de Servicio reporta",
      "technician": "Roberto Calderon",
      "work": "Servicio por garantía",
      "time": 2.5
    }
  ]
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*[

Representa el conjunto de trabajos realizados a una orden que cumplan con los criterios proporcionados en culquiera de los parámetros

{
source*string
example: Cliente reporta, Asesor de Servicio reporta.

Indica quién reportó el trabajo a realizar.

technician*string
example: 035

Identificador único del técnico.

work*string
example: Cambio de balatas

Descripción del trabajo que se va a realizar.

time*number

Medición de tiempo que tardará en realizar el trabajo. Puede estar en horas o UTS, donde 100 UTS = 1 hora

 
}
]
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Creación de Órdenes de Reparación en el Software Tercero de la agencia o taller

POST

/orders

Al llamado de este recurso se debe crear una Orden de Reparación en el DMS o ERP de acuerdo a los valores proporcionados a través del cuerpo de solicitud

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
Cuerpo de solicitud

Formato del cuerpo que se debe envíar desde el cliente para la creación de una orden en el DMS o ERP.

  • Ejemplo
  • Esquema
				
					{
  "vin": "JHLRD77874C026456",
  "organizationId": "01",
  "serviceAdvisorId": "37494",
  "promisedDate": "2021-09-21T17:30:00.000Z",
  "kilometers": "20314",
  "orderType": "Mantenimiento",
  "cone": "30",
  "appointmentId": null
}
				
			
{
vin*string

Número de Identificación del Vehículo relacionado a la orden que se creará en el DMS o ERP

organizationId*string

Identificador único de la agencia o taller relacionada a la orden que se creará en el DMS o ERP

serviceAdvisorIdstring
nullable: true

Identificador único del Asesor de Servicio asignado a la orden que se creará en el DMS o ERP

promisedDate*string

Fecha y hora promesa de entrega del vehículo relacionado a la orden que se creará en el DMS o ERP

kilometers*string

Kilometraje actual del vehículo relacionado a la orden que se creará en el DMS o ERP

orderType*string

Tipo de la orden que se creará en el DMS o ERP

cone*string

Número de cono que se asigna al vehículo relacionado a la orden que se creará en el DMS o ERP

appointmentIdstring
nullable: true

Identificador único de la cita relacionada a la orden que se creará en el DMS o ERP

 
}
Respuestas
Code 200

Respuesta que se debe proporcionar cuando una Orden de Reparación fue creada de forma exitosa.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": "Order successfully created",
  "data": {
    "orderId": "1ABC1-0912-AK123",
    "orderNumber": "AK123",
    "serviceAdvisorId": "37494",
    "orderDate": "2021-01-21T08:30:00.000Z",
    "orderType": "MANTENIMIENTO",
    "serviceType": "service",
    "status": "ABIERTA",
    "promisedDate": "2021-09-21T17:30:00.000Z",
    "total": 3500,
    "openDate": "2021-01-21T08:30:00.000Z",
    "closedDate": "",
    "checkin": "2021-01-21T09:00:00.000Z",
    "checkout": "",
    "vin": "JHLRD77874C026456",
    "brand": "Chevrolet",
    "model": "Spark",
    "year": "2018",
    "licensePlate": "TYU7833",
    "kilometers": "20314",
    "customerParts": null,
    "customerLabor": null,
    "customerMisc": null,
    "totsCost": null,
    "gogCost": null,
    "totalBeforeTaxes": null,
    "invoiceDate": null,
    "insuranceData": {
      "insuranceVehiclesData": "",
      "insurancePolicyNumber": "",
      "insuranceCompany": ""
    },
    "technicianId": "A123",
    "towerNumber": "030",
    "utsSold": "100",
    "comments": "Servicio de los 20,000 km.",
    "clientId": "37438",
    "firstName": "Karina",
    "lastName": "Lopez",
    "address": "Av 100 metros 345 Gustavo A Madero CP 78800",
    "City": "Matehuala",
    "State": "San Luis Potosí",
    "zip": "78800",
    "mainPhone": "3315798465",
    "mobile": "3315798465",
    "email": "karina.lopez@gmail.com"
  }
}
				
			
{
vin*string

Número de Identificación del Vehículo relacionado a la orden que se creará en el DMS o ERP

organizationId*string

Identificador único de la agencia o taller relacionada a la orden que se creará en el DMS o ERP

serviceAdvisorIdstring
nullable: true

Identificador único del Asesor de Servicio asignado a la orden que se creará en el DMS o ERP

promisedDate*string

Fecha y hora promesa de entrega del vehículo relacionado a la orden que se creará en el DMS o ERP

kilometers*string

Kilometraje actual del vehículo relacionado a la orden que se creará en el DMS o ERP

orderType*string

Tipo de la orden que se creará en el DMS o ERP

cone*string

Número de cono que se asigna al vehículo relacionado a la orden que se creará en el DMS o ERP

appointmentIdstring
nullable: true

Identificador único de la cita relacionada a la orden que se creará en el DMS o ERP

 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el detalle de una Orden de Reparación en específico.

GET

/orders/{orderId}

Al llamado de este recurso se deben obtener datos relacionados a la Orden de Reparación de acuerdo al valor proporcionado a través del parámetro(path).

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
orderId
REQUERIDO

(path)

Identificador único de una Orden de Reparación.

OR1234
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": {
    "orderId": "1ABC1-0912-AK123",
    "orderNumber": "AK123",
    "serviceAdvisorId": "37494",
    "orderDate": "2018-01-21T08:30:00.000Z",
    "orderType": "MANTENIMIENTO",
    "serviceType": "service",
    "status": "COMPLETADA",
    "promisedDate": "2018-01-21T11:00:00.000Z",
    "total": 3500,
    "openDate": "2018-01-21T08:30:00.000Z",
    "closedDate": "",
    "vin": "JHLRD77874C026456",
    "brand": "Chevrolet",
    "model": "Spark",
    "year": "2018",
    "licensePlate": "TYU7833",
    "kilometers": "20314",
    "customerParts": "2000",
    "customerLabor": "250",
    "customerMisc": "300",
    "totsCost": "300",
    "gogCost": "167.25",
    "totalBeforeTaxes": "3017.25",
    "invoiceDate": "2018-01-22T12:00:00:00.000Z",
    "insuranceData": {
      "insuranceVehiclesData": "",
      "insurancePolicyNumber": "",
      "insuranceCompany": ""
    },
    "technicianId": "A123",
    "towerNumber": "123",
    "utsSold": "100",
    "comments": "Tenía un golpe en el costado.",
    "clientId": "37438",
    "firstName": "Karina",
    "lastName": "Lopez",
    "address": "Av 100 metros 345 Gustavo A Madero CP 78800",
    "City": "Matehuala",
    "State": "San Luis Potosí",
    "zip": "78800",
    "mainPhone": "3315798465",
    "mobile": "3315798465",
    "email": "karina.lopez@gmail.com"
  }
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*{
description:

Representa el conjunto de Órdenes de Reparación que cumplan con los criterios proporcionados en cualquiera de los parámetros

orderId*string

Identificador único de la orden en la base de datos

orderNumber*string

Número de orden en el sistema.

serviceAdvisorId*string

Identificador único del Asesor de Servicio

orderDate*string($date-time)

Fecha de la orden

orderType*string
example: Garantía

Tipo de orden

serviceTypestring
example: Mantenimiento

Describe el tipo de servicio en la Orden de Reparación

status*string
example: Abierta, Cerrada, Facturada

Algunos DMS o ERP incluyen otros estatus adicionales

total*string

La factura total de la Orden de Reparación, es decir, el costo total del servicio que será pagado por el cliente.

openDatestring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha cuando la Orden de Reparación es abierta.

closeDatestring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha cuando la Orden de Reparación es cerrada

vin*string

Número de Indentificación del Vehículo

brand*string

Marca del vehículo relacionado a la orden

licensePlate*string

Placas del vehículo relacionado a la orden

model*string

Modelo del vehículo relacionado a la orden

year*string

Año del vehículo relacionado a la orden

kilometers*string

Kilometraje del vehículo

customerPartsstring

Costo total en refacciones de la Orden de Reparación

customerLaborstring

Costo total en mano de obra de la Orden de Reparación.

customerMiscstring

Costo total de los articulos diversos (misceláneos) en la factura de la Orden de Reparación

totsCoststring

Costo total de trabajos en otro taller en la factura de la Orden de Reparación.

gogCoststring

Costo de gasolina, aceite y grasa

totalBeforeTaxesstring

Costo total sin impuestos

invoiceDatestring

Fecha de factura

insuranceData
technicianIdstring

Identificador único del Técnico, conocido como el ID del empleado o ID del DMS o ERP

towerNumberstring

Número del cono u objeto puesto sobre cada vehículo en el que se trabaja

utsSoldstring

Unidades de tiempo vendidas (UTS)

commentsstring

Comentarios realizados por el Asesor de Servicio

laborHoursstring

Horas de Mano de obra en la Orden de Reparación

promisedDate*string($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha y hora promesa de la entrega del vehículo

clientId*string

Identificador único del cliente

firstName*string

Nombre del cliente

lastName*string

Apellido del cliente

addressstring

Direccion del cliente

citystring

Ciudad en la dirección del cliente

statestring

Estado en la dirección del cliente

zipstring

Codigo postal de la dirección del cliente

mainPhone*string

Teléfono fijo del cliente

mobilestring

Teléfono celular del cliente

email*string

Correo electrónico del cliente

 
}
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Actualiza una Orden de Reparación en específico.

PUT

/orders/{orderId}

Al llamado de este recurso se deben actualizar los datos relacionados a la Orden de Reparación de acuerdo a los valores proporcionados en el cuerpo de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
orderId
REQUERIDO

(header)

Identificador único de una Orden de Reparación.

OR1234
Cuerpo de solicitud

Formato del cuerpo que se debe enviar desde el cliente para actualizar una Orden de Reparación.

  • Ejemplo
  • Esquema
				
					{
  "orderId": "1ABC1-0912-AK123",
  "orderNumber": "AK123",
  "serviceAdvisorId": "37494",
  "orderDate": "2018-01-21T08:30:00.000Z",
  "orderType": "MANTENIMIENTO",
  "serviceType": "service",
  "status": "COMPLETADA",
  "promisedDate": "2018-01-21T11:00:00.000Z",
  "total": 3500,
  "openDate": "2018-01-21T08:30:00.000Z",
  "closedDate": "",
  "vin": "JHLRD77874C026456",
  "brand": "Chevrolet",
  "model": "Spark",
  "year": "2018",
  "licensePlate": "TYU7833",
  "kilometers": "20314",
  "customerParts": "2000",
  "customerLabor": "250",
  "customerMisc": "300",
  "totsCost": "300",
  "gogCost": "167.25",
  "totalBeforeTaxes": "3017.25",
  "invoiceDate": "2018-01-22T12:00:00:00.000Z",
  "insuranceData": {
    "insuranceVehiclesData": "",
    "insurancePolicyNumber": "",
    "insuranceCompany": ""
  },
  "technicianId": "A123",
  "towerNumber": "123",
  "utsSold": "100",
  "comments": "Tenía un golpe en el costado.",
  "clientId": "37438",
  "firstName": "Karina",
  "lastName": "Lopez",
  "address": "Av 100 metros 345 Gustavo A Madero CP 78800",
  "City": "Matehuala",
  "State": "San Luis Potosí",
  "zip": "78800",
  "mainPhone": "3315798465",
  "mobile": "3315798465",
  "email": "karina.lopez@gmail.com"
}
				
			
{
orderId*string

Identificador único de la orden en la base de datos

orderNumber*string

Número de orden en el sistema.

serviceAdvisorId*string

Identificador único del Asesor de Servicio

orderDate*string($date-time)

Fecha de la orden

orderType*string
example: Garantía

Tipo de orden

serviceTypestring
example: Mantenimiento

Describe el tipo de servicio en la Orden de Reparación

status*string
example: Abierta, Cerrada, Facturada

Algunos DMS o ERP incluyen otros estatus adicionales

total*string

La factura total de la Orden de Reparación, es decir, el costo total del servicio que será pagado por el cliente.

openDatestring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha cuando la Orden de Reparación es abierta.

closeDatestring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha cuando la Orden de Reparación es cerrada

vin*string

Número de Indentificación del Vehículo

brand*string

Marca del vehículo relacionado a la orden

licensePlate*string

Placas del vehículo relacionado a la orden

model*string

Modelo del vehículo relacionado a la orden

year*string

Año del vehículo relacionado a la orden

kilometers*string

Kilometraje del vehículo

customerPartsstring

Costo total en refacciones de la Orden de Reparación

customerLaborstring

Costo total en mano de obra de la Orden de Reparación.

customerMiscstring

Costo total de los articulos diversos (misceláneos) en la factura de la Orden de Reparación

totsCoststring

Costo total de trabajos en otro taller en la factura de la Orden de Reparación.

gogCoststring

Costo de gasolina, aceite y grasa

totalBeforeTaxesstring

Costo total sin impuestos

invoiceDatestring

Fecha de factura

insuranceData
technicianIdstring

Identificador único del Técnico, conocido como el ID del empleado o ID del DMS o ERP

towerNumberstring

Número del cono u objeto puesto sobre cada vehículo en el que se trabaja

utsSoldstring

Unidades de tiempo vendidas (UTS)

commentsstring

Comentarios realizados por el Asesor de Servicio

laborHoursstring

Horas de Mano de obra en la Orden de Reparación

promisedDate*string($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha y hora promesa de la entrega del vehículo

clientId*string

Identificador único del cliente

firstName*string

Nombre del cliente

lastName*string

Apellido del cliente

addressstring

Direccion del cliente

citystring

Ciudad en la dirección del cliente

statestring

Estado en la dirección del cliente

zipstring

Codigo postal de la dirección del cliente

mainPhone*string

Teléfono fijo del cliente

mobilestring

Teléfono celular del cliente

email*string

Correo electrónico del cliente

 
}
Respuestas
Code 204

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": {
    "orderId": "1ABC1-0912-AK123",
    "orderNumber": "AK123",
    "serviceAdvisorId": "37494",
    "orderDate": "2018-01-21T08:30:00.000Z",
    "orderType": "MANTENIMIENTO",
    "serviceType": "service",
    "status": "COMPLETADA",
    "promisedDate": "2018-01-21T11:00:00.000Z",
    "total": 3500,
    "openDate": "2018-01-21T08:30:00.000Z",
    "closedDate": "",
    "vin": "JHLRD77874C026456",
    "brand": "Chevrolet",
    "model": "Spark",
    "year": "2018",
    "licensePlate": "TYU7833",
    "kilometers": "20314",
    "customerParts": "2000",
    "customerLabor": "250",
    "customerMisc": "300",
    "totsCost": "300",
    "gogCost": "167.25",
    "totalBeforeTaxes": "3017.25",
    "invoiceDate": "2018-01-22T12:00:00:00.000Z",
    "insuranceData": {
      "insuranceVehiclesData": "",
      "insurancePolicyNumber": "",
      "insuranceCompany": ""
    },
    "technicianId": "A123",
    "towerNumber": "123",
    "utsSold": "100",
    "comments": "Tenía un golpe en el costado.",
    "clientId": "37438",
    "firstName": "Karina",
    "lastName": "Lopez",
    "address": "Av 100 metros 345 Gustavo A Madero CP 78800",
    "City": "Matehuala",
    "State": "San Luis Potosí",
    "zip": "78800",
    "mainPhone": "3315798465",
    "mobile": "3315798465",
    "email": "karina.lopez@gmail.com"
  }
}
				
			
{
orderId*string

Identificador único de la orden en la base de datos

orderNumber*string

Número de orden en el sistema.

serviceAdvisorId*string

Identificador único del Asesor de Servicio

orderDate*string($date-time)

Fecha de la orden

orderType*string
example: Garantía

Tipo de orden

serviceTypestring
example: Mantenimiento

Describe el tipo de servicio en la Orden de Reparación

status*string
example: Abierta, Cerrada, Facturada

Algunos DMS o ERP incluyen otros estatus adicionales

total*string

La factura total de la Orden de Reparación, es decir, el costo total del servicio que será pagado por el cliente.

openDatestring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha cuando la Orden de Reparación es abierta.

closeDatestring($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha cuando la Orden de Reparación es cerrada

vin*string

Número de Indentificación del Vehículo

brand*string

Marca del vehículo relacionado a la orden

licensePlate*string

Placas del vehículo relacionado a la orden

model*string

Modelo del vehículo relacionado a la orden

year*string

Año del vehículo relacionado a la orden

kilometers*string

Kilometraje del vehículo

customerPartsstring

Costo total en refacciones de la Orden de Reparación

customerLaborstring

Costo total en mano de obra de la Orden de Reparación.

customerMiscstring

Costo total de los articulos diversos (misceláneos) en la factura de la Orden de Reparación

totsCoststring

Costo total de trabajos en otro taller en la factura de la Orden de Reparación.

gogCoststring

Costo de gasolina, aceite y grasa

totalBeforeTaxesstring

Costo total sin impuestos

invoiceDatestring

Fecha de factura

insuranceData
technicianIdstring

Identificador único del Técnico, conocido como el ID del empleado o ID del DMS o ERP

towerNumberstring

Número del cono u objeto puesto sobre cada vehículo en el que se trabaja

utsSoldstring

Unidades de tiempo vendidas (UTS)

commentsstring

Comentarios realizados por el Asesor de Servicio

laborHoursstring

Horas de Mano de obra en la Orden de Reparación

promisedDate*string($date)
pattern: yyyy-MM-ddThh:mm:ss.000Z

Fecha y hora promesa de la entrega del vehículo

clientId*string

Identificador único del cliente

firstName*string

Nombre del cliente

lastName*string

Apellido del cliente

addressstring

Direccion del cliente

citystring

Ciudad en la dirección del cliente

statestring

Estado en la dirección del cliente

zipstring

Codigo postal de la dirección del cliente

mainPhone*string

Teléfono fijo del cliente

mobilestring

Teléfono celular del cliente

email*string

Correo electrónico del cliente

 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}

Obtiene el detalle de un cliente en específico

GET

/customers/{customerId}

Al llamado de este recurso se deben obtener datos relacionados al cliente de acuerdo a los valores proporcionados a través de los parámetros de la llamada.

Parámetros
organizationId
REQUERIDO

(header)

Identificador único de la agencia, taller o inventario de la cual se quiere obtener la información.

16
customerId
REQUERIDO

(path)

Identificador único del cliente final.

12345
Cuerpo de solicitud
Sin datos
Respuestas
Code 200

Solicitud completada de forma satisfactoria.

  • Ejemplo
  • Esquema
				
					{
  "success": true,
  "message": null,
  "data": {
    "clientId": "12345",
    "firstName": "Carlos",
    "lastName": "Castañeda Robles",
    "address": "Calle andada #1538, Colonia del monte, Zapopan, Jal, CP 45440",
    "mainPhone": "31264857",
    "secondaryPhone": "3316487948",
    "mobile": "3315487512",
    "email": "carlos.casta12@gmail.com",
    "socialName": "Carlos Castañeda",
    "RFC": "CAMC900212EI2",
    "fiscalAddress": "Calle andada #1538, Colonia del monte, Zapopan, Jal, CP 45440",
    "fiscalEmail": "carlos.casta12@gmail.com",
    "contactable": true
  }
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso fue exitoso. / Field that tells if a request was successful.

message*string
nullable: true

Proporciona una pequeña descripción cuando ocurre un error al llamado del recurso, por lo regular el valor de este parametro es nulo si no ocurre algún error. / Error message description, can be null if it was a successful request.

data*{
description:

Representa el cliente que cumplan con los criterios proporcionados en culquiera de los parámetros

clientId*string

Identificador único del cliente

firstName*string

Nombre del cliente

lastName*string

Apellido del cliente

address*string

Dirección del cliente

mainPhone*string

Teléfono fijo del cliente

mobile*string

Teléfono celular del cliente

email*string

Correo electrónico del cliente

socialName*string

Razón Social del cliente

RFC*string

RFC del cliente

fiscalAddress*string

Dirección fiscal del cliente

fiscalEmail*string

Correo electrónico de facturación

contactable*boolean

Indica si el cliente desa ser contactado o no.

 
}
 
}
Code 400

Error de solicitud incorrecta, se recomienda proporcionar más detalle a través del atributo “mensaje”, indicando si faltan parámetros para realizar la búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor no puede entender la solicitud debido a un error de sintaxis del lado del cliente, faltan los parámetros: xxxxx, yyyyy, zzzzz. / There is a client side syntax error. The following paramters are missing: xxxxx, yyyyy, zzzzz.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 404

No se encontró una coincidencia con los parámetros de búsqueda.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "No se encontraron datos que cumplan con los criterios proporcionados a través de los parámetros. / There was no match for the resource you're looking for.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Code 500

Error de servidor interno, se recomienda proporcionar más detalle a través del atributo “mensaje”.

  • Ejemplo
  • Esquema
				
					{
  "success": false,
  "message": "El servidor se ha encontrado con una situación que no sabe cómo manejar, intentelo más tarde. / The server can't handle your request at the moment, please try again later.",
  "data": []
}
				
			
{
success*boolean

Valor que indica que el llamado al recurso no fue exitoso. / Field that tells if the request was successful.

message*string

Proporciona una pequeña descripción del error que hubo al momento de la ejecución del recurso. / Provides an error description.

data*[
minItems: 0

maxItems: 0

Arreglo que no contiene datos debido a que hubo un error al momento de la ejecución del recurso. / Empty array due to a failed request.

string]
}
Linkedin Facebook

Compañía

Nosotros

Productos

ClearMechanic One Solution
Auto Prospección
ClearMechanic
Planeador de Taller

Uso de información

Aviso de privacidad
Términos y condiciones
Solicitar eliminar cuenta

© 2024 ClearCheck y sus afiliados.