[20106611] 【ERP】订单系统》B2W平台对接，拉取订单对接订单字段
状态：已发布 ｜ 创建：2021-04-12 16:25:00 ｜ 完成：2021-06-03 04:14:44 ｜ 最后更新：2021-06-03 04:14:44 TAPD链接 ｜ 项目：ERP_需求分析（20106611） 处理人：陈家宜; ｜ 开发： ｜ 创建人：陈家宜 ｜ 优先级：High ｜ 模块：销售-订单管理 ｜ 标签：
原始需求描述
用户场景
对接B2W平台
【产品需求】
1、平台名称：全称：B2W Marketplace。简称：B2W
2、订单拉取对应字段的说明：
对接内容分类 | 系统字段名称 | 对接后实现的功能 | 对应接口字段 | 以订单282769169301为例 | 备注 | 订单明细 | 参考号（平台订单号） | 1.查看（列表+详情） 2.查询 3.导出 | remote_code | 282769169301 | ps：api需要使用code作为订单号 | 买家id | 1.查看（列表+详情） 2.查询 3.导出 | 无 | | | 买家名称 | 1.查看（列表+详情） 2.查询 3.导出 | customer name | Marcelo Seabra Ferreira | | 站点 | 1.查看（详情） 2.导出 3.查询 | 无 | | | email | 1.查看（列表+详情） 2.查询 3.导出 | customer email | 09891368769@email.com.br | | 交易号 | 1.查看（列表+详情） 2.查询 3.导出 | 无 | | | 支付方式 | 1.查看（列表+详情） 2.导出 3.查询 | payments method | DEBIT_CARD | | 订单备注 | 1.查看（列表+详情） 2.导出 | 无 | | | 卖家（店铺账号） | 1.查看（列表+详情） 2.导出 3.店铺账号筛选 | 根据授权取值 | 根据授权取值 | | CPF税号 | 1.查看（详情） | customer vat_number | 09891368769 | 支持更新 | 订单费用 | 总金额 | 1.查看（列表） 2.导出 3.仓配系统的报表 | total_ordered | 221.36 | | 交易额 | 1.查看（列表） 2.导出 3.仓配系统的报表 | total_ordered-shipping_cost | 221.36-0=221.36 | | 运费 | 1.查看（列表） 2.导出 3.仓配系统的报表 | shipping_cost | 0 | | 交易费（成交费） | 1.查看（列表） 2.导出 3.仓配系统的报表 | 无 | | | 手续费 | 1.查看（列表） 2.导出 3.仓配系统的报表 | 无 | | | 其他费用 | 1.查看（列表） 2.导出 3.仓配系统的报表 | 无 | | | 补贴 | 1.查看（列表） 2.导出 3.仓配系统的报表 | 无 | | | 订单时间 | 创建时间 | 1.查看（列表+详情） 2.查询 3.导出 | placed_at | 2021-04-09T03:04:38-03:00 | 零时区转换北京时间 | 付款时间 | 1.查看（列表+详情） 2.查询 3.导出 | approved_date | 2021-04-09T06:09:02 | 零时区转换北京时间 | 发货时间 | 1.查看（列表+详情） 2.查询 3.导出 | delivered_carrier_date | | 零时区转换北京时间 | 收件地址信息 | 收件人 | 1.查看（列表+详情） 2.导出 | shipping_address full_name | Marcelo Seabra Ferreira | | 手机号码 | 1.查看（列表+详情） 2.查询 3.导出 | shipping_address phone | 21 76848490 | | 公司名 | 1.查看（列表+详情） 2.导出 | 无 | | | 收件人国家/地址 | 1.查看（列表+详情） 2.查询 3.导出 | shipping_address country | BR | | 收件人省/州 | 1.查看（列表+详情） 2.查询 3.导出 | shipping_address region | RJ | | 城市 | 1.查看（列表+详情） 2.查询 3.导出 | shipping_address city | Rio de Janeiro | | 邮编 | 1.查看（列表+详情） 2.查询 3.导出 | shipping_address postcode | 20775170 | | 门牌号 | 1.查看（列表+详情） 2.导出 | 无 | | 门牌号不取，拼接到地址1 | 地址1 | 1.查看（列表+详情） 2.导出 | shipping_address neighborhood+street+number+detail | Cachambi Rua Garcia Redondo 67 Ap 402 | | 地址2 | 1.查看（列表+详情） 2.导出 | | 无 | | 平台配送方式 | 1.查看（列表+详情） 2.查询 3.导出 | shipping_carrier | mail_americas_cn | | 跟踪号 | 1.查看（列表+详情） 2.导出 | shipments tracks code | 参考订单：700672726101 GE000091762BR
| | 商品信息 | 商品sku（映射的仓库sku） | 1.查看（列表+详情） 2.查询 3.导出 | items id | EE1467WE00#CXZ4CXZ4uXTk2 | id是子商品id product_id是父商品id | 商品名称 | 1.查看（列表+详情） 2.导出 | items name | Xiaomi Air2 SE TWS Mi True Wireless Bluetooth Fone de ouvido\r\n | | 商品数量 | 1.查看（列表+详情）【商品明细将根据映射关系以仓库sku的维度显示，所以数量也会根据映射关系变化】 2.导出 | items qty | 1 | | 商品链接 | 1.查看（列表+详情） | 无 | | | 商品图片 | 1.查看（列表+详情） | 无 | | | 单价 | 1.查看（列表+详情）【商品明细将根据映射关系以仓库sku的维度显示，所以单价也会根据映射关系变化】 2.导出 | items special_price | 221.36 | | 订单状态映射 | 平台订单状态->系统订单状态 | 订单状态处理 1.未付款-》付款未完成（生成标准单） 2.已经在平台已取消/已退款的不会生成标准单 3.已付款未发货->待发货审核 4.已发货（指已标发）->已发货 无法识别--》冻结中
系统订单更新 1.未付款更新为已付款-》系统状态付款未完成更新为待发货审核 1、未到仓配，取消/退款-》已废弃 2、到了仓配，取消/退款-》问题件 | 见需求 | | |
3、平台状态与系统状态对接说明： 【使用订单状态中字段Type来区分订单】 中台的状态映射是中台处理订单状态后映射的订单状态，在开发过程中可能会有更改，注意和中台沟通。（B2W中台的对接人：刘双力）
Code | Label | Type | Description | 中文解释 | 系统对应状态 | 中台的状态映射 | book_product | NEW - Pagamento Pendente (SkyHub) | NEW | Marketplace orders without payment confirmation. This information is provided by the marketplace itself | 未付款确认 | 1.生成付款未完成状态标准单 | S1; //未付款 | payment_received | Aprovado (SkyHub) | APPROVED | Marketplace orders with payment confirmed. This information is provided by the marketplace itself | 已付款确认 | 1.生成待发货审核状态标准单 2.如果订单状态由book_product更新为payment_received在系统需要更新状态为待发货审核 | S21; //已确认 | order_canceled | Cancelado (SkyHub) | CANCELED | Canceled is the status that the order receives when it has been canceled, either because the customer has given up the purchase or the merchant no longer has the inventory to meet the order. | 取消 | 1.不生成erp系统标准单 2.系统内已有订单状态变成退货则对此单进行截单并且转问题件处理 | S0; //已取消 | order_shipped | Pedido Enviado (SkyHub) | SHIPPED | When the order was delivered to carrier. This information is provided by seller | 已发货 | 已发货 | S4; //已发货 | complete | Completo (entregue) (SkyHub) | DELIVERED | Orders that have already been delivered to the end customer. This information is provided by seller | 妥投 | 已发货 | S41; //已收货 | shipment_exception | Exceção de Entrega (SkyHub) | SHIPMENT_EXCEPTION | This status is applied to the order when for some reason the delivery was not performed. | 出货异常（指订单出现问题不能正常出货，由商家标记的） | 冻结中 | .S2; //待发货 | order_invoiced | Pagamento Faturado (SkyHub) | INVOICED | Orders that have already been billed by the seller. This information is provided by the merchent | 已开发票 | 已发货 | S51; //已开票 | | | RETURNED | 平台表示此状态非默认状态可以不用考虑进行处理 | 退货【仅翻译非准确描述】 | 1.不生成标准单 2.系统内已有订单状态变成退货则对此单进行截单并且转问题件处理 | S90; | | | CONFIRM_STOCK | 平台表示此状态非默认状态可以不用考虑进行处理 | 确认库存【仅翻译非准确描述】 | 1.不生成标准单 | S90; | | | WAITING_PAYMENT | 平台表示此状态非默认状态可以不用考虑进行处理 | 等待付款【仅翻译非准确描述】 | 1.不生成标准单 | S90; | | | HAS_INCIDENT | 平台表示此状态非默认状态可以不用考虑进行处理 | 有事件【仅翻译非准确描述】 | 1.不生成标准单 | S90; | | | OVERDUE | 平台表示此状态非默认状态可以不用考虑进行处理 | 逾期【仅翻译非准确描述】 | 1.不生成标准单 | S90; | | | CONFIRMED_STOCK | 平台表示此状态非默认状态可以不用考虑进行处理 | 已确认库存【仅翻译非准确描述】 | 1.不生成标准单 | S90; | 中台的状态映射代码
if ("NEW".equalsIgnoreCase(status)) { return OrderStatusEnum.S1; //未付款 } else if ("CANCELED".equalsIgnoreCase(status)) { return OrderStatusEnum.S0; //已取消 } else if ("APPROVED".equalsIgnoreCase(status)) { return OrderStatusEnum.S21; //已确认 } else if ("SHIPPED".equalsIgnoreCase(status)) { return OrderStatusEnum.S4; //已发货 } else if ("DELIVERED".equalsIgnoreCase(status)) { return OrderStatusEnum.S41; //已收货 } else if ("INVOICED".equalsIgnoreCase(status)) { return OrderStatusEnum.S51; //已开票 } else if ("SHIPMENT_EXCEPTION".equalsIgnoreCase(status)) { return OrderStatusEnum.S2; //待发货 } return OrderStatusEnum.S90;