日本雅虎API电商接口获取方法 批量发布、订单获取、后台操作等

日本电商起步比较早，现雅虎在日本排名第三。

跨境电商在我国迅猛发展，很多商家都会选择入驻日本雅虎。很多国内跨境电商都是依赖第三方平台对接雅虎商城，

自身对接商城需要费很大的力气。国内对yahoo api对接很少言及，主要是yahoo语言影响，yahoo jp只提供日文版本，各方面的资料能借鉴的比较少。

对接yahoojp shop webapi 会遇到很多坑， 而且yahoo 的api很生涩，没有REST的api提供。

主要步骤如下:

1. 首先是要有一个商家账号id,https://pro.store.yahoo.co.jp/,登录进入商家后台。

2.yahoo的账号是基于yconnect，开发者id可以共用商家id，进入开发者平台https://developer.yahoo.co.jp/

3.创建一个应用ID，获取到key和secret

4.通过yconnect生产acces_token

5.为了获取order列表，需要提交查询订单api的权限，这个审批需要一周的时间

https://developer.yahoo.co.jp/webapi/shopping/

上传API是直接put上csv的，所以必须要生成自己的csv文件再进行提交。

产品上传示例代码：

<?php

$header = [
    'Content-Type: multipart/form-data',
    'POST /ShoppingWebService/V1/uploadItemFile?seller_id=＜ストアアカウント＞ HTTP/1.1',
    'Host: circus.shopping.yahooapis.jp',
    'Authorization: Bearer ' . ＜アクセストークン＞
];

$url   = 'https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/uploadItemFile?seller_id=＜ストアアカウント＞';
$param = array(
            'file' => new CURLFile('＜商品csvのファイルパス＞'),
            'type' => '4'
         );

// 必要に応じてオプションを追加してください。
$ch = curl_init();
curl_setopt($ch, CURLOPT_CUSTOMREQUEST,  'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER,     $header);
curl_setopt($ch, CURLOPT_URL,            $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST,           true);
curl_setopt($ch, CURLOPT_POSTFIELDS,     $param);

$response = curl_exec($ch);
curl_close($ch);

?>

产品上传API：商品アップロードAPI - Yahoo!デベロッパーネットワークYahoo! JAPANの日本語処理や地図、ID連携といった技術は、簡単にお客様のWebサイトに組み込むことができます。Yahoo!デベロッパーネットワークではそのためのWeb APIやSDKを提供しています。https://developer.yahoo.co.jp/webapi/shopping/uploadItemFile.html

日文版：

パラメータ	値	説明
seller_id （必須）	string	ストアアカウントを指定します。 GETパラメータで渡してください。
file （必須）	multipart/form-data	商品CSVファイルを指定します。 ※オプションCSV等はアップロードできません。 ファイルフォーマットはこちら
type （必須）	integer	アップロードタイプを指定します。 1: 追加 2: 上書き 3: 削除 4: 項目指定

中文版：

参数	价值	解释
卖家 ID （必填）	细绳	指定商店帐户。 请将其作为 GET 参数传递。
文件 （必填）	多部分/表单数据	指定产品 CSV 文件。 * 无法上传可选的 CSV 等。单击此处查看 文件格式
类型 （必填）	整数	指定上传类型。 1：添加 2：覆盖 3：删除 4：项目说明

关于上传类型

• 【新增】
  上传的商品将添加到店铺中已注册的现有商品中。
  如果商店中当前注册了产品数据，则更新信息将被覆盖。
  如果您删除字段并上传数据，删除的字段部分的数据将被删除，因此如果您只想
  更新已注册产品数据的某些项目，请使用项目规范上传。
• [覆盖]
  商店中当前注册的所有产品信息将被删除，仅替换为上传的产品数据。
  作为预防措施，建议在执行覆盖操作之前保留备份数据。
• [删除]
  从商店中删除上传的数据库文件中包含的产品数据。
  * 如果您删除产品，“图片管理”的产品图片文件夹中的产品图片和产品详细图片也将被删除。
• 【项目说明】
  仅更改要上传的数据库文件中包含的产品数据的指定字段。

产品CSV 格式：

csv文档格式在最后

如果找不到csv格式可以参考 文章尾部

日本雅虎乐天商城批量上传步骤_Past-CSDN博客日本雅虎商城批量上传步骤(网站后台直接上传)：雅虎商城后台登录链接：https://business.yahoo.co.jp/1. 用黑谍宝贝复制软件采集完宝贝后，在软件主界面点出商品列表，再点图片搬家，选择搬至本地。2. 导出日本雅虎商城格式的CSV数据包，软件会生成三个CSV文件与一个文件夹。注意导出雅虎商城CSV时需要输入账号，但不是登录的账号，而是链接引用的账号，位置下面有图片指出。导出的CSV如: 文件夹名为"yahoojp_20200707015644"，三个CSV文件名为.https://biquge.blog.csdn.net/article/details/122338672
请务必使用

CSV 格式作为文件格式。

アップロードフォーマット - Yahoo!デベロッパーネットワークYahoo!デベロッパーネットワークはクリエイターの皆さんとYahoo! JAPANの技術をつなげるポータルサイトです。Yahoo! JAPANが提供するWeb APIやOSS、ソフトウエア開発に役立つ最新情報をお届けします。https://developer.yahoo.co.jp/webapi/shopping/upload_format.html

• 确保在数据的第一行输入正确的字段名称（半角字母数字字符）。如果您省略字段名称或输入您自己的字段，则会发生错误。
• 不能输入半角假名、特殊符号和机器相关字符。此外，请注意每个项目可以输入的字符类型不同。
• 在有限的字符数内输入每个项目。
• 将换行代码转换为 CR / LF 或 LF。
• 请务必将字符代码转换为 EUC 代码或 shift-JIS 代码。
• 在上传之前，请确保您的数据不包含任何不需要的换行符或空格。使用显示字符控制代码的文本编辑器（例如 MK 编辑器）很容易检查。

• 请注意

• 只能上传产品 CSV 和库存 CSV 文件。无法上传选项 CSV 等。
• 上传限制为 100,000。

最多 5,000 个全角字符（10,000 个半角字符），允许使用 HTML
额外2	可用空间	输入产品的补充说明	最多 5,000 个全角字符（10,000 个半角字符），允许使用 HTML
额外3	可用空间	输入产品的补充说明	最多 5,000 个全角字符（10,000 个半角字符），允许使用 HTML
相关链接	特色产品	输入推荐产品的产品代码，在产品页面显示	产品代码之间用半角空格隔开
			最多可以指定 20 个产品。只有半角数字。99个单字节字符以内
船重	重量	运输/装卸计算中使用的重量单位	只有半角数字。最多 7 个单字节数字
应税	应税	指定商品的含税/免税	只有半角数字。输入 1 或 0	输入税收：1 和免税：0。如果留空，则为“税”
税率类型	降低税率代码	指定产品是否为减税产品	仅单字节字母数字字符。输入 0.1 或 0.08	正常税率 10%: 0.1 降低税率 8%: 0.08 * 如果空白，正常税率 10%
发布日期	发布日期	产品发布日期（仅用于积分和订单管理）	只有半角数字。YYYYMMDD 格式	可在当前日期起 240 天内设置[示例] 20071001（2007 年 10 月 1 日）
临时点	临时积分期	为产品设置临时积分期限	只有半角数字。输入 14-60	如果留空，则将应用商店管理器中设置的时间段。
点码	点放大	指定产品的点放大率时输入点代码值	仅单字节字母数字字符。	Yahoo! Shopping 提供了代码。如果您输入它，放大倍率将优先于存储点应用。见底部的这个页面的点码列表。
元键	元关键字	产品关键词	80个全角字符以内（160个半角字符）
			关键字之间的半角竖线 (|) 分隔符
元描述	元描述	产品描述	80个全角字符以内（160个半角字符）
字段名称	商品编辑页面上的商品名称	解释	输入法	评论	搜索目标
展示	页面发布	进入公共/私人页面	只有半角数字。输入 1 或 0	为公共输入 1，为私有输入 0。如果为空，则为“公开”
模板模板	使用中的模板	指定模板	仅单字节字母数字字符。4个字符以内	在“产品页面模板设置”页面输入模板名称后显示的字符串 [示例] 如果显示模板名称（IT01），则输入“IT01”
销售期开始	销售期间（开始日期）	销售开始日期和时间	只有半角数字。YYYYMMDDHHMM 格式	【例1】2007100115（2007年10月1日下午3点） 【例2】200710011520（2007年10月1日下午3点）
销售期末	销售期间（结束日期）	销售结束日期和时间	只有半角数字。YYYYMMDDHHMM 格式	[例1] 2007100810（2007年10月8日上午10:00） [例2] 200710081020（2007年10月8日上午10:20）
限售	购买限额	输入购买数量限制	只有半角数字。输入 1 到 999
代码	促销代码	活动代码	仅单字节字母数字字符。10个字符	Yahoo! Shopping 提供代码
品牌代码	品牌代码	输入您的品牌代码	只有半角数字。10个字符以内	Yahoo! Shopping 提供代码
雅虎产品代码	雅虎购物产品代码	输入您的 Yahoo! Shopping 产品代码	仅单字节字母数字字符。32 个字符或更少	Yahoo! Shopping 提供代码
产品代码	产品代码	输入产品制造商部件号/型号	只有单字节字母数字和符号（  +-* / () &: ~~. @!#? _）。50字以内		●
简	JAN 代码 / ISBN 代码	输入 JAN 代码 / ISBN 代码	只有半角数字。13个字符以内		●
交货	免运费	免运费设置	只有半角数字。输入 0、1 或 3。	无（如果运费）：0，免费：1，有条件的免费送货：3 如果空白，请输入“无” *“包括运费：2”已于 2013 年 9 月 18 日（星期三）取消..
询问码	今天明天	交割日 “今日到达” 次日递 “Asutsuku”的设置	只有半角数字。 输入 0、1 或 2。	不支持：0　 明天的支持：1　 今天的支持：输入 2 如果为空，“不支持”
条件条件	产品状况	产品状态设置	只有半角数字。 输入 0 或 1。	0：全新 1：二手（* 除非您注册了古董许可证，否则不能设置为已使用） 2：全新：雅虎拍卖联合拍卖 　　* 雅虎拍卖联合拍卖计划有限 3：二手：未使用 4：二手：几乎未使用 5：二手：无明显划痕或污渍 6：二手：轻微划痕或脏污 7：二手：有划痕或污渍 8：二手：总体状况不佳 如果空白，“新”
产品分类	产品分类	输入产品类别	只有半角数字。10个字符以内	Yahoo! Shopping 提供代码
规格1	规格	输入规格项目和规格值	仅输入半角数字，用竖线 (|) 分隔项目和值。每个字符在 10 个字符以内 * 2015 年 10 月 1 日之后的规格 仅限半角 数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供的代码 [示例] 84 | 461（规格商品代码为 84，规格价值代码为 461） * 2015 年 10 月 1 日之后的规格 [示例] 84 | 461: 51 1:193 (规格) 商品代码为 84 , 规格值代码是 461, 511, 193)
规格2	规格	输入规格项目和规格值	仅输入半角数字，用竖线 (|) 分隔项目和值。每个字符在 10 个字符以内 * 2015 年 10 月 1 日之后的规格 仅限半角 数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供的代码 [示例] 84 | 461（规格商品代码为 84，规格价值代码为 461） * 2015 年 10 月 1 日之后的规格 [示例] 84 | 461: 51 1:193 (规格) 商品代码为 84 , 规格值代码是 461, 511, 193)
规格3	规格	输入规格项目和规格值	仅输入半角数字，用竖线 (|) 分隔项目和值。每个字符在 10 个字符以内 * 2015 年 10 月 1 日之后的规格 仅限半角 数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供的代码 [示例] 84 | 461（规格商品代码为 84，规格价值代码为 461） * 2015 年 10 月 1 日之后的规格 [示例] 84 | 461: 51 1:193 (规格) 商品代码为 84 , 规格值代码是 461, 511, 193)
规格4	规格	输入规格项目和规格值	仅输入半角数字，用竖线 (|) 分隔项目和值。每个字符在 10 个字符以内 * 2015 年 10 月 1 日之后的规格 仅限半角 数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供的代码 [示例] 84 | 461（规格商品代码为 84，规格价值代码为 461） * 2015 年 10 月 1 日之后的规格 [示例] 84 | 461: 51 1:193 (规格) 商品代码为 84 , 规格值代码是 461, 511, 193)
规格5	规格	输入规格项目和规格值	仅输入半角数字，用竖线 (|) 分隔项目和值。每个字符在 10 个字符以内 * 2015 年 10 月 1 日之后的规格 仅限半角 数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供的代码 [示例] 84 | 461（规格商品代码为 84，规格价值代码为 461） * 2015 年 10 月 1 日之后的规格 [示例] 84 | 461: 51 1:193 (规格) 商品代码为 84 , 规格值代码是 461, 511, 193)
spec6 此项目可以在 2015 年 10 月 1 日之后指定。	规格	输入规格项目和规格值	仅半角数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供代码 [示例] 84 | 461: 511: 193 (Spec item code is 84, Spec value code is 461, 511, 193 )
spec7 此项目可以在 2015 年 10 月 1 日之后指定。	规格	输入规格项目和规格值	仅半角数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供代码 [示例] 84 | 461: 511: 193 (Spec item code is 84, Spec value code is 461, 511, 193 )
spec8 此项目可以在 2015 年 10 月 1 日之后指定。	规格	输入规格项目和规格值	仅半角数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供代码 [示例] 84 | 461: 511: 193 (Spec item code is 84, Spec value code is 461, 511, 193 )
spec9 此项目可以在 2015 年 10 月 1 日之后指定。	规格	输入规格项目和规格值	仅半角数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供代码 [示例] 84 | 461: 511: 193 (Spec item code is 84, Spec value code is 461, 511, 193 )
spec10 此项目可以在 2015 年 10 月 1 日之后指定。	规格	输入规格项目和规格值	仅半角数字和句点（输入数字时）。输入由竖线 (|) 分隔的项目和值，以及由冒号 (:) 分隔的值。每个字不超过 10 个字符。	Yahoo! Shopping 提供代码 [示例] 84 | 461: 511: 193 (Spec item code is 84, Spec value code is 461, 511, 193 )
种类	产品展示顺序	输入类别内的显示顺序	半角数字 1 到 999999999，空白	* 设置“sort_priority”以指定产品显示顺序。
排序优先级	产品展示优先	在类别中输入显示顺序	半角数字 1 到 9999999，空白	如果输入的号码重复或空白，将按照店铺分类中商品订单设置的顺序显示（推荐订单或新到货订单）。 * 如果指定了商品显示优先级的类别包含“链接目的地”商品页面，则只会更改[链接来源]商品页面的顺序，并且可以更改“链接目的地”商品页面的顺序。不是。您可以通过直接从产品管理屏幕更改顺序来更改“链接目的地”产品页面的顺序。
sp-附加	智能手机的可用空间	输入智能手机产品的补充说明。	全角 5,000 个字符或更少（半角 10,000 个字符或更少），包括图像的总容量 2000 KB（建议最大 600 KB），允许 HTML	如果您收到超出总容量的错误信息，请通过编辑商店编辑页面>编辑产品页面>输入智能手机信息并按保存按钮来检查当前容量。
原价证据	证据网址	输入制造商建议零售价的证据 URL	仅 URL 格式
库存交货期	发货日期信息	有库存设置且库存数量为1个或更多	发货日期信息管理编号（有货时要显示的发货日期显示文字的设置）
提前期缺货	发货日期信息	未设置股票数量，或已设置股票数量且股票数量为 0 或更少。	发货日期信息管理编号（设置缺货时要显示的发货日期显示文字）
保持库存		设置在订购者取消时恢复库存	0： 取消时不恢复库存 1：取消时恢复库存（初始值）
邮资套装	交付组	输入Store Creator Pro中设置的配送组的“控制号”	仅半角数字 （1 到 20）	以下为错误 ，不存在的投递组管理号 ，非数字输入， 1到20以外的数值， 多输入 。如果上传为空，则不会更新。
是药物	一流的医药产品	进入一级药品	只有半角数字。输入 0 或 1	正常产品：0，第 1 类药物：1 输入如果为空白，“无变化”
供应商类型 * 仅限 PayPay 商城店主	销售路线	输入产品是通过国内授权零售商或日本授权进口代理商指定的分销购买的。	仅对半角数字 输入 1、2 和 3	无选择：1 正规销售/进口代理产品：2 平行进口产品，其他：3 默认设置为“无选择”。PayPay商城中将隐藏“无选择”、“水货等”。在隐藏产品的情况下，它们将显示在 PayPay 商城商店搜索和 Yahoo! Shopping 中。
y-shopping-display-flag * 仅限 PayPay 商城店主	要在 Yahoo! Shopping Search 中显示的产品	输入是否在 Yahoo! Shopping 搜索或推荐中显示该产品 * 将在店内搜索中显示。	仅对半角数字 输入 1 或 0。	显示：1 隐藏：0
linegift_cooperation_flag * 仅限 LINE 礼品店老板	LINE 礼品列表设置	设置是否在LINE礼物上显示商品	只为半角数字输入 1 或 0	不列出 ：0（默认） 出售：1 * 注意- “页面发布设置”为“私人”的产品即使设置了列表设置也不会在LINE礼物中列出。 ・“隐藏页面设置”为“隐藏页面”的产品即使在LINE礼物上也不会搜索或发布在首页，但您可以访问产品页面（可以订购）。
linegift_item_commission * 仅限 LINE 礼品店老板	LINE礼物费	包括全国统一运费和礼品包装费等各种费用的金额	仅限半角数字，最多 8 个字符	LINE赠品售价为商品价格与LINE赠品费用之和。
linegift_item_shortname * 仅限 LINE 礼品店老板	LINE 礼品的产品名称	用于LINE礼物的产品名称	全角、半角 20 个字符或更少	LINE礼物列表设置为1：列表时必填，如果 使用半角假名，会转为全角显示在LINE礼物页面。
linegift_item_image_url * 仅限 LINE 礼品店老板	LINE 礼物的产品图片	用于LINE礼物的产品图片的URL	仅 URL 格式	如果LINE礼品列表设置为1：Selling，则为必填项。 Yahoo! Shopping 与附加图片的规格相同。详情请参阅以下手册。 Store Creator Pro 手册 --图像管理概述 文件格式：扩展名仅为 .gif / .jpg / .jpe / .jpeg /.png 文件大小：500 KB 或更少 文件名：半角字母数字、连字符 (-)、下划线 (_)、句点 (.) 仅可用 图片尺寸：垂直 1250 像素，水平 1250 像素或更少 URL 格式：https://shopping.c.yimg.jp/lib/Store account/File name.Extension
底价	自动切换设定：正常售价	输入转换期的正常售价	只有半角数字。在商店设置中选择“含税”时为 8 个字符或更少，选择“不含税”时为 92,592,592 个或更少	使用“自动价格切换设置”时需要
保留销售价格	自动切换设定：售价	输入转换期的销售价格	只有半角数字。在商店设置中选择“含税”时为 8 个字符或更少，选择“不含税”时为 92,592,592 个或更少	自动切换设置：只能输入低于正常售价的价格
保留会员价	自动切换设置：Y!高级会员价格	输入切换期间的 Yahoo! Premium 会员价格	只有半角数字。在商店设置中选择“含税”时为 8 个字符或更少，选择“不含税”时为 92,592,592 个或更少	自动切换设置：只能输入低于正常销售价格和预订销售价格的价格。
储备销售期开始	自动切换设置：切换周期（开始日期）	价格变动的开始日期和时间	只有半角数字。YYYYMMDDHHMM 格式	使用“自动价格切换设置”时需要
储备销售期末	自动切换设置：切换周期（结束日期）	价格变动的结束日期和时间	只有半角数字。YYYYMMDDHHMM 格式	使用“自动价格切换设置”时需要

库存上传格式 (CSV)

字段名称	意义	输入法
代码	产品代码	仅单字节字母数字或连字符，最多 99 个字符
子码	单个产品 代码	仅半角字母数字或连字符，99 个字符或更少 * 没有单独产品代码的产品为空白
数量	库存数量	仅半角数字，最多 9 位
模式模式	种类	半角加号 (+)、减号 (-) 或空白
允许透支	超过库存商品数量的订单	0：即使 超过库存数量也无法订购1：即使超过库存数量也可以订购
股票收盘	库存关闭标志	如果设置了库存关闭标志，则将其视为缺货。 0：库存结清状态释放 如果未指定或为空，则库存结清标志不会更新。

模式字段的指定方法的类型描述如下。
+：加- ：减 空白：如果 没有要赋值的字段，则将其作为“值”处理

http://miss.52dede.com/data202201061327.csv