Forms API Overview
Forms API Overview
Overview
- You can run
GET ccdBatchExchange
on a regular basis — once per day or as often as needed based on the practice — to pull all new forms data into your system. You should runGET patient
first so that you have any newly-registered patients in your system before adding any forms data to their records. - Demographic data (patient name, address, phone, etc.) returned by the Patient API may be more current than the data returned by the Forms API. You may want to ignore demographic data returned by the Forms API for any fields that already have values in your database.
- Medfusion APIs will follow the standard ISO8601 formats for all time elements, unless otherwise noted (http://www.w3.org/TR/xmlschema-2/#dateTime). The standard format will include the timezone. For UTC (the preferred time zone to be used for timestamps), the time zone is specified as ‘Z’. The API documentation will clearly specify any deviation from the ISO8601 recommendation.
For example, an alternative format is to specify timestamps as epochs since January 1, 1970, 00:00:00 UTC, either in seconds (POSIX time) or milliseconds (Java).
Workflow
- Make a
GET patient
request on a scheduled basis. - Process the returned data.
- Repeat the first two steps as needed to get all updated patient information.
- Run a
GET ccdExchangeBatch
request. - Process the returned data. (Do not overwrite any values that were returned by GET patient, as information from the Patient API may be more current than information from the Forms API.)
- Repeat steps 4 and 5 as needed to get all new forms information.