├── LICENSE ├── OCHP-direct.md ├── OCHP.md ├── README.md ├── media ├── CDRperiods.png ├── CDRperiods.svg ├── CDRvalidation.png ├── CDRvalidation.svg ├── ChargingSessionDefinition-1.png ├── ChargingSessionDefinition-1.svg ├── ChargingSessionDefinition-2.png ├── ChargingSessionDefinition-2.svg ├── ClearingHouseLayerModel.png ├── DataFlows.png ├── DataFlows.svg ├── EV-charging-market-overview.png ├── EV-charging-market-overview.svg ├── EVSEstructure.png ├── EVSEstructure.svg ├── EVSEstructureExamples--1.png ├── EVSEstructureExamples--2.png ├── EVSEstructureExamples--3.png ├── EVSEstructureExamples--4.png ├── EVSEstructureExamples--5.png ├── EVSEstructureLegend.png ├── IDstructure.png ├── IDstructure.svg ├── LiveStatusDecision.png ├── LiveStatusDecision.svg ├── OCHPdirectBasicOverview.png ├── OCHPdirectBasicOverview.svg ├── OCHPdirectCommunicationOverview.png ├── OCHPdirectCommunicationOverview.svg ├── OCHPdirectErModel.png ├── OCHPdirectErModel.svg ├── OCHPdirectProcess-1.png ├── OCHPdirectProcess-1.svg ├── OCHPdirectProcess-2.png ├── OCHPdirectProcess-2.svg ├── OCHPdirectTokenExchange.png ├── OCHPdirectTokenExchange.svg ├── OCHPlogo.png ├── POIavailabilityFilter.png ├── POIavailabilityFilter.svg ├── ProtocolVersioning.png ├── ProtocolVersioning.svg ├── SingleAuthorisation-2.png ├── SingleAuthorisation-2.svg ├── SingleAuthorisation-3.png ├── SingleAuthorisation-3.svg ├── SingleAuthorisation.png ├── SingleAuthorisation.svg ├── global-system-overview.png └── global-system-overview.svg ├── ochp-direct.wsdl ├── ochp.wsdl ├── types ├── array-types.xsd ├── data-types.xsd ├── live-types.xsd └── message-elements.xsd └── wsdl-viewer.xsl /LICENSE: -------------------------------------------------------------------------------- 1 | Copyright © 2012-2015 smartlab, bluecorner.be, e-laad.nl 2 | 3 | Permission is hereby granted, free of charge, to any person obtaining a 4 | copy of this software and associated documentation files 5 | (the "Software"), to deal in the Software without restriction, 6 | including without limitation the rights to use, copy, modify, merge, 7 | publish, distribute, sublicense, and/or sell copies of the Software, 8 | and to permit persons to whom the Software is furnished to do so, 9 | subject to the following conditions: 10 | 11 | The above copyright notice and this permission notice shall be included 12 | in all copies or substantial portions of the Software. 13 | 14 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 15 | OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 16 | MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 17 | IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 18 | CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 19 | TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 20 | SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 21 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # OCHP - Open Clearing House Protocol 2 | 3 | The purpose of the Open Clearing House Protocol is to connect market actors in the 4 | field of electric mobility charging infrastructure. 5 | 6 | [The current version of OCHP (1.4).](OCHP.md) 7 | 8 | [The current version of OCHP_direct_ (0.2).](OCHP-direct.md) 9 | 10 | Further information on [ochp.eu](http://ochp.eu) 11 | 12 | 13 | ## History 14 | 15 | 16 | ### [Version 1.3](https://github.com/e-clearing-net/OCHP/tree/OCHP-1.3) 17 | 18 | Introduction of OCHPdirect and small enhancements to the protocol. 19 | 20 | 21 | ### Version 1.2 [Download](http://www.ochp.eu/wp-content/uploads/2013/12/140617_Open-Clearing-House-Protocol_v1.2_0.18.pdf) 22 | 23 | Live Status Interface and further enhancements from market requirements. 24 | 25 | 26 | ### Version 1.0 27 | 28 | Use-case driven structure; Delta-Synchronization; Live-Authorization; CDR-Validation; Alignment to standardization and market development. 29 | 30 | 31 | ### Version 0.2 32 | 33 | VAS data added 34 | -------------------------------------------------------------------------------- /media/CDRperiods.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/CDRperiods.png -------------------------------------------------------------------------------- /media/CDRperiods.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | image/svg+xml 30 | 31 | 37 | 40 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 56 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 80 | 85 | 86 | 87 | 88 | 89 | 92 | 97 | 98 | 99 | 100 | 101 | 104 | 105 | 106 | 107 | 108 | 109 | 112 | 117 | 118 | 119 | 120 | 121 | 124 | 129 | 130 | 131 | 132 | 133 | 136 | 141 | 142 | 143 | 144 | 145 | 148 | 153 | 154 | 155 | 156 | 157 | 160 | 161 | 162 | 163 | 164 | 165 | 168 | 173 | 174 | 194 | 198 | 199 | 202 | 203 | 204 | 205 | 220 | 221 | Example A: 228 | Period 2: Energy (Low Prize) 255 | Period 1: Parking Fee 276 | Period 3: Energy 297 | Time 310 | Period 1: EVSP Usage 331 | Time 344 | Example B: 351 | 352 | -------------------------------------------------------------------------------- /media/CDRvalidation.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/CDRvalidation.png -------------------------------------------------------------------------------- /media/ChargingSessionDefinition-1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/ChargingSessionDefinition-1.png -------------------------------------------------------------------------------- /media/ChargingSessionDefinition-1.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | image/svg+xml 30 | 31 | 37 | 40 | 43 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 63 | 64 | 68 | 74 | 75 | 76 | 77 | 78 | 79 | 82 | 83 | 87 | 93 | 94 | 95 | 96 | 97 | 98 | 101 | 102 | 106 | 112 | 113 | 114 | 115 | 116 | 119 | 124 | 125 | 126 | 127 | 128 | 129 | 132 | 133 | 137 | 143 | 144 | 145 | 146 | 147 | 150 | 155 | 156 | 157 | 158 | 159 | 162 | 167 | 168 | 169 | 170 | 171 | 174 | 179 | 180 | 181 | 182 | 183 | 186 | 187 | 188 | 189 | 190 | 191 | 194 | 199 | 200 | 220 | 224 | 225 | 228 | 229 | 230 | 231 | 246 | 247 | Parking Time 262 | Time 282 | Connection Time 297 | Charging Session 312 | Energy Flow 332 | physical connect 345 | physical disconnect 366 | 367 | successful authorization to connect 384 | successful authorization to disconnect 406 | -------------------------------------------------------------------------------- /media/ChargingSessionDefinition-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/ChargingSessionDefinition-2.png -------------------------------------------------------------------------------- /media/ChargingSessionDefinition-2.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | image/svg+xml 30 | 31 | 37 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 56 | 57 | 61 | 67 | 68 | 69 | 70 | 71 | 72 | 75 | 76 | 80 | 86 | 87 | 88 | 89 | 90 | 93 | 98 | 99 | 100 | 101 | 102 | 103 | 106 | 107 | 111 | 117 | 118 | 119 | 120 | 121 | 124 | 129 | 130 | 131 | 132 | 133 | 136 | 141 | 142 | 143 | 144 | 145 | 148 | 153 | 154 | 155 | 156 | 157 | 160 | 161 | 162 | 163 | 164 | 165 | 168 | 173 | 174 | 194 | 198 | 199 | 202 | 203 | 204 | 205 | 220 | 221 | Parking Time 236 | Time 256 | Connection Time 271 | Charging Session 286 | Energy Flow 306 | physical connect 319 | physical disconnect 335 | 336 | successful authorization to connect 353 | -------------------------------------------------------------------------------- /media/ClearingHouseLayerModel.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/ClearingHouseLayerModel.png -------------------------------------------------------------------------------- /media/DataFlows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/DataFlows.png -------------------------------------------------------------------------------- /media/DataFlows.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 59 | 60 | 61 | 63 | 64 | 65 | 66 | 67 | 68 | 70 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | Zeichenblatt-1 87 | 89 | 90 | 91 | 93 | 95 | 97 | 99 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | Mitarbeiter.45 142 | POIs Live-POIs 143 | 144 | 145 | 146 | 147 | POIsLive-POIs 149 | 150 | 151 | Tabelle.51 152 | Mobility Service Provider 153 | 154 | 155 | 156 | 157 | 158 | 159 | 161 | 162 | 163 | 164 | Mobility Service Provider 166 | 167 | Tabelle.52 168 | EVSE-Operator 169 | 170 | 171 | 172 | 173 | 174 | 175 | 177 | 178 | 179 | 180 | EVSE-Operator 182 | 183 | Tabelle.53 184 | Navigation Service Provider 185 | 186 | 187 | 188 | 189 | 190 | 191 | 193 | 194 | 195 | 196 | Navigation Service Provider 198 | 199 | 200 | 202 | 204 | 206 | 208 | 210 | 212 | 213 | 214 | 215 | 216 | 217 | 218 | 219 | 220 | 221 | 222 | 223 | 224 | 225 | 226 | 227 | 228 | 229 | 230 | 231 | 232 | 233 | 234 | 235 | 236 | 237 | 238 | 239 | 240 | 241 | 242 | 243 | 244 | 245 | 246 | 247 | 248 | 249 | 250 | 251 | 252 | Mitarbeiter.54 253 | Tokens 254 | 255 | 256 | 257 | 258 | Tokens 259 | 260 | 261 | 262 | 264 | 266 | 268 | 270 | 272 | 274 | 275 | 276 | 277 | 278 | 279 | 280 | 281 | 282 | 283 | 284 | 285 | 286 | 287 | 288 | 289 | 290 | 291 | 292 | 293 | 294 | 295 | 296 | 297 | 298 | 299 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 309 | 310 | 311 | 312 | 313 | 314 | Mitarbeiter.60 315 | Tariffs CDRs 316 | 317 | 318 | 319 | 320 | Tariffs CDRs 322 | 323 | 324 | Dynamischer Verbinder 325 | 326 | 327 | 328 | 329 | 330 | 331 | 332 | 333 | 334 | 335 | Dynamischer Verbinder.2 336 | 337 | 338 | 339 | 340 | 341 | 342 | 343 | 344 | 345 | 346 | Dynamischer Verbinder.3 347 | 348 | 349 | 350 | 351 | 352 | 353 | 354 | 355 | 356 | 357 | Tabelle.65 358 | Parking Spot Operator 359 | 360 | 361 | 362 | 363 | 364 | 365 | 367 | 368 | 369 | 370 | ParkingSpotOperator 372 | 373 | Dynamischer Verbinder.72 374 | 375 | 376 | 377 | 378 | 379 | 380 | 381 | 382 | 383 | 384 | 385 | -------------------------------------------------------------------------------- /media/EV-charging-market-overview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/EV-charging-market-overview.png -------------------------------------------------------------------------------- /media/EVSEstructure.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/EVSEstructure.png -------------------------------------------------------------------------------- /media/EVSEstructureExamples--1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/EVSEstructureExamples--1.png -------------------------------------------------------------------------------- /media/EVSEstructureExamples--2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/EVSEstructureExamples--2.png -------------------------------------------------------------------------------- /media/EVSEstructureExamples--3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/EVSEstructureExamples--3.png -------------------------------------------------------------------------------- /media/EVSEstructureExamples--4.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/EVSEstructureExamples--4.png -------------------------------------------------------------------------------- /media/EVSEstructureExamples--5.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/EVSEstructureExamples--5.png -------------------------------------------------------------------------------- /media/EVSEstructureLegend.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/EVSEstructureLegend.png -------------------------------------------------------------------------------- /media/IDstructure.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/IDstructure.png -------------------------------------------------------------------------------- /media/LiveStatusDecision.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/LiveStatusDecision.png -------------------------------------------------------------------------------- /media/OCHPdirectBasicOverview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/OCHPdirectBasicOverview.png -------------------------------------------------------------------------------- /media/OCHPdirectCommunicationOverview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/OCHPdirectCommunicationOverview.png -------------------------------------------------------------------------------- /media/OCHPdirectErModel.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/OCHPdirectErModel.png -------------------------------------------------------------------------------- /media/OCHPdirectProcess-1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/OCHPdirectProcess-1.png -------------------------------------------------------------------------------- /media/OCHPdirectProcess-1.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | image/svg+xmlprovider backend 242 | clearing house 249 | Charging Session 264 | Time 284 | Create CDR 299 | CDR Exchange 314 | OCHP-direct Session 334 | DirectAuth ID 349 | Get CDR 371 | operator system 383 | Billing 403 | sendCDR 430 | requestCDR 449 | controlchargepoint 478 | DirectAuth ID 495 | selectchargepoint 512 | releasechargepoint 536 | DirectAuth ID 544 | -------------------------------------------------------------------------------- /media/OCHPdirectProcess-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/OCHPdirectProcess-2.png -------------------------------------------------------------------------------- /media/OCHPdirectTokenExchange.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/OCHPdirectTokenExchange.png -------------------------------------------------------------------------------- /media/OCHPdirectTokenExchange.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 23 | OCHP direct Token Exchange 25 | 27 | 30 | 34 | 38 | 39 | 42 | 46 | 50 | 51 | 54 | 58 | 62 | 63 | 66 | 70 | 74 | 75 | 85 | 95 | 105 | 115 | 124 | 133 | 134 | 159 | 161 | 162 | 164 | image/svg+xml 165 | 167 | 169 | OCHP direct Token Exchange 170 | 2015-03-02 171 | 172 | 173 | Simon Schilling 174 | 175 | 176 | 177 | 178 | smartlab Innovationsgesellschaft mbH 179 | 180 | 181 | en 182 | 183 | 184 | 185 | 190 | 198 | 206 | 212 | 220 | 228 | 229 | 230 | 231 | Time 232 | partner B 240 | 241 | 242 | 245 | 253 | Token A2 261 | 262 | 263 | 264 | 267 | 275 | Token A1 283 | 284 | 285 | 286 | partner A 294 | 295 | 296 | 299 | 307 | Token B2 315 | 316 | 317 | 318 | 321 | 329 | Token B1 337 | 338 | 339 | 340 | 348 | 351 | download token 2 363 | 369 | 370 | 378 | 386 | 389 | 395 | upload token 3 407 | 408 | 411 | 417 | upload token 2 429 | 430 | AB1 valid 438 | 439 | 440 | AB2 valid 448 | 449 | 450 | 451 | 452 | -------------------------------------------------------------------------------- /media/OCHPlogo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/OCHPlogo.png -------------------------------------------------------------------------------- /media/POIavailabilityFilter.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/POIavailabilityFilter.png -------------------------------------------------------------------------------- /media/ProtocolVersioning.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/ProtocolVersioning.png -------------------------------------------------------------------------------- /media/SingleAuthorisation-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/SingleAuthorisation-2.png -------------------------------------------------------------------------------- /media/SingleAuthorisation-2.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | image/svg+xml 49 | 53 | 54 | 57 | 58 | 59 | 60 | 77 | 78 | 80 | 82 | 86 | 87 | 97 | 101 | 102 | 103 | 104 | 110 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 147 | 152 | 153 | 154 | 155 | 156 | 159 | 160 | 161 | 162 | 163 | 164 | 167 | 172 | 173 | 174 | 175 | 176 | 179 | 184 | 185 | 186 | 187 | 188 | 191 | 192 | 193 | 194 | 195 | 196 | 199 | 204 | 205 | 206 | 207 | 208 | 211 | 212 | 213 | 214 | 215 | 216 | 219 | 224 | 225 | 226 | 227 | 228 | 231 | 236 | 237 | 238 | 239 | 240 | 243 | 248 | 249 | 250 | 251 | 252 | 255 | 260 | 261 | 262 | 263 | 264 | 265 | 266 | 267 | 268 | 271 | 276 | 277 | 278 | 279 | 280 | 283 | 288 | 289 | 290 | 291 | 292 | 295 | 296 | 297 | 298 | 299 | 300 | 303 | 308 | 309 | 310 | 311 | 312 | 315 | 320 | 321 | 322 | 323 | 324 | 327 | 328 | 329 | 330 | 331 | 332 | 333 | 334 | 335 | 336 | 339 | 344 | 345 | 346 | 347 | 348 | 351 | 356 | 357 | 358 | 359 | 360 | 363 | 368 | 369 | 370 | 371 | 372 | 375 | 380 | 381 | 382 | 383 | 384 | 387 | 392 | 393 | 394 | 395 | 396 | 399 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | operator backend 428 | clearing house 442 | Charging Session 457 | LiveAuth Session 472 | Time 492 | Send CDR 512 | Charge Data Exchange 527 | LiveAuth ID 571 | Session ID 600 | Get CDR 620 | provider system 646 | Customer Billing 666 | 677 | LiveAuth IDSession ID 694 | LiveAuth IDSession ID 711 | request 723 | Authrequest 740 | LiveAuth ID 752 | -------------------------------------------------------------------------------- /media/SingleAuthorisation-3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/SingleAuthorisation-3.png -------------------------------------------------------------------------------- /media/SingleAuthorisation-3.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 28 | 29 | 30 | 31 | 32 | 33 | 35 | 36 | 37 | 38 | 39 | Page-2 40 | 42 | 43 | 44 | Tabelle.4 45 | operator backend 46 | 47 | 48 | 49 | operator backend 50 | 51 | Tabelle.5 52 | clearing house 53 | 54 | 55 | 56 | clearing house 57 | 58 | Tabelle.7 59 | Charging Session 60 | 61 | 62 | 63 | Charging Session 64 | 65 | Tabelle.8 66 | Authorisation Data 67 | 68 | 69 | 70 | Authorisation Data 71 | 72 | Tabelle.9 73 | 74 | Pfeil 60 Grad-Spitze 75 | 76 | 77 | 78 | 80 | 81 | 82 | Tabelle.11 83 | Time 84 | 85 | 86 | 87 | Time 88 | 89 | 90 | Dynamischer Verbinder.16 91 | 92 | 93 | 94 | 95 | 96 | 97 | Tabelle.26 98 | Send CDR 99 | 100 | 101 | 102 | Send CDR 103 | 104 | Tabelle.27 105 | Charge Data Exchange 106 | 107 | 108 | 109 | Charge Data Exchange 110 | 111 | Dynamischer Verbinder.28 112 | 113 | 114 | 115 | 116 | 117 | 118 | Tabelle.32 119 | 120 | Tabelle.33 121 | 122 | 123 | 124 | Tabelle.34 125 | 126 | 127 | 128 | 129 | Tabelle.3 130 | Auth request 131 | 132 | 133 | 134 | Auth request 136 | 137 | Tabelle.6 138 | Single Token 139 | 140 | 141 | 142 | Single Token 143 | 144 | Tabelle.12 145 | Session ID 146 | 147 | 148 | 149 | Session ID 150 | 151 | Dynamischer Verbinder 152 | 153 | 154 | 155 | 156 | 157 | 158 | Tabelle.15 159 | Get CDR 160 | 161 | 162 | 163 | Get CDR 164 | 165 | Dynamischer Verbinder.16 166 | 167 | 168 | 169 | 170 | 171 | 172 | Tabelle.19 173 | provider system 174 | 175 | 176 | 177 | provider system 178 | 179 | Dynamic connector.16 180 | 181 | 182 | 183 | 184 | 185 | 186 | Tabelle.21 187 | Customer Billing 188 | 189 | 190 | 191 | Customer Billing 192 | 193 | Tabelle.22 194 | 195 | Tabelle.23 196 | 197 | 198 | 199 | Tabelle.24 200 | 201 | 202 | 203 | 204 | Dynamic connector.1 205 | 206 | 207 | 208 | 209 | 210 | 211 | 212 | -------------------------------------------------------------------------------- /media/SingleAuthorisation.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/SingleAuthorisation.png -------------------------------------------------------------------------------- /media/SingleAuthorisation.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | image/svg+xml 49 | 53 | 54 | 57 | 58 | 59 | 60 | 76 | 77 | 79 | 81 | 85 | 86 | 96 | 100 | 101 | 102 | 103 | 109 | 112 | 115 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 158 | 163 | 164 | 165 | 166 | 167 | 170 | 171 | 172 | 173 | 174 | 175 | 178 | 183 | 184 | 185 | 186 | 187 | 190 | 191 | 192 | 193 | 194 | 195 | 196 | 197 | 198 | 201 | 206 | 207 | 208 | 209 | 210 | 213 | 218 | 219 | 220 | 221 | 222 | 225 | 230 | 231 | 232 | 233 | 234 | 237 | 242 | 243 | 244 | 245 | 246 | 249 | 254 | 255 | 256 | 257 | 258 | 261 | 266 | 267 | 268 | 269 | 270 | 273 | 274 | 275 | 276 | 277 | 278 | 281 | 282 | 283 | 284 | 285 | 286 | 289 | 290 | 291 | 292 | 293 | 294 | 297 | 298 | 299 | 300 | 301 | 302 | 305 | 310 | 311 | 312 | 313 | 314 | 317 | 322 | 323 | 324 | 325 | 326 | 329 | 330 | 331 | 332 | 333 | 334 | 337 | 338 | 339 | 340 | 341 | 342 | 343 | 344 | 345 | 346 | 347 | 348 | 349 | 350 | 351 | 352 | 353 | 354 | 355 | 358 | 363 | 364 | 365 | 366 | 367 | 370 | 375 | 376 | 377 | 378 | 379 | 382 | 387 | 388 | 389 | 390 | 391 | 394 | 399 | 400 | 401 | 402 | 403 | 406 | 411 | 412 | 413 | 414 | 415 | 418 | 423 | 424 | 425 | 426 | 427 | 430 | 435 | 436 | 437 | 438 | 439 | 442 | 443 | 444 | 445 | 446 | 447 | 448 | 449 | 450 | 451 | Charging Session 466 | Start auth. 481 | charge pole 488 | operator 495 | clearing house 502 | End auth. 517 | Time 544 | request* 568 | request 575 | respond* 602 | respond 609 | respond 616 | request 623 | * Methods in scope of OCHP 630 | Send CDR 645 | request* 664 | respond* 676 | 687 | backend 694 | -------------------------------------------------------------------------------- /media/global-system-overview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/e-clearing-net/OCHP/034363a896bb9c8a24a82e078d57505eaad68ce7/media/global-system-overview.png -------------------------------------------------------------------------------- /ochp.wsdl: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 40 | 41 | 42 | 46 | 47 | 48 | Open Clearing House Protocol (OCHP) Version 1.4 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 63 | 64 | 65 | 66 | 67 | 69 | 70 | 71 | 73 | 74 | 75 | 76 | 78 | 79 | 80 | 82 | 83 | 84 | 85 | 87 | 88 | 89 | 91 | 92 | 93 | 94 | 96 | 97 | 98 | 100 | 101 | 102 | 103 | 105 | 106 | 107 | 109 | 110 | 111 | 112 | 113 | 115 | 116 | 117 | 119 | 120 | 121 | 122 | 124 | 125 | 126 | 128 | 129 | 130 | 131 | 133 | 134 | 135 | 137 | 138 | 139 | 140 | 142 | 143 | 144 | 146 | 147 | 148 | 149 | 150 | 151 | 153 | 154 | 155 | 157 | 158 | 159 | 160 | 162 | 163 | 164 | 166 | 167 | 168 | 169 | 171 | 172 | 173 | 175 | 176 | 177 | 178 | 180 | 181 | 182 | 184 | 185 | 186 | 187 | 188 | 189 | 191 | 192 | 193 | 195 | 196 | 197 | 198 | 200 | 201 | 202 | 204 | 205 | 206 | 207 | 208 | 209 | 211 | 212 | 213 | 215 | 216 | 217 | 218 | 220 | 221 | 222 | 224 | 225 | 226 | 229 | 230 | 231 | 232 | 233 | OCHP Version 1.4 Interface 234 | 235 | 236 | 237 | 238 | Local roaming charge data records are sent from the CMS to the CHS. 239 | 240 | 241 | 242 | 243 | 244 | 245 | Cleared roaming charge data records, held at the CHS are sent from the CHS to the MDM. Note that only cleared CDRs that concern the EVSP are sent according to the status specified in the request. 246 | 247 | 248 | 249 | 250 | 251 | 252 | Cleared roaming charge data records, held at the CHS are sent from the CHS to the CMS. Note that only CDRs sent by this EVSE operator are sent according to the status specified in the request. 253 | 254 | 255 | 256 | 257 | 258 | 259 | A CMS downloads the global authorisation data repository from the CHS. 260 | 261 | 262 | 263 | 264 | 265 | 266 | The MDM of each EVSP has to exchange the own authorisation data with the Clearing House to share that data with EVSE Operators. 267 | 268 | 269 | 270 | 271 | 272 | 273 | A NPS downloads the global charge point information from the CHS. 274 | 275 | 276 | 277 | 278 | 279 | 280 | Local roaming charge data records are sent from the CMS to the CHS. 281 | 282 | 283 | 284 | 285 | 286 | 287 | A CMS downloads the changes to the global authorisation data repository since the last synchronization from the CHS. 288 | 289 | 290 | 291 | 292 | 293 | 294 | For later updates of authorization data from the MDM to the Clearing House and the EVSE Operators, only the changed entries (delta) have to be transferred. 295 | 296 | 297 | 298 | 299 | 300 | 301 | Cleared roaming charge data records, downloaded from the CHS are confirmed by the MDM. An EVSE-Operator has to confirm every downloaded CDR either with an accept or a revoke. 302 | 303 | 304 | 305 | 306 | 307 | 308 | A NPS downloads the changes to the global charge point information data repository since the last synchronization from the CHS. 309 | 310 | 311 | 312 | 313 | 314 | 315 | For later updates of charge point information from the CIMS to the Clearing House and the EVSPs, only the changed entries (delta) have to be transferred. 316 | 317 | 318 | 319 | 320 | 321 | 322 | For all updates to tariff objects from the CIMS to the Clearing House and the EVSPs. Can contain single or multiple tariffs to update. 323 | 324 | 325 | 326 | 327 | 328 | 329 | Downloads all tariff objects from the Clearing House that have been updated since a given date and time. Can contain single or multiple tariffs. 330 | 331 | 332 | 333 | 334 | 335 | 336 | A CMS may request the Clearing House to authorize one single token for a charging session 337 | 338 | 339 | 340 | 341 | 342 | 343 | 344 | 345 | 346 | OCHP Version 1.4 Live POI Interface 347 | 348 | 349 | 350 | 351 | A CMS may update the current live status of individual charging stations in the Clearing House to allow roaming partners to receive those statuses. 352 | 353 | 354 | 355 | 356 | 357 | 358 | A NPS may receive the current live status of individual charging stations from the Clearing House. 359 | 360 | 361 | 362 | 363 | 364 | 365 | 368 | 369 | 370 | 371 | 372 | OCHP Version 1.4 Interface 373 | 374 | 375 | 376 | 377 | 378 | 379 | 380 | 381 | 382 | 383 | 384 | 385 | 386 | 387 | 388 | 389 | 390 | 391 | 392 | 393 | 394 | 395 | 396 | 397 | 398 | 399 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 419 | 420 | 421 | 422 | 423 | 424 | 425 | 426 | 427 | 428 | 429 | 430 | 431 | 432 | 433 | 434 | 435 | 436 | 437 | 438 | 439 | 440 | 441 | 442 | 443 | 444 | 445 | 446 | 447 | 448 | 449 | 450 | 451 | 452 | 453 | 454 | 455 | 456 | 457 | 458 | 459 | 460 | 461 | 462 | 463 | 464 | 465 | 466 | 467 | 468 | 469 | 470 | 471 | 472 | 473 | 474 | 475 | 476 | 477 | 478 | 479 | 480 | 481 | 482 | 483 | 484 | 485 | 486 | 487 | 488 | 489 | 490 | 491 | 492 | 493 | 494 | 495 | 496 | 497 | 498 | 499 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 509 | 510 | 511 | 512 | 513 | 514 | 515 | 516 | 517 | 518 | 519 | 520 | 521 | 522 | 523 | 524 | 525 | 526 | 527 | 528 | 529 | 530 | 531 | 532 | 533 | 534 | OCHP Version 1.4 Live POI Interface 535 | 536 | 537 | 538 | 539 | 540 | 541 | 542 | 543 | 544 | 545 | 546 | 547 | 548 | 549 | 550 | 551 | 552 | 553 | 554 | 555 | 556 | 557 | 558 | 559 | 560 | 563 | 564 | 565 | 566 | 567 | EEN European Emobility Network - EV Clearing Platform 568 | 569 | 570 | 571 | 572 | eCHS Productive System Endpoint 573 | 574 | 575 | 576 | 577 | 578 | 579 | eCHS Quality Ensurance System Endpoint 580 | 581 | 582 | 583 | 584 | 585 | 586 | 587 | 588 | eCHS Live-POI Productive System Endpoint 589 | 590 | 591 | 592 | 593 | 594 | 595 | eCHS Live-POI Quality Ensurance Endpoint 596 | 597 | 598 | 599 | 600 | 601 | 602 | 603 | -------------------------------------------------------------------------------- /types/array-types.xsd: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Whitelisted authorisation card info. 10 | 11 | 12 | 13 | 14 | 15 | 16 | Electrical vehicle contract identifier. 17 | 18 | 19 | 20 | 21 | 22 | 23 | EMA-ID the token belongs to. 24 | 25 | 26 | 27 | 28 | 29 | 30 | Might be used for manual authorisation. 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | Tokens may be used until the date of expiry is reached. To be handled by the partners systems. Expired roaming authorisations may be erased locally by each partner's system. 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | CDR info. 53 | 54 | 55 | 56 | 57 | 58 | Alphanumeric, Charge Data Record number. Unique per EVSE-ID. 59 | 60 | 61 | 62 | 63 | 64 | 65 | Unique identifier for every EVSE following a common scheme with a major id-unit reflecting the country and the market partner issuing it. 66 | 67 | 68 | 69 | 70 | 71 | 72 | Utilized token for this charging session. 73 | 74 | 75 | 76 | 77 | 78 | 79 | Identifies a customer in the electric mobility charging context. 80 | 81 | 82 | 83 | 84 | 85 | 86 | Current status of the CDR. Must be set to "new" or "revised" by the issuing CMS. Shall not be changed by any partner but only by the CHS. "Revised" status is only possible for CDRs that have either status "accepted" or "declined". 87 | 88 | 89 | 90 | 91 | 92 | 93 | Start date and time of charge session 94 | (login with the RFID badge). Local time 95 | of the charge point is used. 96 | 97 | 98 | 99 | 100 | 101 | 102 | End date and time of the charge session (log-off with the RFID badge or physical disconnect). Must be set in the local time of the charge point. 103 | 104 | 105 | 106 | 107 | 108 | 109 | Duration of the charge session. Example "000:18:00" 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | Address of the charge point, consisting of housenumber, street, zipcode, city, country. 123 | 124 | 125 | 126 | 127 | 128 | 129 | The type of the charge point "AC" or "DC" 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | Type of utilized socket or connector 143 | 144 | 145 | 146 | 147 | 148 | 149 | Defines the ratings for the charge point. 150 | 151 | 152 | 153 | 154 | 155 | 156 | Written identification number of the physical energy meter, provided by the manufacturer. For future use. 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | 169 | One period per item on the bill. 170 | 171 | 172 | 173 | 174 | 175 | 176 | Total cost for the entire charging process. Should always equal the sum of the individual periodCosts. 177 | 178 | 179 | 180 | 181 | 182 | 183 | Alphabetic. The displayed and charged currency. Defined in ISO 4217 - Table A.1, alphabetic list. 184 | 185 | 186 | 187 | 188 | 189 | 190 | 191 | 192 | 193 | 194 | 195 | 196 | 197 | 198 | Static POI data regarding a charge point / EVSE. 199 | 200 | 201 | 202 | 203 | 204 | 205 | Globally unique identifier 206 | 207 | 208 | 209 | 210 | 211 | 212 | Alphanumeric. Identifies a location/pool of EVSEs. Unique within one EVSE Operator 213 | 214 | 215 | 216 | 217 | 218 | 219 | 220 | 221 | 222 | 223 | 224 | 225 | 226 | Recommended. Date and time of the latest data update for this ChargePointInfo. When set it must be updated if any value is changed. 227 | 228 | 229 | 230 | 231 | 232 | 233 | Official name; should be unique in the geographical area 234 | 235 | 236 | 237 | 238 | 239 | 240 | 241 | 242 | 243 | 244 | 245 | 246 | Alpha, three characters. ISO-639-3 language code defining the language of the location name 247 | 248 | 249 | 250 | 251 | 252 | 253 | 254 | 255 | 256 | 257 | 258 | 259 | 260 | 261 | Address of the charge point, consisting of housenumber, street, zipcode, city, country. 262 | 263 | 264 | 265 | 266 | 267 | 268 | Geographical location of the charge point itself (power outlet). 269 | 270 | 271 | 272 | 273 | 274 | 275 | Geographical location of related points relevant to the user 276 | 277 | 278 | 279 | 280 | 281 | 282 | One of IANA tzdata's TZ-values representing the time zone of the location. Examples: "Europe/Oslo", "Europe/Zurich". (http://www.iana.org/time-zones) 283 | 284 | 285 | 286 | 287 | 288 | 289 | 290 | 291 | 292 | 293 | 294 | The times the EVSE is operating and can be used for charging. Must nor be provided if operating hours are unsure/unknown 295 | 296 | 297 | 298 | 299 | 300 | 301 | The current status of the charge point. 302 | 303 | 304 | 305 | 306 | 307 | 308 | Planned status changes in the future. If a time span matches with the current or displayed date, the corresponding value overwrites "status" 309 | 310 | 311 | 312 | 313 | 314 | 315 | Numeric. Service hotline for charging station to be displayed to the EV user. Separators recommended. Must include country code (e.g. +49). 316 | RegEx: 317 | 318 | 319 | 320 | 321 | 322 | 323 | 324 | 325 | 326 | 327 | 328 | The general type of the charge point location. 329 | 330 | 331 | 332 | 333 | 334 | 335 | Information regarding a parking spot that can be used to access the EVSE. 336 | 337 | 338 | 339 | 340 | 341 | 342 | This value, if provided, represents the restriction to EVSE-usage for different purposes. 343 | 344 | 345 | 346 | 347 | 348 | 349 | 350 | 351 | Which receptable type is/are present for a power outlet. 352 | 353 | 354 | 355 | 356 | 357 | 358 | The type of the charge point "AC" or "DC" 359 | 360 | 361 | 362 | 363 | 364 | 365 | 366 | 367 | 368 | 369 | 370 | 371 | Defines the ratings for the charge point. 372 | 373 | 374 | 375 | 376 | 377 | 378 | Alpha, three characters. Language(s) of the user interface or printed on-site instructions. ISO-639-3 language code 379 | 380 | 381 | 382 | 383 | 384 | 385 | 386 | 387 | 388 | 389 | 390 | 391 | If a reservation of this charge point is possible, this is the maximum duration the CPO will allow a reservation for in minutes. Recommended: 30 or 60 minutes. 392 | 393 | 394 | 395 | 396 | 397 | 398 | 399 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | Information about a tariff referenced at connector level. 408 | 409 | 410 | 411 | 412 | 413 | 414 | Alphanumeric. Identifies a tariff. Unique within one EVSE Operator. Must begin with the Operator-ID, without separators. 415 | 416 | 417 | 418 | 419 | 420 | 421 | Element describing an individual tariff for a specific recipient. One default tariff without recipients must be provided. 422 | 423 | 424 | 425 | 426 | 427 | 428 | -------------------------------------------------------------------------------- /types/live-types.xsd: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | The major status type reflects the overall status of the EVSE. Values: 14 | available: the EVSE is able to start a new charging process; 15 | not-available: at the moment no new charging process may be started; 16 | unknown: the current status of the EVSE is not known; 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | The optional minor status type reflects the detailed status of the EVSE in addition to the major status. For each minor status value a proposed ttl value is given. However, the ttl should only be set to a value other than default if the expected status change is known or can be predicted. Values: 31 | available: the EVSE is able to start a new charging process; 32 | reserved: the EVSE is able to start a new charging process for limited duration as a future reservation is present. ttl to be set on the start of the reservation; 33 | charging: the EVSE is in use. ttl to be set on the expected end of the charging process; 34 | blocked: the EVSE not accessible because of a physical barrier, i.e. a car; 35 | outoforder: the EVSE is currently out of order. ttl to be set to the expected re-enabling; 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | The time to live is set as the deadline until which the status value is to be considered valid. Should be set to the expected status change. 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | The status type reflects the overall status of the parking spot. Values: 64 | available: the parking spot is empty; 65 | not-available: the parking spot is occupied; 66 | unknown: the current status of the parking spot is not known; 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | The time to live is set as the deadline until which the status value is to be considered valid. Should be set to the expected status change. 81 | 82 | 83 | 84 | 85 | 86 | 87 | --------------------------------------------------------------------------------