Bl/Shipping Instructions XML Schema Definition:
WWA Bl instructions version 1.1.0.xsd
WWA BL instructions version 1.1.1.xsd
<?xml version="1.0" encoding="UTF-8"?>
<OBLInstruction xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.wwalliance.com/wiki/images/8/8a/WWA_Bl_instructions_version_1.1.1.xsd">
<OBLInstructionEnvelope>
<SenderID>edi_test_prod</SenderID>
<ReceiverID>wwalliance</ReceiverID>
<Password>test</Password>
<Type>BL_Instructions_XML_Customer</Type>
<Version>1.1.1</Version>
<EnvelopeID>691</EnvelopeID>
</OBLInstructionEnvelope>
<OBLInstructionDetails>
<ApplicationType>WE</ApplicationType>
<BookingNumber>2546786</BookingNumber>
<CustomerControlCode>USNYC01</CustomerControlCode>
<CommunicationReference>NYCS14814879</CommunicationReference>
<CustomerReference>6310999920401200</CustomerReference>
<ShipperReference></ShipperReference>
<ForwarderReference></ForwarderReference>
<ConsigneeReference></ConsigneeReference>
<CustomerContact>Eric Dsouza</CustomerContact>
<CustomerPhone>2014135673</CustomerPhone>
<CustomerEmail>edsouza@shipco.com</CustomerEmail>
<BLRemarks>Test BL uploaded on WWA Wiki</BLRemarks>
<BLRemarks>uploaded on</BLRemarks>
<BLRemarks>WWA Wiki</BLRemarks>
<Instruction>
<TransportType>1</TransportType>
<OBLType>2</OBLType>
<OBLNumber></OBLNumber>
<AESNumber></AESNumber>
<FPI>P</FPI>
<DocumentationDetails>
<DocumentationDetailsType>1</DocumentationDetailsType>
<NumberOfDocuments>1</NumberOfDocuments>
<DocumentsRated>Y</DocumentsRated>
</DocumentationDetails>
<DisbursementCurrency></DisbursementCurrency>
<DisbursementAmount></DisbursementAmount>
<PlaceofIssueCode>USNYC</PlaceofIssueCode>
<PlaceofIssueName>NEW YORK, NY</PlaceofIssueName>
<BookingOffice>USNYC</BookingOffice>
<DateofIssue>2015-10-01</DateofIssue>
</Instruction>
<Address>
<AddressID>FW</AddressID>
<AddressLine1>KUEHNE + NAGEL, INC. FMC1162F</AddressLine1>
<AddressLine2>10 EXCHANGE PLACE CHB4455</AddressLine2>
<AddressLine3>19TH FLOOR</AddressLine3>
<AddressLine4>JERSEY CITY, NJ 07302 USA</AddressLine4>
<AddressLine5>AS AGENT OF BLUE ANCHOR LINE</AddressLine5>
<AddressLine6>AS AGENT OF BLUE ANCHOR LINE</AddressLine6>
<Phone>234567</Phone>
<Fax></Fax>
<Email></Email>
</Address>
<Address>
<AddressID>SH</AddressID>
<AddressLine1>KUEHNE + NAGEL, INC. FMC1162F</AddressLine1>
<AddressLine2>10 EXCHANGE PLACE CHB4455</AddressLine2>
<AddressLine3>19TH FLOOR</AddressLine3>
<AddressLine4>JERSEY CITY, NJ 07302 USA</AddressLine4>
<AddressLine5>AS AGENT OF BLUE ANCHOR LINE</AddressLine5>
<AddressLine6>AS AGENT OF BLUE ANCHOR LINE</AddressLine6>
<Phone>234567</Phone>
<Fax></Fax>
<Email></Email>
</Address>
<Address>
<AddressID>CN</AddressID>
<AddressLine1>KUEHNE + NAGEL (AG & CO) KG</AddressLine1>
<AddressLine2>GROSSER GRASBROOK 11-13</AddressLine2>
<AddressLine3>D 20457 HAMBURG</AddressLine3>
<AddressLine4>GERMANY, EORI 2020939</AddressLine4>
<AddressLine5>AS AGENT OF BLUE ANCHOR LINE</AddressLine5>
<AddressLine6>AS AGENT OF BLUE ANCHOR LINE</AddressLine6>
<Phone>234567</Phone>
<Fax></Fax>
<Email></Email>
</Address>
<Address>
<AddressID>N1</AddressID>
<AddressLine1>KUEHNE + NAGEL (AG & CO) KG</AddressLine1>
<AddressLine2>GROSSER GRASBROOK 11-13</AddressLine2>
<AddressLine3>D 20457 HAMBURG</AddressLine3>
<AddressLine4>GERMANY, EORI 2020939</AddressLine4>
<AddressLine5>AS AGENT OF BLUE ANCHOR LINE</AddressLine5>
<AddressLine6>AS AGENT OF BLUE ANCHOR LINE</AddressLine6>
<Phone>234567</Phone>
<Fax></Fax>
<Email></Email>
</Address>
<Routing>
<VesselVoyageID>TEST123</VesselVoyageID>
<VesselName>COMMANDER</VesselName>
<ETD>2015-10-02</ETD>
<ETA>2015-10-25</ETA>
<Voyage>123</Voyage>
<OriginOfGoods></OriginOfGoods>
<PrecarriageBy></PrecarriageBy>
<PlaceofReceiptCode>USNYC</PlaceofReceiptCode>
<PlaceofReceiptName>New York, NY</PlaceofReceiptName>
<CFSOriginCode>USNYC</CFSOriginCode>
<CFSOriginName>New York, NY</CFSOriginName>
<PortofLoadingCode>USNYC</PortofLoadingCode>
<PortofLoadingName>New York, NY</PortofLoadingName>
<PortofTransshipmentCode></PortofTransshipmentCode>
<PortofTransshipmentName></PortofTransshipmentName>
<PortofDischargeCode>DEHAM</PortofDischargeCode>
<PortofDischargeName>Hamburg, Germany</PortofDischargeName>
<CFSDestinationCode>DEHAM</CFSDestinationCode>
<CFSDestinationName>Hamburg, Germany</CFSDestinationName>
<PlaceofDeliveryCode>DEHAM</PlaceofDeliveryCode>
<PlaceofDeliveryName>Street No.10, Hamburg city</PlaceofDeliveryName>
</Routing>
<CarrierSeal></CarrierSeal>
<CustomsSeal></CustomsSeal>
<QuarantineAgencySeal></QuarantineAgencySeal>
<ShipperSeal></ShipperSeal>
<TerminalOperatorSeal></TerminalOperatorSeal>
<CargoDescription>
<CargoID>0001</CargoID>
<Level>1</Level>
<PackageCount>000004</PackageCount>
<PackageType>PLT</PackageType>
<HSCode>510510</HSCode>
<HSCode>510610</HSCode>
<UOM>M</UOM>
<Weight>00106000</Weight>
<Volume>00007245</Volume>
<Commodity>Wool, carded</Commodity>
<Commodity>55 CARTON(S)</Commodity>
<Commodity>HS-CODE:510510</Commodity>
<Commodity>Carded wool yarn</Commodity>
<Commodity>55 CARTON(S)</Commodity>
<Commodity>HS-CODE:510610</Commodity>
<Marks>TEST BL</Marks>
<Marks>TEST</Marks>
<Marks>BL on WWA wiki</Marks>
<Fumigation>N</Fumigation>
<HazardousFlag>N</HazardousFlag>
</CargoDescription>
<CargoDescription>
<CargoID>0001</CargoID>
<Level>1</Level>
<PackageCount>000004</PackageCount>
<PackageType>PLT</PackageType>
<HSCode>640411</HSCode>
<HSCode>640620</HSCode>
<UOM>M</UOM>
<Weight>00106000</Weight>
<Volume>00007245</Volume>
<Commodity>sports footwear, incl. tennis shoes, basketball shoes, gym shoes</Commodity>
<Commodity>55 CARTON(S)</Commodity>
<Commodity>HS-CODE:640411</Commodity>
<Commodity>Outer soles and heels, of rubber or plastics</Commodity>
<Commodity>55 CARTON(S)</Commodity>
<Commodity>HS-CODE:640620</Commodity>
<Marks>TEST</Marks>
<Marks>TEST BL</Marks>
<Marks>BL on WWA wiki</Marks>
<Fumigation>N</Fumigation>
<HazardousFlag>N</HazardousFlag>
</CargoDescription>
<CargoDescription>
<CargoID>0001</CargoID>
<Level>1</Level>
<PackageCount>000004</PackageCount>
<PackageType>PLT</PackageType>
<HSCode>720230</HSCode>
<HSCode>722300</HSCode>
<UOM>M</UOM>
<Weight>00106000</Weight>
<Volume>00007245</Volume>
<Commodity>Ferro-silico-manganese</Commodity>
<Commodity>55 CARTON(S)</Commodity>
<Commodity>HS-CODE:720230</Commodity>
<Commodity>Wire of stainless steel, in coils</Commodity>
<Commodity>55 CARTON(S)</Commodity>
<Commodity>HS-CODE:722300</Commodity>
<Marks>12345671234567123</Marks>
<Marks>TEST</Marks>
<Marks>BL on WWA wiki</Marks>
<Fumigation>N</Fumigation>
<HazardousFlag>N</HazardousFlag>
</CargoDescription>
</OBLInstructionDetails>
</OBLInstruction>
| Field | Content | Length | Input |
|---|---|---|---|
| Envelope | |||
| SenderID | Sender ID to identify sender. | 50 | Required |
| ReceiverID | Receiver ID to identify receiver. Should be wwalliance by default | 100 | Required |
| Password | Password as assigned by WWA. | 100 | Required |
| Type | Message type, ‘WWA_BL_Instruction_XML’. | 50 | Required |
| Version | Message version | 8 | Required |
| EnvelopeID | Unique ID for message to have a follow up option. | 40 | Required |
| Message Body | |||
| OBLInstructionDetails | Details for BL Instructions | ||
| ApplicationType | This is determining the booking request source type 'WE'(WWA EDI), 'WO'(WWA Online), 'WS'(Web Service). | 2 | Optional |
| BookingNumber | WWA Booking Number sent with the Booking Confirmation | 20 | Required |
| CustomerControlCode | WWA customer control reference. | 20 | Required |
| CommunicationReference | Customer internal reference. | 15 | Optional |
| CustomerReference | Customer reference. | 20 | Optional |
| ShipperReference | The Shipper Reference. | 30 | Optional |
| ForwarderReference | The forwarder reference. | 30 | Optional |
| ConsigneeReference | The consignee reference. | 30 | Optional |
| CustomerContact | Customer Contact Name. | 50 | Optional |
| CustomerPhone | Customer Contact Phone. | 20 | Optional |
| CustomerEmail | Customer Contact eMail address. | 50 | Optional |
| BLRemarks | Remarks should be printed on BL. | 30 | Optional |
| InstructionDetails | Details for the instruction | ||
| TransportType | Identifier for the type of transport. | 1 | Optional |
| OBLType | Identifier for the bill of lading type. | 1 | Optional |
| OBLNumber | Information field for preadvised OBL numbers. | 20 | Optional |
| AESNumber | Information field for AES Number. | 15 | Optional |
| FPI | Freight Payment Indicator (Prepaid/Collect). | 1 | Required |
| DocumentationDetails | Details for the Documentation | ||
| DocumentationDetailsType | Type of Documentation '1'=Originals '2'=non-negotiables. | 1 | Required |
| NumberOfDocuments | Number of needed originals / non-negotiables. | 2 | Required |
| DocumentRated | Rated Documents Yes (Y) or No (N). | 2 | Required |
| DisbursementCurrency | Currency for Disbursements. | 3 | Optional |
| DisbursememtAmount | Amount of Disbursements. | 8 | Optional |
| PlaceofIssueCode | Place of issue per UN Location Code. | 5 | Optional |
| PlaceofIssueName | Place of issue name, if no code is provided. | 30 | Optional |
| BookingOffice | Customer Booking office location. Valid UN CODE. | 5 | Optional |
| DateofIssue | Date of issue -> should be printed on BL. Date format must be YYYY-MM-DD | 10 | Optional |
| AddressDetails | Details for the Address | ||
| AddressID | Identifier for the address type. | 2 | Required |
| "SH" = Shipper Address | |||
| "CN" = Consignee Address | |||
| "N1" = Notify Party 1 Address | |||
| "N2" = Notify Party 2 Address | |||
| "FW" = Forwarder address | |||
| AddressLine1 | Address line one. | 40 | Optional |
| AddressLine2 | Address line two. | 40 | Optional |
| AddressLine3 | Address line three. | 40 | Optional |
| AddressLine4 | Address line four. | 40 | Optional |
| AddressLine5 | Address line five. | 40 | Optional |
| AddressLine6 | Address line six. | 40 | Optional |
| GovtReferenceNumber | Government Reference Number | 50 | Optional |
| Phone | Telephone number. | 20 | Optional |
| Fax | Fax Details. | 20 | Optional |
| Email address. | 50 | Optional | |
| RoutingDetails | Details for the Routing | ||
| VesselVoyageID | Unique Identifier received with XML schedule. | 20 | Optional |
| VesselName | Actual Name of the Vessel. | 50 | Optional |
| ETD | Estimated Time of Departure (YYYY-MM-DD). | 10 | Date |
| ETA | Estimated Time of Arrival (YYYY-MM-DD). | 10 | Optional |
| Voyage | Voyage number received with XML schedule. | 10 | Optional |
| OriginOfGoods | UN Location Code or specific location for Point and Country of Origin of Goods. (eg: USNYC or East Hanover, NJ). | 30 | Optional |
| PrecarriageBy | Precarriage effected by … (Vessel, Truck, …). | 20 | Optional |
| PlaceofReceiptCode | Place of receipt per UN Location Code. | 5 | Optional |
| PlaceofReceiptName | Place of receipt name if code is not provided. | 30 | Optional |
| CFSOriginCode | CFS Origin per UN Location Code. | 5 | Optional |
| CFSOriginName | CFS Origin name if no code is provided. | 30 | Optional |
| PortofLoadingCode | Port of Loading per UN Location Code. | 5 | Optional |
| PortofLoadingName | Port of Loading if code is not provided. | 30 | Optional |
| PortofTransshipmentCode | Port of Transshipment per UN Location Code. | 5 | Optional |
| PortofTransshipmentName | Port of Transshipment if no code is provided. | 30 | Optional |
| PortofDischargeCode | Port of Discharge per UN Location Code. | 5 | Optional |
| PortofDischargeName | Port of Discharge if no code is provided. | 30 | Optional |
| CFSDestinationCode | CFS Destination per UN Location Code. | 5 | Optional |
| CFSDestinationName | CFS Destination if no code is provided. | 30 | Optional |
| PlaceofDeliveryCode | Place of Delivery per UN Location Code. | 5 | Optional |
| PlaceofDeliveryName | Place of Delivery if no code is provided. | 30 | Optional |
| CarrierSeal | 15 | Optional | |
| CustomsSeal | 15 | Optional | |
| QuarantineAgencySeal | 15 | Optional | |
| ShipperSeal | 15 | Optional | |
| TerminalOperatorSeal | 15 | Optional | |
| CargoDescription | Details for the Cargo Description | ||
| CargoID | ID for cargo grouping. | 4 | Optional |
| Level | Package level per cargo grouping. | 4 | Optional |
| PackageCount | Piece count. | 8 | Optional |
| PackageType | Kind of package. | 20 | Optional |
| HSCode | Harmonized code. | 10 | Optional |
| UOM | Line item unit of measure, either ‘E’ (English) or ‘M’ (Metric). | 1 | Required |
| Weight | Line item weight,based on UOM,in kg or lbs. | 8 | Required |
| Volume | Line item volume,based on UOM,in cbm or cbf. | 6 | Required |
| Commodity | Commodity description. | 50 | Required |
| Marks | Shipping Marks. | 20 | Optional |
| Fumigation | Fumigation done to cargo ('Y'=Yes, 'N'=No) | 1 | Optional |
| HazardousFlag | Flag if the cargo contains hazmat ('Y'=Yes, 'N'=No). | 1 | Required |
| HazardousDetails | Details for the Hazardous | ||
| HazardousClass | International IMDG Class. | 4 | Optional |
| ShippingName | Comments about the Hazardous goods. For e.g.ENVIRONMENTALLY HAZARDOUS SUBSTANCE, LIQUID, N.O.S. | 150 | Optional |
| UNNumber | International UN Number. | 4 | Optional |
| TechnicalDescription | Technical description of IMDG cargo. | 180 | Optional |
| Characteristic | Characteristic description of IMDG cargo. | 70 | Optional |
| EMSNumber | IMDG cargo EMS number. | 7 | Optional |
| PackingGroup | IMDG cargo packing group: | 3 | Optional |
| Class I:GreatDanger | |||
| Class II:MediumDanger | |||
| Class III:MinorDanger | |||
| MarinePolutionFlag | MarinePolutionFlag Y/N. | 1 | Optional |
| PrimaryRisk | Sub risk label. | 4 | Optional |
| Flashpoint | Flashpoint temperature. | 10 | Optional |
| FlashpointFlag | Flag centigrade or fahrenheit (“C” or “F”). | 1 | Required |
| DocumentationDetails | |||
| ImageLink | HTTP URL to the pdf, HTML, png, gif or jpeg documentation file. | 999 | IF <ImageLink> is specified, <Image> is Optional |
| Image | Base64binary encode pdf, html, png, gif, jpeg. | 999 | IF <Image> is specified, <ImageLink> is Optional |
| ContentType | Type of image I.e application/pdf, application/html, image/png, image/gif, image/jpeg | 999 | Required |
| ShipperReference | The Shipper Reference. | 30 | Optional |
| ForwarderReference | The forwarder reference. | 30 | Optional |
| ConsigneeReference | The consignee reference. | 30 | Optional |
| DocumentationDetailsType | Type of Documentation '1'=Originals '2'=non-negotiables. | 1 | Required |
| NumberOfDocuments | Number of needed originals / non-negotiables. | 2 | Required |
| DocumentRated | Rated Documents Yes (Y) or No (N). | 2 | Required |
| BookingOffice | Customer Booking office location. Valid UN CODE. | 5 | Optional |
| AddressLine6 | Address line six. | 40 | Optional |
| Phone | Telephone number. | 20 | Optional |
| Fax | Fax Details. | 20 | Optional |
| Email address. | 50 | Optional | |
| GovtReferenceNumber | Government Reference Number | 50 | Optional |
| CarrierSeal | Carrier Seal | 15 | Optional |
| CustomsSeal | Customs Seal | 15 | Optional |
| QuarantineAgencySeal | Quarantine Agency Seal | 15 | Optional |
| ShipperSeal | Shipper Seal | 15 | Optional |
| TerminalOperatorSeal | Terminal Operator Seal | 15 | Optional |
| Fumigation | Fumigation done to cargo ('Y'=Yes, 'N'=No) | 1 | Optional |
| ShippingName | Comments about the Hazardous goods. For e.g.ENVIRONMENTALLY HAZARDOUS SUBSTANCE, LIQUID, N.O.S. | 150 | Optional |
<Image>+<ContentType> OR <ImageLink>+<ContentType>.
<DocumentationDetails>
<Image>
<ContentType>
<DocumentationDetails>
OR
<DocumentationDetails>
<ImageLink>
<ContentType>
<DocumentationDetails>
(Example: <ContentType>application/pdf</ContentType> )
| Option | Tag Used | Data Included in Tag Used | Text in <ContentType> |
|---|---|---|---|
| 1 | <ImageLink> | valid url to pdf | application/pdf |
| 2 | <Image> | base64binary encoded pdf | application/pdf |
| 3 | <ImageLink> | valid url to html | application/html |
| 4 | <Image> | base64binary encoded html | application/html |
| 5 | <ImageLink> | valid url to png | image/png |
| 6 | <Image> | base64binary encoded png | image/png |
| 7 | <ImageLink> | valid url to gif | image/gif |
| 8 | <Image> | base64binary encoded gif | image/gif |
| 9 | <ImageLink> | valid url to jpeg | image/jpeg |
| 10 | <Image> | base64binary encoded jpeg | image/jpeg |