Crunch Expenses API Documentation

expenses-api-service

Overview

Version information

Version : 1

Tags

  • Attachments
  • ExpenseTypeController
  • ExpensesController
  • LedgerController
  • PaymentMethodController
  • PersonsController
  • RecurringExpensesController
  • SupplierController
  • VatTypeController

Access

  • Base URL: https://public-api.crunch.co.uk/v1/expenses

Paths

Download expense attachment

Up 
get /attachments

Query parameters

expenseId (required)
Query Parameter — format: int64
attachmentId (required)
Query Parameter — format: int64
fileName (required)
Query Parameter —

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

byte[]

Example data

Content-Type: application/json
""

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

returns the raw content of an attachment attached to an expense byte[]

Fetch all expense types

Up 
get /expense-types/all

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

ExpenseTypesDto

Example data

Content-Type: application/json
{
  "count" : 6,
  "expenseGroups" : [ {
    "groupName" : "groupName",
    "count" : 0,
    "expenseTypes" : [ {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    }, {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    } ]
  }, {
    "groupName" : "groupName",
    "count" : 0,
    "expenseTypes" : [ {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    }, {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    } ]
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Fetch all expense types ExpenseTypesDto

Fetch expense types

Up 
get /expense-types

Query parameters

excludeDeprecated (optional)
Query Parameter —
date (optional)
Query Parameter — format: date

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

ExpenseTypesDto

Example data

Content-Type: application/json
{
  "count" : 6,
  "expenseGroups" : [ {
    "groupName" : "groupName",
    "count" : 0,
    "expenseTypes" : [ {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    }, {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    } ]
  }, {
    "groupName" : "groupName",
    "count" : 0,
    "expenseTypes" : [ {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    }, {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    } ]
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Fetch expense types ExpenseTypesDto

Create new expense

Up 
post /

Consumes

This API call consumes the following media types via the Content-Type request header:
  • application/json

Request body

body ExpenseDto (optional)
Body Parameter —

Security

oauth2-authorisation-code
Type: oauth2 Scopes: create:all

Return type

ExpenseDto

Example data

Content-Type: application/json
{
  "supplierReference" : "supplierReference",
  "recharged" : true,
  "note" : "note",
  "reconciled" : true,
  "attachments" : [ {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  }, {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  } ],
  "supplierPayments" : [ {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  }, {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  } ],
  "editable" : true,
  "rechargedClient" : {
    "name" : "name",
    "id" : 9
  },
  "deletable" : true,
  "totalCreditsAmount" : 9.369310271410669,
  "postingDate" : "2000-01-23",
  "expenseLineItems" : [ {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  }, {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  } ],
  "creditNotes" : [ {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  }, {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  } ],
  "createdBy" : "createdBy",
  "recurringEvent" : {
    "frequencyOccurrence" : "frequencyOccurrence",
    "nextOccurrenceDate" : "2000-01-23",
    "endDate" : "2000-01-23",
    "occurrenceCount" : 3,
    "description" : "description",
    "id" : 6,
    "recurringEventFrequency" : "recurringEventFrequency",
    "recurringEventEndType" : "recurringEventEndType",
    "enabled" : true
  },
  "supplier" : {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  },
  "expenseLedgerIsOpen" : true,
  "totalRefundsAmount" : 6.683562403749608,
  "createdByRecurringEvent" : true,
  "id" : 9,
  "status" : "status",
  "outstandingBalance" : 8.762042012749001
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

201

new expense is created and put to the body of the response ExpenseDto

Delete an expense

Up 
delete /{expenseId}

Path parameters

expenseId (required)
Path Parameter — format: int64

Security

oauth2-authorisation-code
Type: oauth2 Scopes: delete:all

Responses

200

Expense is successfully deleted

400

Expense cannot be deleted

Fetch all expenses

Up 
get /
The default sorting criteria is date,desc,id,desc.

Query parameters

page (optional)
Query Parameter — The index of the page to retrieve, based at 0. format: int32
size (optional)
Query Parameter — Number of records returned per page. Maximum value allowed is 200. default: 20 format: int32
sort (optional)
Query Parameter — Sorting criteria by a given <code>field</code>. format: <field>[,asc|desc]
supplierId (optional)
Query Parameter — format: int64
expenseType (optional)
Query Parameter —
attachment (optional)
Query Parameter —
paymentMethod (optional)
Query Parameter —
startDate (optional)
Query Parameter — format: date
endDate (optional)
Query Parameter — format: date
paymentStartDate (optional)
Query Parameter — format: date
paymentEndDate (optional)
Query Parameter — format: date

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

PageExpenseDto

Example data

Content-Type: application/json
{
  "number" : 6,
  "numberOfElements" : 1,
  "last" : true,
  "size" : 7,
  "totalPages" : 0,
  "pageable" : {
    "paged" : true,
    "pageNumber" : 5,
    "offset" : 2,
    "pageSize" : 5,
    "unpaged" : true,
    "sort" : {
      "unsorted" : true,
      "sorted" : true,
      "empty" : true
    }
  },
  "first" : true,
  "content" : [ {
    "supplierReference" : "supplierReference",
    "recharged" : true,
    "note" : "note",
    "reconciled" : true,
    "attachments" : [ {
      "fileName" : "fileName",
      "id" : 3,
      "fileContents" : "fileContents"
    }, {
      "fileName" : "fileName",
      "id" : 3,
      "fileContents" : "fileContents"
    } ],
    "supplierPayments" : [ {
      "date" : "2000-01-23",
      "paymentTarget" : {
        "bankAccount" : {
          "defaultBankAccount" : true,
          "bankName" : "bankName",
          "displayableName" : "displayableName",
          "id" : 7
        },
        "paymentMethod" : {
          "paymentMethodName" : "paymentMethodName",
          "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
        },
        "creditCard" : {
          "defaultCreditCard" : true,
          "displayableName" : "displayableName",
          "id" : 1
        }
      },
      "amount" : 6.84685269835264,
      "reconciled" : true,
      "id" : 1
    }, {
      "date" : "2000-01-23",
      "paymentTarget" : {
        "bankAccount" : {
          "defaultBankAccount" : true,
          "bankName" : "bankName",
          "displayableName" : "displayableName",
          "id" : 7
        },
        "paymentMethod" : {
          "paymentMethodName" : "paymentMethodName",
          "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
        },
        "creditCard" : {
          "defaultCreditCard" : true,
          "displayableName" : "displayableName",
          "id" : 1
        }
      },
      "amount" : 6.84685269835264,
      "reconciled" : true,
      "id" : 1
    } ],
    "editable" : true,
    "rechargedClient" : {
      "name" : "name",
      "id" : 9
    },
    "deletable" : true,
    "totalCreditsAmount" : 9.369310271410669,
    "postingDate" : "2000-01-23",
    "expenseLineItems" : [ {
      "expenseType" : "expenseType",
      "amount" : {
        "netAmount" : 7.386281948385884,
        "grossAmount" : 4.145608029883936,
        "vatAmount" : 1.2315135367772556
      },
      "vatType" : "vatType",
      "description" : "description",
      "id" : 2,
      "employee" : {
        "forename" : "forename",
        "surname" : "surname",
        "displayableName" : "displayableName",
        "id" : 1
      }
    }, {
      "expenseType" : "expenseType",
      "amount" : {
        "netAmount" : 7.386281948385884,
        "grossAmount" : 4.145608029883936,
        "vatAmount" : 1.2315135367772556
      },
      "vatType" : "vatType",
      "description" : "description",
      "id" : 2,
      "employee" : {
        "forename" : "forename",
        "surname" : "surname",
        "displayableName" : "displayableName",
        "id" : 1
      }
    } ],
    "creditNotes" : [ {
      "date" : "2000-01-23",
      "lineItems" : [ {
        "description" : "description",
        "id" : 5,
        "expenseLineItemIndex" : 9
      }, {
        "description" : "description",
        "id" : 5,
        "expenseLineItemIndex" : 9
      } ],
      "id" : 4,
      "refunds" : [ null, null ]
    }, {
      "date" : "2000-01-23",
      "lineItems" : [ {
        "description" : "description",
        "id" : 5,
        "expenseLineItemIndex" : 9
      }, {
        "description" : "description",
        "id" : 5,
        "expenseLineItemIndex" : 9
      } ],
      "id" : 4,
      "refunds" : [ null, null ]
    } ],
    "createdBy" : "createdBy",
    "recurringEvent" : {
      "frequencyOccurrence" : "frequencyOccurrence",
      "nextOccurrenceDate" : "2000-01-23",
      "endDate" : "2000-01-23",
      "occurrenceCount" : 3,
      "description" : "description",
      "id" : 6,
      "recurringEventFrequency" : "recurringEventFrequency",
      "recurringEventEndType" : "recurringEventEndType",
      "enabled" : true
    },
    "supplier" : {
      "archived" : true,
      "country" : "country",
      "expenseType" : {
        "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
        "defaultVatType" : "defaultVatType",
        "expenseTypeName" : "expenseTypeName",
        "deprecated" : true,
        "dormantAllowable" : true,
        "assignable" : true
      },
      "vatRegistrationNumber" : "vatRegistrationNumber",
      "contactName" : "contactName",
      "companyName" : "companyName",
      "deletable" : true,
      "id" : 3
    },
    "expenseLedgerIsOpen" : true,
    "totalRefundsAmount" : 6.683562403749608,
    "createdByRecurringEvent" : true,
    "id" : 9,
    "status" : "status",
    "outstandingBalance" : 8.762042012749001
  }, {
    "supplierReference" : "supplierReference",
    "recharged" : true,
    "note" : "note",
    "reconciled" : true,
    "attachments" : [ {
      "fileName" : "fileName",
      "id" : 3,
      "fileContents" : "fileContents"
    }, {
      "fileName" : "fileName",
      "id" : 3,
      "fileContents" : "fileContents"
    } ],
    "supplierPayments" : [ {
      "date" : "2000-01-23",
      "paymentTarget" : {
        "bankAccount" : {
          "defaultBankAccount" : true,
          "bankName" : "bankName",
          "displayableName" : "displayableName",
          "id" : 7
        },
        "paymentMethod" : {
          "paymentMethodName" : "paymentMethodName",
          "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
        },
        "creditCard" : {
          "defaultCreditCard" : true,
          "displayableName" : "displayableName",
          "id" : 1
        }
      },
      "amount" : 6.84685269835264,
      "reconciled" : true,
      "id" : 1
    }, {
      "date" : "2000-01-23",
      "paymentTarget" : {
        "bankAccount" : {
          "defaultBankAccount" : true,
          "bankName" : "bankName",
          "displayableName" : "displayableName",
          "id" : 7
        },
        "paymentMethod" : {
          "paymentMethodName" : "paymentMethodName",
          "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
        },
        "creditCard" : {
          "defaultCreditCard" : true,
          "displayableName" : "displayableName",
          "id" : 1
        }
      },
      "amount" : 6.84685269835264,
      "reconciled" : true,
      "id" : 1
    } ],
    "editable" : true,
    "rechargedClient" : {
      "name" : "name",
      "id" : 9
    },
    "deletable" : true,
    "totalCreditsAmount" : 9.369310271410669,
    "postingDate" : "2000-01-23",
    "expenseLineItems" : [ {
      "expenseType" : "expenseType",
      "amount" : {
        "netAmount" : 7.386281948385884,
        "grossAmount" : 4.145608029883936,
        "vatAmount" : 1.2315135367772556
      },
      "vatType" : "vatType",
      "description" : "description",
      "id" : 2,
      "employee" : {
        "forename" : "forename",
        "surname" : "surname",
        "displayableName" : "displayableName",
        "id" : 1
      }
    }, {
      "expenseType" : "expenseType",
      "amount" : {
        "netAmount" : 7.386281948385884,
        "grossAmount" : 4.145608029883936,
        "vatAmount" : 1.2315135367772556
      },
      "vatType" : "vatType",
      "description" : "description",
      "id" : 2,
      "employee" : {
        "forename" : "forename",
        "surname" : "surname",
        "displayableName" : "displayableName",
        "id" : 1
      }
    } ],
    "creditNotes" : [ {
      "date" : "2000-01-23",
      "lineItems" : [ {
        "description" : "description",
        "id" : 5,
        "expenseLineItemIndex" : 9
      }, {
        "description" : "description",
        "id" : 5,
        "expenseLineItemIndex" : 9
      } ],
      "id" : 4,
      "refunds" : [ null, null ]
    }, {
      "date" : "2000-01-23",
      "lineItems" : [ {
        "description" : "description",
        "id" : 5,
        "expenseLineItemIndex" : 9
      }, {
        "description" : "description",
        "id" : 5,
        "expenseLineItemIndex" : 9
      } ],
      "id" : 4,
      "refunds" : [ null, null ]
    } ],
    "createdBy" : "createdBy",
    "recurringEvent" : {
      "frequencyOccurrence" : "frequencyOccurrence",
      "nextOccurrenceDate" : "2000-01-23",
      "endDate" : "2000-01-23",
      "occurrenceCount" : 3,
      "description" : "description",
      "id" : 6,
      "recurringEventFrequency" : "recurringEventFrequency",
      "recurringEventEndType" : "recurringEventEndType",
      "enabled" : true
    },
    "supplier" : {
      "archived" : true,
      "country" : "country",
      "expenseType" : {
        "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
        "defaultVatType" : "defaultVatType",
        "expenseTypeName" : "expenseTypeName",
        "deprecated" : true,
        "dormantAllowable" : true,
        "assignable" : true
      },
      "vatRegistrationNumber" : "vatRegistrationNumber",
      "contactName" : "contactName",
      "companyName" : "companyName",
      "deletable" : true,
      "id" : 3
    },
    "expenseLedgerIsOpen" : true,
    "totalRefundsAmount" : 6.683562403749608,
    "createdByRecurringEvent" : true,
    "id" : 9,
    "status" : "status",
    "outstandingBalance" : 8.762042012749001
  } ],
  "totalElements" : 6,
  "empty" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

expenses are gathered and put to the body of the response PageExpenseDto

Get expense by id

Up 
get /{expenseId}

Path parameters

expenseId (required)
Path Parameter — format: int64

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

ExpenseDto

Example data

Content-Type: application/json
{
  "supplierReference" : "supplierReference",
  "recharged" : true,
  "note" : "note",
  "reconciled" : true,
  "attachments" : [ {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  }, {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  } ],
  "supplierPayments" : [ {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  }, {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  } ],
  "editable" : true,
  "rechargedClient" : {
    "name" : "name",
    "id" : 9
  },
  "deletable" : true,
  "totalCreditsAmount" : 9.369310271410669,
  "postingDate" : "2000-01-23",
  "expenseLineItems" : [ {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  }, {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  } ],
  "creditNotes" : [ {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  }, {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  } ],
  "createdBy" : "createdBy",
  "recurringEvent" : {
    "frequencyOccurrence" : "frequencyOccurrence",
    "nextOccurrenceDate" : "2000-01-23",
    "endDate" : "2000-01-23",
    "occurrenceCount" : 3,
    "description" : "description",
    "id" : 6,
    "recurringEventFrequency" : "recurringEventFrequency",
    "recurringEventEndType" : "recurringEventEndType",
    "enabled" : true
  },
  "supplier" : {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  },
  "expenseLedgerIsOpen" : true,
  "totalRefundsAmount" : 6.683562403749608,
  "createdByRecurringEvent" : true,
  "id" : 9,
  "status" : "status",
  "outstandingBalance" : 8.762042012749001
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Expense is successfully fetched ExpenseDto

404

Expense not found and cannot be received

400

Expense cannot be received

Get expenses total

Up 
get /total

Query parameters

supplierId (optional)
Query Parameter — format: int64
expenseType (optional)
Query Parameter —
attachment (optional)
Query Parameter —
paymentMethod (optional)
Query Parameter —
startDate (optional)
Query Parameter — format: date
endDate (optional)
Query Parameter — format: date
status (required)
Query Parameter —
paymentStartDate (optional)
Query Parameter — format: date
paymentEndDate (optional)
Query Parameter — format: date

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

ExpensesTotalDto

Example data

Content-Type: application/json
{
  "overpaid" : 1.4658129805029452,
  "grossAmount" : 0.8008281904610115,
  "underpaid" : 6.027456183070403
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Expenses total is calculated ExpensesTotalDto

Update an existing expense

Up 
put /{expenseId}

Path parameters

expenseId (required)
Path Parameter — format: int64

Consumes

This API call consumes the following media types via the Content-Type request header:
  • application/json

Request body

body ExpenseDto (optional)
Body Parameter —

Security

oauth2-authorisation-code
Type: oauth2 Scopes: update:all

Return type

ExpenseDto

Example data

Content-Type: application/json
{
  "supplierReference" : "supplierReference",
  "recharged" : true,
  "note" : "note",
  "reconciled" : true,
  "attachments" : [ {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  }, {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  } ],
  "supplierPayments" : [ {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  }, {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  } ],
  "editable" : true,
  "rechargedClient" : {
    "name" : "name",
    "id" : 9
  },
  "deletable" : true,
  "totalCreditsAmount" : 9.369310271410669,
  "postingDate" : "2000-01-23",
  "expenseLineItems" : [ {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  }, {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  } ],
  "creditNotes" : [ {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  }, {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  } ],
  "createdBy" : "createdBy",
  "recurringEvent" : {
    "frequencyOccurrence" : "frequencyOccurrence",
    "nextOccurrenceDate" : "2000-01-23",
    "endDate" : "2000-01-23",
    "occurrenceCount" : 3,
    "description" : "description",
    "id" : 6,
    "recurringEventFrequency" : "recurringEventFrequency",
    "recurringEventEndType" : "recurringEventEndType",
    "enabled" : true
  },
  "supplier" : {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  },
  "expenseLedgerIsOpen" : true,
  "totalRefundsAmount" : 6.683562403749608,
  "createdByRecurringEvent" : true,
  "id" : 9,
  "status" : "status",
  "outstandingBalance" : 8.762042012749001
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Expense is successfully updated ExpenseDto

404

Expense not found and cannot be updated

Fetch open accounting periods

Up 
get /ledgers

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

array[AccountingPeriodDto]

Example data

Content-Type: application/json
[ {
  "endDate" : "2000-01-23",
  "startDate" : "2000-01-23",
  "status" : "status"
}, {
  "endDate" : "2000-01-23",
  "startDate" : "2000-01-23",
  "status" : "status"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

opened accounting periods are gathered and put to the body of the response

Fetch all payment methods

Up 
get /payment-methods

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

PaymentMethodsDto

Example data

Content-Type: application/json
{
  "paymentMethods" : [ {
    "paymentMethodName" : "paymentMethodName",
    "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
  }, {
    "paymentMethodName" : "paymentMethodName",
    "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Fetch all payment methods PaymentMethodsDto

Fetch persons related to current client id

Up 
get /persons

Query parameters

date (required)
Query Parameter — format: date
role (optional)
Query Parameter —

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

array[PersonDto]

Example data

Content-Type: application/json
[ {
  "forename" : "forename",
  "surname" : "surname",
  "displayableName" : "displayableName",
  "id" : 1
}, {
  "forename" : "forename",
  "surname" : "surname",
  "displayableName" : "displayableName",
  "id" : 1
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

persons related to current client id

Delete recurring expense

Up 
delete /recurring-expenses/{id}

Path parameters

id (required)
Path Parameter — format: int64

Security

oauth2-authorisation-code
Type: oauth2 Scopes: update:all

Return type

Long

Example data

Content-Type: application/json
0

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Recurring expense is successfully deleted Long

404

Recurring expense cannot be allocated

400

Recurring expense cannot be deleted

Get recurring expense

Up 
get /recurring-expenses/{id}

Path parameters

id (required)
Path Parameter — format: int64

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

ExpenseDto

Example data

Content-Type: application/json
{
  "supplierReference" : "supplierReference",
  "recharged" : true,
  "note" : "note",
  "reconciled" : true,
  "attachments" : [ {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  }, {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  } ],
  "supplierPayments" : [ {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  }, {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  } ],
  "editable" : true,
  "rechargedClient" : {
    "name" : "name",
    "id" : 9
  },
  "deletable" : true,
  "totalCreditsAmount" : 9.369310271410669,
  "postingDate" : "2000-01-23",
  "expenseLineItems" : [ {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  }, {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  } ],
  "creditNotes" : [ {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  }, {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  } ],
  "createdBy" : "createdBy",
  "recurringEvent" : {
    "frequencyOccurrence" : "frequencyOccurrence",
    "nextOccurrenceDate" : "2000-01-23",
    "endDate" : "2000-01-23",
    "occurrenceCount" : 3,
    "description" : "description",
    "id" : 6,
    "recurringEventFrequency" : "recurringEventFrequency",
    "recurringEventEndType" : "recurringEventEndType",
    "enabled" : true
  },
  "supplier" : {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  },
  "expenseLedgerIsOpen" : true,
  "totalRefundsAmount" : 6.683562403749608,
  "createdByRecurringEvent" : true,
  "id" : 9,
  "status" : "status",
  "outstandingBalance" : 8.762042012749001
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Recurring expense is successfully returned ExpenseDto

404

Recurring expense is not found for customer

Get recurring expenses for client

Up 
get /recurring-expenses
The default sorting criteria is date,desc,companyName,asc.

Query parameters

page (optional)
Query Parameter — The index of the page to retrieve, based at 0. format: int32
size (optional)
Query Parameter — Number of records returned per page. Maximum value allowed is 200. default: 20 format: int32
sort (optional)
Query Parameter — Sorting criteria by a given <code>field</code>. format: <field>[,asc|desc]

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

PageRecurringExpenseDto

Example data

Content-Type: application/json
{
  "number" : 7,
  "numberOfElements" : 1,
  "last" : true,
  "size" : 5,
  "totalPages" : 0,
  "pageable" : {
    "paged" : true,
    "pageNumber" : 5,
    "offset" : 2,
    "pageSize" : 5,
    "unpaged" : true,
    "sort" : {
      "unsorted" : true,
      "sorted" : true,
      "empty" : true
    }
  },
  "sort" : {
    "unsorted" : true,
    "sorted" : true,
    "empty" : true
  },
  "first" : true,
  "content" : [ {
    "supplierName" : "supplierName",
    "totalAmount" : 2.3021358869347655,
    "nextOccurrenceDate" : "2000-01-23",
    "description" : "description",
    "id" : 5,
    "status" : "status"
  }, {
    "supplierName" : "supplierName",
    "totalAmount" : 2.3021358869347655,
    "nextOccurrenceDate" : "2000-01-23",
    "description" : "description",
    "id" : 5,
    "status" : "status"
  } ],
  "totalElements" : 6,
  "empty" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Recurring expenses successfully returned. PageRecurringExpenseDto

New recurring expense

Up 
post /recurring-expenses

Consumes

This API call consumes the following media types via the Content-Type request header:
  • application/json

Request body

body ExpenseDto (optional)
Body Parameter —

Security

oauth2-authorisation-code
Type: oauth2 Scopes: create:all

Return type

ExpenseDto

Example data

Content-Type: application/json
{
  "supplierReference" : "supplierReference",
  "recharged" : true,
  "note" : "note",
  "reconciled" : true,
  "attachments" : [ {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  }, {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  } ],
  "supplierPayments" : [ {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  }, {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  } ],
  "editable" : true,
  "rechargedClient" : {
    "name" : "name",
    "id" : 9
  },
  "deletable" : true,
  "totalCreditsAmount" : 9.369310271410669,
  "postingDate" : "2000-01-23",
  "expenseLineItems" : [ {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  }, {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  } ],
  "creditNotes" : [ {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  }, {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  } ],
  "createdBy" : "createdBy",
  "recurringEvent" : {
    "frequencyOccurrence" : "frequencyOccurrence",
    "nextOccurrenceDate" : "2000-01-23",
    "endDate" : "2000-01-23",
    "occurrenceCount" : 3,
    "description" : "description",
    "id" : 6,
    "recurringEventFrequency" : "recurringEventFrequency",
    "recurringEventEndType" : "recurringEventEndType",
    "enabled" : true
  },
  "supplier" : {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  },
  "expenseLedgerIsOpen" : true,
  "totalRefundsAmount" : 6.683562403749608,
  "createdByRecurringEvent" : true,
  "id" : 9,
  "status" : "status",
  "outstandingBalance" : 8.762042012749001
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

success ExpenseDto

Update recurring expense

Up 
put /recurring-expenses/{id}

Path parameters

id (required)
Path Parameter — format: int64

Consumes

This API call consumes the following media types via the Content-Type request header:
  • application/json

Request body

body ExpenseDto (optional)
Body Parameter —

Security

oauth2-authorisation-code
Type: oauth2 Scopes: update:all

Return type

ExpenseDto

Example data

Content-Type: application/json
{
  "supplierReference" : "supplierReference",
  "recharged" : true,
  "note" : "note",
  "reconciled" : true,
  "attachments" : [ {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  }, {
    "fileName" : "fileName",
    "id" : 3,
    "fileContents" : "fileContents"
  } ],
  "supplierPayments" : [ {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  }, {
    "date" : "2000-01-23",
    "paymentTarget" : {
      "bankAccount" : {
        "defaultBankAccount" : true,
        "bankName" : "bankName",
        "displayableName" : "displayableName",
        "id" : 7
      },
      "paymentMethod" : {
        "paymentMethodName" : "paymentMethodName",
        "paymentMethodDisplayableName" : "paymentMethodDisplayableName"
      },
      "creditCard" : {
        "defaultCreditCard" : true,
        "displayableName" : "displayableName",
        "id" : 1
      }
    },
    "amount" : 6.84685269835264,
    "reconciled" : true,
    "id" : 1
  } ],
  "editable" : true,
  "rechargedClient" : {
    "name" : "name",
    "id" : 9
  },
  "deletable" : true,
  "totalCreditsAmount" : 9.369310271410669,
  "postingDate" : "2000-01-23",
  "expenseLineItems" : [ {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  }, {
    "expenseType" : "expenseType",
    "amount" : {
      "netAmount" : 7.386281948385884,
      "grossAmount" : 4.145608029883936,
      "vatAmount" : 1.2315135367772556
    },
    "vatType" : "vatType",
    "description" : "description",
    "id" : 2,
    "employee" : {
      "forename" : "forename",
      "surname" : "surname",
      "displayableName" : "displayableName",
      "id" : 1
    }
  } ],
  "creditNotes" : [ {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  }, {
    "date" : "2000-01-23",
    "lineItems" : [ {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    }, {
      "description" : "description",
      "id" : 5,
      "expenseLineItemIndex" : 9
    } ],
    "id" : 4,
    "refunds" : [ null, null ]
  } ],
  "createdBy" : "createdBy",
  "recurringEvent" : {
    "frequencyOccurrence" : "frequencyOccurrence",
    "nextOccurrenceDate" : "2000-01-23",
    "endDate" : "2000-01-23",
    "occurrenceCount" : 3,
    "description" : "description",
    "id" : 6,
    "recurringEventFrequency" : "recurringEventFrequency",
    "recurringEventEndType" : "recurringEventEndType",
    "enabled" : true
  },
  "supplier" : {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  },
  "expenseLedgerIsOpen" : true,
  "totalRefundsAmount" : 6.683562403749608,
  "createdByRecurringEvent" : true,
  "id" : 9,
  "status" : "status",
  "outstandingBalance" : 8.762042012749001
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Recurring expense is successfully updated ExpenseDto

404

Recurring expense is not found for customer

Create new supplier

Up 
post /suppliers

Consumes

This API call consumes the following media types via the Content-Type request header:
  • application/json

Request body

body SupplierDto (optional)
Body Parameter —

Security

oauth2-authorisation-code
Type: oauth2 Scopes: create:all

Return type

SupplierDto

Example data

Content-Type: application/json
{
  "archived" : true,
  "country" : "country",
  "expenseType" : {
    "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
    "defaultVatType" : "defaultVatType",
    "expenseTypeName" : "expenseTypeName",
    "deprecated" : true,
    "dormantAllowable" : true,
    "assignable" : true
  },
  "vatRegistrationNumber" : "vatRegistrationNumber",
  "contactName" : "contactName",
  "companyName" : "companyName",
  "deletable" : true,
  "id" : 3
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

201

new supplier is created and put to the body of the response SupplierDto

Delete supplier by its ID

Up 
delete /suppliers/{supplierId}

Path parameters

supplierId (required)
Path Parameter — format: int64

Security

oauth2-authorisation-code
Type: oauth2 Scopes: delete:all

Return type

SupplierDto

Example data

Content-Type: application/json
{
  "archived" : true,
  "country" : "country",
  "expenseType" : {
    "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
    "defaultVatType" : "defaultVatType",
    "expenseTypeName" : "expenseTypeName",
    "deprecated" : true,
    "dormantAllowable" : true,
    "assignable" : true
  },
  "vatRegistrationNumber" : "vatRegistrationNumber",
  "contactName" : "contactName",
  "companyName" : "companyName",
  "deletable" : true,
  "id" : 3
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Supplier is successfully deleted SupplierDto

Get list of suppliers.

Up 
get /suppliers/all

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

SuppliersDto

Example data

Content-Type: application/json
{
  "count" : 0,
  "content" : [ {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  }, {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

full list of suppliers SuppliersDto

Get supplier by id

Up 
get /suppliers/{supplierId}

Path parameters

supplierId (required)
Path Parameter — format: int64

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

SupplierDto

Example data

Content-Type: application/json
{
  "archived" : true,
  "country" : "country",
  "expenseType" : {
    "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
    "defaultVatType" : "defaultVatType",
    "expenseTypeName" : "expenseTypeName",
    "deprecated" : true,
    "dormantAllowable" : true,
    "assignable" : true
  },
  "vatRegistrationNumber" : "vatRegistrationNumber",
  "contactName" : "contactName",
  "companyName" : "companyName",
  "deletable" : true,
  "id" : 3
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

The supplier is successfully fetched SupplierDto

404

The supplier not found and cannot be received

400

Supplier cannot be received

Get list of suppliers.

Up 
get /suppliers
The default sorting criterion is companyName,asc.

Query parameters

page (optional)
Query Parameter — The index of the page to retrieve, based at 0. format: int32
size (optional)
Query Parameter — Number of records returned per page. Maximum value allowed is 200. default: 20 format: int32
sort (optional)
Query Parameter — Sorting criteria by a given <code>field</code>. format: <field>[,asc|desc]
supplierName (optional)
Query Parameter — If provided, only the supplier with the given company name is returned

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

PageSupplierDto

Example data

Content-Type: application/json
{
  "number" : 5,
  "numberOfElements" : 1,
  "last" : true,
  "size" : 5,
  "totalPages" : 0,
  "pageable" : {
    "paged" : true,
    "pageNumber" : 5,
    "offset" : 2,
    "pageSize" : 5,
    "unpaged" : true,
    "sort" : {
      "unsorted" : true,
      "sorted" : true,
      "empty" : true
    }
  },
  "sort" : {
    "unsorted" : true,
    "sorted" : true,
    "empty" : true
  },
  "first" : true,
  "content" : [ {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  }, {
    "archived" : true,
    "country" : "country",
    "expenseType" : {
      "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
      "defaultVatType" : "defaultVatType",
      "expenseTypeName" : "expenseTypeName",
      "deprecated" : true,
      "dormantAllowable" : true,
      "assignable" : true
    },
    "vatRegistrationNumber" : "vatRegistrationNumber",
    "contactName" : "contactName",
    "companyName" : "companyName",
    "deletable" : true,
    "id" : 3
  } ],
  "totalElements" : 6,
  "empty" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

a pageable list of suppliers PageSupplierDto

Update an existing supplier

Up 
put /suppliers/{supplierId}

Path parameters

supplierId (required)
Path Parameter — format: int64

Consumes

This API call consumes the following media types via the Content-Type request header:
  • application/json

Request body

body SupplierDto (optional)
Body Parameter —

Security

oauth2-authorisation-code
Type: oauth2 Scopes: update:all

Return type

SupplierDto

Example data

Content-Type: application/json
{
  "archived" : true,
  "country" : "country",
  "expenseType" : {
    "expenseTypeDisplayableName" : "expenseTypeDisplayableName",
    "defaultVatType" : "defaultVatType",
    "expenseTypeName" : "expenseTypeName",
    "deprecated" : true,
    "dormantAllowable" : true,
    "assignable" : true
  },
  "vatRegistrationNumber" : "vatRegistrationNumber",
  "contactName" : "contactName",
  "companyName" : "companyName",
  "deletable" : true,
  "id" : 3
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

The supplier is successfully updated SupplierDto

404

The supplier not found and cannot be updated

Fetch all VAT types

Up 
get /vat-types

Security

oauth2-authorisation-code
Type: oauth2 Scopes: read:all

Return type

VatTypesDto

Example data

Content-Type: application/json
{
  "vatTypes" : [ {
    "name" : "name",
    "vatPercent" : 0.8008281904610115
  }, {
    "name" : "name",
    "vatPercent" : 0.8008281904610115
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.
  • application/json

Responses

200

Fetch all VAT types VatTypesDto

Models

[ Jump to Methods ]

Table of Contents

  1. AccountingPeriodDto
  2. AmountDto
  3. AttachmentDto
  4. BankAccountDto
  5. CreditCardDto
  6. CreditNoteDto
  7. CreditNoteLineItemDto
  8. ExpenseDto
  9. ExpenseLineItemDto
  10. ExpenseTypeDto
  11. ExpenseTypeGroupDto
  12. ExpenseTypesDto
  13. ExpensesTotalDto
  14. PageExpenseDto
  15. PageRecurringExpenseDto
  16. PageSupplierDto
  17. Pageable
  18. PaymentMethodDto
  19. PaymentMethodsDto
  20. PaymentTargetDto
  21. PersonDto
  22. RechargedClientDto
  23. RecurringEventDto
  24. RecurringExpenseDto
  25. Sort
  26. SupplierDto
  27. SupplierPaymentDto
  28. SuppliersDto
  29. VatTypeDto
  30. VatTypesDto

AccountingPeriodDto Up

startDate (optional)
date format: date
endDate (optional)
date format: date
status (optional)
String

AmountDto Up

grossAmount (optional)
BigDecimal
netAmount (optional)
BigDecimal
vatAmount (optional)
BigDecimal

AttachmentDto Up

id (optional)
Long A unique number among the attachments of an expense, e.g. 0, 1, 2 etc. format: int64
example: 3
fileName (optional)
String
fileContents (optional)
String Base64-encoding of the file contents

BankAccountDto Up

id (optional)
Long format: int64
bankName
String
displayableName
String
defaultBankAccount (optional)
Boolean

CreditCardDto Up

id (optional)
Long format: int64
displayableName (optional)
String
defaultCreditCard (optional)
Boolean

CreditNoteDto Up

id (optional)
Long format: int64
date (optional)
date format: date
lineItems (optional)
array[CreditNoteLineItemDto]
amount (optional)
AmountDto
refunds (optional)
array[SupplierPaymentDto]

CreditNoteLineItemDto Up

id (optional)
Long format: int64
expenseLineItemIndex (optional)
Integer format: int32
description (optional)
String
amount (optional)
AmountDto

ExpenseDto Up

id (optional)
Long format: int64
supplier (optional)
SupplierDto
supplierReference (optional)
String
note (optional)
String
expenseLineItems (optional)
array[ExpenseLineItemDto]
supplierPayments (optional)
array[SupplierPaymentDto]
creditNotes (optional)
array[CreditNoteDto]
amount (optional)
AmountDto
totalCreditsAmount (optional)
BigDecimal
totalRefundsAmount (optional)
BigDecimal
postingDate (optional)
date format: date
status (optional)
String
outstandingBalance (optional)
BigDecimal
deletable (optional)
Boolean
editable (optional)
Boolean
reconciled (optional)
Boolean
expenseLedgerIsOpen (optional)
Boolean
recharged (optional)
Boolean
rechargedClient (optional)
RechargedClientDto
createdBy (optional)
String
createdByRecurringEvent (optional)
Boolean
recurringEvent (optional)
RecurringEventDto
attachments (optional)
array[AttachmentDto]

ExpenseLineItemDto Up

id (optional)
Long format: int64
expenseType (optional)
String
vatType (optional)
String
description (optional)
String
amount (optional)
AmountDto
employee (optional)
PersonDto

ExpenseTypeDto Up

expenseTypeName (optional)
String
expenseTypeDisplayableName (optional)
String
defaultVatType (optional)
String
assignable (optional)
Boolean
deprecated (optional)
Boolean
dormantAllowable (optional)
Boolean

ExpenseTypeGroupDto Up

expenseTypes (optional)
array[ExpenseTypeDto]
groupName (optional)
String
count (optional)
Integer format: int32

ExpenseTypesDto Up

expenseGroups (optional)
array[ExpenseTypeGroupDto]
count (optional)
Integer format: int32

ExpensesTotalDto Up

grossAmount (optional)
BigDecimal
underpaid (optional)
BigDecimal
overpaid (optional)
BigDecimal

PageExpenseDto Up

totalPages (optional)
Integer format: int32
totalElements (optional)
Long format: int64
numberOfElements (optional)
Integer format: int32
pageable (optional)
Pageable
last (optional)
Boolean
first (optional)
Boolean
size (optional)
Integer format: int32
content (optional)
array[ExpenseDto]
number (optional)
Integer format: int32
sort (optional)
Sort
empty (optional)
Boolean

PageRecurringExpenseDto Up

totalPages (optional)
Integer format: int32
totalElements (optional)
Long format: int64
numberOfElements (optional)
Integer format: int32
pageable (optional)
Pageable
last (optional)
Boolean
first (optional)
Boolean
size (optional)
Integer format: int32
content (optional)
array[RecurringExpenseDto]
number (optional)
Integer format: int32
sort (optional)
Sort
empty (optional)
Boolean

PageSupplierDto Up

totalPages (optional)
Integer format: int32
totalElements (optional)
Long format: int64
numberOfElements (optional)
Integer format: int32
pageable (optional)
Pageable
last (optional)
Boolean
first (optional)
Boolean
size (optional)
Integer format: int32
content (optional)
array[SupplierDto]
number (optional)
Integer format: int32
sort (optional)
Sort
empty (optional)
Boolean

Pageable Up

paged (optional)
Boolean
unpaged (optional)
Boolean
pageSize (optional)
Integer format: int32
pageNumber (optional)
Integer format: int32
offset (optional)
Long format: int64
sort (optional)
Sort

PaymentMethodDto Up

paymentMethodName (optional)
String
paymentMethodDisplayableName (optional)
String

PaymentMethodsDto Up

paymentMethods (optional)
array[PaymentMethodDto]

PaymentTargetDto Up

paymentMethod (optional)
PaymentMethodDto
person (optional)
PersonDto
bankAccount (optional)
BankAccountDto
creditCard (optional)
CreditCardDto

PersonDto Up

id (optional)
Long format: int64
forename (optional)
String
surname (optional)
String
displayableName (optional)
String

RechargedClientDto Up

id (optional)
Long format: int64
name (optional)
String

RecurringEventDto Up

id (optional)
Long format: int64
recurringEventFrequency (optional)
String
recurringEventEndType (optional)
String
frequencyOccurrence (optional)
String
nextOccurrenceDate (optional)
date format: date
endDate (optional)
date format: date
occurrenceCount (optional)
Integer format: int32
description (optional)
String
enabled (optional)
Boolean

RecurringExpenseDto Up

id (optional)
Long format: int64
supplierName (optional)
String
totalAmount (optional)
BigDecimal
status (optional)
String
nextOccurrenceDate (optional)
date format: date
description (optional)
String

Sort Up

unsorted (optional)
Boolean
sorted (optional)
Boolean
empty (optional)
Boolean

SupplierDto Up

id (optional)
Long format: int64
expenseType (optional)
ExpenseTypeDto
companyName (optional)
String
contactName (optional)
String
deletable (optional)
Boolean
archived (optional)
Boolean
country (optional)
String
vatRegistrationNumber (optional)
String

SupplierPaymentDto Up

id (optional)
Long format: int64
date (optional)
date format: date
amount (optional)
BigDecimal
paymentTarget (optional)
PaymentTargetDto
reconciled (optional)
Boolean

SuppliersDto Up

content (optional)
array[SupplierDto]
count (optional)
Integer format: int32

VatTypeDto Up

name (optional)
String
vatPercent (optional)
Double format: double

VatTypesDto Up

vatTypes (optional)
array[VatTypeDto]