ticket_operations_get

Prepare ticket availability, parking metadata, seated price overrides or deletion for one exact E00003 schedule. This is a read; it never changes a seat or deletes a schedule.

Supply channelCode, pAppCode:"E00003", observed eventId, hallId, scheduleId and the full intended operation. Business IDs are 1–160 ASCII letters, digits, underscores or hyphens. Requires the selected installed app and OWNER or MANAGE_P_APPS permission. E00002 is retired.

parking is {type,memo}. Type is LOCATION, EXTERNAL, DEACTIVATED or ETC; memo is at most 200 UTF-16 units, including empty text. Objects are strict. Do not supply buyer details, caller currency, URLs, credentials or raw HTTP requests. For example, this operation fragment blocks two observed available seats:

{"kind":"parkMany","sheetItemIds":["observed-sheet-1","observed-sheet-2"],"parking":{"type":"DEACTIVATED","memo":"Maintenance"},"confirmation":"CHANGE_TICKET_AVAILABILITY"}

The tool reads the whole unpaged management sheet, up to 500 items, and checks identities, exact schedule/event/hall, seat positions and counts. Purchased, reserved, assigned, discounted or printed selected seats cannot be changed. Deletion requires every seat unoccupied. A price or isPaid flag alone is not a purchase. Unrelated occupied seats may remain while eligible seats are changed.

Bulk changes use one dispatch for only unsatisfied selected items. An already parked seat with different metadata requires parkingMeta, not park. Release keeps one common existing tier and exact policy prices; price overrides and mixed tiers are excluded from release. This override restriction is an unresolved service-contract/preservation limit; the original control room does expose release for parked, unpurchased selections. Prepare separate same-tier selections if necessary.

Price overrides use price and require a SEATING schedule, eligible unoccupied tickets and identical stored policy/override maps across selected seats. One exact policy tier-price is changed while every other override and the original schedule prices remain intact. Paid amounts follow channel currency rules; zero requires explicit free. This original control-room action exposes seated items only and has no explicit override reset/removal entry; tier changes are outside this option. See the source action boundaries. Price preparation returns pricingObservation with selected IDs and their complete observed overrides; a missing/null map means no existing override.

Success returns TICKET_OPERATION, scheduleId, scheduleStatus, ticketCounts, configuration-only items, a revision tied to the exact operation, a bounded request preview and writesPerformed:false. A null request means the intended state already matches. No task is created. Purchaser fields are not returned.

Use the unchanged operation and returned revision with ticket_operation_apply. Changing any target, selection or setting requires another preparation. Current reads open the exact schedule control room; deletion preparation opens its surviving schedule list. Follow the single returned URL instead of constructing a different host or target path.

A successful read does not prove that a mutation, customer purchase or refund works. Actual MCP changes and original-console comparison remain separate checks.

Exact preparation contract

Every call requires an operation; there is no plain discovery/list view or optional operation. Obtain the existing event, hall, schedule and sheet item IDs from an authorized current observation such as the original control room. Never substitute seatId, slotId or a numeric database ID for sheetItemId. Use a separate preparation for every changed target, selection, parking value or operation kind, even when single and bulk forms would have the same effect.

The selected authorized channel needs one exact installed E00003 pApp and its current consumer/base currency. OWNER is allowed; a MANAGE_P_APPS delegate also needs a current manual policy permitting configuration. Content-only delegates and account scope are excluded. Connection, credential version, actor, channel, installation, consumer, currency and permissions are checked again before effects. BOOK_AND_TICKET_V3 uses the selected API origin with no shop store or alternate service fallback.

parking.type and parking.memo are both required for park/parkingMeta variants. Memo is not trimmed and may be empty; null and omitted memo are invalid. The shared input and HTTP boundary enforce 200 UTF-16 code units, not 200 visible characters: an astral character consumes two units, so 100 such characters fit and 101 do not. A metadata edit supplies the complete replacement type and memo. The four type literals are accepted without inventing a different availability workflow for each.

For an active schedule, preparation reads the exact schedule detail and its complete unpaged ticketing management sheet twice. At most 500 items are accepted. It verifies consumer, schedule/event/hall parents, seat-template identity, schedule time consistency, unique sheet/seat identities, seat positions and full count reconciliation. Rows are normalized by sheetItemId. This is not a search or best-effort partial inventory.

An occupied selected item rejects the whole preparation, even if its availability would otherwise be satisfied. Occupancy includes purchase/print flags and populated reservation, buyer/assignment or discount fields; it is not inferred from ordinary ticket price or isPaid. Eligible changes may coexist with unrelated occupied rows, which must remain unchanged. The returned configuration items omit raw buyer fields; fingerprints track changes in otherwise omitted source data. Ticket histories are excluded from configuration comparison and are not erased or verified by this workflow.

Release requires the stored seat and metadata tier to agree, that tier to exist in the schedule's tier list, and exactly one matching currency/price for it in every observed event policy. The parked row's policy-price projection must equal those schedule prices. Price overrides are rejected. All changed targets in one bulk release must share one common existing tier. Use separate exact preparations for different tiers; do not add a caller tier or price override. Already-online satisfied rows are not converted again.

Complete preparation examples

The earlier JSON block is an operation fragment. The following are complete getter arguments for the original seven variants, with illustrative IDs. Replace them with authorized observations; they do not discover targets or authorize changes. Each example prepares its own operation-specific revision.

Prepare a single seat hold:

{
  "channelCode": "L2NoYW5uZWxzLzk4",
  "pAppCode": "E00003",
  "eventId": "event-example",
  "hallId": "hall-example",
  "scheduleId": "schedule-example",
  "operation": {
    "kind": "park",
    "sheetItemId": "sheet-example",
    "parking": {
      "type": "DEACTIVATED",
      "memo": "Maintenance"
    },
    "confirmation": "CHANGE_TICKET_AVAILABILITY"
  }
}

Prepare a single release at its existing tier and prices:

{
  "channelCode": "L2NoYW5uZWxzLzk4",
  "pAppCode": "E00003",
  "eventId": "event-example",
  "hallId": "hall-example",
  "scheduleId": "schedule-example",
  "operation": {
    "kind": "unpark",
    "sheetItemId": "sheet-example",
    "confirmation": "CHANGE_TICKET_AVAILABILITY"
  }
}

Prepare a complete parking type/memo replacement, clearing the memo:

{
  "channelCode": "L2NoYW5uZWxzLzk4",
  "pAppCode": "E00003",
  "eventId": "event-example",
  "hallId": "hall-example",
  "scheduleId": "schedule-example",
  "operation": {
    "kind": "parkingMeta",
    "sheetItemId": "sheet-example",
    "parking": {
      "type": "LOCATION",
      "memo": ""
    }
  }
}

Prepare a hold for two exact items:

{
  "channelCode": "L2NoYW5uZWxzLzk4",
  "pAppCode": "E00003",
  "eventId": "event-example",
  "hallId": "hall-example",
  "scheduleId": "schedule-example",
  "operation": {
    "kind": "parkMany",
    "sheetItemIds": [
      "sheet-example",
      "sheet-example-2"
    ],
    "parking": {
      "type": "DEACTIVATED",
      "memo": "Maintenance"
    },
    "confirmation": "CHANGE_TICKET_AVAILABILITY"
  }
}

Prepare release for two items sharing one existing tier:

{
  "channelCode": "L2NoYW5uZWxzLzk4",
  "pAppCode": "E00003",
  "eventId": "event-example",
  "hallId": "hall-example",
  "scheduleId": "schedule-example",
  "operation": {
    "kind": "unparkMany",
    "sheetItemIds": [
      "sheet-example",
      "sheet-example-2"
    ],
    "confirmation": "CHANGE_TICKET_AVAILABILITY"
  }
}

Prepare a shared type/memo replacement on two parked items:

{
  "channelCode": "L2NoYW5uZWxzLzk4",
  "pAppCode": "E00003",
  "eventId": "event-example",
  "hallId": "hall-example",
  "scheduleId": "schedule-example",
  "operation": {
    "kind": "parkingMetaMany",
    "sheetItemIds": [
      "sheet-example",
      "sheet-example-2"
    ],
    "parking": {
      "type": "EXTERNAL",
      "memo": "External allocation"
    }
  }
}

Prepare deletion of the exact unoccupied schedule:

{
  "channelCode": "L2NoYW5uZWxzLzk4",
  "pAppCode": "E00003",
  "eventId": "event-example",
  "hallId": "hall-example",
  "scheduleId": "schedule-example",
  "operation": {
    "kind": "deleteSchedule",
    "confirmation": "DELETE_SCHEDULE"
  }
}

Output and rejected preparation

TICKET_OPERATION returns scheduleId, scheduleStatus, ticketCounts and items containing sheetItemId, seatId, type, parking, isPurchased, isPrinted, occupied, price and seat. It also returns revision, request and writesPerformed:false. The taskType is commerce-ticket-operation and screenId is channel.ticket-operations; these routing fields do not mean a task was created.

The revision binds the entire observed configuration and selected operation. request is the bounded proposed transport form, not an accepted raw-HTTP input. request:null means every selected value is satisfied; a getter never dispatches or creates a journal. Generated timestamps and equivalent monetary/time representations are normalized for stable comparison. Two matching observations do not supply an atomic snapshot or causal proof.

Schema, authorization and context errors may also reject the request. Obtain fresh observations and resolve the cause before preparing a new unsent operation. For uncertain sent work, preserve its original task instead of changing IDs. See the apply recovery contract and original-console destinations.

These methods do not create/edit schedule metadata or manage discount-policy lifecycle. Price changes the selected seated-ticket override only; it does not change the source schedule policy prices. Schedule listing was not connected at this source boundary. The later bounded schedule list provides observed schedule IDs; it does not prepare a control-room operation or discover every creation dependency.

Seated-ticket price preparation

operation.kind:price selects 1–100 unique sheetItemIds and one observed eventPolicyTierPriceId, with payment free or paid decimal text. It has no confirmation field. Observe that exact policy-price ID in the original control room; the getter requires the intended operation and does not provide schedule discovery. Do not substitute a policy ID, tier label ID, seatId or slotId.

Only SEATING schedules and unoccupied selected tickets are supported. The workflow also guards assigned, printed and other occupied records, beyond that original button predicate. ONLINE items require a matching slot/seat/tier projection; PARKING items must not retain an online slot. Every selected policy must contain exactly one price for the seat tier, with unique policy and price IDs, verified channel currency and a matching schedule policy projection. There may be at most 100 policy/price entries and 100 override entries. Selected tickets must share the same stored policy projections and complete override map; prepare differing groups separately.

A missing/null override map is interpreted as empty. An existing override must identify a known policy-price ID in the same currency. New payment amounts use the ticket currency/channel rules, including explicit free for zero. This operation does not compute the discount-policy base-price cap. It preserves original schedule policy prices and changes one seat-level override entry, rather than editing a default or discount policy.

pricingObservation returns each selected sheetItemId with its complete observed overriddenPrices map, which can be omitted or null when no map exists. An effective amount already equal to the requested amount is satisfied: the tool does not create a redundant override merely to restate the inherited price. A price preparation revision cannot authorize a different selection, price ID or payment.

The UTF-16 input limit applies to newly supplied parking memos. Preserve old journals instead of rewriting them to bypass validation.

Complete price preparation, assuming KRW and observed eligible same-policy seats:

{
  "channelCode": "L2NoYW5uZWxzLzk4",
  "pAppCode": "E00003",
  "eventId": "event-example",
  "hallId": "hall-example",
  "scheduleId": "schedule-example",
  "operation": {
    "kind": "price",
    "sheetItemIds": [
      "sheet-example",
      "sheet-example-2"
    ],
    "eventPolicyTierPriceId": "policy-price-example",
    "payment": {
      "kind": "paid",
      "amount": "1500"
    }
  }
}

Source action boundaries

The current price request and commerce-ticket-operation recovery contract are unchanged by these distinctions. They do not authorize a broader input, replay, hidden backend action or automatic restoration. Actual saved values, original-console comparison and restoration remain unverified.

Inputs