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>