Protocolo Eletrônico de Documentos

Visão geral

O NextPDF Enterprise otimiza um PDF em um artefato de entrega adequado ao protocolo eletrônico em tribunais / órgãos governamentais, conforme configurado por um perfil de jurisdição, e o divide em segmentos limitados por tamanho quando um limite de tamanho do perfil é excedido. Ele prepara formatos para protocolo conforme configurado; ele não garante que qualquer documento seja aceito por um tribunal ou cartório.

Disponibilidade e licenciamento

Este recurso é entregue no NextPDF Enterprise (nextpdf/enterprise) e é ativado com um envelope de licença de nível Enterprise. Uma implantação sem essa titularidade não carrega as classes do recurso. Compare edições e obtenha uma licença.

Instalação

composer require nextpdf/enterprise:^3

Visão conceitual

EFilingOptimizer executa um pipeline fixo sobre um PDF de entrada:

1. Higienização. O conteúdo ativo (JavaScript e ações) é removido por meio do mecanismo de content disarm and reconstruction.
2. Linearização. O documento é linearizado para visualização rápida na web.
3. Verificação de tamanho e divisão. Se o resultado exceder o limite de tamanho do perfil, SizeAwareSplitter o divide em segmentos que caibam, usando uma busca binária sobre a contagem de páginas para escolher os pontos de divisão.

Um perfil de jurisdição (EFilingProfile) carrega as restrições: tamanho máximo de arquivo por segmento, qualidade de recompressão JPEG, achatamento de formulários, remoção de JavaScript, linearização e compressão de fluxo de objetos. Os perfis integrados incluem US PACER (limite de 25 MiB), EU e-Justice (limite de 10 MiB) e Taiwan Judicial Yuan (limite de 10 MiB). O resultado (EFilingResult) relata os segmentos, os tamanhos original e otimizado, as otimizações aplicadas e quaisquer avisos.

A saída do protocolo eletrônico é um artefato de entrega, não um estado do ciclo de vida do documento. Um PDF otimizado ou dividido é final para transmissão e não deve voltar a entrar em um pipeline de assinatura ou de arquivamento, porque o reprocessamento quebraria as cadeias de hash e a integridade probatória.

O que este módulo declara e o que não declara

Este módulo prepara formatos para protocolo eletrônico em tribunais / órgãos governamentais conforme configurado. Ele não garante a aceitação por nenhum tribunal, cartório ou portal de protocolo. As regras do portal, os formatos aceitos, os limites de tamanho e os requisitos processuais variam por jurisdição e mudam ao longo do tempo. Os perfis integrados codificam restrições comumente publicadas por conveniência; verifique-as em relação às regras atuais do cartório de destino antes de protocolar.

Por que funciona assim

O pipeline executa em uma ordem fixa — higienizar, linearizar, verificar tamanho — porque cada etapa consome a saída da etapa anterior. O content disarm and reconstruction executa primeiro, porque as entradas de protocolo chegam de partes não confiáveis e devem ser desarmadas antes da reescrita. A linearização precede a verificação de tamanho porque altera o layout de bytes e, portanto, o tamanho que o divisor deve respeitar. splitByMaxSize() então verifica cada segmento produzido em relação ao limite maxFileSizeBytes do perfil, em vez de confiar em uma estimativa de página média. Uma única página que ainda excede o limite é indivisível, então ela surge como um aviso em vez de ser descartada. O artefato de entrega é excluído de nova assinatura e de novo arquivamento, porque reprocessar os bytes protocolados quebraria as cadeias de hash probatórias.

Contexto de design: Higienizando PDFs não confiáveis: content disarm and reconstruction.

Superfície da API

Classe	Responsabilidade
EFilingOptimizer	Executa o pipeline higienizar → linearizar → dividir por tamanho.
EFilingProfile	Perfil de restrições de jurisdição (pacer(), euJustice(), taiwan() ou personalizado).
SizeAwareSplitter	Divide um PDF em segmentos sob um limite de bytes.
EFilingSegment	Um segmento de saída: bytes, intervalo de páginas, tamanho, índice.
EFilingResult	Agregado: segmentos, tamanhos, otimizações, avisos.

Exemplo de código — Início rápido

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

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

Exemplo de código — Produção

$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 extremos e armadilhas

• Um documento já abaixo do limite do perfil retorna um único segmento, inalterado em termos de tamanho.
• Uma única página que excede o limite não pode ser dividida ainda mais; ela é retornada como um segmento fora do limite com um aviso. Reduza a qualidade da imagem em um perfil personalizado ou pré-processe a página.
• Se a higienização rejeitar a entrada, um aviso é registrado e os bytes originais são mantidos; inspecione os avisos antes de protocolar.
• Os limites dos perfis integrados refletem valores comumente publicados, não um feed ao vivo de cada portal. Trate-os como padrões a confirmar.

Desempenho

O custo escala com o tamanho do documento e a contagem de páginas. A divisão realiza uma busca binária sobre a contagem de páginas, então o número de tentativas de divisão é logarítmico na contagem de páginas. A linearização e a recompressão dominam o tempo de parede para documentos grandes e ricos em imagens.

Notas de segurança

O conteúdo ativo é removido antes da entrega por meio de content disarm and reconstruction. Trate os PDFs de entrada de partes não confiáveis como hostis; a etapa de higienização é uma mitigação, não uma garantia de segurança para os sistemas posteriores.

Residência de dados e mitigações de PII

Os documentos protocolados frequentemente contêm dados pessoais e dados do processo. O processamento é em processo e local; o módulo não realiza nenhuma chamada de rede de saída. Aplique os seus próprios controles de retenção aos segmentos e ao original.

Telemetria segura e limpeza de logs

Os avisos e os registros de otimização descrevem ações do pipeline, não o conteúdo do documento. Evite registrar em log caminhos de arquivo ou identificadores de processo do seu código ao redor em destinos compartilhados.

Conformidade

Comportamento	Referência	Status
Semântica de relacionamento de arquivo associado	ISO 19005-3:2012 §6.7.8	Honrada onde os carriers se aplicam
Requisitos de carrier de arquivo incorporado	ISO 19005-4:2020 Annex A	Honrados onde os carriers se aplicam

Esta tabela registra as especificações em relação às quais o tratamento de PDF/A ao redor é construído. Ela não é uma declaração de aceitação por nenhum tribunal ou cartório.

Comportamento em modo FIPS

Este módulo não realiza nenhuma operação criptográfica.

Modelo de ameaças

Os PDFs de entrada não confiáveis que carregam conteúdo ativo são a entrada principal. Mitigação: content disarm and reconstruction antes da linearização e da entrega; o artefato de entrega é excluído de nova assinatura e de novo arquivamento para proteger a integridade probatória.

Contrato de comportamento

• EFilingOptimizer executa um pipeline fixo: content disarm and reconstruction, linearização e, então, uma verificação de tamanho com divisão por busca binária quando um limite do perfil é excedido.
• Um documento já abaixo do limite do perfil retorna um único segmento de tamanho inalterado.
• Uma única página acima do limite é retornada como um segmento fora do limite com um aviso; ela não pode ser dividida ainda mais.
• Um artefato de protocolo eletrônico é final para transmissão e não deve voltar a entrar em um pipeline de assinatura ou de arquivamento; o reprocessamento quebraria as cadeias de hash e a integridade probatória.

Limite de publicação

Esta página documenta apenas o comportamento observável externamente e a superfície pública de API suportada. Caminhos de namespace internos, classes auxiliares, tabelas de mecanismo, nomes de arquivo de runbook e prefixos de tíquete estão fora do escopo.

Fallback do Core

O NextPDF Core não tem otimizador de protocolo eletrônico por perfil de jurisdição, nenhuma etapa de higienização CDR e nenhum divisor por tamanho. Uma implantação somente Core deve construir por conta própria qualquer pipeline de preparação para protocolo.

Fallback do Pro

O NextPDF Pro não fornece o otimizador de protocolo eletrônico por perfil de jurisdição, os perfis integrados PACER / EU e-Justice / Taiwan Judicial Yuan, a etapa de higienização CDR nem o divisor por tamanho. Uma configuração que solicita otimização de protocolo eletrônico orientada por perfil em uma implantação somente Pro não tem nenhum componente Enterprise para satisfazê-la. Consulte a visão geral do Enterprise para a superfície Enterprise.

Nota sobre o limite do Enterprise

Os detalhes internos do mecanismo permanecem na documentação interna do repositório de origem e estão fora do escopo deste manual.

Limite de implantação

Os limites dos perfis integrados codificam restrições comumente publicadas por conveniência, não um feed ao vivo de cada portal; verificá-las em relação às regras atuais do cartório de destino antes de protocolar é responsabilidade do protocolante. O processamento é em processo e local; o módulo não faz nenhuma chamada de rede de saída. O transporte a um tribunal, cartório ou portal de protocolo é externo a este módulo.

Limite de conformidade legal

O NextPDF prepara formatos para protocolo eletrônico em tribunais / órgãos governamentais conforme configurado por um perfil de jurisdição. Ele não garante que um documento seja aceito por nenhum tribunal, cartório, instância ou portal de protocolo, e não fornece aconselhamento jurídico. As regras de protocolo, os formatos aceitos, os limites de tamanho, os requisitos de assinatura e os prazos processuais são definidos pela autoridade competente, variam por jurisdição e mudam. Verificar e cumprir essas regras é responsabilidade do protocolante. Consulte um advogado e a orientação atual do cartório de destino.

Consulte também

• Referência de Protocolo Eletrônico de Documentos — superfície pública completa da API deste módulo.
• Invoice — geração de faturas estruturadas.
• Visão geral do Enterprise
• Matriz de recursos Core vs Pro vs Enterprise