There are two notable sections for summarising costings within a message. The first is at a service level, where the cost can be summarised by service type, and the second is by pax break within a PCM message.
Service Summary Section
The SUMMARY section tags allow services costs to be summarised in either the Header or Tail of the message.
The summary can be by
- Product Service Type, or
- Product Analysis Codes 1 - 6
- A number of variations on the output currency of the summary depending on user's organisation requirements. (Tourplan support offers assistance with specialised messaging variations)
Section Tags
The section tags <<SUMMARY:START>> and <<SUMMARY:END>> must be outside of the SERVICES section tags.
The type of summary is determined by sub-code(s) appended to the <<SUMMARY:START>> tag - e.g.,
- <<SUMMARY:START:SRV:AC>> would output a summary of costs for the services in the booking with (SRV) Service Code AC - Accommodation. No other services would have the costs summarised.
- <<SUMMARY:START:SRV:AC:SS:TF:RV:AV:CR:EF>> would output a summary of costs for the services in the booking for each of the service codes AC - Accommodation; SS - Sightseeing; TF - Transfers; RV - Rental Vehicles; AV - Activities; CR - Cruises and EF - Entrance Fees. Output is down the page.
- <<SUMMARY:START:DBA1>> would output a summary of costs for services in the booking whose Product Analysis Code 1 matched DBA1.
Cost summary’s for multiple Product Analysis Codes must be set up as individual blocks - e.g., <<SUMMARY:START:DBA1:DBA2:DBA3:DBA4>> is not supported. The setup must be:
<<SUMMARY:START:DBA2>>
(Cost & Description substitution codes)
<<SUMMARY:END>>
<<SUMMARY:START:DBA3>>
(Cost & Description substitution codes)
<<SUMMARY:END>>
etc.
| Section Tags | Tag Parameters | Substitution Codes | Data Source |
|---|---|---|---|
| <<SUMMARY:START>> | :SRV (plus codes - :AC:SS etc) | Summarise by product service type | |
| :DBA1 | Summarise by product analysis code 1 | ||
| :DBA2 | Summarise by product analysis code 2 | ||
| :DBA3 | Summarise by product analysis code 3 | ||
| :DBA4 | Summarise by product analysis code 4 | ||
| :DBA5 | Summarise by product analysis code 5 | ||
| :DBA6 | Summarise by product analysis code 6 | ||
| SUMCODE | Product service code | ||
| SUMCODEDESC | Product service description | ||
| DBA1 | Product analysis 1 code | ||
| DBA2 | Product analysis 2 code | ||
| DBA3 | Product analysis 3 code | ||
| DBA4 | Product analysis 4 code | ||
| DBA5 | Product analysis 5 code | ||
| DBA6 | Product analysis 6 code | ||
| DBAD1 | Product analysis 1 description | ||
| DBAD2 | Product analysis 2 description | ||
| DBAD3 | Product analysis 3 description | ||
| DBAD4 | Product analysis 4 description | ||
| DBAD5 | Product analysis 5 description | ||
| DBAD6 | Product analysis 6 description | ||
| COST | Summary in Cost price (incl tax) | ||
| RETAIL | Summary in Retail price (incl tax) | ||
| AGENT | Summary in Agent price (incl tax) | ||
| <<SUMMARY:END>> |
Example Service Summary in Message Template
Example Service Summary Message Output
Pax Breaks Section
The <<PAXBREAKS>> section is designed to be used in PCM messages to output the Service Summary detail by PCM Pax Break.
Service Summaries can be output without the <<PAXBREAKS>> section and will be output by Service (or Analysis Code) with Summary detail for each Pax Range. There will be one row for each Service or Analysis Code. See Service Summary Without Pax Breaks Section
When the Service Summary is output with the <<PAXBREAKS>> section, the summary will be by Pax Range, then Service or Analysis Code and there will be one row for each Service or Analysis Code and each Pax Range grouped within that row. See Service Summary With Pax Breaks Section
Service Summary Without Pax Breaks Section
Example Service Summary in PCM Message Template Tail - Without PAXBREAKS Section
In this template, the <<SUMMARY:START>> has been placed after the <<SERVICES:END>>, meaning it is in the Tail of the message template. The Summary is based on Service Codes (:SRV) for codes :AC (Accommodation), :SS (Sightseeing), :SD (Single Date Service), :TR (Transport), :CR (Cruise), and :EF (Entrance Fees).
There are 6 Pax Ranges in the PCM - 10 + 1 Escort +1 Driver, 15+1+1, 20+1+1, 25+1+1, 30+1+1 and 30+2+1.
Example Service Summary in PCM Message Output - Without PAXBREAKS Section
Service Summary With Pax Breaks Section
Example Service Summary in PCM Message Template Tail - With PAXBREAKS Section
The <<PAXBREAKS:START>> and <<PAXBREAKS:END>> do not have to be inside the SUMMARY tags, so have been wrapped around the <<SUMMARY:START>> and <<SUMMARY:END>> tags. Apart from adding the PAXBREAK tags, this is the same as the template tail used in the Without Paxbreaks example.
Example Service Summary in PCM Message Output - With PAXBREAKS Section
