Inicio / Tutoriales / Comprar y trabajar con proveedores

Borrador sin revisar. Este tutorial todavía no pasó la revisión editorial y no se indexa.

Cómo cargar una compra con foto e IA en ADEstock

Sacarle una foto a la boleta o factura del proveedor y que el sistema lea los renglones solo, los asocie a tus productos, calcule el flete si lo hay, y deje…

Para quién
Dueño, Administrativo
Dónde
POS · Panel
Tiempo
3 a 5 minutos por boleta (menos cada vez)
Necesitás
el módulo *Compras con foto (OCR)* activado y una API key de IA cargada (ver *Antes de empezar*)
Permiso
acceso al módulo de compras; la configuración de la API la hace el dueño
Módulo
compra (Compra simple OCR), producto, agenda (Proveedor)
Verificado
· versión por confirmar

Qué vas a lograr

Sacarle una foto a la boleta o factura del proveedor y que el sistema lea los renglones solo, los asocie a tus productos, calcule el flete si lo hay, y deje la compra lista para actualizar el stock, los costos y la deuda con el proveedor.

Lo más importante de este tutorial: la primera vez que le comprás a un proveedor, el sistema aprende cómo escribe ese proveedor cada producto. Desde la segunda boleta, los reconoce solo. Está explicado en El sistema aprende de cada compra.

Antes de empezar (una sola vez, lo hace el dueño)

1. Activar el módulo

Menú rápido → Configuración → Módulos y sistema → Compras con foto (OCR) y Guardar cambios.

2. Cargar tu API key de IA

El OCR usa tu propia cuenta de un proveedor de IA (por ejemplo Google Gemini). Vos ponés tu API key y pagás solo lo que consumís, que por boleta es del orden de centavos de dólar.

Panel de administración → Billeteras → Configuraciones API OCR → Agregar.

Configuración de la API de OCR
Configuración de la API de OCR
#CampoQué poner
1Model idEl modelo de IA que va a leer las boletas. Por ejemplo gemini-2.5-flash
2API KeyTu clave. Se guarda cifrada y después solo se muestra enmascarada
3Límite diarioMáximo de boletas por día (protege tu gasto)
4Presupuesto mensual (USD)Tope de gasto mensual del OCR

Guardá. Queda así, con la clave enmascarada:

Configuración guardada
Configuración guardada

Consejo: si el modelo que viene por defecto ya no existe en tu proveedor, la lectura falla. Probá con uno vigente de la lista de modelos de tu cuenta.

En la parte de arriba de la pantalla de compras vas a ver el estado: Modo API Key cliente · modelo · Est. OCR: N (tokens estimados por lectura).

Paso a paso

Abrí Menú rápido (F8) → Compras (carga rápida) (Cargar facturas con IA). Aparece cuando el módulo Compras con foto (OCR) está activado. La pantalla vive en la dirección /compras/simple/: podés guardarla como favorito o como acceso directo en el celular. Son 4 pasos.

Paso 1 · La foto

Inicio de compras
Inicio de compras
  1. Zona de carga: arrastrá la foto o hacé clic para elegirla. Acepta JPG, PNG, WEBP o PDF (hasta 20 MB). Desde el celular abre la cámara.
  2. Subir y procesar: manda la boleta al OCR en segundo plano.
  3. Carga rápida manual (sin OCR): si no querés usar IA, cargás los renglones a mano.
Foto elegida
Foto elegida

Mientras la IA lee, ves este aviso y podés cargar otra boleta:

Procesando
Procesando

Para que la lectura salga bien:

  • Foto derecha, de frente y completa (que se vea el total).
  • Con buena luz y sin sombras ni dedos tapando renglones.
  • Si la boleta es larga, sacala en partes con la foto del total incluida.
  • Cuanto más clara la foto, mejor aprende el sistema y menos tenés que corregir.

Cuando termina, el sistema pasa solo al paso 2. Si salís y volvés, la boleta queda en Precargas pendientes y la retomás con Retomar.

Paso 2 · El proveedor

Paso 2 proveedor
Paso 2 proveedor
#ElementoQué es
1Proveedor detectadoEl nombre que la IA leyó en la boleta
2Proveedor seleccionadoElegí cuál de tus proveedores es
3Nuevo proveedorSi es la primera vez que le comprás, lo creás en el momento (empresa y CUIT alcanzan)
4Alias del proveedorCómo figura en las boletas. Se guarda para reconocerlo la próxima vez

Elegí el proveedor y tocá Continuar.

Proveedor elegido
Proveedor elegido

Primera vez: elegís vos el proveedor. Próximas veces: el sistema lo reconoce por el alias y lo deja seleccionado solo (lo ves en la segunda boleta).

Paso 3 · Checks rápidos: IVA, forma de pago y flete

Paso 3 checks
Paso 3 checks
#PreguntaQué responder
1¿La factura discrimina IVA?Tildalo si la boleta es una factura con IVA separado. Una boleta común, no
2¿Cómo se paga esta compra?Efectivo, Transferencia o Cuenta Corriente Proveedor (la pagás después: queda como deuda con el proveedor)
3¿Agregar gasto de flete?Si la compra tuvo un envío, tildalo (ver abajo)

El flete: tres formas de manejarlo

Cuando tildás Sí, incluir flete aparecen las opciones. Primero indicás cuánto es:

  • $ Monto fijo: el importe en pesos del flete.
  • % del total de productos: un porcentaje sobre el total de la compra.
  • Redondear a múltiplo de $: para que el flete quede en un número redondo.

Después decidís quién lo cobra y cómo se registra. Hay tres combinaciones:

A. El flete se paga aparte (opción por defecto)

Los dos tildes apagados. Es lo que pasa cuando el flete lo cobra otra persona (un transportista) o lo pagás por otro lado.

Flete como gasto aparte
Flete como gasto aparte
  • El flete queda como un gasto separado (balance de fletes).
  • No se suma a lo que le debés al proveedor.
  • No cambia el costo de los productos.
B. El flete se paga con la compra, al mismo proveedor

Tildás “El flete se paga con esta compra al proveedor”. Es cuando el proveedor te factura el flete junto con la mercadería.

Flete pagado al proveedor
Flete pagado al proveedor
  • El flete se suma a lo que le debés (o le pagás) al proveedor.
  • No va al balance de fletes.
  • El costo de los productos no cambia: el flete queda como un renglón aparte.
C. El flete se paga con la compra y se prorratea en los productos

Tildás los dos: “se paga con esta compra” y “Prorratear el costo del flete en los productos”. Es la opción correcta si querés que el costo real de cada producto incluya su parte del envío.

Flete prorrateado
Flete prorrateado
  • El flete se reparte proporcionalmente entre los productos, según lo que cuesta cada uno.
  • Cada producto sube su costo unitario con su parte del flete.
  • Ya no queda un renglón de flete: está dentro de los productos.
  • Lo que le debés al proveedor es el total de productos (que ya incluye el flete).

El prorrateo solo se puede usar si el flete se paga con la compra. Si el flete es un gasto aparte, no se prorratea.

Ejemplo con números

Boleta de $ 80.345 y un flete de $ 4.000:

A. AparteB. Con la compraC. Con la compra + prorrateo
Le debés al proveedor$ 80.345$ 84.345$ 84.345
El flete figura comoGasto de fletesFlete de la compra(dentro de los productos)
Costo del Actron (comprado a $ 9.008)$ 9.008$ 9.008$ 9.456,47
¿Cambia el costo de los productos?NoNoSí, +4,98 %

El 4,98 % sale de $ 4.000 ÷ $ 80.345: cada producto absorbe esa proporción del flete.

¿Cuál elijo?

SituaciónOpción
El flete lo cobra un transportista distinto del proveedorA
El proveedor te factura el flete, y no te importa repartirloB
El proveedor te factura el flete y querés que tus costos y márgenes sean realesC (recomendada)

Tocá Continuar a productos.

Paso 4 · Productos y alias

Acá se asocia lo que dice la boleta con tus productos.

Paso 4 productos
Paso 4 productos

La tabla tiene una fila por renglón de la boleta:

ColumnaQué es
Nombre extraído de la fotoLo que la IA leyó. Debajo está el alias corregido: podés editarlo
ProductoEl producto de tu catálogo al que corresponde
Cant. / Precio unit. / Desc% / TotalLos valores leídos. Podés corregirlos
Act. costoSi lo dejás tildado, el costo del producto se actualiza con este precio de compra
QuitarSaca el renglón de la compra

Los colores indican el estado de cada renglón:

  • 🟢 Verde: ya tiene producto asignado.
  • 🔴 Rojo: falta asignarle un producto.

Productos que el sistema sugiere solo

Cuando el nombre de la boleta se parece a uno de tus productos, el sistema lo propone solo (verde). Revisá que sea el correcto.

Sugerencias automáticas
Sugerencias automáticas

Productos que tenés que asignar vos

Para los renglones en rojo, escribí parte del nombre en Producto y elegí el correcto de la lista (se ve el stock y el costo actual).

Buscando producto
Buscando producto

Si no sabés cuál es, usá Búsqueda avanzada.

Productos nuevos: crearlos al vuelo

Si es un producto que todavía no tenés, tocá + Crear producto. Se abre un formulario con el nombre y el costo ya cargados desde la boleta. Completás categoría y precio de venta y listo: el producto queda creado y asignado al renglón.

Crear producto desde la boleta
Crear producto desde la boleta

Controlá los totales

Cuando todos los renglones están en verde:

Totales
Totales
#TotalQué es
1Total OCRLo que la IA leyó como total de la boleta
2Total actualLa suma de los renglones tal como los dejaste
3DiferenciaDebería ser $ 0. Si no, hay un renglón mal leído o un producto sin asignar

Botones de abajo: Agregar renglón manual (por si la IA salteó uno), Guardar y continuar (queda como precarga para seguir después), Crear compra, Descargar PDF compra y Cancelar.

Resumen y creación de la compra

Tocá Crear compra. Antes de guardar, el sistema te muestra un resumen:

Resumen antes de confirmar
Resumen antes de confirmar
DatoQué significa
Líneas detectadas por OCRCuántos renglones leyó la IA
Líneas con producto asignadoCuántas quedaron asociadas
Líneas huérfanasSin producto: se ignoran al guardar. Idealmente 0
Unidades totales a ingresarCuánto stock va a sumar
Total detectado vs. calculadoDebe coincidir. Si no, te avisa con la diferencia
FleteLo que configuraste en el paso 3

Si todo está bien, Crear compra. Si no, Volver a revisar.

Compra creada
Compra creada

La compra aparece en Compras creadas. Todavía no impactó en el stock: falta el último paso.

Confirmar la compra

La compra se crea pendiente de confirmación, para que puedas revisarla antes de que mueva stock y plata. Se confirma desde el panel de administración:

Panel de administración → Compra → Compras.

Compra pendiente
Compra pendiente

La compra figura con estado ⏳ Pendiente. Marcá la casilla y elegí la acción Confirmar compra:

Acción confirmar compra
Acción confirmar compra

Aparece La compra se ingresó correctamente y el estado pasa a ✓ Aprobada:

Compra confirmada
Compra confirmada

Recién ahí:

  • el stock de cada producto aumenta en lo comprado;
  • el costo de los productos se actualiza (los que tienen Act. costo tildado);
  • se registra el pago o la deuda con el proveedor, según lo que elegiste.

El sistema aprende de cada compra

Esta es la parte que hace que cada boleta sea más rápida que la anterior.

Qué guarda el sistema

Cada vez que asociás un renglón de la boleta con uno de tus productos, el sistema guarda esa relación para ese proveedor:

“Cuando Distribuidora Ejemplo escribe Actron 600 x 10 comp, se trata de tu producto Actron 600 mg x 10 comprimidos.”

Eso se llama alias. Se guarda por proveedor, junto con el historial de compras (precios, fechas, cantidades).

Por qué es por proveedor

Cada proveedor escribe a su manera. Lo que un proveedor llama Alf rasta negro otro lo puede llamar Alfajor Rasta Choc.. Guardarlo por proveedor evita confundir productos.

Qué pasa en las primeras compras

CompraQué tenés que hacer
1.ª boleta de un proveedorElegir el proveedor y asociar cada renglón a tu producto (o crearlo). El sistema aprende todo
2.ª boletaLos renglones ya conocidos aparecen solos. Asociás solo los nuevos
A partir de ahíCasi todo se reconoce solo. Solo revisás precios y totales

Por eso conviene hacer bien las primeras compras de cada proveedor: elegir con cuidado el producto correcto es lo que “entrena” al sistema. Un alias mal asociado se repite en las próximas boletas.

Dónde ver lo que aprendió el sistema

En el panel de administración, menú Compra, hay dos listados:

  • Aliases OCR de Productos: cada nombre de boleta asociado a tu producto, por proveedor.
  • Aliases OCR de Proveedores: cómo aparece cada proveedor en sus boletas.
Alias de productos
Alias de productos
ProveedorTexto OCR (como lo escribe la boleta)Producto (el tuyo)Veces confirmado
Distribuidora EjemploActron 600 x 10 compActron 600 mg x 10 comprimidos2
Distribuidora EjemploSertal compuesto x 10 compSertal Compuesto x 10 comprimidos2
Distribuidora EjemploCuritasApósitos adhesivos surtidos1
Distribuidora EjemploAlf rasta negroAlfajor Rasta negro1

La columna Veces confirmado sube cada vez que el sistema vuelve a ver ese nombre y lo confirmás: cuantas más veces, más confiable es el alias. Los dos primeros ya pasaron por dos boletas.

Alias de proveedores
Alias de proveedores

El alias del proveedor (PROVEEDOR DE EJEMPLO) también cuenta cuántas veces se usó. Con él, el sistema selecciona al proveedor solo.

La segunda boleta: el sistema ya conoce al proveedor y sus productos

Subimos una segunda boleta del mismo proveedor. Ahora el sistema:

  1. Lee el proveedor y lo deja seleccionado solo:
Proveedor reconocido
Proveedor reconocido
  1. Reconoce los productos que ya compraste (Actron, Sertal, Prestobarba) sin que hagas nada. Los nuevos quedan en rojo:
Reconocimiento automático
Reconocimiento automático

En cada renglón reconocido, el sistema te muestra además el último costo y la fecha de la compra anterior, para que veas de un vistazo si el proveedor cambió el precio.

  1. Los renglones que no conoce los podés asignar, crear o quitar:
Solo los reconocidos
Solo los reconocidos

Si quitás renglones, el resumen te avisa que el total calculado difiere del de la boleta (porque dejaste productos afuera). Es normal si lo hiciste a propósito:

Resumen de la segunda compra
Resumen de la segunda compra

Flete aparte, en la segunda boleta

En esta segunda compra usamos la opción A (flete aparte, $ 2.500) y pagamos en efectivo:

Flete como gasto separado
Flete como gasto separado

En el listado de compras se ve la diferencia con la primera:

Compras en el admin
Compras en el admin
CompraTotal productosTotal pagosFletesTotal general
#2 (flete prorrateado, a cuenta corriente)$ 84.345$ 84.345—$ 84.345
#4 (flete aparte, en efectivo)$ 17.788$ 17.788$ 2.500$ 20.288

En la #2 el flete está dentro de los productos (por eso 84.345 y sin columna de flete). En la #4 el flete es un concepto aparte y no sube lo que se le paga al proveedor.

Qué pasa por detrás

QuéDetalle
LecturaLa foto se manda al modelo de IA con tu API key. Devuelve proveedor, renglones, cantidades y precios
AliasSe guardan por proveedor y producto: el nombre leído de la boleta, el producto elegido y el historial de precios
CompraSe crea sin confirmar. No toca stock ni plata hasta que la confirmás
Flete prorrateadoSe reparte proporcional al total de cada renglón y se suma al precio unitario. El último renglón absorbe el redondeo
Flete que se paga con la compraSuma a total a pagar al proveedor
Flete aparteQueda como gasto separado, fuera de lo que se le debe al proveedor
Costo del productoCon Act. costo tildado, pasa a ser el precio de compra (más el flete prorrateado, si hubo)
LímitesSi se alcanza el límite diario o el presupuesto mensual, el sistema no usa más IA y te habilita la carga manual para que puedas seguir

Problemas frecuentes

Si te pasa…Es porque…Qué hacer
No veo Compras con fotoEl módulo está apagadoConfiguración → Módulos y sistema → Compras con foto (OCR)
“La configuración OCR no tiene API key”Falta cargar la clavePanel admin → Configuraciones API OCR
Falla la lectura con error del proveedor de IAEl modelo configurado ya no existe, o la clave no tiene saldoCambiá el modelo o revisá tu cuenta del proveedor de IA
“Se alcanzó el límite diario” / “presupuesto mensual”Llegaste al máximo configuradoSubí el límite o continuá con carga manual (se habilita sola)
El OCR leyó mal una cantidad o un precioFoto poco claraCorregilo a mano en el paso 4 (los campos son editables)
La Diferencia no es $ 0Un renglón mal leído, faltante o sin asignarCompará con la boleta y corregí; usá Agregar renglón manual
Un producto se asocia mal siempreEl alias quedó mal aprendidoCorregí el producto en ese renglón y revisá los alias (ver Dónde ver lo que aprendió el sistema)
La compra no mueve el stockQuedó pendienteConfirmala en Panel admin → Compra → Compras → Confirmar compra
Me equivoqué con el flete—Antes de confirmar, no hay efecto: eliminá la compra pendiente y volvela a cargar

Siguiente paso

  • Cargar una compra manual y pagarla
  • Pagar a un proveedor y revisar su cuenta corriente
  • Entrenamiento con compras pasadas (modo retroactivo)

¿Te sirvió?

Si algo no coincide con lo que ves en tu pantalla,escribinos indicando este tutorial(nos ayuda saber que es cargar-compras-con-foto-ia).