Support #100
closedBulk GRV Import Wizard User Manual
Description
Bulk GRV Import Wizard --- User Manual¶
Application: Canofy
Workspace: Custom Mil Power
Source Manual: Version 1.1
Purpose: Create multiple CGRNs from a single Bulk GRV Excel
export.
1. Overview¶
The Bulk GRV Import Wizard allows users to upload one consolidated
Bulk GRV .xlsx file exported from Priority ERP, validate its
Documents and item lines against Canofy, select an Insurance Policy, and
create one CGRN for each selected Document.
End-to-end concept¶
Priority ERP
│
│ Bulk GRV .xlsx
▼
┌──────────────────────┐
│ 1. Upload │
│ Choose + Upload File │
└──────────┬───────────┘
▼
┌──────────────────────┐
│ 2. Parse & Group │
│ Validate BOE / Lots │
│ Select Policy/Docs │
└──────────┬───────────┘
▼
┌──────────────────────┐
│ 3. Processing │
│ One Document → CGRN │
└──────────┬───────────┘
▼
┌──────────────────────┐
│ 4. Results │
│ Created / Error / │
│ Duplicate + Retry │
└──────────┬───────────┘
▼
┌──────────────────────┐
│ 5. Done │
│ Open & Verify CGRNs │
└──────────────────────┘
2. Business Objective¶
The wizard replaces repetitive manual CGRN creation with a controlled
bulk process.
WITHOUT WIZARD
GRV 1 ──► CGRN 1
GRV 2 ──► CGRN 2
GRV 3 ──► CGRN 3
...
GRV N ──► CGRN N
WITH BULK WIZARD
One Priority ERP Excel file
│
▼
Parse + Validate
│
┌─────┼─────┐
▼ ▼ ▼
Document A B C
│ │ │
▼ ▼ ▼
CGRN CGRN CGRN
Core rule: one GRV Document produces one CGRN when selected and
successfully processed.
3. Terminology¶
Term Meaning
GRV Goods Receipt Voucher exported from
Priority ERP.
Document One GRV number in the Excel file;
it may contain one or many item
lines.
CGRN Customer Goods Receipt Note created
in Canofy.
BOE Bill of Entry. The Document must be
linked to a BOE that exists in
Canofy.
Lot Number Lot record in Canofy. Each Excel
item line must match its Lot Number
exactly.
Product Master Canofy product/item record
containing the item and lot-related
information.
Insurance Policy Policy selected in Step 2 and
applied to every CGRN in that run.
Bulk GRV File Consolidated Priority ERP .xlsx
export using the DataSheet
worksheet.
Error Report Step 2 report listing problematic
lines and reasons.
Final Report Step 4 report listing the result of
every selected Document.¶
4. Before You Begin¶
Use this checklist before starting:
-
Use the original Bulk GRV
.xlsxexported from Priority ERP. -
The worksheet is named exactly
DataSheet. - Do not add, remove, rename, or move columns.
- Required BOEs already exist in Canofy.
- Product Masters and Lot Numbers are correct.
- Lot Numbers match the Excel values exactly.
- You know the Insurance Policy to use.
- You have permission to create CGRNs.
Important: The Bulk GRV wizard uses a fixed column layout. Unlike
the single GRV-to-CGRN wizard, there is no Mapping Profile to select.
5. Opening the Wizard¶
- Log in to Canofy.
- Open the Custom Mil Power workspace.
- Under PUBLIC, select Custom Mil Power.
- In Quick Access, select Bulk GRV Import Wizard.
Canofy
└── Custom Mil Power
└── Quick Access
└── Bulk GRV Import Wizard
Do not confuse this with GRV to CGRN Import Wizard or Inventory
Move Import Wizard. The Bulk GRV wizard is intended for multiple
Documents in one file.
6. Step 1 --- Upload¶
Goal¶
Upload the Bulk GRV Excel file.
Procedure¶
- Click Choose .xlsx File.
- Select My Device.
- Choose the Bulk GRV
.xlsxfile. - Drag-and-drop can also be used.
- Check the file name and size.
- Keep Private selected.
- Click Upload.
- Wait for the green tick.
- Click Upload & Parse →.
Privacy rule¶
Keep the uploaded file private.
Do not click
Set all public. The Bulk GRV file contains business
data and should remain private.
What happens next?¶
The wizard reads the Excel file, groups rows by Document, and opens Step
2.
Excel rows
│
├── CR26001105
│ ├── Line 1
│ └── Line 2
│
├── CR26001106
│ └── Line 1
│
└── CR26001107
├── Line 1
└── Line 2
↓
CR26001105 → 1 CGRN
CR26001106 → 1 CGRN
CR26001107 → 1 CGRN
Resume an existing import¶
If an import was left incomplete, use Resume an existing import
instead of uploading the same file again. The manual states that
progress can be resumed without losing the existing processing state.
7. Step 2 --- Parse & Group Preview¶
Goal¶
Review the parsed data, choose the Insurance Policy, and select the
Documents to process.
No CGRN is created at this stage.
7.1 Summary Cards¶
The top of Step 2 displays:
Card Meaning
Total Documents Number of GRV Documents found.
Total Lines Total item lines in the file.
Valid Lines that passed validation.
Errors Lines with a problem.
Unassigned Lines that could not be linked to a BOE.
A healthy example is:
Total Documents : 8
Total Lines : 78
Valid : 78
Errors : 0
Unassigned : 0
The summary also indicates how many Documents are ready, blocked,
unassigned, and selected.
Preferred validation result:
Valid = Total Linesand
Errors = 0.
8. Insurance Policy¶
The Insurance Policy is mandatory.
Procedure¶
- Click the Insurance Policy field.
- Type part of the policy number.
- Select the correct policy.
- Confirm that the policy appears in the field.
Important rule¶
The selected policy applies to every CGRN created in the run.
Insurance Policy
│
┌───────────┼───────────┐
▼ ▼ ▼
CGRN 1 CGRN 2 CGRN N
If different Documents require different policies, process them in
separate runs.
9. Document Selection¶
Selection controls¶
Control Function
Select All Ready Selects every ready Document with
no errors.
Deselect All Clears all selections.
Download Error Report Downloads problem lines and
reasons.
Next: Start Processing → Starts CGRN creation for selected
Documents.
← Back Returns to Step 1.¶
The Error Report control is disabled when there are no errors and the
interface displays ✓ No errors.
10. Document List¶
The Step 2 table contains:
Column Meaning
Include Whether the Document will be processed.
Document No GRV Document number.
BOE No Bill of Entry number.
BOE Resolved Whether the BOE was found in Canofy.
Lines Number of item lines.
Valid / Errors Valid and problematic line counts.
Lot Matched Number of lines matching Canofy Lot Numbers.
Status Overall readiness of the Document.
11. Document Statuses¶
Pending¶
All lines are valid and the Document is ready.
Action: Keep selected if it should be processed.
Pending — Lot Issues¶
At least one line does not have an exact Lot Number match in Canofy.
Action:
- Download the Error Report.
- Identify the BOE, item, and Lot Number.
- Correct the relevant Canofy data.
- Upload the Excel again.
- Confirm the Document becomes
Pending.
The manual notes that although this status can be selected, it will most
likely fail during Step 4.
Blocked — BOE Not Found¶
The BOE in the Excel file was not found in Canofy, or the BOE number
differs.
The selection checkbox is disabled.
Action: Correct/create the BOE or correct its number in Canofy, then
upload the Excel again.
(Unassigned)¶
A line could not be linked to a BOE.
Action: Check the BOE number in the Excel file and Canofy. If the
Excel value is missing, obtain a corrected Priority ERP export.
12. Important Validation Rule¶
One bad line affects the entire Document because one CGRN is created for
the whole Document.
CR26001112
│
├── Line 1 ✓
├── Line 2 ✓
├── Line 3 ✓
├── ...
├── Line 70 ✓
├── Line 71 ✗ Lot issue
└── Line 72 ✓
↓
Entire Document
Pending — Lot Issues
The wizard does not edit individual lines.
Golden rule: Fix the data in Canofy, not in the wizard.
13. Start Processing¶
Before clicking Next: Start Processing →:
- Insurance Policy is selected.
- Intended Documents are ticked.
- Error Report has been reviewed if errors exist.
- Selected Document count is correct.
Then click Next: Start Processing →.
14. Step 3 --- Background Processing¶
Goal¶
Allow the wizard to create CGRNs.
The wizard creates one CGRN for each selected Document, one Document at
a time.
Selected Documents
│
▼
Document 1 → CGRN 1
│
▼
Document 2 → CGRN 2
│
▼
Document 3 → CGRN 3
│
▼
...
The progress line shows the current Document, for example:
Processing Document 1 of 8...
Each Document starts as Pending and changes as processing progresses.
The CGRN column is populated when a CGRN is available.
During processing¶
Do: - Wait for completion. - Allow several minutes for large
files. - Resume later if necessary.
Do not: - Upload the same file again while processing is running.
Resume¶
The manual states that it is safe to leave the process and return later.
Open the wizard and select Resume an existing import.
15. Step 4 --- Results¶
Goal¶
Review what was created and retry failed Documents.
The Results page provides:
- Created count
- Error count
- CGRN number
- Error message
- Retry controls
- Final Report
Controls¶
Button Function
Retry All Failed Reprocesses only Documents with Error status.
Retry Reprocesses one failed Document.
Download Final Report Downloads the result report for the run.
Next → Moves to Step 5.
Retry All Failed is disabled when there are no errors.
16. Understanding Results¶
Created¶
A CGRN exists for the Document.
Document
↓
Created
↓
CGRN number shown
Error¶
A problem occurred while creating the CGRN.
Error
↓
Read Error Message
↓
Fix Canofy data
↓
Retry
Duplicate¶
A CGRN already existed for that Document.
The wizard does not create another copy. It displays the existing CGRN
number.
If every row shows Duplicate, verify whether the same file was imported
previously.
17. Step 4 Error Handling¶
For a Document with Error status:
- Read the Error Message.
- Fix the underlying data in Canofy.
- Return to the wizard.
- Click Retry on that row or Retry All Failed.
- Confirm that the status changes to Created and a CGRN number is
shown.
For Step 4 errors, the manual states that the Excel file does not need
to be uploaded again. Fix the Canofy data and retry.
18. Step 5 --- Done¶
Goal¶
Open and verify the generated CGRNs.
The page displays:
- Overall success message.
- Document-to-CGRN mapping.
- Clickable CGRN numbers.
- Start New Import.
Example:
✓ 8 of 8 Documents created successfully
CR26001105 → CGRN-2026-000060
CR26001106 → CGRN-2026-000061
CR26001107 → CGRN-2026-000062
...
Verify the CGRNs¶
Click a CGRN number. It opens in a new browser tab.
Check:
- Item details
- Quantities
- Lot Numbers
- Insurance Policy
Documents that were marked Duplicate in Step 4 are also listed here with
the existing CGRN.
19. Error Resolution Workflow¶
STEP 2
│
Validation problem?
┌────┴────┐
YES NO
│ │
▼ ▼
Download Report Continue
│
▼
Identify Document
/ BOE / Item / Lot
│
▼
Fix data in Canofy
│
▼
Upload Excel again
│
▼
Recheck Step 2
│
▼
Processing
│
▼
STEP 4
│
Error result?
┌────┴────┐
YES NO
│ │
▼ ▼
Fix Canofy data Done
│
▼
Retry
20. Fixing Lot Number Issues¶
A Lot Number must match exactly.
Examples:
Excel Canofy Result
LOT001 LOT001 ✓
LOT001 LOT 001 ✗
LOT001 lot001 ✗
LOT001 LOT0010 ✗
LOT001 LOT01 ✗
Differences such as extra spaces, missing leading zeros, different
capitalization, or incorrect characters can cause a mismatch.
Procedure¶
- Download the Error Report.
- Note the BOE, item, and Lot Number.
- Open the BOE in Canofy.
- Check the BOE item lines.
- Compare the Lot Number with the Excel line.
- Open the relevant Product Master.
- Check item and lot information.
- Correct the Canofy data.
- Save.
- Upload the same original Excel file again.
- Confirm:
Status = PendingErrors = 0Lot Matched = Lines
Do not modify Excel columns to force a Lot Number match. If the
Priority ERP export itself is incorrect, obtain a corrected export.
21. Fixing Blocked — BOE Not Found
¶
Procedure¶
- Note the BOE number shown in Step 2.
- Search for the BOE in Canofy.
- If it does not exist, create or complete it.
- If it exists with a different number, correct the relevant data so
it matches the Excel value. - Save.
- Upload the Excel again.
Blocked — BOE Not Found
│
▼
Search BOE
│
┌───┴────┐
▼ ▼
Missing Exists
│ │
▼ ▼
Create/ Check number
complete │
│ ▼
└──► Correct if needed
│
▼
Save
│
▼
Upload again
22. Fixing Unassigned Lines¶
Unassigned lines cannot be linked to a BOE.
Check¶
- BOE No in the Excel row.
- Matching BOE in Canofy.
- Exact BOE number.
- If BOE No is missing in Excel, obtain a corrected Priority ERP
export. - Upload again.
23. Troubleshooting¶
Problem Likely Reason What to Do
Upload & Parse is grey No file uploaded. Choose the .xlsx,
upload it, and wait for
the green tick.
File does not read Wrong file, wrong sheet Use the original
correctly name, or changed Priority ERP export and
columns. preserve the layout.
Pending --- Lot Issues Lot Number does not Download Error Report,
exactly match Canofy. fix BOE/Product Master
data, upload again.
Blocked --- BOE Not BOE missing or number Create/correct BOE in
Found differs. Canofy and upload
again.
Unassigned lines Lines cannot be linked Check BOE No in Excel
to a BOE. and Canofy.
Cannot move past Step 2 Insurance Policy Select a policy and at
missing or no Document least one Document.
selected.
Download Error Report There are no errors. No action required;
is grey ✓ No errors is shown.
Error in Step 4 Data problem during Read message, fix
CGRN creation. Canofy data, Retry.
Duplicate message CGRN already exists. No action required;
existing CGRN is
displayed.
Page closed during Browser tab was Reopen wizard and
processing closed/refreshed. choose Resume an
existing import.¶
24. Best Practices¶
Input¶
- Always use the original Priority ERP export.
- Never rename
DataSheet. - Never change the column layout.
Master Data¶
Before upload, ensure:
BOE
├── Correct BOE number
├── Correct item lines
└── Correct Lot Numbers
│
▼
Product Master
│
▼
Ready for Import
Processing¶
- Select the correct Insurance Policy.
- Remember that one policy applies to the whole run.
- Download the Error Report whenever errors exist.
- Fix problems in Canofy rather than trying to modify the wizard input
structure. - Do not upload the same file while processing is active.
Verification¶
After every run:
- Download and retain the Final Report.
- Open a few CGRNs.
- Verify items.
- Verify quantities.
- Verify Lot Numbers.
- Verify Insurance Policy.
25. Operational Decision Tree¶
START
│
▼
Original Priority ERP .xlsx?
│
├── NO → Obtain original export
│
└── YES
│
▼
DataSheet + unchanged layout?
│
├── NO → Use correct export
│
└── YES
│
▼
Upload & Parse
│
▼
Review Step 2
│
┌────┼──────────────┐
▼ ▼ ▼
Ready Lot Issues BOE/Unassigned
│ │ │
│ └──────┐ └──────┐
│ ▼ ▼
│ Fix Canofy Fix BOE data
│ │ │
│ └──────┬───────┘
│ ▼
│ Upload again
│
▼
Select Insurance Policy
│
▼
Select Documents
│
▼
Start Processing
│
▼
Review Results
│
┌───┴────────────┐
▼ ▼
Created Error / Duplicate
│ │
│ ┌─────┴─────┐
│ ▼ ▼
│ Error Duplicate
│ │ │
│ ▼ ▼
│ Fix + Retry Existing CGRN
│
└──────────┬───────────┘
▼
Step 5
│
▼
Verify CGRNs
26. Quick Reference¶
Step User Action Main Control
1 --- Upload Choose and upload Bulk Upload & Parse →
GRV .xlsx
2 --- Preview Review validation, Next: Start
choose Insurance Processing →
Policy, select
Documents
3 --- Processing Wait for CGRN creation Automatic
4 --- Results Review, retry errors, Next →
download report
5 --- Done Open CGRNs or start Start New Import
another import¶
27. Operational Rules¶
Rule Requirement
Input Original Priority ERP .xlsx
Worksheet DataSheet
Layout Fixed; do not alter columns
Processing unit Document
Output One CGRN per selected Document
BOE Must exist and match
Lot Number Must match exactly
Insurance Policy Required; one policy per run
Step 2 errors Fix data and upload again
Step 4 errors Fix data and Retry
Duplicate Existing CGRN is shown; no second copy is created
Error Report Step 2 diagnostic report
Final Report Step 4 result report
Verification Check resulting CGRNs in Step 5
28. Support Checklist¶
If an issue remains unresolved, contact the system administrator/support
team and provide:
- Document No
- Error Report, if applicable
- Final Report, if applicable
- Screenshot of the affected screen
- Exact Error Message
This information helps identify whether the issue relates to the
Document, BOE, item, Lot Number, or CGRN creation stage.
29. End-to-End Success Criteria¶
✓ Original Priority ERP file used
✓ DataSheet preserved
✓ Column layout unchanged
✓ Documents parsed
✓ BOEs resolved
✓ Lot Numbers matched
✓ Insurance Policy selected
✓ Intended Documents selected
✓ CGRNs created or existing CGRNs identified
✓ Errors resolved or retried
✓ Final Report downloaded
✓ Resulting CGRNs verified
Source Coverage¶
This Markdown guide is derived from the supplied Bulk GRV Import
Wizard --- User Manual, Version 1.1, including its five-step workflow,
screen instructions, status definitions, error-resolution procedures,
troubleshooting table, best practices, and quick-reference flow.
Files