Delibee

Prerequisites

Node.js >= 7.6

Required Server Dependencies

NOTE: Sometimes Delibee use Headless Chrome. (e.g. CJ대한통운)

Debian (e.g. Ubuntu)

sudo apt-get install -yq gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget

CentOS

sudo yum install pango.x86_64 libXcomposite.x86_64 libXcursor.x86_64 libXdamage.x86_64 libXext.x86_64 libXi.x86_64 libXtst.x86_64 cups-libs.x86_64 libXScrnSaver.x86_64 libXrandr.x86_64 GConf2.x86_64 alsa-lib.x86_64 atk.x86_64 gtk3.x86_64 ipa-gothic-fonts xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-utils xorg-x11-fonts-cyrillic xorg-x11-fonts-Type1 xorg-x11-fonts-misc -y

Issues

Feel free to submit issues and enhancement requests.

Usage

npm install delibee

On Express Framework

const express = require('express')
const delibee = require('delibee')({
  timeout: 10000, // default timeout value is '10000'
  locale: 'en' // default locale is 'ko'
})
const app = express()

app.get('/tracking/companies', async (req, res) => {
  const companies = await delibee.company()
  res.send(companies)
})

app.get('/tracking', async (req, res) => {
  const company = req.query.company
  const invoiceNo = req.query.invoice_no
  const invoice = await delibee.tracking(company, invoiceNo)
  res.send(invoice)
})

app.listen(3000)

Http Request Example

http://127.0.0.1:3000/tracking?company={delivery_company_code}&invoice_no={invoice_number}

Delivery Company Code

| Company Name | Comapny Code | | ----------------------- | ------------ | | 우체국택배 | EPOST | | CJ대한통운 | CJ | | 한진택배 | HANJIN | | 롯데택배 (구. 현대택배) | LOTTE | | 로젠택배 | LOGEN | | 드림택배 (구. KG로지스) | DREAM | | CVSnet 편의점택배 | CVSNET | | CU 편의점택배 | CU |

Response

| Key | Description | | --------------- | ------------ | | deliveryCompany | 택배회사정보 | | invoiceNumber | 송장번호 | | senderName | 보낸이 | | senderAddr | 출발지/주소 | | receiverName | 받는이 | | receiverAddr | 도착지/주소 | | statusCode | 배송상태코드 | | statusText | 배송상태 | | history | 배송내역 |

DeliveryCompany

| Key | Description | | ---- | ------------ | | code | 택배회사코드 | | name | 택배회사 |

History

| Key | Description | | ---------- | ----------------------- | | dateTime | 시간 (timestamp) | | dateString | 시간 (YYYY.MM.DD HH:mm) | | location | 위치 | | tel | 전화번호 | | remark | 택배사 제공 배송상태 | | statusCode | 배송상태코드 | | statusText | 배송상태 |

Status

| StatusCode | StatusText | | ---------- | ------------ | | -1 | 알수없음 | | 10 | 접수대기 | | 11 | 잔류 | | 20 | 접수 | | 30 | 집하 | | 40 | 배송중(출고) | | 50 | 배송중(입고) | | 55 | 오도착 | | 60 | 배달준비중 | | 65 | 배달중 | | 70 | 배달완료 | | 71 | 미배달 | | 80 | 인수확인 |

Response Expample

{
  "success": true,
  "invoice": {
    "deliveryCompany": {
      "code": "CJ",
      "name": "CJ대한통운"
    },
    "invoiceNumber": "612566673760",
    "senderName": "테*",
    "senderAddr": "",
    "receiverName": "이*",
    "receiverAddr": "",
    "history": [
      {
        "dateTime": 1512043020000,
        "dateString": "2017.11.30 20:57",
        "location": "인천가좌심곡",
        "tel": "",
        "remark": "보내시는 고객님으로부터 상품을 인수받았습니다",
        "statusCode": 20,
        "statusText": "접수"
      },
      {
        "dateTime": 1512055800000,
        "dateString": "2017.12.01 00:30",
        "location": "부평",
        "tel": "",
        "remark": "물류터미널로 상품이 이동중입니다.",
        "statusCode": 40,
        "statusText": "배송중(출고)"
      },
      {
        "dateTime": 1512124740000,
        "dateString": "2017.12.01 19:39",
        "location": "대전HUB",
        "tel": "",
        "remark": "배송지역으로 상품이 이동중입니다.",
        "statusCode": 40,
        "statusText": "배송중(출고)"
      },
      {
        "dateTime": 1512168420000,
        "dateString": "2017.12.02 07:47",
        "location": "덕진",
        "tel": "",
        "remark": "고객님의 상품이 배송지에 도착하였습니다.(배송예정:--)",
        "statusCode": 50,
        "statusText": "배송중(입고)"
      },
      {
        "dateTime": 1512178800000,
        "dateString": "2017.12.02 10:40",
        "location": "전북전주송천",
        "tel": "",
        "remark": "고객님의 상품을 배송할 예정입니다.(11∼13시)(배송담당:--)",
        "statusCode": 65,
        "statusText": "배달중"
      },
      {
        "dateTime": 1512180420000,
        "dateString": "2017.12.02 11:07",
        "location": "전북전주송천",
        "tel": "",
        "remark": "고객님의 상품이 배송완료 되었습니다.(담당사원:--)",
        "statusCode": 70,
        "statusText": "배달완료"
      }
    ],
    "statusCode": 70,
    "statusText": "배달완료"
  }
}

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/moodselah/delibee

1. Fork the repo on GitHub
2. Clone the project to your own machine
3. Commit changes to your own branch
4. Push your work back up to your fork
5. Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

Contributors

| Company Name | Contributor | | ----------------------- | ------------------------------------------ | | 우체국택배 | @moodselah | | CJ대한통운 | @moodselah | | 한진택배 | @moodselah | | 롯데택배 (구. 현대택배) | @moodselah | | 로젠택배 | @moodselah | | 드림택배 (구. KG로지스) | @moodselah | | CVSnet 편의점택배 | @moodselah | | CU 편의점택배 | @moodselah |

License

MIT LICENSE