Written by laravel-style
on 2020-03-31

[PHP - Laravel] 팝빌 전자세금계산서 API 연동 가이드

// 컨트롤러 함수 추가 영역.

}

$this->PopbillTaxinvoice->IsTest(config('popbill.IsTest'));

// 연동환경 설정값, 개발용(true), 상업용(false)

$this->PopbillTaxinvoice = new PopbillTaxinvoice(config('popbill.LinkID'), config('popbill.SecretKey'));

// 세금계산서 서비스 클래스 초기화

define('LINKHUB_COMM_MODE', config('popbill.LINKHUB_COMM_MODE'));

// 통신방식 설정

public function __construct () {

{

class TaskController extends Controller

use Linkhub\Popbill\TaxinvoiceAddContact;

use Linkhub\Popbill\TaxinvoiceDetail;

use Linkhub\Popbill\Taxinvoice;

use Linkhub\Popbill\TIENumMgtKeyType;

use Linkhub\Popbill\PopbillTaxinvoice;

use Linkhub\Popbill\PopbillException;

use Linkhub\Popbill\ChargeInfo;

use Linkhub\Popbill\ContactInfo;

use Linkhub\Popbill\CorpInfo;

use Linkhub\Popbill\JoinForm;

use Linkhub\LinkhubException;

use Illuminate\Http\Request;

namespace App\Http\Controllers;

TaskController에 세금계산서 발행 API를 호출하는 함수를 추가합니다.

RegistIssue API 닫기

public function RegistIssue(){ // 팝빌회원 사업자번호, '-' 제외 10자리 $testCorpNum = '1234567890'; // 팝빌회원 아이디 $testUserID = 'testkorea'; // 세금계산서 문서관리번호 // - 최대 24자리 숫자, 영문, '-', '_' 조합으로 사업자별로 중복되지 않도록 구성 $invoicerMgtKey = '20190213-001'; // 지연발행 강제여부 $forceIssue = false; // 즉시발행 메모 $memo = '즉시발행 메모'; // 안내메일 제목, 미기재시 기본제목으로 전송 $emailSubject = ''; // 거래명세서 동시작성 여부 $writeSpecification = false; // 거래명세서 동시작성시 명세서 관리번호 // - 최대 24자리 숫자, 영문, '-', '_' 조합으로 사업자별로 중복되지 않도록 구성 $dealInvoiceMgtKey = ''; /************************************************************ * 세금계산서 정보 ************************************************************/ // 세금계산서 객체 생성 $Taxinvoice = new Taxinvoice(); // [필수] 작성일자, 형식(yyyyMMdd) 예)20150101 $Taxinvoice->writeDate = '20190213'; // [필수] 발행형태, '정발행', '역발행', '위수탁' 중 기재 $Taxinvoice->issueType = '정발행'; // [필수] 과금방향, // - '정과금'(공급자 과금), '역과금'(공급받는자 과금) 중 기재, 역과금은 역발행시에만 가능. $Taxinvoice->chargeDirection = '정과금'; // [필수] '영수', '청구' 중 기재 $Taxinvoice->purposeType = '영수'; // [필수] 과세형태, '과세', '영세', '면세' 중 기재 $Taxinvoice->taxType = '과세'; // [필수] 발행시점 $Taxinvoice->issueTiming = '직접발행'; /************************************************************ * 공급자 정보 ************************************************************/ // [필수] 공급자 사업자번호 $Taxinvoice->invoicerCorpNum = $testCorpNum; // 공급자 종사업장 식별번호, 4자리 숫자 문자열 $Taxinvoice->invoicerTaxRegID = ''; // [필수] 공급자 상호 $Taxinvoice->invoicerCorpName = '공급자상호'; // [필수] 공급자 문서관리번호, 최대 24자리 숫자, 영문, '-', '_' 조합으로 사업자별로 중복되지 않도록 구성 $Taxinvoice->invoicerMgtKey = $invoicerMgtKey; // [필수] 공급자 대표자성명 $Taxinvoice->invoicerCEOName = '공급자 대표자성명'; // 공급자 주소 $Taxinvoice->invoicerAddr = '공급자 주소'; // 공급자 종목 $Taxinvoice->invoicerBizClass = '공급자 종목'; // 공급자 업태 $Taxinvoice->invoicerBizType = '공급자 업태'; // 공급자 담당자 성명 $Taxinvoice->invoicerContactName = '공급자 담당자성명'; // 공급자 담당자 메일주소 $Taxinvoice->invoicerEmail = '[email protected]'; // 공급자 담당자 연락처 $Taxinvoice->invoicerTEL = '070-4304-2991'; // 공급자 휴대폰 번호 $Taxinvoice->invoicerHP = '010-111-222'; // 발행시 알림문자 전송여부 (정발행에서만 사용가능) // - 공급받는자 주)담당자 휴대폰번호(invoiceeHP1)로 전송 // - 전송시 포인트가 차감되며 전송실패하는 경우 포인트 환불처리 $Taxinvoice->invoicerSMSSendYN = false; /************************************************************ * 공급받는자 정보 ************************************************************/ // [필수] 공급받는자 구분, '사업자', '개인', '외국인' 중 기재 $Taxinvoice->invoiceeType = '사업자'; // [필수] 공급받는자 사업자번호 $Taxinvoice->invoiceeCorpNum = '8888888888'; // 공급받는자 종사업장 식별번호, 4자리 숫자 문자열 $Taxinvoice->invoiceeTaxRegID = ''; // [필수] 공급자 상호 $Taxinvoice->invoiceeCorpName = '공급받는자 상호'; // [역발행시 필수] 공급받는자 문서관리번호, 최대 24자리 숫자, 영문, '-', '_' 조합으로 사업자별로 중복되지 않도록 구성 $Taxinvoice->invoiceeMgtKey = ''; // [필수] 공급받는자 대표자성명 $Taxinvoice->invoiceeCEOName = '공급받는자 대표자성명'; // 공급받는자 주소 $Taxinvoice->invoiceeAddr = '공급받는자 주소'; // 공급받는자 업태 $Taxinvoice->invoiceeBizType = '공급받는자 업태'; // 공급받는자 종목 $Taxinvoice->invoiceeBizClass = '공급받는자 종목'; // 공급받는자 담당자 성명 $Taxinvoice->invoiceeContactName1 = '공급받는자 담당자성명'; // 공급받는자 담당자 메일주소 $Taxinvoice->invoiceeEmail1 = '[email protected]'; // 공급받는자 담당자 연락처 $Taxinvoice->invoiceeTEL1 = '070-111-222'; // 공급받는자 담당자 휴대폰 번호 $Taxinvoice->invoiceeHP1 = '010-111-222'; /************************************************************ * 세금계산서 기재정보 ************************************************************/ // [필수] 공급가액 합계 $Taxinvoice->supplyCostTotal = '200000'; // [필수] 세액 합계 $Taxinvoice->taxTotal = '20000'; // [필수] 합계금액, (공급가액 합계 + 세액 합계) $Taxinvoice->totalAmount = '220000'; // 기재상 '일련번호'항목 $Taxinvoice->serialNum = '123'; // 기재상 '현금'항목 $Taxinvoice->cash = ''; // 기재상 '수표'항목 $Taxinvoice->chkBill = ''; // 기재상 '어음'항목 $Taxinvoice->note = ''; // 기재상 '외상'항목 $Taxinvoice->credit = ''; // 기재상 '비고' 항목 $Taxinvoice->remark1 = '비고1'; $Taxinvoice->remark2 = '비고2'; $Taxinvoice->remark3 = '비고3'; // 기재상 '권' 항목, 최대값 32767 // 미기재시 $Taxinvoice->kwon = 'null'; $Taxinvoice->kwon = '1'; // 기재상 '호' 항목, 최대값 32767 // 미기재시 $Taxinvoice->ho = 'null'; $Taxinvoice->ho = '1'; // 사업자등록증 이미지파일 첨부여부 $Taxinvoice->businessLicenseYN = false; // 통장사본 이미지파일 첨부여부 $Taxinvoice->bankBookYN = false; /************************************************************ * 수정 세금계산서 기재정보 * - 수정세금계산서 관련 정보는 연동매뉴얼 또는 개발가이드 링크 참조 * - [참고] 수정세금계산서 작성방법 안내 - http://blog.linkhub.co.kr/650 ************************************************************/ // [수정세금계산서 작성시 필수] 수정사유코드, 수정사유에 따라 1~6중 선택기재 //$Taxinvoice->modifyCode = ''; // [수정세금계산서 작성시 필수] 원본세금계산서 ItemKey 기재, 문서확인 (GetInfo API)의 응답결과(ItemKey 항목) 확인 //$Taxinvoice->originalTaxinvoiceKey = ''; /************************************************************ * 상세항목(품목) 정보 ************************************************************/ $Taxinvoice->detailList = array(); $Taxinvoice->detailList[] = new TaxinvoiceDetail(); $Taxinvoice->detailList[0]->serialNum = 1; // 일련번호 1~99까지 순차기재, $Taxinvoice->detailList[0]->purchaseDT = '20190101'; // 거래일자 $Taxinvoice->detailList[0]->itemName = '품목명1번'; // 품명 $Taxinvoice->detailList[0]->spec = ''; // 규격 $Taxinvoice->detailList[0]->qty = ''; // 수량 $Taxinvoice->detailList[0]->unitCost = ''; // 단가 $Taxinvoice->detailList[0]->supplyCost = '100000'; // 공급가액 $Taxinvoice->detailList[0]->tax = '10000'; // 세액 $Taxinvoice->detailList[0]->remark = ''; // 비고 $Taxinvoice->detailList[] = new TaxinvoiceDetail(); $Taxinvoice->detailList[1]->serialNum = 2; // 일련번호 1~99까지 순차기재, $Taxinvoice->detailList[1]->purchaseDT = '20190101'; // 거래일자 $Taxinvoice->detailList[1]->itemName = '품목명2번'; // 품명 $Taxinvoice->detailList[1]->spec = ''; // 규격 $Taxinvoice->detailList[1]->qty = ''; // 수량 $Taxinvoice->detailList[1]->unitCost = ''; // 단가 $Taxinvoice->detailList[1]->supplyCost = '100000'; // 공급가액 $Taxinvoice->detailList[1]->tax = '10000'; // 세액 $Taxinvoice->detailList[1]->remark = ''; // 비고 /************************************************************ * 추가담당자 정보 * - 세금계산서 발행안내 메일을 수신받을 공급받는자 담당자가 다수인 경우 * 추가 담당자 정보를 등록하여 발행안내메일을 다수에게 전송할 수 있습니다. (최대 5명) ************************************************************/ $Taxinvoice->addContactList = array(); $Taxinvoice->addContactList[] = new TaxinvoiceAddContact(); $Taxinvoice->addContactList[0]->serialNum = 1; // 일련번호 1부터 순차기재 $Taxinvoice->addContactList[0]->email = '[email protected]'; // 이메일주소 $Taxinvoice->addContactList[0]->contactName = '팝빌담당자'; // 담당자명 $Taxinvoice->addContactList[] = new TaxinvoiceAddContact(); $Taxinvoice->addContactList[1]->serialNum = 2; // 일련번호 1부터 순차기재 $Taxinvoice->addContactList[1]->email = '[email protected]'; // 이메일주소 $Taxinvoice->addContactList[1]->contactName = '링크허브'; // 담당자명 try { $result = $this->PopbillTaxinvoice->RegistIssue($testCorpNum, $Taxinvoice, $testUserID, $writeSpecification, $forceIssue, $memo, $emailSubject, $dealInvoiceMgtKey); $code = $result->code; $message = $result->message; } catch(PopbillException | LinkhubException $pe) { $code = $pe->getCode(); $message = $pe->getMessage(); } return $code.' '.$message }

from http://linkhub.tistory.com/185 by ccl(S) rewrite - 2020-03-31 21:25:50

Top