ADP Global Invoice Extraction · Free API

办公效率

限时免费技能，由 Laiye ADP 团队推出，精准识别并提取全球 100 多种语言的发票和收据信息。

文档处理 PDF 处理

196

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

ADP Global Invoice Extraction Free Skill#

Powered by the Laiye ADP Team (Agentic Document Processing), this skill enables intelligent, high-precision parsing and data extraction for invoices, bills and vouchers across the globe, whether standard or unstructured. It works seamlessly with electronic PDFs, scanned files and images, and returns standardized structured JSON data to facilitate business workflow integration and downstream automation.

📄 Quick Start Guide#

Step 1: Select Base URL#

We offer dedicated public cloud access endpoints for domestic and international users, with separate regional configurations. Connecting to the nearest node ensures fast and stable network calls. No account registration or API Key is required — you may send requests directly to the endpoints listed below.

EnvironmentAPI EndpointGlobalhttps://adp-global.laiye.com/public/v1/invoice-fast/extractChinahttps://adp.laiye.com/public/v1/invoice-fast/extract

Step 2: Send Request#

Choose one file transfer method and send a POST request:

Method 1: File URL

bash

curl -X POST "https://adp-global.laiye.com/public/v1/invoice-fast/extract" \
  -H "Content-Type: application/json" \
  -d '{
    "file_url": "shturl.cc/vZd6rD9NxsmfNZPF5KjsnB78s"
  }'

Method 2: Base64 Encoded File Content

bash

curl -X POST "https://adp-global.laiye.com/public/v1/invoice-fast/extract" \
  -H "Content-Type: application/json" \
  -d '{
    "file_base64": "<base64-encoded-file-content>"
  }'

Request Example in Python:

python

import base64, requests

with open("invoice.pdf", "rb") as f:
    b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://adp-global.laiye.com/public/v1/invoice-fast/extract",
    json={"file_base64": b64},
    timeout=180,
)
print(response.json())

Step 3: Result Example#

FieldTypeDescriptionsuccessbooleanRequest statusdoc_typestringIdentified document type: invoice or receipt``extraction_resultarrayList of extracted fields and valuesaigcobjectMetadata about the AIGC processing, including labels, producer info, and processing typesupgrade_messagestringMessage prompting users to register for enhanced featuressignup_urlstringURL for user registration to unlock full featuresjson

{
    "success": true,
    "doc_type": "invoice",
    "extraction_result": [
        {
            "field_key": "invoice_number",
            "field_name": "Invoice Number",
            "field_values": [
                {
                    "field_value": "09071666",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "09071666"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "invoice_date",
            "field_name": "Invoice Date",
            "field_values": [
                {
                    "field_value": "2019-11-28",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "2019-11-28"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "supplier_name",
            "field_name": "Supplier Name",
            "field_values": [
                {
                    "field_value": "Beijing******Company",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "Beijing******Company"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "supplier_vat_number",
            "field_name": "Supplier VAT Number",
            "field_values": [
                {
                    "field_value": "9111******4393T",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "9111******4393T"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "customer_name",
            "field_name": "Customer Name",
            "field_values": [
                {
                    "field_value": "Hunan******Company",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "Hunan******Company"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "currency",
            "field_name": "Currency",
            "field_values": [
                {
                    "field_value": "CNY",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "CNY"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "total_amount",
            "field_name": "Total Amount (Tax Included)",
            "field_values": [
                {
                    "field_value": "¥1600.00",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "¥1600.00"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "line_items",
            "field_name": "Line Items",
            "table_values": [
                [
                    {
                        "field_key": "line_items_item_code",
                        "field_name": "Item Code",
                        "field_values": [
                            {
                                "field_value": "",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": ""
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_description",
                        "field_name": "Description",
                        "field_values": [
                            {
                                "field_value": "Accommodation Service*Accommodation Service",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "*Accommodation Service*Accommodation Service"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_quantity",
                        "field_name": "Quantity",
                        "field_values": [
                            {
                                "field_value": "2",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "2"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_unit_price",
                        "field_name": "Unit Price",
                        "field_values": [
                            {
                                "field_value": "754.716981132",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "754.716981132"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_total_amount",
                        "field_name": "Total Amount",
                        "field_values": [
                            {
                                "field_value": "1509.43",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "1509.43"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_rate",
                        "field_name": "tax rate",
                        "field_values": [
                            {
                                "field_value": "6%",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "6%"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_tax",
                        "field_name": "tax",
                        "field_values": [
                            {
                                "field_value": "90.57",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "90.57"
                                    }
                                ]
                            }
                        ]
                    }
                ]
            ]
        }
    ],
    "aigc": {
        "Label": "AIGCLabelType.AI_GENERATED",
        "ContentProducer": "001191110108587659081E10001",
        "ProduceID": "e3563f165b4011f19f02d85ed35661fd",
        "ReservedCode1": "34c55657beb0071fecf8abce14b0cdee",
        "ContentPropagator": "001191110108587659081E10001",
        "PropagateID": "e3563f165b4011f19f02d85ed35661fd",
        "ReservedCode2": "34c55657beb0071fecf8abce14b0cdee",
        "ProcessingTypes": [
            "ocr",
            "llm_extract"
        ]
    },
    "upgrade_message": "Sign up to get 100 credits per month and unlock all features, including multi-tier tax calculation, self-evolving recognition capabilities, expanded fields and enhanced performance.",
    "signup_url": "https://adp.laiye.com/"
}

📄 Extraction Field Reference#

Text Fields#

field_keyfield_name (example)Descriptioninvoice_numberInvoice NumberUnique identifier of the invoice.invoice_dateInvoice DateDate when the invoice was issued.supplier_nameSupplier NameName of the issuing supplier.supplier_vat_numberSupplier VAT NumberVAT registration number of the supplier.customer_nameCustomer NameName of the billed customer.currencyCurrencyCurrency code of the invoice (e.g., USD, EUR).total_amount_inc_taxTotal Amount (Inc. Tax)Total invoice amount including tax.

Table Fields#

field_keyfield_name (example)Descriptionitem_codeItem CodeCode/SKU of the line item.descriptionDescriptionDescription of the line item.quantityQuantityQuantity of the line item.unit_priceUnit PriceUnit price of the line item.total_amountTotal AmountTotal amount of the line item.tax_rateTax RateApplicable tax rate for the item (full coverage).tax_amountTax AmountTax amount for the line item (full coverage).

Common Field Structure#

FieldTypeDescriptionfield_keystringField identifierfield_namestringField namefield_valuesarrayList of extracted values (supports multiple values)field_values[].field_confidencefloatConfidence score (0.0 - 1.0)field_values[].referencesarrayList of reference points in the document (e.g., bounding boxes, page numbers)line_items_item_codestringCode/SKU of the line itemline_items_descriptionstringDescription of the line itemline_items_quantitystringQuantity of the line itemline_items_unit_pricestringUnit price of the line itemline_items_total_amountstringTotal amount of the line itemline_items_tax_ratestringTax rate for the line itemline_items_taxstringTax amount for the line item

How to distinguish field types: If table_values is present → table field, read from table_values; otherwise → regular field, read from field_values.

⚠️ Usage Limits#

ItemRequirement / LimitFile SizeLess than 2 MBPage CountSingle page only. Multi-page PDF files will be rejectedSupported Formatsjpeg, .jpg, .png, .bmp, .tiff, .pdf, .doc, .docx, .xlsx, .ofdURL AccessibilityPublicly accessible HTTP/HTTPS URL. Private network or internal IP addresses are not supportedPer IP per minute30 requests (within any consecutive 60 seconds)Per IP per day30 requestsGlobal daily pool5,000 requests

When the limit is exceeded, the API returns HTTP 429 with registration guidance included in the response.

json

{
  "code": "rate_limited_day",
  "message": "Daily free usage limit has been used up. Please come back tomorrow.",
  "upgrade_message": "Sign up for 100 monthly free credits, more fields, higher performance, multi-tax support & self-optimization",
  "signup_url": "https://adp-global.laiye.com/?utm_source=promotions-clawhub"
}

❌ Error Codes#

HTTP Status CodecodeDescription400invalid_inputNo file provided, or both file_base64 and file_url are passed simultaneously400invalid_base64The content of file_base64 is not valid Base64 encoding400invalid_urlInvalid file_url format (not HTTP/HTTPS)400ssrf_blocked``file_url points to an internal network or private IP address400download_failedFailed to download file from file_url400file_too_largeFile size exceeds 2 MB400multi_pageMulti-page PDF detected. Only single-page files are supported400unsupported_formatUnsupported file format429rate_limited_minuteExceeded per-IP minute limit (30 requests within 60 seconds)429rate_limited_dayExceeded per-IP daily limit (30 requests)429rate_limited_globalExceeded global daily limit (5,000 requests)500extraction_failedServer processing failed. Please try again later

🚀 Advanced Usage#

This API uses the fixed invoice-fast (high-speed) model with preset field configurations, designed exclusively for a quick experience.

Upgrade to the full ADP account to unlock these premium capabilities:

Invoice file size exceeds 2MB
Higher API call frequency & unlimited request quotas
Custom extraction fields (add or remove fields as needed)
Asynchronous batch processing
Human-in-the-loop (HITL) review workflow
Webhook callback support
Support for more document types (purchase orders, ID cards, domestic invoices, etc.)
MCP tool integration for AI clients (Claude Desktop, Cursor, etc.)

New users will receive 100 free credits upon registration to experience all full-function features.We provide independent Public Cloud access addresses fr domestic and international users, which need to be configured separately by region. Accessing from a nearby location can better ensure high-speed and stable invocation across the network.