Expense lines to approve

An employee creates and submits an expense report, which is routed to the employee's manager for approval. The individual line items on the expense report can be approved or declined for reimbursement.

List employee expense lines to approve

get/objects/expenses/expense-to-approve-line

Returns a collection with a key, ID, and link for each expense to approve line. This operation is mostly for use in testing; use query to find objects that meet certain criteria and to specify properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": [
    • {
      • "key": "101",
      • "id": "101",
      • "href": "/objects/expenses/expense-to-approve-line/101"
      },
    • {
      • "key": "102",
      • "id": "102",
      • "href": "/objects/expenses/expense-to-approve-line/102"
      },
    • {
      • "key": "103",
      • "id": "103",
      • "href": "/objects/expenses/expense-to-approve-line/103"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "start": 1,
    • "pageSize": 100,
    • "next": 0,
    • "previous": 0
    }
}

Get an approve employee expense line

get/objects/expenses/expense-to-approve-line/{key}

Returns detailed information for a specified expense to approve line.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned unique key for the expense to approve line.

Example: 312
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "key": "312",
    • "id": "312",
    • "entryDate": "2021-01-23",
    • "baseCurrency": "USD",
    • "baseAmount": "123.45",
    • "reimbursementCurrency": "CAD",
    • "reimbursementAmount": "123.45",
    • "txnCurrency": "INR",
    • "txnAmount": "123.45",
    • "totalSelected": "123.45",
    • "totalPaid": "123.45",
    • "quantity": "5.75",
    • "unitRate": "20.00",
    • "paidTo": "Hotel Westin",
    • "paidFor": "Attending conference",
    • "glAccount": {
      • "key": "158",
      • "id": "6775.30",
      • "name": "Travel",
      • "href": "/objects/general-ledger/account/23"
      },
    • "expenseType": {
      • "key": "6000",
      • "id": "Meals",
      • "href": "/objects/expense-type/34"
      },
    • "lineNumber": 1,
    • "reimburseToBaseConversion": {
      • "exchangeRateDate": "2021-01-23",
      • "exchangeRateTypeId": "-1",
      • "exchangeRate": "1.18999"
      },
    • "transactionToReimburseConversion": {
      • "exchangeRate": "65",
      • "exchangeRateDate": "2021-01-23",
      • "exchangeRateTypeId": "-1"
      },
    • "state": "draft",
    • "isBillable": false,
    • "isBilled": false,
    • "form1099": {
      • "isForm1099": "true",
      • "type": "MISC",
      • "box": "3"
      },
    • "paymentType": {
      • "key": "1",
      • "id": "1",
      • "name": "Non-reimburse",
      • "isNonReimbursable": false,
      • "href": "string"
      },
    • "audit": {
      • "createdDateTime": "2022-04-20T16:20:00Z",
      • "modifiedDateTime": "2022-04-20T16:20:00Z",
      • "createdBy": "1",
      • "modifiedBy": "95"
      },
    • "dimensions": {
      • "location": {
        },
      • "department": {
        },
      • "employee": {
        },
      • "employeeContact": {
        },
      • "project": {
        },
      • "customer": {
        },
      • "vendor": {
        },
      • "item": {
        },
      • "warehouse": {
        },
      • "class": {
        },
      • "task": {
        },
      • "costType": {
        },
      • "asset": {
        },
      • "contract": {
        }
      },
    • "approveEmployeeExpense": {
      • "id": "1",
      • "key": "1"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}

Query expense to approve lines

post/services/core/query

Use the query service to find expense to approve lines that meet certain criteria and to specify the properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}