Intacct: 분개 전표 전기 단계
Intacct의 REST v1 API를 사용하여 Sage Intacct 연결을 통해 분개 전표를 Sage Intacct에 전기합니다. 전기용 사용자 정의 함수(UDF)를 직접 작성하는 방식을 대체하는 로우코드 네이티브 방식으로, 연결을 선택하고 열을 매핑하면 인증, 배치 처리, 전표별 오류 처리를 이 단계가 대신 처리합니다.
이 단계는 업스트림에서 이미 구성해 둔 두 테이블, 즉 헤더 테이블과 라인 테이블을 읽어 각 분개 전표를 검증한 다음 전기합니다. 한 번의 실행에서 많은 분개 전표를 각각 독립적으로 전기하고 추적하는 배치 경우를 처리합니다.
모든 전표는 다른 ERP 전기 단계가 사용하는 것과 같은 기록인 PlaidCloud의 전기 원장을 거치므로, 실거래 전기는 전기 등록부와 ERP 전기 기록에 나타납니다. 실거래 전기에는 프로젝트가 해당 연결에 전기할 권한이 있어야 합니다.
데이터 형태 규약
섹션 제목: “데이터 형태 규약”이 단계는 어느 행이 어느 분개 전표에 속하는지 추론하지 않습니다. 이 단계를 실행하기 전에 표준 단계(할당 식, 집계)로 업스트림에서 그 구조를 만들어야 합니다.
- 헤더 테이블은 분개 전표당 정확히 한 행을 가지며, 그 행에는
entry_key열이 있습니다. 전표마다 고유한 값이면 무엇이든 됩니다(배치 번호, 날짜와 설명을 이은 값, 생성된 시퀀스 등). - 라인 테이블은 전기 라인당 한 행을 가지며, 모든 라인이 속한 헤더 행과 같은
entry_key값을 가집니다.
분개 전표 하나만 전기하는 경우(배치 처리 없음)에도 이 형태가 필요합니다. 두 테이블의 모든 행에 동일한 상수 entry_key를 지정하십시오.
이 단계는 검증하거나 전기하기 전에 두 테이블을 entry_key로 그룹화하므로, 일치하는 라인이 없는 헤더 행, 일치하는 헤더가 없는 라인, 같은 키를 가진 헤더 행이 둘 이상인 경우는 모두 잘못된 전기를 만들어 내는 대신 해당 전표의 검증에서 실패합니다.
고유 구성 항목
섹션 제목: “고유 구성 항목”Sage 연결
섹션 제목: “Sage 연결”전기에 사용할 Sage Intacct 연결입니다. 전기에는 Sage Intacct 연결만 가지고 있는 Intacct 전용 토큰 교환과 회사/엔터티 확인이 필요하므로, 여기에는 Sage Intacct 연결만 표시되고 일반 REST 연결은 허용되지 않습니다.
같은 연결을 다른 곳에서 Intacct에서 읽는 데에도 사용합니다(예: Import Sage AP 단계 또는 Import Sage Intacct Query 단계). 하나의 연결이 양방향을 모두 처리합니다. Sage Intacct REST 커넥터를 참조하십시오.
Entry Key
섹션 제목: “Entry Key”헤더 소스 열과 라인 소스 열 양쪽에 존재하며, 헤더 행과 라인 행을 하나의 분개 전표로 그룹화하는 열의 이름입니다. 위의 데이터 형태 규약을 참조하십시오.
소스 열
섹션 제목: “소스 열”탭마다 하나씩 두 개의 별도 열 매핑이 있으며, 각각 소스 열을 해당 열이 채우는 분개 전표 필드에 매핑합니다.
- 헤더 열 — 분개 전표 수준의 필드입니다. 분개장, 전기 날짜, 설명, 참조 번호, 선택 사항인
base_location(전표를 전기할 Intacct 엔터티/위치이며 단일 엔터티 회사라면 생략), Entry Key로 지정한 상관 관계 열, 그리고 이와 유사한 헤더 수준 상세 정보가 있습니다. 매핑한reference_number는 표시용으로만 유지되며, Intacct로 전송되는 참조 번호는 항상 전표 키와 전기 월로 만들어집니다. - 라인 열 — 전기 라인별 필드입니다. 총계정원장 계정, 차변/대변 금액, 라인 설명, 동일한 Entry Key 열, 차원(위치, 부서, 직원, 클래스 등)이 있습니다.
소스 열의 이름을 바꿀 필요는 없습니다. 열의 이름이 무엇이든 위의 대상 필드 이름에 매핑하면 됩니다.
결과 테이블
섹션 제목: “결과 테이블”이 단계가 분개 전표당 한 행씩 기록하는 대상 테이블로, 각 전표를 검증하고 (미리보기가 아닌 경우) 전기한 결과를 기록합니다. 열과 status 값은 아래의 결과 테이블을 참조하십시오.
Preview
섹션 제목: “Preview”기본적으로 선택되어 있는 체크박스입니다. Preview를 켜면 이 단계는 모든 분개 전표를 검증하고 실제 실행과 똑같이 결과 테이블을 기록하지만, Intacct에 인증하지 않으며 아무것도 전기하지 않습니다. Preview 모드에서는 Intacct로 가는 네트워크 호출이 전혀 없습니다. 행은 status = preview로 결과 테이블에 기록되므로, 원장에 아무것도 반영되기 전에 어떤 전표가 문제없이 전기되고 어떤 전표가 검증에서 실패할지 확인할 수 있습니다. 각 전표가 전기할 내용은 ERP 전기 기록과 전기 등록부에도 시뮬레이션으로 기록되며, 시뮬레이션된 전표는 이후의 실제 전기를 막지 않습니다.
실제 실행과 마찬가지로 Preview도 결과 테이블을 이번 실행의 행으로 교체합니다. 결과 테이블은 누적 로그가 아니라 단계의 실행별 출력이므로, 실제 실행 후에 Preview를 실행하면 그 실행의 posted 행과 unknown 행이 덮어써집니다. 지난 실행의 결과 테이블이 여전히 필요하다면 다시 실행하기(Preview든 실제든) 전에 열어서 복사해 두십시오.
Preview는 Intacct 자격 증명을 검증하지 않습니다. 연결하지 않으므로 잘못된 연결이나 만료된 자격 증명은 여기에 나타나지 않습니다. 자격 증명은 연결의 연결 테스트 동작(도구 > 연결)으로 별도로 확인하십시오.
이 필드를 완전히 생략한 단계 구성(예: REST API, MCP 또는 워크플로 번들 가져오기로 작성한 구성)도 실제 전기가 아니라 Preview로 기본 설정됩니다.
실제로 전기할 준비가 되었을 때만 Preview를 선택 해제하십시오. 먼저 Preview를 켜고 실행해 결과 테이블을 검토한 다음, Preview를 끄고 다시 실행하는 것이 좋습니다.
결과 테이블
섹션 제목: “결과 테이블”Preview든 실제 실행이든 모든 실행은 분개 전표마다 결과 테이블에 한 행을 기록합니다.
| 열 | 설명 |
|---|---|
entry_key |
이 행이 보고하는 분개 전표입니다. |
status |
preview, posted, failed, unknown 중 하나입니다. 아래를 참조하십시오. |
intacct_key |
전기된 전표에 대해 Intacct가 할당한 키이며, 사용할 수 있는 경우에만 제공됩니다. |
http_status |
비어 있습니다. 결과는 status와 error_message에 담깁니다. |
error_message |
status가 failed 또는 unknown일 때 무엇이 잘못되었는지에 대한 간단하고 정제된 설명입니다. |
line_count |
이 전표와 일치한 라인의 수입니다. |
posting_date |
Intacct로 전송된(Preview에서는 전송될) 전기 날짜입니다. |
상태 값
섹션 제목: “상태 값”preview— Preview 모드입니다. 전표가 검증되었으며 전기되지 않았습니다.posted— 전표가 지금 또는 이전 실행에서 Intacct에 성공적으로 전기되었습니다.failed— 아무것도 전송되기 전에 전표가 검증에서 실패했거나 Intacct가 거부했습니다. 검증 실패는 수정한 다음 다시 실행하십시오. Intacct가 거부한 전표는 같은entry_key와 전기 월로 다시 전송되지 않으므로, 정정한 전표는 새entry_key로 전기하십시오.unknown— 결과를 확인할 수 없었습니다. 시간 초과, 연결 끊김, 또는 Intacct로부터 명확한 응답이 없는 서버 오류입니다.
failed 또는 unknown 행이 있거나 전기된 합계가 소스와 맞지 않는 실행은 결과 테이블을 열지 않아도 알 수 있도록 단계가 오류로 끝납니다. 다음에 무엇을 해야 하는지는 결과 테이블과 전기 등록부에 표시됩니다.
관련 항목
섹션 제목: “관련 항목”- 내보내기 단계
- 문서 전기 — 하나의 단계에서 Sage Intacct 및 다른 ERP 시스템에 분개 전표와 송장을 전기합니다
- Import Sage AP 단계
- Import Sage Intacct Query 단계
- Sage Intacct REST 커넥터