The Net Remittance modifiers supports Net Remit or Net Fare ticketing. These modifiers change the fare-related data output on tickets and support documents and add information that the airline uses to reconcile the discounts with agency contracts. These modifiers are used in certain markets, but not allowed in others. In addition, some modifiers may only be used in conjunction with others; this varies by country/BSP.
The modifiers in this family are:
- NetRemit
- ActualSellingFare
- AccountingInfo
- NetFare
- InvoiceFare
- CorporateDiscount
- Commission (Value Code)
Request
The UniversalRecordModifyReq/UniversalModifyCmd/AirAdd/AirPricingTicketingModifiers/TicketingModifiers request is used to set Net Remittance modifiers.
To add Ticketing modifiers to multiple stored fares using a single Universal API request, use multiple UniversalModifyCmds, and specify the data separately for each stored fare. For a particular stored fare, all the AirPricingTicketingModifiers/AirPricingInfoRef must be specified or an error is returned. A stored fare is identified by the value of AirPricingInfoGroup, and all AirPricingInfos that have the same AirPricingInfoGroup belong to the same stored fare in the provider reservation.
Net Remit
When NetRemitApplied is "true", the BSP net remittance scheme applies to the ticketed fare.
Actual Selling Fare
ActualSellingFare allows an agency to report an Actual Selling Fare as part of the net remittance BSP agreement. An amount can be added.
Accounting Information
AccountingInfo allows an agency to report Accounting Information as part of the net remittance BSP agreement.
Corporate Discount
Corporate Discount allows an agency to add a corporate discount to the itinerary to be ticketed.
Invoice Fare
InvoiceFare allows an agency to report an Invoice Fare as part of the net remittance BSP agreement. The CGNR tables are provider tables that control what modifiers may be used in a country, as well as combination rules in that country.
Show possible required CGNR formats
- AML: Amount should be entered with local currency with currency code.
- AMZ: Amount should be entered without currency code.
- AMT: Amount should be entered with any currency with currency code.
The InvoiceFare/Value is checked to see if a valid currency code has been passed at the start of the value, e.g., GBP200.00. Any decimal place within the value must be removed.
Net Fare
NetFare allows an agency to set the amount for a ticketed fare.
Commission
Commission allows an agency to modify the value or commission of the ticket. Only one form of commission can be saved per fare (either percentage or amount).
Commission can be entered as a generic ticketing modifier without the Modifier attribute or submitted with @Modifier values.
- FarePercent: Commission percentage applied to the fare.
- FareAmount: Commission amount applied to the fare.
- CommissionAmount: Specific commission amount applied to the fare.
LessStandardCommission: Commission percentage applied to the fare, less the standard commission.
- StandardPlusSupplementaryPercent: Commission percentage includes standard and supplementary commission.
- SupplementaryPercent: Supplementary commission percent that is applied to the fare.
- SupplementaryAmount: Supplementary commission amount that is applied to the fare.
-
@Amount is used for Net Remit ticketing, and documents how the commission is to be calculated/reported. Amount is an optional string. Either the Value or the Amount attribute must be populated, but are mutually exclusive.
-
@Value is used for Net Remit ticketing, and documents how the commission is to be calculated/reported. The Value is supported only if the BSP permits a Net Remit scheme. A Value that is valid for the scheme/method for customer’s BSP must be entered.
Special characters and spaces are not supported in @Value because they are not accepted by Galileo. Value supports non-numeric commission values. When the Value attribute is populated, additional Commission attributes must have the following values:
- Level="Fare"
- Type="Flat"
Value is an optional string. Either the Value or the Amount attribute must be populated, but are mutually exclusive. Additionally, if the Value attribute is populated, a valid value must be supplied in the Modifier attribute.
Value Modifier
ValueModifier allows an agency to modify the value or commission of the ticket. The modifier is generic and depends on the specific GDS and BSP implementation. ValueModifier is a net fare amount that has standard commission applied to it.
Response
A successful response includes the UniversalRecordModifyRsp.
Errors and Warnings
Previously, in Worldspan (1P), during Universal Record Modify, the Net Remit modifiers (Net Fare, Accounting Info, and Value Modifier) were added as a DI line to the PNR in a random sequence. This random sequence was complicating the transaction and sometimes triggering errors during ticketing. Currently, these elements (Net Fare, Accounting Info, and Value Modifier) are sent in the sequence that the customer sends (predefined sequence based on the availability of these elements in the request).
When all the three parameters (Net Fare, Accounting Info, and Value Modifier) are present, the DI line is built as follows:
4-DI|NN<AccountingInfo>/<ValueModifier>/<NetFare>
Note: Accounting Info has a prefix of C, and Value Modifier has a prefix of V.
For all requests that include Commission, the Level attribute must be "Fare", otherwise an error is returned: Only Fare Level commissions are supported as a ticketing modifier
FarePercent Validation
When Commission/Modifier is set to FarePercent:
- Commission/Type must be "PercentBase" or "PercentTotal", an error is returned: Commission Type must be set to PercentBase or PercentTotal for FarePercent Commission
- If "PercentBase" or "PercentTotal", then Percentage must be present or an error is returned: Percent is required for FarePercent Commission
- Percentage must be a whole amount (e.g., 12.5 is not acceptable) or an error is returned: Only whole percentages are supported by the host system
FareAmount Validation
When Commission/Modifier is set to FareAmount:
- Commission/Type must be "Flat", or an error is returned: Commission Type must be set to Flat for amount commissions
- Commission/Amount must be present, or an error is returned: Commission amount must be set for Flat amount commissions
- Amount must be a whole amount (e.g., 12.5 is not acceptable) or an error is returned: Only whole currency amounts are supported by the host system
CommissionAmount Validation
Commission Modifier is set to CommissionAmount:
- Commission/Type must be "Flat", or an error is returned: Commission Type must be set to Flat for amount commissions
- Commission/Amount must be present, or an error is returned: Commission amount must be set for Flat amount commissions
- Amount must be a whole amount (e.g., 12.5 is not acceptable) or an error is returned: Only whole currency amounts are supported by the host system
LessStandardCommission Validation
When Commission/Modifier is set to LessStandardCommission:
- Commission/Type must be "PercentBase" or "PercentTotal", or an error is returned: Commission Type must be set to PercentBase or PercentTotal for LessStandardCommission Commission
- If "PercentBase" or "PercentTotal", then Percentage must be present or an error is returned: Percent is required for LessStandardCommission Commission
- Percentage must be a whole amount (e.g., 12.5 is not acceptable) or an error is returned: Only whole percentages are supported by the host system
StandardPlusSupplementaryPercent Validation
When Commission/Modifier is set to StandardPlusSupplementaryPercent:
- Commission/Type must be "PercentBase" or "PercentTotal", or an error is returned: Commission Type must be set to PercentBase or PercentTotal for StandardPlusSupplementaryPercent Commission
- If "PercentBase" or "PercentTotal", then Percentage must be present or an error is returned: Percent is required for StandardPlusSupplementaryPercent Commission
- Percentage must be a whole amount (e.g., 12.5 is not acceptable) or an error is returned: Only whole percentages are supported by the host system
SupplementaryPercent Validation
When Commission/Modifier is set to SupplementaryPercent:
- Commission/Type must be "PercentBase" or "PercentTotal", or an error is returned: Commission Type must be set to PercentBase or PercentTotal for SupplementaryPercent Commission
- If "PercentBase" or "PercentTotal", then Percentage must be present or an error is returned: Percent is required for SupplementaryPercent Commission
- Percentage must be a whole amount (e.g., 12.5 is not acceptable) or an error is returned: Only whole percentages are supported by the host system
SupplementaryAmount Validation
When Commission/Modifier is set to SupplementaryAmount:
- Commission/Type must be "Flat", or an error is returned: Commission Type must be set to Flat for amount commissions
- Commission/Amount must be present, or an error is returned: Commission amount must be set for Flat amount commissions
- Amount must be a whole amount (e.g., 12.5 is not acceptable) or an error is returned: Only whole currency amounts are supported by the host system