Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Humanitarian & Marine Products Warning Messages

This section contains examples and scenarios of the Errors and Warnings that can be returned by our API when purchasing the Humanitarian or Marine products.

The texts are returned in Spanish or English, which is the default language. Localization of the text can be undertaken by the Seller/Aggregator based on the Short-text code.

The following scenarios show Warning messages resulting from unsuccessful Humanitarian and Marine product requests. As known, these warnings do not prevent the Order from being created.

Scenarios

Scenario 1 - More than one Remark included

More than one Remark is included within the same Instruction ListKey.

Note: Regardless of which product has been requested in the AirShoppingRQ.

OrderCreateRQ

OrderViewRS

In the OrderCreateRQ, more than one Remark:

<InstructionsList>
	<Instruction ListKey="Instruction_01">
		<FreeFormTextInstruction refs="CHILD_01 IB382320230820 IB383820230827">
			<Remark>SEMN/Vessel Name/Country</Remark>
			<Remark>OFSH/Platform Name/Country</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>

Warning returned:

<Warnings>
	<Warning ShortText="NDC_DIST_BI_0001" Code="486">Only the first remark in InstructionList information has been included.</Warning>
</Warnings>

Scenario 2 - More than one company information within the same InstructionsList

2.1. Only one company allowed

When including more than one, only the first valid information will be returned in the InstructionsList (along with the NGO/Vessel/Platform name).

OrderCreateRQ

OrderViewRS

<InstructionsList>
	<Instruction ListKey="Instruction_1">
		<FreeFormTextInstruction>
			<Remark>HUMN/NACIONES UNIDAS</Remark>
		</FreeFormTextInstruction>
	</Instruction>
	<Instruction ListKey="Instruction_2">
		<FreeFormTextInstruction>
			<Remark>HUMN/TODOS AMIGOS</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>

Humanitarian warning message example:

<Warnings>
	<Warning ShortText="SSE_ORM_HU_0002" Code="486">Only the first Humanitarian information included.</Warning>
</Warnings>

Same example but with Marine instead (as first valid option), we would obtain the following warning message:

<Warnings>
	<Warning ShortText="SSE_ORM_MA_0002" Code="486">Only the first Marine information included.</Warning>
</Warnings>

2.2. Multiple company names in the InstructionsList

Humanitarian and Marine information included, resulting in two different warning messages:

OrderCreateRQ

OrderViewRS

In the AirShoppingRQ, only the Humanitarian product is requested, and in the OrderCreateRQ we find that the first Instruction does not show the expected Humanitarian additional information.

It will, then, be ignored and only the first one of the two Instructions left are valid.

<InstructionsList>
	<Instruction ListKey="Instruction_1">
		<FreeFormTextInstruction>
			<Remark>SEMN/.NAVIERA-BLUE./AR</Remark>
		</FreeFormTextInstruction>
	</Instruction>
	<Instruction ListKey="Instruction_2">
		<FreeFormTextInstruction>
			<Remark>HUMN/NACIÓN UNI(DA).</Remark>
		</FreeFormTextInstruction>
	</Instruction>
	<Instruction ListKey="Instruction_3">
		<FreeFormTextInstruction>
			<Remark>HUMN/PRIMERA NACIÓN.</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>

Humanitarian warning message example:

<Warnings>
	<Warning ShortText="SSE_ORM_HU_0002" Code="486">Only the first Humanitarian information included.</Warning>
	<Warning ShortText="SSE_ORM_HU_0001" Code="486">Humanitarian information ignored as invalid.</Warning>
</Warnings>

Same example, but with Marine requested in the AirShoppingRQ:

<Warnings>
	<Warning ShortText="SSE_ORM_MA_0001" Code="486">Marine information ignored as invalid.</Warning>
	<Warning ShortText="SSE_ORM_MA_0002" Code="486">Only the first Marine information included.</Warning>
</Warnings>

2.3. Two companies information included in the InstructionsList

AirShoppingRQ / OrderCreateRQ

OrderViewRS

In the AirShoppingRQ:

<Preference>
	<FarePreferences>
		<Types>
			<Type PreferencesContext="HUMANITARIAN">758</Type>
		</Types>
	</FarePreferences>
	<FlightPreferences>
		<...>
</Preference>

And the InstructionsList within the OrderCreateRQ:

<InstructionsList>
	<Instruction ListKey="Instruction_1">
		<FreeFormTextInstruction>
			<Remark>HUMN/NACIONES UNIDAS</Remark>
		</FreeFormTextInstruction>
	</Instruction>
	<Instruction ListKey="Instruction_2">
		<FreeFormTextInstruction>
			<Remark>SEMN/Nombre Naviera/Pais</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>

Humanitarian warning message example:

<Warnings>
	<Warning ShortText="SSE_ORM_HU_0001" Code="486">Humanitarian information ignored as invalid.</Warning>
</Warnings>

Marine warning message returned (same example but with Marine product requested in the AirShoppingRQ):

<Warnings>
	<Warning ShortText="SSE_ORM_MA_0001" Code="486">Marine information ignored as invalid.</Warning>
</Warnings>

Scenario 3 - Company information not needed for the requested Product

3.1. The product requested in the AirShoppingRQ is NOT Humanitarian / Marine

OrderCreateRQ

OrderViewRS

The information included in the OrderCreate does not match the product previously requested in the AirShoppingRQ (e.g. “TO“ - Tour Operator):

<InstructionsList>
	<Instruction ListKey="Instruction_1">
		<FreeFormTextInstruction>
			<Remark>HUMN/NACIONES UNIDAS</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>
<Warnings>
    <Warning ShortText="SSE_ORM_BI_0001" Code="486">InstructionList information has been  ignored as not aplicable.</Warning>
</Warnings>

3.2. The product requested in the AirShoppingRQ is Humanitarian / Marine

OrderCreateRQ

OrderViewRS

In both cases, the product requested in the AirShoppingRQ does not match the information later included in the OrderCreate InstructionsList:

Humanitarian product is requested in the AirShoppingRQ:

<InstructionsList>
	<Instruction ListKey="Instruction_1">
		<FreeFormTextInstruction>
			<Remark>text1</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>

Marine product is requested in the AirShoppingRQ:

<InstructionsList>
	<Instruction ListKey="Instruction_1">
		<FreeFormTextInstruction>
			<Remark>text2</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>

Humanitarian warning message returned:

<Warnings>
	<Warning ShortText="SSE_ORM_HU_0001" Code="486">Humanitarian information ignored as invalid.</Warning>
</Warnings>

Marine warning message returned:

<Warnings>
	<Warning ShortText="SSE_ORM_MA_0001" Code="486">Marine information ignored as invalid.</Warning>
</Warnings>

Examples of messages with complete flows can be downloaded from here.

  • No labels