다음을 통해 공유


Impower ERP(미리 보기)

속성 관리자에 대한 impower.de 회계 시스템과의 상호 작용 허용

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

서비스 클래스 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)
연락처
이름 API 지원
URL https://impower.de
전자 메일 support+api@impower.de
커넥터 메타데이터
게시자 Impower GmbH
웹 사이트 https://www.impower.de
개인 정보 보호 정책 https://www.impower.de/datenschutzerklaerung
카테고리 비즈니스 관리; 금융

Impower 커넥터를 사용하면 속성, 단위, 계약 및 연락처와 같은 masterdataset에 액세스할 수 있습니다. 또한 문서 및 청구서를 업로드할 수 있습니다. 예약된 방식으로 또는 통합 트리거를 사용하여 웹후크를 등록하여 데이터를 읽을 수 있습니다.

필수 조건

Impower를 사용하려면 다음이 필요합니다.

  1. 유료 Impower 구독
  2. Powerautomate Premium 구독

자격 증명을 가져오는 방법

powerautomate를 연결할 도메인의 APIKey를 얻으려면 .에서 support@impower.de요청을 작성하세요.

커넥터 시작

빌드를 고려할 수 있는 시나리오:

  1. Sharepoint/Onedrive 폴더에서 변경 내용을 확인하고 새 PDF 파일이 표시되는 경우 변경 내용을 임파서에 업로드합니다.
  2. 팀 주소록과 연락처 목록 동기화

알려진 문제 및 제한 사항

파일 다운로드/업로드

파일은 이진 형식의 다중 파트 양식 데이터로 업로드됩니다. http 표준과 마찬가지로 헤더에 제안된 파일 이름과 함께 파일이 제공됩니다.

Ratelimiting

분당 5,000개 이상의 요청을 수행하지 않는 것을 목표로 합니다. 시스템이 사용자에게 신속하게 서비스를 제공할 수 있도록 API에 Ratelimiting을 적용합니다.

연결을 만드는 중

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

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

기본값

적용 가능: 모든 지역

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

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

이름 유형 Description 필수
API-Key 시큐어스트링 (보안 문자열) 이 API에 대한 API-Key 진실

제한 한도

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

동작

(레거시) 청구서 업로드

레거시 API를 사용하여 Impower에 pdf 파일을 업로드합니다. 대신 uploadInvoiceUsingPOST 작업을 사용합니다.

레거시 청구서 세부 정보

레거시 API를 통해 Impower에서 청구서 세부 정보를 가져옵니다. 대신 getInvoiceByIdUsingGET를 사용합니다.

문서 태그 가져오기

표준 및 도메인 관련 문서 태그가 응답으로 반환됩니다.

미리 정의된 모든 오류 코드 값 가져오기

미리 정의된 모든 오류 코드 목록을 반환합니다.

새 문서 태그 만들기

새로 만든 문서 태그가 응답으로 반환됩니다.

연결 삭제

연결 삭제

연결 업데이트

연결 업데이트

연결 읽기

연결 읽기

제공된 필드에 따라 청구서 업데이트

청구서 업데이트

지정된 ID로 계약 가져오기

지정된 ID로 계약을 검색합니다.

지정된 ID로 단위 가져오기

지정된 ID가 있는 단위를 반환합니다.

지정된 ID로 단일 문서 다운로드

문서의 형식은 mimetype으로 정의됩니다.

지정된 ID로 속성 가져오기

지정된 ID로 속성을 검색합니다.

지정된 ID로 연락처 가져오기

지정된 ID로 연락처를 검색합니다.

지정된 ID로 청구서 가져오기

지정된 ID로 청구서를 검색합니다.

지정된 ID에 따라 기존 문서 삭제

시스템 생성 문서를 삭제할 수 없습니다.

지정된 ID에 따라 기존 문서 태그 삭제

시스템 생성 태그를 삭제할 수 없음

지정된 ID에 따라 기존 문서 태그 업데이트

업데이트된 문서 태그가 응답으로 반환됩니다.

지정된 요청 본문에 따라 기존 문서 업데이트

모든 필요한 정보는 요청 본문에 있습니다.

지정된 청구서 예약 항목의 예약 텍스트 업데이트

예약 텍스트 업데이트

지정된 파일에 따라 새 문서 만들기

새로 만든 문서가 응답으로 반환됩니다.

지정된 필터 매개 변수로 계약 가져오기

지정된 필터 매개 변수로 계약 검색

지정된 필터 매개 변수로 문서 가져오기

지정된 필터 매개 변수로 문서 검색

지정된 필터 매개 변수로 속성 가져오기

지정된 필터 매개 변수로 속성 검색

지정된 필터 매개 변수로 연락처 가져오기

지정된 필터 매개 변수로 연락처 검색

지정된 필터 매개 변수로 청구서 가져오기

지정된 필터 매개 변수로 청구서를 검색합니다.

지정된 필터 매개 변수를 사용하여 모든 단위 가져오기

지정된 필터 조건을 준수하는 모든 단위를 반환합니다.

지정된 필터 조건으로 여러 문서 다운로드

문서가 zip 형식으로 제공됩니다.

청구서 PDF 문서 업로드

기본적으로 문서는 OCR 분석을 통해 진행됩니다.

특정 오류 코드의 세부 정보 가져오기

특정 오류 코드에 대한 설명을 검색합니다.

(레거시) 청구서 업로드

레거시 API를 사용하여 Impower에 pdf 파일을 업로드합니다. 대신 uploadInvoiceUsingPOST 작업을 사용합니다.

매개 변수

Name 필수 형식 Description
업로드할 pdf 파일 지정
file True file

업로드할 pdf 파일 지정

반환

LegacyInvoiceDto
LegacyInvoiceDto

레거시 청구서 세부 정보

레거시 API를 통해 Impower에서 청구서 세부 정보를 가져옵니다. 대신 getInvoiceByIdUsingGET를 사용합니다.

매개 변수

Name 필수 형식 Description
송장 ID
invoiceId True integer

자세한 내용은 청구서 ID 지정

반환

LegacyInvoiceDto
LegacyInvoiceDto

문서 태그 가져오기

표준 및 도메인 관련 문서 태그가 응답으로 반환됩니다.

매개 변수

Name 필수 형식 Description
이름 및 설명에 적용된 검색 문자열
description string

이름 및 설명에 적용된 검색 문자열

반환

미리 정의된 모든 오류 코드 값 가져오기

미리 정의된 모든 오류 코드 목록을 반환합니다.

반환

Name 경로 형식 Description
array of string

새 문서 태그 만들기

새로 만든 문서 태그가 응답으로 반환됩니다.

매개 변수

Name 필수 형식 Description
새로 만든 문서 태그에 대한 설명입니다.
description string

새로 만든 문서 태그에 대한 설명입니다.

새로 만든 문서 태그의 이름입니다.
name string

새로 만든 문서 태그의 이름입니다.

반환

문서 태그의 모델 클래스입니다.

DocumentTagDto
DocumentTagDto

연결 삭제

연결 삭제

매개 변수

Name 필수 형식 Description
연결 ID
connectionIdX True integer

연결 ID

연결 업데이트

연결 업데이트

매개 변수

Name 필수 형식 Description
연결 ID
connectionIdX True integer

연결 ID

연결 이름은 UI에 표시되어야 합니다. 지정하지 않으면 애플리케이션의 이름으로 기본 설정됩니다.
name string

연결 이름은 UI에 표시되어야 합니다. 지정하지 않으면 애플리케이션의 이름으로 기본 설정됩니다.

URL은 유효성을 검사할 수 있는 권한 부여 토큰과 {"connectionId":123,"entityType":"properties","entityId":123,"eventType": "UPDATE"} 본문을 사용하여 호출됩니다.
webhookUrl string

URL은 유효성을 검사할 수 있는 권한 부여 토큰과 {"connectionId":123,"entityType":"properties","entityId":123,"eventType": "UPDATE"} 본문을 사용하여 호출됩니다.

반환

기존 연결을 설명하는 데이터

ConnectionDto
ConnectionDto

연결 읽기

연결 읽기

매개 변수

Name 필수 형식 Description
연결의 ID입니다.
connectionIdX True integer

연결의 ID입니다.

반환

기존 연결을 설명하는 데이터

ConnectionDto
ConnectionDto

제공된 필드에 따라 청구서 업데이트

청구서 업데이트

매개 변수

Name 필수 형식 Description
청구서의 고유 ID
invoiceId True integer

청구서의 고유 ID

청구서의 새 발급 날짜입니다.
issuedDate string

청구서의 새 발급 날짜입니다.

청구서의 새 이름입니다.
name string

청구서의 새 이름입니다.

반환

청구서 데이터 구조입니다.

InvoiceDto
InvoiceDto

지정된 ID로 계약 가져오기

지정된 ID로 계약을 검색합니다.

매개 변수

Name 필수 형식 Description
계약의 고유 식별자
contractId True integer

계약의 고유 식별자

반환

계약 데이터 구조입니다.

ContractDto
ContractDto

지정된 ID로 단위 가져오기

지정된 ID가 있는 단위를 반환합니다.

매개 변수

Name 필수 형식 Description
단위의 고유 ID
unitId True integer

단위의 고유 ID

반환

단위 데이터 구조입니다.

UnitDto
UnitDto

지정된 ID로 단일 문서 다운로드

문서의 형식은 mimetype으로 정의됩니다.

매개 변수

Name 필수 형식 Description
문서의 고유 식별자
documentId True integer

문서의 고유 식별자

반환

response
file

지정된 ID로 속성 가져오기

지정된 ID로 속성을 검색합니다.

매개 변수

Name 필수 형식 Description
속성의 고유 식별자
propertyId True integer

속성의 고유 식별자

반환

속성 데이터 구조입니다.

PropertyDto
PropertyDto

지정된 ID로 연락처 가져오기

지정된 ID로 연락처를 검색합니다.

매개 변수

Name 필수 형식 Description
연락처의 고유 식별자
contactId True integer

연락처의 고유 식별자

반환

연락처는 자연인 또는 법인을 나타내며 연락하는 방법을 나타냅니다. ID/회사에 연락할 수 있는 여러 우편 주소가 있어야 합니다. 이러한 연락처는 서로 다른 2개의 연락처로 표시됩니다.

ContactDto
ContactDto

지정된 ID로 청구서 가져오기

지정된 ID로 청구서를 검색합니다.

매개 변수

Name 필수 형식 Description
청구서의 고유 식별자
invoiceId True integer

청구서의 고유 식별자

반환

청구서 데이터 구조입니다.

InvoiceDto
InvoiceDto

지정된 ID에 따라 기존 문서 삭제

시스템 생성 문서를 삭제할 수 없습니다.

매개 변수

Name 필수 형식 Description
documentId
documentId True integer

documentId

지정된 ID에 따라 기존 문서 태그 삭제

시스템 생성 태그를 삭제할 수 없음

매개 변수

Name 필수 형식 Description
삭제할 문서 태그의 고유 식별자
tagId True integer

삭제할 문서 태그의 고유 식별자

지정된 ID에 따라 기존 문서 태그 업데이트

업데이트된 문서 태그가 응답으로 반환됩니다.

매개 변수

Name 필수 형식 Description
문서 태그의 고유 식별자
tagId True integer

문서 태그의 고유 식별자

문서 태그에 대한 새 설명입니다.
description string

문서 태그에 대한 새 설명입니다.

문서 태그의 새 이름입니다.
name string

문서 태그의 새 이름입니다.

반환

문서 태그의 모델 클래스입니다.

DocumentTagDto
DocumentTagDto

지정된 요청 본문에 따라 기존 문서 업데이트

모든 필요한 정보는 요청 본문에 있습니다.

매개 변수

Name 필수 형식 Description
업데이트할 문서 금액의 새 값
amount float

업데이트할 문서 금액의 새 값

할당할 문서를 새로 빌드합니다.
buildingId integer

할당할 문서를 새로 빌드합니다.

할당할 문서에 새 연락처
contactId integer

할당할 문서에 새 연락처

문서를 할당할 새 계약
contractId integer

문서를 할당할 새 계약

업데이트할 문서의 고유 식별자입니다.
id True integer

업데이트할 문서의 고유 식별자입니다.

문서를 업데이트할 새 날짜
issuedDate string

문서를 업데이트할 새 날짜

업데이트할 문서 이름의 새 값
name string

업데이트할 문서 이름의 새 값

문서를 할당할 새 속성
propertyId integer

문서를 할당할 새 속성

할당할 문서의 새 원본 프로세스 ID
sourceId integer

할당할 문서의 새 원본 프로세스 ID

문서에 할당할 태그의 식별자
tagIds array of integer

문서에 할당할 태그의 식별자

할당할 문서 새 단원
unitId integer

할당할 문서 새 단원

반환

지정된 청구서 예약 항목의 예약 텍스트 업데이트

예약 텍스트 업데이트

매개 변수

Name 필수 형식 Description
청구서 예약 항목의 고유 ID
invoiceItemId True integer

청구서 예약 항목의 고유 ID

청구서 항목의 예약 텍스트입니다.
bookingText string

청구서 항목의 예약 텍스트입니다.

반환

InvoiceItemDto
InvoiceItemDto

지정된 파일에 따라 새 문서 만들기

새로 만든 문서가 응답으로 반환됩니다.

매개 변수

Name 필수 형식 Description
업로드할 PDF 파일
file True file

업로드할 PDF 파일

반환

문서 데이터 구조입니다.

DocumentDto
DocumentDto

지정된 필터 매개 변수로 계약 가져오기

지정된 필터 매개 변수로 계약 검색

매개 변수

Name 필수 형식 Description
계약이 연결된 연락처 인스턴스의 ID입니다.
contactId integer

계약이 연결된 연락처 인스턴스의 ID입니다.

계약을 필터링할 계약 ID 목록입니다.
contractIds array

계약을 필터링할 계약 ID 목록입니다.

정렬 방향입니다. 가능한 값: ASC, DESC
order string

정렬 방향입니다. 가능한 값: ASC, DESC

반환할 페이지 번호
page integer

반환할 페이지 번호

계약이 속한 속성 인스턴스의 ID입니다.
propertyId integer

계약이 속한 속성 인스턴스의 ID입니다.

단일 페이지에서 반환할 항목 수
size integer

단일 페이지에서 반환할 항목 수

정렬 매개 변수
sort string

정렬 매개 변수

계약의 형식입니다. 옵션: OWNER | TENANT | PROPERTY_OWNER
type array

계약의 형식입니다. 옵션: OWNER | TENANT | PROPERTY_OWNER

계약이 연결된 단위 인스턴스의 ID입니다.
unitId integer

계약이 연결된 단위 인스턴스의 ID입니다.

날짜에 유효한 계약을 반환합니다. Null은 시작/종료 시간으로 해석됩니다.
validAtDate string

날짜에 유효한 계약을 반환합니다. Null은 시작/종료 시간으로 해석됩니다.

반환

PageOfContractDto
PageOfContractDto

지정된 필터 매개 변수로 문서 가져오기

지정된 필터 매개 변수로 문서 검색

매개 변수

Name 필수 형식 Description
속성의 회계사 이름입니다.
accountant string

속성의 회계사 이름입니다.

속성의 관리자 이름입니다.
administrator string

속성의 관리자 이름입니다.

문서가 속한 연락처 엔터티의 ID입니다.
contactId integer

문서가 속한 연락처 엔터티의 ID입니다.

비슷한 이름의 계약에 연결된 문서입니다.
contractName string

비슷한 이름의 계약에 연결된 문서입니다.

반환할 문서의 ID입니다.
documentIds array

반환할 문서의 ID입니다.

반환할 문서의 이름입니다.
documentName string

반환할 문서의 이름입니다.

문서의 발급 날짜입니다.
issuedDate string

문서의 발급 날짜입니다.

이전에 발급된 날짜가 있는 문서입니다.
maxIssuedDate string

이전에 발급된 날짜가 있는 문서입니다.

발행 날짜가 지난 문서입니다.
minIssuedDate string

발행 날짜가 지난 문서입니다.

정렬 방향입니다. 가능한 값: ASC, DESC
order string

정렬 방향입니다. 가능한 값: ASC, DESC

반환할 페이지 번호
page integer

반환할 페이지 번호

문서가 속한 속성의 사람이 읽을 수 있는 ID입니다.
propertyHrId string

문서가 속한 속성의 사람이 읽을 수 있는 ID입니다.

문서가 속한 속성의 ID입니다.
propertyId integer

문서가 속한 속성의 ID입니다.

문서가 속한 속성의 이름입니다.
propertyName string

문서가 속한 속성의 이름입니다.

단일 페이지에서 반환할 항목 수
size integer

단일 페이지에서 반환할 항목 수

정렬 매개 변수
sort string

정렬 매개 변수

문서가 속한 원본 엔터티의 ID입니다.
sourceId integer

문서가 속한 원본 엔터티의 ID입니다.

문서의 원본 형식입니다.
sourceType array

문서의 원본 형식입니다.

문서가 연결된 태그의 ID입니다.
tagIds array

문서가 연결된 태그의 ID입니다.

문서가 연결되는 태그의 이름과 비슷합니다.
tagName string

문서가 연결되는 태그의 이름과 비슷합니다.

문서가 속한 단위 엔터티의 ID입니다.
unitId integer

문서가 속한 단위 엔터티의 ID입니다.

반환

PageOfDocumentDto
PageOfDocumentDto

지정된 필터 매개 변수로 속성 가져오기

지정된 필터 매개 변수로 속성 검색

매개 변수

Name 필수 형식 Description
속성의 이름입니다.
name string

속성의 이름입니다.

정렬 방향입니다. 가능한 값: ASC, DESC
order string

정렬 방향입니다. 가능한 값: ASC, DESC

반환할 페이지 번호
page integer

반환할 페이지 번호

속성의 사람이 읽을 수 있는 ID입니다.
propertyHrId string

속성의 사람이 읽을 수 있는 ID입니다.

단일 페이지에서 반환할 항목 수
size integer

단일 페이지에서 반환할 항목 수

정렬 매개 변수
sort string

정렬 매개 변수

반환

PageOfPropertyDto
PageOfPropertyDto

지정된 필터 매개 변수로 연락처 가져오기

지정된 필터 매개 변수로 연락처 검색

매개 변수

Name 필수 형식 Description
연락처를 필터링할 연락처 ID 목록입니다.
contactIds array

연락처를 필터링할 연락처 ID 목록입니다.

연락처의 전자 메일 주소입니다.
email string

연락처의 전자 메일 주소입니다.

연락처의 모든 이름입니다. 이름, 성 또는 회사 이름일 수 있습니다.
name string

연락처의 모든 이름입니다. 이름, 성 또는 회사 이름일 수 있습니다.

정렬 방향입니다. 가능한 값: ASC, DESC
order string

정렬 방향입니다. 가능한 값: ASC, DESC

반환할 페이지 번호
page integer

반환할 페이지 번호

단일 페이지에서 반환할 항목 수
size integer

단일 페이지에서 반환할 항목 수

정렬 매개 변수
sort string

정렬 매개 변수

반환

PageOfContactDto
PageOfContactDto

지정된 필터 매개 변수로 청구서 가져오기

지정된 필터 매개 변수로 청구서를 검색합니다.

매개 변수

Name 필수 형식 Description
해당 연락처의 고유 식별자
counterpartContactId integer

해당 연락처의 고유 식별자

검색할 송장 날짜
issuedDate string

검색할 송장 날짜

정렬 방향입니다. 가능한 값: ASC, DESC
order string

정렬 방향입니다. 가능한 값: ASC, DESC

반환할 페이지 번호
page integer

반환할 페이지 번호

청구서가 속한 속성의 고유 식별자
propertyId integer

청구서가 속한 속성의 고유 식별자

단일 페이지에서 반환할 항목 수
size integer

단일 페이지에서 반환할 항목 수

정렬 매개 변수
sort string

정렬 매개 변수

검색할 청구서의 상태
states array

검색할 청구서의 상태

반환

PageOfInvoiceDto
PageOfInvoiceDto

지정된 필터 매개 변수를 사용하여 모든 단위 가져오기

지정된 필터 조건을 준수하는 모든 단위를 반환합니다.

매개 변수

Name 필수 형식 Description
정렬 방향입니다. 가능한 값: ASC, DESC
order string

정렬 방향입니다. 가능한 값: ASC, DESC

반환할 페이지 번호
page integer

반환할 페이지 번호

단위가 속한 속성의 고유 식별자
propertyId integer

단위가 속한 속성의 고유 식별자

단일 페이지에서 반환할 항목 수
size integer

단일 페이지에서 반환할 항목 수

정렬 매개 변수
sort string

정렬 매개 변수

반환

PageOfUnitDto
PageOfUnitDto

지정된 필터 조건으로 여러 문서 다운로드

문서가 zip 형식으로 제공됩니다.

매개 변수

Name 필수 형식 Description
속성의 회계사 이름입니다.
accountant string

속성의 회계사 이름입니다.

속성의 관리자 이름입니다.
administrator string

속성의 관리자 이름입니다.

문서가 속한 연락처 엔터티의 ID입니다.
contactId integer

문서가 속한 연락처 엔터티의 ID입니다.

비슷한 이름의 계약에 연결된 문서입니다.
contractName string

비슷한 이름의 계약에 연결된 문서입니다.

반환할 문서의 ID입니다.
documentIds array

반환할 문서의 ID입니다.

반환할 문서의 이름입니다.
documentName string

반환할 문서의 이름입니다.

문서의 발급 날짜입니다.
issuedDate string

문서의 발급 날짜입니다.

이전에 발급된 날짜가 있는 문서입니다.
maxIssuedDate string

이전에 발급된 날짜가 있는 문서입니다.

발행 날짜가 지난 문서입니다.
minIssuedDate string

발행 날짜가 지난 문서입니다.

문서가 속한 속성의 사람이 읽을 수 있는 ID입니다.
propertyHrId string

문서가 속한 속성의 사람이 읽을 수 있는 ID입니다.

문서가 속한 속성의 ID입니다.
propertyId integer

문서가 속한 속성의 ID입니다.

문서가 속한 속성의 이름입니다.
propertyName string

문서가 속한 속성의 이름입니다.

문서가 속한 원본 엔터티의 ID입니다.
sourceId integer

문서가 속한 원본 엔터티의 ID입니다.

문서의 원본 형식입니다.
sourceType array

문서의 원본 형식입니다.

문서가 연결된 태그의 ID입니다.
tagIds array

문서가 연결된 태그의 ID입니다.

문서가 연결되는 태그의 이름과 비슷합니다.
tagName string

문서가 연결되는 태그의 이름과 비슷합니다.

문서가 속한 단위 엔터티의 ID입니다.
unitId integer

문서가 속한 단위 엔터티의 ID입니다.

반환

response
file

청구서 PDF 문서 업로드

기본적으로 문서는 OCR 분석을 통해 진행됩니다.

매개 변수

Name 필수 형식 Description
청구서의 PDF 파일
file True file

청구서의 PDF 파일

반환

청구서 데이터 구조입니다.

InvoiceDto
InvoiceDto

특정 오류 코드의 세부 정보 가져오기

특정 오류 코드에 대한 설명을 검색합니다.

매개 변수

Name 필수 형식 Description
value
value True string

value

반환

ErrorCodeDetailsDto
ErrorCodeDetailsDto

트리거

애플리케이션 연결 만들기

애플리케이션 연결 만들기

애플리케이션 연결 만들기

애플리케이션 연결 만들기

반환

정의

ConnectionNotificationDto

Name 경로 형식 Description
알림이 적용되는 연결의 ID
connectionId integer

connectionId

엔티티 유형
entityType string

엔티티 유형

entityId
entityId integer

entityId

eventType
eventType string

eventType

ConnectionDto

기존 연결을 설명하는 데이터

Name 경로 형식 Description
애플리케이션의 ID
appId integer

애플리케이션의 ID

연결 애플리케이션의 이름
appName string

연결 애플리케이션의 이름

엔터티의 생성 시간입니다.
created string

엔터티의 생성 시간입니다.

엔터티의 ID입니다.
id integer

엔터티의 ID입니다.

연결 이름
name string

연결 이름

엔터티의 마지막 업데이트 시간입니다.
updated string

엔터티의 마지막 업데이트 시간입니다.

''' POST https://your.webhook.url/path/somewhere Authorization: 전달자 토큰과 같이 호출될 연결의 웹후크 { "connectionId": 0, "entityType": "properties|contacts|invoices|etc.", "entityId": 0, "eventType": "CREATE|UPDATE|DELETE" }'''
webhookUrl string

다음과 같이 호출될 연결의 웹후크

POST https://your.webhook.url/path/somewhere
Authorization: Bearer TOKEN

{
  "connectionId": 0,
  "entityType": "properties|contacts|invoices|etc.",
  "entityId": 0,
  "eventType": "CREATE|UPDATE|DELETE"
}```

ContactDetailsDto

연락처 정보

Name 경로 형식 Description
연락처의 회사 전화 번호
businessPhoneNumber array of string

연락처의 회사 전화 번호

연락처의 생년월일입니다.
dateOfBirth string

연락처의 생년월일입니다.

연락처의 전자 메일 주소
email array of string

연락처의 전자 메일 주소

연락처의 팩스 번호
fax array of string

연락처의 팩스 번호

연락처의 휴대폰 번호
mobilePhoneNumber array of string

연락처의 휴대폰 번호

연락처의 개인 전화 번호
privatePhoneNumber array of string

연락처의 개인 전화 번호

무역 등록 번호입니다.
tradeRegisterNumber string

무역 등록 번호입니다.

연락처의 VAT ID입니다.
vatId string

연락처의 VAT ID입니다.

연락처의 웹 사이트
website array of string

연락처의 웹 사이트

ContactDto

연락처는 자연인 또는 법인을 나타내며 연락하는 방법을 나타냅니다. ID/회사에 연락할 수 있는 여러 우편 주소가 있어야 합니다. 이러한 연락처는 서로 다른 2개의 연락처로 표시됩니다.

Name 경로 형식 Description
도시의 이름입니다.
city string

도시의 이름입니다.

연락처가 회사인 경우 회사의 이름입니다.
companyName string

연락처가 회사인 경우 회사의 이름입니다.

ISO 3166-1 alpha-2 표준에 따른 국가 코드입니다.
country string

ISO 3166-1 alpha-2 표준에 따른 국가 코드입니다.

연락처의 생성 시간입니다.
created string

연락처의 생성 시간입니다.

ContactDetailsDto
details ContactDetailsDto

연락처 정보

연락처가 사람인 경우 연락처의 이름입니다.
firstName string

연락처가 사람인 경우 연락처의 이름입니다.

연락처 인스턴스의 ID입니다.
id integer

연락처 인스턴스의 ID입니다.

연락처가 사람인 경우 연락처의 성입니다.
lastName string

연락처가 사람인 경우 연락처의 성입니다.

거리 번호입니다.
number string

거리 번호입니다.

우편 번호 또는 우편 번호입니다. 전자 메일을 통해 물리적 문자 연락처가 필요한 모든 사람에게 지정되어 있는지 확인합니다.
postalCode string

우편 번호 또는 우편 번호입니다. 전자 메일을 통해 물리적 문자 연락처가 필요한 모든 사람에게 지정되어 있는지 확인합니다.

연락처의 받는 사람 이름입니다.
recipientName string

연락처의 받는 사람 이름입니다.

연락처를 처리하는 데 사용되는 단어의 표준 수식입니다.
salutation string

연락처를 처리하는 데 사용되는 단어의 표준 수식입니다.

시/도, 세분화 또는 지역이라고도 하는 주 이름입니다.
state string

시/도, 세분화 또는 지역이라고도 하는 주 이름입니다.

거리의 이름입니다.
street string

거리의 이름입니다.

연락처의 직호입니다.
title string

연락처의 직호입니다.

연락처의 마지막 업데이트 시간입니다.
updated string

연락처의 마지막 업데이트 시간입니다.

ContactSimpleDto

간소화된 데이터 구조에 연결합니다.

Name 경로 형식 Description
연락처 인스턴스의 ID입니다.
id integer

연락처 인스턴스의 ID입니다.

연락처의 이름입니다. 자세한 내용은 ID를 통해 연락처를 로드합니다.
name string

연락처의 이름입니다. 자세한 내용은 ID를 통해 연락처를 로드합니다.

ContractDto

계약 데이터 구조입니다.

Name 경로 형식 Description
계약과 연결된 연락처 목록입니다.
contacts array of ContactSimpleDto

계약과 연결된 연락처 목록입니다.

계약 수입니다.
contractNumber string

계약 수입니다.

계약의 생성 시간입니다.
created string

계약의 생성 시간입니다.

계약의 유효 기간이 종료되는 날짜입니다. Null은 시간 종료로 해석됩니다.
endDate string

계약의 유효 기간이 종료되는 날짜입니다. Null은 시간 종료로 해석됩니다.

계약 인스턴스의 ID입니다.
id integer

계약 인스턴스의 ID입니다.

이 계약이 빈 형식 계약인지 여부를 설명합니다. 현재 계약이 TENANT 형식인 경우에만 true일 수 있습니다. 빈 계약은 단위가 임대되지 않음을 의미합니다.
isVacant boolean

이 계약이 빈 형식 계약인지 여부를 설명합니다. 현재 계약이 TENANT 형식인 경우에만 true일 수 있습니다. 빈 계약은 단위가 임대되지 않음을 의미합니다.

단위 키로 구성된 계약의 이름과 우편 연락처의 이름입니다.
name string

단위 키로 구성된 계약의 이름과 우편 연락처의 이름입니다.

계약이 속한 속성 인스턴스의 ID입니다.
propertyId integer

계약이 속한 속성 인스턴스의 ID입니다.

계약의 유효 기간이 시작되는 날짜입니다. Null은 시간의 시작으로 해석됩니다.
startDate string

계약의 유효 기간이 시작되는 날짜입니다. Null은 시간의 시작으로 해석됩니다.

계약의 형식입니다. 1. OWNER - 이러한 유형의 계약은 단위의 소유권을 증명합니다. 2. 테넌트 - 이러한 유형의 계약은 단위를 임대하는 것입니다. 3. PROPERTY_OWNER - 이러한 유형의 계약은 재산의 소유권을 증명한다.
type string

계약의 형식입니다.

  1. OWNER - 이러한 유형의 계약은 단위의 소유권을 증명합니다.
  2. TENANT - 이러한 유형의 계약이 단위를 임대하는 것입니다.
  3. PROPERTY_OWNER - 이러한 유형의 계약은 속성의 소유권을 증명합니다.
계약이 속한 단위 인스턴스의 ID입니다.
unitId integer

계약이 속한 단위 인스턴스의 ID입니다.

계약의 마지막 업데이트 시간입니다.
updated string

계약의 마지막 업데이트 시간입니다.

DocumentDto

문서 데이터 구조입니다.

Name 경로 형식 Description
문서에 있는 총 금액입니다.
amount float

문서에 있는 총 금액입니다.

문서가 속한 건물의 ID입니다.
buildingId integer

문서가 속한 건물의 ID입니다.

문서가 속한 연락처의 ID입니다.
contactId integer

문서가 속한 연락처의 ID입니다.

문서가 속한 계약의 ID입니다.
contractId integer

문서가 속한 계약의 ID입니다.

문서의 생성 시간입니다.
created string

문서의 생성 시간입니다.

문서 인스턴스의 ID입니다.
id integer

문서 인스턴스의 ID입니다.

문서의 발급 날짜입니다.
issuedDate string

문서의 발급 날짜입니다.

문서 인스턴스의 이름입니다.
name string

문서 인스턴스의 이름입니다.

문서가 할당된 속성의 사람이 읽을 수 있는 ID입니다.
propertyHrId string

문서가 할당된 속성의 사람이 읽을 수 있는 ID입니다.

문서가 속한 속성의 ID입니다.
propertyId integer

문서가 속한 속성의 ID입니다.

문서가 할당된 속성의 이름입니다.
propertyName string

문서가 할당된 속성의 이름입니다.

문서가 속한 원본 엔터티의 ID입니다.
sourceId integer

문서가 속한 원본 엔터티의 ID입니다.

문서의 원본 형식입니다. ID와 함께 문서가 시작/첨부된 이름과 동일한 이름의 비즈니스 프로세스를 식별합니다. null일 수 있습니다.
sourceType string

문서의 원본 형식입니다. ID와 함께 문서가 시작/첨부된 이름과 동일한 이름의 비즈니스 프로세스를 식별합니다. null일 수 있습니다.

문서의 상태입니다.
state string

문서의 상태입니다.

tags
tags array of DocumentTagSimpleDto
문서가 할당된 단위의 사람이 읽을 수 있는 ID입니다.
unitHrId string

문서가 할당된 단위의 사람이 읽을 수 있는 ID입니다.

문서가 속한 단위의 ID입니다.
unitId integer

문서가 속한 단위의 ID입니다.

문서의 마지막 업데이트 시간입니다.
updated string

문서의 마지막 업데이트 시간입니다.

DocumentTagDto

문서 태그의 모델 클래스입니다.

Name 경로 형식 Description
문서 태그에 대한 설명입니다.
description string

문서 태그에 대한 설명입니다.

문서 태그의 ID입니다.
id integer

문서 태그의 ID입니다.

문서 태그의 이름입니다.
name string

문서 태그의 이름입니다.

DocumentTagSimpleDto

문서 태그의 모델 클래스입니다.

Name 경로 형식 Description
문서 태그의 고유 식별자입니다.
id integer

문서 태그의 고유 식별자입니다.

문서 태그의 이름입니다.
name string

문서 태그의 이름입니다.

ErrorCodeDetailsDto

Name 경로 형식 Description
코드
code string
description
description string

InvoiceDto

청구서 데이터 구조입니다.

Name 경로 형식 Description
청구서에 따라 지불할 금액입니다.
amount float

청구서에 따라 지불할 금액입니다.

청구서의 해당 연락처 ID입니다.
counterpartContactId integer

청구서의 해당 연락처 ID입니다.

청구서의 해당 연락처 이름입니다.
counterpartContactName string

청구서의 해당 연락처 이름입니다.

엔터티의 생성 시간입니다.
created string

엔터티의 생성 시간입니다.

엔터티의 ID입니다.
id integer

엔터티의 ID입니다.

청구서의 발행 날짜입니다.
issuedDate string

청구서의 발행 날짜입니다.

items
items array of InvoiceItemDto
청구서의 이름입니다.
name string

청구서의 이름입니다.

해당 은행 계좌의 BIC 번호입니다.
orderCounterpartBic string

해당 은행 계좌의 BIC 번호입니다.

해당 은행 계좌의 IBAN입니다.
orderCounterpartIban string

해당 은행 계좌의 IBAN입니다.

은행 주문이 실행되도록 표시되는 예약 날짜 전 또는 이후의 일 수입니다.
orderDayOffset integer

은행 주문이 실행되도록 표시되는 예약 날짜 전 또는 이후의 일 수입니다.

속성의 은행 계좌 고유 식별자입니다.
orderPropertyBankAccountId integer

속성의 은행 계좌 고유 식별자입니다.

부동산 은행 계좌의 BIC 번호입니다.
orderPropertyBic string

부동산 은행 계좌의 BIC 번호입니다.

부동산 은행 계좌의 IBAN입니다.
orderPropertyIban string

부동산 은행 계좌의 IBAN입니다.

청구서의 해당 순서가 있는 경우 True입니다.
orderRequired boolean

청구서의 해당 순서가 있는 경우 True입니다.

생성된 순서의 문입니다.
orderStatement string

생성된 순서의 문입니다.

청구서가 속한 속성의 사람이 읽을 수 있는 ID입니다.
propertyHrId string

청구서가 속한 속성의 사람이 읽을 수 있는 ID입니다.

청구서가 속한 속성의 ID입니다.
propertyId integer

청구서가 속한 속성의 ID입니다.

청구서가 속한 속성의 이름입니다.
propertyName string

청구서가 속한 속성의 이름입니다.

청구서의 상태입니다. 가능한 값: 1. DRAFT - 송장을 만들었지만 불완전합니다. 2. READY - 청구서를 예약할 준비가 된 것입니다. 3. 예약됨 - 청구서가 예약되었습니다. 4. SCHEDULED - 되풀이 송장에만 적용됩니다. 5. 반전 - 청구서에서 생성된 모든 예약이 취소되었습니다.
state string

청구서의 상태입니다. 가능한 값:

  1. DRAFT - 청구서가 생성되었지만 불완전합니다.
  2. READY - 청구서를 예약할 준비가 된 것입니다.
  3. BOOKED - 청구서가 예약되었습니다.
  4. SCHEDULED - 되풀이 송장에만 적용됩니다.
  5. 반전 - 청구서에서 생성된 모든 예약이 취소되었습니다.
엔터티의 마지막 업데이트 시간입니다.
updated string

엔터티의 마지막 업데이트 시간입니다.

InvoiceItemDto

Name 경로 형식 Description
예약 항목의 계정 코드입니다.
accountCode string

예약 항목의 계정 코드입니다.

예약 항목의 계정 ID입니다.
accountId integer

예약 항목의 계정 ID입니다.

예약 항목의 계정 이름입니다.
accountName string

예약 항목의 계정 이름입니다.

예약 항목에 해당하는 금액입니다.
amount float

예약 항목에 해당하는 금액입니다.

예약 항목의 예약 텍스트입니다.
bookingText string

예약 항목의 예약 텍스트입니다.

청구서 항목의 생성 시간입니다.
created string

청구서 항목의 생성 시간입니다.

예약 항목의 고유 식별자입니다.
id integer

예약 항목의 고유 식별자입니다.

소득세법에 따른 소득세 신고 관련 금액: [Einkommenstueregesetz EStG 35a](https://www.gesetze-im-internet.de/estg/__35a.html).
laborCostAmount float

소득세법에 따라 소득세 신고와 관련된 금액: Einkommenstueregesetz EStG 35a.

선택한 유형에 따라: 소득세법에 따라 여러 보고서의 35a 부속서에 금액의 백분율이 보고됩니다. [Einkommenstueregesetz EStG 35a](https://www.gesetze-im-internet.de/estg/__35a.html). 예: 하우스머니 정착지(Hausgeldabrechnung) 또는 Opscost Report(Nebenkostenabrechnung). 1. HOUSEHOLD_RELATED_SERVICES - haushaltsnahe Dienstleistungen 2. TECHNICIAN_SERVICE - haushaltsnahe Handwerkerleistungen 3. MARGINAL_EMPLOYMENT - haushaltsnahe geringfügige Beschäftigungsverhältnisse 4. INSURABLE_EMPLOYMENT - sozialversicherungspflichtigen haushaltsnahen Beschäftigungsverhältnissen
laborCostType string

선택한 유형에 따라: 금액의 백분율은 소득세법에 따라 여러 보고서의 35a 부속서에 보고됩니다: Einkommenstueregesetz EStG 35a.

예: 하우스머니 정착지(Hausgeldabrechnung) 또는 Opscost Report(Nebenkostenabrechnung).

  1. HOUSEHOLD_RELATED_SERVICES - haushaltsnahe Dienstleistungen
  2. TECHNICIAN_SERVICE - haushaltsnahe Handwerkerleistungen
  3. MARGINAL_EMPLOYMENT - haushaltsnahe geringfügige Beschäftigungsverhältnisse
  4. INSURABLE_EMPLOYMENT - sozialversicherungspflichtigen haushaltsnahen Beschäftigungsverhältnissen
청구서 항목의 마지막 업데이트 시간입니다.
updated string

청구서 항목의 마지막 업데이트 시간입니다.

예약 항목의 해당 부가가치세 금액입니다.
vatAmount float

예약 항목의 해당 부가가치세 금액입니다.

총 금액의 부가가치세 금액에 해당하는 부가가치세 비율입니다.
vatPercentage float

총 금액의 부가가치세 금액에 해당하는 부가가치세 비율입니다.

PageOfContactDto

Name 경로 형식 Description
내용
content array of ContactDto
비어 있음
empty boolean
첫 번째
first boolean
마지막
last boolean
숫자
number integer
numberOfElements
numberOfElements integer
페이지 가능
pageable Pageable
size
size integer
Sort
sort Sort
totalElements
totalElements integer
totalPages
totalPages integer

PageOfContractDto

Name 경로 형식 Description
내용
content array of ContractDto
비어 있음
empty boolean
첫 번째
first boolean
마지막
last boolean
숫자
number integer
numberOfElements
numberOfElements integer
페이지 가능
pageable Pageable
size
size integer
Sort
sort Sort
totalElements
totalElements integer
totalPages
totalPages integer

PageOfDocumentDto

Name 경로 형식 Description
내용
content array of DocumentDto
비어 있음
empty boolean
첫 번째
first boolean
마지막
last boolean
숫자
number integer
numberOfElements
numberOfElements integer
페이지 가능
pageable Pageable
size
size integer
Sort
sort Sort
totalElements
totalElements integer
totalPages
totalPages integer

PageOfInvoiceDto

Name 경로 형식 Description
내용
content array of InvoiceDto
비어 있음
empty boolean
첫 번째
first boolean
마지막
last boolean
숫자
number integer
numberOfElements
numberOfElements integer
페이지 가능
pageable Pageable
size
size integer
Sort
sort Sort
totalElements
totalElements integer
totalPages
totalPages integer

PageOfPropertyDto

Name 경로 형식 Description
내용
content array of PropertyDto
비어 있음
empty boolean
첫 번째
first boolean
마지막
last boolean
숫자
number integer
numberOfElements
numberOfElements integer
페이지 가능
pageable Pageable
size
size integer
Sort
sort Sort
totalElements
totalElements integer
totalPages
totalPages integer

PageOfUnitDto

Name 경로 형식 Description
내용
content array of UnitDto
비어 있음
empty boolean
첫 번째
first boolean
마지막
last boolean
숫자
number integer
numberOfElements
numberOfElements integer
페이지 가능
pageable Pageable
size
size integer
Sort
sort Sort
totalElements
totalElements integer
totalPages
totalPages integer

페이지 가능

Name 경로 형식 Description
offset
offset integer
pageNumber
pageNumber integer
pageSize
pageSize integer
페이징
paged boolean
Sort
sort Sort
페이지가 지정되지 않음
unpaged boolean

PropertyDto

속성 데이터 구조입니다.

Name 경로 형식 Description
속성 인스턴스의 생성 시간입니다.
created string

속성 인스턴스의 생성 시간입니다.

속성 인스턴스의 ID입니다.
id integer

속성 인스턴스의 ID입니다.

속성 인스턴스의 이름입니다.
name string

속성 인스턴스의 이름입니다.

속성 인스턴스의 사람이 읽을 수 있는 ID입니다.
propertyHrId string

속성 인스턴스의 사람이 읽을 수 있는 ID입니다.

속성의 현재 상태입니다. 1. DRAFT - 속성이 아직 활성화되지 않았으므로 예약 / 은행 주문 / 보고서를 생성 할 수 없습니다. 2. READY - 속성이 활성화되었으며 예약/ 은행 주문/보고서 생성에 사용할 수 있습니다. 3. DISABLED - 속성이 비활성화되었으며 더 이상 예약 / 은행 주문 / 보고서를 생성 할 수 없습니다.
state string

속성의 현재 상태입니다.

  1. DRAFT - 속성이 아직 활성화되지 않았으므로 예약 / 은행 주문 / 보고서를 생성 할 수 없습니다.
  2. READY - 속성이 활성화되었으며 예약/은행 주문/보고서 생성에 사용할 수 있습니다.
  3. DISABLED - 속성이 비활성화되었으며 더 이상 예약/은행 주문/보고서를 생성할 수 없습니다.
속성의 관리 유형입니다. 소유자 - 주택 소유자 협회. RENTAL - 테넌트 관리.
type string

속성의 관리 유형입니다. 소유자 - 주택 소유자 협회. RENTAL - 테넌트 관리.

속성 인스턴스의 업데이트 시간입니다.
updated string

속성 인스턴스의 업데이트 시간입니다.

Sort

Name 경로 형식 Description
비어 있음
empty boolean
정렬
sorted boolean
정렬
unsorted boolean

UnitDto

단위 데이터 구조입니다.

Name 경로 형식 Description
단위 인스턴스의 생성 시간입니다.
created string

단위 인스턴스의 생성 시간입니다.

장치가 있는 바닥입니다.
floor string

장치가 있는 바닥입니다.

단위 인스턴스의 ID입니다.
id integer

단위 인스턴스의 ID입니다.

바닥 내 단위의 위치입니다.
position string

바닥 내 단위의 위치입니다.

단위가 속한 속성 인스턴스의 ID입니다.
propertyId integer

단위가 속한 속성 인스턴스의 ID입니다.

단위가 사용되는 용도입니다. APARTMENT - 주거용으로 사용되는 단위입니다. PARKING - 주차 목적으로 사용되는 장치. COMMERCIAL - 비즈니스/상업적 용도로 사용되는 단위입니다. OTHER - 다른 용도로 사용되는 단위입니다.
type string

단위가 사용되는 용도입니다. APARTMENT - 주거용으로 사용되는 단위입니다. PARKING - 주차 목적으로 사용되는 장치. COMMERCIAL - 비즈니스/상업적 용도로 사용되는 단위입니다. OTHER - 다른 용도로 사용되는 단위입니다.

단위 인스턴스의 사람이 읽을 수 있는 ID입니다.
unitHrId string

단위 인스턴스의 사람이 읽을 수 있는 ID입니다.

순위는 단위가 UI/보고서에 표시되는 방식을 정의합니다. 사용자가 UI에서 업데이트할 수 있습니다.
unitRank integer

순위는 단위가 UI/보고서에 표시되는 방식을 정의합니다. 사용자가 UI에서 업데이트할 수 있습니다.

단위 인스턴스의 업데이트 시간입니다.
updated string

단위 인스턴스의 업데이트 시간입니다.

LegacyInvoiceDto

Name 경로 형식 Description
BIC 대응
counterpartBic string

BIC 대응

ContactID 대응
counterpartContactId integer

ContactID 대응

IBAN 대응
counterpartIban string

IBAN 대응

대응
counterpartName string

대응

날짜
created string

날짜

청구서 URL
documentUrl string

청구서 URL

아이디
id integer

아이디

청구서 날짜
invoiceDate string

청구서 날짜

송장 ID
invoiceHrId string

송장 ID

청구서 번호
invoiceNumber string

청구서 번호

결제 대상 날짜
paymentTargetDate string

결제 대상 날짜

결제 유형
paymentType string

결제 유형

속성 NR
propertyHrId string

속성 NR

속성 ID
propertyId integer

속성 ID

속성 내부 ID
propertyIdInternal string

속성 내부 ID

속성 이름
propertyName string

속성 이름

참조 Nr
refNr string

참조 Nr

청구서 상태
state string

청구서 상태

총 총액
totalGross float

총 총액

총 순
totalNet float

총 순

VAT 포함.
vatIncluded boolean

VAT 포함.

VAT 백분율
vatPercentage float

VAT 백분율

file

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