Implement an OpenADR 2.0b VEN using the pull model to register with a VTN, retrieve EiEvent payloads, and acknowledge events

domain: openadr.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Send an oadrCreatePartyRegistration SOAP request to the VTN registration endpoint; include oadrProfileName ('2.0b'), oadrTransportType ('simpleHttp'), venID (empty on first registration), and oadrHttpPullModel set to true to indicate pull-based operation.
  2. Parse the oadrCreatedPartyRegistration response; store the assigned venID and registrationID — subsequent requests must include these identifiers, and the VTN may return an HTTP 400 if they are missing or mismatched.
  3. Poll the VTN by sending oadrRequestEvent with your venID and replyLimit (maximum number of events to return); the VTN responds with oadrDistributeEvent containing an array of oadrEvent elements each with eventDescriptor, eiActivePeriod, and eiEventSignals.
  4. For each event, parse the eiEventSignals to extract the signalType (SIMPLE, PRICE, LEVEL, etc.) and signalPayload intervals; map these to actionable commands for your DER controller using your program-specific payload mapping.
  5. Acknowledge each event by sending oadrCreatedEvent with an array of oadrEventResponse items, each containing eventID, modificationNumber, and optType ('optIn' or 'optOut'); the modificationNumber must match the value in the received event or the VTN will reject the acknowledgment.
  6. If the VTN expects periodic check-in, send oadrPoll requests at the configured heartbeat interval; the VTN may piggyback new events on the oadrResponse to the poll, so always process the poll response body.

Known gotchas

Related routes

Receive demand-response events as an OpenADR 2.0b Virtual End Node (VEN)
openadr.org · 5 steps · unrated
Implement OpenADR 2.0b EiReport telemetry reporting from a VEN to a VTN, including baseline and actual consumption reports
openadr.org · 6 steps · unrated
register a Virtual End Node (VEN) and subscribe to reports from a Virtual Top Node (VTN) using the OpenADR 3.0/3.1 REST API
openadr.org · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans