BBCS Integration
Blood Bank Computer Systems, Inc. (BBCS) is a dedicated partner to the blood bank industry.
How to integrate BBCS and DailyStory
BBCS integration with DailyStory requires several steps.
- BBCS API URL and API Key
First, you'll need to contact BBCS and request an API URL and API Key. These are required to set up the integration with DailyStory.
- Enable integration in DailyStory
Navigate to Account Settings > Integrations, and select Blood Bank Computer Systems. Enter the API URL and API Key obtained in Step 1.
- Set the BBCS version
Leave the version blank or use v3 for the version unless instructed otherwise by BBCS.
Congratulations. BBCS integration is now successfully configured! Data will begin importing into DailyStory from BBCS.
Click the "Save" button and the BBCS integration will save and registration for sync.
BBCS Sync Schedule
The BBCS sync, which connect to BBCS to fetch donor data, run approximately every hour. It can take up to 15 minutes to complete a sync.
Data Synced from BBCS to DailyStory
DailyStory syncs a variety of data from BBCS.
Standard Contact Fields
| Field Name | Notes |
| First name | The first name of the donor, |
| Last name | The last name of the donor, |
| Date of birth | The donor's date of birth, |
| City | The donor's city, |
| State | The donor's state, |
| Postal Code | The donor's postal code, |
| Mobile phone number | Looks for a phone number registered as "MPHN". If not found next attempts to find a phone number registered as "CELL". |
| Home phone number | Looks for a phone number registered as "HPHN". |
| Work phone number | Looks for a phone number registered as "WPHN". |
| Email address | Looks for an email registered as "EMAL". If not found defaults to the next available email address associated with the donor. |
| Gender | The donor's gender, |
Donor Fields
| Field Name | Notes |
| Blood type | Resolves the blood type from BBCS into a standard format, e.g. o+ to opos. If the blood type is unknown the blood type is stored as unknown. An additional friendly name is set based on the blood type, e.g. O+. This standardization of fields is done because different blood centers use various coding for blood type. |
| Donor UUID | The unique GUID of the donor, |
| Donor Number | The unique number of the donor, |
| Next Recruit Date | The next recruit date for the donor from BBCS. This date is only set if the date is a future, not past, date. |
| Next Appointment Date | The next appointment date of the donor is only set if BBCS is configured to run version 2 of the integration. For newer customers this field is set using the Degree 37 integration. |
| CMV Status | Sets the CMV status of the donor if the donor has an associated CMV status. |
| Group Codes | Sets one or more group codes associated with the donor. |
Donor Eligibility
Returns the donor eligibility data for the following.
| Field Name | Notes |
| Whole Blood | Returns donor eligibility data for the *ZWB code. |
| Platelet | Returns donor eligibility data for the *PLT code. |
| Double Red | Returns donor eligibility data for the *2R code. |
| Plasma | Returns donor eligibility data for the *PLS code. |
| Covid Plasma | Returns donor eligibility data for the *CCP code. |
Each blood product sets the following:
| Field Name | Notes |
| Next Eligible Date | The date that the donor is next eligible to donate this product. |
| Last Date | The date the donor last donated this product. |
| Donation YTD | The total number of donations year to date. |
| Donation LTD | The total number of donations for the life time of the donor. |
| Donation Last Year | The total number of donations in the past 12 months. |
Product Donations
| Field Name | Notes |
| Last Location | The last location the donor donated at. |
| Source | The source of the last donation. |
| Last Donation Group | The last group code associated with the donation. |
| Donation Outcome | The outcome of the donation: Appeared, Donated, Donor Left, Unusable, Post Draw Deferral, deferred. |
| Last Donation Date | The date the donor last donated. |
| Last Donation Product | The blood product the donor last donated. |
| Donation Outcome | The friendly name of the donor outcome. |
Donor Merge
During sync the DailyStory BBCS sync will use the donors merged API to process any donors that BBCS instructs DailyStory to merge into a single record.
Permanent Deferrals
A permanent deferral is a donor that cannot (permanently) donate. If the eligibility date of a product is set to the year 9999 the product type is considered permanently deferred. If all the donor's product eligibility dates are set to 9999 the donor is considered permanently deferred.
Loyalty and Rewards
The following activities from BBCS generate loyalty points:
- New Donor - when a new donor signs up
- Schedule an Appointment - each time a donor schedules an appointment
- Whole Blood Donation - each time a donor donates whole blood
- Platelet Donation - each time a donor donates platelets
- Double Red Donation - each time a donor donates double reds
- Covid 19 Convalescent Plasma - each time a donor donates convalescent plasma