IATA_OrderChangeNotifRQ

Notification · Order Management · Implemented

Implemented

This airline sends IATA_OrderChangeNotifRQ to your notification endpoint — see Notifications. Delivers: ORDOCN Airline-initiated change notification · ORDOC2 Notification with advanced features · PAYRCV Payment recovery · STPNTF Notification message setup.

Limits today:

• PAYRCV — A declined payment leaves the order held within its payment time limit and the seller retries with OrderChangeRQ; at the limit the order is cancelled and the seller is sent an OrderChangeNotifRQ (order.payment_expired).

Rests on simulated supply (payment) — flagged on every response; see Simulated supply.

Asynchronous notification that an order changed (initiated elsewhere).

When to use

Push channel — the airline notifies the seller that an order changed.

Transport

Property	Value
Method & path	POST /24.4/OrderChangeNotifRQ
Content-Type	application/xml
Auth	Authorization: Bearer <token> (or X-API-Key: <key>)
Routing header	IATA-Message-Name: IATA_OrderChangeNotifRQ

See Authentication & connection for the full handshake.

Request example

note

✅ The example below validates against the original XSD.

<?xml version="1.0" encoding="UTF-8"?>
<IATA_OrderChangeNotifRQ xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersMessage">
  <DistributionChain>
    <DistributionChainLink xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
      <Ordinal>1</Ordinal>
      <OrgRole>Carrier</OrgRole>
      <ParticipatingOrg>
        <OrgID>X</OrgID>
      </ParticipatingOrg>
    </DistributionChainLink>
  </DistributionChain>
  <Notification>
    <ChangeGroup>
      <ChangeOperationGroup>
        <ChangeOperation>
          <ChangeDateTime>2024-06-01T09:00:00Z</ChangeDateTime>
          <ChangeTypeCode>X</ChangeTypeCode>
          <ReasonCode>X</ReasonCode>
        </ChangeOperation>
        <OrderVersionNumber>1</OrderVersionNumber>
      </ChangeOperationGroup>
    </ChangeGroup>
    <OrderRefID>X</OrderRefID>
  </Notification>
</IATA_OrderChangeNotifRQ>

Key fields

Top-level content model of IATA_OrderChangeNotifRQ (one level deep, including inherited content):

Field	Type	Required	Repeatable	Notes
AugmentationPoint	xs:any	—	—	extension point (AugmentationPoint)
DistributionChain	DistributionChainType	✓	—
Notification	OrderChangeNotifType	✓	—
PayloadAttributes	IATA_PayloadStandardAttributesType	—	—

Build it with the SDK

The @oms/ndc-24-4 package is a reference SDK — build, serialize, parse, and validate this message in code:

import { IATA_OrderChangeNotifRQ } from '@oms/ndc-24-4';

const xml = IATA_OrderChangeNotifRQ.toXML(payload, { pretty: true });
const obj = IATA_OrderChangeNotifRQ.parseXML(xml);    // round-trips
IATA_OrderChangeNotifRQ.schema.parse(obj);            // strict Zod validation

Related

• All Order Management messages
• Postman collection & SDK · OpenAPI contract