Adding a Labor Item to a Service Request
URL
https://app.bluefolder.com/api/2.0/serviceRequests/addLabor.aspx
Request
<request> <serviceRequestAddLabor> <serviceRequestId></serviceRequestId> <userId></userId> <dateWorked></dateWorked> <duration></duration> <billingStatus></billingStatus> <billingContractId></billingContractId> <itemNo></itemNo> <itemDescription></itemDescription> <itemUnitCost></itemUnitCost> <itemUnitPrice></itemUnitPrice> <comment></comment> <commentIsPublic></commentIsPublic> <startTime></startTime> <taxable></taxable> </serviceRequestAddLabor> </request>
- serviceRequestId - (required) numeric, must match an existing Service Request No.
- userId - (required) numeric, must match an existing User Id from your user list
- dateWorked - (required) date, must be in the format YYYY.MM.DD
- duration - (required) numeric/decimal, partial hours as decimal (e.g. .25 = 15 minutes, .5 = 30 minutes)
- 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)
- startTime - time, must be in the format HH:MM AM
- taxable - boolean
Response
<response status="ok"> <laborId>xxxxxx</laborId> </response>
Editing a Labor Item
URL
https://app.bluefolder.com/api/2.0/serviceRequests/editLabor.aspx
Request
<request> <serviceRequestEditLabor> <laborId></laborId> <userId></userId> <dateWorked></dateWorked> <duration></duration> <billingStatus></billingStatus> <billingContractId></billingContractId> <itemNo></itemNo> <itemDescription></itemDescription> <itemUnitCost></itemUnitCost> <itemUnitPrice></itemUnitPrice> <comment></comment> <commentIsPublic></commentIsPublic> <startTime></startTime> <taxable></taxable> </serviceRequestEditLabor> </request>
- laborId - (required) numeric, must match an existing Service Request Labor Item
- userId - numeric, must match an existing User Id from your user list
- dateWorked - date, must be in the format YYYY.MM.DD
- duration - numeric/decimal, partial hours as decimal (e.g. .25 = 15 minutes, .5 = 30 minutes)
- 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)
- startTime - time, must be in the format HH:MM AM
- taxable - boolean
Response
<response status="ok"> <laborId>xxxxxx</laborId> </response>