Map Form Filling Results to EHR

Map FormFillingResult structured_data fields to your EHR or downstream systems by form_template_id, partner_form_id, ambient_session_id, and correlation_id

This example shows how to map Form filling results to your EHR. When a session completes, onSubmit delivers a FormFillingResult with filled forms in structured_data.generated_values.

The example routes each form by form_template_id (static) or partner_form_id (dynamic) and maps the data object to your EHR fields. Use ambient_session_id to avoid duplicate saves and correlation_id to match results to your encounter. For production, run this mapping in your Webhook handler. Use SDK callbacks for in-app preview only.

TypeScript

import type { FormFillingResult } from "@suki-sdk/form-filling";

type EhrFormPayload = {
  encounterId: string;
  sessionId: string;
  formKey: string;
  fields: Record<string, unknown>;
};

function mapResultToEhr(result: FormFillingResult): EhrFormPayload[] {
  const encounterId = result.correlation_id ?? "";
  const sessionId = result.ambient_session_id;

  return (result.structured_data.generated_values ?? []).map((instance) => ({
    encounterId,
    sessionId,
    formKey: instance.partner_form_id ?? instance.form_template_id ?? instance.id, // New in v0.1.0-beta.3
    fields: instance.data as Record<string, unknown>,
  }));
}

async function saveToEhr(result: FormFillingResult) {
  const payloads = mapResultToEhr(result);

  for (const payload of payloads) {
    await fetch("/api/ehr/forms", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(payload),
    });
  }
}

Templates or schemas with no output appear in non_generated_values. Log or skip them in your handler:

TypeScript

const missing = (result.structured_data.non_generated_values ?? []).map(
  (v) => v.partner_form_id ?? v.form_template_id // New in v0.1.0-beta.3
);
if (missing.length > 0) {
  console.warn("No output for forms:", missing);
}

Available tutorials

Next steps

Webhook handler - Server-side persistence.

Get Form filling structured data - Your webhook payload does not include full output.

Callbacks - FormFillingResult field details.