Microsoft Word - 전자세금계산서 바로빌 Web service Spec v1_2.docx

전자세금계산서바로빌 연동 Web service Specification v1.2 2009. 9 문의 : 1544-8385, 바로빌연계서비스담당자 1 페이지

목 차 1. 개요... 4 1.1. 바로빌연동 Web service 의목적... 4 1.2. 바로빌연동 Web service 의구성... 4 1.3 연동사업자와발행사업자... 5 1.4 발행사업자관리번호... 5 2. 연동 Web service... 6 2.1 구성... 6 2.2. Web service End Point URI... 7 3. 기능상세설명... 8 3.1. CheckCorpIsMember... 8 3.2 GetCorpMemberContacts... 9 3.3. CheckIsValidTaxInvoice... 10 3.4. RegistTaxInvoice... 12 3.5. RegistTaxInvoicePlain... 14 3.6. RegisterBrokerTaxInvoice... 18 3.7. RegisterBrokerTaxInvoicePlain... 20 3.8. UpdateTaxInvoice... 24 3.9. UpdateTaxInvoicePlain... 26 3.10. UpdateBrokerTaxInvoice... 30 3.11. UpdateBrokerTaxInvoicePlain... 32 3.12. DeleteTaxInvoice... 36 3.13. DeleteTaxInvoiceIK... 37 3.14. GetTaxInvoiceState... 38 3.15. GetTaxInvoiceStateIK... 39 3.16. GetTaxInvoiceStateEX... 40 2 페이지

3.17. GetTaxInvoiceStates... 41 3.18. GetTaxInvoiceStatesIK... 42 3.19. IssueTaxInvoice... 43 3.20. ProcTaxInvoice... 44 3.21. AttachFileByFTP... 46 3.22. DeleteAttachFile... 47 4. 오류코드테이블... 48 5. SOAP 객체상세설명... 50 5.1. TaxInvoice... 50 5.3. TaxInvoiceTradeLineItem... 51 5.4. Contact... 52 5.5. ReturnVal... 52 6. Test Bed... 53 A. 부록... 54 A.1. Microsoft SOAP Toolkit 소개... 54 A.2. Borland Delphi 7 연동방법및유의사항... 55 A.3. Visual Basic 6 연동참고사항및 Sample Source... 58 A.4. 첨부파일전송기능 (MTOM : Message Transmission Optimization Mechanism )... 59 A.5. FTP 를이용한파일첨부방법안내... 60 3 페이지

1. 개요 1.1. 바로빌연동 Web service의목적자사의 ERP 또는기타기업용솔루션의전자세금계산서처리를위해바로빌과자료및기능연동을지원하기위하여표준화된 API제공이며, 이를통해, 전자적세금계산서업무처리와 2010년전자세금계산서법제화에따라국세청에전자적으로전송하는프로세스를바로빌을통해처리하여법제화에따른의무화에대비하는것이다. 1.2. 바로빌연동 Web service의구성바로빌연동서비스의구성은연계솔루션에서제공된 Web service를통해자료를전송하고, 전송된자료를확인하여, 바로빌을통해전자서명및발행하며, 최종국세청으로전송을한다. 연계솔루션은일련의과정을 Web service를통해주기적으로확인할수있다. 이를위해바로빌연동 Web service 는다음의기능과자료를제공한다. 가. 세금계산서작성에필요한회원사여부확인및회원사의담당자정보확인기능나. 세금계산서의임시저장 / 수정기능다. 전송한세금계산서의상태확인기능라. 전송한세금계산서의프로세스처리기능 [2009년 9월제공예정 ] 마. 국세청전송요청기능 [2009년 9월제공예정 ] 바. 국세청전송상태확인기능 [2009년 9월제공예정 ] 사. 다양한솔루션에서연동서비스를원활하게사용할수있는 Proxy Module 자료 [2009년 8월예정 ] 4 페이지

1.3 연동사업자와발행사업자연동사업자는바로빌연동 Web service를사용하기위해사전에 과연동방법등을사전에협의하고, 이에따라별첨의신청서를제출하여테스트용인증키를부여받는다. 테스트용인증키는테스트베드에서사용되는제한된인증키로실제바로빌에서는사용할수없다. 바로빌에서사용할수있는인증키는관련연동작업의완료후실인증키를신청하여추가로부여받아사용한다. 연계사업자는하나의인증키를사용하여여러발행사업자의전자세금계산서를연동할수있으나, 발행사업자는반드시바로빌에가입된회원사로제한한다. 이를구분하기위해서발행사업자의사업자등록번호를추가로요구한다. 부여된인증키는고유한값으로, 부여받은연계사업자가관리하며, 인증키의유출방지및불법적인용도의사용방지에대해책임을가진다. 1.4 발행사업자관리번호바로빌로전송하는모든세금계산서는 3개의관리번호로관리된다. 가. 바로빌에서생성시부여되는관리번호 (InvoiceKey) 나. 발행사업자가임의부여하여등록하는발행사업자관리번호 (MgtNum) 다. 국세청전송시에국세청전송용관리번호 (NTSConfirmNum) 3개의관리번호는모두바로빌에저장되며, 국세청전송시에도함께암호화되어전송된다. 바로빌관리번호와국세청전송용관리번호는바로빌자체적으로관리가되며, 발행사업자관리번호는발행하고자하는사업자가중복없는임의의문자로전송하여야하며, 최소 1자리에서최대 24자리까지지원한다. 등록시관리번호의기재위치는세금계산서의종류 ( 일반, 위수탁 ), 발행방향 ( 정발행, 역발행 ) 에따라위치가달라지며, 자세한사항은 5.1. TaxInvoice를참고하여기재한다. 5 페이지

2. 연동 Web service 2.1 구성바로빌연동 Web service 는 SOAP(Simple Object Access Protocol), WSDL(Web Services Description Language) 을이용하여제공되며, 이를지원하는시스템에서연동이가능하다. Web service를통해제공되는 Web method는 TaxInvoice, InvoiceParty등의 Complex Type을 Parameter로사용하며, 연동성을높이기위해등록수정등의 API는기본형 Data Type으로구성된인수형이제공되며, 기능은객체형과동일하나, 일부제약이따른다. Web method 호출에필요한문자는모두 UTF-8 character set을반드시따른다. Web method 기능비고 CheckCorpIsMember 바로빌가입여부확인 GetCorpMemberContacts 바로빌회원사의담당자목록확인 CheckIsValidTaxInvoice 세금계산서등록전유효성체크 RegistTaxInvoice 일반세금계산서등록 RegistTaxInvoicePlain 일반세금계산서등록 [ 인수형 ] RegistBrokerTaxInvoice 위수탁세금계산서등록 RegistBrokerTaxInvoicePlain 위수탁세금계산서등록 [ 인수형 ] UpdateTaxInvoice 일반세금계산서수정 임시저장상태만가능 UpdateTaxInvoicePlain 일반세금계산서수정 [ 인수형 ] 임시저장상태만가능 UpdateBrokerTaxInvoice 위수탁세금계산서수정 임시저장상태만가능 UpdateBrokerTaxInvoicePlain 위수탁세금계산서수정 [ 인수형 ] 임시저장상태만가능 DeleteTaxInvoice 계산서삭제 [ 자체관리번호 ] 임시저장, 승인 / 발행거부, 취소완료상태만가능 DeleteTaxInvoiceIK 계산서삭제 [ 바로빌관리번호 ] 임시저장, 승인 / 발행거부, 취소완료상태만가능 GetTaxInvoiceState 계산서상태확인 [ 자체관리번호 ] GetTaxInvoiceStateEX 계산서상태확인 [ 자체관리번호 ] 계산서상태에대한상세정보를반환함. GetTaxInvoiceStateIK 계산서상태확인 [ 바로빌관리번호 ] GetTaxInvoiceStates 계산서상태대량확인 [ 자체관리번호 ] 대량, 최대100건까지만처리 GetTaxInvoiceStatesIK 계산서상태대량확인 [ 바로빌관리번호 ] 대량, 최대100건까지만처리 IssueTaxInvoice 계산서발행 ( 정발행, 역발행, 위수탁포함 공인인증서및과금정보가필요함. 세부참조. ProcTaxInvoice 계산서프로세스처리 계산서에대한바로빌기능지원 AttachFileByFTP FTP전송화일계산서에첨부 DeleteAttachFile 계산서에첨부파일삭제 GetNTSSendState 국세청전송상태확인 2009년 10월예정 GetNTSSendStates 국체청전송상태대량확인 2009년 10월예정 각함수들의반환값은 int, 또는 ArrayOfReturnVal로제공되며, 반환값또는 ReturnVal.RetVal 값이음수의경우오류코드로처리, 0 이상의경우성공및기타처리에대한반환값이다. 오류코드는오류코드테이블을참조한다. 6 페이지

2.2. Web service End Point URI 연동을위해제공되는 End Point URI는다음과같다. 테스트베드 http://testws.barobill.co.kr/v1/barotiservice.asmx 바로빌 http://ws.barobill.co.kr/v1/barotiservice.asmx WSDL 은다음을참고한다. 테스트 http://testws.barobill.co.kr/v1/barotiservice.asmx?wsdl 바로빌 http://ws.barobill.co.kr/v1/barotiservice.asmx?wsdl 상기연동데이터의확인은바로빌에서확인이가능하다. 테스트베드 http://testbed.barobill.co.kr/ 바로빌 http://www.barobill.co.kr/ 별도로연동성지원을위해 RPC/Literal 형태의 WebService 를지원하고있다. URI와 WSDL은다음과같다. URI : http://testws.barobill.co.kr/v1/barotirpcservice.asmx WSDL :http://testws.barobill.co.kr/v1/barotirpcservice.asmx?wsdl 추가로 RPC/Encoded 등의지원이필요할경우 연동서비스담당자로문의한다. 7 페이지

3. 기능상세설명 3.1. CheckCorpIsMember 바로빌에가입한회원사여부를확인한다. 매개변수 타입 길이 설명 필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O CheckCorpNum String 13 확인할사업자등록번호 ( - 제외 ) O 반환값 : int -1 : 휴 / 폐업 -2 : 탈퇴함 0 : 가입하지않음 1 : 바로빌회원 SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/checkcorpismember" <CheckCorpIsMember xmlns="http://ws.barobill.co.kr/"> <CERTKEY>string</CERTKEY> <CheckCorpNum>string</CheckCorpNum> </CheckCorpIsMember> HTTP/1.1 200 OK <CheckCorpIsMemberResponse xmlns="http://ws.barobill.co.kr/"> <CheckCorpIsMemberResult>int</CheckCorpIsMemberResult> </CheckCorpIsMemberResponse> 8 페이지

3.2 GetCorpMemberContacts 바로빌회원사의담당자목록을반환한다. 매개변수 타입 길이 설명 필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O CheckCorpNum String 13 확인할사업자등록번호 ( - 제외 ) O 반환값 : ArrayofContact (5. SOAP 객체상세설명, Contact 참조 ) SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/getcorpmembercontacts" <GetCorpMemberContacts xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <CheckCorpNum>string</CheckCorpNum> </GetCorpMemberContacts> HTTP/1.1 200 OK <GetCorpMemberContactsResponse xmlns="http://ws.barobill.co.kr/v1/"> <GetCorpMemberContactsResult> <Contact> <ID>string</ID> <ContactName>string</ContactName> <Grade>string</Grade> <Email>string</Email> <TEL>string</TEL> <HP>string</HP> </Contact> <Contact> <ID>string</ID> <ContactName>string</ContactName> <Grade>string</Grade> <Email>string</Email> <TEL>string</TEL> <HP>string</HP> </Contact> </GetCorpMemberContactsResult> </GetCorpMemberContactsResponse> 9 페이지

3.3. CheckIsValidTaxInvoice TaxInvoice 객체의유효성을확인한다. 매개변수 타입 길이 설명 필수 CERTKEY String 40 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O Invoice TaxInvoice - 확인할전자세금계산서 (5. SOAP 객체상세설명참조 ) O 반환값 : int 1 : 유효. SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/checkisvalidtaxinvoice" <CheckIsValidTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <Invoice> <InvoiceKey>string</InvoiceKey> <InvoicerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoicerParty> <InvoiceeParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoiceeParty> <BrokerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> 10 페이지

</BrokerParty> <IssueDirection>int</IssueDirection> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifyCode>string</ModifyCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <WriteDate>string</WriteDate> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <TaxInvoiceTradeLineItems> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> </TaxInvoiceTradeLineItems> </Invoice> </CheckIsValidTaxInvoice> HTTP/1.1 200 OK <CheckIsValidTaxInvoiceResponse xmlns="http://ws.barobill.co.kr/v1/"> <CheckIsValidTaxInvoiceResult>int</CheckIsValidTaxInvoiceResult> </CheckIsValidTaxInvoiceResponse> 11 페이지

3.4. RegistTaxInvoice 일반세금계산서를임시저장함에등록한다. 위수탁세금계산서는 RegistBrokerTaxInvoice를사용한다. 매개변수 타입 길이 설명 필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O Invoice TaxInvoice - 등록할일반세금계산서 (5. SOAP 객체상세설명참조 ) O 반환값 : int 1 : 등록완료. SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/registtaxinvoice" <RegistTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <Invoice> <InvoiceKey>string</InvoiceKey> <InvoicerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoicerParty> <InvoiceeParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoiceeParty> <BrokerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> 12 페이지

<HP>string</HP> <Email>string</Email> </BrokerParty> <IssueDirection>int</IssueDirection> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifyCode>string</ModifyCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <WriteDate>string</WriteDate> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <TaxInvoiceTradeLineItems> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> </TaxInvoiceTradeLineItems> </Invoice> </RegistTaxInvoice> HTTP/1.1 200 OK <RegistTaxInvoiceResponse xmlns="http://ws.barobill.co.kr/v1/"> <RegistTaxInvoiceResult>int</RegistTaxInvoiceResult> </RegistTaxInvoiceResponse> 13 페이지

3.5. RegistTaxInvoicePlain 일반세금계산서를임시저장함에저장한다. 연동성지원을위한인수형. ( 매개변수의추가설명은 5. SOAP 객체설명을추가참고한다.) 매개변수타입길이설명필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O InvoiceKey String 24 바로빌관리번호 X IssueDirection Int 1 1: 정발행 2: 역발행 O InvoicerID String 12 공급자회원아이디대소문자구문함 O InvoicerCorpNum String 13 공급자사업자등록번호 O InvoicerMgtNum String 24 공급자관리번호 O InvoicerCorpName String 70 공급자상호 O InvoicerTaxRegID String 4 공급자종사업장식별번호 ( 단위과세제도 ) X InvoicerCEOName String 30 대표자성명 O InvoicerAddr String 150 공급자주소 O InvoicerBizClass String 40 공급자업종 O InvoicerBizType String 40 공급자업태 O InvoicerContactName String 30 공급자담당자성명 O InvoicerTEL String 20 공급자연락처 O InvoicerHP String 20 공급자휴대전화 O InvoicerEmail String 40 공급자이메일 O InvoiceeID String 12 공급받는자회원아이디대소문자구문함 X InvoiceeCorpNum String 13 공급받는자사업자등록번호 O InvoiceeMgtNum String 24 공급받는자관리번호 O InvoiceeCorpName String 70 공급받는자상호 O InvoiceeTaxRegID String 4 공급받는자종사업장식별번호 X InvoiceeCEOName String 30 공급받는자대표자성명 O InvoiceeAddr String 150 공급받는자주소 O InvoiceeBizClass String 40 공급받는자업종 O InvoiceeBizType String 40 공급받는자업태 O InvoiceeContactName String 30 공급받는자담당자성명 O InvoiceeTEL String 20 공급받는자연락처 O InvoiceeHP String 20 공급받는자휴대전화 O InvoiceeEmail String 40 공급받는자이메일 O TaxInvoiceType Int 1 세금계산서형태 O TaxType Int 1 과세형태 O TaxCalcType Int 1 세금계산형태 O PurposeType Int 1 영수 / 청구구분 O ModifyCode String 4 수정코드 ( 수정세금계산서일경우 ) 숫자만 X Kwon String 4 권숫자 X Ho String 4 호숫자 X SerialNum String 27 일련번호 X Cash String 18 현금 X ChkBill String 18 수표 X Note String 18 어음 X Credit String 18 외상미수금 X AmountTotal String 18 공급가액합계 O TaxTotal String 18 세액합계 O TotalAmount String 18 총액 O Remark1 String 150 비고1 X 14 페이지

Remark2 String 150 비고2 X Remark3 String 150 비고3 X LineItem1 Bool 1 1번상세유무 O PurchaseExpiry1 String 8 구매일자1 ( YYYYMMDD) X Name1 String 100 품목1 X Information1 String 60 규격1 X ChargeableUnit1 String 12.2 수량1 X UnitPrice1 String 18.2 단가1 X Amount1 String 18 공금가액1 X Tax1 String 18 세액1 X Description1 String 40 비고1 X LineItem2 Bool 1 2번상세유무 O PurchaseExpiry2 String 1 구매일자2 ( YYYYMMDD) X Name2 String 100 품목2 X Information2 String 60 규격2 X ChargeableUnit2 String 12.2 수량2 X UnitPrice2 String 18.2 단가2 X Amount2 String 18 공금가액2 X Tax2 String 18 세액2 X Description2 String 40 비고2 X LineItem3 Bool 1 3번상세유무 O PurchaseExpiry3 String 1 구매일자3 ( YYYYMMDD) X Name3 String 100 품목3 X Information3 String 60 규격3 X ChargeableUnit3 String 12.2 수량3 X UnitPrice3 String 18.2 단가3 X Amount3 String 18 공금가액3 X Tax3 String 18 세액3 X Description3 String 40 비고3 X LineItem4 Bool 1 4번상세유무 O PurchaseExpiry4 String 1 구매일자4 ( YYYYMMDD) X Name4 String 100 품목4 X Information4 String 60 규격4 X ChargeableUnit4 String 12.2 수량4 X UnitPrice4 String 18.2 단가4 X Amount4 String 18 공금가액4 X Tax4 String 18 세액4 X Description4 String 40 비고4 X 반환값 : int 1 : 등록완료 SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/registtaxinvoiceplain" <RegistTaxInvoicePlain xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> 15 페이지

16 페이지 <InvoiceKey>string</InvoiceKey> <IssueDirection>int</IssueDirection> <InvoicerID>string</InvoicerID> <InvoicerCorpNum>string</InvoicerCorpNum> <InvoicerMgtNum>string</InvoicerMgtNum> <InvoicerCorpName>string</InvoicerCorpName> <InvoicerTaxRegID>string</InvoicerTaxRegID> <InvoicerCEOName>string</InvoicerCEOName> <InvoicerAddr>string</InvoicerAddr> <InvoicerBizClass>string</InvoicerBizClass> <InvoicerBizType>string</InvoicerBizType> <InvoicerContactName>string</InvoicerContactName> <InvoicerTEL>string</InvoicerTEL> <InvoicerHP>string</InvoicerHP> <InvoicerEmail>string</InvoicerEmail> <InvoiceeID>string</InvoiceeID> <InvoiceeCorpNum>string</InvoiceeCorpNum> <InvoiceeMgtNum>string</InvoiceeMgtNum> <InvoiceeCorpName>string</InvoiceeCorpName> <InvoiceeTaxRegID>string</InvoiceeTaxRegID> <InvoiceeCEOName>string</InvoiceeCEOName> <InvoiceeAddr>string</InvoiceeAddr> <InvoiceeBizClass>string</InvoiceeBizClass> <InvoiceeBizType>string</InvoiceeBizType> <InvoiceeContactName>string</InvoiceeContactName> <InvoiceeTEL>string</InvoiceeTEL> <InvoiceeHP>string</InvoiceeHP> <InvoiceeEmail>string</InvoiceeEmail> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifyCode>string</ModifyCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <LineItem1>boolean</LineItem1> <PurchaseExpiry1>string</PurchaseExpiry1> <Name1>string</Name1> <Information1>string</Information1> <ChargeableUnit1>string</ChargeableUnit1> <UnitPrice1>string</UnitPrice1> <Amount1>string</Amount1> <Tax1>string</Tax1> <Description1>string</Description1> <LineItem2>boolean</LineItem2> <PurchaseExpiry2>string</PurchaseExpiry2> <Name2>string</Name2> <Information2>string</Information2> <ChargeableUnit2>string</ChargeableUnit2> <UnitPrice2>string</UnitPrice2> <Amount2>string</Amount2> <Tax2>string</Tax2> <Description2>string</Description2> <LineItem3>boolean</LineItem3> <PurchaseExpiry3>string</PurchaseExpiry3> <Name3>string</Name3> <Information3>string</Information3> <ChargeableUnit3>string</ChargeableUnit3> <UnitPrice3>string</UnitPrice3> <Amount3>string</Amount3> <Tax3>string</Tax3> <Description3>string</Description3> <LineItem4>boolean</LineItem4> <PurchaseExpiry4>string</PurchaseExpiry4> <Name4>string</Name4> <Information4>string</Information4> <ChargeableUnit4>string</ChargeableUnit4> <UnitPrice4>string</UnitPrice4> <Amount4>string</Amount4> <Tax4>string</Tax4> <Description4>string</Description4> </RegistTaxInvoicePlain>

HTTP/1.1 200 OK <RegistTaxInvoicePlainResponse xmlns="http://ws.barobill.co.kr/v1/"> <RegistTaxInvoicePlainResult>int</RegistTaxInvoicePlainResult> </RegistTaxInvoicePlainResponse> 17 페이지

3.6. RegisterBrokerTaxInvoice 위수탁세금계산서를임시저장함에등록한다. 매개변수 타입 길이 설명 필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O Invoice TaxInvoice - 등록할위수탁세금세금계산서 (5. SOAP 객체상세설명참조 ) O 반환값 : int 1 : 등록완료. SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/registbrokertaxinvoice" <RegistBrokerTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <Invoice> <InvoiceKey>string</InvoiceKey> <InvoicerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoicerParty> <InvoiceeParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoiceeParty> <BrokerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> 18 페이지

</BrokerParty> <IssueDirection>int</IssueDirection> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifyCode>string</ModifyCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <WriteDate>string</WriteDate> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <TaxInvoiceTradeLineItems> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> </TaxInvoiceTradeLineItems> </Invoice> </RegistBrokerTaxInvoice> HTTP/1.1 200 OK <RegistBrokerTaxInvoiceResponse xmlns="http://ws.barobill.co.kr/v1/"> <RegistBrokerTaxInvoiceResult>int</RegistBrokerTaxInvoiceResult> </RegistBrokerTaxInvoiceResponse> 19 페이지

3.7. RegisterBrokerTaxInvoicePlain 위수탁세금계산서를임시저장함에등록한다. 연동성지원을위한인수형. ( 매개변수의추가설명은 5. SOAP 객체설명을추가참고한다.) 매개변수타입길이설명필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O InvoiceKey String 24 바로빌관리번호 X IssueDirection Int 1 1: 정발행 2: 역발행 O BrokerID String 12 위탁자회원아이디대소문자구문함 O BrokerCorpNum String 13 위탁자사업자등록번호 O BrokerMgtNum String 24 위탁자관리번호 O BrokerCorpName String 70 위탁자상호 O BrokerTaxRegID String 4 위탁자종사업장식별번호 ( 단위과세제도 ) X BrokerCEOName String 30 위탁자대표자성명 O BrokerAddr String 150 위탁자주소 O BrokerBizClass String 40 위탁자업종 O BrokerBizType String 40 위탁자업태 O BrokerContactName String 30 위탁자담당자성명 O BrokerTEL String 20 위탁자연락처 O BrokerHP String 20 위탁자휴대전화 O BrokerEmail String 40 위탁자이메일 O InvoicerID String 12 공급자회원아이디대소문자구문함 O InvoicerCorpNum String 13 공급자사업자등록번호 O InvoicerMgtNum String 24 공급자관리번호 O InvoicerCorpName String 70 공급자상호 O InvoicerTaxRegID String 4 공급자종사업장식별번호 ( 단위과세제도 ) X InvoicerCEOName String 30 공급자대표자성명 O InvoicerAddr String 150 공급자주소 O InvoicerBizClass String 40 공급자업종 O InvoicerBizType String 40 공급자업태 O InvoicerContactName String 30 공급자담당자성명 O InvoicerTEL String 20 공급자연락처 O InvoicerHP String 20 공급자휴대전화 O InvoicerEmail String 40 공급자이메일 O InvoiceeID String 12 공급받는자회원아이디대소문자구문함 X InvoiceeCorpNum String 13 공급받는자상호 O InvoiceeMgtNum String 24 공급받는자관리번호 O InvoiceeCorpName String 70 공급받는자상호 O InvoiceeTaxRegID String 4 공급받는자종사업장식별번호 X InvoiceeCEOName String 30 공급받는자대표자성명 O InvoiceeAddr String 150 공급받는자주소 O InvoiceeBizClass String 40 공급받는자업종 O InvoiceeBizType String 40 공급받는자업태 O InvoiceeContactName String 30 공급받는자담당자성명 O InvoiceeTEL String 20 공급받는자연락처 O InvoiceeHP String 20 공급받는자휴대전화 O InvoiceeEmail String 40 공급받는자이메일 O TaxInvoiceType Int 1 세금계산서형태 O TaxType Int 1 과세형태 O TaxCalcType Int 1 세금계산형태 O 20 페이지

PurposeType Int 1 영수 / 청구구분 O ModifyCode String 4 수정코드 ( 수정세금계산서일경우 ) 숫자 X Kwon String 4 권숫자 X Ho String 4 호숫자 X SerialNum String 27 일련번호 X Cash String 18 현금 X ChkBill String 18 수표 X Note String 18 어음 X Credit String 18 외상미수금 X AmountTotal String 18 공급가액합계 O TaxTotal String 18 세액합계 O TotalAmount String 18 총액 O Remark1 String 150 비고1 X Remark2 String 150 비고2 X Remark3 String 150 비고3 X LineItem1 Bool 1 1번상세유무 O PurchaseExpiry1 String 8 구매일자1 ( YYYYMMDD) X Name1 String 100 품목1 X Information1 String 60 규격1 X ChargeableUnit1 String 12.2 수량1 X UnitPrice1 String 18.2 단가1 X Amount1 String 18 공금가액1 X Tax1 String 18 세액1 X Description1 String 40 비고1 X LineItem2 Bool 1 2번상세유무 O PurchaseExpiry2 String 8 구매일자2 ( YYYYMMDD) X Name2 String 100 품목2 X Information2 String 60 규격2 X ChargeableUnit2 String 12.2 수량2 X UnitPrice2 String 18.2 단가2 X Amount2 String 18 공금가액2 X Tax2 String 18 세액2 X Description2 String 40 비고2 X LineItem3 Bool 1 3번상세유무 O PurchaseExpiry3 String 8 구매일자3 ( YYYYMMDD) X Name3 String 100 품목3 X Information3 String 60 규격3 X ChargeableUnit3 String 12.2 수량3 X UnitPrice3 String 18.2 단가3 X Amount3 String 18 공금가액3 X Tax3 String 18 세액3 X Description3 String 40 비고3 X LineItem4 Bool 1 4번상세유무 O PurchaseExpiry4 String 8 구매일자4 ( YYYYMMDD) X Name4 String 100 품목4 X Information4 String 60 규격4 X ChargeableUnit4 String 12.2 수량4 X UnitPrice4 String 18.2 단가4 X Amount4 String 18 공금가액4 X Tax4 String 18 세액4 X Description4 String 40 비고4 X 21 페이지

반환값 : int 1 : 등록완료 SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/registbrokertaxinvoiceplain" <RegistBrokerTaxInvoicePlain xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <InvoiceKey>string</InvoiceKey> <IssueDirection>int</IssueDirection> <BrokerID>string</BrokerID> <BrokerCorpNum>string</BrokerCorpNum> <BrokerMgtNum>string</BrokerMgtNum> <BrokerCorpName>string</BrokerCorpName> <BrokerTaxRegID>string</BrokerTaxRegID> <BrokerCEOName>string</BrokerCEOName> <BrokerAddr>string</BrokerAddr> <BrokerBizClass>string</BrokerBizClass> <BrokerBizType>string</BrokerBizType> <BrokerContactName>string</BrokerContactName> <BrokerTEL>string</BrokerTEL> <BrokerHP>string</BrokerHP> <BrokerEmail>string</BrokerEmail> <InvoicerID>string</InvoicerID> <InvoicerCorpNum>string</InvoicerCorpNum> <InvoicerMgtNum>string</InvoicerMgtNum> <InvoicerCorpName>string</InvoicerCorpName> <InvoicerTaxRegID>string</InvoicerTaxRegID> <InvoicerCEOName>string</InvoicerCEOName> <InvoicerAddr>string</InvoicerAddr> <InvoicerBizClass>string</InvoicerBizClass> <InvoicerBizType>string</InvoicerBizType> <InvoicerContactName>string</InvoicerContactName> <InvoicerTEL>string</InvoicerTEL> <InvoicerHP>string</InvoicerHP> <InvoicerEmail>string</InvoicerEmail> <InvoiceeID>string</InvoiceeID> <InvoiceeCorpNum>string</InvoiceeCorpNum> <InvoiceeMgtNum>string</InvoiceeMgtNum> <InvoiceeCorpName>string</InvoiceeCorpName> <InvoiceeTaxRegID>string</InvoiceeTaxRegID> <InvoiceeCEOName>string</InvoiceeCEOName> <InvoiceeAddr>string</InvoiceeAddr> <InvoiceeBizClass>string</InvoiceeBizClass> <InvoiceeBizType>string</InvoiceeBizType> <InvoiceeContactName>string</InvoiceeContactName> <InvoiceeTEL>string</InvoiceeTEL> <InvoiceeHP>string</InvoiceeHP> <InvoiceeEmail>string</InvoiceeEmail> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifYCode>string</ModifYCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <LineItem1>boolean</LineItem1> <PurchageExpiry1>string</PurchageExpiry1> <Name1>string</Name1> 22 페이지

<Information1>string</Information1> <ChargeableUnit1>string</ChargeableUnit1> <UnitPrice1>string</UnitPrice1> <Amount1>string</Amount1> <Tax1>string</Tax1> <Description1>string</Description1> <LineItem2>boolean</LineItem2> <PurchageExpiry2>string</PurchageExpiry2> <Name2>string</Name2> <Information2>string</Information2> <ChargeableUnit2>string</ChargeableUnit2> <UnitPrice2>string</UnitPrice2> <Amount2>string</Amount2> <Tax2>string</Tax2> <Description2>string</Description2> <LineItem3>boolean</LineItem3> <PurchageExpiry3>string</PurchageExpiry3> <Name3>string</Name3> <Information3>string</Information3> <ChargeableUnit3>string</ChargeableUnit3> <UnitPrice3>string</UnitPrice3> <Amount3>string</Amount3> <Tax3>string</Tax3> <Description3>string</Description3> <LineItem4>boolean</LineItem4> <PurchageExpiry4>string</PurchageExpiry4> <Name4>string</Name4> <Information4>string</Information4> <ChargeableUnit4>string</ChargeableUnit4> <UnitPrice4>string</UnitPrice4> <Amount4>string</Amount4> <Tax4>string</Tax4> <Description4>string</Description4> </RegistBrokerTaxInvoicePlain> HTTP/1.1 200 OK <RegistBrokerTaxInvoicePlainResponse xmlns="http://ws.barobill.co.kr/v1/"> <RegistBrokerTaxInvoicePlainResult>int</RegistBrokerTaxInvoicePlainResult> </RegistBrokerTaxInvoicePlainResponse> 23 페이지

3.8. UpdateTaxInvoice 세금계산서수정, 임시저장상태의세금계산서만수정할수있다. 매개변수 타입 길이 설명 필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O Invoice TaxInvoice - 수정할위수탁세금세금계산서 (5. SOAP 객체상세참조 ) O 반환값 : int 1 : 수정완료 SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/updatetaxinvoice" <UpdateTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <Invoice> <InvoiceKey>string</InvoiceKey> <InvoicerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoicerParty> <InvoiceeParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoiceeParty> <BrokerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> 24 페이지

</BrokerParty> <IssueDirection>int</IssueDirection> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifyCode>string</ModifyCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <WriteDate>string</WriteDate> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <TaxInvoiceTradeLineItems> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> </TaxInvoiceTradeLineItems> </Invoice> </UpdateTaxInvoice> HTTP/1.1 200 OK <UpdateTaxInvoiceResponse xmlns="http://ws.barobill.co.kr/v1/"> <UpdateTaxInvoiceResult>int</UpdateTaxInvoiceResult> </UpdateTaxInvoiceResponse> 25 페이지

3.9. UpdateTaxInvoicePlain 일반세금계산서수정임시저장상태의세금계산서만수정할수있다. 연동성지원을위한인수형. ( 매개변수의추가설명은 5. SOAP 객체설명을추가참고한다.) 매개변수타입길이설명필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O InvoiceKey String 24 바로빌관리번호 X IssueDirection Int 1 1: 정발행 2: 역발행 O InvoicerID String 12 공급자회원아이디대소문자구문함 O InvoicerCorpNum String 13 공급자사업자등록번호 O InvoicerMgtNum String 24 공급자관리번호 O InvoicerCorpName String 70 공급자상호 O InvoicerTaxRegID String 4 공급자종사업장식별번호 ( 단위과세제도 ) X InvoicerCEOName String 30 대표자성명 O InvoicerAddr String 150 공급자주소 O InvoicerBizClass String 40 공급자업종 O InvoicerBizType String 40 공급자업태 O InvoicerContactName String 30 공급자담당자성명 O InvoicerTEL String 20 공급자연락처 O InvoicerHP String 20 공급자휴대전화 O InvoicerEmail String 40 공급자이메일 O InvoiceeID String 12 공급받는자회원아이디대소문자구문함 X InvoiceeCorpNum String 13 공급받는자상호 O InvoiceeMgtNum String 24 공급받는자관리번호 O InvoiceeCorpName String 70 공급받는자상호 O InvoiceeTaxRegID String 4 공급받는자종사업장식별번호 X InvoiceeCEOName String 30 공급받는자대표자성명 O InvoiceeAddr String 150 공급받는자주소 O InvoiceeBizClass String 40 공급받는자업종 O InvoiceeBizType String 40 공급받는자업태 O InvoiceeContactName String 30 공급받는자담당자성명 O InvoiceeTEL String 20 공급받는자연락처 O InvoiceeHP String 20 공급받는자휴대전화 O InvoiceeEmail String 40 공급받는자이메일 O TaxInvoiceType Int 1 세금계산서형태 O TaxType Int 1 과세형태 O TaxCalcType Int 1 세금계산형태 O PurposeType Int 1 영수 / 청구구분 O ModifyCode string 4 수정코드 ( 수정세금계산서일경우 ) 숫자만 X Kwon String 4 권숫자만 X Ho String 4 호숫자만 X SerialNum String 27 일련번호 X Cash String 18 현금 X ChkBill String 18 수표 X Note String 18 어음 X Credit String 18 외상미수금 X AmountTotal String 18 공급가액합계 O TaxTotal String 18 세액합계 O TotalAmount String 18 총액 O Remark1 String 150 비고1 X 26 페이지

Remark2 String 150 비고2 X Remark3 String 150 비고3 X LineItem1 Bool 1 1번상세유무 O PurchaseExpiry1 String 8 구매일자1 ( YYYYMMDD) X Name1 String 100 품목1 X Information1 String 60 규격1 X ChargeableUnit1 String 12.2 수량1 X UnitPrice1 String 18.2 단가1 X Amount1 String 18 공금가액1 X Tax1 String 18 세액1 X Description1 String 40 비고1 X LineItem2 Bool 1 2번상세유무 O PurchaseExpiry2 String 8 구매일자2 ( YYYYMMDD) X Name2 String 100 품목2 X Information2 String 60 규격2 X ChargeableUnit2 String 12.2 수량2 X UnitPrice2 String 18.2 단가2 X Amount2 String 18 공금가액2 X Tax2 String 18 세액2 X Description2 String 40 비고2 X LineItem3 Bool 1 3번상세유무 O PurchaseExpiry3 String 8 구매일자3 ( YYYYMMDD) X Name3 String 100 품목3 X Information3 String 60 규격3 X ChargeableUnit3 String 12.2 수량3 X UnitPrice3 String 18.2 단가3 X Amount3 String 18 공금가액3 X Tax3 String 18 세액3 X Description3 String 40 비고3 X LineItem4 Bool 1 4번상세유무 O PurchaseExpiry4 String 1 구매일자4 ( YYYYMMDD) X Name4 String 100 품목4 X Information4 String 60 규격4 X ChargeableUnit4 String 12.2 수량4 X UnitPrice4 String 18.2 단가4 X Amount4 String 18 공금가액4 X Tax4 String 18 세액4 X Description4 String 40 비고4 X 반환값 : int 1 : 수정완료 SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/updatetaxinvoiceplain" <UpdateTaxInvoicePlain xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> 27 페이지

28 페이지 <InvoiceKey>string</InvoiceKey> <IssueDirection>int</IssueDirection> <InvoicerID>string</InvoicerID> <InvoicerCorpNum>string</InvoicerCorpNum> <InvoicerMgtNum>string</InvoicerMgtNum> <InvoicerCorpName>string</InvoicerCorpName> <InvoicerTaxRegID>string</InvoicerTaxRegID> <InvoicerCEOName>string</InvoicerCEOName> <InvoicerAddr>string</InvoicerAddr> <InvoicerBizClass>string</InvoicerBizClass> <InvoicerBizType>string</InvoicerBizType> <InvoicerContactName>string</InvoicerContactName> <InvoicerTEL>string</InvoicerTEL> <InvoicerHP>string</InvoicerHP> <InvoicerEmail>string</InvoicerEmail> <InvoiceeID>string</InvoiceeID> <InvoiceeCorpNum>string</InvoiceeCorpNum> <InvoiceeMgtNum>string</InvoiceeMgtNum> <InvoiceeCorpName>string</InvoiceeCorpName> <InvoiceeTaxRegID>string</InvoiceeTaxRegID> <InvoiceeCEOName>string</InvoiceeCEOName> <InvoiceeAddr>string</InvoiceeAddr> <InvoiceeBizClass>string</InvoiceeBizClass> <InvoiceeBizType>string</InvoiceeBizType> <InvoiceeContactName>string</InvoiceeContactName> <InvoiceeTEL>string</InvoiceeTEL> <InvoiceeHP>string</InvoiceeHP> <InvoiceeEmail>string</InvoiceeEmail> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifyCode>string</ModifyCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <LineItem1>boolean</LineItem1> <PurchageExpiry1>string</PurchageExpiry1> <Name1>string</Name1> <Information1>string</Information1> <ChargeableUnit1>string</ChargeableUnit1> <UnitPrice1>string</UnitPrice1> <Amount1>string</Amount1> <Tax1>string</Tax1> <Description1>string</Description1> <LineItem2>boolean</LineItem2> <PurchageExpiry2>string</PurchageExpiry2> <Name2>string</Name2> <Information2>string</Information2> <ChargeableUnit2>string</ChargeableUnit2> <UnitPrice2>string</UnitPrice2> <Amount2>string</Amount2> <Tax2>string</Tax2> <Description2>string</Description2> <LineItem3>boolean</LineItem3> <PurchageExpiry3>string</PurchageExpiry3> <Name3>string</Name3> <Information3>string</Information3> <ChargeableUnit3>string</ChargeableUnit3> <UnitPrice3>string</UnitPrice3> <Amount3>string</Amount3> <Tax3>string</Tax3> <Description3>string</Description3> <LineItem4>boolean</LineItem4> <PurchageExpiry4>string</PurchageExpiry4> <Name4>string</Name4> <Information4>string</Information4> <ChargeableUnit4>string</ChargeableUnit4> <UnitPrice4>string</UnitPrice4> <Amount4>string</Amount4> <Tax4>string</Tax4> <Description4>string</Description4> </UpdateTaxInvoicePlain>

HTTP/1.1 200 OK <UpdateTaxInvoicePlainResponse xmlns="http://ws.barobill.co.kr/v1/"> <UpdateTaxInvoicePlainResult>int</UpdateTaxInvoicePlainResult> </UpdateTaxInvoicePlainResponse> 29 페이지

3.10. UpdateBrokerTaxInvoice 위수탁세금계산서를수정한다. 세금계산서수정은임시저장상태의계산서만가능하다. 매개변수 타입 길이 설명 필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O Invoice TaxInvoice - 수정할위수탁세금세금계산서 (5. SOAP 객체상세참조 ) O 반환값 : int 1 : 수정완료. SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/updatebrokertaxinvoice" <UpdateBrokerTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <Invoice> <InvoiceKey>string</InvoiceKey> <InvoicerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoicerParty> <InvoiceeParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> </InvoiceeParty> <BrokerParty> <ContactID>string</ContactID> <MgtNum>string</MgtNum> <CorpName>string</CorpName> <TaxRegID>string</TaxRegID> <CEOName>string</CEOName> <Addr>string</Addr> <BizClass>string</BizClass> <BizType>string</BizType> <ContactName>string</ContactName> <TEL>string</TEL> <HP>string</HP> <Email>string</Email> 30 페이지

</BrokerParty> <IssueDirection>int</IssueDirection> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifyCode>string</ModifyCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <TaxInvoiceTradeLineItems> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> <TaxInvoiceTradeLineItem> <PurchaseExpiry>string</PurchaseExpiry> <Name>string</Name> <Information>string</Information> <ChargeableUnit>string</ChargeableUnit> <UnitPrice>string</UnitPrice> <Amount>string</Amount> <Tax>string</Tax> <Description>string</Description> </TaxInvoiceTradeLineItem> </TaxInvoiceTradeLineItems> </Invoice> </UpdateBrokerTaxInvoice> HTTP/1.1 200 OK <UpdateBrokerTaxInvoiceResponse xmlns="http://ws.barobill.co.kr/v1/"> <UpdateBrokerTaxInvoiceResult>int</UpdateBrokerTaxInvoiceResult> </UpdateBrokerTaxInvoiceResponse> 31 페이지

3.11. UpdateBrokerTaxInvoicePlain 위수탁세금계산서수정, 임시저장상태의세금계산서만수정이가능하다. 연동성지원을위한인수형. ( 매개변수의추가설명은 5. SOAP 객체설명을추가참고한다.) 매개변수타입길이설명필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O InvoiceKey String 24 바로빌관리번호 X IssueDirection Int 1 1: 정발행 2: 역발행 O BrokerID String 12 위탁자회원아이디대소문자구문함 O BrokerCorpNum String 13 위탁자사업자등록번호 O BrokerMgtNum String 24 위탁자관리번호 O BrokerCorpName String 70 위탁자상호 O BrokerTaxRegID String 4 위탁자종사업장식별번호 ( 단위과세제도 ) X BrokerCEOName String 30 위탁자대표자성명 O BrokerAddr String 150 위탁자주소 O BrokerBizClass String 40 위탁자업종 O BrokerBizType String 40 위탁자업태 O BrokerContactName String 30 위탁자담당자성명 O BrokerTEL String 20 위탁자연락처 O BrokerHP String 20 위탁자휴대전화 O BrokerEmail String 40 위탁자이메일 O InvoicerID String 12 공급자회원아이디대소문자구문함 O InvoicerCorpNum String 13 공급자사업자등록번호 O InvoicerMgtNum String 24 공급자관리번호 O InvoicerCorpName String 70 공급자상호 O InvoicerTaxRegID String 4 공급자종사업장식별번호 ( 단위과세제도 ) X InvoicerCEOName String 30 공급자대표자성명 O InvoicerAddr String 150 공급자주소 O InvoicerBizClass String 40 공급자업종 O InvoicerBizType String 40 공급자업태 O InvoicerContactName String 30 공급자담당자성명 O InvoicerTEL String 20 공급자연락처 O InvoicerHP String 20 공급자휴대전화 O InvoicerEmail String 40 공급자이메일 O InvoiceeID String 12 공급받는자회원아이디대소문자구문함 X InvoiceeCorpNum String 13 공급받는자상호 O InvoiceeMgtNum String 24 공급받는자관리번호 O InvoiceeCorpName String 70 공급받는자상호 O InvoiceeTaxRegID String 4 공급받는자종사업장식별번호 X InvoiceeCEOName String 30 공급받는자대표자성명 O InvoiceeAddr String 150 공급받는자주소 O InvoiceeBizClass String 40 공급받는자업종 O InvoiceeBizType String 40 공급받는자업태 O InvoiceeContactName String 30 공급받는자담당자성명 O InvoiceeTEL String 20 공급받는자연락처 O InvoiceeHP String 20 공급받는자휴대전화 O InvoiceeEmail String 40 공급받는자이메일 O TaxInvoiceType Int 1 세금계산서형태 O TaxType Int 1 과세형태 O TaxCalcType Int 1 세금계산형태 O 32 페이지

PurposeType Int 1 영수 / 청구구분 O ModifyCode String 4 수정코드 ( 수정세금계산서일경우 ) X Kwon String 3 권 X Ho String 3 호 X SerialNum String 27 일련번호 X Cash String 18 현금 X ChkBill String 18 수표 X Note String 18 어음 X Credit String 18 외상미수금 X AmountTotal String 18 공급가액합계 O TaxTotal String 18 세액합계 O TotalAmount String 18 총액 O Remark1 String 150 비고1 X Remark2 String 150 비고2 X Remark3 String 150 비고3 X LineItem1 Bool 1 1번상세유무 O PurchaseExpiry1 String 8 구매일자2 ( YYYYMMDD) X Name1 String 100 품목1 X Information1 String 60 규격1 X ChargeableUnit1 String 12.2 수량1 X UnitPrice1 String 18.2 단가1 X Amount1 String 18 공금가액1 X Tax1 String 18 세액1 X Description1 String 40 비고1 X LineItem2 Bool 1 2번상세유무 O PurchaseExpiry2 String 8 구매일자2 ( YYYYMMDD) X Name2 String 100 품목2 X Information2 String 60 규격2 X ChargeableUnit2 String 12.2 수량2 X UnitPrice2 String 18.2 단가2 X Amount2 String 18 공금가액2 X Tax2 String 18 세액2 X Description2 String 40 비고2 X LineItem3 Bool 1 3번상세유무 O PurchaseExpiry3 String 8 구매일자3 ( YYYYMMDD) X Name3 String 100 품목3 X Information3 String 60 규격3 X ChargeableUnit3 String 12.2 수량3 X UnitPrice3 String 18.2 단가3 X Amount3 String 18 공금가액3 X Tax3 String 18 세액3 X Description3 String 40 비고3 X LineItem4 Bool 1 4번상세유무 O PurchaseExpiry4 String 8 구매일자4 ( YYYYMMDD) X Name4 String 100 품목4 X Information4 String 60 규격4 X ChargeableUnit4 String 12.2 수량4 X UnitPrice4 String 18.2 단가4 X Amount4 String 18 공금가액4 X Tax4 String 18 세액4 X Description4 String 40 비고4 X 33 페이지

반환값 : int 1 : 수정완료 SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/updatebrokertaxinvoiceplain" <UpdateBrokerTaxInvoicePlain xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <InvoiceKey>string</InvoiceKey> <IssueDirection>int</IssueDirection> <BrokerID>string</BrokerID> <BrokerCorpNum>string</BrokerCorpNum> <BrokerMgtNum>string</BrokerMgtNum> <BrokerCorpName>string</BrokerCorpName> <BrokerTaxRegID>string</BrokerTaxRegID> <BrokerCEOName>string</BrokerCEOName> <BrokerAddr>string</BrokerAddr> <BrokerBizClass>string</BrokerBizClass> <BrokerBizType>string</BrokerBizType> <BrokerContactName>string</BrokerContactName> <BrokerTEL>string</BrokerTEL> <BrokerHP>string</BrokerHP> <BrokerEmail>string</BrokerEmail> <InvoicerID>string</InvoicerID> <InvoicerCorpNum>string</InvoicerCorpNum> <InvoicerMgtNum>string</InvoicerMgtNum> <InvoicerCorpName>string</InvoicerCorpName> <InvoicerTaxRegID>string</InvoicerTaxRegID> <InvoicerCEOName>string</InvoicerCEOName> <InvoicerAddr>string</InvoicerAddr> <InvoicerBizClass>string</InvoicerBizClass> <InvoicerBizType>string</InvoicerBizType> <InvoicerContactName>string</InvoicerContactName> <InvoicerTEL>string</InvoicerTEL> <InvoicerHP>string</InvoicerHP> <InvoicerEmail>string</InvoicerEmail> <InvoiceeID>string</InvoiceeID> <InvoiceeCorpNum>string</InvoiceeCorpNum> <InvoiceeMgtNum>string</InvoiceeMgtNum> <InvoiceeCorpName>string</InvoiceeCorpName> <InvoiceeTaxRegID>string</InvoiceeTaxRegID> <InvoiceeCEOName>string</InvoiceeCEOName> <InvoiceeAddr>string</InvoiceeAddr> <InvoiceeBizClass>string</InvoiceeBizClass> <InvoiceeBizType>string</InvoiceeBizType> <InvoiceeContactName>string</InvoiceeContactName> <InvoiceeTEL>string</InvoiceeTEL> <InvoiceeHP>string</InvoiceeHP> <InvoiceeEmail>string</InvoiceeEmail> <TaxInvoiceType>int</TaxInvoiceType> <TaxType>int</TaxType> <TaxCalcType>int</TaxCalcType> <PurposeType>int</PurposeType> <ModifYCode>string</ModifYCode> <Kwon>string</Kwon> <Ho>string</Ho> <SerialNum>string</SerialNum> <Cash>string</Cash> <ChkBill>string</ChkBill> <Note>string</Note> <Credit>string</Credit> <AmountTotal>string</AmountTotal> <TaxTotal>string</TaxTotal> <TotalAmount>string</TotalAmount> <Remark1>string</Remark1> <Remark2>string</Remark2> <Remark3>string</Remark3> <LineItem1>boolean</LineItem1> 34 페이지

<PurchageExpiry1>string</PurchageExpiry1> <Name1>string</Name1> <Information1>string</Information1> <ChargeableUnit1>string</ChargeableUnit1> <UnitPrice1>string</UnitPrice1> <Amount1>string</Amount1> <Tax1>string</Tax1> <Description1>string</Description1> <LineItem2>boolean</LineItem2> <PurchageExpiry2>string</PurchageExpiry2> <Name2>string</Name2> <Information2>string</Information2> <ChargeableUnit2>string</ChargeableUnit2> <UnitPrice2>string</UnitPrice2> <Amount2>string</Amount2> <Tax2>string</Tax2> <Description2>string</Description2> <LineItem3>boolean</LineItem3> <PurchageExpiry3>string</PurchageExpiry3> <Name3>string</Name3> <Information3>string</Information3> <ChargeableUnit3>string</ChargeableUnit3> <UnitPrice3>string</UnitPrice3> <Amount3>string</Amount3> <Tax3>string</Tax3> <Description3>string</Description3> <LineItem4>boolean</LineItem4> <PurchageExpiry4>string</PurchageExpiry4> <Name4>string</Name4> <Information4>string</Information4> <ChargeableUnit4>string</ChargeableUnit4> <UnitPrice4>string</UnitPrice4> <Amount4>string</Amount4> <Tax4>string</Tax4> <Description4>string</Description4> </UpdateBrokerTaxInvoicePlain> HTTP/1.1 200 OK <UpdateBrokerTaxInvoicePlainResponse xmlns="http://ws.barobill.co.kr/v1/"> <UpdateBrokerTaxInvoicePlainResult>int</UpdateBrokerTaxInvoicePlainResult> </UpdateBrokerTaxInvoicePlainResponse> 35 페이지

3.12. DeleteTaxInvoice 발행자관리번호로세금계산서를삭제한다. 임시저장, 승인 / 발행거부, 취소완료상태의계산서만삭제가가능하다. 매개변수 타입 길이 설명 필수 CERTKEY String 50 인증키 O CorpNum String 13 발행사업자등록번호 ( - 제외 ) O MgtKey String 24 수정할세금계산서의발행자부여관리번호 O 반환값 : int 1 : 삭제완료 ( 임시저장 ) 2 : 삭제완료 ( 거부, 취소 ) SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/deletetaxinvoice" <DeleteTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKey>string</MgtKey> </DeleteTaxInvoice> HTTP/1.1 200 OK <DeleteTaxInvoiceResponse xmlns="http://ws.barobill.co.kr/v1/"> <DeleteTaxInvoiceResult>int</DeleteTaxInvoiceResult> </DeleteTaxInvoiceResponse> 36 페이지

3.13. DeleteTaxInvoiceIK 바로빌관리번호로세금계산서를삭제한다.. 임시저장, 승인 / 발행거부, 취소완료상태의계산서만삭제가가능하다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O InvoiceKey string 24 수정할세금계산서의바로빌부여관리번호 O 반환값 : int 1 : 삭제완료 ( 임시저장 ) 2 : 삭제완료 ( 거부, 취소 ) SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/deletetaxinvoiceik" <DeleteTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKey>string</MgtKey> </DeleteTaxInvoice> HTTP/1.1 200 OK <DeleteTaxInvoiceIKResponse xmlns="http://ws.barobill.co.kr/v1/"> <DeleteTaxInvoiceIKResult>int</DeleteTaxInvoiceIKResult> </DeleteTaxInvoiceIKResponse> 37 페이지

3.14. GetTaxInvoiceState 발행자부여관리번호로세금계산서의상태를확인한다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O MgtKey string 24 확인할세금계산서의발행자부여관리번호 O 반환값 : int 4자리양수값 # : 현재상태 : 1: 임시저장 2: 진행중 3: 완료 4 : 거부됨 5: 취소됨 ## : 최종처리요청 2자리 01 : 정발행승인요청 02 : 역발행요청 03 : 취소요청 ( 공급자 ) 04 : 취소요청 ( 공급받는자 ) 05 : 내부발행요청 06 : 내부발행요청 # : 최종처리요청의처리상태 0 : 미처리 1: 승인 2: 거부 3: 자체취소 Ex). 2010 : 진행중문서정발행승인요청미처리중, 3011 : 완료문서정발행승인요청승인완료 SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/gettaxinvoicestate" <GetTaxInvoiceState xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKey>string</MgtKey> </GetTaxInvoiceState> HTTP/1.1 200 OK <GetTaxInvoiceStateResponse xmlns="http://ws.barobill.co.kr/v1/"> <GetTaxInvoiceStateResult>int</GetTaxInvoiceStateResult> </GetTaxInvoiceStateResponse> 38 페이지

3.15. GetTaxInvoiceStateIK 바로빌부여관리번호로세금계산서의상태를확인한다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O InvoiceKey string 24 확인할세금계산서의바로빌부여관리번호 O 반환값 : int 4자리양수값 # : 현재상태 : 1: 임시저장 2: 진행중 3: 완료 4 : 거부됨 5: 취소됨 ## : 최종처리요청 2자리 01 : 정발행승인요청 02 : 역발행요청 03 : 취소요청 ( 공급자 ) 04 : 취소요청 ( 공급받는자 ) 05 : 내부발행요청 06 : 내부발행요청 # : 최종처리요청의처리상태 0 : 미처리 1: 승인 2: 거부 3: 자체취소 Ex). 2010 : 진행중문서정발행승인요청미처리중, 3011 : 완료문서정발행승인요청승인완료 SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/gettaxinvoicestateik" <GetTaxInvoiceStateIK xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <InvoiceKey>string</InvoiceKey> </GetTaxInvoiceStateIK> HTTP/1.1 200 OK <GetTaxInvoiceStateIKResponse xmlns="http://ws.barobill.co.kr/v1/"> <GetTaxInvoiceStateIKResult>int</GetTaxInvoiceStateIKResult> </GetTaxInvoiceStateIKResponse> 39 페이지

3.16. GetTaxInvoiceStateEX 발행자부여관리번호로세금계산서의상세상태를확인한다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O MgtKey string 24 확인할세금계산서의발행자부여관리번호 O 반환값 : 반환값은 ReturnVal 형의객체로, ReturnVal 에대한 5. SOAP 객체상세설명을참고한다. SOAP 1.1 POST /V1/BaroTIService.asmx HTTP/1.1 Host: eval.dexteditor.com SOAPAction: "http://ws.barobill.co.kr/v1/gettaxinvoicestateex" <GetTaxInvoiceStateEX xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKey>string</MgtKey> </GetTaxInvoiceStateEX> HTTP/1.1 200 OK <GetTaxInvoiceStateEXResponse xmlns="http://ws.barobill.co.kr/v1/"> <GetTaxInvoiceStateEXResult> <MgtKey>string</MgtKey> <RetVal>int</RetVal> <InvoiceKey>string</InvoiceKey> <Remark1>string</Remark1> <Remark2>string</Remark2> </GetTaxInvoiceStateEXResult> </GetTaxInvoiceStateEXResponse> 40 페이지

3.17. GetTaxInvoiceStates 발행자부여관리번호로세금계산서의상태를대량확인한다. 최대 100건까지처리하며, 초과시에는처리하지않는다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O MgtKeyList ArrayOfstring - 확인할세금계산서의발행자부여관리번호배열 O 반환값 : ArrayOfReturnVal ReturnVal 타입을참조. ReturnVal.RetVal 은 GetTaxinvoiceState의반환값과동일함. SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/gettaxinvoicestates" <GetTaxInvoiceStates xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKeyList> <string>string</string> <string>string</string> </MgtKeyList> </GetTaxInvoiceStates> HTTP/1.1 200 OK <GetTaxInvoiceStatesResponse xmlns="http://ws.barobill.co.kr/v1/"> <GetTaxInvoiceStatesResult> <ReturnVal> <MgtKey>string</MgtKey> <RetVal>int</RetVal> <InvoiceKey>string</InvoiceKey> </ReturnVal> <ReturnVal> <MgtKey>string</MgtKey> <RetVal>int</RetVal> <InvoiceKey>string</InvoiceKey> </ReturnVal> </GetTaxInvoiceStatesResult> </GetTaxInvoiceStatesResponse> 41 페이지

3.18. GetTaxInvoiceStatesIK 바로빌부여관리번호로세금계산서의상태를대량확인한다. 최대 100건까지처리하며, 초과시에는처리하지않는다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O InvoiceKeyList ArrayOfstring - 확인할세금계산서의바로빌부여관리번호배열 O 반환값 : ArrayOfReturnVal ReturnVal 타입을참조. ReturnVal.RetVal 은 GetTaxinvoiceState의반환값과동일함. SOAP 1.1 POST /V1/BaroTiService.asmx HTTP/1.1 Host: localhost SOAPAction: "http://ws.barobill.co.kr/v1/gettaxinvoicestatesik" <GetTaxInvoiceStatesIK xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <InvoiceKeyList> <string>string</string> <string>string</string> </InvoiceKeyList> </GetTaxInvoiceStatesIK> HTTP/1.1 200 OK <GetTaxInvoiceStatesIKResponse xmlns="http://ws.barobill.co.kr/v1/"> <GetTaxInvoiceStatesIKResult> <ReturnVal> <MgtKey>string</MgtKey> <RetVal>int</RetVal> <InvoiceKey>string</InvoiceKey> </ReturnVal> <ReturnVal> <MgtKey>string</MgtKey> <RetVal>int</RetVal> <InvoiceKey>string</InvoiceKey> </ReturnVal> </GetTaxInvoiceStatesIKResult> </GetTaxInvoiceStatesIKResponse> 42 페이지

3.19. IssueTaxInvoice 바로빌부여관리번호로세금계산서를발행한다. 정발행의경우바로빌에해당사업자의유효한공인인증서가등록되었어야하며, 역발행은공급자 ( 역발행요청을받는자 ) 가전자서명하므로, 공인인증서없이발행이가능하다. SendSMS값에따라문자전송여부가결정이되며, 계산서내의휴대전화번호가없을경우, 자동으로 false처리되어문자전송을하지않는다. 발행비용및문자발생비용이과금되어야하므로, 해당사업자는바로빌에결제를통해과금가능한상태에서만발행이가능하다.. 공인인증서등록은바로빌로그인후 [ 회원정보 ]-[ 공인인증서등록 ] 에서등록합니다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O MgtKey String 24 확인할세금계산서의발행자부여관리번호 O SendSMS Bool - SMS문자전송여부 ( 요금정책에따라충전액을확인하여과금할수있음 ) O 반환값 : 1-> 발행성공, 2 -> 발행성공 (SMS 전송충전액부족으로실패 ), 3 -> 발행성공 (Email전송에실패하였습니다. 메일을재발송하십시오.) 기타오류코드는오류코드테이블참조. SOAP 1.1 POST /V1/BaroTIService.asmx HTTP/1.1 Host: eval.dexteditor.com SOAPAction: "http://ws.barobill.co.kr/v1/issuetaxinvoice" <IssueTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKey>string</MgtKey> <SendSMS>boolean</SendSMS> </IssueTaxInvoice> HTTP/1.1 200 OK <IssueTaxInvoiceResponse xmlns="http://ws.barobill.co.kr/v1/"> <IssueTaxInvoiceResult>int</IssueTaxInvoiceResult> </IssueTaxInvoiceResponse> 43 페이지

3.20. ProcTaxInvoice 세금계산서에대한바로빌내부기능을지원한다. 지원되는기능은, ProcType에따라달리하게되며, 세금계산서상태에따라처리결과가반환된다. 지원되는기능은 ProcType에대한 Table을참고한다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O MgtKey String 24 확인할세금계산서의발행자부여관리번호 O ProcType String 30 -ProcType Table 참고 O Memo String 200 취소요청, 요청에대한거부시의사유를입력한다. 반환값 : 0: 동일한프로세스가처리중입니다. 1: 처리완료. 기타음수값은오류테이블을참고한다. ProcType Table ProcType 설명 ACCEPT_INVOICE 수신한정발행세금계산서를승인합니다. REFUSE_INVOICE 수신한정발행세금계산서를거부합니다. UNDO_ACCEPTREQ 정발행세금계산서승인요청을취소합니다. UNDO_ISSUEREQ 역발행세금계산서발행요청을취소합니다. REQUEST_CANCEL 완료된세금계산서에대해취소를요청합니다. UNDO_CANCELREQ REQUEST_CANCEL( 취소요청 ) 를취소합니다. ACCEPT_CANCELREQ 완료된세금계산서에대한취소요청을승인합니다. REFUSE_CANCELREQ 완료된세금계산서에대한취소요청을거부합니다. REFUSE_ISSUEREQ 수신한역발행세금계산서를거부합니다. SOAP 1.1 POST /V1/BaroTIService.asmx HTTP/1.1 Host: eval.dexteditor.com SOAPAction: "http://ws.barobill.co.kr/v1/proctaxinvoice" <ProcTaxInvoice xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKey>string</MgtKey> <ProcType>string</ProcType> <Memo>string</Memo> </ProcTaxInvoice> HTTP/1.1 200 OK 44 페이지

<ProcTaxInvoiceResponse xmlns="http://ws.barobill.co.kr/v1/"> <ProcTaxInvoiceResult>int</ProcTaxInvoiceResult> </ProcTaxInvoiceResponse> 45 페이지

3.21. AttachFileByFTP 지정된 FTP로전송한파일을해당세금계산서로첨부함. 자세한관련사항은부록 A.5. FTP를이용한파일첨부방법안내참조. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O MgtKey String 24 첨부할세금계산서의발행자부여관리번호 O FileName String 300 FTP전송한파일명과확장자 O 반환값 : 1: 첨부완료. 기타음수값은오류테이블을참고한다. SOAP 1.1 POST /V1/BaroTIService.asmx HTTP/1.1 Host: testws.barobill.co.kr SOAPAction: "http://ws.barobill.co.kr/v1/attachfilebyftp" <AttachFileByFTP xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKey>string</MgtKey> <FileName>string</FileName> </AttachFileByFTP> HTTP/1.1 200 OK <AttachFileByFTPResponse xmlns="http://ws.barobill.co.kr/v1/"> <AttachFileByFTPResult>int</AttachFileByFTPResult> </AttachFileByFTPResponse> 46 페이지

3.22. DeleteAttachFile 세금계산서에첨부된파일을삭제합니다. 매개변수 타입 길이 설명 필수 CERTKEY string 50 인증키 O CorpNum string 13 발행사업자등록번호 ( - 제외 ) O MgtKey String 24 삭제할세금계산서의발행자부여관리번호 O 반환값 : 0 : 첨부파일이없습니다. 1 : 삭제완료기타음수값은오류테이블을참고한다. SOAP 1.1 POST /V1/BaroTIService.asmx HTTP/1.1 Host: testws.barobill.co.kr SOAPAction: "http://ws.barobill.co.kr/v1/deleteattachfile" <DeleteAttachFile xmlns="http://ws.barobill.co.kr/v1/"> <CERTKEY>string</CERTKEY> <MgtKey>string</MgtKey> </DeleteAttachFile> HTTP/1.1 200 OK <DeleteAttachFileResponse xmlns="http://ws.barobill.co.kr/v1/"> <DeleteAttachFileResult>int</DeleteAttachFileResult> </DeleteAttachFileResponse> 47 페이지

4. 오류코드테이블 반환값, 또는 ReturnVal.RetVal 이음수일경우에러코드관련정보. 오류코드메시지설명 -10000 UNKNOWN EXCEPTION 알수없는오류발생 -10001 CERTKEY IS NOT INVALID 인증키오류 -11001 INVOICER CONTACTID IS INVALID 공급자회원아이디가잘못되었습니다. -11002 INVOICERPARTY IS NULL 공급자정보없음 -11003 INVOICEEPARTY IS NULL 공급받는자정보없음 -11004 BROKERPARTY IS NULL 위탁자정보없음 -11005 ISSUEDIRECTION IS INVALID 발행방향이잘못되었습니다. -11006 AMOUNTTOTAL IS INVALID 공급가액총액이잘못되었습니다. 1이상의숫자만입력됩니다. -11007 PURPOSETYPE IS INVALID 영수 / 청구구분이잘못되었습니다. -11008 TAXCALCTYPE IS INVALID 세금계산방식이잘못되었습니다. -11009 TAXINVOICETYPE IS INVALID 세금계산서형태가잘못되었습니다. -11010 TAXTYPE IS INVALID 과세형태가잘못되었습니다. -11011 INVOICERMGTNUM IS INVALID 공급자부여관리번호가잘못되었습니다. -11012 INVOICEEMGTNUM IS INVALID 공급받는자부여관리번호가잘못되었습니다. -11013 MGTNUM ALREADY EXISTS 발행자관리번호로이미등록된건이있습니다. -11014 BROKER CONTACTID IS INVALID 수탁자회원아이디가잘못되었습니다. -11015 TOTALAMOUNT IS INVALID 합계금액이잘못되었습니다. 1이상의숫자만입력됩니다. -11016 TAXTOTAL IS INVALID 세액합계가잘못되었습니다. 없을경우 0-11017 INVOICEE CONTACTID IS INVALID 공급받는자아이디가잘못되었습니다. -11018 BROKER MGTNUM IS INVALID 수탁자부여관리번호가잘못되었습니다. -11101 INVOICERPARTY.CORPNUM IS INVALID 공급자사업자등록번호가잘못되었습니다. -11102 INVOICERPARTY.CORPNAME IS INVALID 공급자상호가잘못되었습니다. -11103 INVOICERPARTY.CEONAME IS INVALID 공급자대표자성명이잘못되었습니다. -11104 INVOICERPARTY.ADDR IS INVALID 공급자주소가잘못되었습니다. -11105 INVOICERPARTY.BIZCLASS IS INVALID 공급자업종이잘못되었습니다. -11106 INVOICERPARTY.BIZTYPE IS INVALID 공급자업태가잘못되었습니다. -11107 INVOICERPARTY.CONTACTNAME IS INVALID 공급자담당자성명이잘못되었습니다. -11108 INVOICERPARTY.EMAIL IS INVALID 공급자이메일이잘못되었습니다. -11201 INVOICEEPARTY.CORPNUM IS INVALID 공급받는자사업자등록번호가잘못되었습니다. -11202 INVOICEEPARTY.CORPNAME IS INVALID 공급받는자상호가잘못되었습니다. -11203 INVOICEEPARTY.CEONAME IS INVALID 공급받는자대표자성명이잘못되었습니다. -11204 INVOICEEPARTY.ADDR IS INVALID 공급받는자주소가잘못되었습니다. -11205 INVOICEEPARTY.BIZCLASS IS INVALID 공급받는자업종이잘못되었습니다. -11206 INVOICEEPARTY.BIZTYPE IS INVALID 공급받는자업태가잘못되었습니다. -11207 INVOICEEPARTY.CONTACTNAME IS INVALID 공급받는자담당자성명이잘못되었습니다. -11208 INVOICEEPARTY.EMAIL IS INVALID 공급받는자이메일이잘못되었습니다. -11301 BROKERPARTY.CORPNUM IS INVALID 수탁자사업자등록번호가잘못되었습니다. -11302 BROKERPARTY.CORPNAME IS INVALID 수탁자상호가잘못되었습니다. -11303 BROKERPARTY.CEONAME IS INVALID 수탁자대표자성명이잘못되었습니다. -11304 BROKERPARTY.ADDR IS INVALID 수탁자주소가잘못되었습니다. -11305 BROKERPARTY.BIZCLASS IS INVALID 수탁자업종이잘못되었습니다. -11306 BROKERPARTY.BIZTYPE IS INVALID 수탁자업태가잘못되었습니다. -11307 BROKERPARTY.CONTACTNAME IS INVALID 수탁자담당자성명이잘못되었습니다. -11308 BROKERPARTY.EMAIL IS INVALID 수탁자이메일이잘못되었습니다. -11801 KWON IS INVALID 권항목이잘못되었습니다. 숫자만입력됩니다. -11802 HO IS INVALID 호항목이잘못되었습니다. 숫자만입력됩니다. -11803 CASH IS INVALID 현금항목이잘못되었습니다. 숫자만입력됩니다. 48 페이지

-11804 CHKBILL IS INVALID 수표항목이잘못되었습니다. 숫자만입력됩니다. -11805 NOTE IS INVALID 어음항목이잘못되었습니다. 숫자만입력됩니다. -11806 CREDIT IS INVALID 외상미수금항목이잘못되었습니다. 숫자만입력됩니다. -12002 CORPNUM IS NOT EXIST 사업자번호가존재하지않습니다. -12004 CORPNUM IS QUIT 사업자번호는휴 / 폐업상태입니다. -12005 CORPNUM IS OUTOFMEMBER 사업자번호는탈퇴된회원입니다. -12006 CORPNUM IS NOT ASSIGNED 사업자번호는해당인증키로연동할수없습니다. ( 연동문의요 ) -21000 UOW NOT READY DB연결에실패하였습니다. -21001 INVOICE IS NULL 세금계산서정보가없습니다. -21002 INVOICE IS NOT EXISTS 해당세금계산서정보가없습니다. -21003 INVOICE IS NOT DELETABLE 해당세금계산서는삭제될수없습니다. -21004 INVOICE IS ON PROCESSING 해당세금계산서는처리가진행중인상태로삭제될수없습니다. -21005 INVOICE IS NOT TEMPSAVED 해당세금계산서는임시저장상태가아닙니다. -24002 TAXINVOICETYPE IS NOT INVALID 세금계산서형태가잘못되었습니다. -24003 INVOICERCOPRNUM IS NOT INVALID 공급자사업자번호가잘못되었습니다. -24004 INVOICEECOPRNUM IS NOT INVALID 공급받는자사업자번호가잘못되었습니다. -24005 CORPNUM AND CONTACTID IS MISMATCH 사업자등록번호와담당자아이디가맞지않습니다. -24011 TAXINVOICE DB INSERT FAILED 세금계산서 DB입력에실패하였습니다. -24012 TAXINVOICELINEITEM DB INSERT FAILED 세금계산서상세항목 DB입력에실패하였습니다. -25002 TAXINVOICETYPE IS NOT INVALID 세금계산서형태가잘못되었습니다. -25003 BROKERCORPNUM IS INVALID 위탁자사업자번호가잘못되었습니다. -25004 ISSUEDIRECTION IS INVALID 발행방향이잘못되었습니다. -25005 INVOICERCONTACTID IS INVALID 공급받는자회원아이디가잘못되었습니다. -25011 TAXINVOICE DB INSERT FAILED 세금계산서 DB입력에실패하였습니다. -25012 TAXINVOICELINEITEM DB INSERT FAILED 세금계산서상세항목 DB입력에실패하였습니다. -25013 TRUSTER PARTY DB INSERT FAILED 수탁자정보 DB입력에실패하였습니다. -26000 TAXINVOICE STATE IS NOT ISSUEABLE 해당세금계산서는임시저장상태가아니므로발행이불가능합니다. -26001 CORP CERTIFICATE NOT REGISTERED 발행에필요한공인인증서가등록되어있지않습니다. -26002 CORP CERTIFICATE IS EXPIRED 등록된공인인증서가만료일이지나유효하지않습니다. -26003 CERTIFICATE IS INVALID 등록된공인인증서의검증에실패하였습니다. 재등록하십시오. -26004 ISSUE CHARGE UNAVAILABLE 발행비용을과금할수없습니다. 요금제도를확인하세요. -26005 TAXINVOICE XML LOAD FAIL 해당세금계산서서명용 XML문서로딩에실패하였습니다. -30000 PROCTYPE IS INVALID 지원되지않는 PROCTYPE입니다. -30001 TAXINVOICE STATE IS INVALID, CHECKSTATE 해당세금계산서의상태가 PROCTYPE처리에맞지않습니다. -30002 TAXINVOICEPROC IS NOT READYSTATE 다른 PROCTYPE을처리중이거나, 이미처리가완료되었습니다. -30003 ISSUEDIRECTION IS INVALID 해당 PROCTYPE은정발행세금계산서전용입니다. -30004 ISSUEDIRECTION IS INVALID 해당 PROCTYPE은역발행세금계산서전용입니다. -30005 CORPNUM IS NOT INVOICEE 해당세금계산서에대한공급받는자가아닙니다. -30006 CORPNUM IS NOT INVOICER 해당세금계산서에대한공급자가아닙니다. -30007 PROC IS SENT BY CORPNUM 요청한 PROCTYPE에대해요청자가처리할수없습니다. -33000 FILE NOT FOUND FTP전송된파일이없습니다. -34002 TAXINVOICETYPE IS NOT INVALID 세금계산서형태가잘못되었습니다. -34020 TAXINVOICE STATE IS NOT TEMPSAVED 세금계산서가임시저장상태가아닙니다. -34021 TAXINVOICE DB UPDATE FAILED 세금계산서 DB수정이실패하였습니다. -34022 TAXINVOICELINEITEM DB UPDATE FAILED 세금계산서상세항목 DB수정에실패하였습니다. -35002 TAXINVOICETYPE IS NOT INVALID 세금계산서형태가잘못되었습니다. -35020 TAXINVOICE STATE IS NOT TEMPSAVED 세금계산서가임시저장상태가아닙니다. -35021 TAXINVOICE DB UPDATE FAILED 세금계산서 DB수정에실패하였습니다. -35012 TAXINVOICELINEITEM DB INSERT FAILED 세금계산서상세항목 DB수정에실패하였습니다. 49 페이지

5. SOAP 객체상세설명 5.1. TaxInvoice 항목명 ( 경로포함 ) 국문 영문 T L O 비고 바로빌관리번호 InvoiceKey S 24 0..1 바로빌에서부여하는관리번호 발행방향 IssueDirection N 1 1 1: 정발행 2: 역발행 ( 위수탁세금계산서는정발행만허용 ) 공급자정보 InvoicerParty O - 1 InvoiceParty 참고 공급받는자정보 InvoiceeParty O - 1 InvoiceParty 참고 수탁자정보 BrokerParty O - 0..1 InvoiceParty 참고위수탁세금계산서등록 / 수정시발행자 ( 수탁자 ) 정보반드시기재 세금계산서형태 TaxInvoiceType N 1 1 1 : 일반세금계산서 4: 위수탁세금계산서 과세형태 TaxType N 1 1 1: 과세 2: 영세 3: 면세 ( 계산서 ) 세율계산형태 TaxCalcType N 1 1 1: 절상 2: 절사 3: 반올림 영수 / 청구형태 PurposeType N 1 1 1: 영수 2: 청구 수정사유코드 ModifyCode S 4 0..1 수정세금계산서작성시에수정코드사유코드반드시기재 1: 기제사항의착오 / 정정 2: 공급가액의변동 3: 환입 4: 계약의혜지 5: 내국신용장사후개설 권 Kwon N 4 0..1 별지서식 11호상의 [ 권 ] 항목 호 Ho N 4 0..1 별지서식 11호상의 [ 호 ] 항목 일련번호 SerialNum S 27 0..1 별지서식 11호상의 [ 일련번호 ] 항목 공급가액합계 AmountTotal N 18 1 소수점없음, 자릿수구분기호 (, ) 제외하고, 숫자만입력 세금합계 TaxTotal N 18 1 소수점없음, 자릿수구분기호 (, ) 제외하고, 숫자만입력 총액 TotalAmount N 18 1 소수점없음, 자릿수구분기호 (, ) 제외하고, 숫자만입력 현금 Cash N 18 0..1 소수점없음, 자릿수구분기호 (, ) 제외하고, 숫자만입력 수표 ChkBill N 18 0..1 소수점없음, 자릿수구분기호 (, ) 제외하고, 숫자만입력 어음 Note N 18 0..1 소수점없음, 자릿수구분기호 (, ) 제외하고, 숫자만입력 외상미수금 Credit N 18 0..1 소수점없음, 자릿수구분기호 (, ) 제외하고, 숫자만입력 비고1 Remark1 S 150 0..1 별지서식상에표시됨 비고2 Remark2 S 150 0..1 별도활용 비고3 Remark3 S 150 0..1 별도활용 작성일자 WriteDate S 8 0..1 작성일자 YYYYMMDD형식, 미입력시기본값등록일자. 계산서상세항목 TaxInvoiceTradeLineItems O - 0..99 국세청전송스펙에따라 99개까지지원 TaxInvoiceTradeLineItem 참고 위수탁세금계산서작성시에는수탁자정보에발행자의정보가반드시기재되어야한다. 위수탁세금계산서는발행방향이정발행만지원한다. 수정세금계산서는해당세금계산서형태에수정사유코드가기재될경우수정세금계산서로간주한다. 일반세금계산서정발행시에는발행자의정보가공급자정보에, 역발행시에는발행자정보가공급받는자에관리번호와함께기재한다. 일반세금계산서역발행시에는공급자와공급받는자모두바로빌회원사이어야하며, ContactID를기재하여야한다. 위수탁세금계산서는발행자의정보를수탁자정보에관리번호와함께기재하고, 공급자와공급받는자정보를기재하되, 공급자는반드시바로빌회원사이어야하며, InvoiceParty.ContactID를기재하여야한다. 과세형태를 (3: 면세 ) 로할경우계산서로처리된다. InvoiceeParty.ContactID가미기재시일경우공급받는자는비회원으로발송된다. 회원발송일경우반드시기재해야한다. GetCorpMemeberContacts를활용한다. 일반세금계산서정발행시 InvoicerParty.ContactID( 발행자의회원아이디 ) 가미지정되었을경우자동으로바로빌가입정보에관리자로지정된아이디로저장이된다. 50 페이지

5.2. InvoiceParty 항목명 ( 경로포함 ) 국문 영문 T L O 비고 관리번호 MgtNum S 24 0..1 발행사업자가부여하는관리번호. 발행사업자정보를표현시에반드시기재. 정발행시에는 TaxInvoice.InvoicerParty에역발행시에는 TaxInvoice.BrokerParty에기재한다. 사업자등록번호 CorpNum S 13 1 - 제외 종사업장식별번호 TaxRegID S 4 0..1 사업자단위과세제도사용시국세청부여종사업장식별번호 상호 CorpName S 70 1 특수기호사용불가 ex. 특수기호중 1Byte ( 주 ) 는괄호로입력 대표자성명 CEOName S 30 1 주소 Addr S 150 1 업종 BizClass S 40 1 업태 BizType S 40 1 담당자회원아이디 ContactID S 12 0..1 바로빌회원아이디, InvoicerParty, BrokerParty로쓰일때는필수 InvoiceeParty에서미기재시비회원으로발송됨. 역발행시에는 InvoiceeParty에서도필수대소문자구문함 담당자성명 ContactName S 30 1 연락처 TEL S 20 0..1 - 포함된전화번호 휴대전화 HP S 20 0..1 - 포함된휴대전화번호 SMS발신용 이메일 Email S 40 1 Email은반드시기재 사업자정보는공급자, 공급받는자, 수탁자정보를표현할때사용된다. 일반세금계산서는공급자, 공급받는자정보가필수이며, 발행자의정보가정발행은공급자, 역발행은공급받는자정보에기재되어야한다. 발행자의정보에는관리번호를반드시기재하여야한다. 위수탁세금계산서는공급자, 공급받는자, 수탁자정보가필수이며, 발행자의정보가수탁자정보에관리번호와회원아이디가반드시함께기재되어야한다. 일반세금계산서정발행시에는 InvoicerParty.ContactID를지정하지않으면자동으로바로빌회원사정보에서관리자아이디를추출하여자동으로입력된다. 5.3. TaxInvoiceTradeLineItem 항목명 ( 경로포함 ) 국문 영문 T L O 비고 공급년월일 PurchaseExpiry S 8 0..1 YYYYMMDD로표기 품목명 Name S 100 0..1 규격 Information S 60 0..1 수량 ChargeableUnit N 12.1 0..1 소수점 2자리까지표기가능 ( 예 : 1/2 ->0.5) 단가 UnitPrice N 18 0..1 소수점 2자리까지표기가능 공급가액 Amount N 18 0..1 소수점불가 세액 Tax N 18 0..1 소수점불가 비고 Description S 40 0..1 수량과단가는소수점 2자리까지허용하나이를합산한공급가액과세액은소수점기재가불가하다. 수정계산서작성을위해서 - 값을허용한다. 51 페이지

5.4. Contact 항목명 ( 경로포함 ) 국문 영문 T L O 비고 회원아이디 ID S 12 1 대소문자구분됨. 담당자성명 ContactName S 30 1 직위 Grade S 20 0..1 이메일 Email S 40 1 연락처 TEL S 20 0..1 - 포함된전화번호 휴대전화 HP S 20 0..1 - 포함된휴대전화번호 5.5. ReturnVal 항목명 ( 경로포함 ) 국문 영문 T L O 비고 발행자관리번호 MgtKey S 24 1 반환값 RetVal N 10 1 각 Web method 반환값참고 바로빌관리번호 InvoiceKey S 24 1 비고1 Remark1 S 200 0..1 상태처리에대한요청자의처리사유 비고2 Remark2 S 200 0..1 상태처리에대한수신자의처리사유 52 페이지

6. Test Bed 연동사업자의개발지원을위해바로빌의 Test Bed를운영중이며, 해당사이트를통해, 연동자료의확인및테스트발행, 상태값을확인할수있다. Test Bed URL : http://testbed.barobill.co.kr Test Bed 연동 Web Service URI : http://testws.barobill.co.kr/v1/barotiservice.asmx Test Bed 의자료는관리측면에서언제든지자료가변경, 삭제될수있음. 53 페이지

A. 부록 A.1. Microsoft SOAP Toolkit 소개 SOAP Client가자체적으로지원하지않는솔루션중 Microsoft 계열의 Language(VisualBasic 6, Visual FoxPro 7, Borland Delphi 5, PowerBuilder 8 등 ) 에서본바로빌 Web service를사용하고자할경우 Microsoft에서제공하는 SOAP Toolkit을사용하여구현할수있다. Microsoft SOAP Toolkit은 Microsoft 사가 Web service SOAP Client를제공하지못하는자사의 Language를지원하기위해배포하고있는 SOAP Client 및 Web service 제작지원도구로, 다양한 Language에서사용되고있다. 바로빌은다양한환경에서연동 Web service를사용할수있도록 Microsoft Soap Toolkit을활용한 Proxy Class Module Sample 소스를제공할예정이며, 연동사업자는이를활용하여바로빌과연동을할수있다. Microsoft SOAP Toolkit 2.0 은 Microsoft XP Professional에기본포함되어있다. 특별한경우, 배포가문제될경우 Toolkit 2.0을활용하거나, 아래의 Microsoft SOAP Toolkit 3.0 Redistributable 을활용할수있다. Microsoft SOAP Toolkit 3.0 Redistributable Download http://www.microsoft.com/downloads/details.aspx?displaylang=en&familyid=c943c0dd-ceec-4088-9753- 86f052ec8450 54 페이지

A.2. Borland Delphi 7 연동방법및유의사항 Borland Delphi 7 이상의버전에서 Webservices 지원이가능해짐에따라다음의과정을통해연동서비스를사용할수있다. WSDL Importer를통해생성된 Proxy Module에설정을변경 / 추가함으로써, 연동부분을개발할수있다. 1. 상단메뉴에서 [File] - [New] - [Other] 를선택한다. 2. New Items 화면에서상단탭중에 [WebServices] 를선택하고, [WSDL Importer] 를선택한다. 3. WSDL Source 부에제공된 WSDL 을입력한다. 테스트베드의 WSDL 은 http://testws.barobill.co.kr/v1/barotiservice.asmx?wsdl 이다. 55 페이지

4. Code Preview 를통해생성된코드를확인하고 Finish 를누르면 BaroTIService.pas 가생성된다. 5. 생성된 BaroTIService.pas를프로젝트에추가한다음, 추가적으로다음부분을수정한다. A. function GetBaroTIServiceSoap를다음과같이수정한다. 이는 UTF-8지원부분이다.... if HTTPRIO = nil then RIO := THTTPRIO.Create(nil) else RIO := HTTPRIO; try Result := (RIO as BaroTIServiceSoap); RIO.HTTPWebNode.UseUTF8InHeader := true; if UseWSDL then begin RIO.WSDLLocation := Addr; RIO.Service := defsvc; RIO.Port := defprt; end else RIO.URL := Addr; finally if (Result = nil) and (HTTPRIO = nil) then RIO.Free; end;... B. 인수형 Web method 의경우 Delphi 에서 parameter 의갯수가많아, 인식이되지않으므로삭제한다.... BaroTIServiceSoap = interface(iinvokable) function RegistTaxInvoicePlain( ) // 삭제 function RegistBrokerTaxInvoicePlain( ) // 삭제 function UpdateTaxInvoicePlain( ) // 삭제 function UpdateBrokerTaxInvoicePlain( ) // 삭제 C. initialization 부분에다음코드를추가한다. 이는 Document/Literal 로바인딩하기위한것이다.... Initialization InvRegistry.RegisterInterface(TypeInfo(BaroTIServiceSoap), 'http://ws.barobill.co.kr/v1/', 'utf- 8'); InvRegistry.RegisterDefaultSOAPAction(TypeInfo(BaroTIServiceSoap), 'http://ws.barobill.co.kr/v1/%operationname%'); InvRegistry.RegisterInvokeOptions(TypeInfo(BaroTIServiceSoap), iodocument);... 56 페이지