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

How to Connect Poste Go Fresh to ShippyPro

Discover here how to connect Poste Go Fresh in just a few steps

Poste Go Fresh is Poste Italiane's service for temperature-controlled (fresh and frozen) parcel delivery within Italy. Let's see how you can integrate Poste Go Fresh with ShippyPro in just a few steps.

 

Summary

1. Before you start

2. How to connect Poste Go Fresh

3. Supported services

4. Additional options

5. Troubleshooting & Errors

6. FAQ


 1. Before you start 

To connect Poste Go Fresh you need an active contract with Poste Italiane for the Go Fresh service. Ask your Poste Italiane sales contact for these credentials:

  • Private Key
  • Public Key
  • Shipper ID

Keep in mind that Poste Go Fresh ships within Italy only. International shipments are not supported.

 2. How to connect Poste Go Fresh

  1. Go to the Carriers page and click on the Poste Go Fresh logo.
  2. Fill in the connection form with the fields below.
  3. Click Connect to save the carrier.

Field

Required

Description

Private Key

Yes

Your Poste Go Fresh API private key.

Public Key

Yes

Your Poste Go Fresh API public key.

Shipper ID

Yes

Your shipper identifier, provided by Poste Italiane.

Parcel Type

Yes

Type of parcel: Standard, Bulky or Frozen.

Additional Shipping Days

Yes

Extra working days to add to the delivery date. Set 0 to use the first date available from Poste Go Fresh for the destination ZIP code.

Service Type

Yes

Standard (the only option available).

Label Type

No

PDF A6 or ZPL (100x150 mm, 203 DPI).

Test Mode

No

Connects to the Poste Go Fresh test environment.

Important: ShippyPro doesn't validate your credentials when you save the carrier. If a key or the Shipper ID is wrong, you'll see the error when you create your first shipment.

3. Supported services

 

Service

Description

Standard

Temperature-controlled domestic delivery. The delivery date is calculated from carrier availability for the destination ZIP code, or from your Additional Shipping Days setting.

What's supported:

  • Labels: PDF A6 and ZPL (100x150 mm, 203 DPI)
  • Tracking: yes

 

     

    4. Additional options

    Test Mode

    Enable Test Mode to create test shipments on the Poste Go Fresh test environment.

    ⚠️ Warning: Test Mode shipments are not real. Labels created in Test Mode must not be used to ship parcels. Remember to disable Test Mode before going live.

    Delivery time range

    You can send a preferred delivery time range with the carrier option time_range, in the format YYYY-MM-DDTHH:MM/YYYY-MM-DDTHH:MM (for example 2026-11-05T09:00/2026-11-05T13:00).

     


    5. Troubleshooting & errors

    Error

    What to do

    Authentication / invalid credentials

    Check Private Key, Public Key and Shipper ID. Copy them again from Poste Italiane, with no extra spaces.

    		  

    Destination not covered

    Poste Go Fresh doesn't serve the receiver's ZIP code. Check the ZIP code or use another carrier for that destination.

    		  

    Non-Italian destination

    Poste Go Fresh ships only within Italy. Use another carrier for international shipments.

    		  

    Label not generated

    Make sure Test Mode matches the credentials you're using (test or production), then try again.

    		  

    Internal Server Error

    Usually a temporary issue on the carrier side. Wait a few minutes and try again. If it persists, contact ShippyPro Support.

    		  

    Connection issues

    Check that all required fields are filled in, then save the carrier again.

    		  


    6. FAQ

    What do I need to connect Poste Go Fresh? An active Poste Go Fresh contract with Poste Italiane, plus your Private Key, Public Key and Shipper ID.

    Can I ship outside Italy? No. Poste Go Fresh supports domestic shipments within Italy only.

    How is the delivery date calculated? With Additional Shipping Days set to 0, ShippyPro uses the first date Poste Go Fresh has available for the destination ZIP code. With a value above 0, that number of working days is added.

    Can I ship frozen products? Yes. Select Frozen as Parcel Type in the carrier settings. You can also choose Standard or Bulky.

    Can I cancel a shipment from ShippyPro? No, cancellation (void) isn't available for Poste Go Fresh. Contact Poste Italiane to cancel a shipment.

    Can I track my Poste Go Fresh shipments? Yes. Tracking updates are available in ShippyPro like for your other carriers.