=== CatCode Labels with shipcloud for WooCommerce ===
Contributors: catcodestudio
Tags: shipcloud, shipping labels, dhl, tracking, 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

Shipping labels for WooCommerce orders through your shipcloud account: DHL, DPD, GLS, Hermes, UPS and more, with tracking for the buyer.

== Description ==

Create shipping labels on the order screen of WooCommerce through your own [shipcloud](https://shipcloud.com/) account. The plugin reads the carriers and services that are active in your account, sends the address and the parcel of the order to shipcloud and puts the label and the tracking number back on the order.

* **Label from the order screen** — choose the carrier, the service and the package type, check weight and size, press "Create label". The PDF opens from the same box.
* **Carriers of your account** — the list comes from shipcloud (for example DHL, Deutsche Post, DPD, GLS, Hermes, UPS), so you only see what you can book.
* **Weight from the products** — the weights of the products of the order are added up and converted to kilograms; a default weight and parcel size cover products without them.
* **Tracking for the buyer** — the tracking number and link are added to the order e-mails and to the order page of the account; optionally the buyer gets an e-mail right when the label is created.
* **Several parcels per order** — create one more label for the same order when it ships in two boxes.
* **Delete a label** — delete a label at shipcloud from the order screen, as long as the carrier still allows it.
* **Status on request** — "Update status" reads the current tracking status of the parcel from shipcloud.
* **Your sender address** — the default sender of your shipcloud account, or an address you enter in the plugin.
* **Parcels abroad** — a customs declaration with the items of the order is added for destinations outside the EU customs area.
* **Sandbox ready** — with the sandbox key of shipcloud you create test labels free of charge before you switch to the live key.
* Everything is written to the order notes: what was created, and why a label was refused, in the words of the carrier.
* HPOS and block checkout compatible. The API key is stored encrypted.
* Translations included: English, German.

= Pro =

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

* **Labels for many orders at once** — tick the orders in the list and choose "Create shipcloud labels"; the labels are booked in the background and a column shows the tracking number and the label of each order.
* **Live prices at the checkout** — the shipping method "shipcloud live price" asks shipcloud what the parcel of the cart costs and shows that price, with your surcharge and a fallback price.
* **Return labels** — a return label from the order screen, e-mailed to the buyer on request.
* **Tracking updates** — shipcloud reports every status change to the shop: it is written to the order notes, shown to the buyer, and can set the order to "Completed" when the parcel is delivered.
* **Pickup requests** — ask DPD, GLS, Hermes or UPS to collect your parcels in a time window you choose.
* **Carrier rules** — choose the carrier and service by destination country and weight, for the order screen and for bulk labels.
* Updates from catcode.com.ua.

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. One key covers two sites: the shop and its test copy.

shipcloud is a trademark of its owner. This plugin is an independent integration made by CatCode; it is not an official plugin of shipcloud and is not affiliated with or endorsed by it. You need your own shipcloud account; labels are booked and charged through that account.

== External services ==

The plugin connects to the shipcloud API (shipcloud GmbH, [shipcloud.com](https://shipcloud.com/), API documentation at [developers.shipcloud.io](https://developers.shipcloud.io/reference/)) at `api.shipcloud.io`, and only after you enter your API key.

* When you press "Check connection and load carriers": your API key, to read the account (plan, sandbox or live) and the carriers and services that are active in it.
* When you create a label: your API key; the name, company, address and phone number of the recipient from the order; the weight, size and type of the parcel; the carrier and service; the order number as a reference; the sender address if you entered one. For parcels that leave the EU customs area also the names, quantities, values and weights of the items of the order. If you switch it on in the settings: the e-mail address of the buyer, so that the carrier or shipcloud can send delivery notices.
* When you press "Update status" or "Delete label": your API key and the id of the shipment.
* Pro, at the checkout with the "shipcloud live price" method: your API key, the delivery address typed by the buyer (street, postcode, city, country), the weight of the cart and the parcel size, to get a price.
* Pro, return labels and pickup requests: the same data as for a label, plus the time window of the pickup.
* Pro, tracking updates: the address of your site that receives the updates is registered at shipcloud; shipcloud then calls it with the id of the shipment.

The label itself is a file on the servers of shipcloud (`shipping-labels.shipcloud.io`); the tracking link for the buyer leads to the tracking page of shipcloud or of the carrier.

[shipcloud terms and conditions](https://shipcloud.com/terms-and-conditions/) · [shipcloud privacy policy](https://shipcloud.com/privacy/)

== Installation ==

1. Upload the plugin and activate it. WooCommerce must be active.
2. WooCommerce → **shipcloud**. In your shipcloud account click your e-mail address in the upper right corner, open "API Key" and copy the sandbox key (for tests) or the live key into the plugin.
3. Press "Check connection and load carriers", choose the default carrier, service and parcel size, and save.
4. Open an order: the "shipcloud" box on the right creates the label.

== Frequently Asked Questions ==

= Do I need a shipcloud account? =

Yes. The labels are booked and charged by shipcloud through your account, with the carrier contracts of shipcloud or your own. The plugin does not sell labels.

= Which carriers can I use? =

The ones that are active in your shipcloud account. The plugin reads the list from shipcloud.

= Can I test without paying for labels? =

Yes. With the sandbox API key shipcloud creates test labels and charges nothing.

= A label was not created. Where do I see why? =

In the "shipcloud" box right after the click, and in the notes of the order. Refusals of the carrier are shown in its own words.

= Where does the buyer see the tracking number? =

In the order e-mails and on the order page under "My account". You can also have an e-mail sent as soon as the label is created.

== Changelog ==

= 1.0.0 =
* First release.
