extract-zatca-e-invoice-data

Extract ZATCA E-Invoice Data

Finance teams use this recipe to extract ZATCA E-Invoice fields into structured JSON for accounts receivable, accounts payable, tax, and ERP 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": "zatca-e-invoice.pdf",
      "url": "https://example.com/documents/zatca-e-invoice-sample.pdf"
    }
  ],
  "schema": {
    "fields": [
      {
        "name": "seller_name",
        "type": "TEXT",
        "description": "Seller, supplier, or issuer name"
      },
      {
        "name": "buyer_name",
        "type": "TEXT",
        "description": "Buyer, customer, or recipient name"
      },
      {
        "name": "document_number",
        "type": "TEXT",
        "description": "Invoice or fiscal document number"
      },
      {
        "name": "issue_date",
        "type": "DATE",
        "description": "Issue date"
      },
      {
        "name": "line_items",
        "type": "ARRAY",
        "description": "Line items, services, or taxable supplies",
        "fields": [
          {
            "name": "description",
            "type": "TEXT",
            "description": "Item or service description"
          },
          {
            "name": "quantity",
            "type": "DECIMAL",
            "description": "Quantity"
          },
          {
            "name": "unit_price",
            "type": "CURRENCY_AMOUNT",
            "description": "Unit price"
          },
          {
            "name": "line_total",
            "type": "CURRENCY_AMOUNT",
            "description": "Line total"
          }
        ]
      },
      {
        "name": "tax_amount",
        "type": "CURRENCY_AMOUNT",
        "description": "Tax amount"
      },
      {
        "name": "total_amount",
        "type": "CURRENCY_AMOUNT",
        "description": "Total payable amount"
      },
      {
        "name": "currency",
        "type": "CURRENCY_CODE",
        "description": "Currency code"
      }
    ]
  }
}'