課題
ペルーで電子証憑(電子発行の請求書や領収書)を発行するには、SUNAT(ペルー国税庁)が定める形式でXMLファイルを生成し、電子証明書で署名して送信したうえで、応答の受領記録を保管する必要があります。小規模事業者にとっては、手作業でフォームに入力するか、外部のサービス事業者に頼るのが一般的です。
ソリューション
Ebisuは、電子インボイス機能を組み込んだPOS(販売時点情報管理)システムです。レジ担当者は販売内容を入力し、支払方法を選んで、簡易領収書(boleta)、請求書(factura)、または証憑なしのいずれかを選択します。請求書の場合は、納税者番号(RUC)から顧客情報が自動で入力されます。証憑はPDF、またはQRコード付きの80 mmレシートとして出力されます。
ブラウザで動作し、パソコンでもスマートフォンでも使えます。スマートフォンでは、画面幅320 pxまでレイアウトが対応し、下部ナビゲーションで操作できます。
ランディングページ
製品紹介のためにebisu.gabvmon.com(スペイン語)を公開しました。技術者ではなく、個人商店・小売店・飲食店の経営者に向けたページです。スクリーンショットの代わりに、店舗が毎日目にする画面をHTMLのモックアップで示しています。SUNATに受理された領収書付きの販売、レジ締め、厨房への注文、在庫です。3ステップの導入手順と料金(月額S/ 50から、導入設定と研修込み)を説明し、すべてのCTA(行動喚起)ボタンから定型文入りのWhatsAppが開きます。利用規約、プライバシーポリシー、ペルーで義務付けられている苦情受付簿(Libro de Reclamaciones)も掲載しています。

アーキテクチャ
Webアプリ(Next.js)→ API(NestJS)→ PostgreSQL → 送信キュー → SUNAT
顧客ごとに専用のインストール環境とデータベースを用意しています。中央の管理パネルで各環境を管理しますが、どの顧客の業務データにも触れません。
技術的な判断
- 仲介業者を通さず、SUNATに直接接続。 UBL 2.1形式のXMLを生成し、署名(XMLDSig RSA-SHA256)し、送信前に34種類の公式XSDスキーマで検証し、SUNATの応答記録(CDR)を読み取るモジュールを自作しました。請求書、日次サマリーで送信する簡易領収書、クレジットノート・デビットノート、取消通知、送り状(guía de remisión)に対応しています。
- 障害に強いキュー。 SUNATが応答しない場合は数時間にわたって送信を再試行し、停止したジョブも回復させます。サーバーを再起動しても何も失われません。日次サマリーは500行ごとに分割し、電子証明書の有効期限が近づくと事前に通知します。
- 二重請求や番号の重複を防止。 証憑の発行中は販売データをロックし、1件の販売に対してメインの証憑は1件のみとしています。シリーズの次の連番はアトミックに取得します。割り勘の会計を2台の端末から支払っても二重に請求されることはなく、販売の取消はSUNATが取消を受理した時点で初めて確定します。
- 顧客ごとの分離。 全顧客で1つのデータベースを共有するのではなく、顧客ごとに完全なデプロイ環境(Docker Compose)を用意しています。中央パネルとの通信には署名付きの設定とライセンスを使い、リプレイ攻撃への対策も施しています。
成果
複数の顧客のもとで本番稼働中です。コードベースには1,400件を超える自動テストがあり、継続的インテグレーション(CI)では模擬SUNATに対してテストを実行しています。
