주 컨텐츠로 이동
문서
문서
Adaptive Planning
최종 업데이트: 2023-06-23
계정

계정

버전: v1

지원되는 HTTP 동사

HTTP Verb
설명
POST
요청에 언급된 계정을 삭제합니다.

POST:

요청:
/removeGLAccounts:
지정된 GL 계정 코드의 계정을 삭제합니다.
이 엔드포인트는 '
ENABLE_ACCOUNTS_DELETION_JSON_API
'(현재 기본적으로 켜져 있음) 기능 플래그 뒤에 있습니다.
UI에서 삭제할 수 있는 모든 GL 계정을 지원합니다. 삭제할 수 없는 계정은 무시합니다.
샘플 요청 URI:
https://api.adaptiveplanning.com/api/rest/modeling/v1/globosales/accounts/removeGLAccounts
샘플 요청 헤더:
권한 부여: 기본
Content-Type: application/json
샘플 요청 본문
샘플 POST 요청 
[
    {
        "accountCodesToDelete": ["Assets", "b"]
    }
]
페이로드 매개변수
이름
설명
필수
accountCodesToDelete
삭제할 계정 코드 - 이름
예
경로 매개변수
이름
설명
필수
테넌트
작업할 테넌트입니다. 예: 글로벌 영업
예
쿼리 매개변수
이름
설명
필수
강제 제거
forceRemove=true이면 사용 중인 계정을 삭제하고,forceRemove=false이면 사용 중인 계정을 무시합니다.
기본값은 항상forceRemove=false입니다.
아니요
instanceCode
값을 검색할 instanceCode입니다. 예를 들어, GLOBO입니다. instanceCode를 지정하지 않으면 사용자의 기본 인스턴스가 사용됩니다.
아니요
샘플 응답:
204 내용 없음
상태 코드 204를 사용하여 성공한 응답이 비어 있습니다.
400 잘못된 요청
서버에서 요청을 이해할 수 없습니다.
401 권한 없음
사용자에게 권한이 없습니다.
403 금지
사용자에게 권한이 충분하지 않습니다.
500 내부 서버 오류
내부 서버 오류입니다.

POST:

요청:
/removeAccounts
지정된 GL 계정 코드의 계정을 삭제합니다.
이 엔드포인트는 '
ENABLE_ACCOUNTS_DELETION_JSON_API_2
'(현재 기본적으로 꺼져 있음) 기능 플래그 뒤에 있습니다.
UI에서 삭제할 수 있는 모든 계정을 지원합니다. 삭제할 수 없는 계정은 무시하며 옵션으로 경고를 제공할 수 있습니다.
샘플 요청 URI:
https://api.adaptiveplanning.com/api/rest/modeling/v1/globosales/accounts/removeAccounts
샘플 요청 헤더:
권한 부여: 기본
Content-Type: application/json
샘플 요청 본문
샘플 POST 요청 

    {
        "accountCodesToDelete": ["Assets", "b"]
    }
페이로드 매개변수
이름
설명
필수
accountCodesToDelete
삭제할 계정 코드 - 이름
예
경로 매개변수
이름
설명
필수
테넌트
작업할 테넌트입니다. 예: 글로벌 영업
예
쿼리 매개변수
이름
설명
기본값
필수
강제 제거
사용 중인 계정을 삭제합니다.
false
아니요
showWarnings
응답으로 경고를 표시합니다.
false
아니요
doValidateOnly
검증 모드를 활성화합니다.
false
아니요
경고
account-deletion-warning=일부 계정이 삭제되지 않았습니다.
warning-default-root=기본 root 계정은 삭제할 수 없습니다.
warning-sheet-root=시트 루트 그룹을 삭제할 수 없습니다.
warning-cta-account=누적 환산 조정 계정은 삭제할 수 없습니다.
warning-in-use=forceRemove가 OFF로 설정되어 있으므로 사용 중인 계정을 삭제할 수 없습니다.
warning-cannot_delete_mi_system_account=소수주주지분 시스템 계정은 삭제할 수 없습니다. 이 계정은 전체 연결법을 위한 소수주주지분 계산에 사용되고 있습니다.
warning-cannot_delete_mi_net_ Income_account=Minority Interest Net Income 계정을 삭제할 수 없습니다. 이 계정은 전체 연결법을 위한 소수주주지분 계산에 사용되고 있습니다.
warning-cannot_delete_mi_account_ancestor=계정의 descendant 계정 중 하나가 전체 연결법의 소수주주지분 계산에 사용되었으므로 계정을 삭제할 수 없습니다.
warning-delete_child_used_in_breakback-msg=이 계정 또는 해당 descendant 계정 중 하나가 자동 분산에서 사용 중이므로 계정을 삭제할 수 없습니다.
warning-cannot_delete_pcm_account=이 계정을 삭제하려면 계획 구성 매니저를 사용하십시오.
warning-nonexistent-code=이 계정이 없습니다.
warning-ambigous-code=이 코드는 여러 계정에서 공유됩니다.
샘플 응답:
200 OK
 
{
    "total": 0
}
200 OK(경고 있음)
 
{
    "total": 0,
    "warning": {
        "info": "Some accounts were not deleted.",
        "warnings": [
            {
                "field": "xyz",
                "warning": "This account does not exist."
            }
        ]
    }
}
400 잘못된 요청
서버에서 요청을 이해할 수 없습니다.
401 권한 없음
사용자에게 권한이 없습니다.
403 금지
사용자에게 권한이 충분하지 않음/기능 플래그가 꺼져 있음 
{
    "error": "Service Unavailable"
}
500 내부 서버 오류
내부 서버 오류입니다.