MedGEO reads the surgery schedule from the EMR/EHR system. This is communicated to MedGEO either by sending XML or JSON in an HTTP request, or if the EHR system supports FHIR, then MedGEO reads it form the server of the partner. This is also communicated in HL7 format with MedGEO.

Communication Protocol
  • FHIR: Fully supports the FHIR standards for health information exchange, allowing MedGEO to read the scheduling information for example using resources like Appointment, Schedule, Slot and Procedure.
  • MedGEO's API: Our REST API supports customized integrations for direct system-to-system communication and is used to receive information about surgery schedule
  • Partner's API: Integrating with partner APIs to fetch surgical schedules as per agreed intervals or in real-time.
  • File servers (SFTP): Securely retrieves scheduled surgery data via SFTP, ensuring data integrity and security during transmission.
Data Format
  • XML: Configurable to various XML schemas, supporting extensive data structures across different communication protocols.
  • JSON: Flexible JSON structure adaptation to match partner systems for seamless data exchange.
  • HL7: Supports SIU and SCH messages over API and SFTP, with potential for MLLP implementation based on partner requirements.
Supported Fields
  • Procedure Fields:
    • Procedure Number
    • Procedure Type
    • Procedure Codes
    • Procedure Date Time
    • Procedure Status
    • Surgeon First Name
    • Surgeon Last Name
    • Visit Number
    • Location Number/Name
      • Facility
      • Building
      • Floor
      • Room
  • Patient Fields:
    • MRN
    • Patient First Name
    • Patient Last Name
    • DOB
Example HL7 Message and Field Mapping
HL7 Message:

MSH|^&|test|test Clinic|partner EHR|test Clinic|20190423114154||SIU^S12|8907-45|P|2.3|||NE|NE
SCH|1209|13030|||1209|OV15^OFFICE VISIT-15^CSI^N|OFFICE VISIT-15^OFFICE VISIT-15 -|OV15|15|m|^^15^20190423140000^20190423141500|||||name2^ame2^name2||||name2^name2last^name2first|||||Scheduled^^CSI
PID|1||150||patient^integration^^007||19770920|M|||007 Soho Lane^^Cary^NC^27511||(919)007-0007^^^^^919^0070007(777)707-0707^^CP^^^777^7070707~^NET^X.400^007@test.com|(919)851-6177 X007^^^^^919^8516177^007||M||150|007-00-0007|||||||||||N
PV1|1|R|||||idoc^doctor^integration^S^phd^^^^&MR1127&UPIN||prov1^providerLast, M.D.^provider1^N^^^^^&W22630&UPIN|||||||N||||M
AIG|1||name2, name2|P^^CSI
AIL|1||MainOffi^^^MainOffi^^^^^test|^test Clinic^CSI
AIP|1||flast1^lastName^firstName^^^^^^&F12456&UPIN|D^lastName, firtName||20190423140000|||15|m^Minutes

Fields to Extract:
  • Patient Name: Extracted from PID segment, fields PID-5-1 (First Name) and PID-5-0 (Last Name).
  • Medical Record Number (MRN): Extracted from PID segment, field PID-3-0.
  • Date of Birth (DOB): Extracted from PID segment, field PID-7-0.
  • Surgery Date and Time: Extracted from SCH segment, field SCH-11-0-0.
  • Procedure Type: Extracted from AIG segment, field AIG-3-0-0.
  • Location: Extracted from AIL segment, field AIL-3-0-0.
  • Surgeon Name: Extracted from AIP segment, fields AIP-1-0-1 (First Name) and AIP-1-0-0 (Last Name).
  • Duration: Extracted from AIP segment, field AIP-9-0-0.
Customization of Field Mapping

Above is our default field location mapping from the HL7 message. This can be customized in case the partner is using a different location for some of the fields. Please contact our support team to configure the field mappings according to your specific requirements.
Data Submission Methods
API Submission:

HL7 messages can be sent via an API call to /api/v1/inbound/hl7 where the message is included in the API call body as text. This method ensures real-time processing and integration into our system.

SFTP Submission:

Alternatively, HL7 messages can be uploaded to our SFTP server under the folder shared with the partner. Our Service Level Agreement (SLA) to process files from the SFTP server is within 5 minutes, ensuring timely and efficient data handling.
Example of XML Submission for Scheduling
XML Example:
Click to expand XML example 
                                        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
                                        <Header Application="SISConnect" Version="3.2.8" BUID="29" CreateDateTime="20230810030523" VendorAppName="OnePartnerOBXML" FacilityName="Ambulatory Surgery Center East Side" FacilityAcronym="Ambulatory Surgery Center East Side234" FacilityNPI="1821242488" FacilityTimeZone="Hawaiian Standard Time">
                                          <PatientData>
                                            <Patient Accountnumber="123456" MRN="123456" PatientID="66666" LastName="MMRN34" FirstName="MMRN34" MI="M" DOB="19900101" SSN="989898700" Sex="M" MaritalStatus="Single" RaceCode="White" Nationality="" Language="" HomePhone="7742399428" WorkPhone="5083341000" WorkPhoneExtn="" OtherPhone="" CellPhone="7742399428" Email="FIRSTNAMELASTNAME@test.com" ExternalID="746923107" RaceId="2106-3" EthnicityId="H" EthnicityCode="Hispanic">
                                              <Addresses>
                                                <Address AddressType="M" AddressLine1="286 MAIN ROAD" AddressLine2="Roll Stone Ave" City="OXFORD" State="MA" ZipCode="01540" ZipPlus4="" Country="Other" EmployerName="" Occupation=""/>
                                              </Addresses>
                                              <PatientVisit>
                                                <VisitInformation VisitNumber="6175" TypeOfVisit="Pain Management " VisitStatus="" CaseNumber="6175" AppointmentNumber="57336" TypeOfCase="" Status="U" ApptStatus="SCHEDULED" ScheduledDate="20230123" ScheduledTime="04:00:00:000" ScheduledEndDate="20230123" ScheduledEndTime="04:15:00:000" Duration="15" DurationUnits="Mins" Anesthesia="" Room="HighPoint Bed 2" RoomType="" OthPhysID="" OthPhysLastName="" OthPhysFirstName="" RefPhysID="0" RefPhysLastName="" RefPhysFirstName="" Remarks1="" Remarks2="" CancellationReason=""/>
                                                <PatientProcedures>
                                                  <ProcedureInformation PhysicianID="118" PhysicianLastName="testname sr" PhysicianFirstName="testname2" PhysCredentials="" NPI="" GNPI="" ProcedureSequence="0" ProcedureCode="27003" ProcedureDescription="Tenotomy, adductor, subcutaneous, open, with obturator neurectomy" BodySide="LEFT" ICDCode_1="" ICDdescription_1="" ICDCode_2="" ICDdescription_2="" ICDCode_3="" ICDdescription_3="" ICDCode_4="" ICDdescription_4="" ICD10Code_1="C000" ICD10description_1="Malignant neoplasm of external upper lip" ServiceCode="" ServiceCodeDesc="" ModifiedProcedureDescription="Test Modified Procedure Description for Tenotomy, Test Modified Procedure Description for Tenotomy,Test Modified Procedure Description for Tenotomy."/>
                                                </PatientProcedures>
                                                <PatientEquipment>
                                                  <EquipmentInformation EquipmentID="" EquipmentDescription=""/>
                                                </PatientEquipment>
                                                <PatientGuarantor>
                                                  <GuarantorInformation GuarantorNumber="2530" GuarantorLastName="GUA" GuarantorFirstName="NewGUa" GuarantorMIName="" GuarantorDOB="20100202" GuarantorSSN="" GuarantorSex="M" RelationToPatient="021323" GuarantorAddress1="Add1" GuarantorAddress2="Add2" GuarantorCity="Newton Falls" GuarantorState="OH" GuarantorZipcode="44444-4444" GuarantorHomePhone="" GuarantorWorkPhone="" GuarantorWorkPhoneExtn="" GuarantorEmpName="" GuarantorEmpID=""/>
                                                  <GuarantorInformation GuarantorNumber="33842" GuarantorLastName="MMRN34" GuarantorFirstName="MMRN34" GuarantorMIName="M" GuarantorDOB="19900101" GuarantorSSN="989898700" GuarantorSex="M" RelationToPatient="Self" GuarantorAddress1="286 MAIN ROAD" GuarantorAddress2="Roll Stone Ave" GuarantorCity="OXFORD" GuarantorState="MA" GuarantorZipcode="01540" GuarantorHomePhone="7742399428" GuarantorWorkPhone="5083341000" GuarantorWorkPhoneExtn="" GuarantorEmpName="" GuarantorEmpID=""/>
                                                </PatientGuarantor>
                                                <PatientInsurances>
                                                  <InsuranceInformation InsuranceID="4500" PayerCode="66666" InsuranceName="Aetna" InsuranceRole="PI" InsuranceOfficeName="Test" InsuranceType="Test" AssignOfBenefits="Yes" Address1="Street Lane" Address2="" City="NY" State="NY" ZipCode="72701" InsPhone="9999955522" InsuredLastName="MMRN34" InsuredFirstName="MMRN34" InsuredMiName="M" InsuredDOB="19900101" InsuredSSN="989898700" InsuredSex="Male" RelationToInsured="Self" InsuredAddress1="286 MAIN ROAD" InsuredAddress2="Roll Stone Ave" InsuredCity="OXFORD" InsuredState="MA" InsuredZip="01540" InsGroupName="01212312" InsGroupNum="541545" PreAuthNum="" InsRep="" VerifyByCode="" VerifyByLastName="" VerifyByFirstName="" VerifyByMIName="" VerifyDateTime="1/23/2023 12:09:34 PM +00:00" CoPayment="0" Deposit="" policyDeductable="500" InsuredEmplName="MMRN34MMRN34" InsuredEmplID="" InsuredEmplIDNumber="5421236" PlanEffectiveDate="20150303" PlanExpirationDate="20301212" InsuredEmplAddress1="286 MAIN ROAD" InsuredEmplAddress2="Roll Stone Ave" InsuredEmplCity="OXFORD" InsuredEmplState="MA" InsuredEmplZipCode="01540" InsuredEmplStatus=""/>
                                                  <InsuranceInformation InsuranceID="4565" PayerCode="60005" InsuranceName="Bajaj" InsuranceRole="SI" InsuranceOfficeName="Bajaj" InsuranceType="" AssignOfBenefits="No" Address1="36 Rollstone Ave" Address2="" City="Fayetteville" State="AR" ZipCode="72701" InsPhone="" InsuredLastName="MMRN34" InsuredFirstName="SPouse02" InsuredMiName="S" InsuredDOB="19990202" InsuredSSN="" InsuredSex="Female" RelationToInsured="Spouse" InsuredAddress1="286 MAIN ROAD" InsuredAddress2="Roll Stone Ave" InsuredCity="OXFORD" InsuredState="MA" InsuredZip="01540" InsGroupName="GN01" InsGroupNum="0101" PreAuthNum="" InsRep="" VerifyByCode="" VerifyByLastName="" VerifyByFirstName="" VerifyByMIName="" VerifyDateTime="" CoPayment="" Deposit="" policyDeductable="" InsuredEmplName="MMRN34SPouse02" InsuredEmplID="" InsuredEmplIDNumber="02103100" PlanEffectiveDate="20100101" PlanExpirationDate="20301212" InsuredEmplAddress1="286 MAIN ROAD" InsuredEmplAddress2="Roll Stone Ave" InsuredEmplCity="OXFORD" InsuredEmplState="MA" InsuredEmplZipCode="01540" InsuredEmplStatus=""/>
                                                  <InsuranceInformation InsuranceID="4566" PayerCode="Payercode" InsuranceName="BCBS MCR" InsuranceRole="TI" InsuranceOfficeName="BCBS MCR REPLACE PPO" InsuranceType="Test" AssignOfBenefits="No" Address1="PO BOX 986020" Address2="" City="Boston" State="MA" ZipCode="02298" InsPhone="" InsuredLastName="MMRN34" InsuredFirstName="MMRN34" InsuredMiName="M" InsuredDOB="19900101" InsuredSSN="989898700" InsuredSex="Male" RelationToInsured="Self" InsuredAddress1="286 MAIN ROAD" InsuredAddress2="Roll Stone Ave" InsuredCity="OXFORD" InsuredState="MA" InsuredZip="01540" InsGroupName="GN03" InsGroupNum="0303" PreAuthNum="" InsRep="" VerifyByCode="" VerifyByLastName="" VerifyByFirstName="" VerifyByMIName="" VerifyDateTime="" CoPayment="" Deposit="" policyDeductable="" InsuredEmplName="MMRN34MMRN34" InsuredEmplID="" InsuredEmplIDNumber="2121" PlanEffectiveDate="20200606" PlanExpirationDate="20501212" InsuredEmplAddress1="286 MAIN ROAD" InsuredEmplAddress2="Roll Stone Ave" InsuredEmplCity="OXFORD" InsuredEmplState="MA" InsuredEmplZipCode="01540" InsuredEmplStatus=""/>
                                                </PatientInsurances>
                                                <PatientExternalSourceIdentifier>
                                                  <ExternalSourceIdentifier ID="1" SourceIdentifer="7a46a7ec-4f63-412c-aafd-f4c54682b839" InterfaceType="" ExternalCaseRequest="" ExternalMRN="746923106" Alias="patientupload"/>
                                                  <ExternalSourceIdentifier ID="2" SourceIdentifer="87efde98-e4df-4e1c-a03f-71a691292f93" InterfaceType="" ExternalCaseRequest="" ExternalMRN="746923107" Alias="ADT207"/>
                                                </PatientExternalSourceIdentifier>
                                              </PatientVisit>
                                            </Patient>
                                          </PatientData>
                                        </Header>

This XML is from SIS and showcases how we handle scheduling data. We support different schema upon request from the partners to ensure compatibility with various systems.
Submission Methods:
  • API Submission: XML data can be sent via a POST request to /api/v1/inbound/scheduling/xml with the body type as application/xml. This method facilitates real-time processing and integration.
  • SFTP Submission: Alternatively, XML files can be sent to our SFTP server in a directory provided to the partner by MedGEO. This method ensures secure and efficient data handling according to our SLA.