Actions80
- Extract Text From Word
- Find And Replace Text
- Convert PDF To Editable PDF Using OCR
- Create Swiss QR Bill
- Split PDF By Barcode
- Split PDF By Swiss QR
- Split PDF By Text
- Split PDF Regular
- Create PDF/A
- Convert HTML To PDF
- Convert Markdown To PDF
- Upload File To PDF4me
- Add Attachment To PDF
- Add Barcode To PDF
- Add Form Fields To PDF
- Fill PDF Form
- Add HTML Header Footer
- Add Image Stamp To PDF
- Add Margin To PDF
- Add Page Number To PDF
- Add Text Stamp To PDF
- AI-Invoice Parser
- AI-Process HealthCard
- AI-Process Contract
- Generate Barcode
- Classify Document
- Parse Document
- Linearize PDF
- Flatten PDF
- Convert To PDF
- Json To Excel
- Convert PDF To Excel
- Convert PDF To Word
- Convert PDF To PowerPoint
- Convert VISIO
- Crop Image
- Delete Blank Pages From PDF
- Delete Unwanted Pages From PDF
- Extract Pages
- Merge Multiple PDFs
- Overlay PDFs
- Rotate Document
- Rotate Page
- Sign PDF
- URL to PDF
- Add Image Watermark To Image
- Add Text Watermark To Image
- Compress Image
- Convert Image Format
- Create Images From PDF
- Flip Image
- Get Image Metadata
- Image Extract Text
- Remove EXIF Tags From Image
- Replace Text With Image
- Replace Text With Image In Word
- Resize Image
- Rotate Image
- Rotate Image By EXIF Data
- Compress PDF
- Get PDF Metadata
- Repair PDF Document
- Get Document From Pdf4me
- Update Hyperlinks Annotation
- Protect Document
- Unlock PDF
- Disable Tracking Changes In Word
- Enable Tracking Changes In Word
- Generate Document Single
- Generate Documents Multiple
- Get Tracking Changes In Word
- Read Barcode From Image
- Read Barcode From PDF
- Read SwissQR Code
- Extract Form Data From PDF
- Extract Pages From PDF
- Extract Attachment From PDF
- Extract Text By Expression
- Extract Table From PDF
- Extract Resources
Overview
The node provides functionality to split a PDF document based on the detection of barcodes within its pages. It scans the PDF for barcodes matching specified criteria and splits the document accordingly. This is particularly useful in scenarios where large PDFs contain multiple documents separated by barcode markers, such as batch scanned forms, invoices, or shipping labels.
Practical examples include:
- Automatically splitting a batch of scanned invoices into individual files using invoice number barcodes.
- Separating multi-page shipping manifests where each section starts with a barcode.
- Processing forms where each form is identified by a unique barcode, enabling automated routing or storage.
Properties
| Name | Meaning |
|---|---|
| Input Data Type | Method to provide the PDF data: - Base64 String: Provide PDF content as a base64 encoded string. - Binary Data: Use PDF file from previous nodes. - URL: Provide URL to PDF file. |
| Binary Property Name | Name of the binary property containing the PDF file (used when Input Data Type is Binary Data). |
| Base64 Content | Base64 encoded PDF content (used when Input Data Type is Base64 String). |
| PDF URL | URL to the PDF file (used when Input Data Type is URL). |
| Barcode String | The barcode string to search for within the PDF pages. |
| Barcode Filter | Filter type for barcode matching: - Starts With - Ends With - Contains - Exact Match |
| Barcode Type | Type of barcode to detect: - Any - Data Matrix - QR Code - PDF417 |
| Split Barcode Page | Where to split relative to the barcode page: - After: Split after the page containing the barcode. - Before: Split before the page containing the barcode. - Remove: Remove the barcode page from output. |
| Combine Pages With Same Consecutive Barcodes | Whether to combine consecutive pages that have the same barcode value into a single split document. |
| PDF Render DPI | Resolution in DPI used to render the PDF for processing barcodes: - 100 DPI - 150 DPI - 200 DPI - 250 DPI |
| Advanced Options | Custom profiles in JSON format to adjust extra properties for API calls, allowing advanced customization of the splitting process. |
Output
The node outputs an array of JSON objects representing the resulting split PDF documents. Each item typically contains the PDF data of one split segment, which can be in binary form or base64 encoded depending on configuration.
If the node supports binary output, the binary data represents the individual PDF files created after splitting by barcode.
Dependencies
- Requires access to an external PDF processing service or API capable of reading barcodes and splitting PDFs accordingly.
- Needs appropriate API authentication credentials configured in n8n to interact with the PDF processing backend.
- Internet access may be required if providing PDF via URL or if the service is cloud-based.
Troubleshooting
Common Issues:
- Incorrect barcode string or filter settings may result in no splits being detected.
- Providing invalid or inaccessible PDF URLs will cause failures in fetching the document.
- Insufficient DPI setting might lead to barcode detection failure; increasing DPI can improve accuracy but at the cost of performance.
- If combining pages with the same barcode is enabled incorrectly, output documents may merge unexpectedly.
Error Messages:
- Errors related to "PDF not found" or "Unable to fetch PDF" indicate issues with input data or URL accessibility.
- "Barcode not detected" errors suggest that the barcode string or type does not match any barcode in the document.
- Authentication errors imply missing or invalid API credentials.
Resolutions:
- Verify the barcode string and filter options carefully.
- Ensure the PDF URL is correct and accessible.
- Adjust the PDF Render DPI to a higher value if barcodes are not detected.
- Confirm API credentials are properly set up in n8n.
Links and References
- PDF4me API Documentation — For details on custom profiles and advanced options.
- Barcode Types Reference: Data Matrix, QR Code, PDF417 standards.
- General n8n documentation on handling binary data and credentials.