popbill 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1b19c6374dde032be10db067daf8ae17e3655a6b
+  data.tar.gz: d95f7027035fcc519a20a173188f5adee392c24a
+SHA512:
+  metadata.gz: 1a674c9889c8739f5384d6a34c3cd13e1ff49f1e156a9eecef298b606a76d5a2c381dbc7187dcbfe37ca5ff69f295371be11296979f5f6b851dccbf825b820ec
+  data.tar.gz: 2a899b321f8ddcc8dc83850e95c815efecd11e8bb022a4d599c40862898445049994f6b2ac9a17b8a70496c081eb5c6cebf4c7c95a30c25323d59f7498786179

data/lib/cashbill.rb

@@ -0,0 +1,336 @@
+# -*- coding: utf-8 -*-
+require_relative './popbill.rb'
+
+# 팝빌 현금영수증 API Service Implementation
+class CashbillService < BaseService
+  class << self
+    def instance(linkID, secretKey)
+      super(linkID, secretKey)
+      @instance ||= new
+      @instance.addScope("140")
+      return @instance
+    end
+    private :new
+  end
+
+  def getChargeInfo(corpNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget('/Cashbill/ChargeInfo', corpNum, userID)
+  end
+
+  def getURL(corpNum, togo, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/Cashbill?TG=#{togo}", corpNum, userID)['url']
+  end
+
+  def getUnitCost(corpNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/Cashbill?cfg=UNITCOST", corpNum, userID)['unitCost']
+  end
+
+  def checkMgtKeyInUse(corpNum, mgtKey, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new(-99999999, "현금영수증 문서관리번호가 입력되지 않았습니다.")
+    end
+
+    begin
+      response = httpget("/Cashbill/#{mgtKey}", corpNum)
+      return response['itemKey'].length != 0
+    rescue PopbillException => pe
+      if pe.code == -14000003
+        return false
+      end
+      raise PopbillException.new(pe.code, pe.message)
+    end
+  end
+
+
+  def registIssue(corpNum, cashbill, memo = '', userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    postData = cashbill.to_json
+
+    httppost("/Cashbill", corpNum, postData, "ISSUE", userID)
+  end
+
+
+  def register(corpNum, cashbill, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    postData = cashbill.to_json
+
+    httppost("/Cashbill", corpNum, postData, "", userID)
+  end
+
+
+  def update(corpNum, mgtKey, cashbill, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    postData = cashbill.to_json
+
+    httppost("/Cashbill/#{mgtKey}", corpNum, postData, "PATCH", userID)
+  end
+
+  def issue(corpNum, mgtKey, memo = '', userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    postData = {}
+
+    if memo.to_s != ''
+      postData["memo"] = memo
+    end
+
+    postData = postData.to_json
+
+    httppost("/Cashbill/#{mgtKey}", corpNum, postData, "ISSUE", userID)
+  end
+
+  def cancelIssue(corpNum, mgtKey, memo = '', userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    postData = {}
+
+    if memo.to_s != ''
+      postData["memo"] = memo
+    end
+
+    postData = postData.to_json
+
+    httppost("/Cashbill/#{mgtKey}", corpNum, postData, "CANCELISSUE", userID)
+  end
+
+  def delete(corpNum, mgtKey, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    httppost("/Cashbill/#{mgtKey}", corpNum, "", "DELETE", userID)
+  end
+
+  def search(corpNum, dType, sDate, eDate, state, tradeType, tradeUsage,
+    taxationType, page, perPage, order, queryString = '', userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if dType.to_s == ''
+      raise PopbillException.new('-99999999', '검색일자유형이 입력되지 않았습니다.')
+    end
+
+    if sDate.to_s == ''
+      raise PopbillException.new('-99999999', '시작일자가 입력되지 않았습니다.')
+    end
+
+    if eDate.to_s == ''
+      raise PopbillException.new('-99999999', '종료일자가 입력되지 않았습니다.')
+    end
+
+    uri = "/Cashbill/Search?DType=#{dType}&SDate=#{sDate}&EDate=#{eDate}"
+    uri += "&State" + state.join(',')
+    uri += "&TradeUsage" + tradeUsage.join(',')
+    uri += "&TradeType" + tradeType.join(',')
+    uri += "&TaxationType" + taxationType.join(',')
+    uri += "&Page=" + page.to_s
+    uri += "&PerPage=" + perPage.to_s
+    uri += "&Order=" + order
+
+    if queryString.to_s != ''
+      uri += "&QString=" + queryString
+    end
+
+    httpget(URI.escape(uri), corpNum, userID)
+  end
+
+  def getInfo(corpNum, mgtKey, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '관리번호가 입력되지 않았습니다.')
+    end
+
+    httpget("/Cashbill/#{mgtKey}", corpNum, userID)
+  end
+
+
+  def getInfos(corpNum, mgtKeyList, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    unless mgtKeyList.any?
+      raise PopbillException.new('-99999999', '문서관리번호 배열이 올바르지 않습니다.')
+    end
+
+    postData = mgtKeyList.to_json
+
+    httppost("/Cashbill/States", corpNum, postData, "", userID)
+  end
+
+
+  def getDetailInfo(corpNum, mgtKey, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '관리번호가 입력되지 않았습니다.')
+    end
+
+    httpget("/Cashbill/#{mgtKey}?Detail", corpNum, userID)
+  end
+
+  def sendEmail(corpNum, mgtKey, receiverMail, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '문서관리번호 올바르지 않습니다.')
+    end
+
+    postData = {}
+
+    if receiverMail.to_s != ''
+      postData["receiver"] = receiverMail
+    end
+
+    postData = postData.to_json
+
+    httppost("/Cashbill/#{mgtKey}", corpNum, postData, "EMAIL", userID)
+  end
+
+
+  def sendSMS(corpNum, mgtKey, senderNum, receiverNum, contents, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '문서관리번호 올바르지 않습니다.')
+    end
+
+    if senderNum.to_s == ''
+      raise PopbillException.new('-99999999', '발신번호가 입력되지 않았습니다.')
+    end
+
+    if receiverNum.to_s == ''
+      raise PopbillException.new('-99999999', '수신번호가 입력되지 않았습니다.')
+    end
+
+    if contents.to_s == ''
+      raise PopbillException.new('-99999999', '문자 메시지 내용이 입력되지 않았습니다.')
+    end
+
+    postData = {}
+    postData["sender"] = senderNum
+    postData["receiver"] = receiverNum
+    postData["contents"] = contents
+
+    postData = postData.to_json
+
+    httppost("/Cashbill/#{mgtKey}", corpNum, postData, "SMS", userID)
+  end
+
+
+  def sendFax(corpNum, mgtKey, senderNum, receiverNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '문서관리번호 올바르지 않습니다.')
+    end
+
+    if senderNum.to_s == ''
+      raise PopbillException.new('-99999999', '발신번호가 입력되지 않았습니다.')
+    end
+
+    if receiverNum.to_s == ''
+      raise PopbillException.new('-99999999', '수신번호가 입력되지 않았습니다.')
+    end
+
+    postData = {}
+    postData["sender"] = senderNum
+    postData["receiver"] = receiverNum
+
+    postData = postData.to_json
+
+    httppost("/Cashbill/#{mgtKey}", corpNum, postData, "FAX", userID)
+
+  end
+
+
+  def getLogs(corpNum, mgtKey, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '문서관리번호 올바르지 않습니다.')
+    end
+    httpget("/Cashbill/#{mgtKey}/Logs", corpNum, userID)
+  end
+
+
+  def getPopUpURL(corpNum, mgtKey, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '문서관리번호 올바르지 않습니다.')
+    end
+
+    httpget("/Cashbill/#{mgtKey}?TG=POPUP", corpNum, userID)['url']
+  end
+
+  def getPrintURL(corpNum, mgtKey, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '문서관리번호 올바르지 않습니다.')
+    end
+
+    httpget("/Cashbill/#{mgtKey}?TG=PRINT", corpNum, userID)['url']
+  end
+
+
+  def getEPrintURL(corpNum, mgtKey, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if mgtKey.to_s == ''
+      raise PopbillException.new('-99999999', '문서관리번호 올바르지 않습니다.')
+    end
+
+    httpget("/Cashbill/#{mgtKey}?TG=EPRINT", corpNum, userID)['url']
+  end
+
+
+  def getMassPrintURL(corpNum, mgtKeyList, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    unless mgtKeyList.any?
+      raise PopbillException.new('-99999999', '문서관리번호 배열이 올바르지 않습니다.')
+    end
+
+    postData = mgtKeyList.to_json
+
+    httppost("/Cashbill/Prints", corpNum, postData, "", userID)['url']
+  end
+
+end # end of CashbillService

data/lib/closedown.rb

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*-
+require_relative './popbill.rb'
+
+# 팝빌 휴폐업조회 API Service Implementation
+class ClosedownService < BaseService
+  class << self
+    def instance(linkID, secretKey)
+      super(linkID, secretKey)
+      @instance ||= new
+      @instance.addScope("170")
+      return @instance
+    end
+    private :new
+  end
+
+  def getChargeInfo(corpNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/CloseDown/ChargeInfo", corpNum, userID)
+  end
+
+  def getUnitCost(corpNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/CloseDown/UnitCost", corpNum, userID)['unitCost']
+  end
+
+  def checkCorpNum(corpNum, checkCorpNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    if checkCorpNum.to_s == ''
+      raise PopbillException.new(-99999999, "조회할 사업자등록번호가 입력되지 않았습니다.")
+    end
+
+    httpget("/CloseDown?CN=#{checkCorpNum}", corpNum, userID)
+  end
+
+  def checkCorpNums(corpNum, checkCorpNums, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    if checkCorpNums.length == 0
+      raise PopbillException.new(-99999999, "조회할 사업자등록번호 배열이 입력되지 않았습니다.")
+    end
+
+    httppost("/CloseDown", corpNum, checkCorpNums.to_json)
+  end
+
+
+
+end # end of FaxService

data/lib/fax.rb

@@ -0,0 +1,110 @@
+# -*- coding: utf-8 -*-
+require_relative './popbill.rb'
+
+# 팝빌 팩스 API Service Implementation
+class FaxService < BaseService
+  class << self
+    def instance(linkID, secretKey)
+      super(linkID, secretKey)
+      @instance ||= new
+      @instance.addScope("160")
+      return @instance
+    end
+    private :new
+  end
+
+  def getChargeInfo(corpNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/FAX/ChargeInfo", corpNum, userID)
+  end
+
+  def getURL(corpNum, togo, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/FAX/?TG=#{togo}", corpNum, userID)['url']
+  end
+
+  def getUnitCost(corpNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/FAX/UnitCost", corpNum, userID)['unitCost']
+  end
+
+  def search(corpNum, sDate, eDate, state, reserveYN, senderOnly, page, perPage,
+    order, userID = '')
+    if corpNum.length != 10
+          raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if sDate.to_s == ''
+      raise PopbillException.new('-99999999', '시작일자가 입력되지 않았습니다.')
+    end
+    if eDate.to_s == ''
+      raise PopbillException.new('-99999999', '종료일자가 입력되지 않았습니다.')
+    end
+
+    uri = "/FAX/Search?SDate=#{sDate}&EDate=#{eDate}"
+    uri += "&State=" + state.join(',')
+    uri += "&ReserveYN=" + reserveYN
+    uri += "&SenderOnly=" + senderOnly
+    uri += "&Page=" + page.to_s
+    uri += "&PerPage=" + perPage.to_s
+    uri += "&Order=" + order
+
+    httpget(URI.escape(uri), corpNum, userID)
+  end
+
+  def sendFax(corpNum, senderNum, senderName, receiverNum, receiverName, filePath,
+    reserveDT = '', userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    receiver = [
+      {
+        "rcv" => receiverNum,
+        "rcvnm" => receiverName,
+      }
+    ]
+
+    sendFax_multi(corpNum, senderNum, senderName, receiver, filePath, reserveDT, userID)
+  end
+
+  def sendFax_multi(corpNum, senderNum, senderName, receivers, filePaths,
+    reserveDT = '', userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    postData = {}
+    postData["snd"] = senderNum
+    postData["sndnm"] = senderName
+    postData["fCnt"] = filePaths.length
+    postData["sndDT"] = reserveDT
+    postData["rcvs"] = receivers
+
+    httppostfile("/FAX", corpNum, postData, filePaths, userID)['receiptNum']
+  end
+
+  def getFaxDetail(corpNum, receiptNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    httpget("/FAX/#{receiptNum}", corpNum, userID)
+  end
+
+  def cancelReserve(corpNum, receiptNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    httpget("/FAX/#{receiptNum}/Cancel", corpNum, userID)
+  end
+
+
+
+end # end of FaxService

data/lib/htCashbill.rb

@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+require_relative './popbill.rb'
+
+# 팝빌 홈택스 현금영수증 연계 API Service Implementation
+class HTCashbillService < BaseService
+  class << self
+    def instance(linkID, secretKey)
+      super(linkID, secretKey)
+      @instance ||= new
+      @instance.addScope("141")
+      return @instance
+    end
+    private :new
+  end
+
+  def getChargeInfo(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    httpget("/HomeTax/Cashbill/ChargeInfo", corpNum, userID)
+  end
+
+  def requestJob(corpNum, type, sDate, eDate, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if sDate.to_s == ''
+      raise PopbillException.new('-99999999', '시작일자가 입력되지 않았습니다.')
+    end
+    if eDate.to_s == ''
+      raise PopbillException.new('-99999999', '종료일자가 입력되지 않았습니다.')
+    end
+
+    uri = "/HomeTax/Cashbill/#{type}?SDate=#{sDate}&EDate=#{eDate}"
+
+    httppost(uri, corpNum, "", "", userID)['jobID']
+  end
+
+  def getJobState(corpNum, jobID, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if jobID.to_s == ''
+      raise PopbillException.new('-99999999', '작업아이디(jobID)가 입력되지 않았습니다.')
+    end
+
+    httpget("/HomeTax/Cashbill/#{jobID}/State", corpNum, userID)
+  end
+
+  def listActiveJob(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Cashbill/JobList", corpNum, userID)
+  end
+
+  def search(corpNum, jobID, tradeType, tradeUsage, page, perPage, order, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if jobID.length != 18
+      raise PopbillException.new('-99999999', '작업아이디(jobID)가 올바르지 않습니다.')
+    end
+
+    uri = "/HomeTax/Cashbill/#{jobID}"
+    uri += "?TradeType=" + tradeType.join(',')
+    uri += "&TradeUsage=" + tradeUsage.join(',')
+    uri += "&Page=" + page.to_s
+    uri += "&PerPage=" + perPage.to_s
+    uri += "&Order=" + order
+
+    httpget(URI.escape(uri), corpNum, userID)
+  end
+
+  def summary(corpNum, jobID, tradeType, tradeUsage, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if jobID.length != 18
+      raise PopbillException.new('-99999999', '작업아이디(jobID)가 올바르지 않습니다.')
+    end
+
+    uri = "/HomeTax/Cashbill/#{jobID}/Summary"
+    uri += "?TradeType=" + tradeType.join(',')
+    uri += "&TradeUsage=" + tradeUsage.join(',')
+
+    httpget(URI.escape(uri), corpNum, userID)
+  end
+
+  def getFlatRatePopUpURL(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Cashbill?TG=CHRG", corpNum, userID)['url']
+  end
+
+  def getCertificatePopUpURL(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Cashbill?TG=CERT", corpNum, userID)['url']
+  end
+
+  def getFlatRateState(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Cashbill/Contract", corpNum, userID)
+  end
+
+  def getCertificateExpireDate(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Cashbill/CertInfo", corpNum, userID)['certificateExpiration']
+  end
+
+end # end of HTCashbillService