문서

시작하기

플레이스홀더 채우기

먼저 템플릿을 읽으세요. 템플릿 엔드포인트의 플레이스홀더와 그룹이 values의 전체 계약입니다. 그런 다음 플레이스홀더 키로 색인된 객체로 values를 보냅니다.

  • 키는 돌려받은 그대로의 플레이스홀더 키이며, 라벨 문구나 현재 채워진 텍스트가 아닙니다(키가 생기기 전에 작성된 호출자를 위해 라벨도 여전히 허용됩니다). 문서의 여러 곳에 쓰인 플레이스홀더는 한 번에 모두 채워집니다.
  • 생략한 키는 템플릿의 기본값을 유지합니다. 빈 문자열은 플레이스홀더를 비웁니다.
  • select 플레이스홀더는 옵션 중 정확히 하나 또는 빈 문자열을 받습니다.
  • 숫자 플레이스홀더는 1234.56 같은 숫자 문자열을 두 가지 소수 표기 방식 모두 받습니다. 서버가 템플릿에 선언된 형식으로 다시 쓰므로, 형식이 그렇게 지정된 곳에서는 1234.56이 1,234.56으로 들어갑니다.
  • 날짜 플레이스홀더는 다시 쓰지 않습니다. 형식이 보여 주는 대로 이미 쓰인 날짜를 보내세요. 형식은 기준 날짜인 2026년 8월 27일을 기대하는 방식으로 쓴 것이므로, 형식이 08/27/2026이면 10/15/2026을 원합니다.
  • auto로 표시된 플레이스홀더는 생성 시 PaperClerk가 채웁니다(오늘 날짜 또는 다음 자동 번호). 이에 대해 보낸 값은 무시됩니다.
  • 반복 그룹은 그룹의 필드 키로 색인된 인스턴스 객체 배열을 받으며, 템플릿의 행이 항목마다 복제됩니다. 생략한 그룹은 작성된 한 행을 유지하고, 빈 배열은 해당 섹션을 제거합니다. 필드 값은 최상위 플레이스홀더와 똑같이 검증됩니다.
  • 플레이스홀더에 description이 있으면 그것은 기대하는 값(원하는 형식이나 내용 등)에 대한 템플릿 작성자의 도움말입니다. 문서에는 인쇄되지 않습니다.

송장 템플릿용 values 객체

JSON
{
  "client_name": "Maple & Fern Ltd.",
  "payment_terms": "Net 15",
  "due_date": "10/15/2026",
  "line_items": [
    { "item": "Brand identity system", "quantity": "1", "amount": "4800" },
    { "item": "Brand guidelines document", "quantity": "1", "amount": "1200" }
  ]
}