# Denpyo Japan Invoice & Receipt Reader API

> Denpyo Japan Invoice & Receipt Reader API is a paid API for AI agents from denpyo-api.hp-vladic.workers.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-14).

Extracts structured accounting data from Japanese invoices and receipts (請求書/領収書) and verifies the qualified-invoice registration number (T番号) against the National Tax Agency registry in a single call

## Facts

- Endpoint: POST https://denpyo-api.hp-vladic.workers.dev/read/invoice
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/denpyo-japan-invoice-receipt-reader-api-7ce1e751
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CxCnZcEP83idad5bLvcBd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability denpyo-japan-invoice-receipt-reader-api-7ce1e751 -d '<json body>'
```

Example prompt: Read this Japanese invoice PDF, pull out the vendor name, all line items, the 8% and 10% consumption tax breakdown, and check whether the T番号 on it is actually registered and active with the National Tax Agency.

## When to prefer this

Choose this endpoint when you need both OCR-based extraction of Japanese invoice/receipt data AND real-time NTA registry verification of the qualified-invoice number in a single call. It is purpose-built for Japan's インボイス制度 (qualified invoice system), handles the 8%/10% dual consumption-tax rate split natively, and requires no API key or subscription — ideal for per-transaction AP automation, fraud screening before payment, or expense processing pipelines that must comply with Japanese tax law.

## Known failure modes

- Unreadable or low-quality image results in failed extraction
- T番号 not present on document — qualifiedInvoice block absent or unverified
- NTA registry lookup fails if number is malformed or checksum invalid
- Non-Japanese invoice submitted — parsing may be incomplete or incorrect
- Payment failure via x402 results in 402 response before processing begins
- Multi-page documents may return partial results if page limit exceeded

## How this service works

OCR a Japanese invoice (請求書) into JSON — vendor, line items, 8%/10% consumption-tax (消費税) breakdown — and verify the qualified-invoice registration number (適格請求書 インボイス登録番号 / T番号, T+13 digits) against Japan's National Tax Agency (国税庁) registry in one call: qualified/cancelled, registered-name match, corporate record (法人番号). Pre-payment 経理/AP check. POST {url|base64} (PDF/JPEG/PNG). First 2 pages. Failed analyses not charged.

## Output

A JSON object containing: document type (invoice/receipt), vendor details (name, address, phone, registration number), customer name, invoice metadata (ID, issue date, due date), line items (description, quantity, unit price, amount, tax rate), amounts (subtotal, tax, total, currency, per-rate tax breakdown), and a qualifiedInvoice block with NTA verification result (active/cancelled status, name match, corporate registry record, checksum validity, registration/cancellation dates, and verdict).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Public http(s) URL of a PDF/JPEG/PNG/TIFF/HEIF document"
  },
  "base64": {
   "type": "string",
   "description": "Base64-encoded document bytes (alternative to url), max ~8MB"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "amount": 30000,
    "taxRate": 10,
    "quantity": 2,
    "unitPrice": 15000,
    "description": "純正部品 ブレーキパッドセット"
   }
  ],
  "vendor": {
   "name": "トヨタ自動車株式会社",
   "phone": "0565-28-2121",
   "address": "〒471-8571 愛知県豊田市トヨタ町1番地",
   "registrationNumber": "T1180301018771"
  },
  "amounts": {
   "tax": 5400,
   "total": 60180,
   "currency": "JPY",
   "subtotal": 55000,
   "taxBreakdown": [
    {
     "tax": 5000,
     "rate": 10,
     "taxableAmount": 50000
    },
    {
     "tax": 400,
     "rate": 8,
     "taxableAmount": 5000
    }
   ]
  },
  "docType": "invoice",
  "invoice": {
   "id": "INV-2026-0712",
   "dueDate": "2026-08-31",
   "issueDate": "2026-07-10"
  },
  "customer": {
   "name": "株式会社テスト工業"
  },
  "pagesProcessed": 1,
  "qualifiedInvoice": {
   "entity": "corporation",
   "status": "active",
   "company": {
    "kind": {
     "en": "Kabushiki Kaisha (stock company)",
     "ja": "株式会社"
    },
    "name": "トヨタ自動車株式会社",
    "status": "active",
    "address": {
     "city": "豊田市",
     "street": "トヨタ町1番地",
     "postCode": "4718571",
     "prefecture": "愛知県"
    },
    "closeDate": null,
    "corporateNumber": "1180301018771"
   },
   "verdict": "qualified",
   "nameMatch": true,
   "cancelDate": null,
   "registered": true,
   "checksumValid": true,
   "checkedAgainst": "2026-06-30",
   "registeredName": "トヨタ自動車株式会社",
   "corporateNumber": "1180301018771",
   "registrationDate": "2023-10-01",
   "registrationNumber": "T1180301018771"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/denpyo-japan-invoice-receipt-reader-api-7ce1e751/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from denpyo-api.hp-vladic.workers.dev](https://www.zero.xyz/host/denpyo-api.hp-vladic.workers.dev/llms.txt)