openapi: 3.0.0
info:
  description: ''
  version: 2.0.0
  title: Electronic Bill Of Lading Service
paths:
  /bol/v1/app/:
    post:
      tags:
        - Carrier API Standards
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BOL_Request'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BOL_Response'
components:
  schemas:
    BOL_Request:
      description: Objects and/or attributes that are required are indicated by a _**red asterisk**_*. For those that are conditionally required, it will be indicated within their description, including the condition in which they are required.
      type: object
      required:
        - bol
        - version
        - commodities
        - payment
        - request
        - transit
        - origin
        - destination
        - billTo
      properties:
        bol:
          type: object
          required:
            - function
            - requestedPickupDate
            - isTest
            - requestorRole
          properties:
            requestedPickupDate:
              type: string
              example: '2022-11-20T00:00:00.000'
              description: |
                The requested pickup date of the shipment.

                Valid Formats:
                * YYYY-MM-DDTHH:mm:ss.sss (ISO 8601)
            function:
              type: string
              example: Create
              description: |
                The intent for the submitted request.

                Valid Values:
                * Create - Used for initial creation
            isTest:
              type: boolean
              example: true
              description: Indicates whether or not the submitted request is intended to be a test or not.
            requestorRole:
              type: string
              example: Third Party
              description: |
                Identifies the party making the request.

                Valid Values: See Requestor_Roles schema at the bottom of this page.
            specialInstructions:
              type: string
              example: Gate code 123 to enter complex
              description: Special delivery instructions that need to be followed for the shipment's delivery.
        version:
          type: string
          example: 1.1
          description: |
            Indicates which minor version of the Digital LTL Council Bill of Lading spec you are consuming

              Valid values: v1.0 or v1.1
        images:
          type: object
          properties:
            includeBol:
              type: boolean
              description: |
                Indicates whether or not you want an image of the populated BOL returned in the response.

                Default is false.
              example: true
            includeShippingLabels:
              type: boolean
              description: |
                Indicates whether or not you want image(s) of the shipping labels returned in the response.

                Default is false.
              example: true
            shippingLabels:
              type: object
              properties:
                format:
                  type: string
                  description: |
                    Specifies the printer format type for the labels.

                    Required when images.includeShippingLabels is true.

                    Valid Values: See the Shipping_Label_Formats schema at the bottom of this page.
                  example: Avery
                quantity:
                  type: integer
                  description: |
                    Specifies the quantity of pages desired.

                    Required when images.includeShippingLabels is true.
                  example: 5
                position:
                  type: integer
                  description: |
                    Specifies the starting position for the shipping labels.

                    Required when images.shippingLabel is Avery.

                    Valid Values:
                    * 1 - 6
                  example: 2
            email:
              type: object
              properties:
                includeBol:
                  type: boolean
                  description: |
                    Used to request the bill of lading PDF to be sent to one or more email addresses
                  example: true
                includeLabels:
                  type: boolean
                  description: |
                    Used to request the shipping labels PDF to be sent to one or more email addresses
                  example: true
                addresses:
                  type: array
                  description: |
                    Provide one or more email addresses to receive the bol and/or shipping labels PDF
                  items:
                    type: string
                  example:
                    - dispatch@shipper.com
        notifications:
          type: array
          description: include if you want notifications of shipment movements by text message or email
          items:
            type: object
            properties:
              phoneNumber:
                type: string
                description: Phone number of contact for updates about shipment movements
                example: '8881234567'
              email:
                type: string
                description: Email address of contact for updates about shipment movements
                example: dispatch@consignee.com
        referenceNumbers:
          type: object
          properties:
            pro:
              type: string
              description: Shipper's pre-assigned PRO number for the requested carrier. If not provided, one will be auto assigned by the carrier.
              example: 123456-7
            quoteId:
              type: string
              description: Quote (estimate) number provided by the carrier after submitting a rate quote request.
              example: E556724
            shipmentId:
              type: string
              description: Shipment Id (SID) number for the shipment.
              example: SID9743985
            masterBol:
              type: string
              description: Master Bill of Lading number for the shipment.
              example: MBL98472587
            bol:
              type: array
              items:
                type: string
              example:
                - BL19498432
                - BL99744565
            po:
              type: array
              items:
                type: object
                properties:
                  number:
                    type: string
                    example: '554238'
                    description: The Purchase Order number.
                  pieces:
                    type: integer
                    example: 5
                    description: Total pieces associated with the Purchase Order
                  weight:
                    type: integer
                    example: 150
                    description: Total weight associated with the Purchase Order
                  palletized:
                    type: boolean
                    example: true
                    description: Indicates whether or not the pieces associated with the purchase order are on a pallet/slip/skid or not.
                  additionalShipperInfo:
                    type: string
                    example: Freight must always stay upright
                    description: Additional information from shipper per line item
            additionalReferences:
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                    example: Customer Reference Id
                    description: |
                      Indicates the name of the reference number being provided.
                  value:
                    type: string
                    example: CRID3452-01
                    description: Additional reference number that correlates to the additional reference name.
        payment:
          type: object
          required:
            - terms
          properties:
            terms:
              type: string
              example: Prepaid
              description: |
                Freight Billing Terms for the shipment

                Valid Values: See the Payment_Terms schema at the bottom of this page.
        commodities:
          type: object
          required:
            - lineItemLayout
            - handlingUnits
            - lineItems
          properties:
            lineItemLayout:
              type: string
              example: Nested
              description: |
                Valid values: Nested or Stacked

                Nested: Indicates if the Handling Unit/Line Item relationship is known. If this value is used, each Line Item associated to a Handling Unit is conditionally required to be passed within that Handling Unit's object.


                Stacked: Indicates if the Handling Unit/Line Item relationship is not known.  If this value is used, Line Items may passed within any Handling Unit object.
            handlingUnits:
              type: array
              items:
                type: object
                required:
                  - count
                  - type
                  - weight
                properties:
                  count:
                    type: integer
                    example: 2
                    description: Number of handling units being described
                  type:
                    type: string
                    example: SKD
                    description: |
                      Type of the handling units being described

                      Valid Values: See the Handling_Unit_Types schema at the bottom of this page
                  tareWeight:
                    type: integer
                    example: 5
                    description: Weight of the skids/pallets/slips used in the shipment.
                  weight:
                    type: integer
                    description: Total weight for the specified handling units.
                    example: 1500
                  weightUnit:
                    type: string
                    example: Pounds
                    description: |
                      The unit of measurement for weight.  Defaults to Pounds (Imperial) if not passed.

                      Valid Values: Pounds or Kilograms
                  length:
                    type: integer
                    example: 48
                    description: The length of the handling units being described.
                  width:
                    type: integer
                    example: 48
                    description: The width of the handling units being described.
                  height:
                    type: integer
                    example: 48
                    description: The height of the handling units being described.
                  dimensionsUnit:
                    type: string
                    example: Inches
                    description: |
                      The unit of measurement for dimensions.  Defaults to Inches (Imperial) if not passed.

                      Valid Values: Inches or Centimeters
                  stackable:
                    type: boolean
                    example: false
                    description: |
                      Identifies whether or not the freight being described can be stacked on one another.

                      Default is false.
                  lineItems:
                    type: array
                    items:
                      type: object
                      required:
                        - weight
                        - classification
                        - description
                        - hazardous
                        - stackable
                        - pieces
                        - packagingType
                      properties:
                        description:
                          type: string
                          example: Small frameless mirrors
                          description: Description of the freight being described.
                        weight:
                          type: integer
                          example: 1500
                          description: Total weight for the specified lineItem.
                        weightUnit:
                          type: string
                          example: Pounds
                          description: |
                            The unit of measurement for weight.  Defaults to Pounds (Imperial) if not passed.

                            Valid Values: Pounds or Kilograms
                        pieces:
                          type: integer
                          example: 3
                          description: Number of individual pieces for the line item being described.
                        packagingType:
                          type: string
                          example: BOX
                          description: |
                            Packaging type for the individual pieces of the line item being described.

                            Valid Values: See the Packaging_Types schema at the bottom of this page
                        classification:
                          type: string
                          example: '55'
                          description: |
                            Classification of the line item beind described.

                            Valid Values: See the Classification_Codes schema at the bottom of this page.
                        nmfc:
                          type: string
                          description: NMFC code of the freight being described.
                          example: '86900'
                        nmfcSub:
                          type: string
                          description: The Sub value for the NMFC of the freight being described.
                          example: '3'
                        hazardous:
                          type: boolean
                          example: true
                          description: Identifies whether or not the freight being described contains hazardous materials.
                        hazardousDescription:
                          type: string
                          example: UN 1090, Acetone, 3, PG II
                          description: Conditionally required when 'hazardous' is 'true'. Provides a detailed description of the hazardous item.
                        hazardousDetails:
                          type: object
                          properties:
                            weight:
                              type: integer
                              example: 45
                              description: Total weight of hazardous material coveraged by one description.
                            class:
                              type: string
                              example: 3
                              description: Class that the hazardous material is catogorized by.
                            unnaNumber:
                              type: string
                              example: 1005
                              description: Proper Identification Number (UN or NA) corresponding to the Proper Shipping Name
                            propername:
                              type: string
                              example: Anhydrous ammonia
                              description: |
                                Proper shipping name for the hazardous material.

                                From DOT regulations 172.101
                            technicalName:
                              type: string
                              example: NH3
                              description: |
                                Technical name for the hazardous material. Not all hazardous items will have a technical name.

                                From DOT regulations 172.101
                            packingGroup:
                              type: string
                              example: '2'
                              description: Hazmat Packing Group number. Not all hazmat items have a packing group
                            contractNumber:
                              type: string
                              example: '54321'
                              description: The contract number with the hazardous materials contact
        shipmentTotals:
          type: object
          properties:
            grossWeight:
              type: integer
              example: 2000
              description: Total weight of the entire shipment, including handling units (tare weight).
            netWeight:
              type: integer
              example: 1993
              description: Total weight of the entire shipment, not including handling units (tare weight).
            weightUnit:
              type: string
              example: Pounds
              description: |
                The unit of measurement for weight.  Defaults to Pounds (Imperial) if not passed.

                Valid Values: Pounds or Kilograms
            handlingUnits:
              type: integer
              example: 2
              description: Handling unit count for the entire shipment
            linearLength:
              type: integer
              description: Linear length for the entire shipment
              example: 96
            dimensionsUnit:
              type: string
              example: Inches
              description: |
                The unit of measurement for dimensions.  Defaults to Inches (Imperial) if not passed.

                Valid Values: Inches or Centimeters
            cube:
              type: integer
              example: 128
              description: Cubic volume of the entire shipment (total length X total width X total height).
            cubeDimensionsUnit:
              type: string
              example: Feet
              description: |
                The unit of measurement for cubic dimensions.  Defaults to Feet (Imperial) if not passed.

                Valid Values: Feet or Meters
            declaredValue:
              type: integer
              example: 7
              description: Total monetary value of the shipment in USD (sometimes needed for cross-border moves).
            currency:
              type: string
              example: USD
              description: |
                Optional attribute to indicate currency of declaredValue. Defaults to USD.

                Valid values: See the Currencies schema at the bottom of this page.
        accessorials:
          type: object
          properties:
            codes:
              type: array
              description: |
                An array to hold the list of services requested for the shipment"

                Valid Values: See the Accessorial_Codes schema at the bottom of this page.
              items:
                type: string
              example:
                - IDL
                - LFTP
            hazardousDetails:
              type: object
              description: |
                Required if accessorial codes list contains HAZ and/or if any commodity line item's hazardous flag is set to true.
              properties:
                emergencyContact:
                  type: object
                  properties:
                    name:
                      type: string
                      example: Manny Delgato
                      description: Full name of who should be contacted in the case of a hazardous materials-related issue.
                    phone:
                      type: string
                      example: '7775558899'
                      description: |
                        Phone number of who should be contacted in the case of a hazardous materials-related issue.

                        Valid Formats:
                        * ########## (10 digits - Area code + phone)
            cod:
              type: object
              description: |
                Required when accessorial code COD is present in the accessorial.codes list.
              properties:
                amount:
                  type: string
                  example: '56.71'
                  description: |
                    Amount to be received for the COD.

                    Valid Formats:
                    * ##.## (2 decimal places only)
                currency:
                  type: string
                  example: USD
                  description: |
                    Optional attribute to indicate currency of COD. Defaults to USD.

                    Valid values: See the Currencies schema at the bottom of this page.
                terms:
                  type: string
                  example: Collect
                  description: |
                    Payment terms associated with the COD.

                    Valid Values:
                    * Prepaid
                    * Collect
                customerCheckAcceptable:
                  type: boolean
                  example: true
                  description: Indicates whether or not a customer check or cash is acceptable.
                remitTo:
                  type: object
                  description: |
                    Required when accessorial code COD is present in the accessorial.codes list.
                  properties:
                    name:
                      type: string
                      description: Name of the remit to company.
                      example: Dog Beds by Stella
                    address1:
                      type: string
                      description: Primary Address line of the remit to company.
                      example: 121 S. Cliffwood Ave.
                    address2:
                      type: string
                      description: Secondary Address of the remit to company.
                      example: Suite 55
                    city:
                      type: string
                      example: Los Angeles
                      description: City Name of the remit to company.
                    stateProvince:
                      type: string
                      description: |
                        Two letter state/province code of the remit to company.

                        Valid Values: See the State_Province_Codes schema at the bottom of this page.
                      example: CA
                    postalCode:
                      type: string
                      example: '90001'
                      description: |
                        The 5-digit (or 6-characters for Canada) zip code of the remit to company.

                        Valid formats:
                        * 12345 (5 digits - USA/MEX)
                        * A1A1A1 (6 characters - CAN)
                        * A1A1A (5 characters - CAN)
                    country:
                      type: string
                      example: USA
                      description: |
                        Three letter country code of the remit to company.

                        Valid Values: See the Country_Codes schema at the bottom of this page.
            sortAndSegregateDetails:
              type: object
              description: |
                Required when accessorial code SRT is present in the accessorial.codes list.
              properties:
                pieces:
                  type: integer
                  description: Number of pieces in a shipment to be sorted/segregated
                  example: 25
            fullValueCoverageDetails:
              type: object
              description: |
                Required when accessorial code FVC is present in the accessorial.codes list.
              properties:
                monetaryValue:
                  type: string
                  description: |
                    Value of the cargo.

                     Valid Formats:
                    * ##.## (2 decimal places only)
                  example: '100.00'
                currency:
                  type: string
                  example: USD
                  description: |
                    Optional attribute to indicate currency of monetaryValue. Defaults to USD.

                    Valid values: See the Currencies schema at the bottom of this page.
            markDetails:
              type: object
              description: |
                Required when accessorial code MARK is present in the accessorial.codes list.
              properties:
                pieces:
                  type: integer
                  description: Number of pieces in a shipment requiring marking or tagging
                  example: 25
            limitedAccessType:
              type: object
              description: |
                Optional attribute to indicate the limited access type when accessorial code LTDAP or LTDAD is present in the accessorial.codes list.
              properties:
                origin:
                  type: string
                  description: |
                    Optional attribute to indicate the limited access type when accessorial code LTDAP is present in the accessorial.codes list.

                    Valid Values: See the Limited_Acess_Types schema at the bottom of this page.
                  example: Church
                destination:
                  type: string
                  description: |
                    Optional attribute to indicate the limited access type when accessorial code LTDAD is present in the accessorial.codes list.

                    Valid Values: See the Limited_Acess_Types schema at the bottom of this page.
                  example: Secure
            timeCriticalDetails:
              type: object
              properties:
                type:
                  type: string
                  example: Delivery Window
                  description: |
                    Type of delivery required for the requested Time Critical Service.

                    Required when accessorials.code list include TCS.

                    Valid Values: See the Time_Critical_Types schema at the bottom of this page.
                date:
                  type: object
                  properties:
                    start:
                      type: string
                      example: '2021-05-20T00:00:00.000'
                      description: |
                        The date (with or without time) the shipment is requested to be delivered.

                        Required when timeCriticalDetails.type is populated with any valid value.

                        Valid Formats:
                        * YYYY-MM-DDTHH:mm:ss.sss (ISO 8601)
                    end:
                      type: string
                      example: '2021-05-22T00:00:00.000'
                      description: |
                        The end date (with or without time) of the requested delivery window.

                        Required when the timeCriticalDetails.type is Delivery Window.

                        Valid Formats:
                        * YYYY-MM-DDTHH:mm:ss.sss (ISO 8601)
            appointmentDetails:
              type: object
              properties:
                pickup:
                  type: object
                  properties:
                    start:
                      type: string
                      example: '2021-05-20T00:00:00.000'
                      description: |
                        Starting appointment date (with or without time) the shipment is requested to be picked up.

                        Required when accessorials.code list include APTP.

                        Valid Formats:
                        * YYYY-MM-DDTHH:mm:ss.sss (ISO 8601)
                    end:
                      type: string
                      example: '2021-05-22T00:00:00.000'
                      description: |
                        Ending appointment date (with or without time) the shipment is requested to be picked up.

                        Valid Formats:
                        * YYYY-MM-DDTHH:mm:ss.sss (ISO 8601)
                delivery:
                  type: object
                  properties:
                    start:
                      type: string
                      example: '2021-05-20T00:00:00.000'
                      description: |
                        Starting appointment date (with or without time) the shipment is requested to be delivered.

                        Required when accessorials.code list include APTD.

                        Valid Formats:
                        * YYYY-MM-DDTHH:mm:ss.sss (ISO 8601)
                    end:
                      type: string
                      example: '2021-05-22T00:00:00.000'
                      description: |
                        Ending appointment date (with or without time) the shipment is requested to be delivered.

                        Valid Formats:
                        * YYYY-MM-DDTHH:mm:ss.sss (ISO 8601)
        origin:
          type: object
          required:
            - name
            - address1
            - city
            - stateProvince
            - postalCode
            - country
            - contact
          properties:
            account:
              type: string
              description: Company's account number/id for the origin.
              example: '12345'
            locationId:
              type: string
              description: Company's location id for the origin
              example: '808'
            name:
              type: string
              description: Company name associated with the origin location.
              example: Closets Closets Closets
            address1:
              type: string
              description: Primary Address line for the origin location
              example: 12 S. Closets Place
            address2:
              type: string
              description: Secondary Address line for the origin location
              example: ste 3
            city:
              type: string
              description: City Name for the origin location
              example: Los Angeles
            stateProvince:
              type: string
              description: |
                Two letter state/province code for the origin location.

                Valid Values: See the State_Province_Codes schema at the bottom of this page.
              example: CA
            postalCode:
              type: string
              example: '90001'
              description: |
                The 5-digit (or 6-characters for Canada) zip code ofor the origin location.

                Valid formats:
                  * 12345 (5 digits - USA/MEX)
                  * A1A1A1 (6 characters - CAN)
                  * A1A1A (5 characters - CAN)
            country:
              type: string
              example: USA
              description: |
                Three letter country code for the origin location.

                Valid Values: See the Country_Codes schema at the bottom of this page.
            contact:
              type: object
              description: |
                Object containing contact details for the shipper.
              required:
                - phone
              properties:
                phone:
                  type: string
                  example: '5552226666'
                  description: |
                    Ten digit phone number, without country code and/or dashes, for the origin location's contact person.

                    Valid Formats:
                    * ########## (10 digits - Area code + phone)
                phoneExt:
                  type: string
                  example: '99'
                  description: Phone extensionfor the origin location's contact person.
                name:
                  type: string
                  example: Jay Pritchett
                  description: Name of the origin location's contact person.
                email:
                  type: string
                  example: jpritchett@closets.com
                  description: Email address of the origin location's contact person.
        destination:
          type: object
          required:
            - name
            - address1
            - city
            - stateProvince
            - postalCode
            - country
            - contact
          properties:
            account:
              type: string
              description: Company's account number/id for the destination.
              example: '12345'
            locationId:
              type: string
              description: Company's location id for the destination
              example: '808'
            name:
              type: string
              description: Company name associated with the destination location.
              example: Closets Closets Closets
            address1:
              type: string
              description: Primary Address line for the destination location
              example: 12 S. Closets Place
            address2:
              type: string
              description: Secondary Address line for the destination location
              example: ste 3
            city:
              type: string
              description: City Name for the destination location
              example: Los Angeles
            stateProvince:
              type: string
              description: |
                Two letter state/province code for the destination location.

                Valid Values: See the State_Province_Codes schema at the bottom of this page.
              example: CA
            postalCode:
              type: string
              example: '90001'
              description: |
                The 5-digit (or 6-characters for Canada) zip code ofor the destination location.

                Valid formats:
                  * 12345 (5 digits - USA/MEX)
                  * A1A1A1 (6 characters - CAN)
                  * A1A1A (5 characters - CAN)
            country:
              type: string
              example: USA
              description: |
                Three letter country code for the destination location.

                Valid Values: See the Country_Codes schema at the bottom of this page.
            contact:
              type: object
              description: |
                Object containing contact details for the destination.
              required:
                - phone
              properties:
                phone:
                  type: string
                  example: '5552226666'
                  description: |
                    Ten digit phone number, without country code and/or dashes, for the destination location's contact person.

                    Valid Formats:
                    * ########## (10 digits - Area code + phone)
                phoneExt:
                  type: string
                  example: '99'
                  description: Phone extensionfor the destination location's contact person.
                name:
                  type: string
                  example: Jay Pritchett
                  description: Name of the destination location's contact person.
                email:
                  type: string
                  example: jpritchett@closets.com
                  description: Email address of the destination location's contact person.
        billTo:
          type: object
          required:
            - name
            - address1
            - city
            - stateProvince
            - postalCode
            - country
            - contact
          properties:
            account:
              type: string
              description: Company's account number/id for the billTo.
              example: '12345'
            locationId:
              type: string
              description: Company's location id for the billTo.
              example: '808'
            name:
              type: string
              description: Company name associated with the billTo location.
              example: Closets Closets Closets
            address1:
              type: string
              description: Primary Address line for the billTo location
              example: 12 S. Closets Place
            address2:
              type: string
              description: Secondary Address line for the billTo location
              example: ste 3
            city:
              type: string
              description: City Name for the billTo location
              example: Los Angeles
            stateProvince:
              type: string
              description: |
                Two letter state/province code for the billTo location.

                Valid Values: See the State_Province_Codes schema at the bottom of this page.
              example: CA
            postalCode:
              type: string
              example: '90001'
              description: |
                The 5-digit (or 6-characters for Canada) zip code ofor the billTo location.

                Valid formats:
                  * 12345 (5 digits - USA/MEX)
                  * A1A1A1 (6 characters - CAN)
                  * A1A1A (5 characters - CAN)
            country:
              type: string
              example: USA
              description: |
                Three letter country code for the billTo location.

                Valid Values: See the Country_Codes schema at the bottom of this page.
            contact:
              type: object
              description: |
                Object containing contact details for the billTo.
              required:
                - phone
              properties:
                phone:
                  type: string
                  example: '5552226666'
                  description: |
                    Ten digit phone number, without country code and/or dashes, for the billTo location's contact person.

                    Valid Formats:
                    * ########## (10 digits - Area code + phone)
                phoneExt:
                  type: string
                  example: '99'
                  description: Phone extensionfor the billTo location's contact person.
                name:
                  type: string
                  example: Jay Pritchett
                  description: Name of the billTo location's contact person.
                email:
                  type: string
                  example: jpritchett@closets.com
                  description: Email address of the billTo location's contact person.
        customsBroker:
          type: object
          properties:
            type:
              type: string
              example: Import
              description: |
                Used to identify a customs broker that is involved in a cross-border freight move.

                Valid Values: Import or Export
                  * Import: customs broker handling the destination-side of the cross-border freight move
                  * Export: customs broker handling the origin-side of the cross-border freight move
            name:
              type: string
              description: Company name associated with the customsBroker location.
              example: Closets Closets Closets
            address1:
              type: string
              description: Primary Address line for the customsBroker location
              example: 12 S. Closets Place
            address2:
              type: string
              description: Secondary Address line for the customsBroker location
              example: ste 3
            city:
              type: string
              description: City Name for the customsBroker location
              example: Los Angeles
            stateProvince:
              type: string
              description: |
                Two letter state/province code for the customsBroker location.

                Valid Values: See the State_Province_Codes schema at the bottom of this page.
              example: CA
            postalCode:
              type: string
              example: '90001'
              description: |
                The 5-digit (or 6-characters for Canada) zip code ofor the customsBroker location.

                Valid formats:
                  * 12345 (5 digits - USA/MEX)
                  * A1A1A1 (6 characters - CAN)
                  * A1A1A (5 characters - CAN)
            country:
              type: string
              example: USA
              description: |
                Three letter country code for the customsBroker location.

                Valid Values: See the Country_Codes schema at the bottom of this page.
            contact:
              type: object
              description: |
                Object containing contact details for the customsBroker.
              required:
                - phone
              properties:
                phone:
                  type: string
                  example: '5552226666'
                  description: |
                    Ten digit phone number, without country code and/or dashes, for the customsBroker location's contact person.

                    Valid Formats:
                    * ########## (10 digits - Area code + phone)
                phoneExt:
                  type: string
                  example: '99'
                  description: Phone extensionfor the customsBroker location's contact person.
                name:
                  type: string
                  example: Jay Pritchett
                  description: Name of the customsBroker location's contact person.
                email:
                  type: string
                  example: jpritchett@closets.com
                  description: Email address of the customsBroker location's contact person.
    BOL_Response:
      type: object
      properties:
        version:
          type: string
          example: v1
          description: Indicates which version of the Digital LTL Council Bill of Lading spec was returned
        transactionDate:
          type: string
          example: '2022-11-20T00:00:00.000'
          description: The date associated with this electronic bill of lading transaction.
        referenceNumbers:
          type: object
          properties:
            pro:
              type: string
              example: PRO1234
              description: Shipper's pre-assigned PRO number for the requested carrier. If one was not provided in the request, one will be auto assigned by the carrier.
            shipmentConfirmationNumber:
              type: string
              example: SCN1234
              description: Number provided by the carrier to acknowledge they accepted the BOL.
        images:
          type: object
          properties:
            bol:
              type: string
              description: Base 64 encoded PDF of the populated Bill Of Lading
              example: JVBERi0xLjcKCjQgMCBvYmoKPDwKL0JpdHNQZXJDb21wb25lbnQgOAovQ29sb3JTcGFjZSAvRGV2a......
            shippingLabels:
              type: string
              description: Base 64 encoded PDF of the populated shipping labels
              example: JVBERi0xLjcKCjQgMCBvYmoKPDwKL0JpdHNQZXJDb21wb25lbnQgOAovQ29sb3JTcGFjZSAvRGV2a......
        messageStatus:
          type: object
          description: Object containing message status details.
          properties:
            status:
              type: string
              description: |
                Indicates the status of the request. <br><br>
                PASS - Request is successful with no exceptions.<br>
                FAIL - Request is unsuccessful due to some exception.<br>
                WARNING - Request is successful with some exception.
              example: PASS
            code:
              type: string
              description: Indicates response detail code.
              example: '10000000'
            message:
              type: string
              description: Provides information pertaining to the response code.
              example: Transaction was successful.
            resolution:
              type: string
              description: Provides guidance pertaining to the response code.
              example: ''
            information:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  type:
                    type: string
                  message:
                    type: string
              example: []
    Accessorial_Codes:
      description: |
        Valid values:
        * APTD - Appointment required at delivery
        * APTP - Appointment required at pickup
        * COD - Collect on delivery
        * EXPD - Expedited Service
        * FVC - Full value coverage
        * GTD_AM- Guaranteed service - by Morning
        * GTD_NOON- Guaranteed service - by Noon
        * GTD_PM- Guaranteed service - by End of Day
        * HAZ - Hazardous material
        * IDL - Inside delivery
        * INBD - In bond shipment
        * IPU - Inside pickup
        * LFTD - Lift gate required at delivery
        * LFTP - Lift gate required at pickup
        * LTDAD - Limited access delivery
        * LTDAP - Limited access pickup
        * MARK - Marked or tagged
        * MNC - Must notify consignee
        * OVR - Over dimension/excessive length
        * PPD - Perishables (food)
        * PSC - Protective from cold
        * PSH - Protective from heat
        * PSN - Poisonous material
        * REP - Residential pickup
        * RES - Residential delivery
        * SRT - Sort and segregate
        * SS - Single Shipment
        * TCS - Time Crititcal Service
    Classification_Codes:
      description: |
        Valid values:
        * 50
        * 55
        * 60
        * 65
        * 70
        * 77.5
        * 85
        * 92.5
        * 100
        * 110
        * 125
        * 150
        * 175
        * 200
        * 250
        * 300
        * 400
        * 500
    Country_Codes:
      description: |
        Valid values:
        * CAN - Canada
        * USA - United States
        * MEX - Mexico
    Currencies:
      description: |
        Valid values:
        * CAD
        * MXN
        * USD
    Handling_Unit_Types:
      description: |
        Valid values:
        * BAG - Bag
        * BAL - Bale
        * BBL - Barrel
        * BSK - Basket
        * BIN - Bin
        * BOX - Box
        * BXT - Bucket
        * BCH - Bunch
        * BDL - Bundle
        * CAB - Cabinet
        * CAG - Cage
        * CAN - Can
        * CBY - Carboy
        * CAR - Carrier
        * CTN - Carton
        * CAS - Case
        * CSK - Cask
        * CHS - Chest
        * COL - Coil
        * CNT - Container
        * COR - Cores
        * CRT - Crate
        * CYL - Cylinder
        * DRM - Drum
        * DBK - Dry Bulk
        * ENV - Envelope
        * FIR - Firkin
        * GLD - Gaylord
        * HPR - Hamper
        * HGH - Hogshead
        * HRB - On Hanger or Rack in Boxes
        * INT - Intermediate Bulk Container
        * JAR - Jar
        * JCN - Jerrycan
        * KEG - Keg
        * KIT - Kit
        * LIF - Lifts
        * LBK - Liquid Bulk
        * LSE - Loose
        * MXD - Mixed
        * OTH - Other
        * PKG - Package
        * PCK - Packed
        * PAL - Pail
        * PAT - Pallet
        * PCS - Piece
        * PLN - Pipe Line
        * RCK - Rack
        * REL - Reel
        * ROL - Roll
        * SKD - Skid
        * SLP - Slip Sheet
        * SPL - Spool
        * TNK - Tank
        * TBN - Tote
        * TRY - Tray
        * TRU - Truckload
        * TRK - Trunk
        * TUB - Tub
        * TBE - Tube
        * UNT - Unit
        * VPK - Van Pack
        * WRP - Wrapped
    Limited_Access_Types:
      description: |
        Valid Values:
        * Airport - Airport
        * Church - Church
        * Club - Country Club, Social Club
        * Construction - Construction Site
        * Fair - Fair, Carnival, Flea Market
        * Farm - Farm, Ranch, Vinyard, Orchard
        * Hotel - Hotel, Motel, Inn, Resteraunt
        * Mine - Mine, Mill
        * Other - Other
        * Park - Amusement Park, Camp, Marina
        * Port - Port
        * School - School, University, Library
        * Secure - Military, Prison, Power Plant, Utility
        * Storage - Self Storage Unit
        * Tradeshow -Tradeshow, Exhibition, Expo
    Payment_Terms:
      description: |
        Valid values:
        * Prepaid
        * Collect
        * Third Party
    Packaging_Types:
      description: |
        Valid values:
        * BAG - Bag
        * BAL - Bale
        * BBL - Barrel
        * BSK - Basket
        * BIN - Bin
        * BOX - Box
        * BXT - Bucket
        * BCH - Bunch
        * BDL - Bundle
        * CAB - Cabinet
        * CAG - Cage
        * CAN - Can
        * CBY - Carboy
        * CAR - Carrier
        * CTN - Carton
        * CAS - Case
        * CSK - Cask
        * CHS - Chest
        * COL - Coil
        * CNT - Container
        * COR - Cores
        * CRT - Crate
        * CYL - Cylinder
        * DRM - Drum
        * DBK - Dry Bulk
        * ENV - Envelope
        * FIR - Firkin
        * GLD - Gaylord
        * HPR - Hamper
        * HGH - Hogshead
        * HRB - On Hanger or Rack in Boxes
        * INT - Intermediate Bulk Container
        * JAR - Jar
        * JCN - Jerrycan
        * KEG - Keg
        * KIT - Kit
        * LIF - Lifts
        * LBK - Liquid Bulk
        * LSE - Loose
        * MXD - Mixed
        * OTH - Other
        * PKG - Package
        * PCK - Packed
        * PAL - Pail
        * PAT - Pallet
        * PCS - Piece
        * PLN - Pipe Line
        * RCK - Rack
        * REL - Reel
        * ROL - Roll
        * SKD - Skid
        * SLP - Slip Sheet
        * SPL - Spool
        * TNK - Tank
        * TBN - Tote
        * TRY - Tray
        * TRU - Truckload
        * TRK - Trunk
        * TUB - Tub
        * TBE - Tube
        * UNT - Unit
        * VPK - Van Pack
        * WRP - Wrapped
    Requestor_Roles:
      description: |
        Valid values:
        * Shipper
        * Consignee
        * Third Party
    Shipping_Label_Formats:
      description: |
        Valid Values:
         * Avery - 3-1/3" x 4" (6 labels per sheet)
         * Letter - Standard letter sheet
         * Zebra - 4" x 6" (1 label per sheet)
    State_Province_Codes:
      description: |
        Valid values:
        * AL - Alabama
        * AK - Alaska
        * AZ - Arizona
        * AR - Arkansas
        * CA - California
        * CO - Colorado
        * CT - Connecticut
        * DC - District of Columbia
        * DE - Delaware
        * FL - Florida
        * GA - Georgia
        * HI - Hawaii
        * ID - Idaho
        * IL - Illinois
        * IN - Indiana
        * IA - Iowa
        * KS - Kansas
        * KY - Kentucky
        * LA - Louisiana
        * ME - Maine
        * MD - Maryland
        * MA - Massachusetts
        * MI - Michigan
        * MN - Minnesota
        * MS - Mississippi
        * MO - Missouri
        * MT - Montana
        * NE - Nebraska
        * NV - Nevada
        * NH - New Hampshire
        * NJ - New Jersey
        * NM - New Mexico
        * NY - New York
        * NC - North Carolina
        * ND - North Dakota
        * OH - Ohio
        * OK - Oklahoma
        * OR - Oregon
        * PA - Pennsylvania
        * PR - Puerto Rico
        * RI - Rhode Island
        * SC - South Carolina
        * SD - South Dakota
        * TN - Tennessee
        * TX - Texas
        * UT - Utah
        * VT - Vermont
        * VA - Virginia
        * WA - Washington
        * WV - West Virginia
        * WI - Wisconsin
        * WY - Wyoming
        * AB - Alberta
        * BC - British Columbia
        * MB - Manitoba
        * NB - New Brunswick
        * NL - Newfoundland and Labrador
        * NS - Nova Scotia
        * NT - Northwest Territories
        * NU - Nunavut
        * ON - Ontario
        * PE - Prince Edward Island
        * QC - Quebec
        * SK - Saskatchewan
        * YT - Yukon
        * CMX - Mexican Federal District
        * AGU - Aguascalientes
        * BCN - Baja California
        * BCS - Baja California Sur
        * CAM - Campeche
        * COA - Coahuila
        * COL - Colima
        * CHP - Chiapas
        * CHH - Chihuahua
        * DUR - Durango
        * GUA - Guanajuato
        * GRO - Guerrero
        * HID - Hidalgo
        * JAL - Jalisco
        * MEX - Mexico
        * MIC - Michoacan
        * MOR - Morelos
        * NAY - Nayarit
        * NLE - Nuevo Leon
        * OAX - Oaxaca
        * PUE - Puebla
        * QUE - Queretaro
        * ROO - Quintana Roo
        * SLP - San Luis Potosi
        * SIN - Sinaloa
        * SON - Sonora
        * TAB - Tabasco
        * TAM - Tamaulipas
        * TLA - Tlaxcala
        * VER - Veracruz
        * YUC - Yucatan
        * ZAC - Zacatecas
    Time_Critical_Types:
      description: |
        Valid Values:
          * Deliver On Date - Freight can only be delivered on the specified start date.
          * Deliver On or After Date - Freight can only be delivered on or after the specified start date.
          * Deliver By Date - Freight can only be delivered up to, and including, the specified start date.
          * Delivery Window - Freight can only be delivered between the specified start and end dates.
