YouSend

Описание

This plugin connects your WooCommerce store to YouSend, a courier aggregator shipping worldwide from Latvia. One plugin gives your checkout real courier prices and turns an order into a shipment with a printable label in one click.

At checkout

  • Live rates for the buyer’s destination and the real weight and dimensions of the cart — UPS, FedEx, DPD, Omniva and other services available on your YouSend account.
  • Works with both the classic checkout and the new block-based checkout (Store API).
  • Optional markup percentage on top of your YouSend price.
  • Either always offer the cheapest suitable service, or pin one specific service.

In the order screen

  • Create the shipment from the order actions menu — recipient and parcel data are filled from the order automatically.
  • Get the tracking number and print the PDF label without leaving WordPress.
  • Idempotent by design: clicking twice never creates a duplicate shipment.
  • If the selected carrier refuses the destination, the plugin can substitute the next cheapest service within a price threshold you control; above the threshold it stops and lists the remaining options in the order notes, because the difference would come out of your pocket.

Compatibility

  • High-Performance Order Storage (HPOS) supported.
  • Prices are quoted in EUR. Stores selling in another currency can supply a conversion rate via the yousend_eur_rate filter; otherwise the method is not offered.

Requirements

You need a YouSend account and an API key issued in the API section of the account. Shipments are picked up in Latvia; delivery is worldwide.

External services

This plugin talks to the YouSend Partner API (https://yousend.lv/api/production/v1/services/...). It is the entire purpose of the plugin: YouSend is the shipping provider that quotes prices, registers shipments with the carriers and produces the labels. No other external service is contacted, and nothing is sent anywhere until you enter your YouSend API key in the settings.

What is sent and when:

  • Rate calculation (GET /calculate) — when a buyer with products in the cart opens the checkout: destination country and postcode, parcel weights and dimensions. No names, e-mails or street addresses are sent at this step.
  • Shipment creation (POST /order-store) — only when a store manager clicks «Create YouSend shipment» on an order: recipient name and company, phone, e-mail and full address (street, city, state, postcode, country) from the order; parcel weights and dimensions; the goods value and currency and the product names as the customs description (required for international shipping); your pickup address and the requested pickup date. The request also carries an idempotency header made of the order id, the order key and an 8-character hash of the site URL — it prevents a double click from creating two shipments.
  • Label retrieval (POST /order-confirm, GET /shipment/{id}/labels) — when a manager requests the label for an already created shipment: the shipment id only.

The data is processed by SIA Global Trade (Latvia), the company operating YouSend, under the YouSend Terms and Conditions and Privacy Policy.

Установка

  1. Install and activate the plugin (WooCommerce must be active).
  2. Go to WooCommerce Settings Shipping YouSend and paste the API key from the API section of your YouSend account. The key is shown once when issued, so copy it right away.
  3. Enter the pickup address exactly as it is saved in your YouSend account.
  4. Add the «YouSend» shipping method to the shipping zones you deliver to (WooCommerce Settings Shipping your zone). Without this step the method never appears at checkout — this is how WooCommerce zones work.

Часто задаваемые вопросы

Do I need a YouSend account?

Yes. The plugin is a client for the YouSend Partner API; prices, shipments and labels all come from your account. Registration is free at yousend.lv.

Where are parcels picked up?

The courier collects parcels at your pickup address in Latvia. Delivery is worldwide — over 200 destinations.

Why does the shipping method not appear at checkout?

The most common reason: the method has not been added to a shipping zone. WooCommerce only calls methods that belong to the zone matching the buyer’s address. The second most common: your store currency is not EUR and no yousend_eur_rate filter is set.

Does the buyer’s price include VAT?

The plugin passes the net price to WooCommerce and lets your store’s tax settings apply VAT, so tax is never charged twice.

Can a shipment be cancelled?

A created label is a real shipment registered with the carrier. UPS and FedEx shipments cannot be cancelled through YouSend afterwards — that is why automatic label creation is off by default.

Отзывы

Нет отзывов об этом плагине.

Участники и разработчики

«YouSend» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

«YouSend» переведён на 1 язык. Благодарим переводчиков за их работу.

Перевести «YouSend» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

1.0.0

  • First release in the WordPress.org directory.
  • Previously distributed from yousend.lv as 0.3.x: live rates at checkout (classic and blocks), one-click shipment with idempotency, label printing, carrier substitution with a price threshold, HPOS support, Russian and Latvian translations.