无法通过FedEx Ship API预约周六派送的技术求助

要在FedEx Ship API中启用周六派送服务，需注意以下关键细节并调整请求结构：

核心要求 #

• 服务兼容性：确保所选serviceType支持周六派送，比如PRIORITY_OVERNIGHT、STANDARD_OVERNIGHT等（具体以FedEx官方支持列表为准）。
• 字段命名规范：API采用驼峰命名，周六派送标识SATURDAY_DELIVERY必须放在包裹层级的packageSpecialServices对象中，你代码里注释的大写PackageSpecialServices是错误字段名。
• 日期逻辑：shipDatestamp需设置为周六派送对应的发货工作日（通常为周五），确保系统识别为预约周六派送的请求。

修正后的完整请求代码 #

{
  "labelResponseOptions": "URL_ONLY",
  "requestedShipment": {
    "shipper": {
      "contact": {
        "personName": "John Smith",
        "phoneNumber": 1234567890,
        "companyName": "Company1"
      },
      "address": {
        "streetLines": [
          "street road"
        ],
        "city": "ST PETERS",
        "stateOrProvinceCode": "MO",
        "postalCode": 63376,
        "countryCode": "US"
      }
    },
    "recipients": [
      {
        "contact": {
          "personName": "Jane Doe",
          "phoneNumber": 1234567890,
          "companyName": "Recipient Company Name"
        },
        "address": {
          "streetLines": [
            "14228 Schleisman Rd"
          ],
          "city": "Eastvale",
          "stateOrProvinceCode": "CA",
          "postalCode": 92880,
          "countryCode": "US"
        }
      }
    ],
    "shipDatestamp": "2024-05-10",
    "serviceType": "PRIORITY_OVERNIGHT",
    "packagingType": "FEDEX_BOX",
    "pickupType": "USE_SCHEDULED_PICKUP",
    "blockInsightVisibility": false,
    "shippingChargesPayment": {
      "paymentType": "SENDER"
    },
    "labelSpecification": {
      "imageType": "PDF",
      "labelStockType": "PAPER_85X11_TOP_HALF_LABEL"
    },
    "requestedPackageLineItems": [
      {
        "customerReferences": [
            {
                "customerReferenceType": "INVOICE_NUMBER",
                "value": "3686"
            },
            {
                "customerReferenceType": "P_O_NUMBER",
                "value": "3686"
            }
        ],
        "weight": {
          "value": 10,
          "units": "LB"
        },
        "packageSpecialServices": {
            "specialServiceTypes": [
                "SATURDAY_DELIVERY"
            ]
        }
      }
    ]
  },
  "accountNumber": {
    "value": "xxxxxxxxxx"
  }
}

额外验证点 #

1. 确认测试环境的FedEx账号已开通周六派送服务权限（测试账号通常默认支持，建议核实）。
2. 收件地址需在FedEx周六派送覆盖区域内，否则API会返回服务不可用的错误。

内容的提问来源于stack exchange，提问作者NTaylor