Skip to main content
PATCH
/
invoices
/
{id}
Update an Invoice by ID
curl --request PATCH \
  --url https://api.zivio.net/api/v3/invoices/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'zivio-tenant-id: <api-key>' \
  --data '
{
  "id": "1",
  "status": "draft",
  "job_id": "23",
  "job_summary": "Some text about the project",
  "net_total": "16000.00",
  "tax_total": "2000.00",
  "total": "18000.00",
  "ccy": "GBP",
  "due_on": "2023-11-07T05:31:56Z",
  "milestone_id": "435",
  "line_item_sheet_id": "234",
  "credit_note_id": "124",
  "is_credit_note": "null",
  "credit_note_reason": "invoice paid in error",
  "invoice_items": [
    {
      "id": "1",
      "invoice_id": "123",
      "milestone_id": "3654",
      "line_item_sheet_id": "3645",
      "purchase_order_line_id": "284",
      "description": "Some text about the item",
      "quantity": "10.0",
      "unit_type": "milestone",
      "billing_start": "YYYY-MM-DD",
      "billing_end": "YYYY-MM-DD",
      "ccy": "GBP",
      "unit_cost": "30000.00",
      "cis_type": "materials",
      "net_total_price": "30000.00",
      "tax_rate": "20.0",
      "tax_total": "6000.00",
      "total_price": "36000.00",
      "tax_type": {
        "id": "123",
        "label": "UK VAT",
        "tax_reference": "sales",
        "key": "cis_registered_contractors_deduction",
        "rate": "20.0",
        "country_code": "GB",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "archived": "false",
        "custom_fields": {
          "key": "value"
        }
      }
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "approved_at": "2023-11-07T05:31:56Z",
  "approved_by": {
    "id": "7158",
    "first_name": "Jack",
    "last_name": "Jones",
    "email": "[email protected]",
    "org_name": "Organisation Ltd",
    "org_id": "567",
    "business_unit": "Public Private Partnerships",
    "division": "Infastructure",
    "department": "Bridges",
    "vetting_status": "PASSED",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "custom_fields": {
      "key": "value"
    },
    "has_oversight": "<string>"
  },
  "client": {
    "id": "7158",
    "first_name": "Jack",
    "last_name": "Jones",
    "email": "[email protected]",
    "org_name": "Organisation Ltd",
    "org_id": "567",
    "business_unit": "Public Private Partnerships",
    "division": "Infastructure",
    "department": "Bridge Building",
    "vetting_status": "PASSED",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "custom_fields": {
      "key": "value"
    },
    "has_oversight": "<string>"
  },
  "client_org": {
    "id": "7158",
    "name": "Company Ltd",
    "is_external_client": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "supplier": {
    "id": "77",
    "name": "Company Inc",
    "email": "[email protected]",
    "vetting_status": "PASSED",
    "tax_number": "9876543234",
    "tax_registered": "true",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}
'
{
  "id": "1",
  "status": "draft",
  "job_id": "23",
  "job_summary": "Some text about the project",
  "net_total": "16000.00",
  "tax_total": "2000.00",
  "total": "18000.00",
  "ccy": "GBP",
  "due_on": "2023-11-07T05:31:56Z",
  "dated_on": "2023-11-07T05:31:56Z",
  "milestone_id": "435",
  "line_item_sheet_id": "234",
  "credit_note_id": "124",
  "is_credit_note": "null",
  "credit_note_reason": "invoice paid in error",
  "invoice_items": [
    {
      "id": "1",
      "invoice_id": "123",
      "milestone_id": "3654",
      "line_item_sheet_id": "3645",
      "purchase_order_line_id": "284",
      "description": "Some text about the item",
      "quantity": "10.0",
      "unit_type": "milestone",
      "billing_start": "YYYY-MM-DD",
      "billing_end": "YYYY-MM-DD",
      "ccy": "GBP",
      "unit_cost": "30000.00",
      "cis_type": "materials",
      "net_total_price": "30000.00",
      "tax_rate": "20.0",
      "tax_total": "6000.00",
      "total_price": "36000.00",
      "tax_type": {
        "id": "123",
        "label": "UK VAT",
        "tax_reference": "sales",
        "key": "cis_registered_contractors_deduction",
        "rate": "20.0",
        "country_code": "GB",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "archived": "false",
        "custom_fields": {
          "key": "value"
        }
      }
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "approved_at": "2023-11-07T05:31:56Z",
  "approved_by": {
    "id": "7158",
    "first_name": "Jack",
    "last_name": "Jones",
    "email": "[email protected]",
    "org_name": "Organisation Ltd",
    "org_id": "567",
    "business_unit": "Public Private Partnerships",
    "division": "Infastructure",
    "department": "Bridges",
    "vetting_status": "PASSED",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "custom_fields": {
      "key": "value"
    },
    "has_oversight": "<string>"
  },
  "client": {
    "id": "7158",
    "first_name": "Jack",
    "last_name": "Jones",
    "email": "[email protected]",
    "org_name": "Organisation Ltd",
    "org_id": "567",
    "business_unit": "Public Private Partnerships",
    "division": "Infastructure",
    "department": "Bridge Building",
    "vetting_status": "PASSED",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "custom_fields": {
      "key": "value"
    },
    "has_oversight": "<string>"
  },
  "client_org": {
    "id": "7158",
    "name": "Company Ltd",
    "is_external_client": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "supplier": {
    "id": "77",
    "name": "Company Inc",
    "email": "[email protected]",
    "vetting_status": "PASSED",
    "tax_number": "9876543234",
    "tax_registered": "true",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
X-API-Key
string
header
required
​
zivio-tenant-id
string
header
required

Path Parameters

​
id
number
required

Body

application/json
​
id
integer
Example:

"1"

​
status
string
Example:

"draft"

​
job_id
integer
Example:

"23"

​
job_summary
string
Example:

"Some text about the project"

​
net_total
string
Example:

"16000.00"

​
tax_total
string
Example:

"2000.00"

​
total
string
Example:

"18000.00"

​
ccy
string
Example:

"GBP"

​
due_on
string<date-time>
​
milestone_id
integer
Example:

"435"

​
line_item_sheet_id
integer
Example:

"234"

​
credit_note_id
integer
Example:

"124"

​
is_credit_note
boolean
Example:

null

​
credit_note_reason
string
Example:

"invoice paid in error"

​
invoice_items
object[]
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
approved_at
string<date-time>
​
approved_by
object
​
client
object
​
client_org
object
​
supplier
object

Response

ok

​
id
integer
Example:

"1"

​
status
string
Example:

"draft"

​
job_id
integer
Example:

"23"

​
job_summary
string
Example:

"Some text about the project"

​
net_total
string
Example:

"16000.00"

​
tax_total
string
Example:

"2000.00"

​
total
string
Example:

"18000.00"

​
ccy
string
Example:

"GBP"

​
due_on
string<date-time>
​
dated_on
string<date-time>
​
milestone_id
integer
Example:

"435"

​
line_item_sheet_id
integer
Example:

"234"

​
credit_note_id
integer
Example:

"124"

​
is_credit_note
boolean
Example:

null

​
credit_note_reason
string
Example:

"invoice paid in error"

​
invoice_items
object[]
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
approved_at
string<date-time>
​
approved_by
object
​
client
object
​
client_org
object
​
supplier
object