Skip to content
English
Go to shippypro.com
  • There are no suggestions because the search field is empty.

 How to connect Energo to ShippyPro

Energo is an Italian carrier specialised in home delivery of bulky goods and large home appliances, with in-home/floor delivery by appointment and collection of the replaced appliance (WEE/RAEE). It is integrated through the Bluelinks EDI API V2 platform. ✨

Table of Contents:

  1. Before you start
  2. Carrier setup
  3. Additional options
  4. Errors & Resolutions

1. Before you start

To proceed with the connection, you will need an API Key supplied by Energo/Bluelinks. This key is validated live when you save the configuration on ShippyPro.

⚠️ Important: The production endpoint is not available yet. Energo has not yet supplied the production host and API key. Until they do, the connector can only be used in Test mode. Saving a configuration with Test mode off will return an explicit error.

Contact Energo to obtain your API Key and to be notified when the production environment becomes available.

2. Carrier setup

Go to the Carriers section and select the Energo logo. You can find it quickly by typing "Energo" in the search bar. Once located, click to connect the carrier and fill in the required fields:

Label A free nickname for this configuration, shown in your ShippyPro carrier list. Useful when you have more than one Energo account.

API Key The key supplied by Energo/Bluelinks. Validated live on save.

Service S01 — Consegna al piano (floor delivery by appointment). Currently the only available service.

Test mode Must be enabled until Energo provides the production host and API key.

3. Additional options

Destinations

  • National: Italy only
  • International: NO

Options

  • Label PDF: Available (A5 only — one page per parcel in a single PDF)
  • Label ZPL: NO
  • Label EPL: NO
  • Track & Trace: Available
  • Paperless: NO
  • PickUp/DropOff (PUDO): NO
  • Cash On Delivery: Available
  • Live Rates: NO
  • Return Labels: Available
  • Return Labels (in the box): NO
  • Book/Schedule Pickup: NO
  • Address Check: NO
  • Carrier Options: Available
  • Proof Of Delivery (POD): NO
  • Insurance: Available (declared value in EUR, printed on the waybill of the main parcel)
  • Multiparcel: Available
  • Delete Shipment (Void): NO
  • CloseOut: NO
  • CN22: NO
  • CN23: NO
  • Credentials Validation: Available (live check on save, test configurations only)

Carrier Options

Name Slug Type Description
Order type order_type select Overrides the order type computed by the connector. Accepted values: C (delivery), R (return), RR (WEE/RAEE collection from end customer), RP (WEE/RAEE collection from retail store). Note: S (swap) is not enabled by the carrier and will be rejected.
Good type good_type text Goods classification sent on every parcel, e.g. LAVATRICE, FRIGORIFERO. Should match one of the values in the carrier's goods type list. When empty, the connector falls back to the order description, then to ALTRI ACCESSORI.
Additional services services text Extra service codes, comma-separated, appended to the configured service — e.g. S03,S10. Only S01 has been verified; the full list of accepted codes is pending confirmation from Energo.

Carrier Services

Service Code Service Name Service Particularities
S01 Consegna al piano Floor delivery by appointment. The only verified service and the default applied by the carrier when none is sent.

⚠️ Note: The service code "CB" (Consegna bordostrada / kerbside delivery) does not exist as a valid service code. Sending services=CB will be rejected by the carrier with "Il tipo di servizio CB è sconosciuto". Do not use it without written confirmation from Energo.

Cash on Delivery

COD is supported with five payment types:

Code Description
C Cash (default)
AB Bank check to the GDO
AC Cashier's check to the GDO
ABT Bank check to the carrier
ACT Cashier's check to the carrier

Note: the COD amount is accepted by the API but is not printed on the waybill.

Return Shipments

Return labels are supported (order_type=R). On a return, the customer is the shipper and the merchant warehouse is the destination. One return order can deliver to multiple warehouses.

Tracking

Tracking is supported via polling. Available statuses:

Code Description
0 Open
1 GIT — In transit
2 In Tpoint — At hub for last mile
3 Booked — Appointment set
4 Delivered
110 In stock at hub
900 Not delivered

4. Errors & Resolutions

During the connection attempt or while shipping your orders, you may encounter some errors. Don't worry!

Production host not available

The production endpoint has not yet been supplied by Energo. Attempting to save a configuration with Test mode disabled will return an explicit error. Keep Test mode enabled until Energo provides the production host and API key.

Duplicated order_number

Each order must have a unique reference. If the same order number is submitted twice, the carrier returns "Duplicated order_number". Retries on failed shipments are disabled for this reason — check your order references before resubmitting.

Please wait until the last execution is completed

The Bluelinks platform serialises calls per API key. If a previous request is still pending, all subsequent requests — including read operations — are refused with this message. Wait for the current execution to complete before retrying. If the account remains locked, contact Energo.

Order type S (swap) rejected

The swap order type is not enabled on the carrier side. Submitting order_type=S will return an error. Use the supported values: C, R, RR, or RP.

Invalid address / ZIP code

The carrier does not validate addresses on order creation — an incorrect ZIP code or municipality will still produce a waybill. ShippyPro performs its own address checks before sending the order. Make sure the destination ZIP code and city are valid Italian values.