Dividir PDF por Barcode API

Q: What barcode types does the Split PDF by Barcode API support?

The API supports common 1D and 2D barcode formats including Code128, Code39, QR Code, EAN-13, EAN-8, DataMatrix, and PDF417. Specify the correct type in the Barcode Type parameter to ensure accurate recognition.

Q: What does the Barcode Filter parameter control?

Barcode Filter controls how the Barcode String is matched against the decoded barcode text on each page. Contains: the barcode text includes the Barcode String anywhere. Equals: exact match only. StartsWith, barcode text begins with the string. EndsWith, barcode text ends with the string. Use Contains for partial matches, Equals for strict pattern control.

Q: What does Split Barcode Page control?

Split Barcode Page controls where the cut happens relative to the barcode page. Before: the split occurs before the barcode page (the barcode page becomes the first page of the next document). After: the split occurs after the barcode page (the barcode page is the last page of the current document). Remove, the barcode page is excluded from all output documents.

Q: What does Combine Pages With Same Consecutive Barcodes do?

When set to true, consecutive pages with identical barcode values are grouped into a single output document rather than being split into separate ones. This is useful for multi-page forms or documents where the same barcode appears on every page of a section.

Q: Why should I increase Pdf Render Dpi for small or dense barcodes?

The API renders the PDF at the specified DPI before scanning for barcodes. At 150 DPI, small or dense barcodes (e.g. DataMatrix on A4 pages) may not resolve clearly enough for accurate decoding. Use 300 DPI as a standard setting: increase to 400 or 600 DPI only if recognition is failing on very small barcodes. Higher DPI increases processing time.

Qué hace este punto final: El PDF4me Dividir PDF por Barcode REST API escanea un PDF documento para páginas que contienen un valor de código de barras específico y divide el documento en cada página coincidente. Defina un cadena de código de barras, método de filtrado y tipo de código de barras, luego elige si cortar antes, después o eliminando la página del código de barras. El API utiliza configurable DPI Permite la representación precisa de códigos de barras en diferentes calidades de impresión y, opcionalmente, agrupa páginas consecutivas con el mismo código de barras en una única sección de salida. Ideal para el procesamiento automatizado de facturas, la clasificación de correo, el enrutamiento de lotes de documentos y cualquier flujo de trabajo que utilice códigos de barras como separadores físicos de documentos.

Entradas de blog relacionadas

Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.

Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.

Visita el blog →

Autenticando su API Pedido

Cada PDF4me REST API La llamada debe incluir su API clave en el Authorization Encabezado. Obtenga su clave desde el panel de control del desarrollador.

Get your API Key

Datos importantes que no debes perderte

All eight parameters are required for reliable barcode splitting

DocName, DocContent, Barcode String, Barcode Filter, Barcode Type, Split Barcode Page, Combine Pages With Same Consecutive Barcodes, and Pdf Render Dpi are all required. Omitting any parameter causes the API to return an error or produce unexpected split results. Validate all eight fields before sending the request.

Barcode Type must match the actual barcode format printed in the PDF

The API uses Barcode Type to select the correct recognition engine. Setting Code128 when the document contains QR Codes causes recognition to fail silently: the API returns the unsplit original document because no barcodes matched. Always verify the barcode format used in your documents before setting this parameter.

Increase Pdf Render Dpi to 300+ for small or dense barcodes

The API renders each page at the specified DPI before scanning for barcodes. At low DPI (e.g. 150), small or dense barcodes: such as DataMatrix or compact QR codes on A4 pages, may not resolve clearly enough for accurate decoding. Use 300 DPI as your default. Increase to 400-600 DPI only for very small barcodes; higher values increase processing time significantly.

REST API Punto final

Método	Punto final
POST	`/api/v2/SplitPdfByBarcode_old`

URL base: https://api.pdf4me.com

Parámetros

⚠️ Se requieren los ocho parámetros. para una correcta detección y división del código de barras.

Parámetro	Requerido	Tipo	Lo que hace	Ejemplo
DocName	Required	String	Filename of the source PDF including the .pdf extension. Used for processing identification and output file naming.	batch-invoices.pdf
DocContent	Required	Base64	The complete PDF file encoded as a Base64 string. The PDF must contain pages with machine-readable barcodes.	JVBERi0xLjQK...
Barcode String	Required	String	The barcode text or pattern to search for. Matched against decoded barcode values on each page using the Barcode Filter method.	INV-
Barcode Filter	Required	Enum	How the Barcode String is matched against decoded barcode text. Contains: text includes the string anywhere. Equals, exact match. StartsWith, text begins with the string. EndsWith, text ends with the string.	Contains
Barcode Type	Required	String	The barcode format printed in the PDF. Must match the actual barcode standard used. Common values: Code128 · Code39 · QRCode · EAN13 · EAN8 · DataMatrix · PDF417	Code128
Split Barcode Page	Required	Enum	Controls where the split occurs relative to the barcode page. Before: barcode page starts the next document. After, barcode page ends the current document. Remove, barcode page is excluded from all output.	After
Combine Pages With Same Consecutive Barcodes	Required	Boolean	When true, consecutive pages sharing the same barcode value are grouped into a single output document rather than split individually. Useful for multi-page forms where the same barcode appears on every page of a section.	true
Pdf Render Dpi	Required	String	DPI resolution for rendering PDF pages before barcode scanning. 300 is recommended for standard-size barcodes. Increase to 400-600 for small or dense barcodes. Higher DPI improves recognition accuracy but increases processing time.	300

Campos de salida

Campo	Tipo	Descripción
Contenido del archivo	Base64	La división de salida PDF contenido codificado como Base64. Decodificar a binario para guardar el archivo.
Nombre del archivo	String	Nombre del archivo de la división de salida PDF.

Ejemplo de solicitud

Encabezados

Content-Type: application/json
Authorization: YOUR_API_KEY

JSON Carga útil

{
 "DocName": "batch-invoices.pdf",
 "DocContent": "JVBERi0xLjQK...",
 "Barcode String": "INV-",
 "Barcode Filter": "Contains",
 "Barcode Type": "Code128",
 "Split Barcode Page": "After",
 "Combine Pages With Same Consecutive Barcodes": true,
 "Pdf Render Dpi": "300"
}

Respuesta

{
 "File Content": "BASE64_SPLIT_PDF_CONTENT",
 "File Name": "batch-invoices-split.pdf"
}

Ejemplos de código

Google Script Sample →

AWS Lambda Sample →

Casos de uso comunes

Invoice Batch Processing

Accounts payable teams receive consolidated PDF batches where each invoice has a Code128 barcode separator page. Split at each barcode (Split Barcode Page: Remove) to extract individual invoice PDFs for routing to the correct cost centre or approval queue automatically.

Mail and Parcel Sorting

Bulk print mail runs produce a single PDF with a barcode cover sheet per recipient. Split the document at each barcode page (Split Barcode Page: After) to extract individual mail pieces. Use the barcode value (address or route code) to name each split file for downstream sorting and physical printing.

Document Archive Organisation

Scanned document batches from physical mailrooms often include a QR code separator sheet between each document. Set Barcode Type: QRCode, Barcode Filter: Contains the archive category code, and Split Barcode Page: Remove to get clean content-only PDFs ready for archiving: with no separator stubs included.

Preguntas frecuentes

▶ What barcode types does the Split PDF by Barcode API support?

The API supports common 1D and 2D formats including Code128, Code39, QR Code, EAN-13, EAN-8, DataMatrix, and PDF417. Specify the correct type in Barcode Type: using the wrong type causes the recognition engine to miss all barcodes and return the unsplit original document.

▶ What does the Barcode Filter parameter control?

Barcode Filter controls how Barcode String is matched against decoded barcode text on each page. Contains: barcode text includes the string anywhere. Equals, exact match only. StartsWith, text begins with the string. EndsWith, text ends with the string. Use Contains for partial patterns, Equals for strict control over exact barcode values.

▶ What does Split Barcode Page control?

Split Barcode Page determines what happens to the page containing the matching barcode. Before: that page starts the next output document. After, that page ends the current output document. Remove, that page is excluded from all output documents entirely. Use Remove for blank separator pages or cover sheets you do not want in any output.

▶ What does Combine Pages With Same Consecutive Barcodes do?

When set to true, consecutive pages sharing the same barcode value are grouped into one output document instead of being split individually. This is useful for multi-page records or forms where the same barcode appears on every page of a section: it prevents unnecessary splits within a single logical document.

▶ Why should I increase Pdf Render Dpi for small or dense barcodes?

The API renders each PDF page at the specified DPI before scanning. At 150 DPI, small barcodes (e.g. DataMatrix cells under 5mm wide) may not resolve with enough pixel density for accurate decoding. Use 300 DPI as your default. Increase to 400-600 DPI for very small or dense barcodes: note that higher DPI significantly increases processing time and memory usage.