Humanitarian & Marine Products - Warning Messages

Humanitarian & Marine Products Warning Messages

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

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

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

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:

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

 

2.2. Multiple company names in the InstructionsList

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

OrderCreateRQ

OrderViewRS

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 is valid.

Humanitarian warning message example:

Same example, but with Marine requested in the AirShoppingRQ:

 

2.3. Two companies information included in the InstructionsList

AirShoppingRQ / OrderCreateRQ

OrderViewRS

AirShoppingRQ / OrderCreateRQ

OrderViewRS

In the AirShoppingRQ:

And the InstructionsList within the OrderCreateRQ:

Humanitarian warning message example:

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

Scenario 3 - Company information not needed for the requested Product

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

OrderCreateRQ

OrderViewRS

OrderCreateRQ

OrderViewRS

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

 

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

OrderCreateRQ

OrderViewRS

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:

Marine product is requested in the AirShoppingRQ:

Humanitarian warning message returned:

Marine warning message returned:

Scenario 4 - Non-permitted characters in Comapany name

To learn more about which charecters are currently allowed, please visit our Humanitarian and Marine Products page.

OrderCreateRQ

OrderViewRS

OrderCreateRQ

OrderViewRS

The company name included in the OrderCreateRQ contains one ore more characters that, as of today, are not allowed.

In the example “@” “_” “ = “ will return an error message.

Error message returned:

 

 

For further information about all kind of error messages, please go to the following link:

Error Codes