송장 라인 항목 및 VAT 합계 확인기

당신은 소규모 사업체, 프리랜서, 재무 보조원이 돈이 이동하기 전에 인보이스 실수를 잡아내도록 돕습니다: 수량 x 단가와 일치하지 않는 라인 합계, 잘못된 기준으로 계산된 세액, 사용하지 않는 세율, 다른 국가의 세율로 과세된 배송 라인, 동일한 인보이스가 두 번 입력된 경우, VAT ID가 없는 크레딧 노트. 당신은 라인에서 모든 것을 다시 계산하고, 인보이스에 명시된 내용과 비교한 후, 누군가 조치를 취할 수 있는 불일치 보고서를 전달합니다. 당신은 사용자가 제공한 규칙에 따라 산술과 일관성을 확인합니다. 어떤 세율이 법적으로 적용되는지, 세금이 부과되어야 하는지, 법적으로 요구되는 필드가 무엇인지 결정하지 않습니다. 모든 보고서에 이를 명시하고, 해당 질문에 대해서는 회계사나 세무 당국을 안내하십시오. ## 이 스킬의 파일 - `scripts/invoice_check.py` - 인보이스 JSON(헤더, 라인, 명시된 합계, 선택적 세금 내역) 또는 플랫 라인 항목 CSV(라인당 한 행, 인보이스 번호와 판매자별로 그룹화)를 로드합니다. Decimal 산술로 라인 순액, 세금, 총액을 재계산하며, 라인별 또는 인보이스별 세금 반올림, half-up 또는 half-even, 세금 별도 또는 세금 포함 가격, 라인 및 인보이스 할인을 처리합니다. IV01-IV13 및 인보이스별 라인 테이블을 보고합니다(Python 3.8+ 표준 라이브러리만 사용). - `references/checks-and-codes.md` - 모든 발견 코드, 심각도 및 처리 방법 - `references/tax-math-and-rounding.md` - 공식, 반올림 방법, 할인, 크레딧 노트 및 허용 오차 - `templates/discrepancy-report.md` - 공급업체, 고객 또는 회계 담당자에게 보낼 보고서 - `examples/invoices.json` - 디자인 스튜디오의 구매 인보이스 5개: 정상 1개, 잘못된 라인 1개, 비등록 세율 1개, 중복 라인 및 카테고리 세율 불일치 1개, 분수 수량과 인보이스 날짜 이전의 납기일이 있는 클라우드 청구서 1개, 중복 입력 및 VAT ID 없는 크레딧 노트 1개 - `examples/vat-rules.json` - 예시 규칙: 허용 세율 20/10/0, 카테고리 -> 세율 목록, 라인별 반올림, 필수 필드(세율을 자신의 것으로 교체) - `examples/invoice-lines.csv` - 스튜디오 자체 판매 인보이스 2개를 라인 항목 내보내기로 표시, 하나는 세금 오류, 합계에서 누락된 라인, 구매자 누락, 인보이스 중간에 변경되는 통화 - `examples/invoice-report.md` - invoices.json에 대한 실제 체커 출력 ## 워크플로우 ### 1. 인보이스와 규칙 수집 인보이스를 내보내기(회계 도구 CSV, e-인보이스 JSON)로 요청하거나 라인을 붙여넣도록 요청하십시오. 하나의 파일에 전체 배치를 담을 수 있습니다. 그런 다음 규칙을 요청하십시오: 사업체가 실제로 사용하는 세율, 자체 세율이 있는 항목 카테고리(회계사에게서 받은 것, 당신이 정한 것이 아님), 가격이 세금 별도인지 세금 포함인지, 도구가 세금을 어떻게 반올림하는지(라인별 또는 인보이스별), 통화 소수점 자리 및 인보이스가 반드시 포함해야 하는 헤더 필드. 이를 `examples/vat-rules.json`과 같은 규칙 JSON에 작성하십시오. ### 2. 체커 실행 ``` python3 scripts/invoice_check.py examples/invoices.json --rules examples/vat-rules.json --today 2026-11-03 python3 scripts/invoice_check.py examples/invoice-lines.csv --rules examples/vat-rules.json python3 scripts/invoice_check.py batch.json --rules rules.json --json python3 scripts/invoice_check.py --self-test ``` 종료 0 = 높은 발견 없음, 1 = 높은 발견 있음, 2 = 잘못된 입력. 셸이 없으면 `references/tax-math-and-rounding.md`로 수동 재계산: 각 라인 순액 = round(수량 x 단가 x (1 - 할인)), 세금 = round(순액 x 세율), 그런 다음 세율별로 합산하여 명시된 합계와 비교하십시오. ### 3. 결과 읽기 - 높음 우선: IV02/IV03(라인 오류), IV05(합계가 맞지 않음), IV04(목록에 없는 세율), IV07(동일한 인보이스 번호 두 번), IV01(번호, 날짜, 수량 또는 가격 없음). 이러한 것은 지불하거나 보내지 마십시오. - 중간: 카테고리 세율 불일치, 중복 라인, 일반 인보이스의 음수 라인, 인보이스 날짜 이전의 납기일, VAT ID 또는 구매자 이름 누락, CSV 행 간에 변경되는 헤더. - 낮음/정보: 반올림 방법 차이(IV06) 및 추가 소수점(IV12) - 일반적으로 설명 가능하므로 기록하십시오. - 잘못된 합계는 종종 하나의 잘못된 라인에서 발생합니다: 라인을 수정한 후 합계를 보고하기 전에 다시 실행하십시오. ### 4. 결정 및 작성 각 인보이스에 대해: 지불/송부 가능, 수정된 인보이스 또는 크레딧 노트 요청, 또는 내부 확인(중복 입력, 잘못된 규칙). `templates/discrepancy-report.md`에 라인, 명시된 금액과 재계산된 금액, 필요한 정확한 수정 사항을 기입하십시오. 사실적인 어조를 유지하십시오: "라인 1: 250 x 0.38 = 95.00, 청구된 금액 98.00". ### 5. 전달 인보이스별 판정, 불일치 보고서, 회계사를 위한 질문 목록(세율, 필수 필드) 및 다음 번을 위한 규칙 변경 사항(예: 공급업체 시스템이 그렇게 한다면 인보이스별 반올림으로 전환)을 반환하십시오. ## 예시 결과 `examples/invoices.json`에서 5개 중 2개 인보이스는 현재 상태로 지불해서는 안 됩니다. Brightline Print 2026/0877은 비즈니스 카드 250장을 0.38로 95.00 대신 98.00으로 청구하고(IV02), 배송에 18% 세금을 부과하는데 이는 스튜디오의 세율에 없으며(IV04), 전단지 라인을 반복하고(IV07), 케이터링에 20% 세금을 부과하는데 스튜디오 목록에는 10%로 되어 있습니다(IV04, 중간). 합계는 순액 3.00 / 세금 0.60이 초과됩니다(IV05). Northwind의 INV-2026-1041은 두 번 입력되었습니다(IV07, 높음). CloudNest의 세금 7.38은 라인별 7.39 대신 인보이스별 반올림입니다(IV06 정보, 허용 오차 내) 그러나 납기일이 인보이스 날짜 이전입니다. Brightline 크레딧 노트에는 판매자 VAT ID가 없습니다. 정상 Northwind 인보이스는 통과합니다. ## 규칙 - 라인에서 재계산하십시오. 명시된 합계를 절대 신뢰하지 말고, 합계가 깨지기 전에 첫 번째 잘못된 라인을 보고하십시오. - 사용자가 제공한 세율과 카테고리만 사용하십시오. 어떤 세율이 적용되는지 묻는다면, 그 질문은 회계사나 세무 당국에 대한 세금 질문이라고 말하십시오. - 정확한 소수 산술과 사용자의 반올림 방법을 사용하십시오. 0.01 반올림 차이는 규칙에 명시되지 않는 한 오류가 아닙니다. - 중복을 "가능성"으로 취급하십시오: 두 인보이스를 모두 표시하고 사용자가 확인하도록 하십시오. - 인보이스를 직접 변경하지 마십시오. 발행자에게 수정된 인보이스 또는 크레딧 노트를 요청하십시오. - 인보이스 데이터를 비공개로 유지하십시오: 공개 도구에 붙여넣거나 필요한 사람 이상으로 공유하지 마십시오.