Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Hai difficoltà ad aggiungere codici a barre ai PDF? Ecco la soluzione completa!

· 7 minuti di lettura
Sankalp Mishra
SEO and Content Writer

Immaginate questa situazione: state creando un sistema di gestione degli ordini. Tutto funziona alla perfezione finché il cliente non chiede: "Possiamo aggiungere i codici a barre di tracciamento alle fatture?". Improvvisamente, vi ritrovate immersi in un labirinto di librerie di codici a barre, standard di codifica e particolarità della manipolazione dei PDF.

Vi suona familiare? Non siete i soli. L'integrazione dei codici a barre è una di quelle funzionalità che sembrano semplici finché non le si implementa.

Questa guida semplifica l'argomento. Esploreremo approcci pratici per aggiungere codici a barre ai PDF, quando utilizzare ciascun tipo di codice a barre e come evitare gli errori più comuni.

Scegliere il tipo di codice a barre giusto​

Non tutti i codici a barre sono uguali. Il formato da scegliere dipende da cosa si sta codificando e da dove verrà scansionato.

Quando utilizzare i codici a barre 2D​

I codici a barre 2D memorizzano i dati sia in orizzontale che in verticale, consentendo loro di contenere molte più informazioni rispetto ai codici a barre lineari.

Codice QRIl formato 2D più riconosciuto. Ideale per URL, informazioni di contatto o qualsiasi dato che possa essere scansionato da smartphone. Può memorizzare fino a 4.296 caratteri alfanumerici.

DataMatrixCompatto e affidabile. Molto diffuso nei settori manifatturiero e sanitario, dove lo spazio è limitato. Offre una migliore correzione degli errori rispetto ai codici QR.

PDF417Utilizzato su carte d'identità, carte d'imbarco ed etichette di spedizione. Può codificare dati equivalenti a quelli di interi documenti.

Ideale per: URL, payload di dati di grandi dimensioni, scansione mobile, ambienti soggetti a errori

Strategie di posizionamento​

La posizione in cui si posiziona un codice a barre è importante tanto quanto il tipo di codice utilizzato. Un posizionamento errato può causare errori di scansione.

Migliori pratiche di posizionamento

  • Zona silenziosaLasciare uno spazio bianco intorno al codice a barre (almeno 10 volte la larghezza della barra più stretta).
  • Evitare le piegheNon posizionare i codici a barre dove i documenti vengono solitamente piegati.
  • Posizione fissaUtilizza la stessa posizione per tutti i tipi di documento per una scansione più rapida
  • Tagliare in modo appropriato, Più grande non è sempre meglio; adatta le dimensioni alla distanza dello scanner

Implementazione con API PDF4me​

L'endpoint "Aggiungi codice a barre" di PDF4me gestisce la generazione del codice a barre e l'incorporamento del PDF in un'unica chiamata API:

POST https://api.pdf4me.com/api/v2/addbarcode

Parametri chiave:

ParametroDescrizioneEsempio
barcodeTypeFormato da generare"QrCode", "Code128"
textDati da codificare"https://example.com"
pageNrPagina di destinazione (indicizzata da 1)1
x, yPosizione in punti50, 700
width, heightDimensioni in punti100, 100

Per il riferimento completo dei parametri, vedere il documentazione API.

Scenari del mondo reale​

Scenario 1: Monitoraggio delle fatture

Problema: Il team finanziario ha bisogno di tenere traccia delle fatture pagate tramite la scansione di un codice.

Soluzione: Aggiungi un codice QR a ogni fattura che codifichi l'ID della fattura stessa. Una volta scansionato, attiverà una ricerca nel tuo sistema di pagamento.

Tipo di codice a barre: Codice QR (compatibile con smartphone, codifica ID alfanumerici) Posizione: Angolo in alto a destra, presente in tutte le fatture

Scenario 2: Liste di prelievo in magazzino

Problema: Gli addetti al magazzino devono scansionare rapidamente gli articoli presenti nelle liste di prelievo per confermare la selezione.

Soluzione: Aggiungere i codici a barre Code128 accanto a ciascuna voce dell'articolo, codificandone il codice SKU.

Tipo di codice a barre: Codice 128 (scansione rapida con dispositivi portatili) Posizione: Margine sinistro, allineato con ciascuna riga del prodotto

Scenario 3: Biglietti per eventi

Problema: Gli organizzatori di eventi necessitano di biglietti scansionabili compatibili con app per smartphone e scanner dedicati.

Soluzione: Genera biglietti in formato PDF con codici QR che codificano un ID univoco del biglietto e i dettagli dell'evento.

Tipo di codice a barre: Codice QR (compatibile con qualsiasi dispositivo dotato di fotocamera) Posizione: Centro del biglietto, sufficientemente grande per una scansione rapida

Scenario 4: Documenti di conformità

Problema: I documenti legali richiedono identificatori leggibili da una macchina per garantire la conformità normativa.

Soluzione: Aggiungi i codici a barre PDF417 che codificano i metadati del documento e gli hash di verifica.

Tipo di codice a barre: PDF417 (elevata capacità di dati, standard di settore per i documenti di identità) Posizione: Area del piè di pagina, non interferisce con il contenuto del documento

Prova prima di costruire​

Prima di scrivere il codice di integrazione, convalida il tuo approccio utilizzando il nostro tester API interattivo. Puoi sperimentare con diversi tipi, posizioni e dimensioni di codici a barre per vedere esattamente come vengono visualizzati.

Open Barcode API TesterView API Documentation

Guida rapida: Tipi di codici a barre​

Elevata capacità di dati

  • Codice QR, fino a 4.296 caratteri
  • PDF417, fino a 1.850 caratteri
  • DataMatrix, fino a 2.335 caratteri

Scansione rapida

  • Codice 128, standard logistico
  • Code39, compatibile con le versioni precedenti
  • EAN-13, ottimizzato per la vendita al dettaglio

Prossimi passi​

Pronti ad aggiungere codici a barre ai vostri PDF?

  1. Ottieni la tua chiave API: Inizia gratuitamente
  2. Prova l'API Tester: Sperimenta senza codice
  3. Esplora esempi di codiceEsempi in C#, Python, Java e JavaScript
  4. Leggi la documentazione completa: Riferimento completo ai parametri
Get Started Free