Dispute Verdicts (4PL Billing)

Dispute Verdicts shows disputes related to warehouse billing that require a decision from the warehouse or administrator. This view allows you to review disputes, accept them, reject them, or transfer them to carrier insurance, directly affecting warehouse billing.

This functionality is essential for managing disputes related to packing errors, shipping problems, or other issues that affect billing between the 4PL and 3PL warehouses.

What is Dispute Verdicts?

Dispute Verdicts is a list of disputes (dispute) related to warehouse billing that are pending resolution. Each dispute represents a reported problem (such as a packing error) that requires a warehouse decision on whether to accept responsibility and refund the client, or reject the dispute.

Disputes can be in different states according to their progress in the resolution process, and decisions made directly affect warehouse billing records (partial_invoices_wh).

Why use Dispute Verdicts?

Centralized Management

Manage all disputes related to warehouse billing in one place, facilitating review and decision-making.

Billing Impact

Dispute decisions directly affect warehouse billing, creating automatic adjustments in partial invoices.

Insurance Transfer

Transfer disputes to carrier insurance when appropriate, allowing the carrier to handle the claim directly.

Status Tracking

Track the status of each dispute from open to resolved, maintaining a clear record of the resolution process.

Comments and Documentation

Add final comments and documentation for each dispute, facilitating communication and decision records.

Automatic Resolution

Disputes are automatically accepted after 60 calendar days if no decision has been made, protecting clients.

Accessing Dispute Verdicts

You can access Dispute Verdicts from:

Main Menu → 3PL Billing → 4PL Billing → Dispute Verdicts

Or navigate directly to: /Disputeslist.php?cmd=reset

Dispute Statuses

Disputes can be in the following states:

Status	Description	Visible For
65 - WH Open	Open dispute waiting for warehouse response	Warehouse (Level 2, UserWH=0), Manager (Level 2, UserWH=1)
66 - WH Accepted	Dispute accepted by warehouse	Archived
67 - WH Denied	Dispute rejected by warehouse	Archived
68 - Carrier Insurance	Dispute transferred to carrier insurance	Admin (Level 3), Manager (Level 2, UserWH=1)
69 - Carrier Insurance Accepted	Carrier insurance accepted	Archived
70 - Carrier Insurance Denied	Carrier insurance rejected	Archived

Table Columns

The table shows the following columns:

Column	Description
Actions	Available action buttons according to status and user level (Accept, Decline, CarrierInsurance, Edit Comment)
ID	Unique dispute identifier. You can sort by this field.
Report Date	Date when the dispute was reported (PackingError Date). You can sort by this field.
Account	(Admin/Manager only) Account associated with the dispute. You can sort by this field.
Shipping#	Original shipping number (`FromOrderID`) related to the dispute. You can sort by this field.
Claim Amount	Total claim amount, including shipping & handling, return label, restocking, and additional compensation.
Picker’s Name	(Admin/Manager only) Name of the person who prepared the order.
Dispute Type	Type of reported dispute. You can sort by this field.
Status	Current dispute status (65, 66, 67, 68, 69, 70, etc.). You can sort by this field.
Problem Description	Problem description reported by seller/client. You can sort by this field.
Warehouse’s Final Comments	Final warehouse comments about the dispute. You can sort by this field.
Corrective Shipping#	Corrective shipping number (`OrderID`) if a correction order was created. You can sort by this field.
Compensation	Additional compensation amount agreed. You can sort by this field.
Sh & H	Shipping & handling amount of the corrective shipment (`shipping_handling_amount_corrective_order`). You can sort by this field.
Closed Date	Date when the dispute was closed (`FinishDate`). You can sort by this field.
Recipient phone	(Admin/Manager only) Recipient phone number. You can sort by this field.
Proof of compensation Value	(Admin/Manager only) File or evidence of compensation (`file_name`). You can sort by this field.

Main Features

Search and Filtering

Advanced Search:

Dispute ID#: Search for a specific dispute by its identification number
Shipping#: Search by original shipping number (FromOrderID)
From Shipping#: Search by corrective shipping number (OrderID)
Status: Filter by specific dispute status
Report Date: Filter by date range using the report date
Closed Date: Filter by date range using the close date

Basic Search:

Search by Problem Description, Warehouse’s Final Comments, Dispute Type, or Status
You can use exact phrase search, all words, or any word
Click Search to execute the search or Reset to clear filters
Use Show all to view all disputes without filters

Sorting:

Click any column header to sort by that field
Arrows indicate if sorting is ascending (↑) or descending (↓)
Default sorting is by ID descending (most recent first)

Manage Disputes (Warehouse - Status 65)

For disputes with Status 65 (WH Open), warehouse users can:

Accept a Dispute:

Locate the dispute you want to accept
Click Accept
A popup window (popup_packing_error.php) will open with details
Review and adjust amounts if necessary:
- SH & H (Shipping & Handling)
- Return Label (Return label)
- Restocking (Restocking)
- Additional Compensation (Additional compensation)
The system will automatically calculate the Total Amount
Add Final Comments if you want to document the decision
Click Accept to confirm
The dispute will be marked as accepted (Status 66) and moved to Disputes Archived
Records will be created in partial_invoice and partial_invoices_wh with negative amounts

Reject a Dispute:

Locate the dispute you want to reject
Click Decline
A popup window will open with details
Add Final Comments explaining why the dispute is rejected
Click Decline to confirm
The dispute will be marked as rejected (Status 67) and moved to Disputes Archived
Records will be created in partial_invoices_wh with positive amounts

Transfer to Carrier Insurance:

Locate the dispute you want to transfer (must be less than 30 days from report date)
Click CarrierInsurance
Confirm the action when prompted
The dispute will be marked as transferred (Status 68)
Shipping & handling amount will be recorded and carrier_insurance = 'Y' will be marked
The dispute will remain visible to administrators and managers for review

Edit Comments:

Locate the dispute for which you want to edit comments
Click Edit Comment
Editable fields will become input fields
Modify Warehouse’s Final Comments as necessary
Click Update to save changes or Cancel to discard them

Manage Insurance Disputes (Admin/Manager - Status 68)

For disputes with Status 68 (Carrier Insurance), administrators and managers can:

Accept Insurance Claim:

Locate the insurance dispute you want to accept
Click Accept
A popup window will open with details
Review and adjust amounts if necessary:
- SH & H (Shipping & Handling)
- Return Label (Return label)
- Restocking (Restocking)
- Additional Compensation (Additional compensation)
The system will automatically calculate the Total Amount
Add Final Comments if you want to document the decision
Click Accept to confirm
The dispute will be marked as accepted (Status 69) and moved to Disputes Archived
Records will be created in partial_invoice with negative amounts

Reject Insurance Claim:

Locate the insurance dispute you want to reject
Click Decline
A popup window will open with details
Add Final Comments explaining why the claim is rejected
Click Decline to confirm
The dispute will be marked as rejected (Status 70) and moved to Disputes Archived

Edit Comments:

Locate the dispute for which you want to edit comments
Click Edit comment
Editable fields will become input fields
Modify Warehouse’s Final Comments as necessary
Click Update to save changes or Cancel to discard them

Archive Disputes (Sellers)

If you are a seller (Level 1), you can archive multiple disputes:

Select disputes you want to archive by checking the checkboxes
Use Select All to select all visible disputes on the current page
Click Archive to move selected disputes to Disputes Archived

View Archived Disputes

At the top of the page you’ll find a link to Disputes Archived that allows you to view all disputes that have been resolved or archived.

Rules and Limitations

Automatic Acceptance

60-Day Rule:

Disputes with Status 65 (WH Open) are automatically accepted after 60 calendar days from the report date (BeginDate)
This protects clients by ensuring disputes don’t remain unresolved indefinitely
When automatically accepted, corresponding billing records are created

Transfer to Carrier Insurance

30-Day Rule:

The CarrierInsurance option is only available during the first 30 days from the report date
After 30 days, this option disappears and you can no longer transfer the dispute to insurance
This limitation ensures claims are filed with the carrier within the required timeframe

Action Restrictions

“Pending actions” Message:

If you see the message “Pending actions” instead of action buttons, it means:
- The corrective shipment (OrderID) is not yet in a state that allows actions, OR
- The shipping & handling amount of the corrective shipment has not yet been calculated
Wait until the corrective shipment is complete or the system calculates amounts automatically

Impact on Billing

Dispute decisions directly affect warehouse billing:

Dispute Accepted (Status 66 or 69):

Records are created in partial_invoice and/or partial_invoices_wh with negative amounts
This reduces the amount billed to the client or warehouse
The description includes “Accepted” or “Accepted carrier insurance”

Dispute Rejected (Status 67 or 70):

Records are created in partial_invoices_wh with positive amounts
This maintains the original billed amount
The description includes “Declined” or “Declined carrier insurance”

Transfer to Insurance (Status 68):

Original shipment shipping & handling amount is recorded
carrier_insurance = 'Y' is marked on the dispute
The dispute remains pending administrator or manager decision

Pagination and Records Per Page

Pagination:

Use First, Previous, Next, and Last controls to navigate between pages
You can also click directly on page numbers
Information shows “Records X to Y of Z” to indicate which records you’re viewing

Records Per Page:

Select how many records you want to see per page from the dropdown menu
Available options: 10, 20, 50, 100, 200, 500, or All Records
The system will remember your preference for future visits

Integration with Billing System

Disputes shown in Dispute Verdicts are directly related to:

All Transactions (invoices_whlist.php): Dispute decisions create transactions that appear in All Transactions
Partial Invoices WH: Records created by dispute decisions are stored in partial_invoices_wh
Partial Invoice: For accepted disputes, records are also created in partial_invoice (OMS billing)

💡 Best Practices

Quick Review

Review disputes regularly to avoid automatic acceptance after 60 days. This allows you to make informed decisions instead of automatic acceptances.

Document Decisions

Always add final comments when accepting or rejecting disputes to document the reason for the decision and facilitate communication with clients.

Transfer Timely

If a dispute should be transferred to carrier insurance, do so within the first 30 days to ensure the claim is valid.

Verify Amounts

Carefully review amounts before accepting a dispute to ensure calculations are correct and reflect the actual problem.

Use Status Filters

Use the Status filter to see only disputes that require your attention (Status 65 for warehouse, Status 68 for admin/manager).

Review Complete Details

Always review the problem description and shipment details before making a decision to ensure you have all necessary information.

Troubleshooting

I don’t see any disputes:

Verify that 3PL Billing and 4PL Billing modules are enabled
Make sure there are disputes with appropriate statuses for your user level
Verify that you have listing permissions (CanList)

I can’t accept or reject a dispute:

Verify that the dispute has Status 65 (for warehouse) or Status 68 (for admin/manager)
Make sure the “Pending actions” message doesn’t appear
Verify that the corrective shipment is in a state that allows actions

The CarrierInsurance option doesn’t appear:

Verify that less than 30 days have passed since the report date
Make sure not_carrier_inserance is not marked as ‘ON’
Verify that the report date is after December 13, 2012

Amounts don’t calculate correctly:

Verify that all amount fields are complete
Make sure values are valid numbers
If the problem persists, contact technical support

The dispute doesn’t move to archived:

Verify that the action completed correctly
Review session messages to confirm the action was successful
If the problem persists, contact technical support

Next Steps:

4PL Billing Overview - Understand the complete 4PL billing system
All Transactions - Review all warehouse transactions, including those created by disputes
Statements - Review consolidated account statements that include dispute adjustments
3PL Costs to 4PL - Review specific costs that 3PL warehouses bill you

Related:

Billing Adjustments - Learn about other types of billing adjustments
Disputes (Warehouse Billing) - Understand how disputes are managed from the warehouse perspective