package-tracker

package-tracker is package tracking library for Node.js

Company List

Name | Contributor | Link ---- | ---- EMS | @egg- | https://service.epost.go.kr/trace.RetrieveEmsRigiTraceList.comm ECARGO | @egg- | http://web.ecargo.asia/script/users/tracking.php KPACKET | @egg- | https://service.epost.go.kr/trace.RetrieveEmsRigiTraceList.comm (ems) JX | @egg- | https://service.epost.go.kr/trace.RetrieveEmsRigiTraceList.comm (ems)

Installation

$ npm install package-tracker

Usage

var tracker = require('package-tracker')
var ems = tracker.company(tracker.COMPANY.EMS)
 
ems.trace({trace_number}, function (err, result) {
  console.log(result)
})

command line

$ npm install -g package-tracker
$ package-tracker -h
 
Usage: index [options] <tracecode>
 
  Options:
 
    -h, --help               output usage information
    -c, --company <company>  Company Name
 
$ package-tracker -c ems EBXXXXXXXXXKR

Response

Status Code

tracker.STATUS.{CODE}

CODE	VALUE	DESC
UNKNOWN	-1	알수 없음
RECEIVE	10	접수
DEPARTURE	20	발송
DEPARTURE_READY	21	발송준비
ARRIVAL	30	도착
ARRIVAL_OUTWARD_OFFICE	31	발송교환국에도착
ARRIVAL_INWARD_OFFICE	32	교환국도착
ARRIVAL_DESTIATION_AIRPORT	33	상대국도착
TRANSPER_EXPRESS	40	운송사인계
TRANSPER_DESTIATION_AIRPORT	41	상대국인계
TRANSPER_DESTIATION_AIRPORT	42	재입고
AIRPORT_RECEIVED	50	항공사인수
AIRPORT_DEPARTURE	51	항공기출발
CUSTOMS_PENDING	60	통관검사대기
CUSTOMS	65	통관및분류
DELIVERY_START	70	배달준비
DELIVERY_COMPLETE	75	배달완료
DELIVERY_UNSUCCESSFULE	79	미배달

Error

CODE	VALUE	DESC
UNKNOWN	-1	Unknow error
INVALID_NUMBER	10	invalid trace number.
INVALID_NUMBER_LENGTH	11	invalid trace number.
INVALID_NUMBER_HEADER	12	invalid trace number.
INVALID_NUMBER_COUNTRY	13	invalid trace number.

Sample

{
  "histories": [
    {
      "status_txt": "접수",
      "ts": 1465361520,
      "status": 10,
      "area": "SL.SS.HYUNDAE",
      "detail": "Posting office zip code : 06035\nTransit or Destination country : SINGAPORE"
    },
    {
      "status_txt": "발송",
      "ts": 1465362300,
      "status": 20,
      "area": "SL.SS.HYUNDAE",
      "detail": ""
    },
    {
      "status_txt": "도착",
      "ts": 1465365900,
      "status": 30,
      "area": "EASTSEOUL MAIL CENTER",
      "detail": ""
    },
    {
      "status_txt": "발송",
      "ts": 1465376700,
      "status": 20,
      "area": "EASTSEOUL MAIL CENTER",
      "detail": ""
    },
    {
      "status_txt": "발송준비",
      "ts": 1465382940,
      "status": 21,
      "area": "INTERNATIONAL POST OFFICE",
      "detail": "Dispatch number : 589"
    },
    {
      "status_txt": "발송교환국에 도착",
      "ts": 1465383600,
      "status": 31,
      "area": "INTERNATIONAL POST OFFICE",
      "detail": ""
    },
    {
      "status_txt": "운송사 인계",
      "ts": 1465390860,
      "status": 40,
      "area": "INCHEON",
      "detail": "Flight number : SQ607"
    },
    {
      "status_txt": "항공사 인수",
      "ts": 1465402200,
      "status": 50,
      "area": "INCHEON",
      "detail": ""
    },
    {
      "status_txt": "항공기 출발(예정,한국시간)",
      "ts": 1465431720,
      "status": 51,
      "area": "INCHEON",
      "detail": ""
    },
    {
      "status_txt": "상대국 도착",
      "ts": 1465451160,
      "status": 33,
      "area": "SINGAPORE",
      "detail": ""
    },
    {
      "status_txt": "교환국 도착",
      "ts": 1465474140,
      "status": 32,
      "area": "SGSIND",
      "detail": ""
    },
    {
      "status_txt": "통관 및 분류",
      "ts": 1465515300,
      "status": 60,
      "area": "SGSIND",
      "detail": ""
    },
    {
      "status_txt": "미배달",
      "ts": 1465535940,
      "status": 79,
      "area": "650416",
      "detail": "Reason : Absence of addressee\nResult :"
    },
    {
      "status_txt": "미배달",
      "ts": 1465536600,
      "status": 79,
      "area": "650416",
      "detail": "Reason : Other\nResult :"
    },
    {
      "status_txt": "배달완료",
      "ts": 1465625160,
      "status": 75,
      "area": "650416",
      "detail": "Recipient : ()\nResult : Delivery complete"
    }
  ],
  "number": "EBXXXXXXXXXKR",
  "sender": "C*aris",
  "receiver": "R*i Egg",
  "status_txt": "배달완료",
  "status": 75,
  "company": "EMS",
  "company_code": "ems"
}

Test

Test with mocha

$ grunt

like watch

$ grunt watch

Contributing

Bug reports and pull requests are welcome on Github at https://github.com/egg-/package-tracker

1. Fort it
2. Create your feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a new Pull Request.

Release History

See the CHANGELOG.md

License

package-tracker is licensed under the MIT license.