Skip to main content
[Integration] PaperCut MF

Learn how to integrate PaperCut MF with OfficeRnD to manage printing access and billing for members.

Updated over a week ago

PaperCut is an on-premises printing solution that runs on your own server. Integrating it with Office RnD involves several steps to ensure seamless operation.

Purpose of the PaperCut integration:

  • Configure rules for ORnD members to access PaperCut devices.

  • Allow members to use their ORnD credentials to authenticate in PaperCut without separate accounts.

  • Enable billing through ORnD for printing jobs.

This integration will help you efficiently manage printing access and billing. This article will help you initiate and configure the integration and understand its available functionalities.


Server configuration

This first step is to ensure your server configuration is ready for our integration.

  1. Set Printers as "Unauthenticated." If “Popup authentication“ is turned off, users cannot authenticate or generate fees.

    1. Open the Printers tab.

    2. Select [Template Printer].

    3. Scroll to Advanced Configuration.

    4. Turn on Unauthenticated printer.

      2faf895d-b186-4aa0-893a-266d7f37f2e5.png

  2. Check printers charging.

    • Ensure pricing is set for each printer to charge members accordingly.

    • Each printer has its own configuration settings.

Integration tool installation and initial sync

The second step is to activate the integration in OfficeRnD and install the integration package on your server.

  1. Activate the integration:

    • Go to Settings > Integrations.

    • Under Printing integrations, activate "PaperCut MF" and open the configuration dialog.

  2. Verify the Server URL and Port: Ensure that the PaperCut server URL and port are correct, as this port is required by PaperCut.

  3. Download the installation package:

    • Click Generate & Download configuration file to download the installation.zip file.

    • If you set a different IP address, update it in the PaperCut server under Options > Advanced > Allowed XML Web Services callers or leave the default "*" configuration:

  4. Create an installation folder:

    • Create a folder on the PaperCut server machine, e.g., C:\OfficeRnD.

    • Unzip the downloaded file in C:\OfficeRnD.

    • The folder structure will look like this:

      5305c691-04d2-4724-b041-ded94f5c9578.png

  5. Run the installer:

    • Run installer.bat as an Administrator and wait for the installation to finish.

    • The installer will:

      • Check for the PaperCut server installation folder.

      • Update PaperCut server configuration automatically.

  6. Finalize the configuration:

    • Go to the Flex Admin Portal and either close the dialog by clicking Save or refresh the page.

    • If there are configuration issues, do either of the following:

      • Click Fix Error to resolve it.

        2b2c3031-0eea-4c01-8763-2f301cfd57a3.png
      • Run the installation file again and check for errors during the installation.

  7. Additional step for PaperCut MF Version 23:

    • You can find the complete instructions here.

    • Open the file located at "C:\Program Files\PaperCut MF\server\security.properties" and edit it like this (if you have installed Papercut in C:\Program Files\PaperCut MF or use the corresponding path) :

    • Save the changes and restart the PaperCut Application Server service.

    • Note: Enable your OS to show file extensions to ensure you edit the correct file.

  8. Configure and sync:

    • In the Flex Admin Portal, click Configure next to PaperCut MF again to see the new integration configuration dialog.

    • The first sync is manual; open the Member Management tab and configure the settings to determine the initial sync.

    • Click Save and then Sync.

      • Note: The sync duration depends on the volume. For example, it may take approximately 20 minutes to sync 5000 members.

    98b1fe56-920f-4e68-a9ce-90b6be7cb9e0.png

  9. Sync details:

    • Companies are synced as Groups.

    • Members of companies are synced as users in those groups.

    • Individual members are synced to a special group called [Individual Member].

  10. Initial sync flows:

    • If the PaperCut database is empty, the sync:

      • Creates all entities matching your Member Management configuration.

    • If you have a PaperCut database, the sync:

      • Removes entries that do not match the Member Management configuration in OfficeRnD.

      • Recreates users matching the Member Management configuration, retaining only their userName and balance.

      • Moves all unmatched users to the group UNLINKED_MEMBERS_TO_OFFICERND.

  11. Balance management:

    • Review current balances and adjust if needed.

    • Negative balances will generate fees in OfficeRnD.

Important notes:

  • If the PaperCut users have Card/Identity numbers associated with their profiles, they will be retained.

  • Members not matched to a PaperCut User will be added to a group called “Members not linked to OfficeRnD”.

  • Members with duplicated emails in Office RnD will not be synced to PaperCut MF.

  • After the initial sync, a warning message will display the emails of members who were not synced:


  • When the integration is activated, a new line is added to the Welcome email for admin users to include information about logging into PaperCut MF with OfficeRnD credentials:

Fee management regular syncs and member balance

The last step is to configure the fee management of the integration and learn how the regular sync works.

Go to Settings > Integrations and click Configure next to "PaperCut MF". In the Configure PaperCut MF dialog, open the Fees Management tan and configure the following settings:

  • Print and Pay: Must be activated for the integration to communicate with PaperCut.

  • Billing Plan for printing fees:

    • When the integration is activated, it automatically creates a Billing Plan in OfficeRnD with the following details:

      • Name: PaperCut fees

      • Price: 0

      • Locations: All

      • Account: One-off Fees

    • Ensure the plan is selected in the One-off plan for printing drop-down menu; if not, select it manually.

  • Member Balance: Configure the balance added to users in PaperCut and the frequency (daily, weekly, monthly). It applies to all members when they are pushed to PaperCut MF.

    • Initial Printing Balance: Set the starting balance for all users during the first sync and for new members pushed to PaperCut MF.

    • Add-on balance: Set daily, weekly, or monthly additions to user balances.

    • Maximum balance: Limit the total available balance for all users to prevent excessive accumulation.

    • Balance visibility:

      • Balances are personal and visible only in each user's PaperCut MF profile.

      • Members cannot view their balance in the Member Portal or Mobile App.

Note:

  • The integration syncs daily at 7:30 AM.

  • It checks user balances in PaperCut.

    • If the balance is negative, a fee is created in OfficeRnD equal to the negative balance.

    • The PaperCut balance is then adjusted to zero by adding the fee amount (for example, if you are at –7, a fee for 7$ is created in OfficeRnD, and then the balance in PaperCut is adjusted by +7$).

  • Optional: To make printing free of charge or manage billing outside of OfficeRnD, select "Do not manage printing fees inside OfficeRnD" in the Configure PaperCut MF dialog.

a97759c9-cc6d-46eb-8893-f8cc48c8f8f3.png

​Printing options

In the Printing Options section, you can make the following setting configurations to change billing and printing options:

Configuration

Behavior

✅ Print and Pay

❌ Do not manage printing fees inside OfficeRnD

  • Users can trigger print jobs regardless of their PaperCut balance.

  • If the PaperCut balance is negative, a fee is created in OfficeRnD for the respective amount.

  • The PaperCut balance is adjusted to zero once the fee is created in OfficeRnD.

❌ Print and Pay

✅ Do not manage printing fees inside OfficeRnD

  • Users must have a PaperCut balance above 0 to trigger print jobs.

  • No fees will be created in OfficeRnD.

✅ Print and Pay

✅ Do not manage printing fees inside OfficeRnD

  • Users can trigger print jobs even if their PaperCut balance is 0.

  • No fees are created in OfficeRnD.

❌ Print and Pay

❌ Do not manage printing fees inside OfficeRnD

  • Users cannot trigger print jobs if their PaperCut balance is 0.

  • Users must have a PaperCut balance above 0.

  • If a balance becomes negative, a fee is created in OfficeRnD, and the PaperCut balance is adjusted to zero.

Using Coins with PaperCut MF integration

If you use the PaperCut MF integration, you can also use Coins to provide monetary allowance to your members. For more information, learn how to set up Printing Credits →

  • Automatic application of Coins:

    • Coins must be associated with the One-off Billing Plan used to create printing fees.

    • The default plan used by the integration is "PaperCut Fees".

  • Behavior based on PaperCut Balance and OfficeRnD Coins:

    • If a member has an available balance in PaperCut and available coins in OfficeRnD:

      • While the PaperCut balance is available, print jobs are deducted from the PaperCut balance.

      • When the PaperCut balance is depleted and becomes negative:

        • A fee equal to the negative balance is created in ORnD.

        • Available coins in Office RnD are automatically applied to cover the fee, partially or fully.

    • If a member does not have an available balance in PaperCut but has coins in OfficeRnD:

      • The member can trigger print jobs, and the PaperCut balance becomes negative.

      • When the negative balance is synced, available coins in Office RnD are automatically applied to cover the fee, partially or fully.

Did this answer your question?