Expenses

All API Operations related with Expenses

READ Scope

List all expenses

Retrieves all the expenses that match with provided filters

POSThttps://api.nuvio.io/v1/list-expenses

Body

application/jsontext/jsonapplication/*+json

startDatenullable string

Starting date to be applied to date filter. Should be formatted in YYYY-MM-DD format

endDatenullable string

End date to be applied to date filter. Should be formatted in YYYY-MM-DD format

supplierIdnullable string (uuid)

32-character unique ID to filter a specific business entity. If you don't know the ID, you can also provide supplierCode instead of this field. If both of them are provided, supplierId will be used only.

supplierCodenullable string

User-generated custom unique code to filter a specific business entity. If supplierId is also provided, it will override this filter.

tagNamenullable string

Name of the tag to be included in the filtering. Case sensitive. It should exactly match with the name in the Nuvio Platform.

projectNamenullable string

Name of the project to be included in the filtering. Case sensitive. It should exactly match with the name in the Nuvio Platform.

projectCodenullable string

User generated code of the project to be included in the filtering. Case sensitive. It should exactly match with the code in the Nuvio Platform.

paymentStatusnullable string

Select one of the enum values to filter specific incomes that matches with required payment status.

Response

200

OK

Body

application/json

successboolean

errorsnullable array of string

dataarray of Expenses

Request

JavaScriptCurlPython

const response = await fetch('https://api.nuvio.io/v1/list-expenses', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "success": false,
  "errors": [
    "text"
  ],
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "referenceNumber": "text",
      "paymentStatus": "text",
      "description": "text",
      "dueDate": "text",
      "expenseDate": "text",
      "currency": "text",
      "exchangeRate": 0,
      "project": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "projectCode": "text"
      },
      "supplier": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "entityCode": "text"
      },
      "tags": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        }
      ],
      "subTotal": 0,
      "totalTax": 0,
      "totalAmount": 0,
      "remainingAmount": 0,
      "items": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "itemDetail": "text",
          "productCode": "text",
          "productId": "123e4567-e89b-12d3-a456-426614174000",
          "productName": "text",
          "unitPrice": "text",
          "totalTaxes": 0,
          "totalAmount": 0,
          "itemTaxes": [
            {
              "taxId": "123e4567-e89b-12d3-a456-426614174000",
              "taxName": "text",
              "taxAmount": 0
            }
          ]
        }
      ],
      "matchedPayments": [
        {
          "bankAccountId": "123e4567-e89b-12d3-a456-426614174000",
          "bankAccountName": "text",
          "transactionId": "123e4567-e89b-12d3-a456-426614174000",
          "amount": 0,
          "currency": "text",
          "description": "text",
          "transactionDate": "text"
        }
      ]
    }
  ]
}

Get an Expense by ID

Retrieves an expense by its unique UID

GEThttps://api.nuvio.io/v1/expense/{id}

Path parameters

id*string

Response

200

OK

Body

application/json

successboolean

errorsnullable array of string

dataExpense

Request

JavaScriptCurlPython

const response = await fetch('https://api.nuvio.io/v1/expense/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "success": false,
  "errors": [
    "text"
  ],
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "referenceNumber": "text",
    "paymentStatus": "text",
    "description": "text",
    "dueDate": "text",
    "expenseDate": "text",
    "currency": "text",
    "exchangeRate": 0,
    "project": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "projectCode": "text"
    },
    "supplier": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "entityCode": "text"
    },
    "tags": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text"
      }
    ],
    "subTotal": 0,
    "totalTax": 0,
    "totalAmount": 0,
    "remainingAmount": 0,
    "items": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "itemDetail": "text",
        "productCode": "text",
        "productId": "123e4567-e89b-12d3-a456-426614174000",
        "productName": "text",
        "unitPrice": "text",
        "totalTaxes": 0,
        "totalAmount": 0,
        "itemTaxes": [
          {
            "taxId": "123e4567-e89b-12d3-a456-426614174000",
            "taxName": "text",
            "taxAmount": 0
          }
        ]
      }
    ],
    "matchedPayments": [
      {
        "bankAccountId": "123e4567-e89b-12d3-a456-426614174000",
        "bankAccountName": "text",
        "transactionId": "123e4567-e89b-12d3-a456-426614174000",
        "amount": 0,
        "currency": "text",
        "description": "text",
        "transactionDate": "text"
      }
    ]
  }
}

WRITE Scope

Create a new Expense

Creates a new expense from scratch

POSThttps://api.nuvio.io/v1/expense

Body

application/jsontext/jsonapplication/*+json

referenceNumberstring

Invoice or receipt number of the received expense, formatted in string. Accepts alpha numeric characters and '-' symbol.

description*string

Description of the expense. This will also be its title in the Nuvio Platform.

expenseDate*string

The date of the expense. Should be formatted in YYYY-MM-DD format

dueDate*string

Due date of the payment for this expense. Should be formatted in YYYY-MM-DD format.

currencystring

3-letter currency code. You can find all the available currencies here.

projectIdstring (uuid)

32-character unique ID of the related project. If you don't know the ID, you can also provide projectCode instead of this field. If both of them are provided projectId will be used only.

projectCodestring

User-generated custom code of the related project. If `projectId`` is also provided, it will override this field.

supplierIdstring (uuid)

32-character unique ID of the supplier. If you don't know the ID, you can also provide supplierCode instead of this field. If both of them are provided, supplierId will be used only.

supplierCodestring

User-generated custom unique code of the specific supplier. If supplierId is also provided, it will override this field.

tagsarray of string (uuid)

List of the tags that are related to this expense. Provide a list of tags with their 32-character unique ID.

itemsarray of CreateExpenseItemsRequest (object)

List of the items that are linked to this expense.

exchangeRatenumber (double)

If currency is different than your company's functional currency, this will be the exchange rate that Nuvio will use while converting the amounts of this expense to company's functional currency. Should be number with 4 decimal points. eg. 32.4325

Response

200

OK

Body

application/json

successboolean

errorsnullable array of string

dataExpense

Request

JavaScriptCurlPython

const response = await fetch('https://api.nuvio.io/v1/expense', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "description": "text",
      "dueDate": "text",
      "expenseDate": "text"
    }),
});
const data = await response.json();

Response

200

{
  "success": false,
  "errors": [
    "text"
  ],
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "referenceNumber": "text",
    "paymentStatus": "text",
    "description": "text",
    "dueDate": "text",
    "expenseDate": "text",
    "currency": "text",
    "exchangeRate": 0,
    "project": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "projectCode": "text"
    },
    "supplier": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "entityCode": "text"
    },
    "tags": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text"
      }
    ],
    "subTotal": 0,
    "totalTax": 0,
    "totalAmount": 0,
    "remainingAmount": 0,
    "items": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "itemDetail": "text",
        "productCode": "text",
        "productId": "123e4567-e89b-12d3-a456-426614174000",
        "productName": "text",
        "unitPrice": 0,
        "totalTaxes": 0,
        "totalAmount": 0,
        "itemTaxes": [
          {
            "taxId": "123e4567-e89b-12d3-a456-426614174000",
            "taxName": "text",
            "taxAmount": 0
          }
        ]
      }
    ],
    "matchedPayments": [
      {
        "bankAccountId": "123e4567-e89b-12d3-a456-426614174000",
        "bankAccountName": "text",
        "transactionId": "123e4567-e89b-12d3-a456-426614174000",
        "amount": 0,
        "currency": "text",
        "description": "text",
        "transactionDate": "text"
      }
    ]
  }
}

UPDATE Scope

Update expense

Updates an existing expense

PUThttps://api.nuvio.io/v1/expense/{id}

Path parameters

id*string (uuid)

Body

application/jsontext/jsonapplication/*+json

referenceNumberstring

Invoice or receipt number of the received expense, formatted in string. Accepts alpha numeric characters and '-' symbol.

descriptionstring

Description of the expense. This will also be its title in the Nuvio Platform.

expenseDatestring

The date of the expense. Should be formatted in YYYY-MM-DD format

dueDatestring

Due date of the payment for this expense. Should be formatted in YYYY-MM-DD format

currencystring

3-letter currency code. You can find all the available currencies here.

projectIdstring (uuid)

32-character unique ID of the related project. If you don't know the ID, you can also provide projectCode instead of this field. If both of them are provided projectId will be used only.

projectCodestring

User-generated custom code of the related project. If projectId is also provided, it will override this field.

supplierIdstring (uuid)

32-character unique ID of the supplier. If you don't know the ID, you can also provide supplierCode instead of this field. If both of them are provided, supplierId will be used only.

supplierCodestring

User-generated custom unique code of the specific supplier. If supplierId is also provided, it will override this field.

tagsarray of string (uuid)

List of the tags that are related to this expense. Provide a list of tags with their 32-character unique ID.

itemsarray of UpdateExpenseItemsRequest (object)

List of the items that are linked to this expense. This list will override existing list of items in the updated expense. Do not just update 1 item, make sure to include all the items in your request.

exchangeRatenullable number (double)

If currency is different than your company's functional currency, this will be the exchange rate that Nuvio will use while converting the amounts of this expense to company's functional currency. Should be number with 4 decimal points. eg. 32.4325

Response

200

OK

Body

application/json

successboolean

errorsnullable array of string

dataExpense

Request

JavaScriptCurlPython

const response = await fetch('https://api.nuvio.io/v1/expense/{id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "success": false,
  "errors": [
    "text"
  ],
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "referenceNumber": "text",
    "paymentStatus": "text",
    "description": "text",
    "dueDate": "text",
    "expenseDate": "text",
    "currency": "text",
    "exchangeRate": 0,
    "project": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "projectCode": "text"
    },
    "supplier": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "entityCode": "text"
    },
    "tags": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text"
      }
    ],
    "subTotal": 0,
    "totalTax": 0,
    "totalAmount": 0,
    "remainingAmount": 0,
    "items": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "itemDetail": "text",
        "productCode": "text",
        "productId": "123e4567-e89b-12d3-a456-426614174000",
        "productName": "text",
        "unitPrice": 0,
        "totalTaxes": 0,
        "totalAmount": 0,
        "itemTaxes": [
          {
            "taxId": "123e4567-e89b-12d3-a456-426614174000",
            "taxName": "text",
            "taxAmount": 0
          }
        ]
      }
    ],
    "matchedPayments": [
      {
        "bankAccountId": "123e4567-e89b-12d3-a456-426614174000",
        "bankAccountName": "text",
        "transactionId": "123e4567-e89b-12d3-a456-426614174000",
        "amount": 0,
        "currency": "text",
        "description": "text",
        "transactionDate": "text"
      }
    ]
  }
}