使用 Fedex API RateService 指定 Fedex One Rate 的数组结构

Question

我有一个使用标准 Fedex 费率获取我的货件费率的工作请求，但我想使用特殊的 Fedex One Rate 选项，以便获得他们的统一费率报价。

不幸的是，他们的代码示例没有显示如何指定费率请求应该使用 Fedex One Rate，而且我完全无法通过 WSDL 的 xml 呕吐物进行心理解析。我尝试了几种不同的数组结构来传递（我假设）是正确的变量，但没有任何效果。

我使用 3rd 方生成器生成了 WSDL 的两个 html 版本（两者都不是非常有用，但也许您可以比我更好地阅读它们）。

第一个包括 wsdl，其数据类型直接链接到它们的定义：http://inadaydevelopment.com/stackoverflow/fedex/RateService_v16.html

第二个更基本，它只是以更线性的方式提供层次结构，每个级别都有有效值：http://inadaydevelopment.com/stackoverflow/fedex/RateService_v16_other.html

据我所知，我可以通过两种方式/地方声明我希望我的报价使用单一费率：

1) $request['VariableOptions'] = 'FEDEX_ONE_RATE';

和

2) $request['RequestedShipment']['SpecialServicesRequested'] = array(
    'SpecialServiceTypes' => array('FEDEX_ONE_RATE')
);

当我使用 (1) 时，我会收到包含价格列表的成功响应，但它们不是 One Rate 价格。它们是标准价格。

当我使用 (2) 时，我得到一个失败响应：

stdClass Object
(
    [HighestSeverity] => WARNING
    [Notifications] => stdClass Object
        (
            [Severity] => WARNING
            [Source] => crs
            [Code] => 556
            [Message] => There are no valid services available. 
            [LocalizedMessage] => There are no valid services available. 
        )

    [TransactionDetail] => stdClass Object
        (
            [CustomerTransactionId] =>  *** Service Availability Request v5.1 using PHP ***
        )

    [Version] => stdClass Object
        (
            [ServiceId] => crs
            [Major] => 16
            [Intermediate] => 0
            [Minor] => 0
        )

)

如果我同时使用 (1) 和 (2)，则会收到 (2) 错误消息以及附加警告，指出我以两种不同的方式指定了 One Rate 并且 (2) 将覆盖 ( 1).

这是我的完整请求数组：

array (
  'WebAuthenticationDetail' => 
  array (
    'UserCredential' => 
    array (
      'Key' => 'xxx',
      'Password' => 'xxx',
    ),
  ),
  'ClientDetail' => 
  array (
    'AccountNumber' => 'xxx',
    'MeterNumber' => 'xxx',
  ),
  'TransactionDetail' => 
  array (
    'CustomerTransactionId' => ' *** Service Availability Request v5.1 using PHP ***',
  ),
  'Version' => 
  array (
    'ServiceId' => 'crs',
    'Major' => '16',
    'Intermediate' => '0',
    'Minor' => '0',
  ),
  'ReturnTransitAndCommit' => true,
  'RequestedShipment' => 
  array (
    'DropoffType' => 'STATION',
    'ShipTimestamp' => '2015-06-14T14:13:46-07:00',
    'Shipper' => 
    array (
      'Contact' => 
      array (
        'PersonName' => 'Kenny Wyland',
        'CompanyName' => 'K2 Cashflow',
        'PhoneNumber' => 'xxxxxxxxxx',
      ),
      'Address' => 
      array (
        'StreetLines' => 
        array (
          0 => 'xxxx E xxxxx St',
        ),
        'City' => 'Long Beach',
        'StateOrProvinceCode' => 'CA',
        'PostalCode' => '90805',
        'CountryCode' => 'US',
      ),
    ),
    'Recipient' => 
    array (
      'Contact' => 
      array (
        'PersonName' => 'Bob Smith',
        'PhoneNumber' => 'xxx-xxx-xxxx',
      ),
      'Address' => 
      array (
        'StreetLines' => 
        array (
          0 => 'xxxxx xxxxxxx Rd',
        ),
        'City' => 'Corona',
        'StateOrProvinceCode' => 'CA',
        'PostalCode' => '92883',
        'CountryCode' => 'US',
        'Residential' => true,
      ),
    ),
    'ShippingChargesPayment' => 
    array (
      'PaymentType' => 'SENDER',
      'Payor' => 
      array (
        'ResponsibleParty' => 
        array (
          'AccountNumber' => 'xxxx',
          'Contact' => NULL,
          'Address' => 
          array (
            'CountryCode' => 'US',
          ),
        ),
      ),
    ),
    'PackageCount' => '1',
    'RequestedPackageLineItems' => 
    array (
      0 => 
      array (
        'SequenceNumber' => 1,
        'GroupPackageCount' => 1,
        'Weight' => 
        array (
          'Value' => 0.01,
          'Units' => 'LB',
        ),
      ),
    ),
    'SpecialServicesRequested' => 
    array (
      'SpecialServiceTypes' => 
      array (
        0 => 'FEDEX_ONE_RATE',
      ),
    ),
  ),
)

Answer 1

https://www.fedex.com/templates/components/apps/wpor/secure/downloads/pdf/201408/RateServicesWSDLGuide_v2014.pdf 文件第 2.4.4 点指出，获得 One Rate 定价有几个要求：

1. 指定“FEDEX_ONE_RATE”ShipmentSpecialService。

您已有的（您使用的在 FedEx Freight Priority 和 FedEx Freight Economy，第 2.2.4.1 点中指定）。

下一个要求：

1. 指定以下包装类型之一：

FEDEX_SMALL_BOX

....

在代码中应该是：

$request['RequestedShipment']['PackagingType'] = 'FEDEX_SMALL_BOX';

接下来是第三个要求：

1. 指定美国出发地和美国目的地。

您的代码中已有的。

第四个要求：

4. 指定以下 FedEx Express 服务之一：

FIRST_OVERNIGHT

...

代码中的内容：

$request['RequestedShipment']['ServiceType'] = 'FIRST_OVERNIGHT';

另外，注意最后的注释：

*注意：Web 服务客户端可以通过指定在单个 RateRequest 中请求单一费率和基于权重的（非单一费率）费率 “FEDEX_ONE_RATE”作为 ServiceOptionType 在 RateRequest.variableOptions。