Q. How do I upload a file from a 3rd party application to Scoutbook Plus and produce a report to bring to the Scout Shop to purchase advancements?
IMPORTANT: To login to Scoutbook Plus you must be the unit leader, Chartering Organization Representative or Committee Chair of your unit on your official roster (not just in Scoutbook.) If not one of these three, you will need to be designated in Organization Security Manager at my.scouting.org as a Key 3 Delegate or an Advancement Chair by someone holding one of the three positions above. To make such a delegation, see the guide here.
First check with your 3rd party application vendor on how to produce a file from their product to upload to Internet Advancement.
NOTE: The file format that goes into Scoutbook Plus is a TXT file not a CSV file and the actual format of the file is different than the file format that went into the old Internet Advancement. Please check with your 3rd party application vendor to make sure they support uploading to Scoutbook Plus. Follow their directions on how to obtain the file from their product. If there are issues with the file upload, please work with your 3rd party vendor and ask them to work with BSA IT to rectify them.
Then follow these steps:
Log in
Select Import File from the Roster page
You will be prompted to upload your file. If your file fails to process, contact your 3rd party vendor. Files are processed hourly and will remain in a “Pending” state on your “Activity” tab until processing successfully completes.
Once your file is processed the advancements in your file are recorded automatically.
ERRORS: Most errors concurring on upload are because the name and member ID of the Scout in your 3rd party product does not match your official roster exactly. Make sure the name and member ID of each Scout in your third party product is exactly the same as it is on your official BSA roster.
Run the Advancement Report
To run an advancement report to bring to the Scout Shop, Click on the Scoutbook menu item to the left on the Roster Page. Then click on your unit in Scoutbook, then click on Reports and run the Needs Purchasing Report. More help is here.
Troubleshooting
General Notes:
- Users should not be tampering with the files that are exported from their vendors. If there’s something wrong with the file then they need to work with their vendor to learn how they themselves can update the data in their vendor’s platform and then generate a new file.
- The file from the vendor will be a .TXT file.
- When an Scoutbook Plus user uploads a file, all of the member IDs in the file must match the first and last name of youth registered in the unit. (Again, this data should be fixed in the vendor platform, not in the file.)
- Make sure your unit roster in your 3rd party application matches your official unit roster in the Roster tool in my.scouting.org. Scout names must be the same spelling in both and BSA member IDs must match. There should not be any Scouts in the 3rd party application that is not on the official BSA roster.
Errors on upload:
- If a user sees a red bar on the screen when they try to upload their file, the most likely cause is that the names of the youth or their respective member IDs in the file do not match their name and member ID in Scoutbook.com
Errors on processing
- If there is an error during the hourly process job and the file is rejected, the file will show a red icon in the activity tab.
If you are still having issues, please work with your 3rd party vendor.