Parsers

What is a Parser?

A parser defines the data structure for events in a specific vertical. It controls which fields are collected, how they are encoded for transmission, and whether they can be sent offline via structured protocols when internet connectivity is unavailable. Each parser belongs to a tenant and is scoped to a vertical - healthcare, banking, emergency, logistics, telecom, or gov. A tenant can have multiple parser versions per vertical, but only one is active at a time.

Why Parsers Matter

In environments where connectivity is unreliable, every byte counts. When an event cannot be sent via REST, Wede falls back to structured protocols. A parser ensures that the most critical fields are encoded efficiently - fitting into as few protocol units as possible - while preserving data integrity and legal compliance. A well-configured parser means your operations continue without interruption, regardless of network conditions.

Field Sections

Each parser is composed of fields organised into sections:

Section	Purpose
`core`	Mandatory identifiers and timestamps - always transmitted
`location`	GPS coordinates and addresses
`human`	Person data - subject to legal and GDPR requirements
`hardware`	Equipment, vehicle and device identifiers
`team`	Responder team, dispatch and capacity data
`custom`	Tenant-defined free fields

Field Types

Type	Description	Max Bytes
`string`	Short text	20
`number`	Numeric value	8
`boolean`	Yes/No flag	1
`gps`	Latitude/longitude coordinates	18
`text`	Free text (longer)	80
`timestamp`	ISO date/time	14
`enum`	Fixed set of values	6
`phone`	Phone number	15
`email`	Email address	30
`address`	Free text address	60
`hardware_id`	Device or equipment ID	16

Structured Encoding

Wede calculates the estimated byte size of each enabled field and the total payload size. If the payload exceeds 140 bytes, it is automatically fragmented and reassembled at the destination - transparently, without changes to your integration. Each field is encoded as compact key-value pairs. The field code is a short identifier (up to 8 characters) that minimises transmission size. Fields marked offline_capable: false are excluded when transmitting via structured protocols.

Legal Fields

Fields marked legal: true contain personally identifiable information (PII). These fields are subject to GDPR and local data protection regulations. Wede logs access to legal fields in the audit trail automatically.

Versioning

When you update a parser schema, Wede creates a new version. The previous version is deactivated but retained for audit purposes. All events are tagged with the parser version active at the time of creation.

Parser Protection — Three Layers

Parsers are protected at three levels to prevent accidental or malicious modification of critical fields:

Protection	Flag	Description
Integrity	`integrity: true`	Fields required for event identity (event_id, timestamp, tenant_id). Cannot be disabled or modified.
Legal	`legal: true`	Fields containing PII subject to GDPR. Modification is logged as a compliance event.
Locked	`locked: true`	Operationally critical fields (dispatch triggers, channel selectors). Require admin override.

Attempts to modify protected fields are rejected and recorded in the Audit Log as parser.update.rejected.

Action Catalog Integration

The event_type field in a parser points to the action catalog — not a hardcoded list. This means:

The tenant defines which event types exist (via the catalog)
The parser event_type field references catalog action codes
Teams are linked to catalog actions to determine dispatch eligibility

To configure event types for a parser, go to Parsers → Actions tab in the dashboard and link catalog actions.

Automatic Seed on Vertical Assignment

When a vertical is assigned to a tenant, Wede automatically seeds a default parser for that vertical. The seed parser includes:

Core integrity fields (locked)
Standard legal fields (locked)
Vertical-specific operational fields (configurable)

The tenant can extend the seeded parser with custom fields but cannot remove core or legal fields.

Roles & Access

Role	Access
`wede_global_admin`, `wede_tech_ops`	All parsers across all tenants
`country_admin`	Parsers for tenants in assigned countries
`company_admin`, `company_tech`	Own tenant parsers, own verticals only
`operational_supervisor`	Read-only view
`field_operator`	No parser access

Example - Healthcare Parser

A minimal healthcare parser for offline-capable emergency events:

{
  "vertical": "healthcare",
  "name": "Healthcare v1",
  "schema": [
    { "id": "hc_eid", "name": "event_id", "sms_code": "eid", "type": "string", "required": true, "enabled": true, "offline_capable": true, "section": "core", "max_bytes": 12 },
    { "id": "hc_ts", "name": "timestamp", "sms_code": "ts", "type": "timestamp", "required": true, "enabled": true, "offline_capable": true, "section": "core", "max_bytes": 14 },
    { "id": "hc_typ", "name": "event_type", "sms_code": "typ", "type": "enum", "required": true, "enabled": true, "offline_capable": true, "section": "core", "max_bytes": 6, "enum_values": ["CARDIAC", "TRAUMA", "STROKE", "RESPIRATORY", "OTHER"] },
    { "id": "hc_pid", "name": "patient_id", "sms_code": "pid", "type": "string", "required": true, "enabled": true, "offline_capable": true, "section": "human", "max_bytes": 16, "legal": true },
    { "id": "hc_gps", "name": "requester_gps", "sms_code": "rgps", "type": "gps", "required": true, "enabled": true, "offline_capable": true, "section": "location", "max_bytes": 18 }
  ]
}

This parser fits in a single protocol unit (approximately 90 bytes), ensuring delivery even on the most degraded networks.

Introduction

Core Concepts

Examples by Vertical

What is a Parser?

Why Parsers Matter

Field Sections

Field Types

Structured Encoding

Legal Fields

Versioning

Parser Protection — Three Layers

Action Catalog Integration

Automatic Seed on Vertical Assignment

Roles & Access

Example - Healthcare Parser

​What is a Parser?

​Why Parsers Matter

​Field Sections

​Field Types

​Structured Encoding

​Legal Fields

​Versioning

​Parser Protection — Three Layers

​Action Catalog Integration

​Automatic Seed on Vertical Assignment

​Roles & Access

​Example - Healthcare Parser

What is a Parser?

Why Parsers Matter

Field Sections

Field Types

Structured Encoding

Legal Fields

Versioning

Parser Protection — Three Layers

Action Catalog Integration

Automatic Seed on Vertical Assignment

Roles & Access

Example - Healthcare Parser