> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/faq/it/etichette-barcode/risoluzione-dei-problemi.md).
# Risoluzione dei problemi
***
#### **Come faccio a configurare la scansione dei codici a barre in BoxHero?**
Per iniziare a scansionare i codici a barre:
1. Collega un dispositivo Bluetooth **codice a barre** **scanner**, oppure
2. Usa la **fotocamera del tuo** **telefono** tramite l’app mobile BoxHero.
L’app rileverà e leggerà automaticamente i codici a barre una volta connessa.
#### **Perché i miei codici a barre vengono stampati in rosso?**
Un contorno rosso nell’area del codice a barre di solito significa che all’articolo non è stato assegnato alcun codice a barre. Aggiungi un codice a barre valido all’articolo e prova a stampare di nuovo.
Se a un codice a barre è già stato assegnato, verifica se contiene caratteri speciali — i codici a barre devono contenere solo numeri o lettere.
#### **Le mie etichette sono disallineate. Come posso risolvere?**
Se le tue etichette vengono stampate nella posizione sbagliata (ad esempio spostate, di lato o con un angolo di 90 gradi), prova questi passaggi in ordine.
1. Assicurati che la carta per etichette sia caricata correttamente e allineata all’interno della stampante.
2. Conferma che la dimensione dell’etichetta selezionata in BoxHero corrisponda al foglio o al rotolo di etichette che stai effettivamente usando.
3. Controlla le impostazioni della stampante:
1. Per **stampanti** **standard**, assicurati che il foglio delle etichette sia inserito nell’orientamento corretto — se è capovolto o invertito, la posizione di stampa potrebbe spostarsi.
2. Per **termiche** **standard**, verifica che la dimensione corretta della carta sia configurata nelle impostazioni della stampante del tuo sistema (*Pannello di controllo* > *Bluetooth e dispositivi* > *Stampanti e scanner* > *Preferenze di stampa)*.
#### **Il mio codice a barre non si scansiona dopo la stampa.**
Controlla se il codice a barre è stato stampato chiaramente senza sbavature, sbiadimenti o distorsioni. Se appare sfocato, prova a regolare l’intensità di stampa e a disattivare il dithering nelle impostazioni della stampante.
Se stai usando uno scanner esterno, prova a scansionare il codice a barre in un editor di testo come **Blocco note**. Il numero del codice a barre dovrebbe apparire seguito da un a capo automatico. Se non accade, controlla il manuale dello scanner per abilitare il suffisso del tasto `Invio` .
#### **L’anteprima di stampa è diversa dalla stampa effettiva.**
Assicurati che la dimensione dell’etichetta selezionata in BoxHero e la dimensione della carta nelle impostazioni della stampante corrispondano entrambe alle dimensioni effettive della tua etichetta. Per le stampanti termiche, la dimensione della carta deve essere impostata anche a livello di sistema nelle preferenze della stampante del tuo OS.
#### **Le mie etichette vengono stampate vuote o tagliate.**
Controlla che il supporto sia caricato correttamente e che il formato dell’etichetta in BoxHero corrisponda alla tua carta effettiva. Per le stampanti termiche, disattiva il dithering nel driver della stampante — questa è una causa comune di output vuoto o sbiadito.
* Nei driver Zebra, imposta il dithering su "**Clipart**" sotto **Grafica** **Opzioni** > **Dithering**.
* Nei driver BarTender, impostalo su "**Nessuno**" sotto la scheda **Grafica** > **Dithering**. Se le etichette vengono tagliate, è probabile che la dimensione della carta nelle impostazioni della stampante del sistema non corrisponda al rotolo che stai usando.
{% tabs %}
{% tab title="Zebra" %}
{% endtab %}
{% tab title="BarTender" %}
{% endtab %}
{% endtabs %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://www.boxhero.io/docs/faq/it/etichette-barcode/risoluzione-dei-problemi.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.