n8n-nodes-pappers

A package of nodes for n8n connected to Pappers API.

🚀 Features

Company Node

Retrieve detailed company information by:

• Company number (SIREN for France with automatic validation)
• LEI (Legal Entity Identifier)
• ISIN (International Securities Identification Number)

Additional data blocks available:

• Officers (current and historical)
• Beneficial owners (UBOs)
• Financial statements
• Official documents (with download tokens)
• Certificates
• Legal publications
• Establishments (headquarters + branches)
• Contact information

Search Node

Search for companies by:

• Company name
• Registration number (SIREN, SIRET, etc.)
• Any search term
• Pagination support (up to 100 results per page)

Download File Node

Download official documents (PDF format) using tokens obtained from the Company node's Documents block.

🌍 Supported Countries

France 🇫🇷 | Belgium 🇧🇪 | United Kingdom 🇬🇧 | Switzerland 🇨🇭 | Luxembourg 🇱🇺 | Netherlands 🇳🇱 | Germany 🇩🇪 | Spain 🇪🇸 | Norway 🇳🇴

📦 Installation

Option A: Via n8n Interface (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Click Install
4. Enter n8n-nodes-pappers
5. Click Install

Option B: Via npm

npm install n8n-nodes-pappers

Option C: Manual Installation

cd ~/.n8n
npm install n8n-nodes-pappers

Then restart n8n.

🔑 Getting Your API Key

1. Visit Pappers Account
2. Sign up or log in
3. Generate your API token
4. In n8n, add new Pappers credentials with your token

💡 Usage Examples

Basic Company Lookup

1. Add a Company node
2. Select country (e.g., France)
3. Enter SIREN number (e.g., 888207859)
4. Choose additional data blocks if needed
5. Execute

Search and Retrieve

1. Add a Search node to find companies by name
2. Connect to a Company node
3. Map the company number from search results
4. Retrieve full company details

Batch Processing with Error Handling

1. Enable Continue on Fail in node settings
2. Process multiple companies in one execution
3. Failed items return error objects with pairedItem tracking
4. Use IF node to route successes and failures separately

Download Official Documents

1. Use Company node with "Documents" data block
2. Extract document token from results
3. Pass token to Download File node
4. Save or email the PDF

🧪 Example Workflows

Check the exemples/ folder for ready-to-use workflows:

• Creation devis.json - Form submission → company data → PDF generation → email
• Enrichissement CSV.json - CSV import → company enrichment → results export
• Traitement en lot avec gestion d_erreurs.json - Batch processing with error handling

🛠️ Development

# Clone repository
git clone https://github.com/pappers-fr/pappers-n8n.git
cd pappers-n8n

# Install dependencies
npm install

# Build
npm run build

# Lint
npm run lint

# Watch mode
npm run dev

📝 License

MIT

🔗 Links

• Pappers API Documentation
• n8n Documentation
• Report Issues

💬 Support

For questions or issues:

• Email: [email protected]
• GitHub Issues: pappers-fr/pappers-n8n