=== Flash Express Philippines for WooCommerce ===
Contributors: catcodestudio
Tags: flash express, philippines, shipping, courier, woocommerce
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Ship WooCommerce orders with Flash Express Philippines: create the shipment from the order, print the label, follow the parcel and show the tracking number to your customer.

== Description ==

Connects your WooCommerce store to the Flash Express Open API for the Philippines (open-docs.flashexpress.com/ph). You need a merchant account at Flash Express: they issue the merchant number and the secret key.

* **Create the shipment from the order screen** — recipient, province, city, postal code, address, weight (from your products or a default) and, for cash on delivery, the amount in pesos.
* **Cash on delivery** — tick the payment methods that are collected by the courier; the order total goes to Flash Express in centavos. Only for orders in Philippine pesos.
* **Labels** — the 100×180 mm and the 100×75 mm PDF label straight from Flash Express; nothing is stored on your server.
* **Cancel a shipment** and **refresh the status** from the order screen. Every step leaves a note on the order.
* **Your customer sees** the tracking number and the status on the order page and in the WooCommerce e-mails.
* **Sandbox first** — a fresh install talks to the Flash Express training server until you switch to production.
* HPOS (custom order tables) supported.
// @pro-begin
* Filipino (fil, tl) translation included.
// @pro-end

// @pro-begin
= Pro =

The Pro version is sold on [catcode.com.ua](https://catcode.com.ua/modules/flash-express-philippines-woocommerce/), with a 7-day trial that never starts by itself:

* **Bulk shipments** — create Flash Express shipments for many orders from the orders list.
* **Automatic shipments** — the shipment is created when an order reaches the status you choose.
* **Live status** — Flash Express webhook plus a twice-daily tracking check as a fallback; the order is completed when the parcel is delivered.
* **Courier pickup** — request a pickup for the selected parcels from the orders list.

The licence runs for 1-5 years and includes updates and support for that term; a purchased licence keeps its Pro features after the term ends.
// @pro-end

== External services ==

This plugin sends data to the Flash Express Open API, the service of the courier you ship with. It is the whole point of the plugin and it happens only when you create, cancel, refresh or print a shipment, or when a scheduled tracking check runs.

* Production server: https://open-api.flashexpress.ph, training server: https://open-api-tra.flashexpress.ph.
* Data sent: your merchant number and a signature made with your secret key (the key itself is not sent); for a new shipment the recipient's name, phone and delivery address, the pickup address, the parcel weight, the order number, the cash-on-delivery amount and, if you leave the option on, the product names and the goods value; for other calls the tracking number.
* Terms and privacy: see the website of Flash Express Philippines, https://www.flashexpress.ph/.

== Installation ==

1. Install and activate the plugin. WooCommerce must be active.
2. WooCommerce → Flash Express PH: enter the merchant number and the secret key you received from Flash Express, the pickup address (or a warehouse number), and press "Test the keys".
3. Open an order and press "Create shipment" in the Flash Express box.

== Frequently Asked Questions ==

= Where do I get the merchant number and the secret key? =

From Flash Express: they issue them to merchants, separately for the training server and for production. The plugin cannot create them.

= Does it work outside the Philippines? =

No. Flash Express Philippines delivers inside the Philippines; an order with another delivery country is refused with a clear message.

= Why does the shipment fail with a signature error? =

The pair of keys does not match the environment: the training keys work only with "Sandbox", the production keys only with "Production".

= Flash Express is a trademark of its owner =

This plugin is made by CatCode and is not made or endorsed by Flash Express.

== Changelog ==

= 1.0.0 =
* First release: shipments, labels, cancel, tracking, cash on delivery, customer tracking.
// @pro-begin
* Pro: bulk shipments, automatic shipments, webhook and tracking check, courier pickup.
// @pro-end
