Business Central에 연결

PlaidCloud를 Business Central의 표준 OData v2.0 REST API에 연결하면 OData를 직접 작성하지 않고도 계정, 원장 항목, 고객, 공급업체, 품목, 분개장을 가져오고 일반 분개장 라인을 다시 전기할 수 있습니다. 이 가이드에서는 연결, 가져오기 단계, 전기 단계를 다룹니다.

주의

모든 가져오기는 먼저 샌드박스 환경을 대상으로 실행하고, 실제로 전기하기 전에 모든 전기 배치에 대해 아래의 미리 보기 및 검증을 거치십시오.

사전 요구 사항

Azure AD와 Business Central에서 다음이 필요합니다.

• 클라이언트 시크릿이 있는 PlaidCloud용 Entra ID(Azure AD) 앱 등록. Business Central에 대한 API 권한(Dynamics 365 Business Central > API.ReadWrite.All 또는 관리자가 발급하는 더 좁은 권한)이 부여되어 있어야 합니다.
• Azure AD 테넌트 ID.
• PlaidCloud가 호출할 Business Central 환경 이름(예: Production 또는 샌드박스 환경).
• PlaidCloud가 읽고 전기할 회사. Business Central은 엔터티 읽기와 분개장 전기를 한 번에 하나의 회사로 한정합니다.

참고

이 연결은 사용자가 아니라 애플리케이션으로 인증합니다. PlaidCloud가 다른 Microsoft REST 연결에 사용하는 것과 동일한 OAuth2 클라이언트 자격 증명 메커니즘인 Entra ID 클라이언트 자격 증명(S2S) 흐름입니다. 대화형 로그인은 없습니다.

연결 만들기

1. Tools > Connections를 열고 New Connection을 클릭합니다.

2. 메뉴에서 Business Central을 선택합니다.

3. 필드를 입력합니다.

   필드	값
   이름	알아보기 쉬운 이름(예: BC Prod).
   클라이언트 ID	Entra 앱 등록의 애플리케이션(클라이언트) ID.
   클라이언트 시크릿	앱 등록의 클라이언트 시크릿.
   테넌트 ID	Azure AD 테넌트 ID.
   환경	Business Central 환경 이름(예: Production).
   회사	읽고 전기할 Business Central 회사 ID.

4. Create를 클릭합니다.

연결 테스트

1. 워크플로에 Import Business Central Entity 단계를 추가합니다.

2. Business Central 연결을 만든 연결로, 엔터티 유형을 accounts로, 대상 테이블을 임시 테이블로 설정합니다.

3. 단계를 실행합니다(워크플로에서 단계 하나 실행 참조).

대상 테이블에 데이터가 채워지면 테넌트, 자격 증명, 환경, 회사가 모두 올바른 것입니다. 오류가 발생하면 잘못된 클라이언트 시크릿, 누락된 API 권한 부여, 잘못된 환경/회사 등 문제가 무엇인지 오류에 표시됩니다.

데이터 가져오기

1. Import Business Central Entity 단계를 추가하고 Business Central 연결과 대상 테이블을 설정합니다.

2. 엔터티 유형을 원하는 레코드로 설정합니다. accounts, generalLedgerEntries, customers, vendors, items, journals 중에서 선택합니다.

3. 필터를 추가합니다. {field, operator, value} 행이 AND로 결합되어 요청의 $filter에 들어가며, 엔터티 자체의 쿼리 가능 필드 허용 목록과 대조하여 검사됩니다. 비워 두면 엔터티 전체를 가져옵니다.

4. 단계를 실행하고 대상 테이블을 확인합니다.

참고

회사는 단계가 아니라 연결에서 가져옵니다. Business Central은 모든 읽기를 하나의 회사로 한정하며 연결이 환경과 함께 해당 회사를 전달하므로, 가져오기 단계에는 회사나 환경 필드가 없습니다. 두 번째 회사에서 같은 엔터티를 가져오려면 해당 회사를 가리키는 두 번째 Business Central 연결을 만드십시오.

참고

generalLedgerEntries는 Business Central의 읽기 전용, 전기 완료 전용 원장입니다. 전기되지 않은 분개장 배치에 남아 있는 라인은 표시되지 않으므로, 분개장을 직접 쿼리하지 말고 시산표나 총계정원장 상세를 가져올 때 이 엔터티를 사용하십시오.

일반 분개장 라인 전기

Business Central Post 단계는 기존 일반 분개장 배치에 라인을 전기한 다음 해당 배치를 전기합니다.

1. journal_id당 한 행으로 구성된 헤더 테이블을 만들고, 라인을 전기할 Business Central 분개장 배치 이름과 함께 document_number, posting_date, 통화 레이블을 포함합니다.

2. journal_id당 한 개 이상의 행으로 구성된 라인 테이블을 만들고, 부호가 있는 amount(차변은 양수, 대변은 음수), account_id 또는 account_number, account_type, description을 포함합니다.

3. Business Central Post 단계를 추가하고 Business Central 연결, 환경, 헤더 테이블, 라인 테이블, 결과 테이블을 설정합니다.

4. Validate Only를 선택한 상태로 두고 단계를 실행합니다. PlaidCloud가 아무것도 전기하지 않고 모든 분개장을 만들고 검사합니다.

5. 결과 테이블(journal_id당 한 행: journal_id, external_id, internal_id, status, message)을 검토합니다. error 행을 수정하고 다시 검증합니다.

6. Validate Only를 선택 해제하고 다시 실행하여 실제로 전기합니다. 첫 번째 실패한 분개장에서 배치가 즉시 중단되기를 원하지 않는다면 Continue On Error를 선택한 상태로 둡니다.

주의

journal_id에 지정한 분개장 배치는 Business Central에 이미 있어야 합니다. 이 단계는 배치 안에 라인을 만들 뿐 배치 자체를 만들지는 않습니다. 먼저 Business Central에서 분개장 배치(이름, 분개장 템플릿)를 설정한 다음 journal_id가 해당 배치를 가리키도록 하십시오.

전기 방식

Business Central의 Microsoft.NAV.post 작업은 PlaidCloud가 방금 만든 라인만이 아니라 분개장 배치 전체를 전기합니다. 따라서 이를 호출하기 전에 PlaidCloud는 배치를 다시 읽어, 이 요청의 문서 번호가 찍히지 않은 라인이 있으면 전기를 거부합니다(오류를 기록하고 아무것도 전기하지 않음). 이 보호 장치는 이전의 부분 실패로 남겨진 라인이 같은 배치에 대한 관련 없는 이후 전기에 휩쓸려 총계정원장에 반영되는 일이 없도록 하기 위한 것입니다.

기능 제한 — 실제 전기 전에 읽어 보십시오

주의

• 쓰기 문서 유형은 하나뿐입니다. 일반 분개장 라인 전기만 지원됩니다. Business Central의 초안 문서 흐름(판매/구매 청구서가 초안에서 전기됨으로 이동)은 지원되지 않습니다. 해당 흐름의 정확한 전기 작업이 Microsoft 문서에 명시되어 있지 않으며, PlaidCloud는 금전이 이동하는 쓰기에 대해 검증되지 않은 엔드포인트를 추측하지 않습니다.
• 기존 배치에만 전기합니다. 이 단계는 분개장 배치를 만들지 않습니다. 먼저 Business Central에서 만드십시오(위 참조).
• 아직 실제 환경 검증이 없습니다. Business Central의 문서화된 OData v2.0 계약에 맞춰 구현되었으므로 첫 번째 실제 배치는 검증 실행으로 간주하고 Business Central에서 직접 대사하십시오.
• 같은 배치에 대한 동시 전기는 완전히 직렬화되지 않습니다. 멱등성 보호 장치의 범위는 분개장 배치가 아니라 문서 번호입니다. 서로 다른 두 문서 번호를 같은 배치에 동시에 전기하면 같은 문서 번호로 두 번 호출할 때처럼 직렬화된다는 보장이 없습니다. 하나의 분개장 배치에 동시에 전기하지 마십시오.

관련 항목

• Business Central REST 커넥터 — 필드 참조.
• Import Business Central Entity 단계
• Business Central: 일반 분개장 전기 단계
• ERP 전기 이력 검토 — 모든 Business Central 전기 시도와 현재 상태에 대한 상시 기록.
• 연결 만들기 및 관리