Presentación electrónica de documentos

De un vistazo

NextPDF Enterprise optimiza un PDF para convertirlo en un artefacto de entrega adecuado para la presentación electrónica judicial o gubernamental, según lo configurado por un perfil de jurisdicción, y lo divide en segmentos acotados por tamaño cuando se supera el límite de tamaño de un perfil. Prepara formatos para la presentación según lo configurado; no garantiza que ningún documento sea aceptado por un tribunal o un registro.

Disponibilidad y licencia

Esta capacidad se distribuye en NextPDF Enterprise (nextpdf/enterprise) y se activa con un sobre de licencia de nivel Enterprise. Un despliegue sin ese derecho no carga las clases de la capacidad. Comparar ediciones y obtener una licencia.

Instalación

composer require nextpdf/enterprise:^3

Descripción conceptual

EFilingOptimizer ejecuta un pipeline fijo sobre un PDF de entrada:

1. Saneamiento. El contenido activo (JavaScript y acciones) se elimina mediante el motor de desarme y reconstrucción de contenido.
2. Linealización. El documento se lineariza para una vista web rápida.
3. Comprobación de tamaño y división. Si el resultado supera el límite de tamaño del perfil, SizeAwareSplitter lo divide en segmentos que encajan cada uno, utilizando una búsqueda binaria sobre el número de páginas para elegir los puntos de división.

Un perfil de jurisdicción (EFilingProfile) transporta las restricciones: tamaño máximo de archivo por segmento, calidad de recompresión JPEG, aplanamiento de formularios, eliminación de JavaScript, linealización y compresión de flujos de objetos. Los perfiles integrados incluyen US PACER (límite de 25 MiB), EU e-Justice (límite de 10 MiB) y Taiwan Judicial Yuan (límite de 10 MiB). El resultado (EFilingResult) informa de los segmentos, los tamaños original y optimizado, las optimizaciones aplicadas y cualquier advertencia.

La salida de presentación electrónica es un artefacto de entrega, no un estado del ciclo de vida del documento. Un PDF optimizado o dividido es final para la transmisión y no debe volver a entrar en un pipeline de firma o de archivado, porque el reprocesamiento rompería las cadenas de hash y la integridad probatoria.

Qué afirma y qué no afirma este módulo

Este módulo prepara formatos para la presentación electrónica judicial o gubernamental según lo configurado. No garantiza la aceptación por parte de ningún tribunal, registro ni portal de presentación. Las reglas del portal, los formatos aceptados, los límites de tamaño y los requisitos procesales varían según la jurisdicción y cambian con el tiempo. Los perfiles integrados codifican restricciones publicadas habitualmente a modo de conveniencia; verifíquelos frente a las reglas vigentes del registro de destino antes de presentar.

Por qué funciona así

El pipeline se ejecuta en un orden fijo —sanear, linealizar, comprobar el tamaño— porque cada etapa consume la salida de la etapa anterior. El desarme y la reconstrucción de contenido se ejecutan primero, porque las entradas de presentación llegan de partes no confiables y deben desarmarse antes de reescribirlas. La linealización precede a la comprobación de tamaño porque cambia la disposición de los bytes y, por tanto, el tamaño que el divisor debe respetar. A continuación, splitByMaxSize() verifica cada segmento producido frente al límite maxFileSizeBytes del perfil, en lugar de confiar en una estimación de página promedio. Una sola página que aún supera el límite es indivisible, por lo que aparece como una advertencia en lugar de descartarse. El artefacto de entrega se excluye de la refirma y del rearchivado, porque reprocesar los bytes presentados rompería las cadenas de hash probatorias.

Contexto de diseño: Saneamiento de PDF no confiables: desarme y reconstrucción de contenido.

Superficie de la API

Clase	Responsabilidad
EFilingOptimizer	Ejecutar el pipeline de sanear → linealizar → dividir por tamaño.
EFilingProfile	Perfil de restricción de jurisdicción (pacer(), euJustice(), taiwan() o personalizado).
SizeAwareSplitter	Dividir un PDF en segmentos por debajo de un límite de bytes.
EFilingSegment	Un segmento de salida: bytes, rango de páginas, tamaño, índice.
EFilingResult	Agregado: segmentos, tamaños, optimizaciones, advertencias.

Ejemplo de código — Inicio rápido

use NextPDF\Enterprise\Document\EFiling\EFilingOptimizer;
use NextPDF\Enterprise\Document\EFiling\EFilingProfile;

$result = (new EFilingOptimizer())->optimize($pdfBytes, EFilingProfile::pacer());

Ejemplo de código — Producción

$result = (new EFilingOptimizer())->optimize($pdfBytes, EFilingProfile::euJustice());

foreach ($result->warnings as $warning) {
    $logger->warning('efiling.warning', ['message' => $warning]);
}

foreach ($result->segments as $segment) {
    $store->put("filing/{$segment->segmentIndex}.pdf", $segment->pdfData);
}
// Confirm the destination registry's current rules before submitting.

Casos límite y trampas

• Un documento que ya está por debajo del límite del perfil devuelve un único segmento, sin cambios en términos de tamaño.
• Una sola página que supera el límite no se puede dividir más; se devuelve como un único segmento fuera de los límites con una advertencia. Reduzca la calidad de la imagen en un perfil personalizado o preprocese la página.
• Si el saneamiento rechaza la entrada, se registra una advertencia y se conservan los bytes originales; inspeccione las advertencias antes de presentar.
• Los límites de los perfiles integrados reflejan valores publicados habitualmente, no una fuente en vivo de cada portal. Trátelos como valores predeterminados a confirmar.

Rendimiento

El costo escala con el tamaño del documento y el número de páginas. La división realiza una búsqueda binaria sobre el número de páginas, por lo que el número de intentos de división es logarítmico en el número de páginas. La linealización y la recompresión dominan el tiempo de pared para documentos grandes con muchas imágenes.

Notas de seguridad

El contenido activo se elimina antes de la entrega mediante el desarme y la reconstrucción de contenido. Trate los PDF de entrada de partes no confiables como hostiles; el paso de saneamiento es una mitigación, no una garantía de seguridad para los sistemas posteriores.

Residencia de datos y mitigaciones de PII

Los documentos presentados frecuentemente contienen datos personales y de casos. El procesamiento es en proceso y local; el módulo no realiza llamadas de red salientes. Aplique sus propios controles de conservación a los segmentos y al original.

Telemetría segura y depuración de registros

Las advertencias y los registros de optimización describen acciones del pipeline, no contenido del documento. Evite registrar rutas de archivo o identificadores de caso de su código circundante en destinos compartidos.

Conformidad

Comportamiento	Referencia	Estado
Semántica de la relación de archivo asociado	ISO 19005-3:2012 §6.7.8	Respetada donde se aplican los portadores
Requisitos del portador de archivo incrustado	ISO 19005-4:2020 Annex A	Respetada donde se aplican los portadores

Esta tabla registra las especificaciones frente a las que se ha construido el manejo de PDF/A circundante. No es una declaración de aceptación por parte de ningún tribunal o registro.

Comportamiento en modo FIPS

Este módulo no realiza operaciones criptográficas.

Modelo de amenazas

Los PDF de entrada no confiables que transportan contenido activo son la entrada principal. Mitigación: desarme y reconstrucción de contenido antes de la linealización y la entrega; el artefacto de entrega se excluye de la refirma y del rearchivado para proteger la integridad probatoria.

Contrato de comportamiento

• EFilingOptimizer ejecuta un pipeline fijo: desarme y reconstrucción de contenido, linealización y, después, una comprobación de tamaño con división por búsqueda binaria cuando se supera el límite de un perfil.
• Un documento que ya está por debajo del límite del perfil devuelve un único segmento sin cambios de tamaño.
• Una sola página por encima del límite se devuelve como un único segmento fuera de los límites con una advertencia; no se puede dividir más.
• Un artefacto de presentación electrónica es final para la transmisión y no debe volver a entrar en un pipeline de firma o de archivado; el reprocesamiento rompería las cadenas de hash y la integridad probatoria.

Límite de publicación

Esta página documenta únicamente el comportamiento observable externamente y la superficie pública de la API compatible. Las rutas internas de espacio de nombres, las clases auxiliares, las tablas de mecanismos, los nombres de archivos de runbook y los prefijos de tickets quedan fuera del alcance.

Alternativa de Core

NextPDF Core no tiene optimizador de presentación electrónica por perfil de jurisdicción, ni etapa de saneamiento por CDR, ni divisor consciente del tamaño. Una implementación solo con Core debe construir por sí misma cualquier pipeline de preparación de presentaciones.

Alternativa de Pro

NextPDF Pro no proporciona el optimizador de presentación electrónica por perfil de jurisdicción, ni los perfiles integrados PACER / EU e-Justice / Taiwan Judicial Yuan, ni la etapa de saneamiento por CDR, ni el divisor consciente del tamaño. Una configuración que solicita optimización de presentación electrónica dirigida por perfil en una implementación solo con Pro no tiene ningún componente de Enterprise que la satisfaga. Consulte la visión general de Enterprise para la superficie de Enterprise.

Nota sobre el límite de Enterprise

Los detalles internos del mecanismo permanecen en la documentación interna del repositorio de origen y quedan fuera del alcance de este manual.

Límite de despliegue

Los límites de los perfiles integrados codifican restricciones publicadas habitualmente a modo de conveniencia, no una fuente en vivo de cada portal; verificarlos frente a las reglas vigentes del registro de destino antes de presentar es responsabilidad de quien presenta. El procesamiento es en proceso y local; el módulo no realiza llamadas de red salientes. El transporte a un tribunal, registro o portal de presentación es externo a este módulo.

Límite de cumplimiento legal

NextPDF prepara formatos para la presentación electrónica judicial o gubernamental según lo configurado por un perfil de jurisdicción. No garantiza que un documento vaya a ser aceptado por ningún tribunal, registro, tribunal de justicia ni portal de presentación, y no proporciona asesoramiento legal. Las reglas de presentación, los formatos aceptados, los límites de tamaño, los requisitos de firma y los plazos procesales los establece la autoridad correspondiente, varían según la jurisdicción y cambian. Verificar y cumplir esas reglas es responsabilidad de quien presenta. Consulte a un abogado y la orientación vigente del registro de destino.

Consulte también

• Referencia de presentación electrónica de documentos — superficie pública completa de la API de este módulo.
• Invoice — generación de facturas estructuradas.
• Visión general de Enterprise
• Matriz de funciones: núcleo frente a Pro frente a Enterprise