Skip to content

Job scope change requests

Managing a scope change request for a job.

Sometimes there are services that aren't captured in the job but are identified by the Tax Pro. In these cases, the Tax Pro may request a scope change to amend the services on the job.

When a scope change is requested, the Job will be put ON_HOLD, and a webhook notification will be emitted to let you know that the scope change is pending approval.

The request can then be either accepted or rejected on behalf of the client.

If accepted, the scope change pricing will be applied to the job, and the job will move back to the CLAIMED status.

If rejected, the scope change is dismissed, and the job will remain ON_HOLD.

Endpoints Used

MethodUrl
POST/v1.0/jobs/{job_id}/scope_change/approve
POST/v1.0/jobs/{job_id}/scope_change/reject

Job Scope Change Properties

id

The ID of the scope change.

job_id

The ID of the job the scope change corresponds to.

created_by_user_id

The ID of the user who requested the scope change.

create_time

When the scope change was requested.

items

The requested items.



Job Scope Change Item Properties

Each item describes a service, alongside a price inclusive of the total quantity.

name

A name describing the service.

quantity

The item quantity.

price

The total price of the service.

Copied
1{
2 "id": "60b0888a-2ab2-490b-bfc2-ecdc365e7e71",
3 "job_id": "65b332cc-bbe6-4f0a-831a-14c5e7e402dc",
4 "created_by_user_id": "7628012a-d5e0-45b8-bc0d-72ebce39f836",
5 "create_time": "2022-12-09T06:48:15.672362Z",
6 "items": [
7 {
8 "name": "1040NR",
9 "quantity": 1,
10 "price": 20.3
11 }
12 ]
13}
Last updated on December 12, 2022