extract-ryoshusho-data

Extract Ryoshusho Data

Finance teams use this recipe to extract ryoshusho fields into structured receipt records for reimbursement, consumption-tax checks, and accounting workflows.

APIs Used

Document Extraction (1 credit per page)

Prerequisites

You need an Iteration Layer API key. Get one at platform.iterationlayer.com during the 7-day trial.

For full integration guidance (SDKs, auth, MCP, error handling), see the Iteration Layer Integration Guide.

Implementation

curl -X POST https://api.iterationlayer.com/document-extraction/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "files": [
    {
      "type": "url",
      "name": "ryoshusho.pdf",
      "url": "https://example.com/documents/ryoshusho-sample.pdf"
    }
  ],
  "schema": {
    "fields": [
      {
        "name": "receipt_number",
        "type": "TEXT",
        "description": "Receipt number"
      },
      {
        "name": "issuer_name",
        "type": "TEXT",
        "description": "Issuer or merchant name"
      },
      {
        "name": "issuer_address",
        "type": "ADDRESS",
        "description": "Issuer address"
      },
      {
        "name": "issuer_registration_number",
        "type": "TEXT",
        "description": "Qualified invoice issuer registration number if shown"
      },
      {
        "name": "payer_name",
        "type": "TEXT",
        "description": "Payer or recipient name"
      },
      {
        "name": "receipt_date",
        "type": "DATE",
        "description": "Receipt date"
      },
      {
        "name": "payment_method",
        "type": "TEXT",
        "description": "Payment method"
      },
      {
        "name": "items",
        "type": "ARRAY",
        "description": "Purchased goods or services",
        "fields": [
          {
            "name": "description",
            "type": "TEXT",
            "description": "Item or service description"
          },
          {
            "name": "amount",
            "type": "CURRENCY_AMOUNT",
            "description": "Line amount"
          }
        ]
      },
      {
        "name": "consumption_tax",
        "type": "CURRENCY_AMOUNT",
        "description": "Consumption tax amount"
      },
      {
        "name": "total_amount",
        "type": "CURRENCY_AMOUNT",
        "description": "Total amount paid"
      },
      {
        "name": "currency",
        "type": "CURRENCY_CODE",
        "description": "Currency code"
      }
    ]
  }
}'