PHP调用Colissimo SOAP接口generateLabel请求报错求助

我来帮你梳理下调用Colissimo的generateLabel SOAP接口时常见的报错原因和排查步骤——既然PHP和Postman都出问题，大概率是请求格式、认证或者必填参数的问题，而不是单一工具的bug。

一、先确认基础配置是否踩坑 #

• 认证信息必须准确：Colissimo的SOAP接口依赖contractNumber（合同号）和password进行身份校验，这两个字段是请求的核心必填项，很多报错都是因为填错或者漏传。
• WSDL地址可正常访问：先在本地用curl https://ws.colissimo.fr/sls-ws/SlsServiceWS?wsdl测试能不能获取到完整的WSDL内容，如果返回异常，可能是网络防火墙/代理拦截了请求。
• SOAP版本要匹配：Colissimo接口默认支持SOAP 1.1，不管是PHP的SoapClient还是Postman的请求，都别选错成SOAP 1.2版本。

二、核对请求参数的完整性和格式 #

官方示例XML里的必填字段非常多，很容易漏填或格式错误：

• 地址类字段：countryCode必须是两位ISO代码（比如法国填FR），zipCode要符合目标国家的格式规则；
• 包裹信息：weight必须是数字（单位为千克，比如500g填0.5），不能是字符串或空值；
• 面单格式：labelFormat只能用官方支持的类型，比如PDF_A4_300DPI，不能自定义；
• 命名空间不能漏：SOAP请求的XML根节点必须带上xmlns="http://sls.ws.colissimo.fr"，Postman手动写XML时很容易忽略这一点，导致接口无法识别参数。

三、PHP代码的常见排查点 #

如果用PHP的SoapClient调用，这些细节要注意：

1. 开启调试模式捕获详细错误

try {
    $client = new SoapClient('https://ws.colissimo.fr/sls-ws/SlsServiceWS?wsdl', [
        'trace' => true,
        'exceptions' => true,
        'soap_version' => SOAP_1_1,
        'encoding' => 'UTF-8'
    ]);
} catch (SoapFault $e) {
    echo "客户端初始化错误: " . $e->getMessage();
    // 打印完整请求/响应，方便定位问题
    echo "\n请求内容: " . $client->__getLastRequest();
    echo "\n响应内容: " . $client->__getLastResponse();
}

开启trace和exceptions能帮你拿到具体的错误信息，而不是泛泛的“调用失败”提示。

2. 参数结构必须严格匹配WSDL定义
   generateLabel的参数必须是嵌套关联数组，外层要包含generateLabelRequest节点，比如：

$params = [
    'generateLabelRequest' => [
        'contractNumber' => '你的合同号',
        'password' => '你的密码',
        'outputFormat' => [
            'xsl' => 'PDF_A4_300DPI',
            'outputPrinting' => 'PDF'
        ],
        'parcel' => [
            'weight' => 1.0,
            'nonMachinable' => false
        ],
        'sender' => [
            'address' => [
                'companyName' => '测试公司',
                'lastName' => '张',
                'firstName' => '三',
                'line1' => '123 Rue Test',
                'zipCode' => '75001',
                'city' => 'Paris',
                'countryCode' => 'FR'
            ]
        ],
        'addressee' => [
            // 收件人地址结构和发件人一致
        ]
    ]
];

很多人会把参数扁平化，或者漏了外层的generateLabelRequest，导致接口无法解析。

3. 处理SSL证书问题
   如果PHP环境没信任Colissimo的SSL证书，会出现SSL验证错误，临时调试可以关闭验证（生产环境不建议）：

$client = new SoapClient($wsdl, [
    // 其他参数
    'stream_context' => stream_context_create([
        'ssl' => [
            'verify_peer' => false,
            'verify_peer_name' => false
        ]
    ])
]);

四、Postman测试的注意事项 #

用Postman测SOAP接口别踩这些坑：

• 请求方法选POST，URL填https://ws.colissimo.fr/sls-ws/SlsServiceWS（不要带?wsdl后缀）；
• 请求头必须设置：Content-Type: text/xml; charset=utf-8，还要加SOAPAction: "http://sls.ws.colissimo.fr/generateLabel"；
• 复制官方示例XML后，要把所有占位符替换成真实信息，同时检查XML标签是否闭合，避免语法错误；
• 如果返回“无法识别的操作”，大概率是SOAPAction头没设置对，或者XML命名空间错误。

五、关键调试技巧 #

不管用PHP还是Postman，一定要拿到完整的错误响应：

• PHP里用$client->__getLastResponse()打印SOAP响应；
• Postman里查看Response标签的完整XML，Colissimo接口会返回详细的错误码和描述，比如errorCode=01对应认证失败，errorCode=10对应必填字段缺失。

根据具体的错误提示去针对性修复，比盲目试错高效得多。

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