Schedule Version - Engrate Developer Documentation

{
  "acceptance_level": "cnf",
  "created_ts": "2026-03-25T14:00:00+00:00",
  "is_active": true,
  "last_modified_ts": "2026-03-25T14:05:00+00:00",
  "message_id": "MSG-20260325-001",
  "nrr_received": true,
  "org_uid": "9b2e4d8f-1c3a-4f5e-8d7b-6a9e0f2c1b3d",
  "schedule_uid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "spec": {
    "market": "DE",
    "receiver_id": "10XDE-VE-TRANSMK",
    "sender_id": "11XDE-SENDER---A",
    "series": [],
    "tso": "50HERTZ_DE_TSO"
  },
  "status": "accepted",
  "transmission_report_id": "TR-20260325-001",
  "uid": "c8d7e6f5-4a3b-4c2d-9e1f-0a8b7c6d5e4f",
  "version": 1
}

A schedule version represents one submission attempt within a Schedule. Each time you re-submit for the same TSO + delivery date, a new version is created with an incremented version number. The TSO message ID is reused with a _v{N} suffix.

Status lifecycle

Versions progress through these statuses as the TSO processes the submission:

Status	Meaning
`created`	Queued by the platform, not yet sent to the TSO
`submitted`	Sent to the TSO via AS4
`ack_positive`	TSO acknowledged receipt of the document
`ack_negative`	TSO rejected the document at receipt
`ack_partial`	TSO acknowledged the document with some series rejected
`icnf`	Intermediate confirmation (DE only)
`dacnf`	Day-ahead confirmation
`cnf`	TSO confirmed the schedule values
`cnf_partial`	TSO partially confirmed — some series accepted, others rejected
`fcnf`	Final confirmation

Acceptance levels

The acceptance_level field tracks the highest acknowledgement received from the TSO:

Level	Meaning
(empty)	No TSO response yet (or only submitted)
`ack`	ACK received — the TSO acknowledged receipt of the document
`ano`	The TSO rejected the schedule
`par`	Partial confirmation — some series accepted, others rejected
`cnf`	CNF received — the TSO confirmed the schedule values

Active version

The active version (is_active=true) is the latest version the TSO has accepted — the one it currently treats as binding. Versions that were rejected or are still awaiting a response are not active, and a later rejected version never replaces an accepted earlier one.

A Schedule Version representing one submission attempt. Each re-submission creates a new version.

acceptance_level

string

required

Highest acceptance level reached: empty string, ack, or cnf.

Examples:

"cnf"

"ack"

""

created_ts

string

required

ISO 8601 datetime when this version was created.

Example:

"2026-03-25T14:00:00+00:00"

last_modified_ts

string

required

ISO 8601 datetime of the most recent status change.

Example:

"2026-03-25T14:05:00+00:00"

org_uid

string

required

Organization that owns this version.

Example:

"9b2e4d8f-1c3a-4f5e-8d7b-6a9e0f2c1b3d"

schedule_uid

string

required

Parent Schedule identifier.

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

spec

ScheduleVersionSpec · object

required

Full submission specification including market routing and series references.

Show child attributes

status

string

required

Processing status: ingested, submitted, accepted, rejected, cnf_partial, or icnf.

Examples:

"accepted"

"submitted"

"rejected"

uid

string

required

Unique identifier for this version.

Example:

"c8d7e6f5-4a3b-4c2d-9e1f-0a8b7c6d5e4f"

version

integer

required

Sequential version number (1-based). Increments with each re-submission.

Examples:

1

2

3

is_active

boolean

default:true

Whether this version is the active one according to the authoritative TSO message ID. Older versions become inactive when a new version is accepted.

message_id

string | null

TSO document identification assigned to this version's message.

Example:

"MSG-20260325-001"

nrr_received

boolean | null

Whether a Non-Repudiation of Receipt (NRR) delivery confirmation has been received from the TSO.

transmission_report_id

string | null

Mako365/AS4 transmission report identifier for delivery tracking.

Example:

"TR-20260325-001"

warnings

WarningItem · object[] | null

TSO warnings from the ACK response, if any.

Show child attributes

Schedule Schedule Series

⌘I

​Status lifecycle

​Acceptance levels

​Active version

Status lifecycle

Acceptance levels

Active version