# 概述
面向零售供应商的销售伙伴API帮助供应商通过网络服务集成以编程方式管理他们的零售业务运营.与亚马逊的自动集成可以帮助供应商改善和保持他们的规模性能,并与亚马逊一起发展他们的业务.
直接履行计划中的供应商将希望看到《供应商直接履行API使用案例指南》,以了解针对直接履行的API.
供应商可以使用这些API来构建应用程序,以提高运营效率,减少工作,减少错误,并提高性能.
关于认证和授权的信息,请参阅销售伙伴API开发者指南 (opens new window).
# 什么是供应商订单API?
使用供应商订单API (Orders API),供应商可以接收采购订单并发送订单确认,以接受或拒绝订单的执行.
包括以下操作
Operation | HTTP方法 | 路径 | Description |
---|---|---|---|
getPurchaseOrders | 获取 | /vendor/orders/v1/purchaseOrders | 返回在您指定的时间范围内创建或更改的采购订单的列表. |
getPurchaseOrder | 获取 | /vendor/orders/v1/purchaseOrders /{purchaseOrderNumber} | 根据您指定的purchaseOrderNumber值,返回一个采购订单(PO) |
submitAcknowledgement | 张贴 | /vendor/orders/v1/acknowledgements | 确认(接受或拒绝)一个或多个采购订单. |
getPurchaseOrdersStatus | 获取 | /vendor/orders/v1/purchaseOrdersStatus | 根据您指定的过滤器返回采购订单的状态. |
您可以使用getPurchaseOrders (opens new window)操作来访问在您指定的时间段内创建或更改的订单(在2020年6月后的最后6个月的滚动窗口内).我们建议您将时间范围限制在不超过7天,以优化响应时间.您也可以使用[getPurchaseOrder](https来获取特定订单的详细订单信息 //spapi.cyou/zh/references/vendor-orders-api-v1-reference.html#get-vendorordersv1purchaseorderspurchaseordernumber)操作.然后你可以使用[submitAcknowledgement](https来确认(accept or reject)订单 //spapi.cyou/zh/references/vendor-orders-api-v1-reference.html#post-vendorordersv1acknowledgements)操作.确认订单后,您可以使用getPurchaseOrdersStatus (opens new window)操作来返回一个或多个采购订单的确认状态.
注意:通过调用带有 "includeDetails "过滤器的getPurchaseOrders操作,您可以返回完整的采购订单细节或只返回采购订单号码.该参数的默认值为true,所以如果您不包括这个查询参数,您将返回采购订单的完整细节.如果您 "includeDetails=false",响应将只包括采购订单号码的列表和每个采购订单的当前状态.
下图显示了使用供应商订单API的工作流程.
# 获取采购订单
# Usage
getPurchaseOrders (opens new window)操作只返回订单参考列表(采购订单编号和状态)或完整的订单细节,适用于所有符合请求中指定条件的订单.如果你只返回订单参考,它们可以稍后与getPurchaseOrder (opens new window)操作一起使用,以获得特定订单的细节.
你应该使用这个API来获取可供你执行的采购订单.亚马逊建议供应商在营业时间内每小时至少检查一次订单.根据你的业务量,你可以选择更频繁的检查.你可以在一次API调用中获得多达100个订单.如果有超过100个订单,你可以使用nextToken来获得下一组订单.
# 订单更改和取消
你可以使用getPurchaseOrders操作返回订单的更改和取消.
订单变更有时亚马逊会在订单创建后由于需求的变化而改变采购订单的数据.供应商可以使用getPurchaseOrders API来获取更新的订单.如果亚马逊改变了采购订单,该订单会有一个'purchaseOrderChangedDate'字段,这是亚马逊更新订单的时间戳.如果这个字段不存在,说明该订单创建后从未改变.
注意亚马逊也可以在供应商确认后更改采购订单.
供应商可以通过使用 "changedAfter "和 "changedBefore "查询参数获得在指定日期范围内发生变化的订单列表.这将返回在日期范围内被亚马逊改变的订单,供应商必须履行更新的采购订单.另外,供应商可以使用 "isPOChanged=true "进行过滤,获得所有改变的采购订单.
亚马逊建议每天用更改的日期范围运行单独的API调用几次,以获得一天内更改的订单. 例如,你可以调用获取采购订单的API来获得过去6小时内更改的订单,每天4次.
以下是可以促成订单更改的变化列表,供应商必须拉出更改后的订单,以运送正确的采购订单
-发货/交货窗口的变化
- PO项目更新,如数量变化、项目取消、项目成本变化
-在PO中添加新的项目
PO取消/未取消
PO类型改变
-PO交货目的地(履行中心)改变了
-PO运费信息改变
**项目取消:**订单API也可以通过使用 "poItemState"=Cancelled.过滤来返回有一个或多个取消项目的订单,这将返回所有在购买订单创建后被亚马逊取消了一个或多个项目的订单.这将帮助供应商只获得有取消项目的订单(订购数量为零),他们可以确保不发货的取消项目.
注意供应商也会在更改的订单列表中返回这些订单,因为物品的取消符合订单更改的条件.
**采购订单状态和供应商代码:**采购订单模式包括当前采购订单状态和状态更新时间.您可以使用过滤器'purchaseOrderState'根据当前状态过滤订单.
例如,供应商可以使用'purchaseOrderState=New'.获得所有尚未被确认或履行的采购订单
供应商也可以通过在过滤器'orderingVendorCode'.中提供一个授权的供应商代码来获得特定供应商代码的采购订单,这个过滤器将只返回过滤器中提到的供应商代码的采购订单.
关于所有可用过滤器的细节,请参见Vendor Orders API Reference (opens new window).
下图显示了检索采购订单时的整合工作流程
# 获取采购订单
# Usage
getPurchaseOrder (opens new window)操作返回您使用采购订单号指定的采购订单的信息. 响应包括采购订单的完整采购订单信息,包括细目、数量、成本等.
你应该使用这个API来获取由getPurchaseOrders操作返回的特定订单的细节.
下图显示了整合的工作流程
# Business Requirements
- 发货窗口/交货窗口的使用
对于供应商支付的运费,应该使用交货窗口信息.日期是按照ISO8601的日期时间间隔格式表示的.格式是用双连字符分隔的开始和结束日期(--).开始日期字段代表亚马逊期望货物被交付到采购订单上所列的亚马逊履行中心的最早日期.字段中的结束日期代表亚马逊期望货物被交付到采购订单上所列的亚马逊履行中心的最近日期.
对于亚马逊-支付的货物,应该使用发货窗口信息.日期是按照ISO8601的日期时间间隔格式表示的.格式是用双连字符分隔的开始和结束日期(--).开始日期字段代表亚马逊期望提取货物的最早日期.结束日期代表亚马逊期望提取货物的最晚日期.如果开始日期和结束日期字段中列出的是同一个日期那么就把该日期作为亚马逊预计取货的日期.
- **一个细列项目是否可以接受延期付款?
您需要读取 "isBackOrderAllowed "字段中的值.当为真时,该订单可以作为延期订单处理.当为假时,不允许延期订单.
- 优惠代码
优惠代码是在订单的 "dealCode "字段中报告的促销代码.任何与促销代码、特别折扣或价格有关的信息都将出现在这个字段中.
- 延期订单取消政策
逾期订单政策由您的亚马逊业务代表决定.请与您的供应商经理讨论细节.
注意:延期交货的取消日期可能不会在订单中提交.供应商需要在账户层面上设置我们的延期交货政策.
- 使用API更改订单
目前无法使用API提交订单的变更.在订单下达后,变更订单是一个手动过程.
# 国家具体业务要求
功能 | 印度 | 欧洲 | 北美 |
---|---|---|---|
净成本 | 条件.净成本或清单价格. | 条件.净成本或清单价格. | 条件.净成本或清单价格. |
清单价格 | 有条件的.净成本或清单价格. | 有条件的.净成本或清单价格. | 有条件的.净成本或清单价格. |
后退订单 | 不适用 | 支持 | 支持 |
购买方 | 亚马逊购买实体的地址 | 购买方的指定方ID | 不适用 |
销售方 | 分配给销售方的亚马逊供应商代码 | 分配给销售方的亚马逊供应商代码 | 分配给销售方的亚马逊供应商代码 |
Ship To Party | Ship to Entity的地址 | 分配给shipping to party的party ID | Not Applicable |
Bill To Party | Bill To Entity的地址 | Bill To Entity的地址 | 不适用 |
# 确认订单
# Usage
submitAcknowledgement (opens new window)操作让供应商接受或拒绝履行的采购订单.亚马逊希望得到一份完整的确认书,包括采购订单的所有行项目.如果供应商在确认书中没有提供采购订单的所有行项目,亚马逊将隐含地拒绝缺少的行项目.
亚马逊希望供应商尽快提交确认书;最迟在24小时内提交.确认书应准确反映实际发货数量和日期.
对于数量、价格、发货日期或交货日期的任何变化,亚马逊希望供应商在48小时内对提交的确认进行更新. 供应商可以提交完整的确认更新,也可以只更新特定的行货. 亚马逊总是将更新视为对该行货的早期确认的替换. 48小时后,我们只希望收到发货日期或交货日期的更新.
如果一个特定商品的第一个确认代码是 "拒绝",你不允许用你的更新将其改为 "接受 "或 "退货".
# 验证成功提交的订单确认书
供应商可以使用Vendor Central或使用Transaction Status API.允许系统在提交后最多需要30分钟来显示原始或更新版本.如果Vendor Central没有显示确认的正确值在Vendor Central打开一个 "联系我们 "的案例.
下图显示了确认订单时的整合工作流程.
# Business Requirements
- 供应商在确认订单时,可以增加采购订单中提交的原始数量吗?
不可以,亚马逊不允许供应商在回执中发送比采购订单中提交的数量更多的数量.
- 是否需要为每个采购订单发送订单确认书?
是的,为了正确更新亚马逊系统中的订单状态,亚马逊要求使用API或Vendor Central确认PO.如果您无法使用API满足我们的订单确认要求,您必须使用Vendor Central确认您的采购订单.如果您没有Vendor Central账户,请联系您的亚马逊业务代表.
- 是否需要在相应的订单确认中提供每一个PO行项目?
是的,这样亚马逊才能正确地更新订单状态.
- 如果一个细目被置于滞销状态,是否需要在订单确认中提供数量?
是的,这样亚马逊系统才能正确地更新该行货的状态.
- 应如何使用订单确认书报告订单上的无效或过时物品?
请不要处理或发送订单上有无效货号的商品.请在确认单上返回无效货号,并确认为 "无效".以下确认代码表示由于商品过时而被 "拒绝"
被拒绝亚马逊的解释是,这个代码所描述的数量不会作为这个采购订单的一部分交付给亚马逊.您应该在确认中发送适当的拒绝原因为 "过时".这表明由于该项目已经过时.亚马逊对此的命名是 "硬拒绝",意思是这个项目不应该被重新订购.如果同一项目连续两次收到这个代码(相隔至少48小时),这个项目将不会被重新订购.
注意即使采购订单上的所有项目都是无效的,并且没有产生订单或发票,亚马逊也希望得到确认.如果不能为采购订单发送相应的确认,亚马逊需要手动通知无效的项目.您的采购团队可以通过供应商中心联系我们的链接进行通知.
- 我是否需要在回执中返回与订单交易中收到的相同的产品标识符?
答谢必须返回与采购订单中发送的产品标识符完全相同的产品标识符
- 是否需要在确认中提供价格?
是的,供应商需要在确认中返回单位成本价格.成本价格应与将被开具发票的单位成本价格相匹配.图书供应商需要提供清单价格和折扣乘数.
- **采购订单中的价格可以简单地在确认书上返回吗?
不可以.无论采购订单上提交的价格是多少,亚马逊都要求在回执中提供成本价格.回执上提交的成本价格应该与发票上提交的成本价格一致.亚马逊支付系统会对两者进行比较,如果不一致可能会延迟付款.
- **如果价格和/或供应量在最初的确认函传送后发生变化,亚马逊.com需要什么?
如果亚马逊订单在初始确认传送后发生任何变化,请提供人工通知.您的亚马逊.com业务代表可以就何时、如何以及由谁来通知提供建议.
- **是否需要为滞销的商品提供价格数据?
是的,这是必须的,这样亚马逊才能正确地更新订单的状态.如果省略了价格,这将导致EDI系统内的确认被拒绝.
- **我将如何知道是否允许延期交货?
您需要读取采购订单中 "isBackOrderAllowed "字段的值.值为 "真 "表示允许延期交货.值为 "假 "表示不允许延期交货.
- **是否需要为所有细列项目提供一个确认代码,无论其状态如何?
是的,这是必须的,这样我们才能正确地更新订单的状态.如果省略了确认代码,确认将在我们的EDI系统中被拒绝.
- **亚马逊.com对部分货物的政策是什么?在提交订单确认时,应如何报告部分货物的情况?
部分发货是允许的.亚马逊建议你用代码 "accepted "和相应的日期表明一个确认循环,用代码 "backordered "和相应的日期表明另一个确认循环.
已接受对于可以立即履行的商品.
滞销对于不能立即履行的剩余数量. 剩余的数量(订购的数量减去所有确认的数量)将在以后交付(回购-订购).
- **什么时候应该使用listPrice段?
ListPrice段只有在供应商销售清单价格的书籍时才需要使用.
# 国家具体业务要求
功能 | 印度 | 欧洲 | 北美 |
---|---|---|---|
预定发货日期 | 有条件的.取决于货运条款和目前与供应商的业务安排. | 可选 | 可选 |
预定交货日期 | 有条件. 取决于货运条款和目前与供应商的业务安排. | 可选 | 可选 |
清单价格 | 只需要图书供应商 | 支持 | 只需要图书供应商 |
# 获取采购订单状态
# Usage
The [getPurchaseOrdersStatus](https: //spapi.cyou/zh/references/vendor-orders-api-v1-reference.html#get-vendorordersv1purchaseordersstatus)操作返回符合请求中指定标准的采购订单列表的状态.你可以使用这个API来获得采购订单中项目的确认状态 您可以使用这个API来获取采购订单中可供您执行的项目的确认状态. 这个API返回一个项目的订购数量和确认的历史记录. 您可以查看采购订单中一个项目所处理的所有确认的细节. 我们提供了广泛的查询参数来根据您的要求过滤PO的列表.
您可以在一次API调用中最多返回100个订单.如果有超过100个订单,您可以使用nextToken来获取下一组订单.
下面是几个例子,说明你如何使用getPurchaseOrdersStatus操作和不同的查询参数
1.您可以通过使用PO创建日期(createdBefore和createdAfter)或PO更新日期(updatedBefore和updatedAfter)以及'purchaseOrderStatus=OPEN'来获得指定日期范围内所有未结采购订单的状态.
您可以使用项目状态来过滤PO的st. 例如,如果'itemConfirmationStatus=REJECTED',响应将返回所有有一个或多个项目状态为拒绝的订单.
您可以通过在'purchaseOrderNumber'查询参数中提供PO号码来检查特定PO的状态.
您可以通过在'orderingVendorCode'中提供供应商代码值并包括'purchaseOrderStatus=OPEN'来获得所有为特定供应商代码提出的未结订单的状态.
你可以通过在'shipToPartyId'中提供履行中心(FC)代码,以及在'createdBefore和createdAfter'中提供时间段范围,来获得在某一时间范围内创建的所有需要运往特定亚马逊FC的PO的状态
# 采购订单和确认书用例
# 采购订单中的无效行项目
如果供应商在采购订单中收到一个无效的产品标识符,供应商应该拒绝该项目,确认代码为 "Rejected","rejectionReason "为 "InvalidProductIdentifier"
采购订单
{
"订单": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "新",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "发票"
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": "10",
"unitOfMeasure": "案例",
"单位大小": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"金额": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"金额": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
采购订单确认书
{
" acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
" acknowledgementDate": "2019-07-17T19:17:34.304Z",
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "案例",
"单位大小": 5
},
"netCost": {
"currencyCode": "USD",
"金额": "10.2"
},
"itemAcknowledgements": [
{
" acknowledgementCode": "拒绝的"
"recognizedQuantity": {
"数额": 10
},
"rejectionReason": "InvalidProductIdentifier"
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
采购订单状态
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "CLOSED",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-17T19:17:34.304Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"金额": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"金额": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"数量": 10,
"unitOfMeasure": "案例",
"单位大小": 5
},
"orderedQuantityDetails": [
{
"upedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "案例",
"单位大小": 5
}
}
]
},
" acknowledgementStatus": {
"confirmationStatus": "REJECTED",
"acceptedQuantity": {
"数额": 0,
"unitOfMeasure": "案例",
"单位大小": 5
},
"rejectedQuantity": {
"数量": 10,
"unitOfMeasure": "案例",
"单位大小": 5
},
" acknowledgementStatusDetails": [
{
" acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"数额": 0,
"unitOfMeasure": "案例",
"单位大小": 5
},
"rejectedQuantity": {
"数量": 10,
"unitOfMeasure": "案例",
"单位大小": 5
}
}
]
}
}
]
}
]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
# 采购订单中的过期项目
如果供应商在采购订单中收到一个过时的产品,供应商应该拒绝该项目,确认代码为 "Rejected","rejectionReason "为 "ObsoleteProduct"
采购订单
{
"订单": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "新",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "发票"
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": "10",
"unitOfMeasure": "案例",
"单位大小": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"金额": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
采购订单确认书
{
" acknowledgements": [
{
"purchaseOrderNumber": "L8266356",
"sellingParty": {
"partyId": "999US"
},
" acknowledgementDate": "2019-07-17T19:17:34.304Z",
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123438",
"vendorProductIdentifier": "028877454079",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"netCost": {
"currencyCode": "IN",
"数额": "100.20"
},
"itemAcknowledgements": [
{
"accountledgementCode": "拒绝的"
"recognizedQuantity": {
"数额": 10
},
"rejectionReason": " 过期产品"
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# 确认部分商品数量并退订剩余数量
亚马逊订购了10件商品的数量.供应商计划分批发货,因此发送 "接受 "的商品数量为6件,"退订 "的商品数量为4件,以表示6件将在第一批发货,4件在第二批发货.
采购订单 - (导入采购订单)
{
"订单": {
"purchaseOrderNumber": " L8266357",
"purchaseOrderState": "Acknowledged",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderChangedDate": "2019-07-18T16:05:00Z",
"purchaseOrderStateChangedDate": "2019-07-17T10:00:34.304Z",
"purchaseOrderType": "RegularOrder",
"importDetails": {
"importContainers": "2-20'HC,1-45',1-45'HC",
"InternationalCommercialTerms": "FreeOnBoard",
"methodOfPayment": "PrepaidBySeller",
"PortOfDelivery": "美国"
"shippingInstructions": "首选是托盘-负载,但如果集装箱是地板-负载"
},
"paymentMethod": "发票",
"购买方": {
"partyId": "XYZ1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "XYZ1"
},
"billToParty": {
"partyId": "XYZ1",
"taxInfo": {
"taxRegistrationNumber": "12aaxyz4259z123",
"taxRegistrationType": "增值税"
}
},
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": "10",
"unitOfMeasure": "个"
},
"isBackOrderAllowed": true,
"netCost": {
"金额": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"金额": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
采购订单确认书
{
" acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
" acknowledgementDate": "2019-07-17T19:17:34.304Z",
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "个"
},
"netCost": {
"currencyCode": "USD",
"金额": "10.2"
},
"itemAcknowledgements": [
{
" acknowledgementCode": "已接受"
"recognizedQuantity": {
"数额": 6
},
"预定发货日期": "2019-07-17T19:17:34.304Z"
},
{
" acknowledgementCode": "Backordered",
"recognizedQuantity": {
"数额": 4
},
"预定发货日期": "2019-07-25T19:17:34.304Z"
}
]
}
]
}
]
}
在运送订单的第一部分后,供应商使用 "预定运送日期 "向亚马逊提供第二次运送的更准确的日期.注意,供应商应始终发送完整的更新,包括个别行项目的总订购量.完整的更新提供了数量的明确可见性.
采购订单状态
```json
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "OPEN",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-18T16:05:00Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "XYZ1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"金额": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"金额": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"数量": 10,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"orderedQuantityDetails": [
{
"upedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
]
},
" acknowledgementStatus": {
"confirmationStatus": "ACCEPTED",
"acceptedQuantity": {
"数额": 10,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
" acknowledgementStatusDetails": [
{
" acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"金额": 10,
" unitOfMeasure": "Eaches",
"单位大小": 1
},
"rejectedQuantity": {
"数量": 0,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
]
}
}
]
}
]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
# 多次确认,取消最初接受的数量
当供应商发现他们无法完成最初接受的订单的部分或全部单位时,他们可以使用这个方法,并通知亚马逊这些单位将不会被运出.
采购订单
{
"订单": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "新",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "发票"
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": "10",
"unitOfMeasure": "案例",
"单位大小": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"金额": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"金额": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
采购订单的确认
供应商最初接受的数量.
{
"确认": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
" acknowledgementDate": "2019-07-17T19:17:34.304Z",
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"netCost": {
"currencyCode": "USD",
"金额": "10.2"
},
"itemAcknowledgements": [
{
" acknowledgementCode": "已接受"
"recognizedQuantity": {
"数额": 10,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"预定发货日期": "2019-07-17T19:17:34.304Z"
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
后来,供应商无法履行接受的数量,并通过另一个采购订单确认请求发送全部或部分取消.
全部取消
{
"recognledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
" acknowledgementDate": "2019-07-17T19:17:34.304Z",
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"netCost": {
"currencyCode": "USD",
"金额": "10.2"
},
"itemAcknowledgements": [
{
" acknowledgementCode": "拒绝的"
"recognizedQuantity": {
"数额": 10,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"rejectionReason": "暂时无法使用"
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
部分取消
{
" acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
" acknowledgementDate": "2019-07-17T20:10:34.304Z",
"项目": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"netCost": {
"currencyCode": "USD",
"金额": "10.2"
},
"itemAcknowledgements": [
{
" acknowledgementCode": "已接受"
"recognizedQuantity": {
"数额": 3,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"预定发货日期": "2019-07-17T19:17:34.304Z"
},
{
" acknowledgementCode": "Rejected"(拒绝)
"recognizedQuantity": {
"数额": 7,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"rejectionReason": "暂时无法使用"
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
后续部分取消后的采购订单状态
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "OPEN",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-17T19:17:34.304Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"金额": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"金额": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"数量": 10,
"unitOfMeasure": "案例",
"单位大小": 5
},
"orderedQuantityDetails": [
{
"upedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"金额": 10,
"unitOfMeasure": "案例",
"单位大小": 5
}
}
]
},
" acknowledgementStatus": {
"confirmationStatus": "partially_accepted",
"接受数量": {
"金额": 3,
"unitOfMeasure": "案例",
"单位大小": 5
},
"rejectedQuantity": {
"数量": 7,
"unitOfMeasure": "案例",
"单位大小": 5
},
" acknowledgementStatusDetails": [
{
" acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"金额": 10,
"unitOfMeasure": "案例",
"单位大小": 5
},
"rejectedQuantity": {
"数量": 0,
"unitOfMeasure": "案例",
"单位大小": 5
}
},
{
" acknowledgementDate": "2019-07-17T20:10:34.304Z",
"acceptedQuantity": {
"数额": 3,
"unitOfMeasure": "案例",
"单位大小": 5
},
"rejectedQuantity": {
"数量": 7,
"unitOfMeasure": "案例",
"单位大小": 5
}
}
]
}
}
]
}
]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
# 什么是供应商出货量API?
供应商可以使用Vendor Shipments API (Shipments API)与亚马逊交换货物相关的文件. SubmitShipmentConfirmations (opens new window)操作让供应商为确认的订单发送货物确认书.
在Shipments API中包含了以下操作
Operation | HTTP方法 | 路径 | Description |
---|---|---|---|
SubmitShipmentConfirmations | 张贴 | /vendor/shipping/v1/shipmentConfirmations | 向亚马逊提交一份或多份货物确认书. |
# 提交货件确认书
# Usage
SubmitShipmentConfirmations (opens new window)操作让供应商向亚马逊提交发货确认书.您的发货确认书可以让我们有效地接收和处理您的货物.它包含了关于正在运输的物品的信息,包括采购订单号、发货日期、预计交货日期、批号、到期日和SSCC.
通过收到有效和及时的装运确认书,我们可以正确预测您发送给我们的货物.以下是提交装运确认书的一些优势
货运确认书使我们能够更有效地与承运人合作,跟踪和接收您的货物. 这使我们能够有效地计划我们的劳动力资源,并有助于确保更快、更有效地收到您的货物,这意味着您可以更快地为您的PO开具发票.
发货确认让亚马逊可以跟踪进货库存,并创建自动订单,以确保商品不会缺货.
发货确认让我们对运输中的产品有更多的了解,这使我们能够更准确地反映商品的可用性(按期交付)给终端客户.
亚马逊的PO取消政策允许取消未完成的PO发货.然而,具有准确发货确认的PO提醒我们的内部系统在-运输状态.这可以帮助避免不必要的PO取消、扣款和货运拒绝.
缺乏有效的货件确认可能会导致
-对进货的可视性不足.
在核对实物装运和采购订单时出现错误.
手动跟进以解决差异.
-提供POD(交货证明)用于开具发票.
货物确认书-替换
当 "shipmentConfirmationType "为 "Replace "时,供应商可以通过发送更新的版本来纠正之前提交的货件确认. 第二次货件确认调用将完全覆盖第一次货件确认数据.
主要优点是在首次提交后,通过更新有问题的货件确认书来提高预订的准确性.
它是如何工作的?
为了替换之前提交的货件确认,可以发送第二份货件确认. "shipmentIdentifier "和 "sellingParty"-> "partyId "需要在两次传输中完全相同,这样我们才能成功覆盖之前版本的货件确认.
货件确认书的范围-替换
除了 "shipmentIdentifier "和 "sellingParty"-> "partyId "外,所有的货件确认值都可以编辑,这两个值需要保持一致才能成功地进行货件确认-替换.
托盘、纸箱和装运数量不能增加,只能减少. 为了增加数量,您需要发送第二份带有新的 "shipmentIdentifier "的货件确认书. 如果额外的单位要用同一货件交付,您可以使用同一BOL参考.
使用API提交的货件确认书只能通过使用API提交另一个货件确认书来进行编辑. 在Vendor Central创建的货件确认书不能使用API进行编辑,反之亦然.
替换货件确认只能在最初的货件确认后的7天内进行,而且只有在货件尚未到达亚马逊履约中心的情况下才能进行替换.
验证成功提交的货件确认书*
供应商可以通过 "Vendor Central >Orders>Shipment "或使用交易状态API来验证其原始/替换的货件确认的状态.一旦提交,允许系统在30分钟内显示原始/替换的版本.如果Vendor Central没有显示替换的货件确认的正确值,请在Vendor Central打开一个 "联系我们 "案例.
下图显示了提交货件确认书时的整合工作流程.
# Business Requirements
-每车货物有100份货件确认书的限制.这意味着,只有当该车货物的单个货件确认书总数小于或等于100份时,您才可以在PO级别或纸箱级别单独发送货件确认书(TL)/小于卡车装载(LTL)货件.我们建议您为整个TL/TL货物发送一份货件确认书,包括所有PO和纸箱细节.
亚马逊必须在亚马逊履约中心收到产品之前收到发货确认书. 缺少或延迟发货确认书将导致扣款.
对于小包裹货物,每个包裹/纸箱都需要有发货确认书.
以下是亚马逊的要求,并对其进行测量,以跟踪遵守情况
-对于托盘装运的货物,供应商必须在申请亚马逊履约中心的送货时段之前发送发货确认书,因为只有在亚马逊系统中发现有效的发货确认书时才会提供预约.对于例外情况,请参考当地的发货确认书帮助页面,了解可用的选项.对于包裹,需要在物品运输之前提交发货确认书.错过或延迟的发货确认书将导致扣款.
-货件确认需要针对一个供应商的一次发货,并且不能超过一辆卡车.用多辆卡车发货,发往多个亚马逊履约中心,来自多个供应商账户或在多天内到达的货件需要多次货件确认.
如果同一供应商账户的几个小件货物被合并到一个大件货物中,并且需要多个货物确认,您可以根据以下例子使用伞状BOL选项
货件确认1
"billOfLadingNumber": "BOL1"
"shipmentIdentifier": "SHIPMENT CONFIRMATION_ID1" 货物确认书2
"billOfLadingNumber": "BOL1"
"shipmentIdentifier": "SHIPMENT CONFIRMATION_ID2"
# 国家具体业务要求
Functionality | Business Definition | 印度 | 欧洲 | 北美洲 |
---|---|---|---|---|
提货单号/交货报价 |
BOL号码是供应商分配的唯一号码.货件确认中出现的BOL最好与随货提供的纸质BOL一致,但这并不是必须的.请看表格下面的参考资料中的详细规格.BOL是用于预约和创建货件标签的参考资料.
送货单号码是替代提单作为货件的参考号码. 的一种方法 | 有条件的 | 所有货件确认书都必须填写. | 对TL/LTL货件是强制性的. |
承运人货件参考号码(PRO#) | PRO号码(PRO号码)是承运人分配的唯一号码.用来识别和跟踪出去交货的货物. | 是所有货件确认的必经之路. | Optional | 所有货件确认的必修课. |
装运日期 | 货件离开供应商仓库的日期. | 所有货件确认的必经之路. | 所有货件确认的强制性规定. | 所有货件确认的强制性规定. |
预计交付日期 | 预计货物到达亚马逊履约中心的日期.这需要根据从发货地点到目的地之间的平均运输时间来估算.确切的预约时间将由亚马逊提供,在创建货物时有可能不知道. | 所有货件的确认都是强制性的. | 所有货件确认的强制性规定. | 所有货件确认的强制性规定. |
纸箱数量 | 货物中存在的纸箱数量.堆放在托盘上没有外箱的单位被计算为1个单位=1个纸箱.纸箱计数在货物层面上是必须的. | 所有货物确认都必须填写. | 所有货物确认都必须填写. | 所有货件确认的强制性规定. |
托盘数量 | 货件中存在的托盘数量.对于纯包裹货件,需要注明数值0,所有通过托盘到达FC的货件都需要在此部分至少注明1.该信息在货件层面是必须的. | 对所有托盘交货的货物确认都是强制性的. | 所有货件确认都必须填写. | 建议使用Tl/LTL的货物. |
标准承运人阿尔法代码(SCAC) | 标准承运人阿尔法代码(SCAC)是一个独特的二至四字母代码,用于识别承运人.承运人SCAC代码由NMFTA分配和维护(国家汽车货运协会).Optional | Optional | 所有的货物确认书都是强制性的. | |
装运地点(运往) | Party Id/Warehouse Code of the location where the products are shipped to. API schema field name is "shipToParty" | 所有货件确认的必选项. | 对所有货件确认都是强制性的. | 所有货件确认的强制性规定. |
Supplier Identification | 向亚马逊发货的供应商标识.API模式字段名是 "sellingParty". | 对所有货物确认都是强制性的. | 对所有货件确认都是强制性的. | Optional |
发货地 | 地址(ZIP代码)以及产品实际发运地的国家参考号. | 所有货物确认书必须填写. | 所有装运确认书必须填写.所有货件确认的强制性规定. | |
亚马逊参考号码(仅适用于WePay货件). | 亚马逊参考号码,在WePay货件的相关采购订单中收到. |
只对货件确认有强制性要求
(用于WePay货件). |
只对货件确认有强制性要求
(针对WePay货件). 的强制性规定 | 对代收货款的强制要求. |
采购订单编号 | 亚马逊采购订单号.书面授权供应商以指定的价格运送产品,一旦供应商接受就成为具有法律约束力的合同. | 在标题或细列项目层面是强制性的. | 在标题或细列项目层面上是强制性的. | 在页眉或细列项目上的强制性规定. |
序列运输集装箱代码(SSCC) | 独特的18-数字序列装运集装箱代码(SSCC),用于定义一个托盘/纸箱. | 推荐用于所有的货物确认 在包装单元内. | 对所有包装单元内的货件确认都是强制性的 在包装单元内的所有货物确认. | 每个纸箱必须填写,货盘可选择填写. |
Item Identification | 产品的供应商SKU. | 对所有的装运确认书都是强制性的. | 所有装运确认的强制性规定. | 所有货件确认的强制性规定. |
批号 | 批量或批号将物品与制造商认为与元素串所适用的贸易品的可追溯性有关的信息联系起来.该数据可能是指贸易品本身或包含的物品.易腐烂物品的强制性规定. | 对易腐烂物品的强制性规定. | 易腐烂物品的强制性规定. | |
过期日期 | 决定产品消费或使用限制的日期.其含义根据贸易项目背景确定. | 对易腐烂物品的强制性规定. | 对易腐烂物品的强制性规定. | 过期或生产日期和保质期是必须的. |
生产日期 | 由制造商确定的生产、包装或装配日期.其含义是根据贸易项目的背景确定的. | Optional | Optional | 需要过期或制造商日期和保质期. |
Quantity | 一个特定项目的发货数量. | 对所有装运确认书都是强制性的. | 所有装运确认的强制性规定. | 所有货件确认的强制性规定. |
# 附加字段说明
# 提单 (BOL#)
提单(BOL#)是在亚马逊预约**所需的参考号码.当亚马逊要求提供有效的货物确认书时,必须提供这个参考号码.它是实体货物随附文件的默认参考号码.货物确认书中的BOL# 应与货物文件中提供的BOL# 相符.
在定义BOL#的时候要注意以下几点
BOL# 必须对每批货物是唯一的,不能重复.
BOL# 可以是实际的提单参考,但如果不是,请通过以下方式确保其唯一性
创建至少有8位数字的BOL# ,.
使用亚马逊供应商代码作为前缀(e.g. ABCD193939393).
BOL/# 不能是一个日期/时间.
# Shipment Identification
这个字段是一个唯一的ID(唯一性是在代表这个货件确认的供应商)范围内定义的.如果没有提供 "货件标识",将导致货件确认被拒绝.请确保发送的ID在过去365天内没有使用过.
# Shipped Date
该字段表示货物离开供应商所在地的日期.请供应商在货物离开其仓库/配送中心的30分钟内或在亚马逊履约中心的预约时间前至少6小时内发送货物确认函,以较早者为准.
发货确认书中提到的发货日期应该是在过去7个日历日内(从发货确认书提交日期起)或在未来2个日历日内(从发货确认书提交日期起).
# 预计交付日期
这是一个基于经验的粗略估计,即货物预计何时交付给亚马逊履约中心.供应商需要根据承运人的平均运输时间来确定这一日期.如果我们没有从承运人那里得到估计交付日期,这一信息有助于我们对货物进行规划.
每个货物都需要提供这个日期,即使在这个阶段预约日期可能是未知的.
# 货物集装箱序列号(SSCC)
供应商需要在发货确认信息中提供纸箱内容的详细信息,以便亚马逊使用高度自动化的方法处理收货,这种方法称为License Plate或LP Receive.这是规定的收货流程,通过扫描纸箱或托盘外部的Serial Shipment Container Code (SSCC)条形码来接收物品,无需扫描纸箱/托盘内的每件物品.这种流程有很多明显的优势,包括提高效率,提高收货准确性,更准确的付款,以及更快的付款周期.
为了让供应商选择他们想要的技术解决方案,亚马逊决定不严格遵循GS1-128的解决方案.为了符合亚马逊牌照的要求,SSCC应该是一个独特的18-位的代码,定义一个托盘或纸箱它在365天内不能重复,并且必须在纸箱标签上贴上条码,并包含在装运确认信息中.此外,实物标签上的条码必须与装运确认中的SSCC100%匹配.因此,希望实施GS1-128的供应商被要求在装运确认中的SSCC开头添加一个 "00".
关于更多的细节和实物运输的要求,请参考供应商中心资源中心的牌照接收手册.
# Expiration Date
有效期是决定产品消费或使用限制的日期.它是根据贸易项目背景确定的(e.g.对于食品来说,这表明在该日期之后使用产品可能会导致直接的健康风险,对于药品来说,它表明在该日期之后产品无效可能会导致间接的健康风险).它通常被称为 "使用日期 "或 "最大耐久性日期."
# Manufacturing Date
这是货物被包装或制造的日期.如果一个物品是易腐烂的或有明确的保质期,则应提供这一字段.
# Lot Number
批量或批号将物品与制造商认为与元素串所适用的贸易品的可追溯性有关的信息联系起来.该数据可以指贸易品本身或所包含的物品.该号码可以是,例如,生产批号、班次号、机器号、时间或内部生产代码.
# 在装运确认中使用有效期/生产日期/批号
这些字段只对易腐物品是强制性的,即那些在NIS(新物品设置-up)表格中 "是过期产品 "属性为 "是 "的物品.e.
在装运确认书中定义过期日期/生产日期/批号时,请注意以下几点
-失效日期/生产日期/批号必须在物品层面上发送.
-一个箱子/托盘可以有多个物品(ASINs),每个都有单独的有效期/生产日期/批号.
-一个物品(ASIN)在同一个箱子/托盘中不应该有多个到期日/制造日期/批号.
供应商需要在发货确认书中提供有效期和生产日期,格式为YYYMMDD.
# 发货确认用例
# 带有过期和批次号的小包裹
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "原始",
"shipmentType": "TruckLoad",
"shipmentStructure": "LooseAssortmentCase",
"transportationDetails": {
"carrierScac": "UPSN",
"billOfLadingNumber": "02440000"
},
"amazonReferenceNumber": "ARN_Number",
"shipmentConfirmationDate": "2019-07-29T21:56:18.575Z",
"shippedDate": "2019-07-29T21:56:18.575Z",
"预计交付日期""2019-07-29T21:56:18.575Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"地址": {
"名称": "ABC电子仓库",
"addressLine1": "DEF第一街",
"城市": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "amzwarehousecode"
},
"shipmentMeasurements": {
"货物总重量": {
"unitOfMeasure": "公斤",
"值": "120.45"
},
"出货量": {
"unitOfMeasure": "CuFt",
"值": "2.4"
},
"cartonCount": 2
},
"shippedItems": [
{
" itemSequenceNumber": "001",
"amazonProductIdentifier": "AB1234233",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"金额": 50,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": " 001",
"trackingNumber": "UPS追踪号码"
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698889"
}
],
"cartonSequenceNumber": " 002",
"trackingNumber": "UPS追踪号码"
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
# 有多件物品的托盘式卡车货物
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "原始",
"shipmentType": "TruckLoad",
"shipmentStructure": "PalletizedAssortmentCase",
"transportationDetails": {
"transportationMode": "公路",
"billOfLadingNumber": "02440000"
},
"shipmentConfirmationDate": "2019-08-07T19:56:45.632Z",
"shippedDate": "2019-08-07T19:56:45.632Z",
"预计交付日期""2019-08-07T19:56:45.632Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"地址": {
"名称": "ABC电子仓库",
"addressLine1": "DEF第一街",
"城市": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "vendorwarehousecode"
},
"shipToParty": {
"partyId": "amzwarehousecode"
},
"shipmentMeasurements": {
"货物总重量": {
"unitOfMeasure": "公斤",
"值": "250"
},
"装运量": {
"unitOfMeasure": "立方英尺",
"值": "2.4"
},
"palletCount": 2
},
"shippedItems": [
{
" itemSequenceNumber": "001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"金额": 100,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
},
{
"itemSequenceNumber": "002",
"vendorProductIdentifier": "9782700001000",
"shippedQuantity": {
"金额": 400,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": "001",
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAAAA",
"lotNumber": "1045",
"最高零售价": {
"currencyCode": "EUR",
"金额": "89.00"
},
"handlingCode": "超大尺寸"
}
},
{
"itemReference": "002",
"发货数量": {
"数额": 100,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACC",
"lotNumber": "1087",
"最高零售价": {
"currencyCode": "EUR",
"金额": "120.00"
},
"handlingCode": "超大尺寸"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698999"
}
],
"cartonSequenceNumber": "002",
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"最高零售价": {
"currencyCode": "EUR",
"金额": "89.00"
},
"handlingCode": "超大尺寸"
}
},
{
"itemReference": "002",
"发货数量": {
"数额": 100,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"最高零售价": {
"currencyCode": "EUR",
"金额": "120.00"
},
"handlingCode": "超大尺寸"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698669"
}
],
"cartonSequenceNumber": "003",
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"最高零售价": {
"currencyCode": "EUR",
"金额": "89.00"
},
"handlingCode": "超大尺寸"
}
},
{
"itemReference": "002",
"发货数量": {
"数额": 100,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"最高零售价": {
"currencyCode": "EUR",
"金额": "120.00"
},
"handlingCode": "超大尺寸"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666697799"
}
],
"cartonSequenceNumber": "004",
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"最高零售价": {
"currencyCode": "EUR",
"金额": "89.00"
},
"handlingCode": "超大尺寸"
}
},
{
"itemReference": "002",
"发货数量": {
"数额": 100,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"最高零售价": {
"currencyCode": "EUR",
"金额": "120.00"
},
"handlingCode": "超大尺寸"
}
}
]
}
],
"托盘"[
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098745"
}
],
"层级": 1,
"块": 2,
"尺寸": {
"长度": "1.2",
"宽度": "0.8",
"高度": "1",
"unitOfMeasure": "英寸"
},
"重量": {
"unitOfMeasure": "Kg",
"值": "55"
},
"cartonReferenceDetails": {
"cartonCount": 2,
"cartonReferenceNumbers": [
"001",
"002"
]
}
},
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098700"
}
],
"层级": 1,
"块": 2,
"尺寸": {
"长度": "1.2",
"宽度": "0.8",
"高度": "1",
"unitOfMeasure": "英寸"
},
"重量": {
"unitOfMeasure": "Kg",
"值": "55"
},
"cartonReferenceDetails": {
"cartonCount": 2,
"cartonReferenceNumbers": [
"003",
"004"
]
}
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
# 小于卡车装载量的装运与托盘化的标准箱
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "原始",
"shipmentType": "LessThanTruckLoad",
"shipmentStructure": "PalletizedStandardCase",
"transportationDetails": {
"transportationMode": "公路",
"billOfLadingNumber": "02440000"
},
"shipmentConfirmationDate": "2019-08-07T19:56:45.632Z",
"shippedDate": "2019-08-07T19:56:45.632Z",
"预计交付日期""2019-08-07T19:56:45.632Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"地址": {
"名称": "ABC电子仓库",
"addressLine1": "DEF第一街",
"城市": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "vendorwarehousecode"
},
"shipToParty": {
"partyId": "amzwarehousecode"
},
"shipmentMeasurements": {
"货物总重量": {
"unitOfMeasure": "公斤",
"值": "120.45"
},
"出货量": {
"unitOfMeasure": "CuFt",
"值": "2.4"
},
"palletCount": 1
},
"shippedItems": [
{
" itemSequenceNumber": "001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"金额": 100,
"unitOfMeasure": "Eaches",
"单位大小": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAAAA",
"lotNumber": "1045",
"最高零售价": {
"currencyCode": "EUR",
"金额": "299.00"
},
"handlingCode": "超大尺寸"
}
}
],
"纸箱": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": "001",
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666699999"
}
],
"cartonSequenceNumber": "002",
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666696666"
}
],
"cartonSequenceNumber": "003",
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666697777"
}
],
"cartonSequenceNumber": "004",
"项目": [
{
"itemReference": "001",
"shippedQuantity": {
"数额": 25,
"unitOfMeasure": "Eaches",
"单位大小": 1
}
}
]
}
],
"托盘"[
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098745"
}
],
"级别": 2,
"块": 2,
"尺寸": {
"长度": "1.2",
"宽度": "0.8",
"高度": "1",
"unitOfMeasure": "英寸"
},
"重量": {
"unitOfMeasure": "Kg",
"值": "120.45"
},
"cartonReferenceDetails": {
"cartonCount": 4,
"cartonReferenceNumbers": [
"001",
"002",
"003",
"004"
]
}
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
# 什么是供应商支付API?
使用Vendor Payments API,供应商可以与亚马逊交换付款相关的文件. Submit Invoices API让供应商为确认和发货的订单向亚马逊发送供应商发票.
包括以下操作
操作 | HTTP方法 | 路径 | 描述 |
---|---|---|---|
submitInvoices (opens new window) | POST | /vendor/payments/v1/invoices | 提交一张或多张供应商的发票给Amazon |
注意:submitInvoices操作可用于提交欧洲的信用票据.
# 提交发票
# Usage
submitInvoices (opens new window)操作让供应商提交供应商发票,要求亚马逊为已发货的商品付款.使用此API,供应商可以在一次API调用中提交多张发票.
商品只有在确认并运送到亚马逊后才能开具发票.否则发票将被拒绝.
信息正确的发票将由亚马逊处理,不需要任何人工干预,这意味着供应商可以更快地收到付款.
信息不正确的发票将在亚马逊的收款人系统中被拒绝,所以发送正确的信息是很重要的.参见业务需求部分,了解如何创建具有正确信息的发票.
# 提交发票的平行测试
供应商在开始使用提交发票API进行付款处理之前,需要完成与我们的支付系统的平行测试.当供应商开始使用API发送发票时,平行测试阶段开始.在平行测试阶段供应商为所有发货的订单同时发送纸质和API发票. 供应商需要进行平行测试,直到至少5到10个EDI发票文件的内容得到验证. 平行测试是用生产PO和发票进行的. 平行测试完成后,亚马逊AP团队会与您联系或者如果你的发票有任何内容上的差异. 当供应商收到电子邮件说平行测试已经完成,他们不再需要发送纸质发票. 从那一刻起,他们可以通过使用API发送发票来处理他们的付款.
# 对成功提交的发票进行验证
交易状态API不显示发票处理的实际状态,只显示提交发票的语义验证状态. 供应商可以通过 "Vendor Central > Payments > Invoices". 关于如何使用交易状态API的更多信息,请参考交易状态的业务用例文档. 允许系统在提交后最多需要15分钟来显示原始/更新版本. 如果Vendor Central没有显示更新发票的正确值,请在Vendor Central打开一个 "联系我们 "案例.
下图显示了为已确认并已发货的订单提交发票时的整合工作流程.
# Business Requirements
- 发票号码必须是唯一的,而且绝对不能重复使用(即使是一年之后).
-如果通过API发送的发票由于数据不正确而失败,但纸质发票有正确的数据,那么供应商应该通过API用正确的数据更新它,使用相同的发票ID.
如果一张发票有不正确的数据(纸质和API),那么这张发票就会被取消,应该用新的**发票ID.**发送一张新的发票
不应发送总金额=0的发票,因为这将导致发票失败.**
亚马逊要求在地址段中提供完整的地址信息,以符合税收规定. 这对账单-收件人尤其重要. 对于这个段,亚马逊收款人系统要求精确匹配.
发票中发送的付款条件应与与亚马逊买家商定的付款条件一致.
项目产品标识符应与匹配的采购订单中发送给供应商的订单项目产品标识符相匹配.
-发票上的总金额应等于项目、费用和补贴的总和.
-每一行的**税额总和必须等于页眉一级的税额总和.
- 发票的总数量应与所有项目的数量之和一致.
-每个不同的费和津贴都必须在抬头层逐项列出(例如运费、包装费、小额订购费等等.)
# 国家具体业务要求
Functionality | 印度 | 欧洲 | North America | |
---|---|---|---|---|
发票类型 | 发票类型 "CreditNote "不被支持.发票类型应该总是 "Invoice". | 支持发票类型 "Invoice "和 "CreditNote".供应商需要发送相应的发票类型. | 不支持发票类型 "CreditNote".发票类型应始终为 "Invoice". | |
信用票据参考 | 没有使用 | 如果发票类型是 "CreditNote". | ,供应商需要在项目层面发送这些参考信息未使用 | |
日期 | 必须是 "现在 "或之前. | 必须是 "现在 "或在. | 之前必须是 "现在 "或在. | 之前|
HSN号码 | HSN代码对于符合税法的发票是强制性的.允许的最大长度是8个字符. | 未使用 | 未使用 | 未使用 |
在行和头一级的税收类型 | 以下是允许的税收类型
如果没有提供税务信息,发票会被拒绝. | 要发送的税种. | 未使用 | |
税务登记号码 | 必须提供一个15个字符的GST ID. | VAT号码 | VAT号码 | |
在行和头一级的税收细节 | 如果一个项目适用多个税种,则必须多次发送税收详情部分,并为该项目提供适当的税收类型.
同样适用于发票的总金额. | 如果一个项目适用多个税种,则必须多次发送税收明细部分,并为该项目设置适当的税种.
这同样适用于发票的总金额. 还有一个额外的税种叫做 "国内增值税",它可以用来提交当地货币的税额.为了处理国内增值税,你必须使用与 "增值税 "税种相同的税率. | 如果一个项目适用多个税种,则必须多次发送税收详情部分,并为该项目提供适当的税收类型.
同样适用于发票的总金额. | |
返还给当事人 | 向亚马逊提供货物并将获得付款的一方.也叫供应商. | 税收和地址的详细信息(vendor)一方,他将收到已发货的物品(在发票的情况下)或退回的物品(在信用证的情况下).这是 required. | 将收到已发货物品的付款的(供应商)一方的税务和地址详情.这是 required. | |
发货方 | 寄件人地址的详细信息,以及国家ISO代码.
GST ID必须在税务登记号码中发送.Ship From Party是必须的.数值应该与亚马逊系统中的数值相匹配. | 供应商代码或仓库代码以及物品发运方的地址. | 供应商代码或仓库代码以及物品发运方的地址. | |
发货方 | 发货地址的详细信息以及国家ISO代码.发货方是必需的.
数值应与亚马逊系统中的数值相符. | 亚马逊的ID或仓库代码以及物品将被运往的一方的地址. | 亚马逊的ID或仓库代码以及物品将被运往的一方的地址. | |
Bill To Party | Bill to Party是必需的.它可能与Ship to party相同.如果是这样,供应商需要在两个部分发送相同的信息. | 税收和地址的详细信息(亚马逊)将对已发货的物品(在发票的情况下)或退回的物品(在信用证的情况下).进行结算的一方
这个字段是 required. | 税收和地址的详细信息(亚马逊)谁将会对已发货的物品发出账单.
这个字段是 required. | |
亚马逊产品标识符和外部产品标识符 | 这些值中至少有一个是必须的.标识符必须与订单中收到的相同. | 这些值中至少有一个是必需的.标识符必须与订单中收到的相同. | 这些值中至少有一个是必须的.标识符必须与订单中收到的相同. | |
净成本 | 这个字段是 required. | 这个字段是 required. | 这个字段是 required. | |
采购订单编号 | 一张发票只能包含一张订单的信息.因此,一张发票中的所有项目的PO号码应该是相同的.
Required. | 一张发票可以有多个订单的信息.不同的行项目应发送相应的PO号码.如果发票类型是 "发票",这个字段是required,当发票类型是 "CreditNote "时不使用. | 一张发票可以有多个订单的信息.对于不同的行项目,应该相应地发送PO号码.
Required. | |
Additional Details | 未使用 | 该字段用于销售方为特殊目的提交额外的细节.例如,在波兰语分批付款发票的情况下,销售方必须发送类型为 "SUR"、语言代码为 "PL "的细节 "mechanizm podzielonej płatności". | 未使用 | |
referenceNumber | 由印度政府为每张发票生成的唯一的发票参考号码.该字段仅对印度的发票是强制性的. | 未使用 | 未使用 | 未使用 |
# 信用票据
提交发票API允许供应商向亚马逊发送信用票据.信用票据列出了供应商提供给亚马逊的产品或服务的产品、数量和约定的价格,而亚马逊退回或没有收到它.它可以在货物损坏或价格错误的情况下发出,而亚马逊和供应商之间事先约定了津贴或回扣.
# 亚马逊支持的信用票据
应付账款(AP)信用证 | 应收账款(AR)应收票据_ |
---|---|
PQV信贷 对已开票但未收到的项目进行信贷,或对重复付款进行信贷. | 退货 因货物损坏、货物发错、库存过多等原因而退回给供应商的物品的贷项. |
PPV信贷 对以较高/较低费用开具的项目进行抵扣. | COOP (价格保护,损坏津贴等.) COOP 供应商为销售其产品或为价格保护协议而向亚马逊支付的信用额度. |
Credits for freight 空运、陆运或海运货物所支付的费用. |
注意不是所有的市场都支持信用证.
# 提交发票用例
# 有多个无税项目的发票
{
"Invoices": [
{
"invoiceType": "Invoice",
"id": "I5599913",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"地址": {
"名称": "VENDORNAME",
"addressLine1": "PO BOX 1234",
"城市": "SAN RAFAEL",
"stateOrRegion": "CA",
"postalOrZipCode": "60693",
"countryCode": "美国"
}
},
"shipToParty": {
"partyId": "AMAZON",
"地址": {
"name": "amazon.com",
"addressLine1": "500 mccarthy dr",
"addressLine2": "fairview business park",
"城市": "LEWISBERRY",
"stateOrRegion": "PA",
"postalOrZipCode": "17339",
"countryCode": "美国"
}
},
"billToParty": {
"partyId": "AMAZON",
"地址": {
"name": "amazon.com",
"addressLine1": "500 mccarthy dr",
"addressLine2": "fairview business park",
"addressLine3": "string",
"城市": "LEWISBERRY",
"stateOrRegion": "PA",
"postalOrZipCode": "17339",
"countryCode": "美国"
}
},
"paymentTerms": {
"类型": "基本",
"discountPercent": "2.00",
"discountDueDays": 30,
"netDueDays": 31
},
"发票总额": {
"currencyCode": "USD",
"金额": "1295"
},
"项目": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "040YP0U",
"invoicedQuantity": {
"金额": 2,
"unitOfMeasure": "案例",
"单位大小": "10"
},
"netCost": {
"currencyCode": "USD",
"金额": "140"
},
"purchaseOrderNumber": "S8672793"
},
{
" itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435"
"vendorProductIdentifier": "0264CBS",
"invoicedQuantity": {
"金额": 5,
"unitOfMeasure": "案例",
"单位大小": "10"
},
"netCost": {
"currencyCode": "USD",
"数额": "125"
},
"purchaseOrderNumber": "S8672793"
},
{
" itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436"
"vendorProductIdentifier": "040YP0K",
"invoicedQuantity": {
"金额": 3,
"unitOfMeasure": "案例",
"单位大小": "5"
},
"netCost": {
"currencyCode": "USD",
"金额": "130"
},
"purchaseOrderNumber": "S8672793"
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
# 一个项目的单项税的发票
{
"Invoices": [
{
"invoiceType": "Invoice",
"id": "5002841638",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"地址": {
"名称": "VENDORNAME",
"addressLine1": "PO BOX 1234",
"城市": "TORONTO",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5"
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "增值税",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONCA",
"地址": {
"name": "AMAZON CANADA",
"addressLine1": "500 mccarthy dr",
"addressLine2": "fairview business park",
"城市": "MISSISSAUGA",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
}
},
"billToParty": {
"partyId": "AMAZONCA",
"地址": {
"name": "AMAZON CANADA",
"addressLine1": "500 mccarthy dr",
"addressLine2": "Fairview Business Park",
"addressLine3": "string",
"城市": "MISSISSAUGA",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "增值税",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"类型": "基本",
"netDueDays": 31
},
"发票总额": {
"currencyCode": "CAD",
"金额": "1950"
},
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"金额": "97.5"
},
"taxableAmount": {
"currencyCode": "CAD",
"金额": "1950"
}
}
],
"项目": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "1012380100000",
"invoicedQuantity": {
"金额": 4,
"unitOfMeasure": "数量": 4
},
"netCost": {
"currencyCode": "CAD",
"金额": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"金额": "1.00"
}
}
]
},
{
" itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435"
"vendorProductIdentifier": "1000570100000",
"invoicedQuantity": {
"金额": 30,
"unitOfMeasure": "数量": 30
},
"netCost": {
"currencyCode": "CAD",
"金额": "50.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"金额": "2.50"
}
}
]
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436"
"vendorProductIdentifier": "0543900100000",
"invoicedQuantity": {
"金额": 3,
"unitOfMeasure": "数量": 3
},
"netCost": {
"currencyCode": "CAD",
"数额": "90"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"金额": "4.50"
}
}
]
},
{
"itemSequenceNumber": 4,
"amazonProductIdentifier": "ABC123437"
"vendorProductIdentifier": "1000570200000",
"invoicedQuantity": {
"金额": 5,
"unitOfMeasure": "数量": 5
},
"netCost": {
"currencyCode": "CAD",
"金额": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"金额": "1.00"
}
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
# 一个项目有多种税的发票
{
"Invoices": [
{
"invoiceType": "Invoice",
"id": "8900000001234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ123",
"地址": {
"name": "xyz india private limited",
"addressLine1": "4TH FLOOR",
"城市": "GURUGRAM",
"stateOrRegion": "HR",
"postalOrZipCode": "122002",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "增值税",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"地址": {
"name": "AMAZON INDIA",
"addressLine1": "Chowranghee Mansion JN Road",
"城市": "Kolkata",
"stateOrRegion": "WB",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ123",
"地址": {
"name": "xyz retail pvt ltd",
"addressLine1": "Chowranghee Mansion JN Road",
"城市": "Kolkata",
"stateOrRegion": "WB",
"postalOrZipCode": "700016",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"地址": {
"name": "AMAZON INDIA",
"addressLine1": "Arrjaw Industrial & Warehouse Park",
"addressLine2": "靠近印度煤业公司"
"城市": "Hooghly",
"stateOrRegion": "WB",
"postalOrZipCode": "712310",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "增值税",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"类型": "基本",
"netDueDays": 30
},
"发票总额": {
"currencyCode": "INR",
"金额": "258262.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "218866.43"
}
}
],
"项目": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809000-0000",
"invoicedQuantity": {
"金额": 2,
"unitOfMeasure": "数量": 2
},
"netCost": {
"currencyCode": "INR",
"金额": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.90",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "21060.34"
}
}
]
},
{
" itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435"
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"金额": 3,
"unitOfMeasure": "数量": 3
},
"netCost": {
"currencyCode": "INR",
"金额": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T"
"hsnCode": "76.06.92.91",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "58915.25"
}
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
# 带头层和行层津贴/收费细节的发票,含税
{
"Invoices": [
{
"invoiceType": "Invoice",
"id": "0136981234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ12345",
"地址": {
"name": "xyz india private limited",
"addressLine1": "4TH FLOOR",
"城市": "GURUGRAM",
"stateOrRegion": "HR",
"postalOrZipCode": "122002",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "增值税",
"taxRegistrationNumber": "VENDORVATID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"地址": {
"name": "AMAZON INDIA",
"addressLine1": "Chowranghee Mansion JN Road",
"城市": "Kolkata",
"stateOrRegion": "WB",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ12345",
"地址": {
"name": "xyz retail pvt ltd",
"addressLine1": "Chowranghee Mansion JN Road",
"城市": "Kolkata",
"stateOrRegion": "WB",
"postalOrZipCode": "700016",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"地址": {
"name": "AMAZON INDIA",
"addressLine1": "Arrjaw Industrial & Warehouse Park",
"addressLine2": "靠近印度煤业公司"
"城市": "Hooghly",
"stateOrRegion": "WB",
"postalOrZipCode": "712310",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "增值税",
"taxRegistrationNumber": "AMAZONVATID"
}
]
},
"paymentTerms": {
"类型": "基本",
"discountPercent": "5",
"discountDueDays": 15,
"netDueDays": 30
},
"发票总额": {
"currencyCode": "INR",
"金额": "259678.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "218866.43"
}
}
],
"chargeDetails": [
{
"类型": "运费",
"描述": "货运费用"
"chargeAmount": {
"currencyCode": "INR",
"金额": "1200.00"
},
"taxDetails": [
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"金额": "字符串"
}
},
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"金额": "字符串"
}
}
]
}
],
"项目"[
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809281-5100",
"invoicedQuantity": {
"金额": 2,
"unitOfMeasure": "数量": 2
},
"netCost": {
"currencyCode": "INR",
"金额": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.93",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "21060.34"
}
}
],
"chargeDetails": [
{
"类型": "运费",
"描述": "货运费用"
"chargeAmount": {
"currencyCode": "INR",
"金额": "600.00"
}
}
]
},
{
" itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435"
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"金额": 3,
"unitOfMeasure": "数量": 3
},
"netCost": {
"currencyCode": "INR",
"金额": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"金额": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"金额": "58915.25"
}
}
],
"chargeDetails": [
{
"类型": "运费",
"描述": "货运费用"
"chargeAmount": {
"currencyCode": "INR",
"金额": "600.00"
}
}
]
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
# 欧盟含税信用证
{
"发票": [
{
"invoiceType": "CreditNote",
"id": "BasicCredit",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "AMAZON",
"地址": {
"name": "amazon eu sarl, uk branch",
"addressLine1": "1 principal place worship street",
"城市": "LONDON",
"postalOrZipCode": "EC2A 2FA",
"countryCode": "GB"
}
},
"billToParty": {
"partyId": "VendorCode",
"地址": {
"名称": "供应商名称",
"addressLine1": "供应商地址",
"城市": "供应商城市",
"stateOrRegion": "供应商州",
"postalOrZipCode": "供应商邮政编码",
"countryCode": "供应商国家"
}
},
"发票总额": {
"currencyCode": "GBP",
"金额": "100"
},
"taxDetails": [
{
"taxType": "增值税",
"taxRate": "10",
"taxAmount": {
"currencyCode": "GBP",
"金额": "10.00"
},
"taxableAmount": {
"currencyCode": "GBP",
"金额": "100.00"
}
}
],
"项目": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "TESTSKU",
"invoicedQuantity": {
"金额": 1,
"unitOfMeasure": "案例",
"单位大小": "10"
},
"netCost": {
"currencyCode": "GBP",
"数额": "100"
},
"creditNoteDetails": {
"referenceInvoiceNumber": "test-basic-ref",
"debitNoteNumber": "debit-ref",
"returnsReferenceNumber": "return-ref",
"goodsReturnDate": "2019-07-24T21:17:59.821Z",
"rmaId": "rma-ref",
"consignorsReferenceNumber": "VRET-ref"
}
}
]
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
# 什么是供应商交易状态API?
供应商可以使用这个API来检查他们的POST交易的交易状态.
包括以下操作
| 操作 | HTTP方法 | 路径 | 描述 | **说明 |------------------------|-----------------|-----------------------------------------------------------|-------------------------------------------| | getTransaction | GET | /vendor/transactions/v1/transactionStatus/{transactionId}| 获取交易后请求的状态. |
# 获取交易状态
# Usage
供应商可以使用这个API来检查POST交易的状态.当一个交易,如订单确认或发货确认,使用API发布到亚马逊,响应包括一个交易标识符,唯一标识交易.亚马逊将异步处理交易,最终响应将通过[getTransaction](https获得 //spapi.cyou/zh/references/vendor-transaction-status-api-v1-reference.html#get-vendortransactionsv1transactionstransactionid)操作.见个别API章节中相应的整合工作流程图(i.e.供应商订单供应商发货等.)以了解何时调用此API以获得交易状态.
亚马逊通过此API提供POST API交易的最终处理状态,如订单确认和发货确认.我们强烈建议供应商使用此API检查状态,以确保他们的交易被成功处理.如果发生错误,响应将包含错误信息.然后你可以纠正交易并重新提交.
| 交易状态 | 定义 | |------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------_6 | 处理中 | 亚马逊收到了该API交易,正在进行处理. 处理尚未完成. 检查每个API操作的SLA,了解完成处理的预期时间. | | Success | 该API事务被亚马逊成功处理. 目前不支持这种状态,但将来会支持. | | Failure | API交易在处理过程中失败了. 错误细节将在交易状态响应体中提供. |
注意以下的API操作支持交易状态
-确认订单
- 提交发货确认书
交易状态目前只支持 "处理中 "和 "失败 "的状态值.如果交易状态是 "处理中",并且在15分钟后没有更新为 "失败",这表明交易已经在我们的系统中成功处理.未来将支持 "成功 "状态.
当状态为 "处理中 "时,通常被认为是在我们的终端成功交付. 如果由于任何原因,Vendor Central的状态在发送消息30分钟后没有更新,请通过提供POST调用中返回的交易ID,使用Vendor Central打开一个支持案例. 请在打开案例前确保提交的数据格式正确.
你不能对 "发票 "信息使用这个API,因为它们不被支持,而且状态将永远是 "处理中". 对于任何与付款有关的查询,首先在Vendor Central检查,然后在Vendor Central创建一个 "联系我们 "案例,并选择相关队列.
# 交易状态用例
# 交易正处于处理状态
{
"payload": {
"transactionStatus": {
"transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477",
"状态""处理中"
}
}
}
### 交易已成功处理
交易发布后15分钟内一直处于处理状态.
```json
{
"payload": {
"transactionStatus": {
"transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477",
"状态""处理中"
}
}
}
### 交易在亚马逊失败了
```json
{
"payload": {
"transactionStatus": {
"transactionId": "20190908091302-6ca0ac50-d06e-45f5-a1e2-eb448eadac50",
"状态""失败"
"错误"[
{
"代码": "invalid_order_id"
"消息": "无效的订单ID."
}
]
}
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44