openapi: 3.0.3
info:
  title: 出货前通知 (ASN) 检索 API
  description: 此 API 支持用户检索发货详细信息，例如物流跟踪单号、承运商信息和商业发票等。
  version: 2.0.0
  contact:
    name: API 支持
    url: https://api-portal.ti.com/support
servers:
  - url: 'https://transact.ti.com/v2'
    description: 外部生产 API 网关

security:
  - OAuth2: []
tags:
- name: 出货前通知（测试）
- name: 出货前通知
paths:
  /store/orders/{orderNumber}/advanced-shipment-notices/test:
    get:
      description: 检索特定客户的给定 TI 销售订单号的测试 ASN 详细信息。 
      tags:
        - Advanced ship notice (test)
      security:
        - OAuth2: [] 
      parameters:
      - name: orderNumber
        in: path
        description: TI 销售订单号
        required: true
        style: simple
        explode: false      
        schema:   
          type: string
        example: 'T10999999'  
      - name: requestCommercialInvoicePDF
        in: query
        description: "如果在 requestCommercialInvoicePDF 中传入 true 值，则响应将在字段 supplierCommercialInvoicePDF 中包含商业发票 PDF 单据的 base64 编码字符串"
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          example: true
          enum:
          - true
          - false
          default: false
        example: true  
      - name: requestWaybillPDF 
        in: query
        description: "如果在 requestWaybillPDF 中传入 true 值，则响应将在字段 supplierWaybillPDF 中包含运单 PDF 单据的 base64 编码字符串"
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          example: true
          enum:
          - true
          - false
          default: false
        example: true                         
      responses:
        '200':
          description: 已成功处理请求。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASNRetrieveResponse'
        '400':         
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '405':
          $ref: '#/components/responses/MethodNotSupported'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/TemporarilyUnavailable'       
  /store/orders/{orderNumber}/advanced-shipment-notices/{wayBillNumber}/test:
    get:
      description: 检索特定客户的给定 TI 销售订单号和 wayBillNumber 的测试 ASN 详细信息。为了进行测试，传递的 waybillNumber 参数值应始终为&ldquo;0499999999&rdquo;
      tags:
        - Advanced ship notice (test)
      security:
        - OAuth2: [] 
      parameters:
      - name: orderNumber
        in: path
        description: TI 销售订单号
        required: true
        style: simple
        explode: false      
        schema:   
          type: string
        example: 'T10999999'  
      - name: wayBillNumber
        in: path
        description: TI 运单号
        required: true
        style: simple
        explode: false      
        schema:
          type: string
          default: 0499999999
        example: 0499999999
      - name: requestCommercialInvoicePDF
        in: query
        description: "如果在 requestCommercialInvoicePDF 中传入 true 值，则响应将在字段 supplierCommercialInvoicePDF 中包含商业发票 PDF 单据的 base64 编码字符串"
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          example: true
          enum:
          - true
          - false
          default: false
        example: true  
      - name: requestWaybillPDF 
        in: query
        description: "如果在 requestWaybillPDF 中传入 true 值，则响应将在字段 supplierWaybillPDF 中包含运单 PDF 单据的 base64 编码字符串"
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          example: true
          enum:
          - true
          - false
          default: false
        example: true                         
      responses:
        '200':
          description: 已成功处理请求。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASNRetrieveResponse'
        '400':         
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '405':
          $ref: '#/components/responses/MethodNotSupported'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/TemporarilyUnavailable'  
  /store/orders/{orderNumber}/advanced-shipment-notices:
    get:
      description: 检索特定客户的给定 TI 销售订单号的所有 ASN 详细信息。
      tags:
        -  Advanced ship notice
      security:
        - OAuth2: [] 
      parameters:
      - name: orderNumber
        in: path
        description: TI 销售订单号
        required: true
        style: simple
        explode: false      
        schema:   
          type: string
        example: 'T10999999'          
      - name: requestCommercialInvoicePDF
        in: query
        description: "如果在 requestCommercialInvoicePDF 中传入 true 值，则响应将在字段 supplierCommercialInvoicePDF 中包含商业发票 PDF 单据的 base64 编码字符串"
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          example: true
          enum:
          - true
          - false
          default: false
        example: true  
      - name: requestWaybillPDF 
        in: query
        description: "如果在 requestWaybillPDF 中传入 true 值，则响应将在字段 supplierWaybillPDF 中包含运单 PDF 单据的 base64 编码字符串"
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          example: true
          enum:
          - true
          - false
          default: false
        example: true                         
      responses:
        '200':
          description: 已成功处理请求。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASNRetrieveResponse'
        '400':         
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '405':
          $ref: '#/components/responses/MethodNotSupported'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/TemporarilyUnavailable'                           
  /store/orders/{orderNumber}/advanced-shipment-notices/{wayBillNumber}:
    get:
      description: 检索特定客户的给定 TI 销售订单号和 wayBillNumber 的 ASN 详细信息。订单发货后，可以通过发送不带 waybillNumber 参数的 GET ASN API 请求（<a href="/store-asn-retrieve-api#/Advanced%20ship%20notice/get_store_orders__orderNumber__advanced_shipment_notices" target="_blank">如上所述</a>）或使用 <a href="http://www.ti.com/orderhistory/" target="_blank">myTI 订单历史记录页面</a>来查找订单的运单号。
      tags:
        -  Advanced ship notice
      security:
        - OAuth2: [] 
      parameters:
      - name: orderNumber
        in: path
        description: TI 销售订单号
        required: true
        style: simple
        explode: false      
        schema:   
          type: string
        example: 'T10999999'  
      - name: wayBillNumber
        in: path
        description: TI 运单号
        required: true
        style: simple
        explode: false      
        schema:
          type: string
        example: '0499999999'         
      - name: requestCommercialInvoicePDF
        in: query
        description: "如果在 requestCommercialInvoicePDF 中传入 true 值，则响应将在字段 supplierCommercialInvoicePDF 中包含商业发票 PDF 单据的 base64 编码字符串"
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          example: true
          enum:
          - true
          - false
          default: false
        example: true  
      - name: requestWaybillPDF 
        in: query
        description: "如果在 requestWaybillPDF 中传入 true 值，则响应将在字段 supplierWaybillPDF 中包含运单 PDF 单据的 base64 编码字符串"
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          example: true
          enum:
          - true
          - false
          default: false
        example: true                         
      responses:
        '200':
          description: 已成功处理请求。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASNRetrieveResponse'
        '400':         
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '405':
          $ref: '#/components/responses/MethodNotSupported'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/TemporarilyUnavailable'               
components:
  responses:
    Okay:
      description: 正常响应
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ASNRetrieveResponse'
    BadRequest:
      description: 错误请求
      content:
        application/json:
          schema:
              example:
                errors:
                - errorCode: ERR-TICOM-ASNR-API-0400
                  type: Validation
                  section: Path
                  message: "The path parameter orderNumber cannot be null or empty."              
                - errorCode: ERR-TICOM-ASNR-API-0400
                  type: Validation
                  section: Path
                  message: "The path parameters orderNumber, wayBillNumber cannot be null or empty."
                - errorCode: ERR-TICOM-ASNR-API-0400
                  type: Validation
                  section: Path                
                  message: orderNumber - 87644567 must begin with 'T'.
                - errorCode: ERR-TICOM-ASNR-API-0400
                  type: Validation
                  section: Path 
                  message: orderNumber - T1234567 must be 9 characters in length.
                - errorCode: ERR-TICOM-ASNR-API-0400
                  type: Validation
                  section: Path 
                  message: waybillNumber - T04987431234 must be numeric.
                - errorCode: ERR-TICOM-ASNR-API-0400
                  type: Validation
                  section: Path 
                  message: waybillNumber - 042842325 must be 9 characters in length.  
                - errorCode: ERR-TICOM-ASNR-API-40060
                  type: Validation
                  section: QueryParameter 
                  message: requestCommercialInvoicePDF - X must be true or false. 
                - errorCode: ERR-TICOM-ASNR-API-40060
                  type: Validation
                  section: QueryParameter 
                  message: requestWaybillPDF - X must be true or false.                                                                                
    Unauthorized:
      description: 未经授权
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            errors:
            - errorCode: TI-API-0401
              type: Security
              reason: Invalid Credentials                
              message: "Your Access Token has Expired. Please refresh your token.\
                  \ For more information, please see: https://api-portal.ti.com/oauth-setup/"             
    NotFound:
      description: 未找到
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:                    
            errors:
            - errorCode: TI-API-0404
              type: ResourceNotFound
              reason: Invalid path
              message: No API endpoint ('/order/T2345/advanced-shipping-notification/053434') found. See documentation of this API. 
            - errorCode: ERR-TICOM-ASNR-API-0404
              type: ResourceNotFound
              reason: Resource not found.
              message: Verify the orderNumber and wayBillNumber and resubmit the request.                            
    MethodNotSupported:
      description: 方法不受支持
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:                    
            errors:
            - errorCode: TI-API-0405
              type: ResourceNotFound
              reason: Invalid method
              message: POST is not a supported method. See documentation around this API at https://api-portal.ti.com/apis.              
    TooManyRequests:
      description: 请求太多
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:                    
            errors:
            - errorCode: TI-API-0429
              type: Security
              reason: Too many requests.
              message: Rate Limit Quota exceeded. Please reduce the rate of requests. If issue persists, please contact support (https://api-portal.ti.com/support).               
    InternalServerError:
      description: 内部服务器错误
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:                
            errors:
            - errorCode: TI-API-0500
              type: Unknown
              reason: Service unavailable
              message: System error occurred, please contact support.
            - errorCode: ERR-TICOM-ASNR-API-0500
              type: Unknown
              reason: Service unavailable
              message: "System error occurred, please contact support. Execution ID: execution-304816a1-a1e1-41e7-9214-59e872a3eeb5-2020.05.19"                           
    TemporarilyUnavailable:
      description: 暂时不可用
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            errors:
            - errorCode: TI-API-0503
              type: Security
              reason: Service unavailable                
              message: This service is temporarily unavailable. Please contact support.
            - errorCode: ERR-TICOM-ASNP-API-ERP-0503
              type: Security
              reason: Service unavailable                
              message: This service is temporarily unavailable. Please contact support.                
            - errorCode: ERR-TICOM-ASNP-API-STR-0503
              type: Security
              reason: Service unavailable
              message: This service is temporarily unavailable. Please contact support.                         
  securitySchemes:
    OAuth2:
      type: 'oauth2'
      description: >-
        此 API 将 OAuth 2 与客户端凭据结合使用。请参阅 https://api-portal.ti.com/order-api-authentication
      flows:
        clientCredentials: 
          refreshUrl: 'https://transact.ti.com/v1/oauth'
          tokenUrl : 'https://transact.ti.com/v1/oauth'
          scopes: {}
  schemas:
    ASNRetrieveResponse:
      description: 出货前通知检索响应根对象
      type: object
      properties:
        orderNumber:
          type: string  
          description: 与发货关联的销售订单号
          example: 'T01999999'
        wayBillNumber:
          type: string
          description:  供应商货运单号
          example: '0499999999'
        requestCommercialInvoicePDF:
          type: string
          description: 是否在响应中包含商业发票 PDF 内容（如果可用）
          example: false
        requestWaybillPDF:
            type: boolean
            description: 是否在响应中包含运单 PDF 内容（如果可用）
            example: false
        data:
          type: object
          properties:
            consolidatedInformation:
              type: array
              minItems: 1
              items:
                $ref: "#/components/schemas/ConsolidatedInformation"

    ConsolidatedInformation:
      type: object
      properties:
        estimatedDateOfArrival:
          type: string
          description: 预计货件到达目的地的日期（UTC，YYYY-MM-DD）
          format: date
          example: 2021-04-13
        goodsIssueDate:
          type: string
          description: 发运货物或处理发货的日期（UTC，YYYY-MM-DD）
          format: date
          example: 2021-04-09
        numberOfPallet:
          type: string
          description: 装运托盘数量
          format: int32
          example: '1'
        grossWeight:
          type: string
          description: 装运毛重（包括包装材料）
          format: decimal
          example: '2.450'
        grossWeightUnitOfMeasure:
          type: string
          description: 装运毛重计量单位
          example: KG
        numberOfPieces:
          type: string
          description: 装运包装箱或纸箱数量
          format: int32
          example: '2'
        netWeight:
          type: string
          description: 装运产品重量（毛重减去包装材料重量）
          format: decimal
          example: '0.264'
        netWeightUnitOfMeasure:
          type: string
          description: 净重计量单位
          example: KG
        serviceLevelCode:
          type: string
          description: 承运商运输服务级别代码
          example: ABC
        productDescription:
          type: string
          description: 装运产品/材料描述
          example: ABC DEF GHI
        carrierShipmentMasterTrackingNumber:
          type: string
          description: 承运商货件主跟踪单号
          example: '123456'
        carrierShipmentBoxTrackingNumber:
          type: string
          description: 承运商装运箱跟踪单号
          example: CUSTOMER XLR8
        shippingDate:
          type: string
          description: "供应商处理发货 - 实际发货日期（UTC，YYYY-MM-DD）"
          format: date
          example: 2021-04-09
        shippingPoint:
          type: string
          description: 供应商发货工厂或地点 
          example: '1808'
        shippingCondition:
          type: string
          description: 发货条件，由承运商服务和发货点决定
          example: EG
        soldToNumber:
          type: string
          description: 供应商客户售给方
          example: '0000123456'
        specialProcessingIndicator:
          type: string
          description: 特殊的承运商处理（如散装、空运等），用于未来加急配送
        modeOfTransport:
          type: string
          description: 货物的运输方式（如海运、陆运、空运、卡车运输、火车运输）
          example: '05'
        buyerCode:
          type: string
          description: 客户提供的唯一买家代码
          example: '12345'
        vendorCode:
          type: string
          description: 用于指定发货人的唯一代码
          example: ABCDEFG
        shipTrackReference:
          type: string
          description: 供应商货运追踪参考
          example: '123456789012'
        soldToPartyName:
          type: string
          description: 供应商售给方名称
          example: CUSTOMER CORPORATION
        shipmentInternalTransactionNumberList:
              type: array
              minItems: 1
              items:
                $ref: '#/components/schemas/ShipmentInternalTransactionNumber'

        forwardingAgentDetails:
          type: object
          description: 货运代理详细信息
          properties:
            companyName:
              type: string
              description: 发货人承运商名称（例如 FedEx、UPS、DB Schenker）
              example: XYZ
            standardCarrierAccessCode:
              type: string
              description: "发货人承运商代码 - 标准承运商字母代码 (SCAC)"
              example: ABCD
            carrierIdentifier:
              type: string
              description: "供应商代码 - 货运代理 ZCAR"
              example: '12345'
            carrierTrackingWebSite:
              type: string
              description: 供应商承运商跟踪网站
              example: https://www.carrierxyz.com
        wayBillNumberList:
              type: array
              minItems: 1
              items:
                $ref: '#/components/schemas/WayBill'
        commercialInvoicelist:
              type: array
              minItems: 1
              items:
                $ref: '#/components/schemas/CommercialInvoice'
        shipToDetails:
          type: object
          description: 收货方详细信息
          properties:
            plantIdentifier:
              type: string
              description: 客户收货工厂标识符（工厂或地点）
              example: '00001234'
            companyName: 
              type: string
              description: 客户收货公司名称
              example: XYZ
            contactName:
              type: string
              description: 客户收货联系人姓名 
              example: 010-234-2010
            address1:
              type: string
              description: 客户收货地址 1
              example: 123 Main St
            address2:
              type: string
              description: 客户收货地址 2
              example: ABC
            city:
              type: string
              description: 客户收货城市
              example: Fort Worth
            stateRegion:
              type: string
              description: 客户收货州/省/直辖市/自治区
              example: TX
            postalCode:
              type: string
              description: 客户收货地址邮政编码
              example: 12345-1234
            countryCode:
              type: string
              description: 客户收货国家/地区
              example: US
            companyNameAdditionalDetail:
              type: string
              description: 客户收货公司名称其他详细信息
              example: ABCD
        shipFromDetails:
          type: object
          description: 发货方详细信息
          properties:
            plantIdentifier:
              type: string
              description: 供应商发货工厂代码或地点 
              example: '00001234'
            companyName: 
              type: string
              description: 供应商发货公司名称
              example: Texas Instruments
            contactName:
              type: string
              description: 供应商发货联系人姓名
              example: 010-234-2010
            address1:
              type: string
              description: 供应商发货地址 1
              example: 13601 Independence Parkway
            address2:
              type: string
              description: 供应商发货地址 2
              example: ABC
            city:
              type: string
              description: 供应商发货城市
              example: Fort Worth
            stateRegion:
              type: string
              description: 供应商发货州/省/直辖市/自治区
              example: TX
            postalCode:
              type: string
              description: 供应商发货地址邮政编码
              example: 12345-1234
            countryCode:
              type: string
              description: 供应商发货国家/地区
              example: US
            email:
              type: string
              description: 供应商发货电子邮件地址
              example: test@test.com
            phoneNumber: 
              type: string
              description: 供应商发货电话号码
              example: 010-101-2031
        crossDockDetails:
          type: object
          description: 供应商越库详细信息
          properties:
            plantIdentifier:
              type: string
              description: 供应商越库工厂代码或机场代码
              example: '00001234'
            companyName: 
              type: string
              description: 供应商越库公司名称
              example: XYZ
            contactName:
              type: string
              description: 供应商越库联系人姓名 
              example: 010-234-2010
            address1:
              type: string
              description: 供应商越库地址 1
              example: 123 Main St
            address2:
              type: string
              description: 供应商越库地址 2
              example: ABC
            city:
              type: string
              description: 供应商越库城市
              example: Fort Worth
            stateRegion:
              type: string
              description: 供应商越库州/省/直辖市/自治区
              example: TX
            postalCode:
              type: string
              description: 供应商越库地址邮政编码
              example: 12345-1234
            countryCode:
              type: string
              description: 供应商越库国家/地区
              example: US
        importerDetails:
          type: object
          description: 进口商详细信息
          properties:
            companyName: 
              type: string
              description: 最终收货人或登记进口商 (IOR) 公司名称
              example: XYZ
            contactName:
              type: string
              description: 最终收货人或登记进口商联系人姓名
              example: 010-234-2010
            address1:
              type: string
              description: 最终收货人或登记进口商地址 1
              example: 13601 Independence Parkway
            address2:
              type: string
              description: 最终收货人或登记进口商地址 2
              example: ABC
            city:
              type: string
              description: 最终收货人或登记进口商城市
              example: Fort Worth
            stateRegion:
              type: string
              description: 最终收货人或登记进口商州/省/直辖市/自治区
              example: TX
            postalCode:
              type: string
              description: 最终收货人或登记进口商地址邮政编码
              example: 12345-1234
            countryCode:
              type: string
              description: 最终收货人或登记进口商国家/地区
              example: US
        manifestIdentifierList:
          type: object
          description: 清单关键编号列表
          properties:
            manifestidentifier: 
              type: string
              description: 由供应商系统生成并分配给提单的唯一编号
              example: '7890123456'
        bookingOrderDetails:
              type: array
              minItems: 1
              items:
                $ref: "#/components/schemas/BookingOrderDetails"
    ShipmentInternalTransactionNumber:
      type: object
      properties:
        shipmentInternalTransactionNumber:
          type: string
          description: 内部交易编号是由自动出口系统 (AES) 生成并分配给货件的编号，用于确认 EEI 已被接受并已在 AES 中存档。此编号应标注在装货单上，以便海关和边境保护局 (CBP) 官员在需要时能够检索货物。
          example: '1234'
    WayBill:
      description: 供应商运单（发货详细信息，包括承运商、发货路线、发货方式、服务级别等）
      type: object
      properties:
        wayBillNumber:
          type: string
          description:  唯一的货运单号/跟踪单号
          example: '5678901234'
        creationDate:
          type: string
          description: "运单发货创建日期 - 实际发货开始日期（UTC，YYYY-MM-DD）"
          format: date
          example: 2021-04-08
        creationTime:
          type: string
          description: "运单发货创建时间 - 实际发货开始时间（UTC，HH:MM:SS）"
          format: time
          example: '09:15:08'
        waybillPDF:
          type: string
          description: 运单 PDF 内容（base64 编码字符串）
    CommercialInvoice:
      description: 供应商商业发票
      type: object
      properties:
        commercialInvoiceNumber:
          type: string
          description: 海关用于确定关税和清关货物的商业发票。
          example: '987654321'
        invoiceDate:
          type: string
          description: 发票创建日期（UTC，YYYY-MM-DD）
          format: date
          example: 2021-04-08
        invoiceTime:
          type: string
          description: 发票创建时间（UTC，HH:MM:SS）
          format: time
          example: '22:32:40'
        incotermCode:
          type: string
          description: 规定了谁负责支付和管理发货、保险、单据、清关和其他物流活动的 Incoterm 值。
          example: DDP
        incotermDescription:
          type: string
          description: 规定了谁负责支付和管理发货、保险、单据、清关和其他物流活动的 Incoterm 值的描述。
          example: Buyers Dock
        invoiceValue:
          type: string
          description: 所购货物的发票价值
          format: decimal
          example: '100.100'
        currency:
          type: string
          description: 供应商发票金额使用的币种
          example: USD
        commercialInvoicePDF:
          type: string
          description: 商业发票 PDF 内容（base64 编码字符串）
    BookingOrderDetails:
      description: 预订订单详细信息
      type: object
      properties:
        customerPurchaseOrderNumber:
          type: string
          description: 客户采购订单号
          example: T1234567
        purchaseOrderDate:
          type: string
          description: 采购订单创建日期（UTC，YYYY-MM-DD）
          format: date
          example: 2021-02-28
        passThrus:
            type: array
            minItems: 1
            items:
              $ref: "#/components/schemas/PassThru"
        packageDetails:
            type: array
            minItems: 1
            items:
              $ref: "#/components/schemas/Package"
    
    PassThru:
      type: object
      properties:
        orderNumber:
          type: string
          description: 与发货关联的供应商销售订单号
          example: '1234567890'
        passthru1:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00001*URL=www.test.com
        passthru2:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00002*URL=www.test.com
        passthru3:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00003*URL=www.test.com
        passthru4:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00004*URL=www.test.com
        passthru5:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00005*URL=www.test.com
        passthru6:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00006*URL=www.test.com
        passthru7:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00007*URL=www.test.com
        passthru8:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00008*EML=test@test.com
        passthru9:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00009*URL=www.test.com
        passthru10:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00010*URL=www.test.com
        passthru11:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00011*URL=www.test.com
        passthru12:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00012*EML=test@test.com
        passthru13:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00013*URL=www.test.com
        passthru14:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00014*URL=www.test.com
        passthru15:
          type: string
          description: 需要在 API 响应中发送回客户的客户特定数据
          example: ZREF*00015*URL=www.test.com
    Package:
      type: object
      properties:
        packageHandlingUnitNumber:
          type: string
          description: "集装箱唯一标识符 - 该包装箱的牌照"
          example: '1234567890'
        packageContainerVolume:
          type: string
          description: 包装容器体积
          format: decimal
          example: '0.000'
        packageContainerVolumeUnitOfMeasure:
          type: string
          description: 包装容器体积计量单位
          example: 'CDM'
        packageLength:
          type: string
          description: 包装长度
          format: decimal
          example: '0.000'
        packageWidth:
          type: string
          description: 包装宽度
          format: decimal
          example: '0.000'
        packageHeight:
          type: string
          description: 包装高度
          format: decimal
          example: '0.000'
        unitOfMeasure:
          type: string
          description: 包装长度、宽度和高度计量单位
          example: MM
        trackingNumber:
          type: string
          description: 包裹跟踪单号
          example: '123456789012'
        numberOfLineItems:
          type: string
          description: 包裹行项目数
          format: Int32
          example: '0'
        alternateHandlingUnitNumber:
          type: string
          description: 包含备用处理单元编号
          example: 'ABCDEFGH'
        netWeight:
          type: string
          description: 包裹净重
          format: decimal
          example: '0.000'
        grossWeight:
          type: string
          description: 包裹毛重
          format: decimal
          example: '0.000'
        weightUnitOfMeasure:
          type: string
          description: 包裹重量计量单位
          example: KG
        itemDetails:
          type: array
          minItems: 1
          items:
            $ref: "#/components/schemas/Item"
    Item:
      type: object
      properties:
        tiPartNumber:
          type: string
          description: 供应商物料编号
          example: TPS12345
        customerPartNumber:
          type: string
          description: 客户器件型号 (CPN)
          example: ABCDEFG
        tiPartDescription:
          type: string
          description: 供应商物料描述
          example: TPS12345 description
        deliveryLineItemNumber:
          type: string
          description: 供应商交货行项目编号
          example: '000010'
        deliveryDocumentNumber:
          type: string
          description: 为订单行项目创建的交货单号
          example: '0123456789'
        orderNumber:
          type: string
          description: 供应商销售订单号
          example: 'T02281839'
        lineItemNumber:
          type: string
          description: 供应商销售订单项目编号
          example: '000010'
        customerPurchaseOrderNumber:
          type: string
          description: 客户采购订单号
          example: T1234567
        customerLineItemNumber:
          type: string
          description: 客户采购订单项目编号
          example: '2'
        purchaseOrderDate:
          type: string
          description: 客户采购订单日期（UTC，YYYY-MM-DD）
          format: date
          example: 2021-02-28
        numberOfUnitsShipped:
          type: string
          description: 发货的产品数量
          example: '000000000001'
        baseUnitOfMeasure:
          type: string
          description: 供应商物品基本计量单位
          example: EA
        grossWeight:
          type: string
          description: 包括运输包装在内的物品重量
          format: decimal
          example: '1.450'
        netWeight:
          type: string
          description: 物品重量（毛重减去包装材料重量）
          format: decimal
          example: '0.165'
        weightUnitOfMeasure:
          type: string
          description: 物品重量计量单位
          example: KG
        commercialInvoiceNumber:
          type: string
          description: 供应商商业发票编号
          example: '987654321'
        commercialInvoiceItem:
          type: string
          description: 供应商商业发票项目
          example: '000001'
        commercialInvoiceUnitprice:
          type: string
          description: 供应商商业发票单价
          format: decimal
          example: '123.000000'
        commercialInvoiceValue:
          type: string
          description: 供应商商业发票价值
          format: decimal
          example: '123.000000'
        commercialInvoiceCurrency:
          type: string
          description: 供应商商业发票币种
          example: USD
        countryOfOriginCode:
          type: string
          description: 供应商原产国/地区代码
          example: PH
        countryOfOriginDescription:
          type: string
          description: 供应商原产国/地区描述
          example: Philippines
        assemblyCountryOfOriginCode3Character:
          type: string
          description: 供应商组装原产国/地区代码（3 个字符）
          example: PHL
        assemblyCountryOfOriginCode2Character:
          type: string
          description: 供应商组装原产国/地区代码（2 个字符）
          example: PH
        assemblyCountryOfOriginDescription:
          type: string
          description: 供应商组装原产国/地区描述
          example: Philippines
        harmonizedTariffScheduleExportCode:
          type: string
          description: 供应商物品协调关税表出口代码
          example: '8901234567'
        harmonizedTariffScheduleExportDescription:
          type: string
          description: 供应商物品协调关税表出口描述
          example: Electronic Integrated Circuits, Other
        harmonizedTariffScheduleImportCode:
          type: string
          description: 供应商物品协调关税表进口代码
          example: '8901234567'
        harmonizedTariffScheduleImportDescription:
          type: string
          description: 供应商物品协调关税表出口描述
          example: Electronic Integrated Circuits, Other
        confirmDate:
          type: string
          description: 供应商物品确认日期（UTC，YYYY-MM-DD）
          example: 2021-04-09
        orderType:
          type: string
          description: 供应商订单类型
          example: ZJR
        deliveryLineItemTotalQuantity:
          type: string
          description: 供应商交货行项目总数量
          example: '24000.000'
        deliveryLineItemTotalQuantityUnitOfMeasure:
          type: string
          description: 供应商交货行项目总数量计量单位
          example: EA
        goodsIssueDate:
          type: string
          description: 供应商物品发货日期（UTC，YYYY-MM-DD）
          example: 2021-04-09
        goodsIssueTime:
          type: string
          description: 供应商物品发货时间（UTC，HH:MM:SS）
          example: '05:23:19'
        passThru1:
          type: string
          description: 客户物品通过
          example: ZOI6*00001*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru2:
          type: string
          description: 客户物品通过
          example: ZOI6*00002*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru3:
          type: string
          description: 客户物品通过
          example: ZOI6*00003*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru4:
          type: string
          description: 客户物品通过
          example: ZOI6*00004*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru5:
          type: string
          description: 客户物品通过
          example: ZOI6*00005*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru6:
          type: string
          description: 客户物品通过
          example: ZOI6*00006*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru7:
          type: string
          description: 客户物品通过
          example: ZOI6*00007*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru8:
          type: string
          description: 客户物品通过
          example: ZOI6*00008*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru9:
          type: string
          description: 客户物品通过
          example: ZOI6*00009*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru10:
          type: string
          description: 客户物品通过
          example: ZOI6*00010*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru11:
          type: string
          description: 客户物品通过
          example: ZOI6*00011*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru12:
          type: string
          description: 客户物品通过
          example: ZOI6*00012*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru13:
          type: string
          description: 客户物品通过
          example: ZOI6*00013*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru14:
          type: string
          description: 客户物品通过
          example: ZOI6*00014*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        passThru15:
          type: string
          description: 客户物品通过
          example: ZOI6*00015*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206
        shipTrackCodeList:
          type: array
          minItems: 1
          items:
            $ref: "#/components/schemas/ShipTrackCode"
    ShipTrackCode:
      type: object
      properties:
        shipTrackCode:
          type: string
          description: 供应商货运追踪代码
          example: 012345ABC
        alternateShipTrackCode:
          type: string
          description: 供应商备用货运追踪代码
          example: HIJKLM
        chipCountryOfOriginCode3Character:
          type: string
          description: 供应商芯片原产国/地区代码（3 个字符）
          example: USA
        chipCountryOfOriginCode2Character:
          type: string
          description: 供应商芯片原产国/地区代码（2 个字符）
          example: US
        chipCountryOfOriginDescription:
          type: string
          description: 供应商芯片原产国/地区描述
          example: USA
        shipTrackCodeQuantity:
          type: string
          description: 供应商物品货运追踪代码数量
          example: '3000'
        batchNumber:
          type: string
          description: 供应商批号
          example: 1234567PHI
        shipDate:
          type: string
          description: 供应商发货日期（UTC，YYYY-MM-DD）
          example: 2021-04-08
        dateCode:
          type: string
          description: 供应商日期代码
          example: '2110'
        boxCount:
          type: string
          description: 供应商包装箱计数
          example: '2'           
        alternateTrackingNumber:
          type: string
          description: 供应商备用追踪标识符
          example: ABCDEFGHIJK
    Error:
      title: 错误
      description: >-
        标准错误响应
      type: object  
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ErrorDetail'
    ErrorDetail:
      type: object
      properties:
        errorCode:
          type: string
          description: 已返回错误的唯一代码。
          example: ERR-TICOM-ASNR-API-0400
        type:
          type: string 
          description: 错误的分类。
          example: Validation           
        section:
          type: string
          description: 提供可找到请求违规字段的段（如果适用）。
          example: shipFromDetails          
        field:
          type: string 
          description: 验证失败的字段的名称（如果适用）。
          example: orderNumber             
        reason:
          type: string 
          description: 产生错误的原因。详细说明请求被拒绝的原因。
          example: Invalid orderNumber                                              
        message:
          type: string
          description: 具体错误的详细信息以及要采取的解决措施。
          example: orderNumber is not valid. Please provide a valid orderNumber