openactive / open-booking-api

Repository for the Open Booking API specification
Other
2 stars 3 forks source link

Consider contact details for 10.1.10 `schema:Organization` for `customer` #229

Open nickevansuk opened 2 years ago

nickevansuk commented 2 years ago

Consider including contactPoint in the model for an Organization when specified as a customer. Otherwise there is no means specified to capture the contact details of the Organization.

For example the following:

{
  "@type": "Organization",
  "name": "Company Limited",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Raynes Park High School, 46A West Barnes Lane",
    "addressLocality": "New Malden",
    "addressRegion": "London",
    "postalCode": "NW5 3DU",
    "addressCountry": "GB"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "name": "Ralph Jones",
    "email": "alexjones@example.com",
    "telephone": "020 811 8055"
  }
}

Open question: although the model above comes out-of-the-box with schema.org, should this instead include a Person object as the primaryContact or similar rather than a ContactPoint (which is not intended for details of a specific person)

For systems that require a Person to be associated with the Organization rather than just a contact centre number, primaryContact is likely a more accurate model. However if a contact centre contract is preferred for a B2B relationship, perhaps contactPoint would be preferred.

Implementation experience may be required here.