사용자 가이드인보이스 발행

인보이스 발행

VAT 계산, PDF 생성 및 Stripe 결제를 통해 여러 통화로 인보이스를 생성, 전송 및 추적할 수 있습니다.

인보이스 생성, 보내기, 추적

NomadBill 인보이스 발행을 사용하여 전문 인보이스를 생성하고, VAT를 계산하고, 브랜드 PDF를 내보내고, 이메일로 인보이스를 보내고, Stripe를 통해 온라인 결제를 수락하세요. 초안 및 전송된 인보이스를 관리하고, 결제 진행 상황을 추적하고, 회사 전체에서 인보이스 번호를 일관되게 유지할 수 있습니다.

승인된 견적에서 시작하는 경우 견적에 설명된 견적-인보이스 흐름을 사용하세요.

인보이스 상태

NomadBill은 status 및 payment_status라는 두 개의 개별 필드를 사용하여 인보이스를 추적합니다. 인보이스 배지는 결제 정보에 우선순위를 두므로 payment_status가 paid인 경우 일반 status 필드에 다른 내용이 표시되더라도 인보이스는 결제된 것으로 표시됩니다.

필드가치의미
statusdraft, sent, paid, overdue문서 생명주기 상태
payment_statusunpaid, pending, paid, failed결제 처리 상태

이것을 읽는 실용적인 방법은 다음과 같습니다.

  • draft — 아직 인보이스를 편집 중이며 전송이 완료되지 않았습니다.
  • sent — 인보이스가 배송되었거나 전송된 것으로 표시되었습니다.
  • overdue — 만기일이 지났으나 청구서가 아직 정산되지 않았습니다.
  • paid — 인보이스가 정산되었습니다.

결제 관련 상태는 다음과 같습니다.

  • unpaid — 아직 결제가 기록되지 않았습니다.
  • pending — 결제가 진행 중입니다.
  • paid — 결제가 성공적으로 완료되었습니다.
  • failed — 결제 시도가 완료되지 않았습니다.

인보이스 UI에 paid가 표시되면 해당 유료 상태가 배지 표시에 대한 일반 문서 상태보다 우선합니다.

인보이스 만들기

인보이스 영역에서 새 인보이스를 생성하고, 고객 및 청구 세부 정보를 완료하고, 개별 항목을 추가한 다음, 보내기 전에 결과를 검토하세요. NomadBill은 완료되지 않은 인보이스를 초안으로 보관하므로 나중에 다시 확인할 수 있습니다.

새 인보이스 열기

인보이스로 이동하여 새 인보이스를 생성하세요. NomadBill은 현재 회사에 맞게 문서를 준비하고 인보이스가 생성될 때 번호를 지정합니다.

인보이스가 열리면 편집 가능한 청구 필드, 항목, 합계 및 문서 설정이 표시됩니다.

고객 및 청구 세부정보 추가

고객 정보, 인보이스 날짜, 만기일, 통화 및 언어를 입력합니다. PDF 및 이메일의 라벨이 올바르게 표시되도록 수신자와 일치하는 인보이스 언어를 선택하십시오.

저장한 후 인보이스는 보내거나 달리 표시할 때까지 draft 상태로 유지됩니다.

품목 추가

각 제품이나 서비스를 이름, 수량, 단가가 포함된 별도의 품목으로 추가하세요. 범위, 청구 기간 또는 결과물을 명확히 해야 할 경우 설명을 포함하세요.

항목을 추가하거나 편집하면 소계가 업데이트됩니다.

VAT 및 합계 검토

인보이스를 보내기 전에 VAT 비율을 확인하세요. NomadBill은 소계와 VAT 백분율로 합계를 계산하므로 PDF 또는 결제 링크를 생성하기 전에 금액을 확인할 수 있습니다.

올바른 검토 단계를 수행하면 명확한 소계, VAT 금액 및 최종 합계가 제공됩니다.

결제 내보내기, 보내기 또는 수령

인보이스가 정확해 보이면 PDF를 생성하여 이메일로 보내거나 고객이 온라인으로 결제하도록 하려면 Stripe 체크아웃을 활성화하세요. 전송 후 NomadBill은 인보이스를 받은 사람, 언제 전송되었는지 등 전송 세부정보를 기록할 수 있습니다.

이 시점에서 인보이스는 편집에서 활성 추적으로 전환됩니다.

품목

각 인보이스 개별 항목은 작고 일관된 구조를 저장하므로 요금을 명확하고 예측 가능하게 유지할 수 있습니다. 품목에는 다음이 포함됩니다.

  • id — 선택적 내부 식별자
  • name — 품목 제목
  • description — 선택적 세부 텍스트
  • quantity — 청구 단위 수
  • price — 단위당 가격

청구 가능한 서비스, 제품 또는 청구 기간당 하나의 항목을 사용하십시오. 이렇게 하면 PDF를 더 쉽게 읽을 수 있고 고객이 전체 구성 방법을 이해하는 데 도움이 됩니다.

NomadBill은 품목에 대한 드래그 앤 드롭 재정렬도 지원합니다. 핵심 서비스를 먼저 나열하고 환급 비용을 마지막에 나열하는 등 청구서에 전달하려는 내용과 일치하도록 항목을 재정렬하세요.

VAT 계산

NomadBill은 소계와 VAT 백분율로 인보이스 합계를 계산합니다. 공식은 다음과 같습니다.

total = subtotal + (subtotal x vat_percentage / 100)

기본 VAT 요율은 표준 독일 요율과 일치하는 **19%**입니다. 값이 0~100의 허용 범위 내에 있는 한 필요에 따라 인보이스당 VAT 백분율을 변경할 수 있습니다.

이는 다음을 의미합니다.

  • **0**는 VAT 면제 또는 0등급 인보이스에 유효합니다.
  • **19**는 기본 시작점입니다.
  • **100**는 허용되는 상한입니다.

인보이스를 보내기 전에 VAT 세율을 확인하세요. 특히 여러 관할권에 걸쳐 청구하거나 혼합 세금 처리를 사용하는 경우 더욱 그렇습니다.

통화 및 언어

NomadBill은 5가지 인보이스 통화와 4가지 인보이스 언어를 지원합니다. 이러한 값은 적용되므로 인보이스는 항상 지원되는 옵션 중 하나를 사용합니다.

지원되는 통화

  • EUR
  • USD
  • GBP
  • CHF
  • AED

지원되는 인보이스 언어

  • DE
  • EN
  • FR
  • ES

기본 통화 선택 방법

NomadBill은 다음 순서로 인보이스 통화를 해결합니다.

  1. 인보이스 통화 — 인보이스에 이미 통화가 있는 경우 해당 값이 사용됩니다.
  2. 회사 기본 통화 — 인보이스에 명시적인 통화가 없는 경우 NomadBill은 회사 기본값을 확인합니다.
  3. 글로벌 통화 기본 설정 — 처음 두 가지 중 어느 것도 존재하지 않으면 NomadBill은 로컬 브라우저 저장소에 nb.currency로 저장된 글로벌 통화로 대체됩니다.

이 우선순위는 기존 인보이스를 안정적으로 유지하는 동시에 회사 전체 및 사용자 수준 대체를 제공합니다.

인보이스 번호 매기기

인보이스 번호는 R-00001 형식을 사용합니다. R 접두사는 문서 유형을 식별하며 숫자 부분은 앞에 0이 붙은 5자리 숫자를 사용합니다.

NomadBill은 각 회사에 대해 원자적으로 다음 문서 번호를 할당하는 데이터베이스 기능을 통해 번호를 생성합니다. 여러 사람이 동시에 인보이스를 생성하는 경우에는 순서가 경쟁 조건으로부터 안전하게 유지되므로 중요합니다.

일상적인 사용에는 두 가지 세부 사항이 중요합니다.

  • 인보이스 번호는 회사별로 관리되며 모든 계정에서 전역으로 공유되지 않습니다.
  • 각 인보이스 번호는 company_id 및 invoice_number 조합을 통해 동일한 회사 내에서 고유해야 합니다.

PDF 생성

NomadBill은 다운로드, 공유 또는 이메일 전달을 위해 인보이스를 PDF 문서로 내보낼 수 있습니다. PDF 엔진은 회사 브랜딩과 함께 표준 인보이스 데이터를 사용하여 완성된 문서를 생성합니다.

생성된 PDF는 A4 세로 방향 레이아웃과 15 mm 여백을 사용하며 다음을 포함할 수 있습니다.

  • 회사 로고
  • 브랜드 색상
  • 품목 테이블
  • 총계 블록
  • 은행 세부정보
  • 보행인

PDF 출력은 4개의 인보이스 언어도 모두 지원하므로 라벨은 인보이스에서 선택한 언어로 표시됩니다. 사용자 정의 PDF 레이아웃을 사용하는 경우 NomadBill은 템플릿 기반 렌더링도 지원합니다.

이메일로 인보이스 보내기

NomadBill은 noreply@nomadbill.co를 보낸 사람 주소로 사용하여 Resend를 통해 인보이스 이메일을 보냅니다. HTML 콘텐츠와 선택적 PDF 첨부 파일이 포함된 문서 이메일을 보내거나 데이터베이스에 배달 세부 정보를 기록하는 요약 스타일 이메일을 보낼 수 있습니다.

인보이스 요약 이메일을 보내면 NomadBill은 다음 추적 필드를 업데이트합니다.

  • sent_at — 인보이스가 전송된 날짜
  • sent_to — 인보이스가 전송된 수신자 주소
  • email_status — sent로 설정

이메일 콘텐츠에는 다음이 포함될 수 있습니다.

  • 문서 번호
  • 고객 이름
  • 선택적인 맞춤 메시지
  • 총액

이를 통해 아웃바운드 배송과 인보이스 기록 내부의 기본 감사 추적이 모두 제공됩니다.

Stripe로 결제 수락

고객이 호스팅된 결제 페이지를 통해 결제하도록 하려면 인보이스에서 Stripe를 활성화하세요. NomadBill은 인보이스에 대한 Stripe 결제 세션을 생성하고 고객을 Stripe로 보내 결제를 완료합니다.

Stripe 흐름의 작동 방식

인보이스에 대해 Stripe를 활성화합니다.

인보이스에 대해 Stripe를 켜면 stripe_enabled가 활성화됩니다. 이는 인보이스가 온라인 결제에 적합한 것으로 표시됩니다.

활성화되면 인보이스에서 호스팅된 결제 세션을 생성할 수 있습니다.

결제 세션 생성

NomadBill은 인보이스 총액에서 Stripe 체크아웃 세션을 생성합니다. Stripe로 전송된 금액은 Math.round(total_amount * 100)를 사용하여 센트로 변환되고, Stripe API의 경우 통화 코드가 소문자로 변환됩니다.

이렇게 하면 Stripe가 예상한 형식으로 금액을 받을 수 있습니다.

고객을 Stripe로 리디렉션

안전하게 결제를 완료하기 위해 고객은 Stripe가 호스팅하는 결제 페이지로 리디렉션됩니다. 청구서 페이지 내에서 직접 카드 세부정보를 수집할 필요는 없습니다.

리디렉션이 성공하면 고객이 이제 Stripe에서 결제를 완료하고 있음을 의미합니다.

성공 또는 취소 처리

결제 후 Stripe는 고객을 다음 두 가지 인보이스 경로 중 하나로 돌려보냅니다.

  • 성공: /invoices/$id/pay/success
  • 취소: /invoices/$id/pay/cancel

성공 페이지에서는 결제를 확인하고 구매 추적을 시작합니다. 취소 페이지를 통해 고객은 다시 시도할 수 있습니다.

웹훅 확인 후 인보이스 업데이트

Stripe가 checkout.session.completed 웹후크 이벤트를 보내면 NomadBill은 인보이스를 payment_status=paid 및 status=paid로 업데이트합니다.

이 웹훅 업데이트는 NomadBill 내부의 유료 상태를 마무리합니다.

반복 인보이스

반복 인보이스를 사용하면 인보이스를 반복 청구 패턴의 일부로 표시할 수 있습니다. NomadBill은 이를 is_recurring 플래그 및 recurring_frequency 값과 함께 저장합니다.

지원되는 반복 빈도는 다음과 같습니다.

  • weekly
  • monthly
  • quarterly
  • yearly

반복 청구서는 메타데이터일 뿐입니다. NomadBill은 자동 크론 작업을 실행하지 않으며 이 플래그만으로는 일정에 따라 새 인보이스를 생성하지 않습니다.

반복 설정을 사용하여 반복 청구에 라벨을 지정하고 구성하지만 자동화된 구독 엔진으로 의존하지 마십시오.

다음 단계