경비 정산 시스템 킹디 클라우드 스타 연동: 증빙 전송 필드와 흔한 오류

연동의 어려움은 결코 인터페이스 호출 방법이 아니라 보조 회계 차원을 어떻게 전달하고 결산 기간 상태를 어떻게 검증하는지——이 두 곳이 오류의 주요 원천입니다. 인터페이스 자체에는 표준 문서가 있으니 그대로 작성하면 됩니다. 실제로 시간이 드는 것은 비용통제 측의 부서, 프로젝트, 직원 코드를 진뎨 측의 기초 자료와 정렬하는 일입니다.

증빙 전송의 필수 필드

보조 회계는 가장 걸리기 쉬운 부분입니다

킹디의 계정과목은 여러 회계 차원을 연결할 수 있으며, 또한 계정과목별로 요구하는 차원이 다릅니다。관리비는 부서만 필요할 수 있고, 연구개발 지출은 프로젝트도 필요하며, 기타 미지급금은 직원이 필요합니다.

비용통제 측에서 각 계정이 어떤 차원을 요구하는지 모르면 전부 전송하거나 전부 전송하지 않을 수밖에 없습니다. 전자는 계정이 받지 않는 차원을 전송할 수 있고, 후자는 차원 부족으로 거부됩니다.

올바른 방법은 비용통제 측의 계정 마스터 데이터에 required_dims 필드를 유지 관리 증빙 생성 시 계정과목 요건에 따라 채우고 검증하며, 누락된 것은 초안 단계에서 보고됩니다.

코드가 맞지 않으면 어떻게 하나요

비용 통제 시스템의 부서 코드는 Kingdee 기초자료와 일치하지 않을 수 있으며, 특히 비용 통제가 OA나 HR의 조직 구조를 사용할 때 그러합니다.

이때 필요한 것은 한 장의 코드 변환 대조표：비용관리 측 코드 → 킹디 측 코드. 이 표는 구현 단계에서 구축하고 유지해야 하며, 양측 코드가 자연스럽게 일치할 것이라고 기대해서는 안 됩니다.

조사 단계에서 반드시 명확히 물어야 할 한 가지 질문은 차원 값의 코드가 양쪽에서 일치하는지, 불일치하면 변환 테이블이 필요한지입니다.

다섯 가지 흔한 오류

이 다섯 가지 중 앞의 네 가지는 모두 마땅히 푸시되기 전에 차단됩니다 진뎨가 오류 코드를 반환한 뒤에야 문제를 살펴보게 되면, 재무 담당자가 보는 것은 기술 정보뿐이라 어느 전표에 문제가 있는지도, 어떻게 수정해야 하는지도 알 수 없다.

멱등: 동일 전표에서 두 개의 증빙을 생성할 수 없음

인터페이스 타임아웃, 네트워크 지터, 수동 재시도 모두 동일한 지출전표가 여러 번 푸시될 수 있습니다.반드시 데이터베이스 수준에서 고유 인덱스를 생성해야 합니다「비용청구번호 + 업무 유형」을 고유 키로 사용하며, 애플리케이션 계층 판단에만 의존하지 않습니다. 동시성 상황에서는 애플리케이션 계층 판단이 무효화되기 때문입니다.

실패 재시도의 상태 머신

실패 원인은 반드시 완전히 기록하고 재무 담당자가 읽을 수 있는 방식으로 제시해야 하며, 단순히 오류 코드만 저장해서는 안 됩니다.

무효는 수정발행으로, 삭제하지 마세요

비용 정산서가 폐기되거나 반환될 때는 적자 전표를 생성하여 상계하고 원래 전표는 보존해야 합니다. 이유는 두 가지입니다: 회계기록 완전성 요구, 그리고 총계정 시스템은 일반적으로 기장 완료된 전표 삭제를 허용하지 않기 때문입니다.