Kontakt

Ansicht
Dokumentation

RNCAMB00 - Ambulatory (AMB) Report

RNCAMB00 - Ambulatory (AMB) Report

General Material Data   PERFORM Short Reference  
This documentation is copyright by SAP AG.
SAP E-Book

Purpose

This program creates AMB files under a specified AMB Code for the SSN Treatment Certificates (TCs) of the outpatient cases that match your selection criteria.

Integration

Prerequisites

  • Communication-specific Customizing
SAP delivers a communication standard with versions, message types, message segments, and message fields assigned to the EDI procedure (AMB). However, you can also define your own communication standard and add region-specific fields.
For more information about Communication-specific Customizing, see the Customizing for SAP Healthcare - Industry-Specific Components for Hospitals under Communication -> Electronic Data Interchange -> Customizing Step-By-Step -> IT: AMB Customizing.

Features

You can select SSN TCs either using TC selections or according to the various selection criteria available in the selection screen.

Selection

When you select Basic Selection Criteria, you can filter SSN TCs based on the following criteria:

  • End Date of Treatment
The system selects all SSN TCs with an end date of treatment that is in the specified period.
  • Visit Date
The system selects all SSN TCs with an assigned visit whose visit date is in the specified period. Note that, canceled assignments of visits to TCs as a result of canceled visits or canceled assignments itself are not considered for the selection of TCs.
  • AMB Number
The system selects all SSN TCs that are associated with each of the AMB numbers specified as a range.
  • TC Number
The system selects all SSN TCs within the specified range of TC numbers.
  • Case Selection
The system selects all SSN TCs of the cases within the case selection specified. If you specify a case selection, the system will not allow you to specify a case as well for the TC selection process.
  • Case
The system selects all SSN TCs of the case with the case number that is within the specified range. If you specify a case, the system will not allow you to specify a case selection as well for the TC selection process.
  • Patient
The system selects all SSN TCs belonging to patients within the specified range of patient numbers.

When you select SSN TCs using TC selection, the system retrieves all the SSN TCs included within this selection.

Note:You can define and update your own TC selection in the Layout section of this report, which you can use as a selection criterion to select SSN TCs.

When you select Additional Selection Criteria, you can filter SSN TCs based on the following criteria:

  • Treatment Org. Unit
The system selects all SSN TCs in which the treating Organizational Unit (OU) of the first visit assigned to the TCs is within this range. Note that, canceled assignments of visits to SSN TCs as a result of canceled visits or canceled assignments itself are not considered for the selection of SSN TCs.
  • TC Category
The system selects all SSN TCs with the specified TC category.
  • TC Application Status
The system selects all SSN TCs with the specified external application status linked to the internal application status of the TCs.
  • Region
The system selects all SSN TCs with the specified region of the patient who owns the SSN TCs.

Execution Options

  • Set AMB Records as 'Temporary'
  • If you select this checkbox, then all AMB records are marked as 'Temporary'. This means that these are temporary versions of the records which will be sent to the authority.

  • If you do not select this checkbox, then all AMB records are marked as 'Final'. This means that these are the final versions of the records which will be sent to the authority.

Note: The indication if an AMB record is temporary is available only in the protocol table (NCSSN). However, these database changes are made only if you have not selected the Test Mode checkbox.

  • Test Mode
  • If you execute the program in test mode, the system does not save changes on the database while the program is running.

  • If you execute the program in real (update) mode, the protocol log is saved to the database and the application status of the TC is changed automatically (according to the Customizing settings for external application status) for every TC included in the communication process to SSN.

The AMB files are created independent of the test mode. In test mode, the system adds the characters 'TEST' to the file names.

  • Create AMB Files Directly
  • If you select this checkbox, you can skip the hierarchical ALV display of the TCs and messages.

  • If you do not select this checkbox, you can select the TCs to be considered for AMB file creation manually. The system displays a hierarchical ALV list of the selected TCs and messages. You can use this option to check all the errors associated with the AMB records. You can then create files by manually selecting the TCs to be included.

Options available in the application toolbar of the hierarchical ALV list

These options are available only if the Create AMB Files Directly checkbox is not chosen as an execution option and, therefore, the hierarchical ALV list with TCs displays. For the below-mentioned options, you can mark the TC by positioning the cursor on the corresponding line of the hierarchical ALV list and then choosing an option.

Case Overview

You are re-directed to Case Overview (transaction NP10), where you can view the case details of the case of the TC. In the menu, you can choose Extras -> Treatment Certificates to access Maintain Treatment Certificates (transaction NP44).

TC Overview

Alternatively, you can also double-click on the TC line in the ALV to access Maintain Treatment Certificates (transaction NP44).

Here you can view the case and all the TCs of that case. You can change either the case details of the TC, or the TC details of the case, if required.

Note: You cannot immediately view the changes made to the TC in the ALV list of the Ambulatory Report. Run the Ambulatory Report again to view the refreshed data, then continue with the process of AMB file creation.

SAP/AMB View

You now have the possibility to see both the SAP and the AMB values of an AMB record via an ALV grid. The SAP value is the value which is represented in IS-H, and the AMB value is the value which is communicated to the external world.

The fields for the AMB view are obtained from the communication framework for the given communication standard and version. The values for these AMB view fields are obtained after conversions for character, numeric and date formats. The changes from the bAdI 'ISH_AMBDATA_FORMAT' are also encorporated within these AMB values.

Choose Detail

You now have the possibility to see only the values of fields which have been filled for the TC and displayed in the hierarchical ALV list. The values represented in IS-H are shown here.

File Create

Within the Ambulatory Report, you can mark the TC by selecting the corresponding checkbox in the hierarchical ALV list and choosing the option File Create. Note: You can only select the TCs which have no errors reported, that is, TCs with green or yellow traffic lights. By default, all error-free TCs are selected.

You now have the possibility to create three AMB files (AMB1, AMB2 and AMB3) for all selected TCs. The TCs are included in all three AMB files, hence, each line item of the file constitutes an AMB record.

Scenarios when the selected TCs are not included in the AMB files:

  • If you select TCs that have errors associated with them (signified by a red traffic light in the hierarchical ALV list display).
  • If you select TCs whose cases are locked at the moment of creation of the AMB files (signified by a red traffic light in the hierarchical ALV list display).
  • If you select TCs that cannot be included in the AMB files, they are not included in any of the three AMB files. However, if only the TEAM card details of the patient are unavailable for the case of a TC, this TC will be included in the AMB1 and AMB2 files, but not in the AMB3 file.

Scenarios when the AMB files are not created:

  • If the Communication-specific Customizing for the Ambulatory Report is missing, or not done correctly, you will encounter error messages at the status bar of the selection screen. Until you correct the Customizing, you will not be allowed to create the three AMB files.
  • If all TCs selected have errors associated with them (signified by red traffic lights in the hierarchical ALV list display for all TCs).
  • If all TCs selected are locked.
  • If there are errors after the call of the BAdI 'ISH_AMBDATA_FORMAT' within the AMB report.
  • If all TCs selected have cases which have no TEAM card details of the patient, no AMB3 file will be created in that execution run.

Canceled Treatment Certificates

Processing of canceled TCs takes place in a specific manner in the Ambulatory Report. In standard SAP Patient Management reports, canceled TCs are normally no longer accounted, but the Ambulatory Report works differently.

  • Selection of TCs
  • Canceled TCs are included in selection if you only select using TC-specific selection criteria such as 'End Date of Treatment', 'AMB Number', 'TC Number', 'Case', 'Case Selection', 'Patient' or 'TC Selection' and additional selection criteria such as 'Treatment Org. Unit', 'TC Category', 'TC Application Status', and 'Region'. Canceled TCs are not included if you specify the selection criterion 'Visit Date'. Also note that, if the TC is canceled, it is selected only if it has been communicated before to SSN as the Ambulatory Code is then determined from the already communicated one.

  • ALV list output
  • If a TC is canceled in the SAP Patient Management system and has not yet been sent to SSN, the system displays an error message indicating that the TC has been canceled. This is not included in AMB file creation, since this need not be communicated to SSN.

  • If a TC that is canceled in the SAP Patient Management system, and has communicated to SSN in the 'Final' version as canceled, and you attempt to communicate it again, the system displays the warning message "TC has already been communicated to SSN with 'Canceled' status". Morever, the system also displays an information message indicating that the TC has been canceled .

  • If a TC is already communicated to SSN and is later canceled in the SAP Patient Management system, the system displays an information message indicating that the TC has been canceled . This TC is included in AMB file creation, since information about its cancelation must be communicated to SSN. Note that this canceled TC is communicated to SSN with the communication status 'Cancellation' only in the 'Final' version, otherwise it always will be communicated with the internal communication status 'First Submission'.

Standard Variants

Output

The system displays a hierarchical ALV list of selected TCs and assigned messages. If you select the Create AMB Files Directly checkbox, you can create the AMB files with all marked TCs to be included and thus skip this. A statistical analysis is also displayed, for example:

  • Total number of TCs selected
The total number of TCs that were selected based on selection criteria entered at the selection screen.
  • File creation
The file names are generated by the Ambulatory Report with a predefined naming logic: ____
For example, the three AMB files in the temporary version in the 'Test Mode' would be assigned the following names:
  • 0001_1000_AMB1_20071204_125647_TEMP_TEST.TXT

  • 0001_1000_AMB2_20071204_125647_TEMP_TEST.TXT

  • 0001_1000_AMB3_20071204_125647_TEMP_TEST.TXT

The three AMB files in the final version in the 'Test Mode', however, would be assigned the following names:
  • 0001_1000_AMB1_20071204_125647_TEST.TXT

  • 0001_1000_AMB2_20071204_125647_TEST.TXT

  • 0001_1000_AMB3_20071204_125647_TEST.TXT

  • Output on SAP server
If you select this option, the AMB files created are made available on the SAP server. You can specify the path where you want the files to be stored on the server in the field Data Output Path on the selection screen.
  • Output to PC
If you select this option, you can enter the path where you want to store files on a local PC in the field Data Output Path on the selection screen.
  • Layout
  • Layout

You can define your own set of fields to display the results in the hierarchical ALV list of TCs. You can save this layout for future use.
  • Write TCs Included in Files into TC Selection

You can define or update your own TC selection here for SSN TCs that are included in the AMB files created in the real mode, and use it as a selection criterion while executing the AMB report in future. This is particularly necessary for re-sending the same set of SSN TCs in the temporary version if errors are reported by the authority for any of the TCs.
  • Write TCs Not Included in Files into TC Selection

You can define your own TC selection here for the SSN TCs that were not included in the AMB files created in the real mode (for example, locked TCs) and use it as a selection criterion while executing the AMB report in future. This is particularly necessary for sending the same set of SSN TCs in the temporary version to the authority which could not be sent before, as a result of errors.
Note1: If this option is selected, the TC Selection contains only those SSN TCs that were selected in the hierarchical ALV list but could not be included in the AMB files due to errors (for example, locked TCs). This means that the unselected SSN TCs or/and SSN TCs with errors in the ALV list will not be included into this TC selection.
Note2:The TC selection will be created only when the Ambulatory report is executed in the 'Real Mode' ,for both temporary and real versions of the AMB records.

Patient data on case level

Within the AMB record of the Ambulatory Report, there are fields included which are patient attributes, for example, Marital Status. These patient attributes may change over time but must be kept stable for the AMB record. Therefore, the system copies these patient-related attributes into the table NPNTCAS at the time of creation and saving of the first SSN TC on case level. You can view, and with the corresponding authorization, change this copied data via the SAP standard subscreen Patient Data on Case Level in the Clinical Process Builder (NV2000).

The exact point of copying of Patient Data for a TC is linked to the creation and saving of the first SSN TC of an outpatient case. The copied dataset is deleted only if the case of the TC is canceled. The values of this copied dataset are updated only via the SAP standard subscreen Patient Data on Case Level in the Clinical Process Builder (NV2000) and not via any of the other SAP subscreens for Patient and Address data.

A new 'COPY' option is also available in the subscreen, which you can use to manually copy patient data (NPAT (Patient Master data) and NADR (Patient Address details)) into NPNTCAS. This is useful in, for example, emergency cases, where you cannot fill the address details of the patient during the creation of the first SSN TC of the cases, but want to update it later.

After the patient data is copied, the Ambulatory Report retrieves the patient-related attributes only from this copy.

Note: There is one exception to this rule. The field Patient/Sex/Age in the field catalogue of the ALV always reflects thecurrent values of the patient level. Since this is not a field of the AMB record, and is only used for display purposes in the ALV list, it has no influence on the data within the AMB record of the AMB files.

Also, if the NPNTCAS entry for an outpatient case of a TC does not exist because the case was canceled, then the AMB record has no values reported for any of the fields coming in from NPNTCAS.

End Date of Treatment

This selection screen option corresponds to the field 'Completed On'' in the 'General'' tabstrip of the 'Detail'subscreen of treatment certificates via transaction NP44 (Maintain Treatment Certficates). Only if this field is filled for the SSN TC and the value is within the range of the value of the selection screen option 'End Date of Treatment', will the SSN TC be selected and displayed in the hierarchical ALV list.

First Visit of TC

The first visit of a TC selected for creation of AMB files is the basis for the data retrieval of all movement-related information of a TC. Therefore, in the ALV list you see only the first visit's details such as the OU, referral type and referral diagnosis. This is the information which will be included in the AMB files after conversion to the external format is done.

If the TC does not have any visit assigned to it as a result of the visit being canceled or the assignment itself being canceled, then the TC will not be selected as the determination of Ambulatory Code is not possible. However, if the TC is canceled, it is selected only if it has been communicated before to SSN as the Ambulatory Code is then determined from the already communicated one. For such TCs, all visit related details are not available and hence not shown in the ALV list and not communicated in the AMB files.

Locking of cases and case selections of TCs

All cases and case selections containing the selected TCs for the creation of AMB files will be locked at the time of file creation. This prevents any other user from updating the case details; and they also cannot even read the case data via other IS-H transactions.

This lock at the case level is implemented only during the real mode of creation of AMB files.

Every selected TC from the selection screen is displayed in the hierarchical ALV list without locking the TC case. During the real mode of creation, every case of the selected TC is locked (one case at a time) and the data is read again from the database to find the most up-to-date data. This data is then checked again, and the TCs of that case are included in the AMB files. (The TCs are only included if the lock on the case is successful, and no errors are reported.)

If the lock on a single case fails, all TCs of that case are omitted from the three AMB files and listed in an hierarchical ALV list of TCs at the end of the AMB report execution.

Activities

Background processing

The Ambulatory Program can be scheduled for background processing with the same execution options as above. The result is the same. The advantage of this is that the program can be scheduled for a specified time period and the AMB files can be created without user interaction.

First visit of TCs

Treatment Organizational Unit

SAP recommends that you assign the AMB Code that you have selected for the Ambulatory Report execution to the Treatment OU of the first visit assigned to the TC. This can be done via Create Organizational Unit (transaction NB20) in the Other Data tab in the AMB-Code block. This Treatment OU is then displayed in the hierarchical ALV list for the TC. However, this value is not communicated in the AMB files.

Also, you must define a Specialty Category and maintain Code Specialties for this Specialty Category. Assign one of these Specialty Codes to the OU of the first visit of the TC via Create Organizational Unit (transaction NB20). To define Specialty Category and maintain Code Specialties, see the Customizing for SAP Healthcare - Industry-Specific Components for Hospitals under Communication -> Electronic Data Interchange -> Customizing Step-By-Step -> IT: AMB Customizing. This is necessary to obtain the branch of the Treatment OU of the first visit of the TC. This value is then communicated in the AMB files.

Referral type

You must maintain the referral types for the movement category '4' - Outpatient visits with the Customizing for SAP Healthcare - Industry-Specific Components for Hospitals under Patient Management -> Movements -> Maintain Referral Types / Postdischarge Treatment Types.

You can use these values to assign a referral type for the first visit. This value is then displayed in the hierarchical ALV list for the TC and also communicated in the AMB files.

Referral diagnosis

You must assign a referral diagnosis to the first visit of the TC via Maintain Diagnosis for Case/Department (transaction NP61).

Note: Only the first referral diagnosis assigned to the first visit of the TC is considered (if more than one is assigned). This value is displayed in the hierarchical ALV list for the TC and also communicated in the AMB files.

You can also maintain the referral diagnosis for the first visit via the SAP Standard Variant, by choosing the first visit of the case assigned to the TC and entering the referral diagnosis in the Referral Diagnosis subscreen.

Note: If two TCs are assigned to the same first visit, and you want to communicate different referral diagnoses for each, you must create another visit and assign it as the first visit for one of the TCs.

Assignment of Health Insurance card (TEAM card) to case of the TC

Within the AMB record of the Ambulatory Report, there are details that are mandatory for foreign patients coming from the EU (European Union), or other countries with special health agreements. This information can be taken from the Health Insurance card (TEAM card) of the patient.

Process:

  1. Integrate the SAP provided subscreens Overview of Health Insurance Cards and Health Insurance Cards Dialog into a variant of the Clinical Process Builder.
  2. Start the Clinical Process Builder with the case number to which the TEAM card must be assigned.
  3. Click the Create Card pushbutton on the ALV toolbar in the Overview subscreen. A card of type 'EU_E111' is created with a temporary number as a node for the case. A version of this card is also created as a leaf under this node. If other (newer) versions must be created for the card as a result of changes in data, select the card and click the Create Version E111 pushbutton on the ALV toolbar.
  4. Enter all Health Insurance card (TEAM card) details of the patient in the Dialog subscreen visible below the Overview subscreen. When you select the card in the Overview, the Dialog subscreen displays the card details. These are prompted by the system. When you select the card version in the Overview, the Dialog subscreen shows the specific details of that version. You can also enter different details for that version.
  5. Assign the Health Insurance Card (TEAM card) to the case by assigning the Insurance relationships of the case to a version of the card.
    1. Select the card version in the Overview. A list of Insurance relationships (SSN and otherwise) for the case are displayed in the Dialog subscreen.
    2. Mark an Insurance relationship from the table control. The relationship is highlighted, indicating that this is the Insurance relationship that is to be assigned to the card version. (You can also cancel this assignment by unmarking the Insurance relationship. The relationship is no longer be highlighted, indicating that it is no longer assigned to the card version.)
Note: The list of Insurance relationships to be assigned to the card version consists of those that are not assigned to any other card version.
  1. Click Save. The card (permanent number) and assignments are saved onto the database.

Example

Purpose

Integration

Prerequisites

Features

Selection

Standard Variants

Output

Activities

Example






rdisp/max_wprun_time - Maximum work process run time   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.

Length: 29220 Date: 20240520 Time: 091618     sap01-206 ( 516 ms )