The ABM Portal allows you to enter encounter data manually in user-friendly way. On sending, Encounter.Submission transaction in .xml format is generated. To add an encounter, follow the below steps.

Step 1. Log in to https://abm.moh.gov.sa/.

Home page loads.

Step 2. Select Services > Add Encounter from the menu or click Add Encounter tile on the dashboard.

Add Encounter page loads. The page contains multiple tabs with data fields:

General Info;
Patient Info;
Additional Info;
Diagnoses;
Activities.

Mandatory fields are shown in bold. All fields have tooltips with their description.

Step 3. Staying on General Info tab, select:

Organization ID - the list showing available organizations. Once the organization is selected, the following greyed out fields are auto-populated with additional info (that is not a part of the final transaction):

Unique Healthcare Facility ID;
Healthcare Facility Sector Identifier;
Healthcare Facility Type of Care;
Cluster;
Total Hospital Beds;
Healthcare Facility Level of Care;
Facility Location;

Encounter Type - the list of available visit types. Once any type is selected, data fields on all tabs are updated:

those fields that are not allowed for the respective encounter type are greyed out; if there is a value already entered, it is cleared;
some additional fields become in bold if the respective encounter type requires this info to be send.

Fill in the rest of the fields.

Step 4. Click Patient Info tab or Next >>, fill in the required fields.

Step 5. Click Additional Info tab or Next >>, fill in the required fields.

Step 6. Click Diagnoses tab or Next >>, then click Add Diagnosis.

The following warning appears if Encounter End and Code Set Edition are not specified on General Info tab.

In this case, click Close, go to General Info tab, fill these fields, return to Diagnoses tab and click Add Diagnosis again.

Add Diagnosis popup appears.

Step 7. Enter a diagnosis details and click Add.

Add Diagnosis popup closes. The set diagnosis appears in the grid on Diagnoses tab. Note, a diagnosis with Type = 1 (Principal) is mandatory, diagnoses of other type are optional. Only one principal diagnosis is allowed. Any diagnosis can be edited or removed by clicking the corresponding icons in column Actions.

Step 8. Click Activities tab or Next >>, then click Add Activity.

The following warning appears if Encounter End and Code Set Edition are not specified on General Info tab.

In this case, click Close, go to General Info tab, fill these fields, return to Activities tab and click Add Activity again.

Add Activity popup appears.

Step 9. Enter an activity details and click Add.

Once Type is selected, Code becomes a list with the set of codes of the corresponding type.

On clicking Add, Add Activity popup closes. The set activity appears in the grid on Activities tab. Note, Quantity may have a value only for Type = 2 (Trade Drug) and 4 (Laboratory Test). Any activity can be edited or removed by clicking the corresponding icons in column Actions.

Step 10. Finally, click Upload.

A confirmation popup appears.

Step 11. Click Submit.

The confirmation popup closes. A transaction file in .xml format is generated, validated and then sent. The validation result can be SUCCESS and FAILED. When FAILED is returned, the transaction submitting is aborted, and the errors report is returned and shown as a grid. There is a possibility to search for specific data in all columns of the report as well as download the report as zipped .csv file by clicking this link.

Step 12. Correct the errors, click Upload, then Submit again.

The confirmation popup closes. A transaction file is generated, validated and then sent. When SUCCESS is returned, the transaction is actually submitted. The sent file can be downloaded.

Browser not supported