Field NationDeveloper Platform
Field NationDeveloper Platform
IntroductionQuick StartAPI Playground

Getting Started

API Reference

Overview
PayExpensesBonuses & PenaltiesDiscounts & Increases
Work OrdersFinancials

Bonuses & Penalties

Apply incentives and deductions to work orders.


Bonuses & Penalties

You can modify the final payout using Bonuses (incentives) and Penalties (deductions).

Bonuses

Incentives for good performance, urgent work, or special circumstances.

List Available Bonuses

GET /bonuses

{
  "results": [
    { "id": 1, "name": "Urgent Dispatch", "amount": 25.00 },
    { "id": 2, "name": "Weekend Work", "amount": 50.00 },
    { "id": 3, "name": "Exceptional Service", "amount": 30.00 }
  ]
}

List Work Order Bonuses

GET /workorders/{id}/bonuses

Apply Bonus

POST /workorders/{id}/bonuses/{bonus_id}

{
  "amount": 25.00,
  "description": "Urgent same-day dispatch"
}

Include bonuses in the initial work order payload:

"pay": {
  "type": "fixed",
  "base": { "amount": 100 },
  "bonuses": {
    "results": [{ "id": 1 }]
  }
}

Add bonus after the work order is assigned:

POST /workorders/{id}/bonuses/1


Penalties

Deductions for late arrivals, missing deliverables, or other issues.

List Available Penalties

GET /penalties

{
  "results": [
    { "id": 1, "name": "Late Arrival", "amount": 15.00 },
    { "id": 2, "name": "Missing Photos", "amount": 10.00 },
    { "id": 3, "name": "Incomplete Tasks", "amount": 20.00 }
  ]
}

List Work Order Penalties

GET /workorders/{id}/penalties

Apply Penalty

POST /workorders/{id}/penalties/{penalty_id}

{
  "amount": 15.00,
  "reason": "Provider arrived 45 minutes late"
}

Penalties can only be applied before the work order is Paid. Communicate clearly with providers about deduction reasons.

Final Pay Calculation

Final Pay = Base Pay + Bonuses - Penalties + Approved Expenses

Example

ComponentAmount
Base Pay (Fixed)$150.00
+ Urgent Bonus$25.00
- Late Penalty-$15.00
+ Materials Expense$45.00
Total$205.00

Related

  • Pay - Base pay structure
  • Expenses - Reimbursable costs
  • Company - Configure bonus/penalty types

Last updated on

Expenses

Managing provider expense claims and reimbursements.

Discounts & Increases

Managing buyer discounts and pay increases on work orders.

On this page

Bonuses & Penalties
Bonuses
List Available Bonuses
List Work Order Bonuses
Apply Bonus
Penalties
List Available Penalties
List Work Order Penalties
Apply Penalty
Final Pay Calculation
Example
Related