Update Purchase Order

Update a Purchase Order

Path Parameters

• number string required

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

  The Purchase Order Number

application/json

Request Body

• description string
• label_list string

  Possible values: <= 255 characters

  A comma separated list of tags associated with this record. The only delimiter allowed is a comma (,). Please remove any commas from your labels before saving the record.

• vendor_id integer

  Possible values: >= 1

• part_location_id int32

  Possible values: >= 1

  The Fleetio ID of the Part Location for the Part being purchased.

• number int32

  Must be unique within the scope of your Account. You can either generate your own number or leave it blank and Fleetio will generate one for you. Fleetio will use the next number in the sequence based on your existing Purchase Orders. This becomes the unique identifier, even in endpoints. Id is never used.

• discount_type DiscountType

  Possible values: [fixed, percentage]

  Default value: percentage

  The type of discount applied to this record.

• discount_percentage int32

  The discount percentage. This field should be present when discount_type is set to percentage.

• discount number

  The actual value of the discount

• shipping number

  The cost of shipping

• tax_1_percentage number

  The primary tax percentage amount. This field should be present when tax_1_type is set to percentage.

• tax_1 int32

  The actual amount of the primary tax in cents

• tax_1_type string

  Possible values: [fixed, percentage]

  Default value: percentage

  The type of tax to apply to this record.

• tax_2_percentage number

  The secondary tax percentage amount. This field should be present when tax_2_type is set to percentage. Note that this secondary tax must be configured in your Account Settings.

• tax_2 int32

  The secondary tax amount. Note that this secondary tax must be configured in your Account Settings.

• tax_2_type string

  Possible values: [fixed, percentage]

  Default value: percentage

  The type of tax to apply to this record.

• custom_fields object

  *Full details on working with Custom Fields here.

• purchase_order_line_items_attributes object[]

  part_id int32

  Possible values: >= 1

  The Fleetio ID of the Part being purchased.

  quantity int32

  How many of this Part to be purchased.

  unit_cost number

  The cost of this Part (per unit).

Responses

• 204
• 401
• 403
• 404
• 422
• 500

---

OK

Request could not be authenticated

application/json

• Schema
• Example (from schema)

---

Schema

• status integer

  Possible values: >= 400 and <= 599

• title string

  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.

• detail string

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

• instance string

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

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

Insufficient permission to perform this operation

application/json

• Schema
• Example (from schema)

---

Schema

• status integer

  Possible values: >= 400 and <= 599

• title string

  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.

• detail string

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

• instance string

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

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

The requested resource could not be located

application/json

• Schema
• Example (from schema)

---

Schema

• status integer

  Possible values: >= 400 and <= 599

• title string

  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.

• detail string

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

• instance string

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

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

Unprocessable Entity

application/json

• Schema
• Example (from schema)
• Example

---

Schema

• errors object

  type

  items string

{
  "errors": {}
}

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

Something unexpected happened

application/json

• Schema
• Example (from schema)

---

Schema

• status integer

  Possible values: >= 400 and <= 599

• title string

  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.

• detail string

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

• instance string

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

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

Loading...