Bulk Documents

Bulk Documents

Use Bulk Documents to upload many employee documents at once, such as signed contracts for everyone or one memo to a whole team. You list each document in a worksheet, zip it with the files, and KAMI attaches each file to the right employee's profile. The same page lets you find, download and delete documents across all employees.

Where:

  • My Team › Tools & Reports › Bulk Documents
  • My Team › Settings, under Bulk tools › Bulk Documents

You need:

  • The Document Access (Public) right to open the page
  • The Add Document right: read to export the list, write to upload and download
  • The Delete Document right to delete

Which tool, when

You haveUse
Many finished files to attach to employeesBulk Documents
Files you need employees to upload themselvesDocument Requests, via Request documents on this page
One letter to fill in with each employee's detailsDocument Templates
A policy everyone must read and acknowledgePolicy Center
One file for one personUpload it on their profile

How to upload documents in bulk

  1. On the Bulk Documents page, select Bulk Upload.
  2. Select Bulk Doc Template. This downloads a worksheet called Profile_Documents_Upload.xlsx. Do not rename it.
  3. Add one row per document, using the columns in the table below.
  4. Put the worksheet and all the files in one folder, then compress the folder to a .zip file of up to 100 MB. On Windows, right-click and choose Send to › Compressed folder. On a Mac, right-click and choose Compress.
  5. Select Upload .zip and choose your file.
  6. Select Upload.
  7. Wait for the Data Import email, and read it. It says whether the import worked and lists any errors by row.

The Bulk Document Upload window: the Bulk Doc Template button and the place to upload the .zip file

What goes in the worksheet

ColumnRequiredWhat to enter
EmployeeIDYesThe employee's ID in KAMI
Document NameYesThe name shown on the profile
Document DescriptionNoAnything that helps people find it
Document TypeYesA document type in your company, such as Personal or Employment, or one you added under Document Types on the Document Templates page. Upper and lower case don't matter
Document AccessYesConfidential, Private, Public or Restricted
Document Start DateNoWhen the document starts to apply
Document End DateNoWhen it expires. It can't be before the start date
File NameYesThe file's exact name in the .zip, including its extension
Require ExecutionNoSet to true to have the employee sign it. The file must be a .pdf or .docx. A .docx has its KAMI fields filled in and is turned into a PDF

To send one document to many people, add one row per employee and use the same File Name on each row. The .zip only needs one copy of the file.

How to find documents

The list shows each document's Name, Document, Type, Upload Date and Expiry Date. Click a row to open the document.

  • Search by name.
  • Filters narrows by Status (Pending Approval, Completed, Declined by Approver, To Execute, Pending Execute, To Consent, Rejected by Signatory), Access, Type, Department, Branch, Position, Subsidiary and Cost Centre. Clear removes them.
  • Date range picks which date to filter on: By Valid From Date, By Submission Date, By Approval Date or By Valid To Date, with a start and end date.

With nothing to show it says "No records found matching your criteria."

How to download or delete documents in bulk

  1. Search or filter the list.
  2. Tick the documents you want, or Select on the page. You can select up to 60 at a time; KAMI tells you when you reach the limit. Deselect all clears them.
  3. Select Bulk Download or Bulk Delete.

Bulk Download shows the documents and their total size, with a box to leave any out, and gives you a .zip with a folder per employee. More than 30 documents are prepared in the background and sent to your Download Center instead.

Export prepares the list of documents as a spreadsheet in the background. It appears in your Download Center.

What Happens Next

  • If any row fails the checks, nothing is saved. A wrong EmployeeID, an unknown Document Type or a File Name missing from the .zip rejects the whole upload. Fix the rows listed in the email and upload the .zip again.
  • Uploaded documents are approved straight away. They do not go through document approval, so check them before you upload.
  • Documents with Require Execution are also set up for signature. See Sending a document for signature.
  • You can see every upload under Import History on the Company Bulk Data page.

Tips

  • Test with five files before doing two hundred. A naming mismatch found on five costs minutes.
  • Copy file names, do not retype them. Upper and lower case must match exactly.
  • Get the Document Type and Document Access right at upload. A contract marked Public can be seen far more widely than you intended.
  • Check a few profiles by eye afterwards. A row misaligned in the spreadsheet attaches everyone's contract to their neighbour, and nothing in the process will tell you.
  • Check the profiles before uploading the same .zip twice. Each successful upload creates new documents, so you would get duplicates. If an upload ended in an error email, look at a few profiles first: some rows may already be there.

Troubleshooting / FAQ

Q: How do I send a document to everyone? Add one row per employee in the worksheet with the same File Name, then upload the .zip. To have them acknowledge it as well, use the Policy Center.

Q: I uploaded the .zip and no documents appeared. Read the Data Import email. If one row was wrong, nothing was saved.

Q: It says there is no file named Profile_Documents_Upload.xlsx. The worksheet was renamed or left out of the .zip. Put it back under that exact name.

Q: A .doc file with Require Execution was rejected. Only .pdf and .docx can be signed. Save it as one of those.

Q: Documents attached to the wrong people. A row was misaligned in the worksheet. Delete them with Bulk Delete, correct the worksheet and upload again.

Q: I can't see Bulk Upload. You need the Add Document right with write access. See User rights and access control.

Related articles