GetSystemEvents

  • Web Service URL: https://[SERVER_ADDRESS]/EventsWS/EventsData.asmx

  • MPS Version: From 5.3.0

Description

This method returns a list of all system events that are pending, awaiting resolution, or ignored according to the requested eventStatusID.

Syntax

public string GetSystemEvents(string dealerName, string dealerUserEmail, string dealerUserPassword, int eventStatusID)

Parameters

  • dealerName: Name of the provider;

  • dealerUserEmail: Email address of the provider user;

  • dealerUserPassword: Encrypted user password;

  • eventStatusID: Indicator of the type of events to be returned.

Parameter

Accepted types

eventStatusID

1 - Pending events

2 - Events awaiting resolution

3 - Ignored events

Return fields

Field

Description

EventID

Event identifier number

EnterpriseID

Company identifier number

EnterpriseName

Company name

WarningID

Event type identifier number

WarningName

Event name. Example: No printed pages, No accounting, etc.

WarningData

This is a number that indicates something about the event. For more information, see the table below.

CreatedDate

Date and hour when the event was identified by the system

CriticalID

Indicates the critical level of this event (according to the provider's rules):
1 - Critical
2 - Moderate
3 - Minor

More details about the type of event:

WarningID

WarninName

WarningData

2

No accounting

1 - No accounting today

2 - No accounting since yesterday

3 or more - Number of days without accounting

3

No printed pages

1 - No pages printed today

2 - No pages printed since yesterday

3 or more - Number of days without printed pages

4

Discrepancy between accounting and meters

Indicates the percentage of divergence

5

Discrepancy between meters and target

Indicates the percentage of divergence

Click here to learn more about the return format.

Possible errors returned

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

Restrictions

  • To execute this method, the user must be assigned to monitor the company to which the desired events belong, have at least restricted permission in the Events Area, and permission for System Events;

  • The method only returns events that the user has permission to view. If you do not have the necessary permissions, the event list will be returned blank.