[УКР](https://hackmd.io/q3baQG6gSpe9igShE8JHag) | ENG ![](https://i.imgur.com/ULmPUgP.jpg) :arrow_left: [Guide](https://hackmd.io/QA2NYRliRLGviJl5P4-ZCw) # [80200] Get Fines Information ## Usage Request [80200] is used to get detailed information about the client's fines. ## Request *See the description of the "Partner", "KeyAES" and "Sign" attributes in the section "[General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ)".* ### Data Structure To get the fines' information in the "Data" structure, the following parameters must be sent: 1. *OR driver's license data:* :::info <details> <summary>1. Data structure formation (examples are below)</summary> <br> ~~~ { "LicenseSeries": "", "LicenseNumber": "", "LicenseDate": "", "Transaction": { "TransactionID": "", "TerminalID": "", "DateTime": "" } } ~~~ </details> ::: |Parameter|Required|Type|Description|Example| |:----:|:----:|:----:|----|:----:| |`LicenseSeries`|Yes|String|Driver's license series.|`ООО`| |`LicenseNumber`|Yes|String|Driver's license number.|`321456`| |`LicenseDate`|Yes|String|Driver's license issue date in the format: YYYY-MM-DD.|`2015-05-05`| |`Transaction`|Yes|Structure|Structure transmits transaction data. See section "[Transaction Structure](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ?view#2-Data)".|See example below.| 2. *OR passport/ID card data (one of two) and vehicle registration plate*: :::info <details> <summary>2. Data structure formation (examples are below)</summary> <br> ~~~ { "PassportSeries": "", "PassportNumber": "", "IDcardNumber": "", "RegPlate": "", "Transaction": { "TransactionID": "", "TerminalID": "", "DateTime": "" } } ~~~ </details> ::: |Parameter|Required|Type|Description|Example| |:----:|:----:|:----:|----|:----:| |`PassportSeries`|Yes/No|String|Passport series.|`AB`| |`PassportNumber`|Yes/No|String|Passport number.|`165433`| |`IDcardNumber`|Yes/No|String|ID card number - unique entry number in the register (Ukrainian, "УНЗР").| `19910824-00026`| |`RegPlate`|Yes|String|Vehicle registration plate.|`AI1387SK`| |`Transaction`|Yes|Structure|Structure transmits transaction data. See section "[Transaction Structure](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ?view#2-Data)".|See example below.| 3. *OR resolution data and vehicle registration plate:* :::info <details> <summary>3. Data structure formation (examples are below)</summary> <br> ~~~ { "ResolutionSeries": "", "ResolutionNumber": "", "RegPlate": "", "Transaction": { "TransactionID": "", "TerminalID": "", "DateTime": "" } } ~~~ </details> ::: |Parameter|Required|Type|Description|Example| |:----:|:----:|:----:|----|:----:| |`ResolutionSeries`|Yes|String|Resolution series.| `AR`| |`ResolutionNumber`|Yes|String|Resolution number.| `123456`| |`RegPlate`|Yes|String|Vehicle registration plate.|`AI1387SK`| |`Transaction`|Yes|Structure|Structure transmits transaction data. See section "[Transaction Structure](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ?view#2-Data)".|See example below.| :::success <details> <summary>Example of the request [80200] (driver's license data)</summary> <br> ~~~md { "Partner": { "PartnerToken": "72a8ddb8-9145-4a41-af1a-8c48ecaa4be1", "OperationType": 80200 }, "Data": "{\"LicenseSeries\":\"ООО\",\"LicenseNumber\":\"321456\",\"LicenseDate\":\"2015-05-05\",\"Transaction\ ":{\"TransactionID\":\"321466\",\"TerminalID\":\"1\",\"DateTime\":\"2019-02-11 13:37:17\"}}" , "KeyAES": "", "Sign": "" } ~~~ </details> ::: ## Response *See the general information on the response structure formation in the section "[General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ)"*. Successful response to the request [80200] contains the array of structures `Fines`, which transmits data of the requested fines: |Parameter|Required|Type|Description|Example| |:----:|:----:|:----:|----|:----:| | `Department`|No | String | Police department that issued the report. |`LIVIV REGION PATROL POLICE DEPARTMENT`| | `fab` | No | String | Crime plot (fabula). |`M06 508 SOLID LINE CROSSING OF ROAD MARKINGS 1.1`| | `kupap` |No | String | Violated article of the Code of Administrative Offenses. |`ST.122 Part 1. Exceeding established speed limits by vehicle drivers and violations of other traffic rules`| | `region` | No | String | Region. | `LVIVSKA`| | `district` |No | String | District.| `BUSKY`| | `city` |No | String | City. | `LVIV`| | `street` |No | String | Street. | `MYRNA`| | `roadKm` | No | String | Road kilometer, where the offense was committed. | `17`| | `send` | No | String | Сourt, where the protocol was sent for consideration. | `Sykhiv District Court of Lviv`| | `consider` |No | String | Person, who considered. |`Borachok M.V.`| | `decision` |No | String | Decision. | `FINE WAS IMPOSED FOR ST. KUPAP`| | `penalty` |No| String | Type of penalty. | `FINE`| | `sumFine` |No | String | Sum of fine. |`255`| | `sumPenalty` | No | String | Sum of penalty. | `255`| | `paidPenalty` | No | String | Sum of paid penalty. |`255` | | `licensePlate` |No | String | Vehicle license plate. |`AI1387SK`| | `brand` |No | String | Vehicle make and model. |`KIA SOUL`| | `pdd` | No | String | Violated article of traffic rules. |`p.8.5.1. Traffic regulations - Violation of the requirements of horizontal road markings` | | `mark` |No | String | Marks to the protocol. |`<Marks>`| | `drecord` |No | String | Date of database recording. |`2019-06-23T00:00:00` | | `dsignPost` |No | String | Date of protocol signing.|`2019-06-23T00:00:00` | | `dperpetration` |No | String | Date of offense perpetration. | `2019-06-23T00:00:00`| | `dateDelivery` | No | String | Delivery date. |`2019-06-23T00:00:00`| | `dsend` | No | String | Date of protocol sending. |`2019-06-23T00:00:00` | | `decision` | No | String | Date of decision. |`2019-06-23T00:00:00`| | `dpaid` | No | String | Payment date. |`2019-07-02T00:00:00`| | `dcanceled` | No| String | Date of cancellation of the decision. |`2019-10-02T00:00:00`| | `sprotocol` |No | String | Series of protocol. |`EAV`| | `nprotocol` |No | String | Number of protocol. | `1258836`| |`sdecree`|No | String| Series of decree. |`ASDK`| |`ndecree`|No | String| Number of decree.| `103437587`| | `paidinfo` |No | String | Details of fine payment. |`UA088999980333209397000026001` | | `docId` | No | String |Unique fine identifier. |`30191745443969447370`| | `typeFine`|No| Integer | Type of fine: </br> `1` - ordinary, </br> `2` - photo fixation, </br> `3` - parking. |`1`| | `payStatus` | No | Integer | Fine payment status: </br> `0` - unpaid, </br> `1` - paid, </br> `2` - repaid.|`2`| ### Response Examples :::success <details> <summary>Operation Successfully Completed</summary> <br> ~~~md { "Code": 200, "Message": "done", "Data": { "Fines": [ { "CanPay": false, "brand": "KIA SOUL", "city": null, "consider": "Borachok M.V.", "dateDelivery": null, "dcanceled": null, "decision": "2019-06-23T00:00:00", "decision": "FINE WAS IMPOSED FOR ST. KUPAP", "department": "LIVIV REGION PATROL POLICE DEPARTMENT", "district": "BUSKY", "docId": "30191745443969447370", "dpaid": "2019-07-02T00:00:00", "dperpetration": "2019-06-23T00:00:00", "drecord": "2019-06-23T00:00:00", "dsend": null, "dsignPost": "2019-06-23T00:00:00", "fab": "M06 508 SOLID LINE CROSSING OF ROAD MARKINGS 1.1", "kupap": "ST.122 Part 1. Exceeding established speed limits by vehicle drivers and violations of other traffic rules", "licensePlate": "AI1387SK", "mark": null, "ndecree": null, "nprotocol": "1258836", "paidPenalty": "255", "paidinfo": null, "payStatus": 2, "pdd": "p.8.5.1. Traffic regulations - Violation of the requirements of horizontal road markings", "penalty": "FINE", "region": "LVIVSKA", "roadKm": null, "sdecree": null, "send": "NOT SENT", "sprotocol": "EAV", "status": null, "street": "MYRNA", "sumFine": "255", "sumPenalty": "255", "typeFine": 1 } ], "OperationStatus": 10 }, "KeyAES": "", "Sign": "" } ~~~ </details> ::: :::success <details> <summary>Operation Failed</summary> <br> ~~~md { "Code": 200, "Message": "done", "Data": { "OperationID": 111, "OperationStatus": 21, "Reason": 3 }, "KeyAES": "", "Sign": "" } ~~~ </details> ::: ## Related Requests [[80001] Fines Payment by Card for Mobile Application](https://hackmd.io/fWnQXFk5T2-sYiloHg6IaQ) [Fines Payment Form for Partner Resource](https://hackmd.io/sFCB2G7OT2eMgGx4LqOg2g) ## Reference Materials General parameters of the XPAY system are given in the section ["Reference Materials"](https://hackmd.io/16yLv895Qo-FWTvrWWQwbg):  operation types, payment types, response codes, operation status, reasons of operation rejection, etc. ![](https://i.imgur.com/17gAyWb.png) :arrow_left: [Guide](https://hackmd.io/QA2NYRliRLGviJl5P4-ZCw) :arrow_left: [General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ) <details> <summary>XPAY Support</summary> </br> Phone: +38 093 891 92 00 Email: info@xpay.com.ua Telegram: @xpaysupportbot </details>