This guide describes how Greenrain Automation Lite Server software works.

Prerequisites

• GAL server application software is installed and configured.

• GAL server license is activated.

• GAL server service is in running state.

Follow the ‘Install guide - Greenrain Automation Lite’ to complete the above-mentioned prerequisites.

Application workflow

The server consists of 2 workflows.

• Upload workflow - To upload e-claim transactions to Post Office in .XML or .ZIP format.

• Download workflow - To download e-claim transactions (remittance advice transactions) from the Post Office.

Upload workflow

Successful uploads

• To upload claim transaction, place the XML files into the designated Upload folder (this directory is configured while setting up the configuration of the application).

  • The files can either be

    • .XML / .xml format

    • .ZIP format (There has to be a valid XML withing the ZIP file to be processed)

By default, both XML and ZIP files are processed/uploaded to Shafafiya in their respective file formats without any conversions. However,

• If ‘ZIP transactions before upload’ setting is specifically selected upon configuration then,

  • All XML Claim.Submission files placed into the upload folder will be converted to ZIP files and then uploaded to Shafafiya. Consequently, all post-processed files found in the ‘Success’ folder will be of ZIP file format.

  • All ZIP Claim.Submission files placed into the upload folder will be uploaded to Shafafiya without any conversions and processed as is.

Open

• If you get an admin prompt to paste files to the folder, then press continue. If required and available press the checkbox that allows admin privilege on all files that you re about to paste.

Open

• Claims are validated and uploaded to Shafafiya if files

  • are valid claims submission transactions.

  • are of valid files types.

  • have no other errors after validation.

• Further subdirectories are created in the ‘Success’ folder in the following fashion,

  • Configured directory\Success\YYYY-MM\Payor ID. Where,

    • Configured directory is the directory configured in the application.

    • Success - is the success subfolder.

    • YYYY-MM - is the year and month of claim upload in YYYY-MM format.

    • Payor ID - is the payor ID to which claims are uploaded.

• All uploaded file names will also have a Prefix in the following fashion,

  • YYYY-MM-DD HH_mm_SS original filename, where,

    • YYY-MM-DD HH_mm_SS - is the date time stamp in the specified format when the upload was completed.

    • original filename - is the original filename of the Claim.Submission file.

  • If there are multiple files with the same name, then a counter is automatically appended to each file to differentiate them.

• The uploaded claims can also be cross-checked via Greenrain messenger by searching for claims submissions as shown.

Failed uploads

• If uploads have failed, this is because there may be certain validation errors. In this scenario, the errors along with specific claim files are moved to the ‘Failed’ subfolder within the specified upload directory. The excel file provides the error code and error description for correction following which the claims file can be reuploaded.

Invalid uploads

• Files are moved to ‘Invalid’ folder within the specified upload folder when,

  • files are of incorrect file type

  • transactions/file content are not of claims submission transactions

In these cases, files are moved the Invalid folder as shown below,

Download workflow

Download transactions

• Greenrain Automation Lite Server software checks Post Office for un downloaded remittance advice transactions for the validated license.

• The remittance advice transaction is downloaded into the ‘Download’ subfolder within the specified directory while configuring the application.

• Download transaction workflow happens at specified intervals specified during the installation and configuration of the application. Default is every 60 seconds.

• New transactions are downloaded if

  • They belong to the validated license.

  • They have not been downloaded before.

If valid transactions matching the above conditions are found then they are downloaded to the download folder and the transactions are marked downloaded at the Post Office. By default, both XML and ZIP files are processed/downloaded from Shafafiya in their respective file formats without any conversions. However,

• If ‘Unzip transactions after download’ setting is specifically selected upon configuration then,

  • All downloaded XML Remittance.Advice files placed into the download folder will still be XML file format with no changes.

  • All downloaded ZIP Remittance.Advice files will be automatically extracted and only the XML file will be placed into the specified download folder. Original ZIP files will automatically be removed.

• Further subdirectories are created in the ‘Download’ folder in the following fashion,

  • Configured directory\Download Date\Transaction Date\From payor ID. Where,

    • Configured directory - is the directory configured in the application.

    • Download- is the default download subfolder.

    • Download date - is the date of downloading Remittance.Advice file in the format YYYY-MM-DD.

    • Transaction date - is the date of the original transaction in the format YYYY-MM-DD.

    • From payor ID - is the payor ID from which Remittance.Advice file was received.

Don't forget

• If you are making changes to these application settings for e.g. changing upload/download folder OR changing polling interval, then you should ensure to restart the service as shown below for new changes to take effect.

Changing application settings -

Restarting services -

Log files

Log files can be found in the following location \Users\Public\Documents\Greenrain\AutomationLite\Log. Log files are particularly useful for troubleshooting invalid uploads and also may be requested by Greenrain troubleshooting team for investigation.

Support

For queries, concerns, suggestions or support contact help@greenrain.online.