Reconcile immutable Charge Detail Records against Sessions and model tariff step_size billing rounding using OCPI 2.2.1's CDRs and Tariffs modules

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

Steps

  1. Implement the CDRs module so the CPO POSTs a new CDR to the eMSP's receiver interface after a session ends; the eMSP's response Location header is used for later GET retrieval.
  2. Treat CDRs as immutable and billing-final — never PUT/PATCH an existing CDR; if a correction is needed, send a Credit CDR with a negative total_cost referencing the original via credit_reference_id.
  3. Implement the Tariffs module so the CPO pushes tariffs to the eMSP via PUT (replace-in-place), or the eMSP falls back to pulling tariffs via GET with date_from/date_to/limit pagination.
  4. Structure each Tariff as a list of TariffElements, each grouping price_components (ENERGY priced per kWh, TIME/PARKING_TIME priced per hour with a step_size in seconds, FLAT with no step_size) under shared restrictions.
  5. Apply step_size rounding by rounding usage up to the next step (e.g. 42 actual parking minutes billed as 45 minutes at a 15-minute step_size).

Known gotchas

Related routes

generate and reconcile OCPI 2.2.1 Charge Detail Records (CDRs) between a CPO and an eMSP for post-session billing
evroaming.org · 6 steps · unrated
Exchange charging session and CDR (Charge Detail Record) data between a CPO and eMSP via OCPI 2.2.1
evroaming.org · 5 steps · unrated
Exchange Charge Detail Records (CDRs) between a CPO and eMSP using the OCPI 2.2.1 CDRs module.
evroaming.org · 5 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