Professional Documents
Culture Documents
Business Requirements Document (BRD) Deductions Management - Phase 1
Business Requirements Document (BRD) Deductions Management - Phase 1
Business Requirements
Document (BRD)
Deductions Management – Phase
1
SIM/Deductions
September 2017
Version X.XX
Kroger
BRD
Document Revisions
Revision Author Date Change
0.1 Lakshmi Jul-01-2017 Draft
1.0 Paul Fagg Jul-18-2017
Approvals
Role Name Title Signature Date
Project Sponsor Dan
Business Owner Brad Royer
Product Manager Paul Fagg Product Manager
System Architect
Development Lead Sanjeev Gautam
User Experience Paul Brooks
Lead
Quality Lead
Content Lead
2
BRD
Introduction
Project Summary
Objectives
Enable suppliers to initiate a deduction claim if the paid amount is less than the invoice amount.
The claims initiated by the supplier go through an approval cycle and upon approval by the
buyer, the claims are processed successfully.
Project Scope
In Scope Functionality
Payments (Phase 1) - All invoices approved by Kroger and sent to VPS (paid/unpaid,
positive/negative invoices)
View; Search; Send Inquiry; Submit Dispute
Disputes (Phase 1) - All claims/disputes created by a supplier (open [supplier not submitted-
supplier view only]/pending/closed)
View; Search; Send Inquiry
0
BRD
Out of Scope Functionality
Invoices (Phase 2) - All invoices received by Kroger but not yet approved for payment
View; Search; Send Inquiry
BH OSD (Phase 2) – All items flagged as Over, Short or Damaged on a CPU/Backhaul loads
Daily feed to SIM w/notifications to designated BH supplier contact
View; Search; Send Inquiry
Acceptance Criteria
Vendors are able to view deductions
Kroger staff are able to view, manage and resolve inquiries or disputes via platform
1
BRD
Business Process Overview
User Roles
Buyer
2
BRD
disputes - can add account numbers and approve disputes - add
disputes
7 PRGX Reviewer
Role Definitions
See File: Kroger DM Project Workflow
o Workflow Rules
o Workflow by Dispute Type
o User Role Permissions
o Alerts
1) Manager
3
BRD
User Stories
ID User Story
As a supplier with an invoice discrepancy, I want to see the details of an invoice, to confirm there
2
is a legitimate reason
As a supplier with an invoice discrepancy, I want to raise an inquiry with the buyer, so I can get
3
further clarity and possibly raise a dispute
As a supplier with an invoice discrepancy, I want to raise a dispute with the buyer, so I can claim
4
the missing funds back
As a supplier raising an invoice dispute, I want to view a disputes details, so I can confirm the
5
details are correct
As a buyer (finance operators clerk/departments) doing the initial review of invoice disputes, I
7
want to review the invoice/dispute details, so I can correctly assign a dispute status
As a buyer (finance manager) approving escalated technical disputes, I want the ability to review
9
and edit the invoice/dispute details, so I can approve and close the dispute efficiently
As a buyer (finance specialist / co-ordinator) , I want the ability to review and edit the
10 invoice/dispute between >=$5k to <$30k in details, so I can approve and close the dispute
efficiently
As a buyer interested in the status of invoice disputes, I want to view progress reports by
11
type/location/supplier, so I can understand how the entity is performing
As a buyer approving disputes, I want to split the payments between cost centers, so they are
13
accounted for correctly
4
BRD
As a buyer (assistant controller) , I want the ability to review and edit the invoice/dispute >=$30k
14
in details, so I can approve and close the dispute efficiently
As a buyer denying disputes, I want the ability to select a denial reason and provide additional
16
backup verbiage and attachments that will be shared with the supplier
17 As a buyer admin, I want to edit master data, so I can keep the user selections up-to-date
5
BRD
Workflow
ID Workflow Description
Processes
High Level View
6
BRD
Workflow / Status
Dispute Status
Resolution Status
Paid
Partial Pay
Denied
Workflow Definitions
See File: Kroger DM Project Configuration Data
o Dispute Types
o Dispute Status
o Resolution Status
o Resolution Reasons
o Dispute Priority
o GL Account Codes (full listing found in See File: Active Accounts)
See File: Kroger DM Project Workflow
o Workflow Rules
o Workflow by Dispute Type
o User Role Permissions
o Alerts
7
BRD
Standard Screens
Supplier Screens
Login Home
Buyer Screens
Login Home
Manage
Tasks Suppliers Invoices Payments Claims Reports
Organization
8
BRD
Functional Requirements
UC 1: As a supplier submitting/settling invoices, I want to know of any invoice payment discrepancies, so I can
investigate the reasons
1. User navigates to ‘Payments’ screen upon logging in as a supplier
2. User should be able to view the following details in Payments screen (see file:DM Fields - Payments):
b. Search menu
c. Action buttons :
3. The table should list all the paid invoices irrespective of claims being associated with these records
5. If there are no claims associated with the invoice , then ‘Claim#’ column will be left blank
6. If invoice is associated with multiple claims , then records will be multiple rows
7. ‘Invoice#’ will be a hyperlink and will display Invoice Details upon clicking
8. ‘Claim#’ will be a hyperlink and will display Invoice Details upon clicking
9
BRD
UC 2: As a supplier with an invoice discrepancy, I want to see the details of an invoice, to confirm there is a
legitimate reason
1. User navigates to ‘Payments’ screen upon logging in as a supplier
2. In the search results table, a user selects an invoice to view by clicking on a ‘Invoice #’ link
3. The invoice number is shown at the top of the screen and the details are shown as follows (see file:DM
Fields – Payment Details):
a. Payment Header
g. Comments
4. The user closes the screen and returns to the previous screen
UC3: As a supplier with an invoice discrepancy, I want to raise an inquiry with the buyer, so I can get further
clarity and possibly raise a dispute
1. User navigates to ‘Payments’ screen upon logging in as a supplier
2. In the search results table, a user selects an invoice to view by clicking on that entries checkbox
4. User clicks on Request Information button and Add Comment screen appears
5. The screen displays any previous comments between the buyer/supplier, for each comment:
a. Username
b. Date of comment
c. Comment text
7. Clicking on Send Request will send a notification to a buyer user, the user then returns to previous screen
10
BRD
8. Clicking on Cancel will cancel the request and return user to previous screen
UC4: As a supplier with an invoice discrepancy, I want to raise a dispute with the buyer, so I can claim the
missing funds back
1. System should be able to support the following :
3. ‘Create Claim’ button should get enabled if one or more invoice records are enabled
4. User should be able to see the pop up with the following fields upon clicking on ‘Create Dispute’
Field Name Field Type Values
Claim Type Single select dropdown AR-Reclamation
CD-Cash Discount
CV-CRV Repays
FR-Freight
LC-List Cost
… (for full list see DM Project
Configuration Data)
Claim Amount Input Text along with a dropdown
to select currency
Chargeback Invoice # Textbox
Additional Comments Text Area
Supporting Documents Table
Document Type Single select dropdown Values
Supporting File Upload
Documents
Action Delete Deletes row entry
User can create new table rows:
‘Add New’ – Single button - Active
5. User should be able to see the following buttons in the pop up :
Button Text Format Values
Save Single Button Active
Save and Submit Single Button Active
11
BRD
Cancel Text Link
6. Clicking on Save will create the claim and the status of the claim will be ‘Open’ and user will be navigated
to previous screen
7. Clicking on Save and Submit will create the claim and the following happens:
iii. Button: OK
8. Clicking on Cancel will cancel the claim creation and user will be navigated to previous screen
9. Claim ID is unique per supplier and will be auto-generated at the time of claim creation
10. User should be able to edit the claim details of those claims that are in ‘Open’ status
UC5: As a supplier raising an invoice dispute, I want to view a disputes details, so I can confirm the details are
correct
1. User navigates to ‘Claims’ screen upon logging in as a supplier
b. Search menu
c. Action buttons :
3. In the search results table, a user selects a claim to view by clicking on a ‘Claim #’ link
4. The claim number is shown at the top of the screen and the details are shown as follows (see file:DM
Fields – Claim Details):
a. Header Information :
12
BRD
e. Associated Discounts (table)
i. Comments
5. The user closes the screen and returns to the previous screen
UC6: As a buyer (finance operators clerk) reviewing supplier inquiries, I want to review the invoice/dispute
details, so I can correctly respond
1. User navigates to inquiry tasks upon logging in as a buyer
2. User should be able to view all the inquiries awaiting response, comments can be associated with
invoices, payments or claims (See File: Kroger DM Fields)
4. User can also view invoice details or payment details by clicking on their respective links in the table
5. If the inquiry is deemed as important, the buyer can flag it as a priority. The flag is only visible to buyer
users
6. The user can respond to an inquiry by adding comments to the comment string, this will be sent to the
supplier
UC7: As a buyer (finance operators clerk) doing the initial review of invoice disputes, I want to review the
invoice/dispute details, so I can correctly assign a dispute status
1. User navigates to ‘Claims’ tasks upon logging in as a buyer
2. System controls claims to be viewed based on workflow rules (see file: Kroger DM Project Workflow).
Routing details found in ‘WF Rules’/’WF by Disp Type’
3. User should be able to view all the claims awaiting approval. (see file:DM Fields - Claims):
a. Search results table
13
BRD
b. Search menu
c. Action buttons
c. Process Claim: Button enabled if one or more claims are selected. Multiple claims can be
processed at once.
5. User can view invoice, payment or claim details by clicking on their respective links in the table.
a. Claim Priority
b. Claim Action
c. Settlement Amount
d. Resolution
e. GL Code
f. Notes(Public)
g. Notes(Private)
h. Action Buttons :
i. Save : The changes will be saved and user will exit out of the pop up
ii. Save and Submit: Details are saved and claim has been processed or submitted for next
level of approval depending on the workflow configuration.
iii. Cancel: will closed the pop up and changes are not saved.
a. If settlement amount is less than claim amount, then message is ‘Settlement Amount is less than
Claim Amount. Resolution Status will be Partial Pay’
14
BRD
b. If settlement amount is greater than claim amount, then message is ‘Settlement Amount cannot
be greater than Claim Amount’
UC8: As a buyer (department facilitator), I want to review designated disputes assigned by Level 2 users or
directly from the system, so I can facilitate their resolution
1. Mirrors UC7. Refer to workflow rules (see file: Kroger DM Project Workflow). Routing details found in
‘WF Rules’/’WF by Disp Type’
UC9: As a buyer (finance manager) approving high value/technical disputes, I want the ability to review and
edit the invoice/dispute details, so I can approve and close the dispute efficiently
1. Mirrors UC7. Refer to workflow rules (see file: Kroger DM Project Workflow). Routing details found in
‘WF Rules’/’WF by Disp Type’
UC10: As a buyer (finance specialist / co-ordinator), I want the ability to review and edit the invoice/dispute
between >=$5k to <$30k in details, so I can approve and close the dispute efficiently
1. Mirrors UC7. Refer to workflow rules (see file: Kroger DM Project Workflow). Routing details found in
‘WF Rules’/’WF by Disp Type’
UC11: As a buyer interested in the status of invoice disputes, I want to view progress reports by
type/location/supplier, so I can understand how the entity is performing
1. User should be able to navigate to Dashboards
c. Dispute by Type
i. Graph depicts the number of claims for each of the claim type as a trend line
ii. Claim Type (x-axis) vs Claim Amount ($) (y-axis) will be displayed as a bar chart
iii. User should be able to view the monthly, quarterly, yearly data
d. Dispute by Warehouse
i. Graph depicts the number of claims for each of the Division/Delivery Centre as a trend
line
15
BRD
ii. DC (Delivery Centre/Division) (x-axis) vs Claim Amount ($) (y-axis) will be displayed as a
bar chart
iii. User should be able to view the monthly, quarterly, yearly data
e. Dispute by Supplier
i. Graph depicts the number of claims for each supplier (top 10/20)
ii. Supplier (x-axis) vs Claim Amount ($) (y-axis) will be displayed as a bar chart
iii. User should be able to view the monthly, quarterly, yearly data
2. User should be able to navigate to Reports
a. Open/unprocessed disputes
b. Total disputes
c. Period-End AP Liability
d. Platform usage
Report Definitions
See File: Kroger DM Reports
o Dashboards
o Reports
UC12: As a buyer responsible for processing supplier inquiries/disputes, I want to be reminded of any aged
actions, so I can close all my assigned tasks
UC13: As a buyer approving disputes, I want to split the payments between cost centers, so they are
accounted for correctly
1. User actions mirrors UC7/UC8/UC9/UC10. Refer to workflow rules (see file: Kroger DM Project
Workflow). Routing details found in ‘WF Rules’/’WF by Disp Type’
a. User has ability to enter multiple account numbers for payment of one dispute. Up to a
maximum of 20 GL Account Codes per payment
b. User can search for and only select GL Account Codes that are related to their account (based on
Warehouse/DC mapping)
c. Where the GL Account Number begins ’03…’ user to complete a subfield ‘Receiver Number’
d. For each GL Account Number added, a dollar amount is to be completed (to 2 decimal places)
16
BRD
3. System checks that the GL Account Number amount totals are exactly equal to the ‘Settlement Amount’
a. If settlement amount is not equal to total of GL Account Number total, then message is
‘Settlement Amount is not equal to total of GL Account Number total. Edit amounts ‘
Chargeback Invoice #
1. Chargeback Invoice # will be entered by Kroger if dispute is denied.
1. High
2. Medium
3. Low
1. Repay
2. Partial Repay
3. Deny
1. Valid Contract
17
BRD
2. Revised Deal
5. Shipment Error
6. Substituted Product
7. Invoice Error
c. Action Buttons :
i. Process Claims : User exits out of the pop up and the claim approval records are cleared
from tasks page
3. When user clicks on ‘Process Claim’, system checks if the settlement amount provided is less than the
claim amount in case of ‘Partial Repay’ selected as Claim Action
a. If some of the claims have have claims have claim amount equal to less than settlement amount,
such claims are listed out and not processed.
Message:
The following Claims do not have Settlement amount less than Claim Amount.
18
BRD
Do you wish to process the remaining claims?
b. Claims which have Settlement amount less than Claim Amount are processed successfully upon
user clicking on Yes
c. The values provided for Claim Priority, Claim Action, Resolution, Settlement and Notes (Public
and Private) are applicable for all the claims
d. The status of the claim changes to ‘Closed’ once the claims are processed successfully
4. System should support configuration of workflow steps as well as auto approval based on data
provided for Claim Type, Claim Amount, Delivery Location and Vendor Type.
Appendices
Glossary of Terms
19
BRD
Related Documents
20