{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": "https://schema.org",
  "@type": "WebAPI",
  "name": "Nexcellence Agent Actions & Autonomous Booking Protocol",
  "version": "1.2.0",
  "description": "Enterprise machine-readable manifest and OpenAPI-style action definitions enabling autonomous AI agents (OpenAI Operator, browser-use, LangChain, Claude, AutoGPT) to programmatically inspect calendar availability, execute deterministic bookings, and handle schedule modifications for Cesare Ghezzi, PhD at Nexcellence (C&S by C. Ghezzi), Neuchâtel, Switzerland.",
  "url": "https://www.nexcellence.ch/",
  "documentation": "https://www.nexcellence.ch/llms-full.txt",
  "termsOfService": "https://www.nexcellence.ch/terms/",
  "privacyPolicy": "https://www.nexcellence.ch/privacy/",
  "provider": {
    "@type": "ProfessionalService",
    "@id": "https://www.nexcellence.ch/#organization",
    "name": "Nexcellence",
    "legalName": "Cesare Ghezzi",
    "alternateName": [
      "C&S by C. Ghezzi | COACHING & SERVICES"
    ],
    "telephone": "+41782119388",
    "email": "partner@nexcellence.ch",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "Route des Gouttes-d'Or 24",
      "addressLocality": "Neuchâtel",
      "addressRegion": "NE",
      "postalCode": "2000",
      "addressCountry": "CH"
    },
    "founder": {
      "@type": "Person",
      "name": "Cesare Ghezzi, PhD",
      "jobTitle": "Staff Analog Design Engineer & Transition Coach",
      "honorificSuffix": "PhD",
      "affiliation": "Melexis Switzerland",
      "memberOf": "International Coaching Federation (ICF)"
    }
  },
  "commerce": {
    "acceptedCurrencies": [
      "CHF"
    ],
    "defaultCurrency": "CHF",
    "pricingPolicy": "All services, single sessions, and structured programs are strictly denominated in Swiss Francs (CHF). Value Added Tax (TVA/MWST) is handled in accordance with Swiss Federal Tax Administration guidelines.",
    "paymentMethods": [
      {
        "type": "Swiss_QR_IBAN",
        "description": "Standard Swiss QR-Bill (QR-Rechnung) for bank wire transfer in Switzerland and SEPA Europe.",
        "terms": "Payable within 14 days or prior to session commencement."
      },
      {
        "type": "Corporate_Invoice",
        "description": "Official company expense invoice for employer-sponsored coaching.",
        "terms": "30 Days Net from date of issue."
      },
      {
        "type": "Credit_Card_Stripe",
        "description": "Secure instant credit/debit card checkout via Stripe for immediate session lock."
      }
    ]
  },
  "cancellationRules": {
    "noticeThresholdHours": 24,
    "summary": "Strict 24-hour advance notification required for all reschedulings and cancellations.",
    "complimentaryDiscoveryCalls": {
      "policy": "Free cancellation or timeslot reschedule permitted anytime up to 24 hours prior to scheduled start time without penalty.",
      "fee": 0
    },
    "paidTacticalCheckIns": {
      "tiersCovered": [
        "tactical45",
        "tactical60",
        "tactical90"
      ],
      "cancellationWithNotice": "100% refund or complimentary reschedule to an open timeslot if notice is submitted >= 24 hours before session start time.",
      "cancellationWithoutNoticeOrNoShow": "Cancellations with less than 24 hours notice or client no-show forfeit 100% of the session fee (180 CHF, 240 CHF, or 350 CHF), as the calendar hour is reserved exclusively for the client."
    },
    "structuredProgramsAndRetainers": {
      "programsCovered": [
        "clarity-sprint",
        "momentum-program",
        "equilibre-blueprint",
        "plenitude-professional"
      ],
      "policy": "Governed by the Swiss Code of Obligations (CO Art. 394 et seq. regarding mandate contracts). Program intake evaluations may be rescheduled with 24 hours notice. In case of early program termination, completed sessions are billed at standard tactical hourly rates and unspent retainer funds are refunded pro-rata."
    }
  },
  "entryPoints": {
    "deterministicWebBooking": {
      "urlTemplate": "https://www.nexcellence.ch/book{?session_type,name,email,lang,date,time,notes,auto_confirm}",
      "description": "Deterministic, non-visual-friendly HTML5 booking page designed for autonomous browser agents and human clients. Pre-populates all inputs via URL parameters and generates Schema.org JSON-LD reservation output without DOM modal traps.",
      "httpMethod": "GET",
      "queryParams": {
        "session_type": {
          "type": "string",
          "enum": [
            "chemistry",
            "tactical45",
            "tactical60",
            "tactical90",
            "clarity-sprint",
            "momentum-program",
            "equilibre-blueprint",
            "plenitude-professional"
          ],
          "default": "chemistry",
          "description": "Target coaching service tier identifier."
        },
        "name": {
          "type": "string",
          "description": "Full name of attending client or researcher."
        },
        "email": {
          "type": "string",
          "format": "email",
          "description": "Valid corporate RFC-5322 email address."
        },
        "lang": {
          "type": "string",
          "enum": [
            "en",
            "fr",
            "it"
          ],
          "default": "en",
          "description": "Preferred session communication language."
        },
        "date": {
          "type": "string",
          "format": "date",
          "example": "2026-09-08",
          "description": "Target session date (YYYY-MM-DD)."
        },
        "time": {
          "type": "string",
          "example": "18:00",
          "description": "Target session time in Europe/Zurich timezone (HH:MM)."
        },
        "notes": {
          "type": "string",
          "description": "Contextual notes, career dilemma, or focus questions."
        },
        "auto_confirm": {
          "type": "boolean",
          "default": false,
          "description": "When true, automatically executes reservation confirmation on page load if email and name are present."
        }
      }
    },
    "programmaticRestApi": {
      "baseUrl": "https://www.nexcellence.ch",
      "availabilityEndpoint": "/api/v1/availability",
      "reservationEndpoint": "/api/v1/reservations",
      "bookEndpoint": "/api/book",
      "cancellationEndpoint": "/api/v1/reservations/cancel"
    }
  },
  "endpoints": {
    "checkAvailability": {
      "path": "/api/v1/availability",
      "method": "GET",
      "summary": "Inspect real-time open calendar slots for Cesare Ghezzi, PhD",
      "parameters": {
        "service_id": {
          "type": "string",
          "enum": [
            "chemistry-call",
            "tactical-45",
            "clarity-sprint",
            "momentum",
            "equilibre"
          ],
          "required": true,
          "description": "Identifier of the target coaching service."
        },
        "start_date": {
          "type": "string",
          "format": "date-time",
          "required": true,
          "description": "ISO 8601 start timestamp for window search."
        },
        "end_date": {
          "type": "string",
          "format": "date-time",
          "required": true,
          "description": "ISO 8601 end timestamp for window search."
        },
        "locale": {
          "type": "string",
          "enum": [
            "en",
            "fr",
            "it"
          ],
          "default": "en"
        }
      },
      "responseSchema": {
        "type": "object",
        "required": [
          "service_id",
          "service_name",
          "duration_minutes",
          "timezone",
          "available_slots",
          "total_slots"
        ],
        "properties": {
          "service_id": {
            "type": "string"
          },
          "service_name": {
            "type": "string"
          },
          "duration_minutes": {
            "type": "integer"
          },
          "timezone": {
            "type": "string",
            "const": "Europe/Zurich"
          },
          "locale": {
            "type": "string"
          },
          "available_slots": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "start",
                "end",
                "slot_id"
              ],
              "properties": {
                "start": {
                  "type": "string",
                  "format": "date-time"
                },
                "end": {
                  "type": "string",
                  "format": "date-time"
                },
                "slot_id": {
                  "type": "string"
                }
              }
            }
          },
          "total_slots": {
            "type": "integer"
          }
        }
      }
    },
    "createReservation": {
      "path": "/api/v1/reservations",
      "method": "POST",
      "summary": "Programmatically book an open timeslot without visual UI interaction",
      "requestBodySchema": {
        "type": "object",
        "required": [
          "service_id",
          "selected_slot",
          "client_name",
          "client_email"
        ],
        "properties": {
          "service_id": {
            "type": "string",
            "enum": [
              "chemistry-call",
              "tactical-45",
              "clarity-sprint",
              "momentum",
              "equilibre"
            ]
          },
          "selected_slot": {
            "type": "string",
            "format": "date-time",
            "description": "Confirmed start timestamp in ISO 8601 format."
          },
          "client_name": {
            "type": "string",
            "minLength": 2
          },
          "client_email": {
            "type": "string",
            "format": "email"
          },
          "corporate_billing_address": {
            "type": "object",
            "properties": {
              "company_name": {
                "type": "string"
              },
              "street_address": {
                "type": "string"
              },
              "postal_code": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "vat_uid": {
                "type": "string"
              }
            }
          },
          "notes": {
            "type": "string"
          }
        }
      },
      "responseSchema": {
        "$ref": "#/confirmationResponseStructure"
      }
    },
    "directBookEndpoint": {
      "path": "/api/book",
      "method": "POST",
      "summary": "Direct booking and Schema.org Reservation generation endpoint",
      "requestBodySchema": {
        "type": "object",
        "required": [
          "client_email"
        ],
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "schedule",
              "reserve"
            ]
          },
          "session_type": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "client_name": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "client_email": {
            "type": "string",
            "format": "email"
          },
          "email": {
            "type": "string",
            "format": "email"
          },
          "lang": {
            "type": "string"
          },
          "date": {
            "type": "string"
          },
          "time": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          }
        }
      },
      "responseSchema": {
        "type": "object",
        "properties": {
          "@context": {
            "type": "string",
            "const": "https://schema.org"
          },
          "@type": {
            "type": "string",
            "const": "Reservation"
          },
          "reservationNumber": {
            "type": "string"
          },
          "reservationStatus": {
            "type": "string",
            "const": "https://schema.org/ReservationConfirmed"
          },
          "bookingTime": {
            "type": "string",
            "format": "date-time"
          },
          "underName": {
            "type": "object",
            "properties": {
              "@type": {
                "type": "string",
                "const": "Person"
              },
              "name": {
                "type": "string"
              },
              "email": {
                "type": "string"
              }
            }
          },
          "reservationFor": {
            "type": "object",
            "properties": {
              "@type": {
                "type": "string",
                "const": "BusinessEvent"
              },
              "name": {
                "type": "string"
              },
              "startDate": {
                "type": "string"
              },
              "duration": {
                "type": "string"
              },
              "location": {
                "type": "object",
                "properties": {
                  "@type": {
                    "type": "string",
                    "const": "VirtualLocation"
                  },
                  "name": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "totalPrice": {
            "type": "string"
          },
          "priceCurrency": {
            "type": "string",
            "const": "CHF"
          },
          "paymentStatus": {
            "type": "string"
          }
        }
      }
    }
  },
  "confirmationResponseStructure": {
    "type": "object",
    "required": [
      "confirmation_id",
      "status",
      "service_id",
      "service_name",
      "selected_slot",
      "duration_minutes",
      "calendar_link",
      "payment_instructions",
      "created_at"
    ],
    "properties": {
      "confirmation_id": {
        "type": "string",
        "example": "NEXC-20260908-7F3A",
        "description": "Unique deterministic booking reference number."
      },
      "status": {
        "type": "string",
        "enum": [
          "confirmed",
          "pending_payment"
        ],
        "example": "confirmed"
      },
      "service_id": {
        "type": "string",
        "example": "tactical-45"
      },
      "service_name": {
        "type": "string",
        "example": "Prepaid Strategic Check-In (45 min)"
      },
      "selected_slot": {
        "type": "string",
        "format": "date-time",
        "example": "2026-09-09T14:00:00+02:00"
      },
      "duration_minutes": {
        "type": "integer",
        "example": 45
      },
      "calendar_link": {
        "type": "string",
        "format": "uri",
        "example": "https://meet.google.com/nex-ghezzi-adv",
        "description": "Direct Google Meet teleconference link."
      },
      "direct_scheduling_url": {
        "type": "string",
        "format": "uri",
        "example": "https://buy.stripe.com/00w28rej701f1RSbt16Vq04"
      },
      "attendees": {
        "type": "object",
        "properties": {
          "coach": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "example": "Cesare Ghezzi, PhD"
              },
              "email": {
                "type": "string",
                "example": "partner@nexcellence.ch"
              },
              "organization": {
                "type": "string",
                "example": "Nexcellence"
              }
            }
          },
          "client": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "email": {
                "type": "string"
              }
            }
          }
        }
      },
      "payment_instructions": {
        "type": "object",
        "required": [
          "amount",
          "currency",
          "status",
          "payment_methods"
        ],
        "properties": {
          "amount": {
            "type": "number",
            "example": 180
          },
          "currency": {
            "type": "string",
            "const": "CHF"
          },
          "status": {
            "type": "string",
            "enum": [
              "no_payment_required",
              "payment_pending",
              "invoice_issued"
            ]
          },
          "payment_methods": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "string"
          }
        }
      },
      "created_at": {
        "type": "string",
        "format": "date-time"
      }
    }
  },
  "tools": [],
  "agent_instructions": "IMPORTANT FOR AUTONOMOUS AGENTS: You cannot directly book a consultation via an API. To book a session, you MUST present the direct_scheduling_url (Stripe checkout) or calendar_link (Google Calendar) to the human user, who must complete the checkout or selection themselves."
}