Logo
Submit a request

Expenses on Service Requests (API)

Adding an Expense Item to a Service Request

URL

https://app.bluefolder.com/api/2.0/serviceRequests/addExpense.aspx

Request

<request>
    <serviceRequestAddExpense>
        <serviceRequestId></serviceRequestId>
        <userId></userId>
        <dateUsed></dateUsed>
        <quantity></quantity>
        <billingStatus></billingStatus>
        <billingContractId></billingContractId>
        <itemNo></itemNo>
        <itemDescription></itemDescription>
        <itemUnitCost></itemUnitCost>
        <itemUnitPrice></itemUnitPrice>
        <comment></comment>
        <commentIsPublic></commentIsPublic>
        <taxable></taxable>
    </serviceRequestAddExpense>
</request>
            
  • serviceRequestId - (required) numeric, must match an existing Service Request No.
  • userId - (required) numeric, must match an existing User Id from your user list
  • dateUsed - (required) datetime, must be in the format YYYY.MM.DD HH:MM AM
  • quantity - (required) numeric/decimal
  • billingStatus - string, must be either "billable", "non-billable", or "contract"
  • billingContractId
  • itemNo - string, must match an existing Item Name/No. from your Item List
  • itemDescription - string (250 char limit)
  • itemUnitCost - decimal (do not include currency symbols)
  • itemUnitPrice - decimal (do not include currency symbols)
  • comment - string (no char limit), the comment text
  • commentIsPublic - boolean, indicates if comment should be public (visible to your customer)
  • taxable - boolean

Response

<response status="ok">
    <expenseId>xxxxxx</expenseId>
</response>
            

Editing an Expense Item

URL

https://app.bluefolder.com/api/2.0/serviceRequests/editExpense.aspx

Request

<request>
    <serviceRequestEditExpense>
        <expenseId></expenseId>
        <userId></userId>
        <dateUsed></dateUsed>
        <quantity></quantity>
        <billingStatus></billingStatus>
        <billingContractId></billingContractId>
        <itemNo></itemNo>
        <itemDescription></itemDescription>
        <itemUnitCost></itemUnitCost>
        <itemUnitPrice></itemUnitPrice>
        <comment></comment>
        <commentIsPublic></commentIsPublic>
        <taxable></taxable>
    </serviceRequestEditExpense>
</request>
            
  • expenseId - (required) numeric, must match an existing Service Request Expense Item
  • userId - numeric, must match an existing User Id from your user list
  • dateUsed - datetime, must be in the format YYYY.MM.DD HH:MM AM
  • quantity - numeric/decimal
  • billingStatus - string, must be either "billable", "non-billable", or "contract"
  • billingContractId
  • itemNo - string, must match an existing Item Name/No. from your Item List
  • itemDescription - string (250 char limit)
  • itemUnitCost - decimal (do not include currency symbols)
  • itemUnitPrice - decimal (do not include currency symbols)
  • comment - string (no char limit), the comment text
  • commentIsPublic - boolean, indicates if comment should be public (visible to your customer)
  • taxable - boolean

Response

<response status="ok">
    <expenseId>xxxxxx</expenseId>
</response>
            
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request