콘텐츠로 이동
PlaidCloud

Business Central: Post General Journal Lines 단계

설명

섹션 제목: “설명”

Business Central 연결을 통해 PlaidCloud의 공유 ERP 쓰기 파이프라인으로 Business Central에 일반 분개장 라인을 전기합니다. 이 단계는 헤더 테이블(journal_id당 한 행)과 라인 테이블(journal_id당 한 행 이상)을 입력으로 받아, 이미 있는 분개장 배치 안에 라인을 만들고 해당 배치를 전기합니다. 검증만을 사용하면 전기하지 않고 모든 분개를 구성하여 검사하며, 선택 사항인 결과 테이블에 처리 결과가 기록됩니다.

구성

섹션 제목: “구성”

연결

섹션 제목: “연결”
  • Business Central 연결 — 전기에 사용할 Business Central 연결입니다.
  • 환경 — 연결의 환경입니다.

데이터

섹션 제목: “데이터”
  • 헤더 테이블 — journal_id당 한 행: 라인을 전기할 Business Central 분개장 배치 이름, document_number, posting_date, 통화 레이블.
  • 라인 테이블 — journal_id당 한 행 이상: 부호가 있는 amount(차변은 양수, 대변은 음수), account_id 또는 account_number, account_type, description.
  • 결과 테이블 — 출력 테이블 ID: journal_id당 한 행이며 journal_id, external_id, internal_id, status, message를 포함합니다.
  • 검증만 — 기본으로 선택되어 있습니다. 사전 점검만 수행하며 원장 선점이나 전기는 하지 않습니다. 이 필드가 아예 없는 단계 구성(예: REST API, MCP 또는 워크플로 번들 가져오기로 작성한 구성)도 실제 전기가 아니라 검증만으로 기본 동작합니다.
  • 오류 발생 시 계속 — 기본으로 선택되어 있습니다. 한 분개가 실패한 후에도 나머지 분개를 계속 전기하며, 선택을 해제하면 첫 번째 실패에서 배치를 중지합니다.

전기 방식

섹션 제목: “전기 방식”

Business Central의 Microsoft.NAV.post 바운드 작업은 이 요청이 만든 라인뿐 아니라 분개장 배치 전체를 전기합니다. 이를 호출하기 전에 PlaidCloud는 배치를 다시 읽어, 이 요청의 문서 번호가 찍혀 있지 않은 라인이 있으면 전기를 거부하고 오류를 기록합니다(아무것도 전기되지 않음). 이 방어 장치는 이전의 부분 실패로 남은 라인이 같은 배치에 대한 관련 없는 이후 전기와 함께 총계정원장에 반영되는 것을 막습니다.

generalLedgerEntries는 읽기 전용이며 전기된 항목만 포함하므로, PlaidCloud는 분개장 배치를 다시 읽는 대신 그곳에서 문서 번호를 찾아 전기 성공 여부를 확인합니다. generalLedgerEntries에서 일치하는 항목이 있다면 라인이 만들어졌다는 것이 아니라 실제로 전기되었다는 증거입니다.

기능 제한

섹션 제목: “기능 제한”
제한 사항 의미
쓰기 문서 유형 하나만 지원 일반 분개장 라인 전기만 지원합니다. Business Central의 임시 문서 흐름(판매/구매 송장, 임시 → 전기됨)은 지원하지 않습니다. 해당 흐름의 정확한 전기 작업이 Microsoft의 공개 문서에 명시되어 있지 않기 때문입니다.
기존 배치만 가능 이 단계는 분개장 배치를 만들지 않습니다. 먼저 Business Central에서 배치를 만든 다음 journal_id가 해당 배치를 가리키게 하십시오.
같은 배치에 대한 동시 전기 멱등성 보호는 분개장 배치가 아니라 문서 번호 단위로 적용됩니다. 따라서 서로 다른 두 문서 번호를 같은 배치에 동시에 전기하면, 같은 문서 번호로 두 번 호출한 경우처럼 직렬화된다는 보장이 없습니다. 하나의 배치에 동시에 전기하지 마십시오.

관련 항목

섹션 제목: “관련 항목”