对接亚马逊SP-API（AmazonSellingPartnerAPI）第六章：
Fulfi。。。
1. API 对⽐
简短说明
返回创建 ⼊库货件所需的信息。
创建⼊库货件。
更新现有⼊库货件。
向亚马逊发送⼊库货件的运输信息。
请求⼊库货件的预计运费。
返回⼊库货件的当前运输信息。
确认您接受亚马逊合作承运⼈的预计运费，并请求亚马逊合作承运
⼈配送您的⼊库货件。
取消之前确认的使⽤亚马逊合作承运⼈配送⼊库货件的请求。
返回⽤于打印⼊库货件包裹标签的 PDF ⽂档数据。
返回⽤于打印⼊库货件提单的 PDF ⽂档数据。
根据您指定的条件返回⼊库货件列表
使⽤ NextToken 参数返回下⼀页⼊库货件。
返回指定⼊库货件的商品列表或在指定时间段内更新的商品列表。
使⽤ NextToken 参数返回下⼀页⼊库货件商品。
返回 “配送⼊库货件 API”部分 的运⾏状态。
2.
1.
2.
3.
4.
5.
6.
7.
8.
9.
3. SP-API 流程
3.1. 创建货件计划：createInboundShipmentPlan
参照 MWS 流程
备注：只创建货件计划是⽆法在亚马逊后台查询的，确认了货件计划才可以查得到。
public void createInboundShipmentPlanTest() throws ApiException {
CreateInboundShipmentPlanRequest body = new CreateInboundShipmentPlanRequest();
// Address
Address address = new Address();
address.tName("XXX");
address.tAddressLine1("XXX");
address.tCity("XXX");
address.tStateOrProvinceCode("XXX");
address.tCountryCode("CA");
address.tPostalCode("000000");
body.tShipFromAddress(address);
/*
* LabelPrepPreference 是您在 CreateInboundShipmentPlan 操作使⽤的⼀个关键参数。此参数指明了您将要发送⾄亚马逊物流的商品的标签准备⾸选项。
* 以下是 LabelPrepPreference 的有效值：
* SELLER_LABEL - 指明您将⾃⾏为每个需要商品标签的商品（不是⽆需贴标签的混杂库存中的商品）贴标。
* AMAZON_LABEL_ONLY - 亚马逊将为⼊库货件中需要标签的商品贴标。如果亚马逊确定没有成功对商品贴标所需的信息，⼊库货件计划不会包含该商品 * AMAZON_LABEL_PREFERRED - 亚马逊将为⼊库货件中需要标签的商品贴标。如果亚马逊确定没有对商品成功贴标所需的信息，⼊库货件计划会包含该 * 注：除⾮您注册了“亚马逊物流贴标服务”，否则 SELLER_LABEL 即为 LabelPrepPreference 的唯⼀有效值。“亚马逊物流贴标服务”不适⽤于印度 (IN)。
* */
body.tLabelPrepPreference(LabelPrepPreference.SELLER_LABEL);
// InboundShipmentPlanRequestItems
InboundShipmentPlanRequestItemList inboundShipmentPlanRequestItems = new InboundShipmentPlanRequestItemList();
InboundShipmentPlanRequestItem inboundShipmentPlanRequestItem = new InboundShipmentPlanRequestItem();
inboundShipmentPlanRequestItem.tSellerSKU("XXX");
inboundShipmentPlanRequestItem.tQuantity(1000);
inboundShipmentPlanRequestItems.add(inboundShipmentPlanRequestItem);
body.tInboundShipmentPlanRequestItems(inboundShipmentPlanRequestItems);
CreateInboundShipmentPlanRespon respon = ateInboundShipmentPlan(body);
}
题外: 分仓 --> 合仓
只创建了⼀个SKU的计划，却有两个 DestinationFulfillmentCenterId。
解决：（感谢阿科⼤佬）
备注：需要将账号默认库存配置设置成合仓。合仓的费⽤会⾮常贵！（运营⽴马掐灭了我修改配置想法..）
路径：Account Setting --> Fulfillment by Amazon --> Inbound Setting --> Inventory Placement Option --> Inventory Placement
Service
配置完后先测试⼀下，如果解决了就没问题了。我修改完配置已经变成⼀个了。
不⾏的话，再执⾏下列操作（多个SKU的情况下需要⽤到）。
调⽤ 获取 。（没有则为"NONE"）
在 Item 中添加查询出来的参数。
// 避免分仓
PrepDetailsList prepDetails = new PrepDetailsList();
PrepDetails prepDetail = new PrepDetails();
prepDetail.tPrepInstruction(PrepInstruction.LABELING);
prepDetail.tPrepOwner(PrepOwner.SELLER);
prepDetails.add(prepDetail);
inboundShipmentPlanRequestItem.tPrepDetailsList(prepDetails);
BUG 1: Reason: XX State field must be two characters.
{
"errors": [
{
"code": "InvalidInput",
"message": " Reason: XX State field must be two characters.",
"details": ""
}
]
}
解决：
参数中 AddressLine 和 CountryCode 必须是⼀致的。不能 AddressLine 是CA地址，CountryCode 填US。
BUG 2: NOT_IN_PRODUCT_CATALOG
<Error>
<Type>Sender</Type>
<Code>InvalidRequestException</Code>
<Message>This operation may be partially successful, Plea check the status. Reason: [Item(s) ineligible from being inbounded, with reason: NOT_IN_PROD </Error>
解决：
在亚马逊后台检查该产品是否为FBA发货
位置：后台 --> Inventory --> Manage FBA Inventory --> 相关SKU --> 配送类型更改为【所有】
3.2. 确认货件计划：createInboundShipment
参照 MWS 流程
3.3. 上传资料(没账号测试了，等以后处理了在补充资料。如果有愿意提供账号的可以联
系我！)
Feeds API 使⽤⽅式参照官⽅教程：
3.3.1. 上传纸箱内容
说明：上传 xml。
Feed Type: POST_FBA_INBOUND_CARTON_CONTENTS
3.3.2. 上传箱⼦尺⼨
说明：上传 excel。
Feed Type: POST_FLAT_FILE_FROM_EXCEL_FBA_CREATE_CARTON_INFO（此类型为隐藏类型，⼀般⼈我不告诉他们的，且知且
珍惜）
3.3. 发货：updateInboundShipment
参照 MWS 流程
3.4. 获取贴箱标：getLabels
备注：贴箱标是需要发给物流商的。
@Test
public void getLabelsTest() throws ApiException {
String shipmentId = "FBAAAAAAAA";
String pageType = "PackageLabel_Letter_2";
String labelType = "BARCODE_2D";
Integer numberOfPackages = null;
List<String> packageLabelsToPrint = null;
Integer numberOfPallets = null;
Integer pageSize = null;
Integer pageStartIndex = null;
GetLabelsRespon respon = Labels(shipmentId, pageType, labelType, numberOfPackage
s, packageLabelsToPrint, numberOfPallets, pageSize, p // TODO: test validations
}
然后就可以获取到⼀个下载的URL。（URL在15秒后会失效）
