0 votes
in Couriers by (120 points)
edited by

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.

2 Answers

0 votes
by
It's working as InPost, but not supported natively.
by (120 points)
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.
0 votes
by (44.7k points)
edited by

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!

by (120 points)
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.
by (370 points)
A working tracking id for paczkomaty:
645678286499300013002887
Welcome to Deliveries Package Tracker Q&A, where you can ask questions and receive answers from other members of the community.

Categories

...