Integrating PrintReleaf with 3manager
PrintReleaf has partnered with 3manager to offer a software integration that automatically and securely synchronizes customer paper consumption data from your 3manager server to PrintReleaf.
On a nightly basis, PrintReleaf performs a data collection process that connects to your 3manager instance via the 3manager Public API. PrintReleaf retrieves and processes paper consumption metrics for each of your customers and deposits the data into the customer’s PrintReleaf account.
At the end of each month, PrintReleaf totals each customer’s paper consumption for that month, equates it to forest impact measured in trees, and issues a Certificate of Reforestation to the customer certifying that their paper consumption has been reforested.
Configuring the Integration
At a high-level, setup of the PrintReleaf/3manager integration involves two parts:
- Registering your 3manager server in your PrintReleaf dashboard
- Connecting customer feeds to map your 3manager customers to their respective accounts in PrintReleaf
You will need the following 3manager credentials to register your server:
- URL: The web URL of your 3manager server (ex: https://app.3manager.com)
- Username & Password: Login credentials for a user on your 3manager server. As a best practice, it is highly recommended you create a new 3manager user specifically for the PrintReleaf integration.
To register your 3manager server in PrintReleaf, you provide the URL of your server and Username & Password credentials that PrintReleaf will use to connect to your 3manager server.
Once your 3manager server is registered in PrintReleaf, you can begin registering individual customer feeds that should be synchronized with your 3manager server.
To register a customer feed, you select the customer’s 3manager Organization from the dropdown menu which is populated with the list of orgs on your 3manager server, the Activation Date, and Sync Settings.
The 3manager Organization is used by PrintReleaf to identify the matching customer in 3manager.
The Activation Date is the date PrintReleaf should begin synchronizing data for this customer; if it is set to a date in the past, PrintReleaf will automatically sync historical data back to that date.
In Sync Settings, you have the option to synchronize paper consumption from all of the customer’s devices, or only devices marked as ‘managed’.
For complete step-by-step configuration instructions, please view the 3manager Integration Setup Guide.
Data Collection & Flow
PrintReleaf’s data collectors will attempt to connect to your 3manager server on a nightly basis to retrieve and process customer paper consumption data. Individual customers are batched and synchronized one after another in a serial fashion.
The duration of a data collection is dependent on a number of factors, including current load on your 3manager server, the number of customers to be synchronized, and network latency due to geographic distance to your server. Most individual customer data collections finish in between 1 and 2 seconds.
Customer data only flows from 3manager to PrintReleaf; PrintReleaf never writes new data to your 3manager server.
3manager Customer Data provided to PrintReleaf
PrintReleaf uses the 3manager Public API to securely connect to your server, authenticate via OAuth 2.0, and retrieve customer paper consumption data. When performing a customer data collection, PrintReleaf calls the Devices API endpoint. The Devices endpoint returns information about the device (e.g. DeviceID and management status) as well as counters for each of the meters on the device. PrintReleaf synchronizes the meter data with its own database, calculates the daily deltas, and deposits the page counts to the customer’s account.
3manager device data fields stored by PrintReleaf:
- DeviceID: Unique identifier for this device supplied by 3manager
- Managed: Device management status
- InitialCount: The initial lifecount on the device recorded the first time it was synced with PrintReleaf
- LatestCount: The most recently recorded lifecount on the device PrintReleaf
- LifeCount: The number of pages since syncing with PrintReleaf (LatestCount–InitialCount)
PrintReleaf does not store any other data about the customer or their devices.
Integration Health Checks
PrintReleaf actively monitors the health of your 3manager integration on two levels: the server level and the feed level.
The server health check is performed by attempting to connect to your 3manager server using the credentials provided during registration. Failed attempts to connect will immediately mark the server as unhealthy and will pause customer data collection until the health check passes again.
At the individual feed level, PrintReleaf monitors the flow of inbound paper consumption data. If the feed has not received new data from 3manager in 3 business days, the feed is marked as unhealthy. This often indicates the DCA is stale. When a feed becomes healthy again, PrintReleaf automatically synchronizes data back in time to when the feed became unhealthy, ensuring paper consumption data is never missed.
In transit, all network traffic to and from PrintReleaf’s web servers, data collectors, and APIs is transmitted via HTTPS. HTTP requests are not permitted. At rest, sensitive data (e.g. server credentials) are encrypted using industry standard hashing functions and ciphers.
Personal Data Security & PII
Still have questions?
Can't find the answer you're looking for? Get in touch with us.
Ready To Make A Difference?
As a Managed Print Services provider, you understand the significance of paper usage, and embracing more sustainable printing practices is becoming a vital part to doing business. Your customers rely on you to ensure smooth operations. Let's explore how PrintReleaf can support your business, deliver added value to your customers, and help you contribute to a greener planet.Start the conversation