Field NationDeveloper Platform
Field NationDeveloper Platform
IntroductionQuick StartAPI Playground

Getting Started

Work Order LifecycleClassification

API Reference

Core Concepts

Work Order Lifecycle

Understand the stages of a work order from creation to payment.


The Work Order Lifecycle

The lifecycle of a work order is the central concept in the Field Nation platform. Understanding these states is critical for building a robust integration.

The Flow

1. Draft

When you first POST a work order, it is created in the Draft state.

  • Visibility: Only visible to you (the buyer).
  • Actions: You can edit all details.
  • Next Step: Publish the work order to make it live.

2. Published (Routed)

Once published, the work order enters the marketplace.

  • Visibility: Visible to providers you have routed it to (or the general marketplace if open).
  • Status: Routed or Published.
  • Actions: Providers can view requests and submit counter-offers.
  • Next Step: Assign a provider.

3. Assigned

You have selected a provider and they have accepted the work.

  • Status: Assigned.
  • Actions: The provider checks in, performs work, and checks out.

4. Work Done (Completed)

The provider has marked the work as complete.

  • Status: Work Done.
  • Actions: You must review the work deliverables (photos, notes).
  • Options:
    • Approve: Validated work. Moves to payment.
    • Incomplete: Reject work. Sends back to provider for fixes.

5. Approved

The work is accepted.

  • Status: Approved.
  • Actions: The system calculates final pay (including bonuses/expenses) and initiates the payment process.

6. Paid

Payment has been transferred to the provider.

  • Status: Paid.
  • Note: This is the final terminal state.

State Diagram

Loading diagram...

Integration Tip: Most integrations poll for status changes or listen to Webhooks to trigger their internal workflows (e.g., closing a ticket when the work order is Approved).

Related

  • Workflow Management - API endpoints for each state
  • Assignments - Managing provider assignments
  • Taxonomy - Understanding work order structure

Last updated on

Troubleshooting

Common error codes, pitfalls, and how to resolve them.

Classification

How work is categorized using Types of Work and Templates.

On this page

The Work Order Lifecycle
The Flow
1. Draft
2. Published (Routed)
3. Assigned
4. Work Done (Completed)
5. Approved
6. Paid
State Diagram
Related