Create Service Entry Line Item

POST 
https://secure.fleetio.com/api/v2/service_entries/:service_entry_id/service_entry_line_items

Creates a new Service Entry Line Item

Request

Path Parameters

service_entry_id stringrequired

Possible values: Value must match regular expression ^[0-9]+$

The id of the associated Service Entry

application/json

Body

typeServiceEntryLineItemType (string)

Denotes the type of the ServiceEntryLineItem

Possible values: [ServiceEntryServiceTaskLineItem, ServiceEntryLaborLineItem, ServiceEntryPartLineItem, ServiceEntryTaxLineItem, ServiceEntryFeeLineItem, ServiceEntryTireLineItem, ServiceEntryFreeTextLineItem]

service_task_idId (integer)

Possible values: >= 1

descriptionstring

A description of the service performed for this line item.

issue_idsId (integer)[]

IDs of any Issues this line item is linked to.

Possible values: >= 1

labor_costfloat

The cost of labor for this line item.

parts_costfloat

The cost of Parts for this line item.

subtotalfloat

Ignored if labor_cost and parts_cost is present.

Responses

201

OK

Response Headers

application/json

Schema

Schema

idId (integer)required

Possible values: >= 1

created_atdate-time

The date and time at which this record was created.

Example: 2023-03-14T13:46:27-06:00

updated_atdate-time

The date and time at which this record was most recently updated.

Example: 2023-03-14T13:46:27-06:00

account_idId (integer)

Possible values: >= 1

titlestringnullablerequired

A title for this line item.

descriptionstringnullablerequired

A description of the service performed for this line item.

positionintegernullablerequired

The position of this line item in the list of line items.

linking_sourcestringnullablerequired

Possible values: [manual, automatic_algorithm, service_code_mapper]

vehicle_idId (integer)required

Possible values: >= 1

service_entry_line_item_idintegernullablerequired

For nested line items. This value denotes the parent Service Entry Line Item.

service_reminder_idintegernullablerequired

If this line item is linked to a Service Reminder, this ID will be set.

service_entry_idId (integer)required

Possible values: >= 1

service_task_idId (integer)required

Possible values: >= 1

service_code_idNullableId (integer)nullablerequired

Possible values: >= 1

import_idNullableId (integer)nullable

Possible values: >= 1

labor_cost_centsinteger

The labor cost in cents for this line item.

parts_cost_centsinteger

The parts cost in cents for this line item.

subtotal_centsinteger

The pre-tax subtotal in cents for this line item.

vmrs_system_idNullableId (integer)nullable

Possible values: >= 1

vmrs_assembly_idNullableId (integer)nullable

Possible values: >= 1

vmrs_component_idNullableId (integer)nullable

Possible values: >= 1

vmrs_reason_for_repair_idNullableId (integer)nullable

Possible values: >= 1

vmrs_system_group_idNullableId (integer)nullable

Possible values: >= 1

Example (auto)

{
  "id": 0,
  "created_at": "2023-03-14T13:46:27-06:00",
  "updated_at": "2023-03-14T13:46:27-06:00",
  "account_id": 0,
  "title": "string",
  "description": "string",
  "position": 0,
  "linking_source": "manual",
  "vehicle_id": 0,
  "service_entry_line_item_id": 0,
  "service_reminder_id": 0,
  "service_entry_id": 0,
  "service_task_id": 0,
  "service_code_id": 0,
  "import_id": 0,
  "labor_cost_cents": 0,
  "parts_cost_cents": 0,
  "subtotal_cents": 0,
  "vmrs_system_id": 0,
  "vmrs_assembly_id": 0,
  "vmrs_component_id": 0,
  "vmrs_reason_for_repair_id": 0,
  "vmrs_system_group_id": 0
}

401

Request could not be authenticated

application/json

Schema

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

A human-readable explanation specific to this occurrence of the problem.

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (auto)

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

403

Insufficient permission to perform this operation

application/json

Schema

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

A human-readable explanation specific to this occurrence of the problem.

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (auto)

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

422

Unprocessable Entity

application/json

Schema

Schema

errors object
property name* string[]
Array [
string
]

Example (auto)

{
  "errors": {}
}

Example

{
  "errors": {
    "field1": [
      "error1",
      "error2"
    ],
    "field2": [
      "error3"
    ]
  }
}

500

Something unexpected happened

application/json

Schema

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

A human-readable explanation specific to this occurrence of the problem.

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (auto)

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

Authorization: Authorization

name: Authorizationtype: apiKeyin: headerdescription: Prefix the value with "Token", for example: "Token 76cbe06c49a64".
You can generate a new API key [here](https://secure.fleetio.com/api_keys).

name: Account-Tokentype: apiKeyin: headerdescription: You can find your Account-Token [here](https://secure.fleetio.com/api_keys)

• curl
• ruby
• python
• csharp
• go
• java
• nodejs
• php

• CURL

curl -L 'https://secure.fleetio.com/api/v2/service_entries/:service_entry_id/service_entry_line_items' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Token <Authorization>' \
-H 'Account-Token: <Authorization>' \
-d '{
  "type": "ServiceEntryServiceTaskLineItem",
  "service_task_id": 0,
  "description": "string",
  "issue_ids": [
    0
  ],
  "labor_cost": 0,
  "parts_cost": 0,
  "subtotal": 0
}'

Request Collapse all

Base URL

https://secure.fleetio.com/api

Auth

apiKey

accountToken

Parameters

service_entry_id — pathrequired

Body

{
  "type": "ServiceEntryServiceTaskLineItem",
  "service_task_id": 0,
  "description": "string",
  "issue_ids": [
    0
  ],
  "labor_cost": 0,
  "parts_cost": 0,
  "subtotal": 0
}

ResponseClear

Click the Send API Request button above and see the response here!