---
module: transactions.journal-parsing
title: Journal Parsing Rules
tab: Testing
order: 35
audience: dev
---

Frontend test checklist for **Journal Parsing** in the Transactions SPA (`transactions.bcos.dev`). Click through in the UI and mark each row Pass or Fail. The screen lives under **Settings → Journal → Parsing → ATM**.

## Set up
Log in at **transactions.bcos.dev** — test accounts (all password `Passw0rd-d3v!`):

| Login | Role | Sees |
|-------|------|------|
| `bcos_a@bcos.dev` | Admin | All institutions · full Settings |
| `msp_a@msp1.bcos.dev` | MSP admin | C1 + C2 · full Settings |
| `customer_a@customer1.bcos.dev` | Customer | C1 only · read-only |

For the Reparse test use a simulator ATM ID like **C1-ATM-001**.

## What to test

| # | Do this | ✅ Pass if |
|---|---------|-----------|
| 1 | As `msp_a`, open the **Settings** gear → **Journal** → **Parsing** → **ATM** | Page **Journal Parsing** loads with three panels: **Journal Parsing Rules**, **Journal / Vendor Types**, **Reparse Journals** |
| 2 | Look at the **Journal Parsing Rules** panel | Rules show as read-only sections labelled **Version**, **Timestamp Pattern**, **Transaction Rules**, **System Events** |
| 3 | Click **Reload Rules** | A green message like **"Rules reloaded (v…)"** appears with a version number |
| 4 | Click **Edit Rules** | The rules turn into an editable text box; the buttons change to **Cancel** and **Save & Apply** |
| 5 | Click **Cancel** | Editing closes, the grouped read-only view returns, nothing changed |
| 6 | **Edit Rules** again, make a tiny change, click **Save & Apply** | A green **"Saved and applied (v…)"** message shows and the version number is higher than before |
| 7 | Look at the **Journal / Vendor Types** panel | It lists type badges, or shows **"No vendor types defined"** — either way, no error |
| 8 | In **Reparse Journals**, type `C1-ATM-001` in the box | The button label updates to **"Reparse C1-ATM-001"** |
| 9 | Clear the box (blank), then click **Reparse All** | A green message like **"Queued N of M journal files for re-parse."** appears |
| 10 | Log in as `customer_a` and look at the left sidebar | Only **Transactions** shows — there is **no Settings gear**, so Journal Parsing can't be reached at all |

**Report a fail with:** the row #, which login you used, and what you actually saw.
