Support for Paczkomaty by Inpost

Question

Hi,

I was wondering if you could add support for Polish automated parceli delivery service called Paczkomaty.pl which is run by Inpost. This is second largest package delivery system in Poland and it's rapidly getting more and more popular.

In order to make your work easier I've included below a fragment of their API documentation (http://paczkomaty.pl/pliki/paczkomaty_api.zip) translated into english (pages 11 and 12 to be exact).

In order to track a parcel issue HTTP request to the following address: 

http://api.paczkomaty.pl/?do=getpackstatus&packcode=tracking_number_goes_here

Sample address: http://api.paczkomaty.pl/?do=getpackstatus&packcode=*removed* (this parcel was sent 21.10.2014 and tracking number will be valid at least for next 3 months)

In response server will return valid XML document containing parcel status:

<?xml version="1.0" encoding="UTF-8"?>
	<paczkomaty>
	<status>STATUS_CODE</status>
	<statusDate>2014-10-22T19:38:45.981+02:00</statusDate>
	</paczkomaty>

Valid status codes are:

Created - parcel was just created in system and is awaiting for pickup

Prepared - picked up, awaiting departure

Sent - parcel has left original point of pickup

InTransit - package is in transit

Stored - parcel is awaiting for pickup at automated pickup point

Avizo - avizo document has been issued

Expired - package hasn't been picked up in time (after 48h packages are moved from automated delivery point to Inpost post office)

Delivered - self explanatory

RetunedToAgency - moved to Inpost post office

Cancelled 

Claimed - customer has issued a complaint request

ClaimProcessed - complaint request processing finished

 

In case of error following XML is returned:

<?xml version="1.0" encoding="UTF-8"?>
	<paczkomaty>
	<error key="Error_description_goes_here">Human readable error message in Polish</error>
	</paczkomaty>

Error in case of wrong tracking number (parcel not found in system):

<?xml version="1.0" encoding="UTF-8"?>
	<paczkomaty>
	<error key="NoPackageFound">Nie znaleziono paczki</error>
	</paczkomaty>

I hope that I've provided enough information. In case of questions please do not hesitate and contact me.

Answer 1

It's working as InPost, but not supported natively.

Comments

Inpost and Paczkomaty have separate tracking systems. If you entre paczkomaty tracking number on inpost site the only info you'll get will be 'package exists'. Also you could support inpost natively via similar api if you want. The documentation is in Polish but I can translate it for you.

Answer 2

Thanks for the detailed information, this really helped me properly implementing it! I'll add support for "Paczkomaty InPost" in the next update.

 

I made some modifications to the naming of the status messages. Please let me know if the below table fits your needs.

Code	Polish	English
Created	Oczekuje na wysyłkę	Shipment created, ready for pickup
Prepared	Gotowa do wysyłki	Picked up
Sent	Przesyłka nadana	Left original point of pickup
InTransit	Przesyłka w drodze	In transit
Stored	Oczekuje na odbiór	Awaiting pickup at automated pickup point
Avizo	Ponowne avizo	Avizo document has been issued
Expired	Nie odebrana	Shipment has not been picked up in time
Delivered	Dostarczona	Delivered
RetunedToAgency	Przekazana do oddziału	Transferred to post office
Cancelled	Anulowana	Cancelled
Claimed	Przyjęto zgłoszenie reklamacyjne	Complaint issued by customer
ClaimProcessed	Rozpatrzono zgłoszenie reklamacyjne	Complaint processed
CustomerStored	Paczka została umieszczona w Paczkomacie nadawczym	Package was placed in an automated pickup point
CustomerSent	Paczka została odebrana z paczkomatu nadawczego przez kuriera	Package was taken from an automated pickup point by the courier

 

As for InPost itself: I do not have a tracking ID for them yet. If you need native support for them too, you'd need to supply a working one. As far as I can tell, their API is protected so I'd need an API key for that. If you happen to know how to get one, please let me know.

I really appreciate your help!

Comments

First I'd like to thank you for implementing support for Paczkomaty. The table in your post is correct. As for InPost I'll look into it and I'll post back.

---

A working tracking id for paczkomaty:
645678286499300013002887