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>