EVRWResultInformation Structure (POS for .NET v1.14.1 SDK Documentation)
4/4/2017
Defines a programmatic structure used to contain the tag name/value information returned by RetrieveResultInformation.
Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)
Syntax
'Declaration
Public Structure EVRWResultInformation
public struct EVRWResultInformation
public value class EVRWResultInformation
public final class EVRWResultInformation extends ValueType
Remarks
The following table defines the valid tag names as specified by the Unified Point of Service (UnifiedPOS) v1.14.1 international standard:
Tag name |
Format |
Description |
AccessLogLastDateTime |
Datetime |
The time that the last transaction log was obtained. |
AccountNumber |
String |
The account ID for the electronic value service. |
Amount |
Currency |
The payment amount on the electronic money service |
AmountForPoint |
Currency |
The amount targeted for calculating points. The amount is specified when the electronic value reader/writer device calculates the point values to be added at the same time as settlement, but there are some products not targeted for points. |
AuthenticationStatus |
Enumerated |
Indicates the authentication status:
ValueDescription
EVRW_TAG_AS_AUTHENTICATEDAuthenticated
EVRW_TAG_AS_UNAUTHENTICATEDUnauthenticated
|
AutoCharge |
Boolean |
If “True”, indicates a request to conduct an automatic charge at the time of issuing a method, or the result of an automatic charge at the time of completing the process. |
Balance |
Currency |
The balance of the electronic value service. |
BalanceOfPoint |
Currency |
The balance of the point service. |
BusinessUnitID |
String |
The ID value for a store. |
CardCompanyName |
String |
The name of the company issuing the electronic value media (card or mobile phone), |
CardTransactionNumber |
Number |
The transaction number. This value is assigned and controlled by the electronic value service media (card or mobile phone). |
ChargeableAmount |
Currency |
The amount for which charging is possible. |
ChargeableCount |
Number |
How many times charging is possible. |
ChargeMethod |
Enumerated |
Indicates the method to charge an electronic value service, either cash or exchanging points:
ValueDescription
EVRW_TAG_CM_CASHCharge as cash
EVRW_TAG_CM_CREDITCharge as credit
EVRW_TAG_CM_POINTCharge as points
|
DateTime |
Datetime |
The time that a method was issued, an event was notified, or a process was completed. |
EffectiveDaysOfKey |
Number |
The number of days the Key value is effective. |
EndAccountID |
String |
The ending point specified by an account ID when requesting closing or summary to the electronic value reader/writer. |
EndDateTime |
Datetime |
The ending point specified by a date time when requesting closing or summary to the electronic value reader/writer. |
EndEVRWTransactionNumber |
Number |
The ending point number specified by the reader/writer transaction sequential number when requesting closing or summary to the electronic value reader/writer. |
EndPOSTransactionNumber |
Number |
The ending point number specified by a POS transaction number when requesting closing or summary to the electronic value reader/writer. |
EVRWApprovalCode |
String |
The approval code for processing. This value is assigned and controlled by the electronic value reader/writer. |
EVRWDateTime |
Datetime |
The date time managed by the electronic value reader/writer. |
EVRWID |
Number |
The ID of the electronic value reader/writer. |
EVRWTransactionLogID |
String |
The ID for transaction details stored in the electronic value reader/writer. |
EVRWTransactionNumber |
Number |
The transaction number. This value is assigned and controlled by the electronic value reader/writer. |
ExpirationDate |
Datetime |
The expiration date of the medium. |
ExpiredAccountID |
String |
The description provided when information is held for an account already expired in the electronic value service media (card or mobile phone). |
ForceOnlineCheck |
Boolean |
If “True”, indicates that there is a request to force the center to check online at the time of settlement. |
InsufficientAmount |
Currency |
Indicates the insufficient amount when the balance is found insufficient by the electronic value reader/writer. |
ItemCode |
String |
The item code for the product being handled in the settled transaction. |
KeyExpirationDateTime |
Datetime |
The time when the Key expires. |
KeyUpdateDateTime |
Datetime |
The time when the Key was last updated. |
LastTimeBalance |
Currency |
The balance before settlement. |
LastTimeCardTransactionLogID |
String |
The ID for the last time transaction details stored in the electronic value service media (card or mobile phone). |
LastTimeEVRWTransactionLogID |
String |
The ID for the last time transaction details stored in the electronic value reader/writer. |
LastUsedDateTime |
Datetime |
The most recent used date time of the medium. |
LogCheck |
Boolean |
If “True”, indicates to check the transaction log when voiding the settlement. |
MediaData |
String |
Information data for electronic value media (card or mobile phone) that is not related to POS. The content can be freely set by service providers or vendors. |
MediumID |
Number |
The ID for electronic value service media (card or mobile phone). |
MediumIssuerInformation |
String |
The information on the issuer of the medium. |
MerchantID |
String |
The merchant identification information. |
ModuleID |
Number |
The ID for individual settlement modules or applications that exist in the electronic value reader/writer that provides multiple services. |
NegativeInformationType |
Enumerated |
The value indicating the type of negative transaction information.
ValueDescription
EVRW_TAG_NIT_ALLFull list of negative settlement information.
EVRW_TAG_NIT_UPDATEDUpdated list of negative settlement information.
|
NegativeInformationUpdateTime |
DateTime |
The time when the negative information of the EVR/W was updated. |
NumberofAddition |
Number |
The number of charge settlement transactions. |
NumberofEVRWTransactionLog |
Number |
The number of transaction details stored in the electronic value reader/writer. |
NumberOfFreeEVRWTransactionLog |
Number |
The number value of free space for transaction details stored in the electronic value reader/writer. |
NumberOfRecord |
Number |
The number of records. |
NumberofSentEVRWTransactionLog |
Number |
The number of transaction details that are stored in the electronic value reader/writer and have been sent to the settlement center. |
NumberOfSubtraction |
Number |
The number of settlement transactions. |
NumberOfTransaction |
Number |
The total number of transactions. |
NumberOfUncompletedAddition |
Number |
The number of transactions uncompleted due to communication errors between the electronic value reader/writer and electronic value media (card or mobile phone) during the charge settlement transaction. |
NumberOfUncompletedSubtraction |
Number |
The number of transactions uncompleted due to communication errors between the electronic value reader/writer and electronic value media (card or mobile phone) during the settlement transaction. |
NumberOfUncompletedVoid |
Number |
The number of transactions uncompleted due to communication errors between the electronic value reader/writer and the electronic value media (card or mobile phone) while voiding transactions. |
NumberOfVoid |
Number |
The number of voided transactions. |
OtherAmount |
Currency |
The amount for extra payment when used for the transaction together with a regular settlement. |
PaymentCondition |
Enumerated |
Indicates the type of payment for the settlement amount in case of post-pay type electronic value services:
ValueDescription
EVRW_TAG_PC_INSTALLMENT_2Installment 2
EVRW_TAG_PC_INSTALLMENT_3Installment 3
EVRW_TAG_PC_BONUS_1Bonus 1
EVRW_TAG_PC_BONUS_2Bonus 2
EVRW_TAG_PC_BONUS_3Bonus 3
EVRW_TAG_PC_BONUS_4Bonus 4
EVRW_TAG_PC_BONUS_5Bonus 5
EVRW_TAG_PC_BONUS_COMBINATION_1With extra payment by bonus 1
EVRW_TAG_PC_BONUS_COMBINATION_2With extra payment by bonus 2
EVRW_TAG_PC_BONUS_COMBINATION_3With extra payment by bonus 3
EVRW_TAG_PC_BONUS_COMBINATION_4With extra payment by bonus 4
EVRW_TAG_PC_INSTALLMENT_1Installment 1
EVRW_TAG_PC_LUMPLump-sum
EVRW_TAG_PC_REVOLVINGRevolving
|
PaymentDetail |
String |
The type of payment for the settlement amount in case of post-pay type electronic value services. |
PaymentMethod |
Enumerated |
Indicates the type of settlement of the transaction amount required by the electronic value reader/writer:
ValueDescription
EVRW_TAG_PM_COMBINEDSettlement combined with other payment
EVRW_TAG_PM_FULL_SETTLEMENTFull settlement
|
PaymentMethodForPoint |
Enumerated |
Indicates the settlement method to be used for calculating points:
ValueDescription
EVRW_TAG_PMFP_CASHCash
EVRW_TAG_PMFP_CREDITCredit
EVRW_TAG_PMFP_EMElectronic money
EVRW_TAG_PMFP_OTHEROther
|
Point |
Number |
The point value requested to the electronic value reader/writer from POS. |
POSDateTime |
Datetime |
The time of accounting managed by POS. |
POSTransactionNumber |
Number |
Sequential number that identifies the POS transaction. |
RegistrableServiceCapacity |
Number |
The quantity of services that can be registered. |
RequestedAutoChargeAmount |
Currency |
The amount requested for automatic charge. |
ResponseCode1 |
Number |
The primary result code for processing. This value can be freely set by service providers or vendors. |
ResponseCode2 |
Number |
The primary result code for detailed processing. This value can be freely set by service providers or vendors. |
ResultOnSettlement |
Enumerated |
Indicates the result status of the settlement transaction between the electronic value reader/writer and the electronic value media (card or mobile phone):
ValueDescription
EVRW_TAG_ROS_NGAbnormal termination
EVRW_TAG_ROS_OKNormal termination
EVRW_TAG_ROS_UNKNOWNUnidentified
|
RetryTimeout |
Number |
The amount of time, in milliseconds, when it is necessary to retry processing between the electronic value reader/writer and the electronic value media (card or mobile phone) after the electronic value media was last connected with the electronic value reader/writer. |
SettledAmount |
Currency |
The amount actually settled with the electronic value reader/writer. |
SettledAutoChargeAmount |
Currency |
The automatic charge value actually settled by the electronic value reader/writer. |
SettledMemberInformation |
String |
The member information in the membership certificate after it has been updated. |
SettledOther-Amount |
Currency |
The actual amount of extra payment when an electronic value service is used with other settlement methods. |
SettledPoint |
Number |
The point value actually settled by the electronic value reader/writer. |
SettlementNumber |
Number |
The sequential number for the clearing process. |
SignatureFlag |
Boolean |
Indicates if it is necessary to sign after the settlement or not. |
SoundAssistFlag |
Boolean |
If “True”, indicates to activate voice navigation. |
StartAccountID |
String |
The starting point specified by an account ID when requesting closing or summary to the electronic value reader/writer. |
StartDateTime |
Datetime |
The starting time when requesting closing or summary to the electronic value reader/writer. |
StartEVRWTransactionNumber |
Number |
The starting point number specified by the reader/writer transaction sequential number when requesting closing or summary to the electronic value reader/writer. |
StartPOSTransactionNumber |
Number |
The starting point number specified by a POS transaction number when requesting closing or summing to the electronic value reader/writer. |
SummaryTermType |
Enumerated |
Indicates the term for the summary process.
ValueDescription
EVRW_TAG_STT_1From the previous type of summary result to current
EVRW_TAG_STT_2From the summary result before the previous type of result to the previous summary result
EVRW_TAG_STT_3From the summary result two times before the previous type of summary result to the summary result before the previous result
|
TaxOthers |
Currency |
Tax and other currency amounts included in the required settlement amount. |
TotalAmountOfAddition |
Currency |
The total amount of charge settlement transactions. |
TotalAmountOfSubtraction |
Currency |
The total amount of settlement transactions. |
TotalAmountOfTransaction |
Currency |
The total currency amount of transactions. |
TotalAmountOfUncompletedAddition |
Currency |
The total currency amount of transactions uncompleted due to communication errors between the electronic value reader/writer and electronic value media (card or mobile phone) during the charge settlement transaction. |
TotalAmountOfUncompletedSubtraction |
Currency |
The total currency amount of transactions uncompleted due to communication errors between the electronic value reader/writer and electronic value media (card or mobile phone) during the voiding transaction. |
TotalAmountOfVoid |
Currency |
The total currency amount of voiding transactions. |
TouchTimeout |
Number |
The timeout in milliseconds until the electronic value reader/writer is touched by electronic value media (card or mobile phone). |
TransactionType |
Enumerated |
Indicates the type of transaction for the electronic value service:
ValueDescription
EVRW_TAG_TT_ADDAdding (charge)
EVRW_TAG_TT_CANCEL_CHARGECanceling charge
EVRW_TAG_TT_CANCEL_RETURNCanceling/Return
EVRW_TAG_TT_CANCEL_SALESCanceling sales
EVRW_TAG_TT_GET_LOG Acquiring a transaction log
EVRW_TAG_TT_READReading (reference)
EVRW_TAG_TT_RETURNReturn
EVRW_TAG_TT_SUBTRACTSubtracting (sales)
EVRW_TAG_TT_WRITEWriiiting
|
UILCDControl |
Boolean |
If “True”, indicates that the LCD is controlled when the electronic value reader/writer has an LCD. |
UILEDControl |
Boolean |
If “True”, indicates that the LED is controlled when the electronic value reader/writer has an LED. |
UISOUNDControl |
Boolean |
If “True”, indicates that sound is controlled when the electronic value reader/writer plays sounds. |
VOIDorRETURN |
Enumerated |
Indicates how a transaction is voided:
ValueDescription
1Void
2Return
|
VoidTransactionType |
Enumerated |
Indicates the type of transaction to be voided:
ValueDescription
1Cash
2Exchanging points
|
VoucherID |
String |
The ID of the voucher or ticket. |
VoucherIDList |
String |
A list of enumerated IDs of the voucher/ticket. |
WorkstationID |
String |
The POS ID. |
WorkstationMaker |
String |
The manufacturer’s code of the workstation manufacturer. |
WorkstationSerialNumber |
String |
The manufacturer’s serial number or the identification code of the POS workstation. |
The following table defines the tag formats as specified by the UnifiedPOS v1.14.1 international standard:
Format |
Description |
String |
A text character string. |
Number |
A 32 bit integer value represented by text characters. |
Currency |
A 64 bit Integer value represented by text characters. The last four digits represent the value after the decimal point. Example: a tag value of “1234567” translates to a currency value of 123.4567. |
Datetime |
A date time represented by text characters in the following format: yyyy-mm-ddThh:mn:ss.sssTZD - (dash) is the character separator between date elements. yyyy is a 4-digit number representing the year. mm is a 2-digit number representing the month, where 01 = January and 12 = December. dd is a 2-digit number representing the day of the month, from 01 to 31. T is the character separator between the date and the time. : (colon) is the character separator between the time elements. hh is a 2 digit number representing the hour, from 00 to 23. mn is a 2-digit number representing the minutes, from 00 to 59. ss is a 2-digit number representing the integer part of the seconds, from 00 to 59. . (period) is the character separator between the time and the fractional seconds. sss is a 1-digit to 3-digit number representing the fractional seconds. TZD represents an optional time zone designator, which is Z, +hh:mm, or -hh:mm. Z indicates that the time zone is GMT. +hh:mm or –hh:mm indicates a delta from GMT, where hh indicates the hours (from 00 to 14) and mm indicates the minutes (from 00 to 59). Example: 2008-04-12T23:20:50.275-05:00 represent April 12, 2008, 23 hours, 20 minutes, and 50.275 seconds in New York (GMT – 5 hours). |
Boolean |
A logical type indicated by the text characters “True” or “False”. |
Enumerated |
A text string that indicates one of a set of possible values for a particular tag name. |
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.
See Also
Reference
EVRWResultInformation Members
Microsoft.PointOfService Namespace