템플릿 병합 기능 개선

템플릿 병합 API에 대해 2가지를 개선하였습니다.

소스별 식별자(identifier) 지정 지원
서명자 첨부파일 병합 규칙 변경

소스별 식별자(`identifier`) 지정 지원

템플릿 병합 시 TEMPLATE 타입 소스에 identifier(선택, 최대 8자)를 지정할 수 있습니다. 각 소스의 하위 리소스를 구분하는 dataLabel의 postfix로 사용되며, 이를 활용해 동일한 템플릿을 여러 번 병합할 수 있습니다. 미입력 시 templateId의 앞 8자로 자동 대체됩니다.

Request Body 예시

{
  "sources": [
    {
      "type": "TEMPLATE",
      "templateId": "5e1be670-3d54-11f1-bef5-f1a20e974ff9",
      "identifier": "doc1"
    },
    {
      "type": "TEMPLATE",
      "templateId": "aa12a2a0-d3fd-11f0-abb4-c347321b0a7c",
      "identifier": "doc2"
    }
  ]
}

Response Body 예시

{
  "participants": [
    {
      "type": "SIGNER",
      "fields": [
        // 첫 번째 소스의 템플릿에 있던 필드
        { "type": "NAME", "dataLabel": "서명자이름_근로계약서_doc1" }
      ]
    },
    {
      "type": "SIGNER",
      "fields": [
        // 두 번째 소스의 템플릿에 있던 필드
        { "type": "NAME", "dataLabel": "서명자이름_근로계약서_doc2" }
      ]
    }
  ]
}

서명자 첨부파일 병합 규칙 변경

템플릿 병합 시, 서명자 첨부파일 병합 규칙이 다음과 같이 변경됩니다.

변경 전

모든 소스의 서명자 첨부파일을 유지합니다.

변경 후

병합되는 소스 간 서명자 첨부파일의 이름이 같은 경우, 앞쪽 소스의 서명자 첨부파일을 사용합니다.

변경 예시

병합하려는 템플릿 2개에 동일 인물로 판단되는 서명자가 있고 각 템플릿에서의 서명자 첨부파일이 다음과 같을 때,

순서	identifier	서명자 첨부파일 이름
source[0]	`doc1`	`신분증`
source[1]	`doc2`	`신분증`
source[1]	`doc2`	`재직증명서`

병합 결과는 다음과 같습니다.

서명자 첨부파일 이름	사용된 소스	사유
`신분증`	`doc1` (source[0])	이름이 동일한 경우, 앞쪽 소스 우선 사용
`재직증명서`	`doc2` (source[1])	이름이 다른 경우, 해당 소스 그대로 유지