Logo
Submit a request

Labor for Service Requests (API)

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>
            
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request