Lexoffice(독립 게시자)(미리 보기)

Lexware API는 문서, 연락처, 청구서, 주문 및 파일 관리와 같은 핵심 Lexware 비즈니스 기능에 프로그래밍 방식으로 액세스할 수 있도록 합니다. 이 Independent Publisher 커넥터를 사용하면 Lexware의 REST API와 안전하게 통합할 수 있으므로 사용자가 비즈니스 데이터를 만들고 검색하고, 프로세스를 자동화하고, Lexware 리소스를 Power Platform 애플리케이션과 연결할 수 있습니다. 커넥터는 보안 인증 및 API 지침에 OAuth 2.0 인증 코드 흐름을 사용합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Premium	다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)
논리 앱	스탠다드	다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD)
Power Apps	Premium	다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)
Power Automate (파워 오토메이트)	Premium	다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)

연락처
이름	LowCode 조사자 지원
URL	https://lowcode-investigator.com/
전자 메일	kontakt@lowcodeinvestigator.com

커넥터 메타데이터
게시자	LowCodeInvestigator
웹 사이트	https://office.lexware.de/
개인 정보 보호 정책	https://office.lexware.de/datenschutz/
카테고리	비즈니스 관리; 금융

Lexware API 커넥터(독립 게시자)

Lexware API는 개발자가 연락처, 청구서, 문서 및 파일과 같은 Lexware 비즈니스 기능을 자체 애플리케이션에 통합할 수 있도록 하는 RESTful 인터페이스입니다. 이 커넥터를 사용하면 안전하고 인증된 API 요청을 통해 이러한 리소스와 직접 상호 작용할 수 있습니다.

게시자: 독립 게시자

필수 조건

등록된 Lexware 계정 및 적절한 라이선스
Lexware 개발자 포털을 통해 가져온 유효한 API 키(액세스 토큰)
인증을 위해 OAuth 2.0 인증 코드 흐름이 필요합니다.

지원되는 작업

이 커넥터는 다음 Lexware API 엔드포인트를 지원합니다.

문서: 아티클 만들기, 검색, 업데이트, 삭제 및 필터링
연락처: 고객 및 공급업체 데이터 관리
청구서: PDF 렌더링을 포함하여 청구서 데이터 만들기 및 검색
신용 메모, 배달 메모, 주문, 따옴표 및 바우처
국가, 결제 조건, 인쇄 레이아웃 및 프로필
이벤트 구독 및 파일
설명된 전체 목록: Lexware API 문서

자격 증명 가져오기

Lexware API를 호출하려면 API 키가 필요합니다.

Lexware Office 계정에 로그인합니다.
확장 → Weitere Apps → 공용 API로 이동하거나 열기
Lexware 개발자 포털 을 직접.
원하는 권한으로 새 API 키를 만듭니다.
생성된 API 키를 복사합니다. 이 값은 커넥터에서와 같이 accessToken 사용됩니다.

API 게이트웨이

새 Lexware API 게이트웨이를 사용하세요.

https://api.lexware.io

속도 제한

최대 2개 요청/초
이 제한을 초과하는 요청은 HTTP를 받습니다. 429 Too Many Requests
권장: 토큰 버킷 알고리즘 또는 지수 백오프 사용

Authentication

Lexware API는 OAuth 2.0 인증 코드 흐름을 사용합니다. 각 요청의 헤더에 토큰을 Authorization: Bearer {accessToken} 포함합니다.

사용 예시

문서 만들기:

curl https://api.lexware.io/v1/articles \
  -X POST \
  -H "Authorization: Bearer {accessToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Lexware Buchhaltung Premium 2024",
    "type": "PRODUCT",
    "unitName": "Download-Code",
    "articleNumber": "LXW-BUHA-2024-001",
    "price": {
      "netPrice": 61.90,
      "leadingPrice": "NET",
      "taxRate": 19
    }
  }'

알려진 문제 및 제한 사항

최대 2개 요청/초
일부 엔드포인트에는 추가 권한 또는 역할이 필요합니다.

API 문서

전체 API 참조는 다음 위치에서 사용할 수 있습니다.
https://developers.lexware.io/docs/

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.


기본값	연결을 만들기 위한 매개 변수입니다.	모든 지역	공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름	유형	Description	필수
API 키	시큐어스트링 (보안 문자열)	이 API의 API 키	진실

제한 한도

Name	호출	갱신 기간
연결당 API 호출	100	60초

동작

Event-Subscription 삭제	트리거 WebHook 삭제
게시 범주 목록 검색	이 엔드포인트는 어휘에서 지원되는 (부기) 바우처 수익 또는 비용에 대한 게시 범주 목록에 대한 읽기 권한을 제공합니다.
결제 정보 검색	결제 엔드포인트는 청구서 및 신용 메모를 포함하여 (부기 또는 판매) 바우처의 지불 상태에 대한 읽기 액세스를 제공합니다.
결제 조건 목록 검색	다음 샘플에서는 현재 구성된 결제 조건 목록을 검색하는 방법을 보여 있습니다. 요청을 보내기 전에 자리 표시자 {accessToken}을(를) 바꿔야 합니다.
계약금 청구서 검색	ID 값 {id}을(를) 사용하여 계약금 청구서를 반환합니다.
국가 목록 검색	어휘에 알려진 국가 목록입니다.
더닝 검색	ID 값 {id}이(가) 있는 dunning을 반환합니다.
더닝 만들기	만든 더닝은 어휘의 기본 바우처 목록에 표시되지 않지만 청구서에 첨부되어 표시됩니다. 고객에게 생성된 더닝에 대한 액세스를 제공하려면 딥링크 함수를 사용하세요.
더닝 문서 렌더링(PDF)	더닝 문서의 PDF 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 더닝 리소스에서 반환됩니다. 그러나 API를 통해 새로 만든 더닝은 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.
되풀이 템플릿 검색	ID 값 {id}을(를) 사용하여 되풀이 템플릿을 반환합니다.
따옴표 검색	ID 값이 {id}인 따옴표를 반환합니다. 인용 문서 렌더링(PDF)
따옴표 만들기	API를 통해 전송되는 따옴표는 기본값에 따라 초안 모드로 만들어집니다. 상태 열기로 마무리된 따옴표를 만들려면 선택적 쿼리 매개 변수 종료를 설정해야 합니다. API를 통해 따옴표의 상태를 변경할 수 없습니다.
모든 되풀이 템플릿 검색	되풀이 템플릿의 컬렉션을 검색합니다. 결과는 참조된 연락처(ID 및 이름만), 총 가격, 지불 조건 및 전체 되풀이 템플릿 설정인 가장 관련성이 큰 데이터의 일부만 반환합니다. 하지만 개체 및 속성의 이름은 동일합니다.
모든 연락처 검색	모든 연락처 검색
모든 이벤트 구독 검색	모든 이벤트 구독 검색
문서 업데이트	페이로드에 지정된 데이터를 JSON으로 사용하여 ID {id}로 기존 문서를 업데이트합니다. 성공에 대한 작업 결과를 반환합니다.
문서 필터링	페이징 메커니즘을 사용하여 filter_n filter_1 필터에서 지정한 조건을 충족하는 아티클을 반환합니다. 둘 이상의 필터가 지정된 경우 논리 커넥터는 AND입니다. 설정되지 않은 필터는 무시됩니다. 이 엔드포인트의 최대 페이지 크기를 확인하려면 리소스 페이징을 참조하세요.
바우처 검색	판매 바우처 나열(예: 청구서, 크레딧 주)
바우처 만들기	바우처 만들기(판매 바우처로 제한)
바우처 목록 검색 및 필터링	바우처 목록(부기) 바우처(예: salesinvoices, salescreditnotes), 청구서(계약금 청구서 포함), 신용 메모, 주문 확인, 따옴표 및 배달 메모를 가져옵니다.
바우처 업데이트	바우처 업데이트
바우처에 파일 업로드	{id}로 식별된 바우처에 파일(pdf 또는 이미지)을 업로드하고 할당합니다.
배달 메모 검색	ID 값 {id}을(를) 사용하여 배달 메모를 반환합니다.
배달 메모 만들기	만든 배달 메모는 어휘의 기본 바우처 목록에 표시됩니다. API를 통해 전송되는 배달 노트는 초안 모드에서만 생성됩니다.
배달 메모 문서 렌더링(PDF)	이 엔드포인트는 배달 노트에 대한 읽기 및 쓰기 액세스 권한을 제공하며 문서를 다운로드하기 위해 PDF로 렌더링할 수도 있습니다. 배달 노트는 항상 초안 모드에서 생성되며 완료할 필요가 없습니다.
신용 메모 검색	이 엔드포인트는 신용 메모에 대한 읽기 및 쓰기 액세스 권한을 제공하며 문서를 다운로드하기 위해 PDF로 렌더링할 수도 있습니다. 크레딧 노트는 초안으로 만들거나 오픈 모드에서 완료할 수 있습니다.
아티클 검색	ID 값 {id}을(를) 사용하여 아티클을 반환합니다.
아티클 만들기	문서의 내용은 요청 본문에 애플리케이션/json으로 필요합니다.
아티클 삭제	ID 값 {id}을(를) 사용하여 아티클을 삭제합니다. 성공하면 204를 반환하고 ID가 없으면 404를 반환합니다.
연락처 검색	ID로 연락처 검색
연락처 만들기	새 연락처 만들기
연락처 업데이트	연락처 업데이트
이벤트 구독 검색	이벤트 구독 검색
인용 문서 렌더링(PDF)	인용 문서의 pdf 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 따옴표 리소스에서 반환됩니다. 그러나 API를 통해 열려 있는 상태에서 새로 만든 따옴표는 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.
주문 확인 검색	ID 값 {id}을(를) 사용하여 주문 확인을 반환합니다.
주문 확인 만들기	이 엔드포인트는 주문 확인에 대한 읽기 및 쓰기 액세스 권한과 문서를 다운로드하기 위해 PDF로 렌더링할 수도 있습니다. 주문 확인은 항상 초안 모드로 생성되며 완료할 필요가 없습니다.
주문 확인 문서 렌더링(PDF)	주문 확인 문서의 PDF 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 주문 확인 리소스에서 반환됩니다. 그러나 API를 통해 새로 만든 주문 확인은 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.
청구서 검색	ID 값 {id}이(가) 있는 청구서를 반환합니다.
청구서 만들기	API를 통해 전송되는 송장은 기본값에 따라 초안 모드로 생성됩니다. 상태가 열려 있는 최종 송장을 만들려면 선택적 쿼리 매개 변수 종료를 설정해야 합니다. API를 통해 청구서 상태를 변경할 수 없습니다.
청구서 문서 렌더링(PDF)	청구서 문서의 pdf 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 청구서 리소스에서 반환됩니다. 그러나 API를 통해 열려 있는 상태에서 새로 만든 청구서는 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.
크레딧 메모 만들기	API를 통해 전송되는 신용 정보는 기본값에 따라 초안 모드로 생성됩니다. 상태가 열려 있는 완료된 크레딧 메모를 만들려면 선택적 쿼리 매개 변수 종료를 설정해야 합니다. API를 통해 신용 메모의 상태를 변경할 수 없습니다.
크레딧 메모 문서 렌더링(PDF)	신용 메모 문서의 pdf 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 신용 메모 리소스에서 반환됩니다. 그러나 API를 통해 열려 있는 상태에서 새로 만든 신용 메모는 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.
파일 다운로드	이 엔드포인트를 사용하여 파일을 다운로드합니다.
파일 업로드	이 엔드포인트를 사용하여 파일(예: 바우처 또는 청구서)을 업로드합니다.
프로필 정보 검색	다음 샘플에서는 기본 프로필 정보를 검색하는 방법을 보여 줍니다. 요청을 보내기 전에 자리 표시자 {accessToken}을(를) 바꿔야 합니다.

Event-Subscription 삭제

작업 ID:: DeleteEventSubscription

트리거 WebHook 삭제

매개 변수

Name	키	필수	형식	Description
구독 ID	subscriptionId	True	string	구독 ID를 지정합니다.

게시 범주 목록 검색

작업 ID:: RetrieveListPostingCategories

이 엔드포인트는 어휘에서 지원되는 (부기) 바우처 수익 또는 비용에 대한 게시 범주 목록에 대한 읽기 권한을 제공합니다.

반환

response: array of Response_posting-categories_get_items

결제 정보 검색

작업 ID:: RetrievePaymentInformation

결제 엔드포인트는 청구서 및 신용 메모를 포함하여 (부기 또는 판매) 바우처의 지불 상태에 대한 읽기 액세스를 제공합니다.

매개 변수

Name	키	필수	형식	Description
바우처 ID	voucherId	True	string	바우처 ID를 지정합니다.

반환

Name	경로	형식
currency	currency	string
openAmount	openAmount	string
paymentItems	paymentItems	array of object
분량	paymentItems.amount	float
currency	paymentItems.currency	string
paymentItemType	paymentItems.paymentItemType	string
postingDate	paymentItems.postingDate	date-time
결제 상태	paymentStatus	string
voucherStatus	voucherStatus	string
voucherType	voucherType	string

결제 조건 목록 검색

작업 ID:: RetrieveListOfPaymentConditions

다음 샘플에서는 현재 구성된 결제 조건 목록을 검색하는 방법을 보여 있습니다. 요청을 보내기 전에 자리 표시자 {accessToken}을(를) 바꿔야 합니다.

반환

response: array of Response_payment-conditions_get_items

계약금 청구서 검색

작업 ID:: RetrieveDownPaymentInvoice

ID 값 {id}을(를) 사용하여 계약금 청구서를 반환합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
city	address.city	string
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
보충	address.supplement	string
zip	address.zip	string
보관	archived	boolean
closingInvoiceId	closingInvoiceId	uuid
생성일	createdDate	date-time
기한날짜	dueDate	date-time
documentFileId	files.documentFileId	uuid
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
lineItemAmount	lineItems.lineItemAmount	number
이름	lineItems.name	string
수량	lineItems.quantity	number
type	lineItems.type	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	number
netAmount	lineItems.unitPrice.netAmount	number
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
discountPercentage	paymentConditions.paymentDiscountConditions.discountPercentage	number
discountRange	paymentConditions.paymentDiscountConditions.discountRange	integer
paymentTermDuration	paymentConditions.paymentTermDuration	integer
paymentTermLabel	paymentConditions.paymentTermLabel	string
paymentTermLabelTemplate	paymentConditions.paymentTermLabelTemplate	string
말	remark	string
shippingType	shippingConditions.shippingType	string
taxAmounts	taxAmounts	array of object
netAmount	taxAmounts.netAmount	number
taxAmount	taxAmounts.taxAmount	number
taxRatePercentage	taxAmounts.taxRatePercentage	number
taxType	taxConditions.taxType	string
title	title	string
currency	totalPrice.currency	string
totalGrossAmount	totalPrice.totalGrossAmount	number
totalNetAmount	totalPrice.totalNetAmount	number
totalTaxAmount	totalPrice.totalTaxAmount	number
updatedDate	updatedDate	date-time
version	version	integer
voucherDate	voucherDate	date-time
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

국가 목록 검색

작업 ID:: RetrieveListCountries

어휘에 알려진 국가 목록입니다.

반환

response: array of Response_countries_get_default

더닝 검색

작업 ID:: RetrieveDunning

ID 값 {id}이(가) 있는 dunning을 반환합니다.

매개 변수

Name	키	필수	형식	Description
더닝시드 주	dunningsid	True	string	dunningsid를 지정합니다.

반환

Name	경로	형식
city	address.city	string
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
보충	address.supplement	string
zip	address.zip	string
보관	archived	boolean
생성일	createdDate	date-time
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
discountPercentage	lineItems.discountPercentage	number
lineItemAmount	lineItems.lineItemAmount	number
이름	lineItems.name	string
수량	lineItems.quantity	number
type	lineItems.type	string
unitName	lineItems.unitName	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	number
netAmount	lineItems.unitPrice.netAmount	number
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
relatedVouchers	relatedVouchers	array of object
아이디	relatedVouchers.id	uuid
voucherNumber	relatedVouchers.voucherNumber	string
voucherType	relatedVouchers.voucherType	string
말	remark	string
shippingDate	shippingConditions.shippingDate	date-time
shippingType	shippingConditions.shippingType	string
taxAmounts	taxAmounts	array of object
netAmount	taxAmounts.netAmount	number
taxAmount	taxAmounts.taxAmount	number
taxRatePercentage	taxAmounts.taxRatePercentage	number
taxType	taxConditions.taxType	string
title	title	string
currency	totalPrice.currency	string
totalGrossAmount	totalPrice.totalGrossAmount	number
totalNetAmount	totalPrice.totalNetAmount	number
totalTaxAmount	totalPrice.totalTaxAmount	number
updatedDate	updatedDate	date-time
version	version	integer
voucherDate	voucherDate	date-time
voucherStatus	voucherStatus	string

더닝 만들기

작업 ID:: CreateDunning

만든 더닝은 어휘의 기본 바우처 목록에 표시되지 않지만 청구서에 첨부되어 표시됩니다. 고객에게 생성된 더닝에 대한 액세스를 제공하려면 딥링크 함수를 사용하세요.

매개 변수

Name	키	필수	형식	Description
이전 판매 바우처 ID	precedingSalesVoucherId		string	이전 판매 바우처 ID를 지정합니다.

반환

몸: Response_dunnings_post

더닝 문서 렌더링(PDF)

작업 ID:: RenderDunningDocument

더닝 문서의 PDF 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 더닝 리소스에서 반환됩니다. 그러나 API를 통해 새로 만든 더닝은 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.

매개 변수

Name	키	필수	형식	Description
더닝시드 주	dunningsid	True	string	dunningsid를 지정합니다.

반환

Name	경로	형식	Description
documentFileId	documentFileId	uuid

되풀이 템플릿 검색

작업 ID:: RetrieveRecurringTemplate

ID 값 {id}을(를) 사용하여 되풀이 템플릿을 반환합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
city	address.city	string
contactId	address.contactId	uuid
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
zip	address.zip	string
보관	archived	boolean
생성일	createdDate	date-time
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
discountPercentage	lineItems.discountPercentage	number
lineItemAmount	lineItems.lineItemAmount	number
이름	lineItems.name	string
수량	lineItems.quantity	number
type	lineItems.type	string
unitName	lineItems.unitName	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	number
netAmount	lineItems.unitPrice.netAmount	number
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
paymentTermDuration	paymentConditions.paymentTermDuration	integer
paymentTermLabel	paymentConditions.paymentTermLabel	string
paymentTermLabelTemplate	paymentConditions.paymentTermLabelTemplate	string
recurringTemplateSettings	recurringTemplateSettings	object
말	remark	string
taxAmounts	taxAmounts	array of object
netAmount	taxAmounts.netAmount	number
taxAmount	taxAmounts.taxAmount	number
taxRatePercentage	taxAmounts.taxRatePercentage	number
taxType	taxConditions.taxType	string
title	title	string
currency	totalPrice.currency	string
totalGrossAmount	totalPrice.totalGrossAmount	number
totalNetAmount	totalPrice.totalNetAmount	number
totalTaxAmount	totalPrice.totalTaxAmount	number
updatedDate	updatedDate	date-time
version	version	integer

따옴표 검색

작업 ID:: RetrieveQuotation

ID 값이 {id}인 따옴표를 반환합니다. 인용 문서 렌더링(PDF)

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
city	address.city	string
contactId	address.contactId	uuid
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
zip	address.zip	string
보관	archived	boolean
생성일	createdDate	date-time
유효기간	expirationDate	date-time
documentFileId	files.documentFileId	uuid
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
대안	lineItems.alternative	boolean
discountPercentage	lineItems.discountPercentage	number
아이디	lineItems.id	uuid
lineItemAmount	lineItems.lineItemAmount	number
이름	lineItems.name	string
optional	lineItems.optional	boolean
수량	lineItems.quantity	number
하위	lineItems.subItems	array of object
대안	lineItems.subItems.alternative	boolean
discountPercentage	lineItems.subItems.discountPercentage	number
아이디	lineItems.subItems.id	uuid
lineItemAmount	lineItems.subItems.lineItemAmount	number
이름	lineItems.subItems.name	string
optional	lineItems.subItems.optional	boolean
수량	lineItems.subItems.quantity	number
type	lineItems.subItems.type	string
unitName	lineItems.subItems.unitName	string
currency	lineItems.subItems.unitPrice.currency	string
grossAmount	lineItems.subItems.unitPrice.grossAmount	number
netAmount	lineItems.subItems.unitPrice.netAmount	number
taxRatePercentage	lineItems.subItems.unitPrice.taxRatePercentage	number
type	lineItems.type	string
unitName	lineItems.unitName	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	number
netAmount	lineItems.unitPrice.netAmount	number
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
discountPercentage	paymentConditions.paymentDiscountConditions.discountPercentage	number
discountRange	paymentConditions.paymentDiscountConditions.discountRange	integer
paymentTermDuration	paymentConditions.paymentTermDuration	integer
paymentTermLabel	paymentConditions.paymentTermLabel	string
paymentTermLabelTemplate	paymentConditions.paymentTermLabelTemplate	string
말	remark	string
taxAmounts	taxAmounts	array of object
netAmount	taxAmounts.netAmount	number
taxAmount	taxAmounts.taxAmount	number
taxRatePercentage	taxAmounts.taxRatePercentage	number
taxType	taxConditions.taxType	string
title	title	string
currency	totalPrice.currency	string
totalGrossAmount	totalPrice.totalGrossAmount	number
totalNetAmount	totalPrice.totalNetAmount	number
totalTaxAmount	totalPrice.totalTaxAmount	number
updatedDate	updatedDate	date-time
version	version	integer
voucherDate	voucherDate	date-time
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

따옴표 만들기

작업 ID:: CreateQuotation

API를 통해 전송되는 따옴표는 기본값에 따라 초안 모드로 만들어집니다. 상태 열기로 마무리된 따옴표를 만들려면 선택적 쿼리 매개 변수 종료를 설정해야 합니다. API를 통해 따옴표의 상태를 변경할 수 없습니다.

매개 변수

Name	키	필수	형식	Description
마무리	finalize	True	boolean	종료를 지정합니다.

반환

몸: Response_quotations_post

모든 되풀이 템플릿 검색

작업 ID:: RetrieveAllRecurringTemplates

되풀이 템플릿의 컬렉션을 검색합니다. 결과는 참조된 연락처(ID 및 이름만), 총 가격, 지불 조건 및 전체 되풀이 템플릿 설정인 가장 관련성이 큰 데이터의 일부만 반환합니다. 하지만 개체 및 속성의 이름은 동일합니다.

매개 변수

Name	키	형식	Description
페이지	page	integer	페이지를 지정합니다.
Size	size	integer	크기를 지정합니다.
정렬	sort	string	정렬을 지정합니다.

반환

몸: Response_recurring-templates_get

모든 연락처 검색

작업 ID:: RetrieveAllContacts

모든 연락처 검색

매개 변수

Name	키	형식	Description
Number	number	integer	숫자를 지정합니다.
전자 메일	email	string	전자 메일을 지정합니다.
이름	name	string	이름을 지정합니다.
공급업체	vendor	boolean	공급업체를 지정합니다.
고객	customer	boolean	고객을 지정합니다.
페이지	page	integer	페이지를 지정합니다.
Size	size	integer	크기를 지정합니다.
정렬	sort	string	정렬을 지정합니다.

반환

몸: Response_contacts_get

모든 이벤트 구독 검색

작업 ID:: RetrieveAllEventSubscriptions

모든 이벤트 구독 검색

반환

몸: Response_event-subscriptions_get

문서 업데이트

작업 ID:: UpdateAnArticle

페이로드에 지정된 데이터를 JSON으로 사용하여 ID {id}로 기존 문서를 업데이트합니다. 성공에 대한 작업 결과를 반환합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.
articleNumber	articleNumber		string	articleNumber
gtin	gtin		string	gtin
메모	note		string	메모
grossPrice	grossPrice	True	float	grossPrice
leadingPrice	leadingPrice	True	string	leadingPrice
netPrice	netPrice	True	float	netPrice
taxRate	taxRate		float	taxRate
title	title		string	title
type	type	True	string	type
unitName	unitName	True	string	unitName
version	version	True	integer	version

반환

몸: Response_articles_id_get

문서 필터링

작업 ID:: FilteringArticles

페이징 메커니즘을 사용하여 filter_n filter_1 필터에서 지정한 조건을 충족하는 아티클을 반환합니다. 둘 이상의 필터가 지정된 경우 논리 커넥터는 AND입니다. 설정되지 않은 필터는 무시됩니다. 이 엔드포인트의 최대 페이지 크기를 확인하려면 리소스 페이징을 참조하세요.

매개 변수

Name	키	형식	Description
문서 번호	articleNumber	string	아티클 번호를 지정합니다.
그틴 주	gtin	string	gtin을 지정합니다.
유형	type	string	형식을 지정합니다.
페이지	page	integer	페이지를 지정합니다.
Size	size	integer	크기를 지정합니다.
정렬	sort	string	정렬을 지정합니다.

반환

몸: Response_articles_get

바우처 검색

작업 ID:: RetrieveVoucher

판매 바우처 나열(예: 청구서, 크레딧 주)

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
생성일	createdDate	date-time
기한날짜	dueDate	date-time
files	files	array of string
아이디	id	uuid
조직 ID	organizationId	uuid
말	remark	string
shippingDate	shippingDate	date-time
taxType	taxType	string
totalGrossAmount	totalGrossAmount	number
totalTaxAmount	totalTaxAmount	number
type	type	string
updatedDate	updatedDate	date-time
useCollectiveContact	useCollectiveContact	boolean
version	version	integer
voucherDate	voucherDate	date-time
voucherItems	voucherItems	array of object
분량	voucherItems.amount	number
categoryId	voucherItems.categoryId	uuid
taxAmount	voucherItems.taxAmount	number
taxRatePercent	voucherItems.taxRatePercent	number
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

바우처 만들기

작업 ID:: CreateVoucher

바우처 만들기(판매 바우처로 제한)

매개 변수

Name	키	필수	형식
contactId	contactId		string
기한날짜	dueDate		date
말	remark		string
shippingDate	shippingDate		date
taxType	taxType	True	string
totalGrossAmount	totalGrossAmount		float
totalTaxAmount	totalTaxAmount		float
type	type	True	string
useCollectiveContact	useCollectiveContact		boolean
voucherDate	voucherDate		date
분량	amount		float
categoryId	categoryId		string
taxAmount	taxAmount		float
taxRatePercent	taxRatePercent		integer
voucherNumber	voucherNumber		string
voucherStatus	voucherStatus		string

반환

몸: Response_vouchers_post

바우처 목록 검색 및 필터링

작업 ID:: RetrieveAndFilterVoucherlist

바우처 목록(부기) 바우처(예: salesinvoices, salescreditnotes), 청구서(계약금 청구서 포함), 신용 메모, 주문 확인, 따옴표 및 배달 메모를 가져옵니다.

매개 변수

Name	키	필수	형식	Description
바우처 유형	voucherType	True	string	바우처 유형을 지정합니다.
바우처 상태	voucherStatus	True	string	바우처 상태를 지정합니다.
Archived	archived		boolean	보관된 파일을 지정합니다.
연락처 ID	contactId		string	연락처 ID를 지정합니다.
바우처 날짜	voucherDateFrom		string	바우처 날짜를 지정합니다.
바우처 날짜	voucherDateTo		string	바우처 날짜를 지정합니다.
만든 날짜	createdDateFrom		string	만든 날짜를 지정합니다.
만든 날짜	createdDateTo		string	만든 날짜를 지정합니다.
업데이트된 날짜	updatedDateFrom		string	업데이트된 날짜를 지정합니다.
업데이트된 날짜	updatedDateTo		string	업데이트된 날짜를 지정합니다.
바우처 번호	voucherNumber		string	바우처 번호를 지정합니다.
페이지	page		integer	페이지를 지정합니다.
Size	size		integer	크기를 지정합니다.
정렬	sort		string	정렬을 지정합니다.

반환

몸: Response_voucherlist_get

바우처 업데이트

작업 ID:: UpdateVoucher

바우처 업데이트

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.
contactId	contactId		string
기한날짜	dueDate		date
files	files		array of string	fileId 생략 목록
말	remark		string
shippingDate	shippingDate		date
taxType	taxType	True	string
totalGrossAmount	totalGrossAmount		float
totalTaxAmount	totalTaxAmount		float
type	type	True	string
useCollectiveContact	useCollectiveContact		boolean
version	version		integer
voucherDate	voucherDate		date
분량	amount		float
categoryId	categoryId		string
taxAmount	taxAmount		float
taxRatePercent	taxRatePercent		integer
voucherNumber	voucherNumber		string
voucherStatus	voucherStatus		string

반환

몸: Response_vouchers_id_put

바우처에 파일 업로드

작업 ID:: UploadFileVoucher_Lexoffice

{id}로 식별된 바우처에 파일(pdf 또는 이미지)을 업로드하고 할당합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.
File	file	True	file	업로드할 파일입니다.

배달 메모 검색

작업 ID:: RetrieveDeliveryNote

ID 값 {id}을(를) 사용하여 배달 메모를 반환합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
city	address.city	string
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
보충	address.supplement	string
zip	address.zip	string
보관	archived	boolean
생성일	createdDate	date-time
deliveryTerms	deliveryTerms	string
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
이름	lineItems.name	string
수량	lineItems.quantity	number
type	lineItems.type	string
unitName	lineItems.unitName	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	number
netAmount	lineItems.unitPrice.netAmount	number
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
말	remark	string
taxType	taxConditions.taxType	string
title	title	string
updatedDate	updatedDate	date-time
version	version	integer
voucherDate	voucherDate	date-time
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

배달 메모 만들기

작업 ID:: CreateDeliveryNote

만든 배달 메모는 어휘의 기본 바우처 목록에 표시됩니다. API를 통해 전송되는 배달 노트는 초안 모드에서만 생성됩니다.

매개 변수

Name	키	필수	형식	Description
이전 판매 바우처 ID	precedingSalesVoucherId		string	이전 판매 바우처 ID를 지정합니다.

반환

몸: Response_delivery-notes_post

배달 메모 문서 렌더링(PDF)

작업 ID:: RenderDeliveryNoteDocument

이 엔드포인트는 배달 노트에 대한 읽기 및 쓰기 액세스 권한을 제공하며 문서를 다운로드하기 위해 PDF로 렌더링할 수도 있습니다. 배달 노트는 항상 초안 모드에서 생성되며 완료할 필요가 없습니다.

매개 변수

Name	키	필수	형식	Description
배달 메모	DeliveryNoteid	True	string	배달 noteid를 지정합니다.

반환

Name	경로	형식
city	address.city	string
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
보충	address.supplement	string
zip	address.zip	string
보관	archived	boolean
생성일	createdDate	date-time
deliveryTerms	deliveryTerms	string
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
이름	lineItems.name	string
수량	lineItems.quantity	number
type	lineItems.type	string
unitName	lineItems.unitName	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	float
netAmount	lineItems.unitPrice.netAmount	float
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
말	remark	string
taxType	taxConditions.taxType	string
title	title	string
updatedDate	updatedDate	date-time
version	version	integer
voucherDate	voucherDate	date-time
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

신용 메모 검색

작업 ID:: RetrieveCreditNote

이 엔드포인트는 신용 메모에 대한 읽기 및 쓰기 액세스 권한을 제공하며 문서를 다운로드하기 위해 PDF로 렌더링할 수도 있습니다. 크레딧 노트는 초안으로 만들거나 오픈 모드에서 완료할 수 있습니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
city	address.city	string
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
보충	address.supplement	string
zip	address.zip	string
보관	archived	boolean
생성일	createdDate	date-time
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
lineItemAmount	lineItems.lineItemAmount	number
이름	lineItems.name	string
수량	lineItems.quantity	number
type	lineItems.type	string
unitName	lineItems.unitName	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	float
netAmount	lineItems.unitPrice.netAmount	float
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
말	remark	string
taxAmounts	taxAmounts	array of object
netAmount	taxAmounts.netAmount	number
taxAmount	taxAmounts.taxAmount	number
taxRatePercentage	taxAmounts.taxRatePercentage	number
taxType	taxConditions.taxType	string
title	title	string
currency	totalPrice.currency	string
totalGrossAmount	totalPrice.totalGrossAmount	float
totalNetAmount	totalPrice.totalNetAmount	float
totalTaxAmount	totalPrice.totalTaxAmount	float
updatedDate	updatedDate	date-time
version	version	integer
voucherDate	voucherDate	date-time
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

아티클 검색

작업 ID:: RetrieveAnArticle

ID 값 {id}을(를) 사용하여 아티클을 반환합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
articleNumber	articleNumber	string
gtin	gtin	string
아이디	id	string
메모	note	string
grossPrice	price.grossPrice	float
leadingPrice	price.leadingPrice	string
netPrice	price.netPrice	float
taxRate	price.taxRate	float
title	title	string
type	type	string
unitName	unitName	string
version	version	integer

아티클 만들기

작업 ID:: CreateArticle

문서의 내용은 요청 본문에 애플리케이션/json으로 필요합니다.

매개 변수

Name	키	형식	Description
articleNumber	articleNumber	string	articleNumber
grossPrice	grossPrice	float	grossPrice
leadingPrice	leadingPrice	string	leadingPrice
netPrice	netPrice	float	netPrice
taxRate	taxRate	float	taxRate
title	title	string	title
type	type	string	type
unitName	unitName	string	unitName

반환

몸: Response_articles_post

아티클 삭제

작업 ID:: DeleteAnArticle

ID 값 {id}을(를) 사용하여 아티클을 삭제합니다. 성공하면 204를 반환하고 ID가 없으면 404를 반환합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

연락처 검색

작업 ID:: RetrieveContact

ID로 연락처 검색

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
보관	archived	boolean
아이디	id	string
조직 ID	organizationId	string
이름 (첫 번째 이름)	person.firstName	string
lastName	person.lastName	string
인사말	person.salutation	string
숫자	roles.customer.number	integer
version	version	integer

연락처 만들기

작업 ID:: CreateContact

새 연락처 만들기

반환

몸: Response_contacts_post

연락처 업데이트

작업 ID:: UpdateContact

연락처 업데이트

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

몸: Response_contacts_id_put

이벤트 구독 검색

작업 ID:: RetrieveAEventSubscription

이벤트 구독 검색

매개 변수

Name	키	필수	형식	Description
구독 ID	subscriptionId	True	string	구독 ID를 지정합니다.

반환

몸: EventSubscriptionResponse

인용 문서 렌더링(PDF)

작업 ID:: RenderQuotationDocument

인용 문서의 pdf 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 따옴표 리소스에서 반환됩니다. 그러나 API를 통해 열려 있는 상태에서 새로 만든 따옴표는 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식	Description
documentFileId	documentFileId	uuid

주문 확인 검색

작업 ID:: RetrieveOrderConfirmation

ID 값 {id}을(를) 사용하여 주문 확인을 반환합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
city	address.city	string
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
보충	address.supplement	string
zip	address.zip	string
보관	archived	boolean
생성일	createdDate	date-time
deliveryTerms	deliveryTerms	string
documentFileId	files.documentFileId	uuid
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
discountPercentage	lineItems.discountPercentage	number
아이디	lineItems.id	uuid
lineItemAmount	lineItems.lineItemAmount	number
이름	lineItems.name	string
수량	lineItems.quantity	number
type	lineItems.type	string
unitName	lineItems.unitName	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	number
netAmount	lineItems.unitPrice.netAmount	number
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
discountPercentage	paymentConditions.paymentDiscountConditions.discountPercentage	number
discountRange	paymentConditions.paymentDiscountConditions.discountRange	integer
paymentTermDuration	paymentConditions.paymentTermDuration	integer
paymentTermLabel	paymentConditions.paymentTermLabel	string
paymentTermLabelTemplate	paymentConditions.paymentTermLabelTemplate	string
말	remark	string
shippingDate	shippingConditions.shippingDate	date-time
shippingType	shippingConditions.shippingType	string
taxAmounts	taxAmounts	array of object
netAmount	taxAmounts.netAmount	number
taxAmount	taxAmounts.taxAmount	number
taxRatePercentage	taxAmounts.taxRatePercentage	number
taxType	taxConditions.taxType	string
title	title	string
currency	totalPrice.currency	string
totalGrossAmount	totalPrice.totalGrossAmount	number
totalNetAmount	totalPrice.totalNetAmount	number
totalTaxAmount	totalPrice.totalTaxAmount	number
updatedDate	updatedDate	date-time
version	version	integer
voucherDate	voucherDate	date-time
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

주문 확인 만들기

작업 ID:: CreateOrderConfirmation

이 엔드포인트는 주문 확인에 대한 읽기 및 쓰기 액세스 권한과 문서를 다운로드하기 위해 PDF로 렌더링할 수도 있습니다. 주문 확인은 항상 초안 모드로 생성되며 완료할 필요가 없습니다.

매개 변수

Name	키	필수	형식	Description
이전 판매 바우처 ID	precedingSalesVoucherId		string	이전 판매 바우처 ID를 지정합니다.

반환

몸: Response_order-confirmations_post

주문 확인 문서 렌더링(PDF)

작업 ID:: RenderOrderConfirmationDocument

주문 확인 문서의 PDF 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 주문 확인 리소스에서 반환됩니다. 그러나 API를 통해 새로 만든 주문 확인은 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식	Description
documentFileId	documentFileId	uuid

청구서 검색

작업 ID:: RetrieveInvoice

ID 값 {id}이(가) 있는 청구서를 반환합니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식
city	address.city	string
countryCode	address.countryCode	string
이름	address.name	string
street	address.street	string
보충	address.supplement	string
zip	address.zip	string
보관	archived	boolean
생성일	createdDate	date-time
아이디	id	uuid
소개	introduction	string
language	language	string
lineItems	lineItems	array of object
discountPercentage	lineItems.discountPercentage	number
아이디	lineItems.id	uuid
lineItemAmount	lineItems.lineItemAmount	number
이름	lineItems.name	string
수량	lineItems.quantity	number
type	lineItems.type	string
unitName	lineItems.unitName	string
currency	lineItems.unitPrice.currency	string
grossAmount	lineItems.unitPrice.grossAmount	number
netAmount	lineItems.unitPrice.netAmount	number
taxRatePercentage	lineItems.unitPrice.taxRatePercentage	number
조직 ID	organizationId	uuid
discountPercentage	paymentConditions.paymentDiscountConditions.discountPercentage	number
discountRange	paymentConditions.paymentDiscountConditions.discountRange	integer
paymentTermDuration	paymentConditions.paymentTermDuration	integer
paymentTermLabel	paymentConditions.paymentTermLabel	string
paymentTermLabelTemplate	paymentConditions.paymentTermLabelTemplate	string
말	remark	string
shippingDate	shippingConditions.shippingDate	date-time
shippingType	shippingConditions.shippingType	string
taxAmounts	taxAmounts	array of object
netAmount	taxAmounts.netAmount	number
taxAmount	taxAmounts.taxAmount	number
taxRatePercentage	taxAmounts.taxRatePercentage	number
taxType	taxConditions.taxType	string
title	title	string
currency	totalPrice.currency	string
totalGrossAmount	totalPrice.totalGrossAmount	number
totalNetAmount	totalPrice.totalNetAmount	number
totalTaxAmount	totalPrice.totalTaxAmount	number
updatedDate	updatedDate	date-time
version	version	integer
voucherDate	voucherDate	date-time
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

청구서 만들기

작업 ID:: CreateInvoice

API를 통해 전송되는 송장은 기본값에 따라 초안 모드로 생성됩니다. 상태가 열려 있는 최종 송장을 만들려면 선택적 쿼리 매개 변수 종료를 설정해야 합니다. API를 통해 청구서 상태를 변경할 수 없습니다.

매개 변수

Name	키	필수	형식	Description
이전 판매 바우처 ID	precedingSalesVoucherId		string	이전 판매 바우처 ID를 지정합니다.
마무리	finalize	True	boolean	종료를 지정합니다.

반환

몸: Response_invoices_post

청구서 문서 렌더링(PDF)

작업 ID:: RenderInvoiceDocument

청구서 문서의 pdf 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 청구서 리소스에서 반환됩니다. 그러나 API를 통해 열려 있는 상태에서 새로 만든 청구서는 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식	Description
documentFileId	documentFileId	uuid

크레딧 메모 만들기

작업 ID:: CreateCreditNote

API를 통해 전송되는 신용 정보는 기본값에 따라 초안 모드로 생성됩니다. 상태가 열려 있는 완료된 크레딧 메모를 만들려면 선택적 쿼리 매개 변수 종료를 설정해야 합니다. API를 통해 신용 메모의 상태를 변경할 수 없습니다.

매개 변수

Name	키	필수	형식	Description
이전 판매 바우처 ID	precedingSalesVoucherId		string	이전 판매 바우처 ID를 지정합니다.
마무리	finalize	True	boolean	종료를 지정합니다.

반환

몸: Response_credit-notes_post

크레딧 메모 문서 렌더링(PDF)

작업 ID:: RenderCreditNoteDocument

신용 메모 문서의 pdf 파일을 다운로드하려면 documentFileId가 필요합니다. 이 ID는 일반적으로 신용 메모 리소스에서 반환됩니다. 그러나 API를 통해 열려 있는 상태에서 새로 만든 신용 메모는 pdf 문서 파일 렌더링을 별도로 트리거해야 합니다. 이 엔드포인트를 사용하여 이 작업을 수행할 수 있습니다.

매개 변수

Name	키	필수	형식	Description
아이디	id	True	string	ID를 지정합니다.

반환

Name	경로	형식	Description
documentFileId	documentFileId	uuid

파일 다운로드

작업 ID:: DownloadFile_Lexoffice

이 엔드포인트를 사용하여 파일을 다운로드합니다.

매개 변수

Name	키	필수	형식	Description
파일 ID	fileId	True	string	파일 ID를 지정합니다.
수락	Accept		string	수락을 지정합니다.

반환

response: file

파일 업로드

작업 ID:: UploadFile_Lexoffice

이 엔드포인트를 사용하여 파일(예: 바우처 또는 청구서)을 업로드합니다.

매개 변수

Name	키	필수	형식	Description
File	file	True	file	업로드할 파일입니다.
유형	type	True	string	파일 내용에 대한 설명입니다.

반환

몸: Response_files_post

프로필 정보 검색

작업 ID:: RetrieveProfileInformation

다음 샘플에서는 기본 프로필 정보를 검색하는 방법을 보여 줍니다. 요청을 보내기 전에 자리 표시자 {accessToken}을(를) 바꿔야 합니다.

반환

몸: Response_profile_get

트리거

사용자 지정 트리거 선택

연락처 엔드포인트에 대한 새 트리거 등록

사용자 지정 트리거 선택

작업 ID:: EventSubscription_Lexoffice

연락처 엔드포인트에 대한 새 트리거 등록

매개 변수

Name	키	필수	형식	Description
이벤트 유형	eventType	True	string	eventType

반환

Name	경로	형식	Description
eventDate	eventDate	string	eventDate
eventType	eventType	string	eventType
조직 ID	organizationId	string	조직 ID
resourceId	resourceId	string	resourceId

정의

EventSubscriptionResponse

Name	경로	형식
subscriptionId	subscriptionId	string
eventType	eventType	string
조직 ID	organizationId	string
생성일	createdDate	date-time
콜백 URL	callbackUrl	string

Response_articles_get

Name	경로	형식	Description
내용	content	array of object	내용
articleNumber	content.articleNumber	string	articleNumber
gtin	content.gtin	string	gtin
아이디	content.id	string	아이디
메모	content.note	string	메모
grossPrice	content.price.grossPrice	float	grossPrice
leadingPrice	content.price.leadingPrice	string	leadingPrice
netPrice	content.price.netPrice	float	netPrice
taxRate	content.price.taxRate	float	taxRate
title	content.title	string	title
type	content.type	string	type
unitName	content.unitName	string	unitName
version	content.version	integer	version
첫 번째	first	boolean	첫 번째
마지막	last	boolean	마지막
숫자	number	integer	숫자
numberOfElements	numberOfElements	integer	numberOfElements
size	size	integer	size
sort	sort	array of object	sort
오름차순	sort.ascending	boolean	오름차순
방향	sort.direction	string	방향
무시 케이스	sort.ignoreCase	boolean	무시 케이스
nullHandling	sort.nullHandling	string	nullHandling
property	sort.property	string	property
totalElements	totalElements	integer	totalElements
totalPages	totalPages	integer	totalPages

Response_articles_id_get

Name	경로	형식	Description
articleNumber	articleNumber	string	articleNumber
gtin	gtin	string	gtin
아이디	id	string	아이디
메모	note	string	메모
grossPrice	price.grossPrice	float	grossPrice
leadingPrice	price.leadingPrice	string	leadingPrice
netPrice	price.netPrice	float	netPrice
taxRate	price.taxRate	float	taxRate
title	title	string	title
type	type	string	type
unitName	unitName	string	unitName
version	version	integer	version

Response_articles_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_contacts_get

Name	경로	형식	Description
내용	content	array of object	내용
청구서 발행	content.addresses.billing	array of object	청구서 발행
city	content.addresses.billing.city	string	city
countryCode	content.addresses.billing.countryCode	string	countryCode
street	content.addresses.billing.street	string	street
보충	content.addresses.billing.supplement	string	보충
zip	content.addresses.billing.zip	string	zip
선박	content.addresses.shipping	array of object	선박
city	content.addresses.shipping.city	string	city
countryCode	content.addresses.shipping.countryCode	string	countryCode
street	content.addresses.shipping.street	string	street
보충	content.addresses.shipping.supplement	string	보충
zip	content.addresses.shipping.zip	string	zip
보관	content.archived	boolean	보관
allowTaxFreeInvoices	content.company.allowTaxFreeInvoices	boolean	allowTaxFreeInvoices
contactPersons	content.company.contactPersons	array of object	contactPersons
이메일 주소	content.company.contactPersons.emailAddress	string	이메일 주소
이름 (첫 번째 이름)	content.company.contactPersons.firstName	string	이름 (첫 번째 이름)
lastName	content.company.contactPersons.lastName	string	lastName
주된	content.company.contactPersons.primary	boolean	주된
인사말	content.company.contactPersons.salutation	string	인사말
이름	content.company.name	string	이름
세금 번호	content.company.taxNumber	string	세금 번호
vatRegistrationId	content.company.vatRegistrationId	string	vatRegistrationId
사업	content.emailAddresses.business	array of string	사업
사무실	content.emailAddresses.office	array of string	사무실
other	content.emailAddresses.other	array of string	other
아이디	content.id	string	아이디
메모	content.note	string	메모
조직 ID	content.organizationId	string	조직 ID
사업	content.phoneNumbers.business	array of string	사업
팩스	content.phoneNumbers.fax	array of string	팩스
사무실	content.phoneNumbers.office	array of string	사무실
other	content.phoneNumbers.other	array of string	other
숫자	content.roles.customer.number	integer	숫자
숫자	content.roles.vendor.number	integer	숫자
version	content.version	integer	version
첫 번째	first	boolean	첫 번째
마지막	last	boolean	마지막
숫자	number	integer	숫자
numberOfElements	numberOfElements	integer	numberOfElements
size	size	integer	size
sort	sort	array of object	sort
오름차순	sort.ascending	boolean	오름차순
방향	sort.direction	string	방향
무시 케이스	sort.ignoreCase	boolean	무시 케이스
nullHandling	sort.nullHandling	string	nullHandling
property	sort.property	string	property
totalElements	totalElements	integer	totalElements
totalPages	totalPages	integer	totalPages

Response_contacts_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_countries_get_default

Name	경로	형식	Description
countryCode	countryCode	string	countryCode
countryNameDE	countryNameDE	string	countryNameDE
countryNameEN	countryNameEN	string	countryNameEN
taxClassification	taxClassification	string	taxClassification

Response_credit-notes_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_delivery-notes_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_dunnings_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_event-subscriptions_get

Name	경로	형식	Description
내용	content	array of object	내용
콜백 URL	content.callbackUrl	string	콜백 URL
생성일	content.createdDate	string	생성일
eventType	content.eventType	string	eventType
조직 ID	content.organizationId	string	조직 ID
subscriptionId	content.subscriptionId	string	subscriptionId

Response_files_post

Name	경로	형식	Description
아이디	id	string	아이디

Response_invoices_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_order-confirmations_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_payment-conditions_get_items

Name	경로	형식	Description
아이디	id	string	아이디
organizationDefault	organizationDefault	boolean	organizationDefault
discountPercentage	paymentDiscountConditions.discountPercentage	integer	discountPercentage
discountRange	paymentDiscountConditions.discountRange	integer	discountRange
paymentTermDuration	paymentTermDuration	integer	paymentTermDuration
paymentTermLabelTemplate	paymentTermLabelTemplate	string	paymentTermLabelTemplate

Response_posting-categories_get_items

Name	경로	형식	Description
contactRequired	contactRequired	boolean	contactRequired
groupName	groupName	string	groupName
아이디	id	string	아이디
이름	name	string	이름
splitAllowed	splitAllowed	boolean	splitAllowed
type	type	string	type

Response_profile_get

Name	경로	형식	Description
businessFeatures	businessFeatures	array of string	businessFeatures
companyName	companyName	string	companyName
connectionId	connectionId	string	connectionId
date	created.date	string	date
사용자 이메일	created.userEmail	string	사용자 이메일
userId	created.userId	string	userId
사용자 이름	created.userName	string	사용자 이름
features	features	array of string	features
조직 ID	organizationId	string	조직 ID
smallBusiness	smallBusiness	boolean	smallBusiness
subscriptionStatus (구독상태)	subscriptionStatus	string	subscriptionStatus (구독상태)
taxType	taxType	string	taxType

Response_quotations_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_recurring templates_get

Name	경로	형식	Description
내용	content	array of object	내용
contactId	content.address.contactId	string	contactId
이름	content.address.name	string	이름
생성일	content.createdDate	string	생성일
아이디	content.id	string	아이디
조직 ID	content.organizationId	string	조직 ID
discountPercentage	content.paymentConditions.paymentDiscountConditions.discountPercentage	integer	discountPercentage
discountRange	content.paymentConditions.paymentDiscountConditions.discountRange	integer	discountRange
paymentTermDuration	content.paymentConditions.paymentTermDuration	integer	paymentTermDuration
paymentTermLabel	content.paymentConditions.paymentTermLabel	string	paymentTermLabel
paymentTermLabelTemplate	content.paymentConditions.paymentTermLabelTemplate	string	paymentTermLabelTemplate
종료일	content.recurringTemplateSettings.endDate	string	종료일
executionInterval	content.recurringTemplateSettings.executionInterval	string	executionInterval
executionStatus	content.recurringTemplateSettings.executionStatus	string	executionStatus
마무리	content.recurringTemplateSettings.finalize	boolean	마무리
아이디	content.recurringTemplateSettings.id	string	아이디
lastExecutionFailed	content.recurringTemplateSettings.lastExecutionFailed	boolean	lastExecutionFailed
nextExecutionDate	content.recurringTemplateSettings.nextExecutionDate	string	nextExecutionDate
shippingType	content.recurringTemplateSettings.shippingType	string	shippingType
startDate	content.recurringTemplateSettings.startDate	string	startDate
title	content.title	string	title
currency	content.totalPrice.currency	string	currency
totalGrossAmount	content.totalPrice.totalGrossAmount	integer	totalGrossAmount
totalNetAmount	content.totalPrice.totalNetAmount	float	totalNetAmount
updatedDate	content.updatedDate	string	updatedDate
첫 번째	first	boolean	첫 번째
마지막	last	boolean	마지막
숫자	number	integer	숫자
numberOfElements	numberOfElements	integer	numberOfElements
size	size	integer	size
sort	sort	array of object	sort
오름차순	sort.ascending	boolean	오름차순
방향	sort.direction	string	방향
무시 케이스	sort.ignoreCase	boolean	무시 케이스
nullHandling	sort.nullHandling	string	nullHandling
property	sort.property	string	property
totalElements	totalElements	integer	totalElements
totalPages	totalPages	integer	totalPages

Response_voucherlist_get

Name	경로	형식	Description
내용	content	array of object	내용
보관	content.archived	boolean	보관
contactId	content.contactId	string	contactId
연락처 이름	content.contactName	string	연락처 이름
생성일	content.createdDate	string	생성일
currency	content.currency	string	currency
기한날짜	content.dueDate	string	기한날짜
아이디	content.id	string	아이디
openAmount	content.openAmount	float	openAmount
총액	content.totalAmount	float	총액
updatedDate	content.updatedDate	string	updatedDate
voucherDate	content.voucherDate	string	voucherDate
voucherNumber	content.voucherNumber	string	voucherNumber
voucherStatus	content.voucherStatus	string	voucherStatus
voucherType	content.voucherType	string	voucherType
첫 번째	first	boolean	첫 번째
마지막	last	boolean	마지막
숫자	number	integer	숫자
numberOfElements	numberOfElements	integer	numberOfElements
size	size	integer	size
sort	sort	array of object	sort
오름차순	sort.ascending	boolean	오름차순
방향	sort.direction	string	방향
무시 케이스	sort.ignoreCase	boolean	무시 케이스
nullHandling	sort.nullHandling	string	nullHandling
property	sort.property	string	property
totalElements	totalElements	integer	totalElements
totalPages	totalPages	integer	totalPages

Response_vouchers_post

Name	경로	형식	Description
생성일	createdDate	string	생성일
아이디	id	string	아이디
resourceUri	resourceUri	string	resourceUri
updatedDate	updatedDate	string	updatedDate
version	version	integer	version

Response_contacts_id_put

Name	경로	형식
보관	archived	boolean
아이디	id	uuid
조직 ID	organizationId	uuid
이름 (첫 번째 이름)	person.firstName	string
lastName	person.lastName	string
인사말	person.salutation	string
숫자	roles.customer.number	integer
version	version	integer

Response_vouchers_id_put

Name	경로	형식
생성일	createdDate	date-time
기한날짜	dueDate	date-time
files	files	array of object
items	files	object
아이디	id	uuid
조직 ID	organizationId	uuid
말	remark	string
shippingDate	shippingDate	date-time
taxType	taxType	string
totalGrossAmount	totalGrossAmount	number
totalTaxAmount	totalTaxAmount	number
type	type	string
updatedDate	updatedDate	date-time
useCollectiveContact	useCollectiveContact	boolean
version	version	integer
voucherDate	voucherDate	date-time
voucherItems	voucherItems	array of object
분량	voucherItems.amount	number
categoryId	voucherItems.categoryId	uuid
taxAmount	voucherItems.taxAmount	number
taxRatePercent	voucherItems.taxRatePercent	number
voucherNumber	voucherNumber	string
voucherStatus	voucherStatus	string

file

기본 데이터 형식 'file'입니다.

다음을 통해 공유

Lexoffice(독립 게시자)(미리 보기)

Lexware API 커넥터(독립 게시자)

게시자: 독립 게시자

필수 조건

지원되는 작업

자격 증명 가져오기

API 게이트웨이

속도 제한

Authentication

사용 예시

알려진 문제 및 제한 사항

API 문서

연결을 만드는 중

기본값

제한 한도

동작

Event-Subscription 삭제

매개 변수

게시 범주 목록 검색

반환

결제 정보 검색

매개 변수

반환

결제 조건 목록 검색

반환

계약금 청구서 검색

매개 변수

반환

국가 목록 검색

반환

더닝 검색

매개 변수

반환

더닝 만들기

매개 변수

반환

더닝 문서 렌더링(PDF)

매개 변수

반환

되풀이 템플릿 검색

매개 변수

반환

따옴표 검색

매개 변수

반환

따옴표 만들기

매개 변수

반환

모든 되풀이 템플릿 검색

매개 변수

반환

모든 연락처 검색

매개 변수

반환

모든 이벤트 구독 검색

반환

문서 업데이트

매개 변수

반환

문서 필터링

매개 변수

반환

바우처 검색

매개 변수

반환

바우처 만들기

매개 변수

반환

바우처 목록 검색 및 필터링

매개 변수

반환

바우처 업데이트

매개 변수

반환

바우처에 파일 업로드

매개 변수

배달 메모 검색

매개 변수

반환