# Access App Landing Page

How to Access App Landing page from BJCP Home Page. This function does not require you to be logged into your account.

* Click on "Judge Account" button on the right as shown in picture

<figure><img src="/files/V5OMBH7chSpCaU0aGDR3" alt=""><figcaption></figcaption></figure>

* This should take you to the App Landing Page as shown below

<figure><img src="/files/6qagbFP6D1X8PZpC2Ed4" alt=""><figcaption></figcaption></figure>


# Get Back to BJCP Home Page

How to get back to BJCP Home Page from App Landing Page

* Click on "BJCP" icon as shown in the picture below

<figure><img src="/files/xyP3lPLmjPARvyOhwjCm" alt=""><figcaption></figcaption></figure>

* This takes you back to the BJCP Home page as shown below

<figure><img src="/files/7ux3zYmMnPJcs9OJQF5f" alt=""><figcaption></figcaption></figure>


# Log In & Change Password

How to login to your judge account and reset/change your password

You can login to your BJCP account using your existing login ID (which is your BJCP ID) and your current password as shown below. \
\
Once logged in - it is **highly recommended** that you change your password as shown below. A warning will continue to appear on your judge account until you reset your password.&#x20;

It is also recommended to get your your email address verified from your judge records (See "Access Your Judge Record" documentation). Your email address will continue to show "Unverified" until you verify your email address.&#x20;

**Login**

* Click Login on the App page top-level menu.&#x20;

<figure><img src="/files/asnHAqO3ij0ixUnIsHyw" alt=""><figcaption></figcaption></figure>

* Enter your existing BJCP Judge ID and Password

<figure><img src="/files/iBatEkFQeU0LqQaNaOH2" alt=""><figcaption></figcaption></figure>

**Reset Password**

* Click on Reset Password link in the warning at the top of the Bravo landing page once logged in. You can also access "Change Password" in your Judge Record.&#x20;

<figure><img src="/files/RwVvY9S7pn2CLkPBZlrd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/oseKTsCrTcgK6gb1JJKe" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5QNtuJjsvckm6k345zTu" alt=""><figcaption></figcaption></figure>


# Lookup a Judge

How to lookup a judge - you must have the BJCP Judge ID OR both Full first name and last name. This function does not require you to be logged into your account.

* Click on "Judges" Menu and then "Judge Lookup"&#x20;

<figure><img src="/files/vQ2OF8rXbKgkbkOF2xjM" alt=""><figcaption></figcaption></figure>

* Enter Judge ID or BOTH First Name AND Last Name (FULL - and **exactly** as they appear on their judge records)

<div><figure><img src="/files/dTInCuafDqMzCBTrigjr" alt=""><figcaption></figcaption></figure> <figure><img src="/files/xfniYujNkI9tyQjYvMjP" alt=""><figcaption></figcaption></figure></div>


# Access Judge Reports

How to access Various Judge reports. This function does not require you to be logged in to your account.

These are reports that list current:

* Master Level judges, Distinguished National, National and Distinguished Certified judges.&#x20;
* Current Mead and Cider Judges.&#x20;
* For those planning to run a Beer, Mead or Cider exam - you can find Proctor level judges for each of these exams. (For reference, judges who are National or higher are allowed to proctor a beer exam and judges who have scored higher than 80 in Mead or Cider Exam are allowed to proctor those exams - all after approval from the Exam Directorate)
* If you are want to take a written exam - you can find approved "Written Exam Admins" (For reference - National level or higher judges who are also exam graders are allowed to run a written exam after approval from the Exam Directorate)&#x20;
* Competition Organizers with upcoming competitions can access current list of judges to download in CSV format by clicking on "Judge List" - See separate help page for this functionality for more details.&#x20;
* "Judges Missing Email" is a list of BJCP judges whose email address are not on file (or are bouncing) - the purpose of this list is that **if you know any of these judges - please let them know to update their email address.**&#x20;

<figure><img src="/files/83MIimxt3P04p6orwSqo" alt=""><figcaption></figcaption></figure>


# Get to App Landing page from Within the App

How to get to Top Level page from one of the pages within the Bravo

* Click on "Home" as shown below

<figure><img src="/files/UmyKG5rgQKr11lb7CgFM" alt=""><figcaption></figcaption></figure>


# Access Your Judge Record

How to Access Your Judge Record and related functionality (Change address, Change Password, Change Email address, Verify email address, set up email preferences etc.)

* From App Landing/Home page - click on "My Record" OR click on "My Record" from your account menu drop down.&#x20;

<figure><img src="/files/D0d7VDVBrolIQN6jce1S" alt=""><figcaption></figcaption></figure>

* You Judge record contains:
* You Current rank, your certificates, your badges etc.&#x20;
* Records of your Exams - Scores, RTPs etc
* Records of competitions you have judged&#x20;
* Your Rank Advancement History
* Progress towards your next Rank
* Any Exam Grading, Proctoring, Admin Points
* Continuing Education and other Experience Points
* Account related functionality as described below

<figure><img src="/files/4yHo3p2LxjQVP8vtnPiQ" alt=""><figcaption></figcaption></figure>

* You must verify your email address when using Bravo for the first time - click on "Send Verification" button&#x20;

<figure><img src="/files/OQ9ee7Hig7TnNCReyCaW" alt=""><figcaption></figcaption></figure>

* You can change your Password from your judge record as follows

<figure><img src="/files/oseKTsCrTcgK6gb1JJKe" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Ld8KTMcdtOsXeHwskApD" alt=""><figcaption></figcaption></figure>

* You can change your address, email address etc. by clicking on "Update Info" Button. Note that all changes are effective immediately.&#x20;

<figure><img src="/files/cofExGv29yYxZecYxprw" alt=""><figcaption></figcaption></figure>

* You can edit a number of account related preferences as shown below:&#x20;
  * "Retired" - if the "Retired" box is checked - you are marked as retired from BJCP organization and will not be contacted. However, you can log in and mark your self not retired any time in future. You might still receive communication from competitions who are not using the latest judge list.&#x20;
  * "Include in Newsletter Email List" - Uncheck this if you do not want to receive BJCP Newsletters
  * "Include in Judges List" - Uncheck this if you do not want to be included in Active judges list. NOTE that this means you may not receive competition invitation emails. NOTE ALSO that this does not guarantee that you will not receive competition invitation emails because some competition organizers have their own lists.&#x20;

<figure><img src="/files/7p87XT8MUeM83fmCpxQZ" alt=""><figcaption></figcaption></figure>


# Order Lapel Pins/Badges/Sensory Kits

Order Lapel Pins, Badges and Sensory Kits from your account

Pins, Badges and Sensory kits can be ordered from your account.&#x20;

* Pins and Badges can be ordered for free every time your rank is updated or if you get an additional endorsement (Cider or Mead)
* Discounted Sensory Kits can be ordered in a limited manner (and until a given year's budget for sensory kit discount is exhausted).&#x20;
* You may be limited to order pins, badges or sensory kits once every X number of months as determined by BJCP Board or corresponding directorate (Communication Directorate for Lapel Pins/Badges and Education Directorate for Sensory Kits).&#x20;
* There may be shipping restrictions on Lapel Pins, Badges or Sensory Kits - order form will notify you of this.&#x20;
* Ordering system will track your previous order and may not allow you to order Lapel Pin, Badges or Sensory kit if you are not eligible for it.&#x20;
* Exceptions can be made - you can reach out by email to corresponding volunteer handling each item from each respective order form.&#x20;
* To Access Lapel Pin/Badge/Sensory Kit Order page - click on the corresponding item on the "Account" submenu

<figure><img src="/files/68ocKtb9i7TqW2nc0biD" alt=""><figcaption></figcaption></figure>

* Fill out the information required on each form and follow the instructions to submit the order form.&#x20;


# See Upcoming Competitions

See a list of upcoming competition - with search/filter functionality. This function does NOT require you to be logged into your account.

* Click on Competitions Menu and then on "Upcoming Competitions"&#x20;

<figure><img src="/files/UYpJ42wiEMGpJKnLFXkg" alt=""><figcaption></figcaption></figure>

* Alternately - Click on "Upcoming Competitions" on the "Home" (Landing) page&#x20;

<figure><img src="/files/YtxWpmgc8t4AjsqARIMh" alt=""><figcaption></figcaption></figure>


# Find Past Competitions

Find past competitions.

* Click on "Competitions Menu" to see a number of past competitions lists.&#x20;

<figure><img src="/files/HmgScitAkT4s06lo93wj" alt=""><figcaption></figcaption></figure>

* These lists specifically are:&#x20;
  * "Competitions Waiting for Report"&#x20;

    In case you judged a competition and your points are not showing up in your record yet - most likely that is because competition organizer has **not** submitted a report yet. If the competition is in this list - please reach out to competition organizer first to ask him/her to submit the report.&#x20;
  * "Delinquent Competitions"&#x20;

    This is similar to "Competitions Waiting for Report" except that these competitions are **past their report submission deadline**. If your comp is in this list or if you know someone whose competition is in this list - please let them know that their competition is delinquent.&#x20;
  * "Complete Competitions"&#x20;

    This is primarily for finding competition ID and contact information for past competition if needed for requesting missing judging/non-judging points in your record.
  * "Largest Competitions"&#x20;

    This is simply a list of competitions with 500 entries or more. One can filter these by search words if needed.&#x20;


# Register and Pay for a Competition (Organizer Only)&#x20;

Register and pay for a competition. This is accessible to both BJCP and NON-BJCP persons (no login required). However, Competitions fees are discounted for BJCP judges.

* You can access competition registration from the landing page or from the "Competitions" menu as shown below.&#x20;

<figure><img src="/files/ePk0JHkWvYuIP045qQuO" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/y2dC2AOwiyX2KfKoll6U" alt=""><figcaption></figcaption></figure>

* In above pictures - first click on "Register" to register a competition. After that - click on "Make a Payment" to pay for that competition. Please note that you must pay IMMEDIATELY after registering the competition before your competition is approved and posted on the competition calendar.&#x20;
* Competition Registration fee is discounted if prior to registering the competition, you log into your BJCP account.&#x20;
* Another advantage of registering for your competition after logging in to your BJCP account is you can access your registered competitions WITHOUT requiring competition password (this includes the ability to edit competition info, getting current active judges list and submitting competition report).&#x20;
* All competition organizers who are not BJCP judges can perform all competition required functions but they will be required to enter their competition ID (which will be emailed to them on competition approval).&#x20;
* Registration process in details is as follows:&#x20;
  * Enter Competition Name, Date, Location, Entry Fees, etc. in the registration form and click on Submit (if you are logged in - your details will be auto-populated).&#x20;

<figure><img src="/files/pxISzyhEECxdR3h57wRj" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/sHWA3b6pq2Du1Atj1l5d" alt=""><figcaption></figcaption></figure>

* On Submit - it will take you to payment page - NOTE only option available to pay is via PayPal. Depending your country of origin - PayPal may allow you to use a credit card to pay for a competition without requiring a PayPal account.&#x20;
  * Please NOTE that you MUST make payment for your competition as soon as you register it - your competition will not be considered for approval till payment is received.&#x20;

<figure><img src="/files/QocpLNzReGrnwVaZRYZB" alt=""><figcaption></figcaption></figure>

* You can also access your competitions from list of "My Organized Competitions" as shown below:
* From the Competition Menu

<figure><img src="/files/PcDcPJdo6XA5IRVNGcdj" alt=""><figcaption></figcaption></figure>

* From the Landing page&#x20;

<figure><img src="/files/1dbztKE0o6pnRF8KDulS" alt=""><figcaption></figcaption></figure>

* Once the competition is on the list of your organized competitions - you can perform a number of functions:&#x20;
  * Payment for competition
  * Edit competition information (such as date, location, entry fees, website link etc.)
  * Set up or reset competition password (to allow someone else other than yourself to submit/edit competition data)&#x20;
  * Cancel the competition&#x20;

<figure><img src="/files/F5G6rgXgf9yeQtYAXj09" alt=""><figcaption></figcaption></figure>


# Get list of Active Judges (Organizer Only)

How to get list of currently Active Judges - this is ONLY for the purpose of sending emails for upcoming competitions and available ONLY to upcoming competition organizers.

* Click on "Judges" menu and then "Active Judges"&#x20;

<figure><img src="/files/Wjg23KBl9BymGqX1wf7M" alt=""><figcaption></figcaption></figure>

* This takes you to following page

<figure><img src="/files/xv5duFYQubCZilTkAr7a" alt=""><figcaption></figcaption></figure>

* Select your competition from the drop down list (ONLY upcoming competitions are listed here)

<figure><img src="/files/DdtO5fnyzcUCtVIfKbjM" alt=""><figcaption></figcaption></figure>

* At this point you will be required to provide password for the competition - which you should have received by email at the time of competition approval. (If you have misplaced your competition password - you can reset it from "Your Competitions" page in your account - this option is not available to Non-BJCP comp organizers).&#x20;

<figure><img src="/files/Wae92K0ZTO9OMkXBpv5j" alt=""><figcaption></figcaption></figure>

* Once you enter password - you should have access to a list of currently active judges. You can search and sort/filter this list if needed and download the list as CSV file by clicking on "Download CSV"

<figure><img src="/files/I7hA4BPxed1TrIDgqIcd" alt=""><figcaption></figcaption></figure>


# Submit a Competition Report (Organizer Only)

Submit a competition report after Competition is completed - NOTE: BOS winner information should NOT be entered.

Note that this functionality is available ONLY to competition organizers. It can be accessed from the main landing page as shown in images below and explained below:

1. If you are a BJCP Judge: After logging in from your judge account - competition password is NOT required in this case.
2. If you are NOT a BJCP Judge:  A competition password (emailed to you at the time of competition approval) is REQUIRED.&#x20;

The following image shows two potential ways to Access Competition Report function.&#x20;

<figure><img src="/files/DmQ4LEohe8YIskWfBNQn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/eMlkE9JbOtKX63NK9S1Q" alt=""><figcaption></figcaption></figure>

* Find the competition that you want to submit a report for:&#x20;

  NOTE that only competitions that are completed (i.e., dates are in the past) AND report has not been submitted yet will show up on the list. If you need to make changes to a report you have already submitted - you will have to email <it_director@bjcp.org> and <comp_director@bjcp.org> with a list of changes with competition ID and all relevant judge information.&#x20;

<figure><img src="/files/iSQBBN4pWBoS8hPYRoS3" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/D4SZVQxKuIExLyATeZtE" alt=""><figcaption></figcaption></figure>

* If you are NOT a BJCP Judge clicking on "Next Step" after selecting the competition will bring you to "Competition Password" page. Enter competition password (Emailed to you at the time of competition approval).&#x20;

<figure><img src="/files/8t6PRyAvWrRxnz9TAoOA" alt=""><figcaption></figcaption></figure>

* If you are a BJCP Judge AND the competition is registered under your account - you will be taken to Competition report page without requiring a password.&#x20;

<figure><img src="/files/vgYkLlXR2TYqSCjDSQtb" alt=""><figcaption></figcaption></figure>

* As shown above - at this point you have 3 options:&#x20;
  * Enter competition report manually online (We will describe this in details below).
  * Enter Competition report by cutting and pasting an XML report from your competition organization software (Make sure the Comp ID matches).&#x20;
  * Select and upload a XML file from your device.&#x20;

<figure><img src="/files/Ej2DXbTe7MuoIizhhDOn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/t987Yw6CKQDwaTZYS6It" alt=""><figcaption></figcaption></figure>

* Once your XML is processed (either from cut and paste or from file upload) - If there are ERRORS in XML file - it will show you a list of errors and you will not be allowed to proceed till those errors are fixed. (See image below for an example).&#x20;

<figure><img src="/files/lZkWxyM4kyfyxIY9Enz8" alt=""><figcaption></figcaption></figure>

* If there are no errors OR after you have fixed all the errors - it will take you to a summary page as shown below. Review all data you have entered before hitting "Submit". Or you can go back and edit the data. Once you hit submit - you can NOT edit data anymore other than reaching out to <comp_director@bjcp.org> to ask them to make each change manually. So REVIEW the summary page carefully before hitting submit.&#x20;

<figure><img src="/files/o0wOIX1F31qyoVhQz9jM" alt=""><figcaption></figcaption></figure>

## Filing Competition Report Online

* Select "Create Online Organizer Report" when you get to the following page (See above)&#x20;

<figure><img src="/files/vgYkLlXR2TYqSCjDSQtb" alt=""><figcaption></figcaption></figure>

* This will lead you to Competition Report Entry page.&#x20;

<figure><img src="/files/PY8ljLccsgs0YS0yz93c" alt=""><figcaption></figcaption></figure>

* First enter the total number of entries, Number of Days and Number of Sessions. These entries determine the amount of points you have available to assign to Judges, Stewards, Staff and Organizers. As you enter this data - you will automatically see allowable points below.&#x20;

<figure><img src="/files/GPmCFir9qXPU3Q20yJx0" alt=""><figcaption></figcaption></figure>

* Next you will enter any BOS - Best Of Shows that your competition might have had one by one (you can enter up to FIVE BOS per competition). You can skip this if you did not have any BOS round.&#x20;

  Please make sure to enter number of entries on each BOS flight and type of BOS (Beer, Mead or Cider). This information is needed to determine allowable BOS judging points for the competition.&#x20;

<figure><img src="/files/3ZH0MiJQ1gRa4GyIq3ua" alt=""><figcaption></figcaption></figure>

* Once you have entered BOS Data you are ready to enter individuals
* To add a BJCP Judge, Click on "Add BJCP Judge". It will create a new line with four fields. "Judge", "Role", "Judge Points", "Non Judge Points".

<figure><img src="/files/ILjAZBm8CXdMdIUsbuW8" alt=""><figcaption></figcaption></figure>

* As you start entering the name of the judge or Judge ID - it will find matching judges and auto-fill the name. This speeds up the judge entry and avoids typing/spelling mistakes.&#x20;

<figure><img src="/files/tYFoZQIDVzCfJq6ZvIyW" alt=""><figcaption></figcaption></figure>

* Next you will declare the role that judge performed for the competition - the following list shows the options.&#x20;

<figure><img src="/files/bm6PkNohnWGjjXx5ey7W" alt=""><figcaption></figcaption></figure>

* Next you will enter corresponding judging or non-judging points. Note that at this point if you enter a number that is not allowable - it will issue a warning (as shown below) and you can not proceed until you fix that error.&#x20;

<figure><img src="/files/lZkWxyM4kyfyxIY9Enz8" alt=""><figcaption></figcaption></figure>

* Entering a non-BJCP judge is the same except that the names will not be auto-filled. You must make sure that you do not make any spelling mistakes in their names to make sure we can find and credit them with points in case they become a BJCP Judge in future.&#x20;
* When all names are entered - click on "Next Step" to go to the summary page.&#x20;

<figure><img src="/files/o0wOIX1F31qyoVhQz9jM" alt=""><figcaption></figcaption></figure>

* At this point you can review the report and if any correction is needed - click on "Back to edit" to go back to previous page. Once you hit submit - you can NOT edit data anymore other than reaching out to <comp_director@bjcp.org> to ask them to make each change manually. So REVIEW the summary page carefully before hitting submit.&#x20;
* Once you hit "Submit" you are done! Thanks for submitting your report on time!!&#x20;


# See Upcoming Exams

You can access a list of upcoming exams in one of the following two ways:&#x20;

* From the App landing page as shown below

<figure><img src="/files/JIAOdLEz3Munm5Oqs7DD" alt=""><figcaption></figcaption></figure>

* From the Exam Menu as shown below

<figure><img src="/files/UhZIdjAdqo6ZmVTC0q5F" alt=""><figcaption></figcaption></figure>

* Once you are on the exam list you can further search/filter exams by location, name etc. Clicking on the name of the Exam Administrator will open up an email window for you to contact that administrator.&#x20;

<figure><img src="/files/Vv60rnjCVCKUg9TZEf9M" alt=""><figcaption></figcaption></figure>


# Request to Run an Exam (Admin Only)&#x20;

* To request to run an exam - click on "Exams" menu and then "Request an Exam" as shown below

<figure><img src="/files/29JKeP6Qco4y32qXWeVY" alt=""><figcaption></figcaption></figure>

* This will take you to EDAF (Exam Data Approval Form). Fill out Date of exam, Type of Exam, Language of Exam and Proctors you intend to use for the exam. Please make sure that the proctors would be available on the date of your email before filling out EDAF.&#x20;

<figure><img src="/files/nbSv5KjRDGz0HsTBAzds" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/mrQbxiGCqgpqzsUCUvpM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/XltjkSAlXXq059QvCl08" alt=""><figcaption></figcaption></figure>

* On clicking "Request" button - your exam request has been registered. Once approved - your exam will be visible in "Administered Exams"&#x20;

<figure><img src="/files/D8zs0MSUVvDHPT5ESJxy" alt=""><figcaption></figcaption></figure>


# Get Exam Documents Prior to Exam (Admin Only)

This includes Examinee Scoresheets, Proctor Scoresheets, Examinee/Proctor Instructions and Exam Data Spreadsheets

* This is available ONLY AFTER your exam is approved by the Exam Team.&#x20;
* Click on "Administered Exams" submenu item in "Exams" Menu&#x20;

<figure><img src="/files/D8zs0MSUVvDHPT5ESJxy" alt=""><figcaption></figcaption></figure>

* This will take you to a list of exams which you have administered in the past **and** exams you are administering in future. Click on the exam in question.

<figure><img src="/files/TgOL3G5hkET6DGewiBac" alt=""><figcaption></figcaption></figure>

* This will take you to the Exam Details page as shows below. Click on "Download" Button

<figure><img src="/files/tITiBh20nehFo99sILEx" alt=""><figcaption></figcaption></figure>

* This will bring you to "Exam Downoads" Page - select the language you want to download your documents in in (Current availability is limited to English, Spanish and Portuguese)

<figure><img src="/files/xojtXFDvGj15OCmPaVBn" alt=""><figcaption></figcaption></figure>

* Once you click on "Download" - the download begins

<figure><img src="/files/mL4oviszDTl80zz15M13" alt=""><figcaption></figcaption></figure>

* Once downloaded - you can find your downloaded files as a compressed folder in your browser's downloaded files folder. Note the folder/file name extensions for different languages in the picture below.&#x20;

<figure><img src="/files/SFydmiwd08CUAadWDoq0" alt=""><figcaption></figcaption></figure>


# Pay Exam Fees (Admin Only)

Exam can be paid anytime after your exam has been approved. NOTE: that once approved - the exam must be paid before it will be processed further (i.e., assigned graders etc.)&#x20;

* After logging in - click on "Exam" menu and "Administered Exams"&#x20;

<figure><img src="/files/D8zs0MSUVvDHPT5ESJxy" alt=""><figcaption></figcaption></figure>

* Next find the corresponding exam in your list of administered exams and click on the exam code.&#x20;

<figure><img src="/files/TgOL3G5hkET6DGewiBac" alt=""><figcaption></figcaption></figure>

* From the Exam Details page - click on "Pay" Button

<figure><img src="/files/vmJwIz0F3MfspCSqjOdI" alt=""><figcaption></figcaption></figure>

* This will take you to Exam Payment Details page (note this page might change over time as we add more options). Select the number of current BJCP Members taking the exam and number of Non-BJCP (i.e., new BJCP Members). This is required because the fee structure is different for current BJCP member vs new BJCP members

<figure><img src="/files/xvWEJv4v8LHgI7pyRLlA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bsfUhZdv9q3i9MRNCdRo" alt=""><figcaption></figcaption></figure>

* On clicking submit - you will be taken to payment summary page which will summarize the total amount of payment. If everything looks good - click on PayPal "Pay Now" Button and you will be transferred to PayPal to complete the transaction.&#x20;

<figure><img src="/files/7oHjsSCIoFtMSs7eBU8w" alt=""><figcaption></figcaption></figure>


# XML Format (Version 2.2 - Draft Version)

Date: Sept 14, 2025 - Minor update/clarifications with Bravo Release - If any questions - email it\_director\@bjcp.org

## BJCP Database XML Interface Specification 2.2.

### Introduction

The BJCP database accepts competition organizer reports in an XML format. The database doesn’t presently use XML, but rather parses the data in XML format. Since the parsing is done using scripting language within the database, it is important that all programs that write XML data use the standard format described in this specification. Future versions of the BJCP database may import the data directly using XML.&#x20;

The standard BJCP online competition organizer’s reporting system creates an XML file in the format described in this specification. Any other program that wishes to interface with the BJCP database must follow similar rules, enforce BJCP business logic, and perform necessary field validation. The back-end does limited error checking; the frontend program is responsible for formatting data and enforcing validation rules and business logic.&#x20;

The XML file is simply a text file with XML data that can be copied and pasted or uploaded at the competition report page at <https://app.bjcp.org/competitions/report>. Before this, the developer must coordinate with the BJCP IT Director to ensure the data file meets the specification provided in this document and imports properly into the BJCP database.&#x20;

### XML File Format&#x20;

The organizer’s report is delineated by \<OrgReport> \</OrgReport> tags. Anything not within these tags will be ignored. Seven major sections are contained within the organizer’s report:

1. The competition data section contains overall information about the competition. There is one of these data sections per report. It is delimited by \<CompData>\</CompData> tags. See Details below.&#x20;
2. The BOS Data section contains number of Best of Shows for the competition, their beverage type and number of entries on each of those BOS Judging panels. It is delimited by \<BOSData>\</BOSData> tags. See details below.&#x20;
3. The BJCP points section contains judging and non-judging points assigned to BJCP judges. There is one BJCP points section, and it can contain multiple judge records. It is delimited by \<BJCPpoints>\</BJCPpoints> tags. See details below.&#x20;
4. The Non-BJCP points section contains judging and non-judging points assigned to people not in the BJCP. There is one Non-BJCP points section, and it can contain multiple judge records. It is delimited by \<NonBJCP>\</NonBJCP> tags. See details below.
5. The comments section contains free-format text comments that may be passed to the program administrator. One possible use of the field is to contain the name of the person entering the data, discrepancies or problems encountered in entering the data, or notes to the database administrator. There is one comments section, and it only contains data. It is delimited by \<Comments>\</Comments>tags, and contains free format text data. **It is highly encouraged that this section contain the email address of the person submitting the report. It is also highly encouraged that this section contain the name and version of the software which created this report.**&#x20;
6. The IP Address section contains the IP address of the host system where the data was collected. This is a rudimentary auditing feature in case the authenticity of the data is questioned. There is one IP address section, and it only contains data. It is delimited by \<IPAddress>\</IPAddress> tags, and contains data in the format nnn.nnn.nnn.nnn, where n is a digit (leading zeroes suppressed). **Note: With bravo deployment, IPAddress is collected when XML report is uploaded. So this field is deprecated.**&#x20;
7. The submission date section contains a date- and time-stamp when the data was collected and transmitted. This is a rudimentary auditing feature in case the authenticity of the data is questioned. There is one submission date section, and it only contains data. It is delimited by \<SubmissionDate>\</SubmissionDate> tags, and contains data in the format Day, dd month yyyy hh:mm am/pm, where Day is the day of the week (e.g. Tuesday), dd month yyyy is the date (e.g. 20 April 2004) and hh:mm am/pm is the time in 12-hour format (e.g. 5:22 pm). **Note: With bravo deployment, SubmissionDate is collected when XML report is uploaded. So this field is deprecated.**&#x20;

#### Competition Data Section

The Competition Data section contains seven data elements:

1. Competition ID: the six-digit competition registration number. There is one competition ID per section and is delimited by \<CompID>\</CompID> tags.
2. Competition Name: the free-format text name of the competition. There is one competition name per section and is delimited by \<CompName>\</CompName> tags.
3. Competition date: the date the competition was held in the format yyyy-mm-dd where the yyyy, mm and dd fields are numbers representing the year, month and day (leading zeroes retained). There is one competition date per section and is delimited by \<CompDate>\</CompDate> tags.
4. Competition entries: the number of entries the competition has. There is one competition entries per section and is delimited by \<CompEntries>\</CompEntries> tags.
5. Competition days: the number of days the competition **judging** was held. There is one competition days per section and is delimited by \<CompDays>\</CompDays>tags. **Note this is NOT the number days elapsed between first day or judging and last day of judging - but actual number of days judging was held for the competition.**&#x20;
6. Competition sessions: the number of judging sessions (periods or rounds in which judging was held, not counting the best of show round). There is one competition sessions per section and is delimited by \<CompSessions>\</CompSessions> tags. **Note that this is not number of flights judges by each judge panel during a session (i.e., Morning, Afternoon, etc.) but actual sessions. Maximum 3 sessions per day are allowed.**&#x20;
7. Competition flights **(This tag is deprecated in favor of BOSData and BOSBeer, BOSCider, BOSMead, BOSBeerMead, BOSBeerCider, BOSMeadCider, BOSBeerMeadCider tags as described below. To help with transition - for next few months; if BOSData section is missing - we will treat CompFlights tag to communicate entry count in a BOSData Section with single BOS of type BOSBeerMeadCider)**: the number of beers in the best of show round (usually the same as the number of flights; but the number of entries on the BOS table is the actual metric desired). There is one competition flights per section and is delimited by \<CompFlights>\</CompFlights> tags. If there are multiple BOS rounds, this field should contain the sum of all entries in all BOS panels. The information on number/type of entries on each BOS panel should be stored in the Comments section. **(Again - this field is deprecated and this data is not needed).**&#x20;

#### BOS (Best of Show) Data Section

The BOS Data section contains number of Best of Shows for the competition, their beverage type and number of entries on each of those BOS Judging panels.&#x20;

1. \<BOSData>\</BOSData> tags will identify the BOS Data Section. Following tags can appear within BOSData section.
2. \<BOSBeer>number\_of\_entries\</BOSBeer> should be used to report a BOS which contained Beers exclusively. "number\_of\_entries" is an integer number reporting number of entries on that best of show panel.
3. \<BOSMead>number\_of\_entries\</BOSMead> should be used to report a Mead BOS where "number\_of\_entries" is an integer number reporting the number of entries on that best of show panel.
4. \<BOSCider>number\_of\_entries\</BOSCider> should be used to report a Cider BOS where "number\_of\_entries" is an integer number reporting the number of entries on that best of show panel.
5. \<BOSBeerMead>number\_of\_entries\</BOSBeerMead> should be used to report a BOS which contained both beers and meads on the table. "number\_of\_entries" is an integer number reporting the number of entries on that best of show panel.
6. \<BOSBeerCider>number\_of\_entries\</BOSBeerCider> should be used to report a BOS which contained both beers and ciders on the table. "number\_of\_entries" is an integer number reporting the number of entries on that best of show panel.
7. \<BOSMeadCider>number\_of\_entries\</BOSMeadCider> should be used to report a BOS which contained both meads and ciders on the table. "number\_of\_entries" is an integer number reporting the number of entries on that best of show panel.
8. \<BOSBeerMeadCider>number\_of\_entries\</BOSBeerMeadCider> should be used to report a BOS which contained beers, meads and ciders on the table. "number\_of\_entries" is an integer number reporting the number of entries on that best of show panel.
9. One can report more than one BOS or same type.&#x20;
10. Maximum number of BOS is limited to FIVE.&#x20;

#### Judging Points Section

The BJCP points section contains one or more judge data records, each delimited by \<BJCPpoints>\</BJCPpoints> . Each of the judge data records contains five elements:

1. Judge ID: the BJCP ID of the judge (see field validation rules). Structured text. Delimiting tags are \<JudgeID>\</JudgeID>. The Judge ID MUST be provided for a BJCP judge to receive credit.
2. Judge Name: the full name of the judge. Free-format text. Delimiting tags are \<JudgeName>\</JudgeName>.
3. Judge Role: the specific duty the judge performed in the competition (see field validation rules; there are only certain values that can be used). Delimiting tags are \<JudgeRole>\</JudgeRole>.
4. Judge Points: the judging points assigned to the judge (see field validation rules). Numeric data. Delimiting tags are \<JudgePts>\</JudgePts>.
5. Non-Judge Points: the non-judging points assigned to the judge (see field validation rules). Numeric data. Delimiting tags are \<NonJudgePts>\</NonJudgePts>.&#x20;

#### Non-BJCP Points Section

The Non-BJCP points section contains one or more judge data records, each delimited by \<NonBJCP>\</NonBJCP>. Each of the judge data records contains four elements:

1. Judge Name: the full name of the judge. Free-format text. Delimiting tags are \<JudgeName>\</JudgeName>.
2. Judge Role: the specific duty the judge performed in the competition (see field validation rules; there are only certain values that can be used). Delimiting tags are \<JudgeRole>\</JudgeRole>.
3. Judge Points: the judging points assigned to the judge (see field validation rules). Numeric data. Delimiting tags are \<JudgePts>\</JudgePts>.
4. Non-Judge Points: the non-judging points assigned to the judge (see field validation rules). Numeric data. Delimiting tags are \<NonJudgePts>\</NonJudgePts>.

### Field Validation Rules

1. Judge ID is a five character text field: \[A-G]\[0-9]\[0-9]\[0-9]\[0-9], or A0001 to G9999.
2. Comp ID is a six digit number: 100000 and greater.
3. Judge Role is a text field that can accept only certain values:&#x20;

   1. "Judge"&#x20;
   2. "Judge + BOS"&#x20;
   3. "BOS Judge"&#x20;
   4. "Steward"&#x20;
   5. "Organizer"&#x20;
   6. "Staff"&#x20;
   7. "Staff + Judge"&#x20;
   8. "Staff + BOS"&#x20;
   9. "Staff + Judge + BOS"&#x20;
   10. "Staff + Steward".&#x20;

   The quotes aren't part of the field values, but the spaces within the quotes should be preserved.
4. Judge Points and Non-Judge Points are non-negative numbers with one decimal place (i.e. 0.0 and greater).
5. **Each person can appear only once in a report.**&#x20;
6. *An organizer can only receive organizer points - organizers is not allowed to receive judging points.*&#x20;

### Business Logic&#x20;

The full set of rules describing competition reporting can be found at <http://www.bjcp.org/rules.html>. Much of the data contained in the Competition Data section is used to validate certain assignment of points.

1. Stewards receive 0.5 non-judging points per day, up to a maximum of 1.0 points per *competition*. Steward points are awarded separately from any staff points, although they may be combined. Steward points awarded never detract from allowable staff points.
2. Judges generally get 1 judging point per competition, but the actual rules are:&#x20;

   1. 0.5 points per *session*&#x20;
   2. 1.5 points per day ***maximum***&#x20;
   3. 1.0 points per competition ***minimum***&#x20;

   \[b and c combine to give 1 point for most competitions since it is rare to have 3 sessions per day; max points per comp are per the table at the end]
3. BOS judge rules (BOS judges earn judging points)&#x20;
   1. BOS judges get an extra 0.5 points if they also judged at least one normal flight&#x20;
   2. BOS judges get 1.0 points if they only judge BOS&#x20;
   3. Multiple BOS tables are allowed, but only for separate purposes (i.e., not for doing a multi-round BOS). Examples include homebrewed beer, commercial beer, mead, cider, and mead/cider.&#x20;
   4. Each BOS table is subject to the overall BOS rules&#x20;
   5. Up to 3 judges can get BOS points for 5-14 entries on a BOS table containing beer&#x20;
   6. Up to 3 judges can get BOS points for 3-14 entries on a mead/cider BOS table&#x20;
   7. Up to 5 judges can get BOS points for 15+ entries on any BOS table&#x20;
   8. 30 entries and either 5 BOS beers or 3 BOS meads/ciders are needed to award BOS points at all&#x20;
   9. A single judge can only receive the BOS bonus once per competition.
4. Maximum points per competition for organizers, staff, and judges:

| Entries | Organizer | Staff                                      | Judge (Not including BOS Points) |
| ------- | --------- | ------------------------------------------ | -------------------------------- |
| 1-49    | 2.0       | 1.0                                        | 1.5                              |
| 50-99   | 2.5       | 2.0                                        | 2.0                              |
| 100-149 | 3.0       | 3.0                                        | 2.5                              |
| 150-199 | 3.5       | 4.0                                        | 3.0                              |
| 200-299 | 4.0       | 5.0                                        | 3.5                              |
| 300-399 | 4.5       | 6.0                                        | 4.0                              |
| 400-499 | 5.0       | 7.0                                        | 4.5                              |
| 500-599 | 6.0       | 8.0                                        | 5.5                              |
| 600+    | 6.0       | Additional 1 per each 100 entries over 600 | 5.5                              |

* For each competition that has 600 or more entries, an additional 1.0 staff points are available for each 100 additional entries (600 = 9, 700 = 10, etc.).&#x20;
* The organizer and judge points are maximums allowed, regardless of competition size (i.e., they do not scale up as do staff points).&#x20;
* **Staff points are the sum of all staff points that can be awarded, not the number to be awarded to each person**&#x20;
* Staff points must be awarded in 0.5 point increments&#x20;
* Judge points are maximums, but must be earned according to (2) above&#x20;
* No individual participant can earn more total points (judging and non-judging, combined) than the organizer, although others can earn the same number of points as the organizer.
* Only the Roles listed in the field validation rules \[3] are allowed. For example, organizer points cannot be combined with other points, and judging and stewarding points cannot be combined.

### Sample XML File

\<OrgReport>\
&#x20;  \<CompData>\
&#x20;     \<CompID>101440\</CompID>\
&#x20;     \<CompName> Gambrinus Challenge\</CompName>\
&#x20;     \<CompDate>2003-11-15\</CompDate>\
&#x20;     \<CompEntries> 82 \</CompEntries>\
&#x20;     \<CompDays> 2\</CompDays>\
&#x20;     \<CompSessions> 3\</CompSessions>\
&#x20;     \<CompFlights>19\</CompFlights>\
&#x20;  \</CompData>\
&#x20;  \<BOSData>\
&#x20;     \<BOSBeerCider>14\</BOSBeerCider>\
&#x20;     \<BOSMead>5\</BOSMead>\
&#x20;  \</BOSData>\
&#x20;  \<BJCPPoints>\
&#x20;     \<JudgeData>\
&#x20;        \<JudgeID>D0646\</JudgeID>\
&#x20;        \<JudgeName>Dave Neilly\</JudgeName>\
&#x20;        \<JudgeRole>Judge + BOS\</JudgeRole>\
&#x20;        \<JudgePts>1.5\</JudgePts>\
&#x20;        \<NonJudgePts>0\</NonJudgePts>\
&#x20;     \</JudgeData>\
&#x20;     \<JudgeData>\
&#x20;        \<JudgeID>D0491\</JudgeID>\
&#x20;        \<JudgeName>Rod Savoie\</JudgeName>\
&#x20;        \<JudgeRole>Judge\</JudgeRole>\
&#x20;        \<JudgePts>1.0\</JudgePts>\
&#x20;        \<NonJudgePts>0\</NonJudgePts>\
&#x20;     \</JudgeData>\
&#x20;     \<JudgeData>\
&#x20;        \<JudgeID>D0642\</JudgeID>\
&#x20;        \<JudgeName>Walter Martin\</JudgeName>\
&#x20;        \<JudgeRole>Staff + Judge\</JudgeRole>\
&#x20;        \<JudgePts>1.0\</JudgePts>\
&#x20;        \<NonJudgePts>1.0\</NonJudgePts>\
&#x20;     \</JudgeData>\
&#x20;  \</BJCPPoints>\
&#x20;  \<NonBJCP>\
&#x20;     \<JudgeData>\
&#x20;        \<JudgeName>Blake Rooks\</JudgeName>\
&#x20;        \<JudgeRole>Steward\</JudgeRole>\
&#x20;        \<JudgePts>0\</JudgePts>\
&#x20;        \<NonJudgePts>0.5\</NonJudgePts>\
&#x20;     \</JudgeData>\
&#x20;    \<JudgeData>\
&#x20;        \<JudgeName>Cal Soloway\</JudgeName>\
&#x20;        \<JudgeRole>Judge\</JudgeRole>\
&#x20;        \<JudgePts>1\</JudgePts>\
&#x20;        \<NonJudgePts>0\</NonJudgePts>\
&#x20;     \</JudgeData>\
&#x20;  \</NonBJCP>\
&#x20;  \<Comments>\
Competition data entered by Al Boyce C0428 on 4/3/2004. \
Submitter Email:<first.last@hostname.com> \
&#x20;  \</Comments>\
\</OrgReport>&#x20;

### Change History&#x20;

#### Changes since Version 1.0&#x20;

The BJCP Board of Directors approved a change to the competition point award structure in July 2005. Following is a summary of the changes for those who have already implemented version 1.0 of the interface specification.&#x20;

* The XML file format, tags and data types are unchanged. However, it is now encouraged that the comments section of the XML file also include the email address of the person preparing the report (in case there are questions about the data). The discussion also clarifies where to send the final report (<program_admin@bjcp.org> and <it_director@bjcp.org>).&#x20;
* The business rules for validating data have changed. However, there are no new “roles.” Only the point award schedule has changed, as well as treatment of stewards, judges and BOS judges.&#x20;
* The daily maximum point award for judges has changed from 1.0 to 1.5 points. The following two rules remain unchanged: (1) judges earn a minimum of 1.0 points per competition, and (2) judges earn points at a rate of 0.5 points per session. BOS points are in addition to any judging points, as they are today.&#x20;
* Multiple BOSs can be held in a single competition. This is not meant to allow a multi-stage BOS, but rather to allow homebrew vs. commercial beer BOS, and separate mead, cider, or mead/cider BOSs.&#x20;
* BOS judges earn an extra 0.5 judging point, in addition to any other points earned. If they only judge BOS, they earn the 1.0 competition minimum.&#x20;
* The number of BOS judges that can earn points is based on the number of entries in the BOS round. The limits apply to each BOS flight.&#x20;

  * 5-14 entries including beer = 3 BOS judges&#x20;
  * 3-14 mead/ciders (only) = 3 BOS judges&#x20;
  * 15+ entries (any combination) = 5 BOS judges&#x20;

  The database does not distinguish types of BOS. The validation rules should simply enforce the total number of BOS judges based on: (1) the number of BOSs, (2) the number of entries in each BOS, and (3) the type of beverage judged in each BOS. The number of BOS entries are reported the same, although if there are multiple BOS rounds only the homebrewed beer BOS should be listed in\<CompFlights>.. The rest should be listed in the section \<Comments>. (*This has since been modified)*.&#x20;
* The award schedule for organizer points has changed. The same minimum (2) and maximum (6) exist, but the number of entries for each has changed. There is also more granularity (half points can be awarded).&#x20;
* The award schedule for staff points has changed. Staff points can still be awarded to any program participant (except the organizer), and they still must be awarded in 0.5 point increments. The schedule uses the same levels as the organizer schedule. However, there is no cap on the number of staff points. In the new table, 8 staff points are earned for 500-599 entry competitions. At 600 entries and every 100 entries thereafter, an additional 1.0 staff points are available.
* The maximum number of judging points that can be awarded to any individual in a competition has changed. Likewise, it is based on the same levels as organizer and staff points. Judging points must be earned using the rules for sessions, days and competitions previously stated.&#x20;
* Following is the maximum point table by number of entries. Except for the organizer, these points are not automatic. They must be earned (for judges) or assigned (for staff).&#x20;
*

```
| Entries | Organizer | Staff                                        | Judge (Not including BOS Points) |
```

```
| ------- | --------- | -------------------------------------------- | -------------------------------- |
| 1-49    | 2.0       | 1.0                                          | 1.5                              |
| 50-99   | 2.5       | 2.0                                          | 2.0                              |
| 100-149 | 3.0       | 3.0                                          | 2.5                              |
| 150-199 | 3.5       | 4.0                                          | 3.0                              |
| 200-299 | 4.0       | 5.0                                          | 3.5                              |
| 300-399 | 4.5       | 6.0                                          | 4.0                              |
| 400-499 | 5.0       | 7.0                                          | 4.5                              |
| 500-599 | 6.0       | 8.0                                          | 5.5                              |
| 600+    | 6.0       | Additional 1 per each 100 entries over 600   | 5.5                              |
```

* Organizers may award a combination of staff and steward points. Steward points must be earned. Staff points are allocated. They come from different point pools.&#x20;
* Stewards can now earn a maximum of 1.0 non-judging points per competition. Rather than 0.5 points per competition, they earn 0.5 points per day up to a maximum of 1.0 points. Stewarding points are in addition to any staff points that might be awarded (i.e., they do not come from the same pool of non-judging points).&#x20;
* No individual may earn more total points (sum of judging and non-judging points) in a competition than the organizer. Other individuals may earn an amount equal to the points earned by the organizer. This rule previously existed, but is now explicitly stated in case it was not implemented.&#x20;

#### Changes since Version 2.0&#x20;

Minor clarifications based on comments.&#x20;

* Judges may only receive the BOS bonus once per competition (i.e., a judge can not earn extra points by judging in two or more BOS panels in a single competition).&#x20;
* The section should include the sum of all BOS entries in all BOS panels. Individual BOS details (type, entries) should be put in the section.&#x20;
* At least three BOS mead/ciders are needed to award BOS points in a mead/cider competition or BOS panel.&#x20;
* Clarified composition of BOS panels to award BOS judge points.

#### Changes since version 2.1 (Updated by HV)

These are technically not really changes as this was supported before but only BJCP internal tool was using this and it was not published. This clarification is needed due to migration to Bravo

* \<CompFlights> tag will be deprecated in favor of \<BOSData> tag to report number of Best of Shows (BOS), type of BOS and number of entries on each BOS panel
* &#x20;\<IPAddress> and \<SubmissionDate> tags are deprecated and not needed anymore because this information is automatically collected as part of Competition report uploading process.
* \<BOSData>\</BOSData> tag is used to indicate BOS Data section
* Within BOSData tag - upto FIVE Best of Shows can be reported.&#x20;
* Type of BOS is determined by  \<BOSBeer>, \<BOSMead> and \<BOSCider>, \<BOSBeerMead>, \<BOSBeerCider>, \<BOSMeadCider> and \<BOSBeerMeadCider> - depending on beverages on BOS panel.&#x20;
* Number of entries on each BOS panel is reported within BOSBeer, BOSMead, BOSCIder, BOSBeerMead, BOSBeerCider, BOSMeadCider and BOSBeerMeadCider tags.&#x20;
* See below example for illustration: \
  \<BOSData>\
  &#x20;    \<BOSBeer>25\</BOSBeer>\
  &#x20;    \<BOSMead>5\</BOSMead>\
  &#x20;    \<BOSCider>3\</BOSCider>\
  &#x20;   \<BOSBeer>8\</BOSBeer>\
  \</BOSData>\
  \
  The above example shows a case where there were 4 BOS for a competition with two beer BOS with 25 and 8 entries on BOS panel, a Mead BOS with 5 entried on BOS Panel and a Cider BOS with 3 entries on BOS Panel. \
  \
  As per BJCP rules - the above example will allow 5 + 3 + 3 + 3 = 14 BOS judge credits.&#x20;