Ordinavo Connect API v1

Billing Events

Billing events are structured triggers for downstream ERP or accounting workflows, not invoices.

Billing events

Billing events are not invoices. They indicate that a completed and approved operational visit may be relevant for downstream billing, ERP or accounting workflows.

No invoice creation

Ordinavo does not create invoices in this workflow. It creates structured billing trigger events that connected systems can process.

Event types

Event TypeDescription
billing.event_createdA billing trigger event was created.
billing.event_readyA billing trigger event is ready for downstream processing.
billing.event_sentA billing trigger event was marked sent to an external system.
billing.event_failedA billing trigger event failed downstream processing.

Example: billing.event_created

{
  "eventId": "evt_01JZ8Y6EXAMPLE",
  "eventType": "billing.event_created",
  "occurredAt": "2026-06-18T16:50:00Z",
  "payloadVersion": "2026-06-18",
  "customer": {
    "ordinavoCustomerId": 12,
    "externalId": "CUST-10042",
    "customerNumber": "RRM-001",
    "name": "Rhein-Ruhr Medical Supply"
  },
  "location": {
    "ordinavoLocationId": 34,
    "externalId": "LOC-ESSEN-01",
    "name": "Essen Center",
    "city": "Essen"
  },
  "billingEvent": {
    "id": 3001,
    "status": "Pending",
    "sourceType": "VisitReport",
    "visitReportId": 901,
    "targetId": 455,
    "appointmentId": 1201,
    "createdAtUtc": "2026-06-18T16:50:00Z"
  },
  "visitReport": {
    "id": 901,
    "title": "Maintenance visit - Essen Center",
    "status": "Approved",
    "result": "Successful",
    "isBillable": true,
    "billingStatus": "Pending"
  },
  "target": {
    "id": 455,
    "externalId": "JOB-2026-000918",
    "title": "Maintenance visit"
  }
}