popbill 1.0.0

data/lib/htTaxinvoice.rb

@@ -0,0 +1,170 @@
+# -*- coding: utf-8 -*-
+require_relative './popbill.rb'
+
+# 팝빌 홈택스 세금계산서 연계 API Service Implementation
+class HTTaxinvoiceService < BaseService
+  class << self
+    def instance(linkID, secretKey)
+      super(linkID, secretKey)
+      @instance ||= new
+      @instance.addScope("111")
+      return @instance
+    end
+    private :new
+  end
+
+  def getChargeInfo(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    httpget("/HomeTax/Taxinvoice/ChargeInfo", corpNum, userID)
+  end
+
+  def requestJob(corpNum, type, dType, sDate, eDate, 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 = "/HomeTax/Taxinvoice/#{type}?DType=#{dType}&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/Taxinvoice/#{jobID}/State", corpNum, userID)
+  end
+
+  def listActiveJob(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Taxinvoice/JobList", corpNum, userID)
+  end
+
+  def search(corpNum, jobID, type, taxType, purposeType, taxRegIDType, taxRegIDYN,
+    taxRegID, 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/Taxinvoice/#{jobID}"
+    uri += "?Type=" + type.join(',')
+    uri += "&TaxType=" + taxType.join(',')
+    uri += "&PurposeType=" + purposeType.join(',')
+    uri += "&TaxRegIDType=" + taxRegIDType
+    uri += "&TaxRegID=" + taxRegID
+    uri += "&Page=" + page.to_s
+    uri += "&PerPage=" + perPage.to_s
+    uri += "&Order=" + order
+
+    if taxRegIDYN.to_s != ''
+      uri += "&TaxRegIDYN=" + taxRegIDYN
+    end
+
+    httpget(URI.escape(uri), corpNum, userID)
+  end
+
+  def summary(corpNum, jobID, type, taxType, purposeType, taxRegIDType, taxRegIDYN,
+    taxRegID, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if jobID.length != 18
+      raise PopbillException.new('-99999999', '작업아이디(jobID)가 올바르지 않습니다.')
+    end
+
+    uri = "/HomeTax/Taxinvoice/#{jobID}/Summary"
+    uri += "?Type=" + type.join(',')
+    uri += "&TaxType=" + taxType.join(',')
+    uri += "&PurposeType=" + purposeType.join(',')
+    uri += "&TaxRegIDType=" + taxRegIDType
+    uri += "&TaxRegID=" + taxRegID
+
+    if taxRegIDYN.to_s != ''
+      uri += "&TaxRegIDYN=" + taxRegIDYN
+    end
+
+    httpget(URI.escape(uri), corpNum, userID)
+  end
+
+  def getTaxinvoice(corpNum, ntsConfirmNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if ntsConfirmNum.length != 24
+      raise PopbillException.new('-99999999', '전자세금계산서 국세청승인번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Taxinvoice/#{ntsConfirmNum}", corpNum, userID)
+  end
+
+  def getXML(corpNum, ntsConfirmNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+    if ntsConfirmNum.length != 24
+      raise PopbillException.new('-99999999', '전자세금계산서 국세청승인번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Taxinvoice/#{ntsConfirmNum}?T=xml", corpNum, userID)
+  end
+
+  def getFlatRatePopUpURL(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Taxinvoice?TG=CHRG", corpNum, userID)['url']
+  end
+
+  def getCertificatePopUpURL(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Taxinvoice?TG=CERT", corpNum, userID)['url']
+  end
+
+  def getFlatRateState(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Taxinvoice/Contract", corpNum, userID)
+  end
+
+  def getCertificateExpireDate(corpNum, userID = "")
+    if corpNum.length != 10
+      raise PopbillException.new('-99999999', '사업자등록번호가 올바르지 않습니다.')
+    end
+
+    httpget("/HomeTax/Taxinvoice/CertInfo", corpNum, userID)['certificateExpiration']
+  end
+
+end # end of HTTaxinvoiceService
+
+module KeyType
+  SELL = "SELL"
+  BUY = "BUY"
+  TRUSTEE = "TRUSTEE"
+end

data/lib/message.rb

@@ -0,0 +1,272 @@
+# -*- coding: utf-8 -*-
+require_relative './popbill.rb'
+
+# 팝빌 문자 API Service Implementation
+class MessageService < BaseService
+  class << self
+    def instance(linkID, secretKey)
+      super(linkID, secretKey)
+      @instance ||= new
+      @instance.addScope("150")
+      @instance.addScope("151")
+      @instance.addScope("152")
+      return @instance
+    end
+    private :new
+  end
+
+  def getChargeInfo(corpNum, msgType, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/Message/ChargeInfo?Type=#{msgType}", corpNum, userID)
+  end
+
+  def getAutoDenyList(corpNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/Message/Denied", corpNum, userID)
+  end
+
+  def getUnitCost(corpNum, msgType, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    httpget("/Message/UnitCost?Type=#{msgType}", corpNum, userID)['unitCost']
+  end
+
+
+  def sendMessage(msgType, corpNum, sender, senderName, subject, contents,
+    messages, reserveDT, adsYN = false, userID = '')
+
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    req = {}
+
+    if sender.to_s != ''
+      req["snd"] = sender
+    end
+    if senderName.to_s != ''
+      req["sndnm"] = senderName
+    end
+    if subject.to_s != ''
+      req["subject"] = subject
+    end
+    if contents.to_s != ''
+      req["content"] = contents
+    end
+    if reserveDT.to_s != ''
+      req["sndDT"] = reserveDT
+    end
+    if messages.to_s != ''
+      req["msgs"] = messages
+    end
+    if adsYN
+      req["adsYN"] = true
+    end
+
+    postData = req.to_json
+
+    httppost("/#{msgType}", corpNum, postData, "", userID)['receiptNum']
+  end
+
+
+  def sendSMS(corpNum, sender, senderName, receiver, receiverName, contents,
+    reserveDT = '', adsYN = false, userID = '')
+
+    messages = [
+      {
+        "snd" => sender,
+        "sndName" => senderName,
+        "rcv" => receiver,
+        "rcvnm" => receiverName,
+        "msg" => contents,
+      }
+    ]
+    sendMessage("SMS", corpNum, '', '', '', '', messages, reserveDT,
+      adsYN, userID
+    )
+  end
+
+  def sendSMS_multi(corpNum, sender, senderName, contents, messages, reserveDT = '',
+    adsYN = false, userID = '')
+
+    sendMessage("SMS", corpNum, sender, senderName, '', contents, messages, reserveDT,
+      adsYN, userID
+    )
+  end
+
+
+  def sendLMS(corpNum, sender, senderName, receiver, receiverName, subject, contents,
+    reserveDT = '', adsYN = false, userID = '')
+
+    messages = [
+      {
+        "snd" => sender,
+        "sndName" => senderName,
+        "rcv" => receiver,
+        "rcvnm" => receiverName,
+        "msg" => contents,
+        "sjt" => subject,
+      }
+    ]
+
+    sendMessage("LMS", corpNum, '', '', '', '', messages, reserveDT,
+      adsYN, userID
+    )
+  end
+
+  def sendXMS_multi(corpNum, sender, senderName, subject, contents, messages,
+    reserveDT = '', adsYN = false, userID = '')
+
+    sendMessage("XMS", corpNum, sender, senderName, subject, contents, messages,
+      reserveDT, adsYN, userID
+    )
+  end
+
+  def sendXMS(corpNum, sender, senderName, receiver, receiverName, subject, contents,
+    reserveDT = '', adsYN = false, userID = '')
+
+    messages = [
+      {
+        "snd" => sender,
+        "sndName" => senderName,
+        "rcv" => receiver,
+        "rcvnm" => receiverName,
+        "msg" => contents,
+        "sjt" => subject,
+      }
+    ]
+
+    sendMessage("XMS", corpNum, '', '', '', '', messages, reserveDT,
+      adsYN, userID
+    )
+  end
+
+  def sendLMS_multi(corpNum, sender, senderName, subject, contents, messages,
+    reserveDT = '', adsYN = false, userID = '')
+
+    sendMessage("LMS", corpNum, sender, senderName, subject, contents, messages,
+      reserveDT, adsYN, userID
+    )
+  end
+
+
+  def sendMMS(corpNum, sender, senderName, receiver, receiverName, subject, contents,
+    filePath, reserveDT = '', adsYN = false, userID = '')
+
+    messages = [
+      {
+        "snd" => sender,
+        "sndnm" => senderName,
+        "rcv" => receiver,
+        "rcvnm" => receiverName,
+        "msg" => contents,
+        "sjt" => subject,
+      }
+    ]
+
+    sendMMS_multi(corpNum, sender, senderName, subject, contents, messages, filePath,
+      reserveDT, adsYN, userID
+    )
+  end
+
+  def sendMMS_multi(corpNum, sender, senderName, subject, contents, messages, filePath,
+    reserveDT = '', adsYN = false, userID = '')
+
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    req = {}
+
+    if sender.to_s != ''
+      req["snd"] = sender
+    end
+    if senderName.to_s != ''
+      req["sndnm"] = senderName
+    end
+    if subject.to_s != ''
+      req["subject"] = subject
+    end
+    if contents.to_s != ''
+      req["content"] = contents
+    end
+    if reserveDT.to_s != ''
+      req["sndDT"] = reserveDT
+    end
+    if messages.to_s != ''
+      req["msgs"] = messages
+    end
+    if adsYN
+      req["adsYN"] = true
+    end
+
+    httppostfile("/MMS", corpNum, req, [filePath], userID)['receiptNum']
+  end
+
+  def getMessages(corpNum, receiptNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    if receiptNum.to_s == ''
+      raise PopbillException.new(-99999999, "접수번호(receiptNum)가 입력되지 않았습니다.")
+    end
+
+    httpget("/Message/#{receiptNum}", corpNum, userID)
+  end
+
+  def cancelReserve(corpNum, receiptNum, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+    if receiptNum.to_s == ''
+      raise PopbillException.new(-99999999, "접수번호(receiptNum)가 입력되지 않았습니다.")
+    end
+
+    httpget("/Message/#{receiptNum}/Cancel", corpNum, userID)
+  end
+
+  def getURL(corpNum, togo, userID = '')
+    if corpNum.length != 10
+      raise PopbillException.new(-99999999, "사업자등록번호가 올바르지 않습니다.")
+    end
+
+    httpget("/Message/?TG=#{togo}", corpNum, userID)['url']
+  end
+
+  def search(corpNum, sDate, eDate, state, item, reserveYN, senderYN, 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 = "/Message/Search?SDate=#{sDate}&EDate=#{eDate}"
+    uri += "&State=" + state.join(',')
+    uri += "&Item=" + item.join(',')
+    uri += "&ReserveYN=" + reserveYN
+    uri += "&SenderYN=" + senderYN
+    uri += "&Page=" + page.to_s
+    uri += "&PerPage=" + perPage.to_s
+    uri += "&Order=" + order
+
+    httpget(URI.escape(uri), corpNum, userID)
+  end
+
+
+end # end of MessageService
+
+module MsgType
+  SMS = "SMS"
+  LMS = "LMS"
+  MMS = "MMS"
+end