> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Signテンプレートを使用した署名リクエストの作成

export const MultiRelatedLinks = ({sections = []}) => {
  if (!sections || sections.length === 0) {
    return null;
  }
  return <div className="space-y-8">
      {sections.map((section, index) => <RelatedLinks key={index} title={section.title} items={section.items} />)}
    </div>;
};

export const RelatedLinks = ({title, items = []}) => {
  const getBadgeClass = badge => {
    if (!badge) return "badge-default";
    const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
    return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
  };
  if (!items || items.length === 0) {
    return null;
  }
  return <div className="my-8">
      {}
      <h3 className="text-sm font-bold uppercase tracking-wider mb-4">{title}</h3>

      {}
      <div className="flex flex-col gap-3">
        {items.map((item, index) => <a key={index} href={item.href} className="py-2 px-3 rounded related_link hover:bg-[#f2f2f2] dark:hover:bg-[#111827] flex items-center gap-3 group no-underline hover:no-underline border-b-0">
            {}
            <span className={`px-2 py-1 rounded-full text-xs font-semibold uppercase tracking-wide flex-shrink-0 ${getBadgeClass(item.badge)}`}>
              {item.badge}
            </span>

            {}
            <span className="text-base">{item.label}</span>
          </a>)}
      </div>
    </div>;
};

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

署名リクエストAPIを使用すると、署名リクエストの作成時に、あらかじめ定義されたBox Signテンプレートを使用できます。このテンプレートには、リクエストの作成時にデータが自動的に設定されるプレースホルダが含まれています。

## テンプレートの作成

まず、リクエストに必要となる`text`、`date`、`signature`フィールドを含むBox Signテンプレートを作成します。

詳細な手順については、[テンプレートに関するガイド][docuprep]を参照してください。

## テンプレートIDの取得

署名リクエストを送信するには、使用するテンプレートのIDを渡す必要があります。`template_id`を確認するには、テンプレートのリストを取得します。

```json theme={null}
"entries": [
  {
    "id": "6ae28666-03c4-4ac1-80db-06a90d3b1361",
    "name": "Contract.pdf",
    "parent_folder": {
      "id": "157064745449",
      "etag": "0",
      "type": "folder",
      "sequence_id": "0",
      "name": "My Sign Requests"
    },
    "source_files": [
      {
        "id": "1216382236853",
        "etag": "0",
        "type": "file",
        "sequence_id": "0",
        "sha1": "ca9c75cda0d5e3c3c9b0a1e6d42cb5e29a211ab6",
        "file_version": {
          "id": "1327286673653",
          "type": "file_version",
          "sha1": "ca9c75cda0d5e3c3c9b0a1e6d42cb5e29a211ab6"
        }
      }
    ],
    "signers": [
      {
        "email": "",
        "label": "reader",
        "public_id": "4Z8QZZV4",
        "role": "final_copy_reader",
        "is_in_person": false,
        "order": 1,
        "inputs": [...]
      },
      {
        "email": "",
        "label": "signer1",
        "public_id": "4Z8QZZV4",
        "role": "signer",
        "is_in_person": false,
        "order": 1,
        "inputs": [...]
      },
      {
        "email": "",
        "label": "signer2",
        "public_id": "13VK8794",
        "role": "signer",
        "is_in_person": false,
        "order": 1,
        "inputs": [
          {
            "document_tag_id": "signer2_full_name",
            "id": "da431975-55c5-4629-86ae-3fb12dda1386",
            "type": "text",
            "text_value": null,
            "is_required": true,
            "content_type": "full_name",
            ...
          },
          {
            "document_tag_id": null,
            "id": "b5a76a22-8d48-456e-a012-22a12fc91eb7",
            "type": "signature",
            ...
          },
          {
            "document_tag_id": null,
            "id": "7e0cc4ee-b878-4739-afde-acbf69b117b2",
            "type": "date",
            "date_value": null,
            ...
          }
        ],
      }
    ]
    ...
  }
]
```

レスポンスは以下のようになります (説明のため省略されています)。レスポンス全体の例については、<Link href="/reference/get-sign-templates#response-example">Box SignテンプレートAPI</Link>を参照してください。

また、具体的なパラメータの詳細については、<Link href="/reference/post-sign-requests">署名リクエストを作成</Link>ガイドで確認できます。

```json theme={null}
"entries": [
  {
    "id": "6ae28666-03c4-4ac1-80db-06a90d3b1361",
    "name": "Contract.pdf",
    "parent_folder": {
      "id": "157064745449",
      "etag": "0",
      "type": "folder",
      "sequence_id": "0",
      "name": "My Sign Requests"
    },
    "source_files": [
      {
        "id": "1216382236853",
        "etag": "0",
        "type": "file",
        "sequence_id": "0",
        "sha1": "ca9c75cda0d5e3c3c9b0a1e6d42cb5e29a211ab6",
        "file_version": {
          "id": "1327286673653",
          "type": "file_version",
          "sha1": "ca9c75cda0d5e3c3c9b0a1e6d42cb5e29a211ab6"
        }
      }
    ],
    "signers": [
      {
        "email": "",
        "label": "reader",
        "public_id": "4Z8QZZV4",
        "role": "final_copy_reader",
        "is_in_person": false,
        "order": 1,
        "inputs": [...]
      },
      {
        "email": "",
        "label": "signer1",
        "public_id": "4Z8QZZV4",
        "role": "signer",
        "is_in_person": false,
        "order": 1,
        "inputs": [...]
      },
      {
        "email": "",
        "label": "signer2",
        "public_id": "13VK8794",
        "role": "signer",
        "is_in_person": false,
        "order": 1,
        "inputs": [
          {
            "document_tag_id": "signer2_full_name",
            "id": "da431975-55c5-4629-86ae-3fb12dda1386",
            "type": "text",
            "text_value": null,
            "is_required": true,
            "content_type": "full_name",
            ...
          },
          {
            "document_tag_id": null,
            "id": "b5a76a22-8d48-456e-a012-22a12fc91eb7",
            "type": "signature",
            ...
          },
          {
            "document_tag_id": null,
            "id": "7e0cc4ee-b878-4739-afde-acbf69b117b2",
            "type": "date",
            "date_value": null,
            ...
          }
        ],
      }
    ]
    ...
  }
]
```

## 署名リクエストの作成

テンプレートを使用して<Link href="/reference/post-sign-requests">署名リクエストを作成</Link>するには、以下の手順に従います。

1. リクエスト本文で、`template_id`を指定します。

   ```json theme={null}
   {
     "template_id": "6ae28666-03c4-4ac1-80db-06a90d3b1361",
     "parent_folder": {
       "id": "123456789",
       "etag": "0",
       "type": "folder",
       "sequence_id": "0",
       "name": "My Sign Requests"
     },
     ...
   }
   ```

2. 署名者のメールアドレスと役割を追加します。

   ```json theme={null}
   {
     "template_id": "6ae28666-03c4-4ac1-80db-06a90d3b1361",
     "parent_folder": {
       "id": "157064745449",
       "etag": "0",
       "type": "folder",
       "sequence_id": "0",
       "name": "My Sign Requests"
     },
     "signers": [
       {
         "email": "signer1@sample.com",
         "role": "signer"
       },
       {
         "email": "signer2@sample.com",
         "role": "signer"
       }
     ]
   }
   ```

3. `prefill_tags`を追加してフィールドにデータを設定します。

   <Info>
     署名者の順序がテンプレートに表示されている順序と同じであることを確認してください。テンプレートで最初に`signer1`、次に`signer2`がある場合、`POST`リクエストでは、適切な署名者を割り当てるために同じにする必要があります。
   </Info>

   ```json theme={null}
   {
     "template_id": "6ae28666-03c4-4ac1-80db-06a90d3b1361",
     "parent_folder": {
       "id": "123456789000",
       "etag": "0",
       "type": "folder",
       "sequence_id": "0",
       "name": "My Sign Requests"
     },
     "signers": [
       {
         "email": "signer1@sample.com",
         "role": "signer"
       },
       {
         "email": "signer2@sample.com",
         "role": "signer"
       }
     ],
     "prefill_tags": [
       {
         "document_tag_id": "signer1_full_name",
         "text_value": "Aaron Levie"
       },
       {
         "document_tag_id": "signer2_full_name",
         "text_value": "Albert Einstein"
       }
     ]
   }
   ```

4. `POST`リクエストを送信します。レスポンスは以下のようになります。

   ```json theme={null}
   {
     "is_document_preparation_needed": false,
     ...
     "signers": [
       {
         "email": "reader@sample.com",
         "role": "final_copy_reader",
       },
       {
         "email": "signer1@sample.com",
         "role": "signer",
       },
       {
         "email": "signer2@sample.com",
         "role": "signer",
       }
     ],
     "id": "d02fefd2-15fa-431f-a127-2b4525616ae6",
     "prefill_tags": [
       {
         "document_tag_id": "signer1_full_name",
         "text_value": "Aaron Levie",
       },
       {
         "document_tag_id": "signer2_full_name",
         "text_value": "Albert Einstein",
       }
     ],
     "source_files": [],
     "parent_folder": {
       "id": "123456789000",
       "type": "folder",
       "name": "My Sign Requests"
     },
     "name": "Contract.pdf",
     "type": "sign-request",
     "status": "created",
     "sign_files": {
       "files": [
         {
           "id": "123456789",
           "type": "file",
           "name": "Contract.pdf",
         }
       ],
       "is_ready_for_download": true
     },
     "template_id": "6ae28666-03c4-4ac1-80db-06a90d3b1361"
   }
   ```

[docuprep]: https://support.box.com/hc/en-us/articles/4404094944915-Creating-templates

[parentfolder]: /guides/box-sign/create-sign-request#parent-folder

[signers]: /guides/box-sign/create-sign-request#signers

<RelatedLinks
  title="関連するAPI"
  items={[
{ label: translate("List Box Sign templates"), href: "/reference/get-sign-templates", badge: "GET" },
{ label: translate("Get Box Sign template by ID"), href: "/reference/get-sign-templates-id", badge: "GET" }
]}
/>

<RelatedLinks
  title="関連するガイド"
  items={[
{ label: translate("Create Box Sign Request"), href: "/guides/box-sign/create-sign-request", badge: "GUIDE" }
]}
/>