API: POST /orders/{orderId}/estimates

Agrega cotización a una Orden de Reparación existente.

POST

/orders/{orderId}/estimates

Al llamado de este recurso se deben agregar los Puntos de Inspección seleccionados en CMOS junto con su cotización a una Orden de Reparación ya existente.

Parámetros

organizationId

REQUERIDO

(header)

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

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.

Ejemplo
Esquema

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

{

inspectionItemName

string

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

cmosInspectionItemId

string

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.

quantity

number

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

partUnitPrice

number

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

availability

number

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

laborHours

number

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

laborHourPrice

number

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

comments

string

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 ‘,’

approvalStatus

string
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.
quantity	number Cantidad disponible en el inventario del sistema de cotizaciones externo. / Required quantity of the sub item.
partUnitPrice	number Precio por unidad del artículo del sub punto. / Price per unit of the sub item
availability	number Cantidad disponible en el inventario del sistema de cotizaciones externo. / Availability on stock.
laborHours	number Cantidad de horas cotizadas para trabajar en la mano de obra del Punto de Inspección./ Hours worked on the sub item.
laborHourPrice	number Precio por unidad de hora de mano de obra del sub punto. / Price per hour.
comments	string 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 201

Solicitud completada de forma satisfactoria.

Ejemplo
Esquema

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

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.

{

inspectionItemName

string

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

cmosInspectionItemId

string

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.

quantity

number

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

partUnitPrice

number

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

availability

number

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

laborHours

number

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

laborHourPrice

number

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

comments

string

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 ','

approvalStatus

string
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

{

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.
quantity	number Cantidad disponible en el inventario del sistema de cotizaciones externo. / Required quantity of the sub item.
partUnitPrice	number Precio por unidad del artículo del sub punto. / Price per unit of the sub item
availability	number Cantidad disponible en el inventario del sistema de cotizaciones externo. / Availability on stock.
laborHours	number Cantidad de horas cotizadas para trabajar en la mano de obra del Punto de Inspección./ Hours worked on the sub item.
laborHourPrice	number Precio por unidad de hora de mano de obra del sub punto. / Price per hour.
comments	string 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 ','

}]

}

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]

}

Recepción de vehículos

Cotizaciones

Facturación

API: POST /orders/{orderId}/estimates

Agrega cotización a una Orden de Reparación existente.

POST

/orders/{orderId}/estimates

(header)

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

(path)

Identificador único de una Orden de Reparación.

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.

Solicitud completada de forma satisfactoria.

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.

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

Compañía

Productos

Uso de información