thailandpost-track 1.0.0

A Python library for Thailand Post track API

Thailand Post Track

A Python library for Thailand Post Track API

Table of Contents

• Installation
• Usage
  • Initial a Object
  • Viewing Track
  • Viewing Token Expire
  • Fetch New Token
• References
  • Status Code
  • Language

Installation

pip install thailandpost-track

Usage

from thailandpost_track import ThailandpostTrack

Initial Thailand Post Track Object

Parameter:

• token_key string token to access API Get here

Function:

TOKEN_KEY = 'X5RcT/DOF@ESK_RxMICNP8PTW=Dm...'

thp = ThailandpostTrack(token_key=TOKEN_KEY)

Viewing Track

Check status of tracking

Parameter:

• barcode string list tracking number of Thailand Post
• status string filter by status default StatusCode.ALL more
• language string language of response default Language.EN more

Function:

from thailandpost_track import Language
from thailandpost_track import StatusCode


barcode = ['EF582568151TH']
thp.track(barcode=barcode, status=StatusCode.FINAL_DELIVERY, language=Language.EN)

Response:

{
  'response': {
    'items': {
      'EF582568151TH': [
        {
          'barcode': 'EF582568151TH',
          'status': '501',
          'status_description': 'Final delivery',
          'status_date': '26/10/2019 10:00:44+07:00',
          'location': 'RONG KWANG',
          'postcode': '54140',
          'delivery_status': 'S',
          'delivery_description': 'Successful',
          'delivery_datetime': '26/10/2019 10:00:44+07:00',
          'receiver_name': 'ยุพิน/ภรรยา',
          'signature': 'https://trackimage.thailandpost.co.th/f/signature/QDY4MTUxYjVzMGx1VDMz/QGI1c0VGMGx1VDMx/QGI1czBsVEh1VDM0/QGI1czBsdTU4MjVUMzI='
        }
      ]
    },
    'track_count': {
      'track_date': '24/03/2020',
      'count_number': 6,
      'track_count_limit': 1000
    }
  },
  'message': 'successful',
  'status': True
}

Viewing Token Expire

Check token expire

Function:

thp.expire()

Response:

2020-04-24 17:30:48+07:00

Fetch New Token

Fetch new token, if your token will expire

Function:

thp.fetch_token()

References

Status Code

Status of items. Click link to show more detail.

List:

Variables	Code	Description
ALL	all	All
PRELOAD	101	Preload
ACCEPTED_BY_AGENT	102	Accepted by Agent
COLLECTION	103	Posting/Collection
IN_TRANSIT	201	In transit
PERFORM_CUSTOMS_CLEARANCE	202	Perform customs clearance
RETURN_TO_SENDER	203	Return to Sender
ARRIVAL_AT_OUTWARD_OFFICE	204	Arrival at outward office of exchange
ARRIVAL_AT_INWARD_OFFICE	205	Arrival at inward office of exchange
ARRIVAL_AT_POST_OFFICE	206	Arrival at post office
PREPARE_TRANSIT	207	Prepare transit
ITEM_OUT_FOR_PHYSICAL_DELIVERY	301	Item out for physical delivery
ITEM_ARRIVAL_AT_COLLECTION_POINT	302	Item arrival at collection point for pick-up (by recipient)
UNSUCCESSFUL	401	Unsuccessful (physical) delivery
FINAL_DELIVERY	501	Final delivery

How to use:

from thailandpost_track import StatusCode

StatusCode.ALL

Language

Language of response.

List:

Variables	Description
TH	Thai Language
EN	English Language
CN	Chinese Language

How to use:

from thailandpost_track import Language

Language.EN