How to create an order for Service Department

This document is designed to help you understand how you can create a Repair Order for the Service Department. The endpoint enables users to submit a new repair order with various parameters like orderDate, closeDate, orderNumber, etc.. The created order will contain all the relevant order information. To use this endpoint, you first need your credentials. If you don't already have them, head over to the Authentication and Authorization page to see how you can request credentials from us. The endpoint mentioned below can assist you in creating a Repair Order with customized parameters :-

Parameters Used

Parameter Name	Description	Required
`{{department_token}}`	UUID of service subscriber	True
`{{authorization}}`	Authorization: Basic generate using username password	True

Scope

The service subscriber needs to have the following scope - order.create

Authorization

This request requires the following authorization scopes:

Scope	Level	Description
`order.create`	`DealerDepartment`	Authorizes client to create order for provided user's dealer department

Endpoint

curl -X PUT "https://api.mykaarma.com/order/v2/department/{{serviceSubscriberDealerDepartmentToken}}/order/"
-H "authorization: {{basic_auth_token}}"
-d '{
    "order":{
      "type":"RO",
      "header":{
         "orderNumber":"string",
         "serviceAccount":"string",
         "accountingAccount":"string",
         "status":"string",
         "deptType":"string",
         "advisorNumber":"string",
         "advisorName":"string",
         "assignedUserUuid":"string",
         "creatorUserUuid":"string",
         "appointmentNumber":"string",
         "tagNumber":"string",
         "mileageIn":"string",
         "mileageOut":"string",
         "createDate":"string",
         "createTime":"string",
         "promisedDate":"string",
         "promisedTime":"string",
         "voidDate":"string",
         "closeDate":"string",
         "closeTime":"string",
         "waiter":"string",
         "rental":"string",
         "soldHours":"string",
         "actualHours":"string",
         "laborCost":"string",
         "laborSale":"string",
         "laborSaleCustomer":"string",
         "laborSaleInternal":"string",
         "laborSaleWarranty":"string",
         "partsCost":"string",
         "partsCostCustomer":"string",
         "partsCostInternal":"string",
         "partsCostWarranty":"string",
         "partsSale":"string",
         "partsSaleCustomer":"string",
         "partsSaleInternal":"string",
         "partsSaleWarranty":"string",
         "lubeSale":"string",
         "lubeSaleCustomer":"string",
         "lubeSaleInternal":"string",
         "lubeSaleWarranty":"string",
         "miscSale":"string",
         "miscSaleCustomer":"string",
         "miscSaleInternal":"string",
         "miscSaleWarranty":"string",
         "subletSale":"string",
         "subletSaleCustomer":"string",
         "subletSaleInternal":"string",
         "subletSaleWarranty":"string",
         "customerPayAmount":"string",
         "customerPayStateTax":"string",
         "internalPayAmount":"string",
         "warrantyPayAmount":"string",
         "description":"string"
      },
      "vehicle":{
         "uuid":"string",
         "vin":"string",
         "make":"string",
         "model":"string",
      },
      "customer":{
         "uuid":"string",
         "firstName":"string",
         "lastName":"string"
      },
      "jobs":[
         {
            "jobIdentifier":"string",
            "jobNumberString":"string",
            "lopSeqNumber":"string",
            "laborOpCode":"string",
            "laborOpCodeDesc":"string",
            "laborType":"string",
            "laborSale":"string",
            "soldHours":"string",
            "actualHours":"string",
            "partsSale":"string",
            "miscSale":"string",
            "bookerNo":"string",string
            "dispatchLineStatus":"string",
            "techNo":"string",
            "campaignCode":"string",
            "parts":[
              {
                   
                  "partNumber":"string",
                  "description":"string",
                  "seqNo":"string",
                  "quantityOrdered":"string",
                  "quantitySold":"string",
                  "cost":"string",
                  "salePrice":"string",
                  "saleTotal":"string",
                  "laborType":"string"
              }
            ],
            "gog":[
               {
                  "itemType":"string",
                  "itemDescription":"string",
                  "jobNumber":"string",
                  "quantity":"string",
                  "saleTotal":"string",
                  "salePrice":"string",
                  "laborType":"string"
               }
            ],
            "techHours":[
               {
                  "techNo":"string",
                  "partSeqNo":"string",
                  "laborCost":"string",
                  "laborSale":"string",
                  "soldHours":"string",
                  "otherHours":"string",
                  "laborType":"string"
               }
            ],
            "comments":[
               {
                  "comment":"string",
                  "lastUpdatedBy":"string",
                  "updateDate":string"",
                  "updateTime":"string"
               }
            ],
            "ccc":{
               "complaint":"string",
               "complaintCode":"string",
               "cause":"string",
               "correction":"string"
            }
         }
              
      ],
      "mls" :[
        {
          "laborType": "string",
          "opCode" : "string",
          "opCodeDesc" : "string",
          "failureCode" : "string",
          "salePrice" : "string",
          "costPrice" : "string",
          "saleCompany" : "string",
          "sourceCompany" : "string",
          "lineCode" : "string",
          "poNumber" : "string",
          "poCreateDate" :"string",
          "poLineID" : "string",
          "mlsType" : "string"
        }
      ]
    }
}'

Response

{
  "errors": [
    {
      "errorCode": "string",
      "errorDescription": "string",
      "errorUID": "string"
    }
  ],
  "warnings": [
    {
      "warningCode": 0,
      "warningDescription": "string"
    }
  ],
  "orderUUID": "string",
  "statusCode": "Integer"
}

Request Body

Order Details

Parameter Name	Description	Required
`type`	"RO" for service/repair order	Yes
`orderNumber`	Unique identifier for the order.	Yes
`serviceAccount`	Account associated with the service.	No
`accountingAccount`	Account used for accounting purposes.	No
`status`	Current status of the order .	Yes ( allowed values are "OPENED" , "PRE-INVOICED", "CLOSED" )
`deptType`	Type of department handling the order.	No
`advisorNumber`	Identifier for the service advisor in the DMS to which RO is being assigned .	Yes
`advisorName`	Name of the service advisor.	No
`assignedUserUuid`	Unique token issued by mykaarma of the dealer associate to which RO is being assigned	No ( Required Only if advisorNumber is blank )
`creatorUserUuid`	Unique token issued by mykaarma of the dealer associate which is creating the RO.	No ( Required Only if advisorNumber is blank )
`appointmentNumber`	Appointment Number (generated in the DMS) associated with RO .	No
`tagNumber`	Identifier for the vehicle tag.	No
`mileageIn`	Mileage of the vehicle when it arrived.	No
`mileageOut`	Mileage of the vehicle when it left.	No
`createDate`	Date when the order was created. yyyy-MM-dd format in UTC timezone	Yes
`orderTime`	Time when the order was created. HH:mm:ss in UTC timezone	Yes
`promisedDate`	Date by which the service is promised to be completed. yyyy-MM-dd format in UTC timezone	No
`promisedTime`	Time by which the service is promised to be completed. HH:mm:ss format in UTC timezone	No
`voidDate`	Date when the order was voided. yyyy-MM-dd HH:mm:ss format	No
`closeDate`	Date when the order was closed. yyyy-MM-dd format in UTC timezone	No
`closeTime`	Time when the order was closed. HH:mm:ss format	No
`waiter`	Indicates if the customer is waiting for the service. "Y/N"	No
`rental`	Indicates if a rental vehicle is provided. "Y/N"	No
`soldHours`	Number of hours sold for the service.	No
`actualHours`	Actual hours spent on the service.	No
`laborCost`	Cost of labor for the service. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`laborSale`	Sale amount for labor. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`laborSaleCustomer`	Sale amount for labor charged to the customer. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`laborSaleInternal`	Sale amount for internal labor. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`laborSaleWarranty`	Sale amount for labor under warranty. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`partsCost`	Cost of parts used in the service. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`partsCostCustomer`	Cost of parts charged to the customer. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`partsCostInternal`	Cost of parts for internal use. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`partsCostWarranty`	Cost of parts under warranty. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`partsSale`	Sale amount for parts. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`partsSaleCustomer`	Sale amount for parts charged to the customer. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`partsSaleInternal`	Sale amount for internal parts. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`partsSaleWarranty`	Sale amount for parts under warranty. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`lubeSale`	Sale amount for lubricants. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`lubeSaleCustomer`	Sale amount for lubricants charged to the customer. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`lubeSaleInternal`	Sale amount for internal lubricants. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`lubeSaleWarranty`	Sale amount for lubricants under warranty. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`miscSale`	Sale amount for miscellaneous items. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`miscSaleCustomer`	Sale amount for miscellaneous items charged to the customer. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`miscSaleInternal`	Sale amount for internal miscellaneous items. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`miscSaleWarranty`	Sale amount for miscellaneous items under warranty. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`subletSale`	Sale amount for miscellaneous items under warranty. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`subletSaleCustomer`	Sale amount for sublet services charged to the customer. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`subletSaleInternal`	Sale amount for internal sublet services. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`subletSaleWarranty`	Sale amount for sublet services under warranty. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`customerPayAmount`	Total amount payable by the customer. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`customerPayStateTax`	State tax amount payable by the customer. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`internalPayAmount`	Total internal charges. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`warrantyPayAmount`	Total amount covered by warranty. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`description`	Description of the order.	No

Vehicle Information

Parameter Name	Description	Required
`vehicle.uuid`	Unique identifier issued by mykaarma for the vehicle for which the order is being created.	No
`vehicle.vin`	Vehicle Identification Number for the vehicle for which the order is being created .	No
`vehicle.make`	Manufacturer of the vehicle the order is being created.	No
`vehicle.model`	Model of the vehicle.	No

Customer Information

Parameter Name	Description	Required
`customer.uuid`	Unique identifier issued by mykaarma for the customer for which the order is being created.	Yes
`customer.firstName`	First name of the customer.	No
`customer.lastName`	Last name of the customer.	No

Job details

Parameter Name	Description	Required
`job.jobIdentifier`	Unique identifier for the line + labor operation. Example "A-1","B-2"	No
`job.jobNumberString`	Unique identifier for the line. Example "A","B","C"	Yes
`job.lopSeqNumber`	Sequence number for the labor operation. Example "1","2" ,"3"	Yes
`job.laborOpCode`	Code for the labor operation. Example "OIL"	Yes
`job.laborOpCodeDesc`	Description of the labor operation.	No
`job.laborType`	Type of labor performed. Perferred allowed values are C/W/I	No
`job.laborSale`	Sale amount for the labor.(Only numerics alowed upto 2 decimal places like "12.56" )	No
`job.soldHours`	Number of hours sold for the job.	No
`job.actualHours`	Actual hours spent on the job.	No
`job.partsSale`	Sale amount for parts used in the job. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`job.miscSale`	Sale amount for miscellaneous items in the job. (Only numerics alowed upto 2 decimal places like "12.56" )	No
`job.bookerNo`	Booker number for the job.	No
`job.dispatchLineStatus`	Status of the dispatch line.	No
`job.techNo`	Identifier for the technician in the DMS who performed the job.	No
`job.campaignCode`	Code for any applicable campaign.	No

Parts Information

Parameter Name	Description	Required
`part.partNumber`	Number identifying the part.	Yes
`part.description`	Description of the part.	No
`part.seqNo`	Sequence number for the part.	Yes
`part.quantityOrdered`	Quantity of the part ordered.	No
`part.quantitySold`	Quantity of the part sold.	No
`part.cost`	Cost of the part.	No
`part.salePrice`	Sale price of the part.	No
`part.saleTotal`	Total sale amount for the part.	No
`part.laborType`	Type of labor associated with the part.	No

GOG Information

Parameter Name	Description	Required
`gog.itemType`	Type of item in the GOG.	No
`gog.itemDescription`	Description of the item.	No
`gog.jobNumber`	Job number associated with the item.	No
`gog.quantity`	Quantity of the item.	No
`gog.saleTotal`	Total sale amount for the item.	No
`gog.salePrice`	Sale price of the item.	No
`gog.salePrice`	Sale price of the item.	No
`gog.laborType`	Type of labor associated with the item.	No

Tech Hours

Parameter Name	Description	Required
`tech.itemType`	Identifier for the technician.	No
`tech.itemDescription`	Cost of labor for the technician.	No
`tech.jobNumber`	Sale amount for the labor.	No
`tech.quantity`	Number of hours sold for the technician's work.	No
`tech.saleTotal`	Other hours associated with the technician's work.	No
`tech.salePrice`	Type of labor performed by the technician.	No

Comments

Parameter Name	Description	Required
`comments.comment`	Text of the comment.	No
`comments.lastUpdatedBy`	Identifier for the person who last updated the comment.	No
`comments.updateDate`	Date when the comment was last updated. yyyy-MM-dd format UTC timezone	No
`comments.updateTime`	Time when the comment was last updated. HH:mm:ss format UTC timezone	No

Complaint cause correction

Parameter Name	Description	Required
`ccc.complaint`	Description of the customer's complaint.	No
`ccc.complaintCode`	Code for the complaint.	No
`ccc.cause`	Cause of the job.	No
`ccc.correction`	Correction made to address the complaint.	No

MLS Information

Parameter Name	Description	Required
`mls.laborType`	Type of labor in the MLS.	No
`mls.opCode`	Operation code in the MLS.	No
`mls.opCodeDesc`	Description of the operation code.	No
`mls.failureCode`	Code for any failure.	No
`mls.salePrice`	Sale price in the MLS..	No
`mls.costPrice`	Cost price in the MLS.	No
`mls.saleCompany`	Company responsible for the sale.	No
`mls.sourceCompany`	Company that sourced the item.	No
`mls.lineCode`	Code for the line item.	No
`mls.poNumber`	Purchase order number.	No
`mls.poCreateDate`	Date when the purchase order was created.	No
`mls.poLineID`	Line ID for the purchase order.	No
`mls.mlsType`	Type of MLS entry.	No

Response Object Explanation

{{orderUUID}} uuid of the order which was created/updated .

{{errors}} An array of error objects detailing issues encountered during order creation or update.

{{warnings}} An array of warning objects providing non-critical alerts encountered during customer creation or update.

{{errors.errorCode}} Code indicating the specific error encountered during customer creation or update; refer to the API reference for a list of possible error codes.

{{errors.errorTitle}} Title describing the specific error encountered during customer creation or update; refer to the API reference for detailed descriptions.

{{errors.errorDescription}} Detailed message describing the specific error encountered during customer creation or update; refer to the API reference for more information.

{{warnings.warningCode}} Detailed message describing the specific warning encountered during customer creation or update; refer to the API reference for more information.

{{warnings.warningDescription}} Detailed message describing the specific warning encountered during customer creation or update; refer to the API reference for more information.

Parameters Used​

Scope​

Authorization​

Endpoint​

Response​

Request Body​

Order Details​

Vehicle Information​

Customer Information​

Job details​

Parts Information​

GOG Information​

Tech Hours​

Comments​

Complaint cause correction​

MLS Information​

Response Object Explanation​