Purchase Invoices

Create a purchase invoice.

Create a purchase invoice.

post/purchase-invoices

Request

  • Base URL: https://api.floorworks.co.uk/api/v1
  • URL: https://api.floorworks.co.uk/api/v1/purchase-invoices
  • Auth: OAuth 2 (password, token URL https://api.floorworks.co.uk/api/v1/auth)

Request body

contact_idstring uuid

ID of the contact that is associated with this document.

manager_contact_idstring uuid

Manager Id.

property_idstring uuid

Property Id.

department_idnumber

Department Id.

type'INVOICE' | 'CREDIT_NOTE' | 'INVOICE_CIS'

Purchase invoice type.

status'DRAFT' | 'INVOICED' | 'VOID' | 'PAID' | 'PAID_PARTIALLY'

Purchase invoice status.

time_sentstring YYYY-MM-DD

When was document first sent.

time_receivedstring YYYY-MM-DD

When was document first received by user.

time_invoicedstring YYYY-MM-DD

Date of invoice

time_dueinteger

Due date.

time_paidstring YYYY-MM-DD

Invoice payment date. Fills when invoice is fully paid.

total_discountnumber double

Total Discount

total_paymentsnumber double

Total Paid

total_balancenumber double

Total Balance

total_pricenumber double

Total price ex. VAT

total_price_vatnumber double

Total price inc. VAT

total_vatnumber double

Total vat

referencestring

Auto generated reference of the document.

reference_externalstring

Vendor invoice ID for external reference. Use this field to filter and retrieve all the orders that have this ID. Used for filtering.

supplier_acc_nostring nullable

Supplier account number.

Example request

{
  "time_sent": "2019-05-17",
  "time_received": "2019-05-17",
  "time_invoiced": "2025-08-17",
  "time_due": 1755388800,
  "time_paid": "2025-08-17"
}

Response

Created

contact_idstring uuid

ID of the contact that is associated with this document.

manager_contact_idstring uuid

Manager Id.

property_idstring uuid

Property Id.

department_idnumber

Department Id.

type'INVOICE' | 'CREDIT_NOTE' | 'INVOICE_CIS'

Purchase invoice type.

status'DRAFT' | 'INVOICED' | 'VOID' | 'PAID' | 'PAID_PARTIALLY'

Purchase invoice status.

time_sentstring YYYY-MM-DD

When was document first sent.

time_receivedstring YYYY-MM-DD

When was document first received by user.

time_invoicedstring YYYY-MM-DD

Date of invoice

time_dueinteger

Due date.

time_paidstring YYYY-MM-DD

Invoice payment date. Fills when invoice is fully paid.

total_discountnumber double

Total Discount

total_paymentsnumber double

Total Paid

total_balancenumber double

Total Balance

total_pricenumber double

Total price ex. VAT

total_price_vatnumber double

Total price inc. VAT

total_vatnumber double

Total vat

referencestring

Auto generated reference of the document.

reference_externalstring

Vendor invoice ID for external reference. Use this field to filter and retrieve all the orders that have this ID. Used for filtering.

supplier_acc_nostring nullable

Supplier account number.

idnumber

ID.

uuidstring uuid

UUID.

time_createdstring YYYY-MM-DD

Creation date

time_modifiedstring YYYY-MM-DD

Last modification date

status_approval'PENDING' | 'APPROVED' | 'REJECTED'

Purchase invoice approval status.

Example response

{
  "time_sent": "2019-05-17",
  "time_received": "2019-05-17",
  "time_invoiced": "2025-08-17",
  "time_due": 1755388800,
  "time_paid": "2025-08-17",
  "id": 12345,
  "time_created": "2025-08-17",
  "time_modified": "2025-08-18"
}

Changes

No recorded changes to this operation across all 1 revision of this API.