Feature Overview
Our Status and Vendor/Customer Status are two linked status fields that appear on Purchase Order lines. Together they provide a lightweight communication tracking layer for purchase order negotiations — allowing a purchasing team to record and manage the state of each purchase line through the lifecycle of sending a request, awaiting a reply, receiving an answer, making changes, or cancelling.
Our Status represents the internal view: what action has been taken or is expected from the company's side (e.g. Send Request, Request Sent, Reminder Sent, Answer Received, Change Accepted, Cancel). Vendor Status (also referred to as Customer or Vendor Status depending on context) represents the external party's response (e.g. Waiting for answer, Accept, Declined, Changed). The two status tables are configured with cross-update rules: when Our Status changes to a given value, the Vendor Status can be automatically updated to a corresponding value, and vice versa.
Status transitions are also triggered automatically when Document Handling sends a purchase-related email. For example, when a new order request email is sent, Our Status is automatically set to the default "Request Sent" value. When a reminder is sent, it is set to "Reminder Sent". This automation means the status always reflects the current state of the communication without the purchaser having to manually update it after each send action.
This feature requires the Purchase Order Handling app (BC629) to be installed alongside Document Handling for full functionality — the status fields live on Purchase Lines and are part of the purchase handling workflow.
Key Facts
| Topic | Detail |
|---|---|
| Where to configure statuses | Our Status (page), Handling Cust-Vend Status (page) |
| Where statuses appear | On Purchase Order Lines (Our Status and Vendor Status fields) |
| Automatic status update on send | Yes — triggered when Document Handling sends a purchase email |
| Automatic status update on quantity entry | Yes — when a quantity is entered on a new purchase line, Our Status is set to the default "Send Request" value |
| Bidirectional update | Our Status can auto-update Vendor Status, and Vendor Status can auto-update Our Status |
| Default option | Each status value can be flagged as "Default Option" for a given status category |
| Integration dependency | Purchase Order Handling app (BC629) required for full workflow functionality |
Getting Started
- Run Default Setup in Document Handling Setup — this creates the standard set of Our Status and Vendor/Customer Status values automatically.
- Open the Our Status page (search for "Our Status") and review the generated values. Each status has an Our Status Options category (Send Request, Request Sent, Reminder Sent, etc.) and a Default Option flag.
- Open the Handling Cust-Vend Status page and review the corresponding Vendor Status values.
- For each Our Status value that should automatically update the Vendor Status, enable Update Customer or Vendor Status and set the Set Customer or Vendor Status field.
- For each Vendor Status value that should automatically update Our Status, enable Update Our Status and set the Set Our Status field.
- Open a Purchase Order and verify the Our Status and Vendor Status fields are visible on the order lines. Add a line item and observe that Our Status is set automatically.
- Use the Document Handling send action on the purchase order — the status updates automatically based on the action taken.
Related Features
Our Status and Vendor/Customer Status are tightly integrated with Email Sending & Sending Profiles — the act of sending an email is what triggers the automatic status transitions on purchase lines. Email Templates defines the mail types (New, Change, Cancel, Reminder) that correspond to the different status transitions. The full workflow including the handling journal, batch sending, and acceptance flows is part of the Purchase Order Handling app, which extends Document Handling's core sending capability into a complete purchase communication workflow.
User Stories
US-01: Set up the default Our Status and Vendor Status values using Default Setup
As a IT Manager
I want to generate the standard set of Our Status and Vendor Status values in a single step
So that the purchasing team has a ready-to-use status framework without manual configuration
Setup:
- Open Document Handling Setup.
- Click Default Setup.
- The standard Our Status values are created: Send Request, Mail Sent, Request Sent, Reminder Sent, Answer Received, Accepted, Cancelled, Cancellation Sent.
- The standard Vendor Status values are created: Accepted, Awaiting Reply, Changed, Rejected, Ongoing Dialogue.
- Review both pages after setup to verify the cross-update rules are correct for your business.
US-02: Configure automatic Vendor Status update when Our Status changes
As a IT Manager
I want to configure Our Status values to automatically set a corresponding Vendor Status
So that the purchasing team doesn't have to manually update both status fields after each action
Setup:
- Open the Our Status page.
- For each status value where a Vendor Status update should follow, enable Update Customer or Vendor Status.
- Set Set Customer or Vendor Status to the target Vendor Status value.
- Example: when Our Status is set to "Mail Sent", Vendor Status should automatically be set to "Awaiting Reply".
US-03: Configure automatic Our Status update when Vendor Status is entered
As a Purchasing Agent
I want to configure Vendor Status values to automatically update Our Status when the vendor's response is recorded
So that recording the vendor's reply automatically advances Our Status to the correct next step
Setup:
- Open the Handling Cust-Vend Status page.
- For each Vendor Status value that should trigger an Our Status update, enable Update Our Status.
- Set Set Our Status to the target Our Status value.
- Example: when Vendor Status is set to "Accepted", Our Status should automatically be set to "Accepted".
US-04: Understand how Our Status is set automatically when a quantity is entered on a purchase line
As a Purchasing Agent
I want to understand the automatic status assignment when adding a new purchase line
So that I know why Our Status is already populated when I start a new purchase order line
Setup:
- Open a Purchase Order and add a new line.
- When a non-zero quantity is entered on a line that previously had no quantity, Document Handling automatically looks up the default Our Status value in the Send Request category and assigns it to the line.
- No manual action is required — the status transitions automatically. This is controlled by the Default Option flag on the Our Status record with status category "Send Request".
US-05: Automatically update Our Status when a purchase order email is sent
As a Purchasing Agent
I want to have Our Status automatically update after sending a purchase email
So that I don't have to manually change the status on each line after every communication action
Setup:
- Ensure Our Status values are configured with the correct Our Status Options categories and Default Option flags.
- When a new order request email is sent via Document Handling, Our Status on the purchase line is automatically set to the default "Request Sent" value.
- When a reminder email is sent, Our Status is set to the default "Reminder Sent" value.
- When a cancellation email is sent, Our Status is set to the default "Cancel Request Sent" value.
- No manual configuration is required per send — the automation is driven by the Default Option flags on the status records.
US-06: Add custom Our Status values for company-specific workflow states
As a Business Manager
I want to add custom Our Status values beyond the defaults
So that the status tracking reflects the specific stages of our purchasing process
Setup:
- Open the Our Status page.
- Add new rows with a Our Status code and description.
- Assign an Our Status Options category — this category determines how Document Handling treats the status in automated transitions. Choose the closest matching category (e.g. "Request Sent" for a status that means "sent to vendor").
- Optionally enable Update Customer or Vendor Status and set the target vendor status.
- Set Default Option if this custom value should be the one used in automated transitions for its category.
Note: Only one record per Our Status Options category can have Default Option enabled. Setting a new default automatically clears the previous default for that category.
US-07: Use Our Status to control which Document Handling actions are available on a purchase line
As a Purchasing Agent
I want to understand how Our Status determines which actions I can take on a purchase line from the Purchase Handling journal
So that I know why some actions are greyed out depending on the current status
Setup:
- The available actions in the Purchase Handling workflow are determined by the Our Status Options category of the current Our Status value:
- Blank or Send Request → the line is in a state where a new request can be initiated.
- Request Sent, Reminder Sent, or Cancel Request Sent → the line is awaiting a response; change and accept actions may be limited.
- Change Accepted or Answer Received → the exchange is considered resolved.
- Cancel → the line is cancelled.
- Accept actions on Quote lines are blocked — they must be processed from the Purchase Handling Journal.
Field Reference
| Field | Where to find it | What it does | Default |
|---|---|---|---|
| Our Status | Our Status page | Unique code for this internal status value | — |
| Description | Our Status page | Free-text description of the status | Blank |
| Our Status Options | Our Status page | Category that controls automated behaviour (Send Request, Request Sent, etc.) | — |
| Default Option | Our Status page | Marks this value as the default for its category in automated transitions | Off |
| Update Customer or Vendor Status | Our Status page | When this Our Status is set, automatically update the Vendor Status field | Off |
| Set Customer or Vendor Status | Our Status page | Which Vendor Status value to set when Update is enabled | — |
| Customer or Vendor Status | Handling Cust-Vend Status page | Unique code for this external party status value | — |
| Customer or Vendor Status Options | Handling Cust-Vend Status page | Category: Waiting for answer, Accept, Declined, Changed | — |
| Default Option | Handling Cust-Vend Status page | Marks this value as the default for its category | Off |
| Update Our Status | Handling Cust-Vend Status page | When this Vendor Status is set, automatically update Our Status | Off |
| Set Our Status | Handling Cust-Vend Status page | Which Our Status value to set when Update is enabled | — |