DSV Shipments API

openapi: 3.2.0
info:
  title: SCM Shipments API
  description: SCM Shipments API
  version: v2
servers:
- url: https://api.dsv.com/om/shipments/v2
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Shipments
paths:
  /Shipments/SearchCriteria:
    post:
      tags:
      - Shipments
      summary: 1. Search for Shipments by criteria
      description: Search for Shipments by criteria
      operationId: POSTapi-public-v2-Shipments-SearchCriteria
      parameters:
      - name: authorization
        in: header
        description: DSV Authorization header
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Search.SearchRequest'
            example:
              grid:
                Page: 0
                PageSize: 0
                Sorts:
                - Member: string
                  SortDirection: Ascending
                Filters:
                - {}
                Groups:
                - MemberType: string
                  DisplayContent: {}
                  AggregateFunctions:
                  - AggregateMethodName: string
                    Caption: string
                    SourceField: string
                    FunctionName: string
                    MemberType: string
                    ResultFormatString: string
                  Member: string
                  SortDirection: Ascending
                Aggregates:
                - Aggregates:
                  - AggregateMethodName: string
                    Caption: string
                    SourceField: string
                    FunctionName: string
                    MemberType: string
                    ResultFormatString: string
                  Member: string
              criteria: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.Shipment'
components:
  schemas:
    eDC.Web.Api.v2.Models.Entities.Booking:
      type: object
      properties:
        bookingNumber:
          type:
          - string
          - 'null'
          description: Booking Number
        externalBookingNumber:
          type:
          - string
          - 'null'
          description: External Booking Number
        externalBookingSender:
          type:
          - string
          - 'null'
          description: External Booking Sender
        state:
          $ref: '#/components/schemas/eDC.Domain.Enums.BookingState'
        origin:
          type:
          - string
          - 'null'
          description: Origin of the Booking
        destination:
          type:
          - string
          - 'null'
          description: Destination of the Booking
        incoterm:
          type:
          - string
          - 'null'
          description: Incoterm of the Booking
        additionalTerms:
          type:
          - string
          - 'null'
          description: Additional Terms of the Booking
        additionalTermsUNLOCO:
          type:
          - string
          - 'null'
          description: UN Location Code
        freightTerm:
          type:
          - string
          - 'null'
          description: Freight Terms
        orderNumbers:
          type:
          - string
          - 'null'
          description: Order Numbers
        unitOfWeight:
          type:
          - string
          - 'null'
          description: Unit of Measure for Weight
        weight:
          type: number
          description: Weight
          format: double
        unitOfVolume:
          type:
          - string
          - 'null'
          description: Unit of Measure for Volume
        volume:
          type: number
          description: Volume
          format: double
        noOfPieces:
          type: integer
          description: Number of Pieces
          format: int32
        orderCurrency:
          type:
          - string
          - 'null'
          description: Currency for the Order
        totalValue:
          type: number
          description: Total Value of the Order
          format: double
        packingWeight:
          type: number
          description: Packing Weight
          format: double
        packingVolume:
          type: number
          description: Packing Volume
          format: double
        transitWarehouse:
          type:
          - string
          - 'null'
          description: Transit Warehouse
        onHandDate:
          type:
          - string
          - 'null'
          description: On Hand Date
          format: date-time
        preBooked:
          type:
          - string
          - 'null'
          format: date-time
        bookedDate:
          type:
          - string
          - 'null'
          description: Date of Booking
          format: date-time
        rejectedDate:
          type:
          - string
          - 'null'
          description: Date of Booking Rejection
          format: date-time
        approvedDate:
          type:
          - string
          - 'null'
          description: Date of Booking Approval
          format: date-time
        confirmedDate:
          type:
          - string
          - 'null'
          description: Date of Booking Confirmation
          format: date-time
        cancelledDate:
          type:
          - string
          - 'null'
          description: Date of Booking Cancellation
          format: date-time
        countOfTEU:
          type: number
          description: TEU count
          format: double
        countOf20FT:
          type: integer
          description: Count of 20ft Container
          format: int32
        countOf40FT:
          type: integer
          description: Count of 40ft Container
          format: int32
        countOf45FT:
          type: integer
          description: Count of 45ft Container
          format: int32
        source:
          type:
          - string
          - 'null'
          description: Source
        systemID:
          type:
          - string
          - 'null'
          description: System ID
          format: uuid
        isApprovalRequired:
          type: boolean
          description: Boolean if Approval is required
        transitWarehouseDescription:
          type:
          - string
          - 'null'
          description: Transit Warehouse Description
        estimatedDeliveryDate:
          type:
          - string
          - 'null'
          description: Estimated Delivery Date
          format: date-time
        collectionRequiredDate:
          type:
          - string
          - 'null'
          description: Collection Required Date
          format: date-time
        collectionRequiredDateBy:
          type:
          - string
          - 'null'
          description: Collection Required Date By
          format: date-time
        deliveryRequiredDate:
          type:
          - string
          - 'null'
          description: Delivery Required Date
          format: date-time
        deliveryRequiredDateBy:
          type:
          - string
          - 'null'
          description: Delivery Required Date By
          format: date-time
        isCancelled:
          type: boolean
          description: Boolean if cancelled
        shipmentNumbers:
          type:
          - string
          - 'null'
          description: Shipment Number
        noOfContainers:
          type: integer
          description: Number of Containers
          format: int32
        ownership:
          type:
          - string
          - 'null'
          description: Ownership
        bookingDeliveryInstructions:
          type:
          - string
          - 'null'
          description: Booking Delivery Instruction
        requiredDepartureWeekNumber:
          type:
          - integer
          - 'null'
          description: Required Departure Week Number
          format: int32
        requiredArrivalWeekNumber:
          type:
          - integer
          - 'null'
          description: Required Arrival Week Number
          format: int32
        cargoReadyDateWeekNumber:
          type:
          - integer
          - 'null'
          description: Cargo Ready Date Week Number
          format: int32
        deliveryDateWeekNumber:
          type:
          - integer
          - 'null'
          description: Delivery Date Week Number
          format: int32
        estimatedDeliveryToOriginCFSWeekNumber:
          type:
          - integer
          - 'null'
          description: Estimated Delivery To Origin CFS Week Number
          format: int32
        supplierRef:
          type:
          - string
          - 'null'
          description: Supplier Reference
        requiredExFactory:
          type:
          - string
          - 'null'
          description: Required Ex Works Date
          format: date-time
        requiredInStore:
          type:
          - string
          - 'null'
          description: Required in Store Date
          format: date-time
        requestedDepartureDate:
          type:
          - string
          - 'null'
          description: Requested Departure Date
          format: date-time
        requestedArrivalDate:
          type:
          - string
          - 'null'
          description: Requested Arrival Date
          format: date-time
        transportMode:
          type:
          - string
          - 'null'
          description: Mode of Transport
        containerMode:
          type:
          - string
          - 'null'
          description: Container Mode
        goodsDescription:
          type:
          - string
          - 'null'
          description: Description of Goods
        marksAndNumbers:
          type:
          - string
          - 'null'
          description: Marks and Numbers
        bookingInstructions:
          type:
          - string
          - 'null'
          description: Booking Instructions
        loadingMeters:
          type: number
          description: Loading Meters
          format: double
        commodityCode:
          type:
          - string
          - 'null'
          description: Commodity Code
        plannerCode:
          type:
          - string
          - 'null'
          description: Planner Code
        plannerEmail:
          type:
          - string
          - 'null'
          description: Planner Email
        loadPort:
          type:
          - string
          - 'null'
          description: Port  of loading
        dischargePort:
          type:
          - string
          - 'null'
          description: Port of discharge
        sdocComplete:
          type:
          - string
          - 'null'
          format: date-time
        estimatedDeliveryToOriginCFS:
          type:
          - string
          - 'null'
          description: Estimated Delivery To Origin CFS Date
          format: date-time
        isPickupRequired:
          type: boolean
          description: Boolean for Pickup required
        shippingInstructions:
          type:
          - string
          - 'null'
          description: Shipment Instructions
        customerDivision:
          type:
          - string
          - 'null'
        carrierSpaceReservation:
          type:
          - string
          - 'null'
          format: date-time
        followUpDate:
          type:
          - string
          - 'null'
          format: date-time
        dateModified:
          type:
          - string
          - 'null'
          description: Date Modified
          format: date-time
        userModified:
          type:
          - string
          - 'null'
          description: User Modified
        dateCreated:
          type:
          - string
          - 'null'
          description: Date Created
          format: date-time
        userCreated:
          type:
          - string
          - 'null'
          description: User Created
        isSuspended:
          type: boolean
        suspendedDate:
          type:
          - string
          - 'null'
          format: date-time
        loadPlanNumber:
          type:
          - string
          - 'null'
        shipmentNumber:
          type:
          - string
          - 'null'
        temperatureControl:
          $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.TemperatureControl'
        customFields:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.GenCustomAddOnValue'
          description: Custom Fields
        additionalReferences:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.AdditionalReference'
        parties:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.Company'
          description: Parties
        packLines:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.JobPackLine'
          description: Pack Lines
        equipmentTypes:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.EquipmentType'
          description: Equipment Types
        notes:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.Note'
          description: Notes
        events:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.Event'
          description: Events
        shipments:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.Shipment'
      additionalProperties: false
    eDC.Web.Api.v2.Models.Entities.DangerousGoods:
      type: object
      properties:
        regulation:
          type:
          - string
          - 'null'
        hazardClass:
          type:
          - string
          - 'null'
        additionalHazardClass:
          type:
          - string
          - 'null'
        classificationCode:
          type:
          - string
          - 'null'
        undgNumber:
          type:
          - string
          - 'null'
        variant:
          type:
          - string
          - 'null'
        psn:
          type:
          - string
          - 'null'
        technicalName:
          type:
          - string
          - 'null'
        labels:
          type:
          - string
          - 'null'
        packingGroup:
          type:
          - string
          - 'null'
        upperPlate:
          type:
          - string
          - 'null'
        lowerPlate:
          type:
          - string
          - 'null'
        numberOfPackages:
          type:
          - string
          - 'null'
        packageType:
          type:
          - string
          - 'null'
        packagingInstruction:
          type:
          - string
          - 'null'
        transportMeansCategory:
          type:
          - string
          - 'null'
        grossWeight:
          type: number
          format: double
        netWeight:
          type: number
          format: double
        explosiveWeight:
          type: number
          format: double
        unitOfWeight:
          type:
          - string
          - 'null'
        flashPointTemperature:
          type:
          - string
          - 'null'
        flashPointTemperatureUnit:
          type:
          - string
          - 'null'
        flashPointDescription:
          type:
          - string
          - 'null'
        tremCardNumber:
          type:
          - string
          - 'null'
        emsNumber:
          type:
          - string
          - 'null'
        mfagNumber:
          type:
          - string
          - 'null'
        marinePollutant:
          type:
          - string
          - 'null'
        limitedQuantity:
          type: boolean
        tunnelCode:
          type:
          - string
          - 'null'
        remarks:
          type:
          - string
          - 'null'
        contactName:
          type:
          - string
          - 'null'
        contactEmail:
          type:
          - string
          - 'null'
      additionalProperties: false
    eDC.Web.Api.v2.Models.Search.ListSortDirection:
      enum:
      - Ascending
      - Descending
      type: string
      format: int32
    eDC.Web.Api.v2.Models.Entities.Shipment:
      type: object
      properties:
        isCancelled:
          type: boolean
        isShipping:
          type: boolean
        isForwardRegistered:
          type: boolean
        shipmentStatus:
          type:
          - string
          - 'null'
        shipmentNumber:
          type:
          - string
          - 'null'
        interimReceipt:
          type:
          - string
          - 'null'
        houseBill:
          type:
          - string
          - 'null'
        cfsReference:
          type:
          - string
          - 'null'
        shipmentType:
          type:
          - string
          - 'null'
        goodsDescription:
          type:
          - string
          - 'null'
        releaseType:
          type:
          - string
          - 'null'
        aviationSecurity:
          type:
          - string
          - 'null'
        originCode:
          type:
          - string
          - 'null'
        originCountry:
          type:
          - string
          - 'null'
        originPort:
          type:
          - string
          - 'null'
        etd:
          type:
          - string
          - 'null'
          format: date-time
        destinationCode:
          type:
          - string
          - 'null'
        destinationCountry:
          type:
          - string
          - 'null'
        destinationPort:
          type:
          - string
          - 'null'
        eta:
          type:
          - string
          - 'null'
          format: date-time
        serviceLevel:
          type:
          - string
          - 'null'
        incoterm:
          type:
          - string
          - 'null'
        additionalTerms:
          type:
          - string
          - 'null'
        transportMode:
          type:
          - string
          - 'null'
        containerMode:
          type:
          - string
          - 'null'
        shippedOnBoard:
          type:
          - string
          - 'null'
        shippedOnBoardDate:
          type:
          - string
          - 'null'
          format: date-time
        actualVolume:
          type: number
          format: double
        unitOfVolume:
          type:
          - string
          - 'null'
        actualWeight:
          type: number
          format: double
        unitOfWeight:
          type:
          - string
          - 'null'
        actualChargeable:
          type: number
          format: double
        chargeableUOM:
          type:
          - string
          - 'null'
        totalPackageCount:
          type: integer
          format: int32
        totalCountPackType:
          type:
          - string
          - 'null'
        totalPacks:
          type: integer
          format: int32
        packType:
          type:
          - string
          - 'null'
        houseBillIssueDate:
          type:
          - string
          - 'null'
          format: date-time
        shippersReference:
          type:
          - string
          - 'null'
        importBrokerReference:
          type:
          - string
          - 'null'
        screeningStatus:
          type:
          - string
          - 'null'
        loadPort:
          type:
          - string
          - 'null'
        dischargePort:
          type:
          - string
          - 'null'
        estimatedDeliveryDate:
          type:
          - string
          - 'null'
          format: date-time
        actualDeliveryDate:
          type:
          - string
          - 'null'
          format: date-time
        deliveryTransportAdvisedDate:
          type:
          - string
          - 'null'
          format: date-time
        deliveryRequiredByDate:
          type:
          - string
          - 'null'
          format: date-time
        deliveryRequiredFrom:
          type:
          - string
          - 'null'
          format: date-time
        estimatedPickupDate:
          type:
          - string
          - 'null'
          format: date-time
        pickupRequestedByDate:
          type:
          - string
          - 'null'
          format: date-time
        pickupRequestedFrom:
          type:
          - string
          - 'null'
          format: date-time
        pickupTransportAdvisedDate:
          type:
          - string
          - 'null'
          format: date-time
        actualPickupDate:
          type:
          - string
          - 'null'
          format: date-time
        receiptDate:
          type:
          - string
          - 'null'
          format: date-time
        arrivalPickupDate:
          type:
          - string
          - 'null'
          format: date-time
        arrivalDeliveryDate:
          type:
          - string
          - 'null'
          format: date-time
        departureDeliveryDate:
          type:
          - string
          - 'null'
          format: date-time
        goodsValue:
          type: number
          format: double
        goodsValueCurrency:
          type:
          - string
          - 'null'
        insuranceValue:
          type: number
          format: double
        insuranceValueCurrency:
          type:
          - string
          - 'null'
        goodsAvailableDate:
          type:
          - string
          - 'null'
          format: date-time
        goodsStorageDate:
          type:
          - string
          - 'null'
          format: date-time
        loadingMeters:
          type: number
          format: double
        natureOfCargo:
          type:
          - string
          - 'null'
        codCurrency:
          type:
          - string
          - 'null'
        codAmount:
          type: number
          format: double
        numberOfEuroPallets:
          type: integer
          format: int32
        marksAndNumbers:
          type:
          - string
          - 'null'
        secondaryShipmentID:
          type:
          - string
          - 'null'
        qaIssueParty:
          type:
          - string
          - 'null'
        qaIssueReason:
          type:
          - string
          - 'null'
        qaIssuePoint:
          type:
          - string
          - 'null'
        qaIssueType:
          type:
          - string
          - 'null'
        qaIssueDate:
          type:
          - string
          - 'null'
          format: date-time
        qaIssueNotes:
          type:
          - string
          - 'null'
        qaIssueResolvedDate:
          type:
          - string
          - 'null'
          format: date-time
        qA2IssueParty:
          type:
          - string
          - 'null'
        qA2IssueReason:
          type:
          - string
          - 'null'
        qA2IssuePoint:
          type:
          - string
          - 'null'
        qA2IssueType:
          type:
          - string
          - 'null'
        qA2IssueDate:
          type:
          - string
          - 'null'
          format: date-time
        qA2IssueNotes:
          type:
          - string
          - 'null'
        qA2IssueResolvedDate:
          type:
          - string
          - 'null'
          format: date-time
        state:
          $ref: '#/components/schemas/eDC.Domain.Enums.ShipmentState'
        stateDescription:
          type:
          - string
          - 'null'
        customsCleared:
          type:
          - string
          - 'null'
          format: date-time
        customsCommenced:
          type:
          - string
          - 'null'
          format: date-time
        customsClearanceInstructionReceived:
          type:
          - string
          - 'null'
          format: date-time
        customsPaid:
          type:
          - string
          - 'null'
          format: date-time
        handoverDate:
          type:
          - string
          - 'null'
          format: date-time
        airlineHandoverDate:
          type:
          - string
          - 'null'
          format: date-time
        destinationDocumentsHandoverDate:
          type:
          - string
          - 'null'
          format: date-time
        deliveryOrderReceived:
          type:
          - string
          - 'null'
          format: date-time
        transitWarehouse:
          type:
          - string
          - 'null'
        masterLead:
          type:
          - string
          - 'null'
        asmHouseBill:
          type:
          - string
          - 'null'
        departedOriginCFSDate:
          type:
          - string
          - 'null'
          format: date-time
        availableDestinationCFSDate:
          type:
          - string
          - 'null'
          format: date-time
        departedDestinationCFSDate:
          type:
          - string
          - 'null'
          format: date-time
        customsBrokerAdvisedDate:
          type:
          - string
          - 'null'
          format: date-time
        transportNumber:
          type:
          - string
          - 'null'
        customerReference:
          type:
          - string
          - 'null'
        odsNumber:
          type:
          - string
          - 'null'
        customsEntryStatus:
          type:
          - string
          - 'null'
        customsEntryNumbers:
          type:
          - string
          - 'null'
        exportCustomsCleared:
          type:
          - string
          - 'null'
          format: date-time
        exportDocumentationReceived:
          type:
          - string
          - 'null'
          format: date-time
        shipmentDate:
          type:
          - string
          - 'null'
          format: date-time
        carrierBookingSubmitted:
          type:
          - string
          - 'null'
          format: date-time
        carrierBookingAccepted:
          type:
          - string
          - 'null'
          format: date-time
        carrierBookingRef:
          type:
          - string
          - 'null'
        usCustomsClearedAvailable:
          type:
          - string
          - 'null'
          format: date-time
        freightTerm:
          type:
          - string
          - 'null'
        detailedDescription:
          type:
          - string
          - 'null'
        sourceModule:
          type:
          - string
          - 'null'
        numberOfOriginalBills:
          type: integer
          format: int32
        numberOfCopyBills:
          type: integer
          format: int32
        customsStatus:
          type:
          - string
          - 'null'
        fclAvailableDate:
          type:
          - string
          - 'null'
          format: date-time
        fclStorageDate:
          type:
          - string
          - 'null'
          format: date-time
        pickupDropMode:
          type:
          - string
          - 'null'
        deliveryDropMode:
          type:
          - string
          - 'null'
        branchCode:
          type:
          - string
          - 'null'
        departmentCode:
          type:
          - string
          - 'null'
        departmentID:
          type:
          - string
          - 'null'
          format: uuid
        source:
          type:
          - string
          - 'null'
        isManuallyAssigned:
          type: boolean
        isInternal:
          type: boolean
        vessel:
          type:
          - string
          - 'null'
        voyageFlight:
          type:
          - string
          - 'null'
        firstPortETD:
          type:
          - string
          - 'null'
          format: date-time
        firstPortATD:
          type:
          - string
          - 'null'
          format: date-time
        lastPortETA:
          type:
          - string
          - 'null'
          format: date-time
        lastPortATA:
          type:
          - string
          - 'null'
          format: date-time
        discharge_Leg1:
          type:
          - string
          - 'null'
        etA_Leg1:
          type:
          - string
          - 'null'
          format: date-time
        atA_Leg1:
          type:
          - string
          - 'null'
          format: date-time
        load_Leg2:
          type:
          - string
          - 'null'
        load_Leg3:
          type:
          - string
          - 'null'
        load_Leg4:
          type:
          - string
          - 'null'
        discharge_Leg2:
          type:
          - string
          - 'null'
        discharge_Leg3:
          type:
          - string
          - 'null'
        discharge_Leg4:
          type:
          - string
          - 'null'
        etD_Leg2:
          type:
          - string
          - 'null'
          format: date-time
        etD_Leg3:
          type:
          - string
          - 'null'
          format: date-time
        etD_Leg4:
          type:
          - string
          - 'null'
          format: date-time
        atD_Leg2:
          type:
          - string
          - 'null'
          format: date-time
        atD_Leg3:
          type:
          - string
          - 'null'
          format: date-time
        atD_Leg4:
          type:
          - string
          - 'null'
          format: date-time
        etA_Leg2:
          type:
          - string
          - 'null'
          format: date-time
        etA_Leg3:
          type:
          - string
          - 'null'
          format: date-time
        etA_Leg4:
          type:
          - string
          - 'null'
          format: date-time
        atA_Leg2:
          type:
          - string
          - 'null'
          format: date-time
        atA_Leg3:
          type:
          - string
          - 'null'
          format: date-time
        atA_Leg4:
          type:
          - string
          - 'null'
          format: date-time
        vessel_Leg1:
          type:
          - string
          - 'null'
        vessel_Leg2:
          type:
          - string
          - 'null'
        vessel_Leg3:
          type:
          - string
          - 'null'
        vessel_Leg4:
          type:
          - string
          - 'null'
        voyageFlight_Leg1:
          type:
          - string
          - 'null'
        voyageFlight_Leg2:
          type:
          - string
          - 'null'
        voyageFlight_Leg3:
          type:
          - string
          - 'null'
        voyageFlight_Leg4:
          type:
          - string
          - 'null'
        firstLoad:
          type:
          - string
          - 'null'
        lastDischarge:
          type:
          - string
          - 'null'
        imoNumber:
          type:
          - string
          - 'null'
        carrierCode:
          type:
          - string
          - 'null'
        carrierSCAC:
          type:
          - string
          - 'null'
        carrierContractNumber:
          type:
          - string
          - 'null'
        workflow:
          type:
          - string
          - 'null'
        workflowId:
          type:
          - string
          - 'null'
          format: uuid
        acceptedDate:
          type:
          - string
          - 'null'
          format: date-time
        declinedDate:
          type:
          - string
          - 'null'
          format: date-time
        customerDivision:
          type:
          - string
          - 'null'
        trackableTill:
          type:
          - string
          - 'null'
          format: date-time
        cancelledDate:
          type:
          - string
          - 'null'
          format: date-time
        invoicedDate:
          type:
          - string
          - 'null'
          format: date-time
        temperatureControl:
          $ref: '#/components/schemas/eDC.Web.Api.v2.Models.Entities.TemperatureControl'
        exte

# --- truncated at 32 KB (73 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dsv/refs/heads/main/openapi/dsv-shipments-api-openapi.yml