n8n-nodes-adp

This is an n8n community node package for ADP (Agentic Document Processor), an AI-powered document processing platform that provides intelligent document extraction capabilities.

n8n is a fair-code licensed workflow automation platform.

Features

This integration provides a node for interacting with ADP's document extraction API:

• ADP Overseas Extract - Extract data from overseas invoices, receipts, and purchase orders

Capabilities

Supported Document Types

• Overseas Business Documents:
  • Invoices (B2B)
  • Receipts (B2E)
  • Purchase Orders

AI-Powered Extraction

• OCR-based text recognition
• VLM (Vision Language Model) for direct image understanding
• Intelligent field extraction and normalization
• Support for multiple languages (Chinese, English, Japanese, Korean)

Installation

Follow the installation guide in the n8n community nodes documentation.

Quick Install

# In your n8n installation directory
npm install n8n-nodes-adp

Credentials

To use this node, you need to configure ADP API credentials:

1. Base URL: The ADP API base URL (default: https://adp.laiye.com)
2. API Key: Your API key for authentication (X-API-KEY), found in application API settings
3. App ID: Your application unique identifier, found in application API settings
4. Tenant Name: Your tenant name (defaults to "laiye")

Getting Your Credentials

Contact your ADP administrator or visit the ADP documentation to obtain your API credentials.

Usage

ADP Overseas Extract Node

Extract data from overseas business documents (invoices, receipts, purchase orders) using AI-powered automatic classification.

Parameters:

• Input Source: Choose between Binary File (from previous node) or URL
• File URL (if URL selected): The URL of the file to process
• With Recognition Result: Include OCR recognition results in the response
• Field Name Language: Language for returned field names (Chinese or English)

Response:

{
  "code": "success",
  "message": "...",
  "data": {
    "task_id": "...",
    "file_url": "...",
    "status": 4,
    "extraction_result": [...],
    "classify_result": {...}
  }
}

Task Status Codes

| Status | Code | Description | |--------|------|-------------| | Pending | 1 | Task created, waiting to start | | Parsing | 2 | Parsing document | | Extracting | 3 | Extracting structured data | | Success | 4 | Task completed successfully | | Failed | 5 | Task failed |

Error Handling

All nodes support "Continue On Fail" option. When enabled:

• Failed items will return error details instead of stopping the workflow
• Error response format:

{
  "error": "Error message",
  "details": {...}
}

API Reference

Endpoints

• POST /open/agentic_doc_processor/{tenant_name}/v1/app/doc/extract - Overseas document extraction

Authentication

The node uses custom headers for authentication:

X-API-KEY: {api_key}
X-Api-Source: n8n
accept-language: zh|en

Compatibility

• Minimum n8n version: 1.0.0
• Tested with: n8n 1.50.0+
• Node API Version: 1

Resources

• n8n community nodes documentation
• ADP API Documentation
• ADP Portal

Version History

0.1.0 (2025-01-30)

• Initial release
• ADP Overseas Extract node for invoices, receipts, and purchase orders
• Base64 and URL file input support

License

MIT

Support

For issues and questions:

• Create an issue in the GitHub repository
• Contact: [email protected]

Built with ❤️ for the n8n community