Sistema de gestión de bultos con lector de código de barras | Caso TecnoBus

El desafío

Saber dónde está cada bulto

La operación es solo de depósito y despacho: no hay facturación ni ventas, y eso quedó afuera a propósito.

1

Seguir cada bulto

Ingreso, stock, despacho y seguimiento: cada bulto tiene su código y su estado (en depósito, en tránsito o entregado).

2

Despachar sin equivocarse de cliente

Un despacho tiene un solo destino: el primer código leído define el cliente, y la pistola rechaza cualquier bulto de otro.

3

Etiquetar y reetiquetar rápido

Etiquetas de 100×150 o de 100×60 mm con código de barras; para reimprimir se tildan varios bultos desde Stock.

4

Saber qué remito tiene cada transportista

Los remitos son un registro atado a cada despacho y a su transportista. Se busca por remito, código, cliente o transportista en una sola caja.

Remitos preimpresos 100×60Búsqueda únicaHistorial por transportistaTablero del díaFechas en hora argentinaUsuarios y roles

Cómo funciona

Del ingreso al despacho

El recorrido de un bulto dentro del depósito.

Ingreso

Se cargan los bultos de un cliente; el sistema les asigna códigos y se imprimen las etiquetas.

Seguimiento

Cada bulto tiene su estado y su historial, y se encuentra por código, cliente, remito o transportista.

Despacho con pistola

Se leen los bultos del pallet y se van sumando; la pantalla deja rastro de cada lectura.

Remito

Al confirmar, el número de remito queda atado al despacho y al transportista.

Los equipos

Qué se usa en el depósito

No hay equipos especiales: la pistola y la impresora se comportan como un teclado y una impresora común, y el sistema se encarga del resto.

Lectura

Lector de código de barras

La pistola lee el bulto y el sistema lo suma al despacho. Para el navegador, la pistola es un teclado que escribe el código.

Conexión: Se comporta como un teclado: escribe donde está el cursor
Rechaza: Código inexistente, ya despachado, de otro cliente o repetido
Rastro: Las últimas lecturas quedan a la vista con ✓, = o ✕

Etiquetas

Etiquetas de bulto

Dos medidas, 100 × 150 y 100 × 60 mm, con el código de barras Code128 y los datos del destino.

Medidas: 100×150 mm y 100×60 mm, a elección
La chica: No es la grande achicada: se le sacan datos para que el código se pueda leer
Impresión: Desde el navegador; la impresión térmica directa está en desarrollo

Remitos

Remitos preimpresos 100 × 60 mm

Formularios en blanco, en papel autoadhesivo, que el depósito completa a mano. Cada uno trae su número y un código de barras.

Contenido: Talón con número, origen y destino, remitente y destinatario, firma
Número: Lo da el servidor: dos tandas seguidas nunca arrancan en 1
Búsqueda: El código de barras se lee con la pistola para encontrarlo

Arquitectura

Cómo se conecta todo

Las pantallas y la API viven en un único Worker de Cloudflare. En el depósito, la pistola y la impresora trabajan con el navegador.

Nació como una aplicación en la red interna del depósito (Express y SQLite). Se pasó a Cloudflare Workers y D1 sin tocar el frontend: al compartir origen no hay CORS ni un segundo proyecto para publicar.

Cloudflare WorkerD1 (SQLite)JavaScript sin buildCode128JWTImpresión por navegador

Decisiones de diseño

Lo que no se ve, pero importa

Un depósito no puede esperar a que el sistema se acomode: estas decisiones salieron de problemas reales.

La pistola no se cuelga

Después de cada lectura el foco vuelve al campo, y cada lectura deja rastro en pantalla: el operario mira el bulto, no el monitor.

Los números nunca se repiten

Los códigos de bulto y los números de remito salen de un contador atómico en la base: con dos operarios despachando a la vez, nadie saca el mismo número.

Las fechas, en hora argentina

El servidor corre en UTC; para que un bulto ingresado a las 22:00 no figure con fecha de mañana, todo pasa por la hora de Argentina.

Cada bulto con su código de barras