"$schema": https://json-schema.org/draft/2020-12/schema
title: Air Waybill
description: A non-negotiable transport document issued by or on behalf of an air carrier acknowledging receipt of goods for carriage and evidencing the contract of air carriage between the carrier and the shipper.
type: object
required:
  - "@context"
  - type
  - credentialSchema
  - issuer
  - credentialSubject
properties:
  "@context":
    type: string
    format: uri
    description: 'Linked Data context for semantic interoperability'
    const: "https://un.opensource.unicc.org/unece/uncefact/spec-unvtd/air-waybill-context.json"
  type:
    type: array
    description: 'Credential types'
    items:
      type: string
      enum:
        - VerifiableCredential
        - AirWaybill
    minItems: 2
    maxItems: 2
    example:
      - VerifiableCredential
      - AirWaybill
  credentialSchema:
    type: object
    description: 'Reference to the credential schema for validation'
    properties:
      id:
        type: string
        format: uri
        const: "https://un.opensource.unicc.org/unece/uncefact/spec-unvtd/air-waybill-schema.yaml"
        description: 'Public location of the schema'
      type:
        type: string
        const: "JsonSchema"
        description: 'Schema type identifier'
    required:
      - id
      - type
  id:
    type: string
    format: uri
    description: 'Unique identifier for the credential'
    example: "urn:uuid:aw-2025-081-12345678"
  validFrom:
    example: 2025-03-15T00:00:00Z
    type: string
    format: date-time
    description: 'Credential validity start date'
  validTo:
    example: 2026-03-15T00:00:00Z
    type: string
    format: date-time
    description: 'Credential validity end date'
  issuer:
    description: 'Identifier of the air carrier issuing the air waybill (e.g., DID)'
    type: string
    format: uri
    example: did:web:qantasfreight.example.com
  credentialSubject:
    name: AirWaybill
    description: 'Air waybill details'
    type: object
    required:
      - airWaybillNumber
      - houseWaybillDocumentIdentifier
      - estimatedTimeOfDeparture
      - estimatedTimeOfArrival
      - carrier
      - consignor
      - consignee
      - originalLoadingLocation
      - placeOfDeparture
      - arrivalLocation
      - transportContractConditions
      - grossWeight
      - volume
      - descriptionOfGoods
      - consignmentSummaryDescription
      - numberOfPackages
      - hsCode
      - conveyanceReferenceNumber
    properties:
      airWaybillNumber:
        example: 081-12345678
        type: string
        description: Reference number of the master air waybill issued by the carrier.
      houseWaybillDocumentIdentifier:
        example: GFS-HAWB-2025-001
        type: string
        description: Reference number of the house air waybill issued by the freight forwarder.
      estimatedTimeOfDeparture:
        example: '2025-03-15T23:00:00Z'
        type: string
        format: date-time
        description: Date and time when the aircraft is scheduled to depart.
      estimatedTimeOfArrival:
        example: '2025-03-16T18:00:00Z'
        type: string
        format: date-time
        description: Date and time of the estimated arrival of the aircraft at destination.
      consignor:
        description: Party consigning goods as stipulated in the air transport contract.
        type: object
        properties:
          type:
            type: string
            default: Consignor
            enum:
            - Consignor
          id:
            example: did:web:surfproexports.example.com
            type: string
            format: uri
            description: A unique party identifier.
          name:
            example: SurfPro Exports Pty Ltd
            type: string
            description: Trade party name.
          street:
            example: 12 Harbour Drive
            type: string
            description: The street component of the address.
          city:
            example: Sydney
            type: string
            description: The city component of the address.
          state:
            example: NSW
            type: string
            description: The state component of the address.
          zip:
            example: 2000
            type: number
            description: Postal code.
          country:
            example: AU
            type: string
            description: Country.
      consignee:
        description: Party to which the air cargo is consigned.
        type: object
        properties:
          type:
            type: string
            default: Consignee
            enum:
            - Consignee
          id:
            example: did:web:waveridersupplies.example.com
            type: string
            format: uri
            description: A unique party identifier.
          name:
            example: Wave Rider Supplies, Inc
            type: string
            description: Trade party name.
          street:
            example: 210 Ocean Road
            type: string
            description: The street component of the address.
          city:
            example: Williamsburg
            type: string
            description: The city component of the address.
          state:
            example: VA
            type: string
            description: The state component of the address.
          zip:
            example: 23185
            type: number
            description: Postal code.
          country:
            example: US
            type: string
            description: Country.
      carrier:
        description: Air carrier providing the transport of goods.
        type: object
        properties:
          type:
            type: string
            default: Carrier
            enum:
            - Carrier
          id:
            example: did:web:qantasfreight.example.com
            type: string
            format: uri
            description: A unique party identifier.
          name:
            example: Qantas Freight
            type: string
            description: Trade party name.
          country:
            example: AU
            type: string
            description: Country.
      freightForwarder:
        description: Party arranging the transport of goods on behalf of the consignor.
        type: object
        properties:
          type:
            type: string
            default: FreightForwarder
            enum:
            - FreightForwarder
          id:
            example: did:web:globalfreightsolutions.example.com
            type: string
            format: uri
            description: A unique party identifier.
          name:
            example: Global Freight Solutions Pty Ltd
            type: string
            description: Trade party name.
          country:
            example: AU
            type: string
            description: Country.
      transportEquipmentOperator:
        description: Party operating the transport equipment (e.g., ULD operator at the airport).
        type: object
        properties:
          type:
            type: string
            default: TransportEquipmentOperator
            enum:
            - TransportEquipmentOperator
          id:
            example: did:web:sydneyairportground.example.com
            type: string
            format: uri
            description: A unique party identifier.
          name:
            example: Sydney Airport Ground Services
            type: string
            description: Trade party name.
          country:
            example: AU
            type: string
            description: Country.
      notifyParty:
        description: Party to be notified of the cargo's arrival.
        type: object
        properties:
          type:
            type: string
            default: NotifyParty
            enum:
            - NotifyParty
          id:
            example: did:web:waveridersupplies.example.com
            type: string
            format: uri
            description: A unique party identifier.
          name:
            example: Wave Rider Supplies, Inc
            type: string
            description: Trade party name.
          country:
            example: US
            type: string
            description: Country.
      originalLoadingLocation:
        description: Airport at which the cargo is first loaded onto an aircraft.
        type: object
        properties:
          name:
            example: Sydney Airport
            type: string
            description: Location name.
          city:
            example: Sydney
            type: string
            description: City.
          country:
            example: AU
            type: string
            description: Country.
          unlocode:
            example: https://service.unece.org/trade/locode/au.htm#AUSYD
            type: string
            format: uri
            description: UN/LOCODE identifier.
      placeOfDeparture:
        description: Airport from which the aircraft departs.
        type: object
        properties:
          name:
            example: Sydney Airport
            type: string
            description: Location name.
          iataCode:
            example: SYD
            type: string
            description: IATA airport code.
          city:
            example: Sydney
            type: string
            description: City.
          country:
            example: AU
            type: string
            description: Country.
      arrivalLocation:
        description: Airport at which the aircraft arrives at destination.
        type: object
        properties:
          name:
            example: Los Angeles International Airport
            type: string
            description: Location name.
          iataCode:
            example: LAX
            type: string
            description: IATA airport code.
          city:
            example: Los Angeles
            type: string
            description: City.
          country:
            example: US
            type: string
            description: Country.
      conveyanceReferenceNumber:
        example: QF 107
        type: string
        description: Flight number or other journey identifier for the means of transport.
      transportContractConditions:
        example: "Subject to IATA Standard Conditions of Contract"
        type: string
        description: Reference to the carrier's conditions of carriage.
      loadingInstructions:
        example: "Handle with care — fragile sporting equipment"
        type: string
        description: Instructions for the loading of the goods.
      grossWeight:
        description: Total gross weight of the consignment including packaging.
        type: object
        properties:
          amount:
            example: 520.0
            type: number
            format: float
            description: Weight amount.
          unit:
            example: KGS
            type: string
            description: Weight unit.
      volume:
        description: Total volume of the consignment.
        type: object
        properties:
          amount:
            example: 8.5
            type: number
            format: float
            description: Volume amount.
          unit:
            example: CBM
            type: string
            description: Volume unit.
      numberOfPackages:
        example: 18
        type: number
        description: Number of packages in the consignment.
      descriptionOfGoods:
        example: "Surfboards, fins and wetsuits for water sports retail"
        type: string
        description: Plain language description of the nature of the goods.
      consignmentSummaryDescription:
        example: "Sports equipment - surfing products"
        type: string
        description: Plain language description of the consignment in summary terms.
      hsCode:
        example: "950630"
        type: string
        description: Harmonized System code specifying the type of goods for customs purposes.
      freightAndChargesAmount:
        description: Total freight and ancillary charges for the air carriage.
        type: object
        properties:
          amount:
            example: 3200.00
            type: number
            format: float
            description: Monetary amount.
          currency:
            example: USD
            type: string
            minLength: 3
            maxLength: 3
            description: ISO 4217 three-letter currency code.