Walmart Marketplace Shipping Updates API遇SYSTEM_ERROR.GMP_ORDER_API问题求助

问题详情 #

调用加拿大站Shipping Updates API时返回内部错误，错误码SYSTEM_ERROR.GMP_ORDER_API，响应提示系统遇到内部错误。请求与响应详情如下：

请求CURL #

curl --location 'https://marketplace.walmartapis.com/v3/ca/orders/ORDER_ID/shipping' \
--header 'WM_SVC.NAME: Walmart Marketplace' \
--header 'WM_TENANT_ID: WALMART.CA' \
--header 'WM_LOCALE_ID: en_CA' \
--header 'WM_QOS.CORRELATION_ID: ...' \
--header 'WM_SEC.TIMESTAMP: ...' \
--header 'WM_SEC.AUTH_SIGNATURE: ...' \
--header 'WM_CONSUMER.ID: ...' \
--header 'WM_CONSUMER.CHANNEL.TYPE: ...' \
--header 'Content-Type: application/xml' \
--header 'Accept: application/xml' \
--header 'Host: marketplace.walmartapis.com' \
--data '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orderShipment
  xmlns:ns2="http://walmart.com/mp/v3/orders"
  xmlns:ns3="http://walmart.com/">
    <orderLines>
        <orderLine>
            <lineNumber>1</lineNumber>
            <shipFromCountry>US</shipFromCountry>
            <orderLineStatuses>
                <orderLineStatus>
                    <status>Shipped</status>
                    <statusQuantity>
                        <unitOfMeasurement>EACH</unitOfMeasurement>
                        <amount>1</amount>
                    </statusQuantity>
                    <trackingInfo>
                        <shipDateTime>2023-03-20:10:00.000Z</shipDateTime>
                        <carrierName>
                            <carrier>UPS</carrier>
                        </carrierName>
                        <methodCode>Standard</methodCode>
                        <trackingNumber>TRACKING_NUMBER</trackingNumber>
                    </trackingInfo>
                </orderLineStatus>
            </orderLineStatuses>
        </orderLine>
    </orderLines>
</orderShipment>'

响应XML #

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:errors xmlns:ns2="http://walmart.com/">
    <ns2:error>
        <ns2:code>SYSTEM_ERROR.GMP_ORDER_API</ns2:code>
        <ns2:info>System encountered some internal error.</ns2:info>
        <ns2:severity>ERROR</ns2:severity>
        <ns2:category>DATA</ns2:category>
        <ns2:causes/>
        <ns2:errorIdentifiers/>
    </ns2:error>
</ns2:errors>

排查与解决步骤 #

• 修正日期格式错误：请求XML中shipDateTime的格式不符合ISO 8601标准，当前为2023-03-20:10:00.000Z，需改为2023-03-20T10:00:00.000Z（将日期和时间之间的冒号替换为T）。日期格式解析失败是触发此类内部错误的常见原因。
• 校验请求头有效性：确保WM_SEC.TIMESTAMP为当前UTC时间的毫秒数，且与签名生成时的时间一致；每次请求使用唯一的WM_QOS.CORRELATION_ID，避免重复ID导致系统处理异常。
• 确认订单状态：检查目标订单是否处于可发货状态（如未发货、已确认），若订单已完成发货或取消，重复提交会触发错误。
• 重试临时故障：间隔5-10分钟后使用新的CORRELATION_ID和TIMESTAMP重试请求，排除Walmart API临时内部故障。
• 提交精准工单：向Walmart技术支持提交工单时，必须包含完整的请求头（敏感信息打码）、请求XML、响应XML、WM_QOS.CORRELATION_ID以及问题发生的UTC时间范围，这是Walmart排查内部错误的关键信息，避免模板化回复。

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