API: PUT /orders/{orderId}/estimates

Actualiza la cotización de una Orden de Reparación ya existente.

PUT

/orders/{orderId}/estimates

Al llamado de este recurso se deben actualizar los Puntos de Inspección de una Orden de Reparación ya existente con la información que se modificó en CMOS.

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

Formato del cuerpo que se debe enviar desde el cliente para la creación de Puntos de Inspección en una cotización de una Orden de Reparación existente. 

				
					{
  "orderNumber": "RO12345",
  "inspectionItems": [
    {
      "inspectionItemName": "Correa Transmisión Serpentina",
      "cmosInspectionItenId": "192859128",
      "externalInspectionItemId": "1928375182",
      "quantity": 1,
      "partUnitPrice": 500,
      "availability": 20,
      "LaborHours": 1,
      "LaborHourPrice": 200,
      "comments": null,
      "approvalStatus": "Pending",
      "subItems": null
    },
    {
      "inspectionItemName": "Retrovisor Delantero Derecho",
      "cmosInspectionItemId": "192856491",
      "externalInspectionItemId": "1928331692",
      "quantity": null,
      "partUnitPrice": null,
      "availability": null,
      "LaborHours": null,
      "LaborHourPrice": null,
      "comments": null,
      "approvalStatus": "Pending",
      "subItems": null
    },
    {
      "inspectionItemName": "Sistema de Refrigeración",
      "cmosInspectionItemId": "192856491",
      "externalInspectionItemId": "1928331692",
      "quantity": null,
      "partUnitPrice": null,
      "availability": null,
      "LaborHours": null,
      "LaborHourPrice": null,
      "comments": null,
      "approvalStatus": "Pending",
      "subItems": [
        {
          "subItemName": "Manguera",
          "externalPartId": "154653",
          "quantity": null,
          "partUnitPrice": null,
          "availability": null,
          "LaborHours": null,
          "LaborHourPrice": null,
          "comments": "Comentario"
        },
        {
          "subItemName": "Líquido Refrigerante",
          "externalPartId": "351391",
          "quantity": null,
          "partUnitPrice": null,
          "availability": null,
          "LaborHours": null,
          "LaborHourPrice": null,
          "comments": "Aceite de buena marca."
        }
      ]
    },
    {
      "inspectionItemName": "Servicio 15,000km",
      "cmosInspectionItemId": "123456789",
      "externalInspectionItemId": "987654321",
      "quantity": null,
      "partUnitPrice": null,
      "availability": null,
      "LaborHours": null,
      "LaborHourPrice": null,
      "comments": "Servicio de 15,000 km",
      "approvalStatus": "Approved",
      "subItems": [
        {
          "subItemName": "Aceite",
          "externalPartId": "159753",
          "quantity": 1,
          "partUnitPrice": 200,
          "availability": 25,
          "LaborHours": null,
          "LaborHourPrice": null,
          "comments": "Comentario"
        },
        {
          "subItemName": "Filtro",
          "externalPartId": "357951",
          "quantity": 1,
          "partUnitPrice": 400,
          "availability": 34,
          "LaborHours": null,
          "LaborHourPrice": null,
          "comments": "Aceite de buena marca."
        },
        {
          "subItemName": "Mano de obra",
          "externalPartId": "456735",
          "quantity": 1,
          "partUnitPrice": 500,
          "availability": null,
          "LaborHours": null,
          "LaborHourPrice": null,
          "comments": "Mano de obra de cambio de aceite."
        }
      ]
    },
    {
      "inspectionItemName": "Espejo Retrovisor",
      "cmosInspectionItemId": "12349876",
      "externalInspectionItemId": "102837529",
      "quantity": null,
      "partUnitPrice": null,
      "availability": null,
      "LaborHours": null,
      "LaborHourPrice": null,
      "comments": "",
      "approvalStatus": "Rejected",
      "subItems": [
        {
          "subItemName": "Espejo",
          "externalPartId": "159753",
          "quantity": 2,
          "partUnitPrice": 500,
          "availability": 25,
          "LaborHours": null,
          "LaborHourPrice": null,
          "comments": "Comentario"
        },
        {
          "subItemName": "Mano de obra",
          "externalPartId": "456735",
          "quantity": null,
          "partUnitPrice": null,
          "availability": null,
          "LaborHours": 2,
          "LaborHourPrice": 150,
          "comments": "Mano de obra de cambio de aceite."
        }
      ]
    },
    {
      "inspectionItemName": "Cambio Balatas traseras",
      "cmosInspectionItemId": "72817291",
      "externalInspectionItemId": "123499882",
      "quantity": null,
      "partUnitPrice": null,
      "availability": null,
      "LaborHours": null,
      "LaborHourPrice": null,
      "comments": "",
      "approvalStatus": "Pending",
      "subItems": [
        {
          "subItemName": "Balatas traseras",
          "externalPartId": "159753",
          "quantity": 2,
          "partUnitPrice": 1000,
          "availability": 20,
          "LaborHours": 2,
          "LaborHourPrice": 500,
          "comments": "Balatas Alcon"
        }
      ]
    },
    {
      "inspectionItemName": "Llanta trasera izquierda",
      "cmosInspectionItemId": "192839288",
      "externalInspectionItemId": "222233434",
      "quantity": 1,
      "partUnitPrice": 2500,
      "availability": null,
      "LaborHours": null,
      "LaborHourPrice": null,
      "comments": "",
      "approvalStatus": "Approved",
      "subItems": [
        {
          "subItemName": "Mano de Obra",
          "externalPartId": "159753",
          "quantity": null,
          "partUnitPrice": null,
          "availability": null,
          "LaborHours": 0.5,
          "LaborHourPrice": 500,
          "comments": "Balatas Alcon"
        }
      ]
    }
  ]
}
{
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 los datos relacionados a la cotización de una Orden de Reparación./ Repair Order’s estimate information.

{
orderNumber*string

Identificador único de la Orden de Reparación de la cual se obtendrá la cotización. / Repair Order unique identifier.

inspectionItems*[

Representa los Puntos de Inspección que se van a cotizar en la Orden de Reparación. / Estimate information of the Repair Order’s inspection items.

{
inspectionItemNamestring

Nombre del Punto de Inspección. / Inspection Item name.

cmosInspectionItemIdstring

Identificador único del Punto de Inspección en la librería maestra de CMOS. / Inspection Item unique identifier in the CMOS master library.

externalInspectionItemId*string

Identificador único del Punto de Inspección en el sistema de cotizaciones externo. / Inspection Item unique identifier in the external system master library.

quantitynumber

Cantidad de artículos que se necesitan de este Punto de Inspección. / Required quantity of the Inspect Item.

partUnitPricenumber

Precio por unidad del artículo en el Punto de Inspección. / Price per unit of the Inspection Item.

availabilitynumber

Cantidad disponible en el inventario del sistema de cotizaciones externo. / Availability in stock.

laborHoursnumber

Cantidad de horas cotizadas para trabajar en la mano de obra del Punto de Inspección. / Hours worked on the Inspection Item.

laborHourPricenumber

Precio por unidad de hora de mano de obra del Punto de Inspección. / Price per hour worked.

commentsstring

Comentarios adicionales sobre el Punto de Inspección. Cada comentario adicional debe estar separado por una coma ‘,’/ Additional comments. Any additional comment should be separated by a comma ‘,’

approvalStatusstring
example: Approved Rejected Pending

Status en el que se encuentra el Punto de Inspección con respecto a la aprobación del cliente. Los estatus disponibles son ‘Pending’, ‘Approved’ y ‘Rejected’ / Status of the Inspection Item regarding the client decision, the posible statuses are: ‘Pending’, ‘Approved’, ‘Rejected’

subItems[
nullable: true

Listado de los sub-puntos con los que cuenta el Punto de Inspección. Un Punto de Inspección puede o no tener sub-puntos. / Sub item list of the Inspection Item. An Inspection Item can have 0 or many sub-items.

{
subItemName*string

Nombre del sub punto. / Sub item name.

externalPartId*string

Identificador único del sub punto en el sistema de cotizaciones externo. / Sub item unique identifier on the external system.

quantitynumber

Cantidad disponible en el inventario del sistema de cotizaciones externo. / Required quantity of the sub item.

partUnitPricenumber

Precio por unidad del artículo del sub punto. / Price per unit of the sub item

availabilitynumber

Cantidad disponible en el inventario del sistema de cotizaciones externo. / Availability on stock.

laborHoursnumber

Cantidad de horas cotizadas para trabajar en la mano de obra del Punto de Inspección./ Hours worked on the sub item.

laborHourPricenumber

Precio por unidad de hora de mano de obra del sub punto. / Price per hour.

commentsstring

Comentarios adicionales sobre el sub punto. Cada comentario adicional debe estar separado por una coma ‘,’/ Additional comments of the sub-item. Any additional comment should be separated by a comma ‘,’

}]
}]
}]
 
}
Respuestas
Code 204

Se ha actualizado la cotización de forma satisfactoria.

				
					Se ha actualizado la cotización de forma satisfactoria. / Successful request.
{
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.

				
					{
  "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.

				
					{
  "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”.

				
					{
  "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.