'Tebra (Kareo)',
'tasks' => array( 'create_patient' => 'Create Patient' )
);
return $actions;
}
add_filter( 'adfoin_settings_tabs', 'adfoin_tebra_settings_tab', 10, 1 );
function adfoin_tebra_settings_tab( $providers ) {
$providers['tebra'] = 'Tebra (Kareo)';
return $providers;
}
add_action( 'adfoin_settings_view', 'adfoin_tebra_settings_view', 10, 1 );
function adfoin_tebra_settings_view( $current_tab ) {
if ( $current_tab !== 'tebra' ) return;
$arguments = wp_json_encode( array(
'platform' => 'tebra',
'fields' => array(
array( 'key' => 'customerKey', 'label' => __( 'Customer Key', 'advanced-form-integration' ), 'hidden' => true ),
array( 'key' => 'username', 'label' => __( 'Username', 'advanced-form-integration' ) ),
array( 'key' => 'password', 'label' => __( 'Password', 'advanced-form-integration' ), 'hidden' => true ),
array( 'key' => 'practiceName','label' => __( 'Practice Name', 'advanced-form-integration' ) ),
),
) );
$instructions = __( 'Tebra (Kareo) uses a SOAP API. Request a Customer Key from Tebra Support, then enter the integration username/password and your practice name.', 'advanced-form-integration' );
echo adfoin_platform_settings_template( __( 'Tebra (Kareo)', 'advanced-form-integration' ), 'tebra', $arguments, $instructions );
}
add_action( 'adfoin_action_fields', 'adfoin_tebra_action_fields' );
function adfoin_tebra_action_fields() {
?>
'firstName', 'value' => 'First Name', 'description' => '' ),
array( 'key' => 'middleName','value' => 'Middle Name','description' => '' ),
array( 'key' => 'lastName', 'value' => 'Last Name', 'description' => '' ),
array( 'key' => 'email', 'value' => 'Email', 'description' => '' ),
array( 'key' => 'phone', 'value' => 'Home Phone', 'description' => '' ),
array( 'key' => 'mobile', 'value' => 'Mobile Phone', 'description' => '' ),
array( 'key' => 'workPhone', 'value' => 'Work Phone', 'description' => '' ),
array( 'key' => 'dob', 'value' => 'Date of Birth', 'description' => 'YYYY-MM-DD' ),
array( 'key' => 'gender', 'value' => 'Gender', 'description' => 'M / F / U' ),
array( 'key' => 'ssn', 'value' => 'SSN', 'description' => '' ),
array( 'key' => 'address', 'value' => 'Street', 'description' => '' ),
array( 'key' => 'city', 'value' => 'City', 'description' => '' ),
array( 'key' => 'state', 'value' => 'State', 'description' => '' ),
array( 'key' => 'zip', 'value' => 'Zip', 'description' => '' ),
array( 'key' => 'caseTypeId','value' => 'Case Type ID','description' => '' ),
array( 'key' => 'note', 'value' => 'Note', 'description' => '' ),
);
wp_send_json_success( $fields );
}
function adfoin_tebra_credentials_list() {
foreach ( adfoin_read_credentials( 'tebra' ) as $option ) {
printf( '', esc_attr( $option['id'] ), esc_html( $option['title'] ) );
}
}
function adfoin_tebra_request( $action, $params = array(), $record = array(), $cred_id = '' ) {
$credentials = adfoin_get_credentials_by_id( 'tebra', $cred_id );
$customer = isset( $credentials['customerKey'] ) ? $credentials['customerKey'] : '';
$username = isset( $credentials['username'] ) ? $credentials['username'] : '';
$password = isset( $credentials['password'] ) ? $credentials['password'] : '';
$practice = isset( $credentials['practiceName'] ) ? $credentials['practiceName'] : '';
if ( ! $customer || ! $username || ! $password ) return;
$url = 'https://webservice.kareo.com/services/soap/2.1/KareoServices.svc';
$request = array_merge( array(
'CustomerKey' => $customer,
'User' => $username,
'Password' => $password,
'PracticeName' => $practice,
), $params );
$args = array(
'timeout' => 45,
'method' => 'POST',
'headers' => array(
'Content-Type' => 'text/xml; charset=utf-8',
'SOAPAction' => 'http://www.kareo.com/api/schemas/KareoServices/' . $action,
),
'body' => adfoin_tebra_build_envelope( $action, $request ),
);
$response = wp_remote_request( $url, $args );
if ( $record ) adfoin_add_to_log( $response, $url, $args, $record );
return $response;
}
function adfoin_tebra_build_envelope( $action, $params ) {
$body = '';
foreach ( $params as $key => $value ) {
if ( is_array( $value ) ) {
$body .= "<{$key}>" . adfoin_tebra_build_envelope( '', $value ) . "{$key}>";
} else {
$body .= "<{$key}>" . htmlspecialchars( (string) $value, ENT_XML1, 'UTF-8' ) . "{$key}>";
}
}
if ( ! $action ) return $body;
return '' .
'' .
'' . $body . '' .
'';
}
/**
* Tebra's (Kareo) SOAP service is WCF/.NET-generated — confirmed via its
* RequestHeader (CustomerKey/User/Password) and related resource fields
* (PatientID, AppointmentID, RenderingProviderID, BatchNumber), all
* PascalCase. The Patient element names below follow that same confirmed
* convention; exact spelling wasn't independently verifiable against the
* WSDL/XSD (only the top-level schema/operation were reachable), so treat
* this as a best-effort mapping — if CreatePatient silently drops fields,
* check the account's Integration Guide PDF (from Tebra Support) for the
* authoritative Patient schema.
* @link https://webservice.kareo.com/services/soap/2.1/KareoServices.svc?wsdl
*/
function adfoin_tebra_build_patient_payload( $fields ) {
$map = array(
'firstName' => 'FirstName',
'middleName' => 'MiddleName',
'lastName' => 'LastName',
'email' => 'Email',
'phone' => 'HomePhone',
'mobile' => 'MobilePhone',
'workPhone' => 'WorkPhone',
'dob' => 'DOB',
'gender' => 'Gender',
'ssn' => 'SSN',
'note' => 'Note',
'caseTypeId' => 'CaseTypeID',
'address' => 'Address',
'city' => 'City',
'state' => 'State',
'zip' => 'Zip',
);
$patient = array();
foreach ( $map as $local => $remote ) {
if ( ! empty( $fields[ $local ] ) ) $patient[ $remote ] = $fields[ $local ];
}
return $patient;
}
function adfoin_tebra_create_patient( $fields, $record, $cred_id ) {
$patient = adfoin_tebra_build_patient_payload( $fields );
return adfoin_tebra_request( 'CreatePatient', array( 'Patient' => $patient ), $record, $cred_id );
}
add_action( 'adfoin_tebra_job_queue', 'adfoin_tebra_job_queue', 10, 1 );
function adfoin_tebra_job_queue( $data ) {
adfoin_tebra_send_data( $data['record'], $data['posted_data'] );
}
function adfoin_tebra_send_data( $record, $posted_data ) {
$record_data = json_decode( $record['data'], true );
if ( isset( $record_data['action_data']['cl'] ) && adfoin_check_conditional_logic( $record_data['action_data']['cl'], $posted_data ) ) return;
$data = isset( $record_data['field_data'] ) ? $record_data['field_data'] : $record_data;
$cred_id = isset( $data['credId'] ) ? $data['credId'] : ( isset( $record['cred_id'] ) ? $record['cred_id'] : '' );
$fields = array();
foreach ( $data as $k => $v ) {
$parsed = adfoin_get_parsed_values( $v, $posted_data );
if ( $parsed !== '' && $parsed !== null ) $fields[ $k ] = $parsed;
}
if ( $record['task'] === 'create_patient' ) {
adfoin_tebra_create_patient( $fields, $record, $cred_id );
}
}