=== Yahoo! Shopping JP for WooCommerce ===
Contributors: catcodestudio
Tags: woocommerce, japan, yahoo shopping, orders, inventory
Requires at least: 6.2
Tested up to: 6.8
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Imports Yahoo! Shopping (Japan) orders into WooCommerce and sends WooCommerce stock to the Yahoo! Shopping store through the official store APIs.

== Description ==

If you sell on your own WooCommerce site and in a Yahoo! Shopping (LY Corporation) store, this plugin keeps the two in step through the official Yahoo! Shopping store APIs (Order API and Stock API).

**What it does**

* Connects to your store with the Yahoo! JAPAN ID (OAuth), using your own Client ID.
* Imports orders of the last 1-30 days as WooCommerce orders: buyer, delivery address (Japanese prefectures mapped to WooCommerce states), items matched by SKU, shipping, payment fee and discounts. An order is imported once.
* Cancels the WooCommerce order when the store cancelled it on Yahoo! Shopping.
* Sends the stock quantity of a product to Yahoo! Shopping with one button on the product screen. The item code on Yahoo! is the product SKU; a variation is sent as "parent SKU:variation SKU".
* No e-mail goes to the buyer from WooCommerce for imported orders.
* English and Japanese interface.

**Before you start**

You need a Yahoo! JAPAN developer application for your store. The Order API requires a separate usage application at Yahoo!, and Yahoo! may ask for a fixed IP address of the server. The plugin does not create these for you.

**External service**

The plugin talks to Yahoo! JAPAN (LY Corporation) services when you connect, import orders or send stock:

* auth.login.yahoo.co.jp: sign-in with the Yahoo! JAPAN ID and token renewal.
* circus.shopping.yahooapis.jp (or test.circus.shopping.yahooapis.jp when the test environment is switched on): the Yahoo! Shopping order and stock APIs. Sent: your store account, order ids and stock quantities with item codes (SKU). Received: orders with the buyer's name, address, phone and e-mail.

Yahoo! JAPAN terms of use: https://developer.yahoo.co.jp/ and privacy policy: https://privacy.lycorp.co.jp/

== Installation ==

1. Install and activate WooCommerce, then this plugin.
2. Open WooCommerce > Yahoo! Shopping JP.
3. Enter the store account, Client ID and Client Secret, register the shown redirect address in your Yahoo! application, save, and press "Connect to Yahoo! JAPAN".
4. Press "Import orders now". Open a product and use "Send stock to Yahoo! Shopping".

== Frequently Asked Questions ==

= Are product listings created on Yahoo! Shopping? =

No. The plugin imports orders and sends stock quantities for items that already exist in the store. Creating and editing listings stays in the store management tools of Yahoo! Shopping.

= How are prices handled? =

Prices from Yahoo! Shopping are tax-inclusive yen and are copied as they are, without recalculation. If the lines do not add up to the total reported by Yahoo!, a note is added to the order.

= Is it a service of Yahoo! JAPAN? =

No. It is an independent plugin by CatCode that uses the public store APIs of Yahoo! Shopping. Yahoo! is a trademark of its owner.

== Changelog ==

= 1.0.0 =
* First release: connection by Yahoo! JAPAN ID, manual order import, stock button on the product screen, Japanese translation.
// @pro-begin
* Pro (sold on catcode.com.ua): scheduled order import, automatic stock push and full-catalogue sync, shipment report back to Yahoo! Shopping.
* Updates from catcode.com.ua for the Pro build.
// @pro-end

== Upgrade Notice ==

= 1.0.0 =
First release.
