GetReferenceCountersData

Web Service URL: https://[SERVER_ADDRESS]/CountersWS/CountersData.asmx [ GLOBAL ]  [ GLOBAL2 ]  [ USA ] [ EURO ]
MPS Version: From 5.9.0.

Description

This method returns the reference counters for printers according to the rules configured in the MPS interface.

Syntax

public string GetReferenceCountersData(string dealerName, string dealerUserEmail, string dealerUserPassword, string dateTimeEnd, int maxLimitDaysEarlier, string enterpriseName, string serialNumber, string siteName, string siteDivisionName, bool engaged, string fieldsList)

Parameters

• dealerName: Name of the provider;

• dealerUserEmail: Email address of the provider user;

• dealerUserPassword: Encrypted user password;

• dateTimeEnd: End date for which you want to retrieve the counters (format yyyy-MM-dd HH:mm:ss);

• maxLimitDaysEarlier: Maximum number of days to consider;

• enterpriseName: Name(s) of the company(ies) from which the printer counters will be retrieved. A single company can be specified to retrieve only the counters for printers belonging to that company; it can be left blank to retrieve printer counters without filtering by company; or a list of companies separated by semicolons (;) can be specified to retrieve only the counters for printers belonging to those companies. Example: Comp1;Comp2;Comp3;

• serialNumber: Serial number(s) of the printer(s) from which the counters will be retrieved. A single serial number can be entered to search only for counters for the printer containing this serial number; it can be left blank to retrieve counters without filtering by serial number; or a list of numbers separated by semicolons (;) can be entered to search only for counters for printers containing the serial numbers entered. Example: SNImp1;SNImp1;SNImp1;

• siteName: Name(s) of the site(s) where printer counters will be retrieved. You can enter a single site to retrieve only the counters for printers belonging to that site; you can leave it blank to retrieve printer counters without filtering by site; or you can enter a list of sites separated by semicolons (;) to retrieve only the counters for printers belonging to those sites. Example: Site1;Site2;Site3;

• siteDivisionName: Name(s) of the department(s) where printer counters will be retrieved. You can enter a single department to search only for printer counters belonging to that department; it can be left blank to bring up counters without filtering by your department; or you can enter a list of departments separated by semicolons (;) to search only for printer counters belonging to those departments. Example: Depart1;Depart2;Depart3;

• engaged: When set to true, it brings only the counters of contract printers, including printers with no movement in the specified period. When set to false, it brings up the counters for all printers;

• fieldsList: List of fields that will be returned by the method. They must be specified by separating them with the character ‘;’. Example: PrinterDeviceName;SerialNumber;AddressName.

 Fields recognized in fieldsList

Example of return received

Click here to learn more about the format of returns.

Possible errors returned

Click here to check the possible errors that may be returned and learn about their reasons.

Restrictions

The method only returns the counters of the printers that the user is allowed to view, that is, the user must monitor the company or site to which the printer whose counters they want to view belongs.