CAPÍTULO 1El circuito de puesta en marcha
AxerOK se configura en un orden determinado, y ese orden no es arbitrario: cada paso necesita que el anterior esté guardado. Este capítulo es el mapa. Los capítulos que siguen son cada paso en detalle.
Los cuatro objetos que hay que entender
Casi toda la configuración de AxerOK gira alrededor de cuatro cosas. Si estas cuatro quedan claras, el resto del manual se lee solo.
| Objeto | Qué es |
|---|---|
| Empresa | La razón social. Tiene el CUIT, la condición frente al IVA y el certificado de ARCA. Es quien factura. |
| Sucursal | El local físico de esa empresa. Tiene domicilio y define el membrete del ticket. Una empresa puede tener muchas. |
| Caja | El puesto de trabajo (la PC o terminal donde se vende). Pertenece a una sucursal. Es lo que el cajero elige al iniciar sesión. |
| Diario | El libro de emisión: define cómo se factura (el sistema) y con qué número de punto de venta de ARCA. La caja no factura por sí misma: factura por el diario que tiene asignado. |
El orden de trabajo
Este es el circuito completo, de un comercio vacío a la primera factura.
- Crear la empresa — razón social, CUIT, condición IVA. Ajustes → Empresas · Capítulo 2
- Cargar el certificado ARCA — generar la clave, pedir el certificado a ARCA, importarlo y delegar el servicio. Ajustes → Empresas → solapa Facturación electrónica · Capítulo 3
- Crear los diarios — uno por cada punto de venta dado de alta en ARCA. Menú → Contabilidad → Diarios · Capítulo 4
- Crear la sucursal — domicilio y membrete del ticket. Ajustes → Empresas → solapa Sucursales · Capítulo 5
- Crear las cajas — una por puesto de trabajo, con su host y su depósito. Ajustes → Empresas → solapa Cajas · Capítulo 6
- Asignar el diario a cada caja — recién acá la caja puede facturar. Ficha de la caja → fila Diarios · Capítulo 7
- Configurar los medios de cobro — el catálogo de la empresa y qué usa cada sucursal. Solapa Sucursales → botón Medios de cobro · Capítulo 8
- Impuestos y percepciones — categorías de IVA y, si corresponde, agentes de recaudación. Menú → Contabilidad → Configuración · Capítulo 10
- Usuarios y roles — quién entra, a qué empresa y a qué caja. Menú → Ajustes → Usuarios / Roles · Capítulo 11
- Catálogo — almacenes, productos, clientes y proveedores. Menú → Inventario · Capítulo 12
- Periféricos de cada PC — impresora, balanza, visor, gaveta y lector. Ajustes → Configuración → Periféricos · Capítulo 13
- Cargar la licencia — el token que llega al comprar. Habilita la conexión de los celulares y las actualizaciones; el POS vende igual sin ella. Ajustes → Configuración → solapa Licencia · Capítulo 13
Dónde está cada cosa
La configuración vive en dos lugares distintos, y saber cuál es cuál ahorra mucho tiempo:
| Lugar | Qué se configura ahí |
|---|---|
| Menú → Ajustes | Las entradas directas: Empresas (lo fiscal: empresas, ARCA, sucursales, cajas, medios de cobro), Configuración (lo de esta PC: periféricos, ticket, base de datos, apariencia, licencia), Usuarios, Roles y Servidores de correo. |
| Configuración (al pie de cada aplicación) | El índice compartido con el resto del negocio: recursos, impuestos, categorías, percepciones, agentes de recaudación, CAEA y almacenes. |
ARCA, no AFIP
En toda la interfaz se dice ARCA. El modo de facturación se llama «Factura Electrónica (ARCA)» en las cinco pantallas donde aparece. Por dentro el sistema conserva la nomenclatura vieja (siglas WSFE, WSAA, CAE, CAEA y los endpoints), que es la que usa el propio organismo en su documentación técnica: esa asimetría es intencional.
CAPÍTULO 2La empresa
La empresa es la razón social que factura. Todo lo demás — sucursales, cajas, diarios, medios de cobro — cuelga de ella.
Se entra por Menú › Ajustes › Empresas. La pantalla tiene el selector de empresa arriba y, debajo, una tarjeta con el resumen de la empresa seleccionada.
Crear una empresa
- Tocá + Nueva empresa, arriba a la derecha. Se abre el diálogo «Nueva empresa» con cuatro solapas: General, Facturación electrónica (ARCA), Dirección y Logos.
- En General, completá los datos fiscales (la tabla de abajo).
- Tocá Guardar empresa. Recién con la empresa guardada se habilitan el certificado, las sucursales y los medios de cobro.
Solapa General
| Campo | Qué va |
|---|---|
| Razón social | El nombre legal, tal como figura en la constancia de inscripción. Es lo que se imprime en el comprobante si no hay alias. |
| CUIT | Sin guiones. Es la clave de todo lo fiscal: los puntos de venta se dan de alta contra este número. |
| Localización fiscal | Argentina (ARCA). Define el juego de comprobantes y validaciones. |
| Condición IVA | Responsable Inscripto, Monotributo, Exento o Resp. No Inscripto. Determina qué comprobantes emite la empresa (una Responsable Inscripto emite A y B; una Monotributo, C). |
| Ingresos brutos | El número de inscripción en IIBB. Sale impreso en el comprobante. |
| Inicio de actividades | Formato aaaa-mm-dd. También va impreso. |
| Alias | El nombre de fantasía. Si está cargado, es lo que se imprime en el membrete del ticket en lugar de la razón social. |
| Empresa activa (opera en la caja) | Destildado, la empresa deja de aparecer en las cajas. Sirve para dar de baja una razón social sin borrar su historia. |
Solapa Dirección
El domicilio fiscal de la razón social. No es el domicilio del local: ése va en la ficha de la sucursal (capítulo 5), y es el que sale en el membrete.
Solapa Logos
Las imágenes de la empresa para los comprobantes y los informes.
Qué muestra la tarjeta «Empresa seleccionada»
Debajo de la lista, una tarjeta resume el estado de la empresa con chips de color. El más importante es el del certificado:
- «Certificado · …» en verde: hay certificado cargado y muestra sus datos.
- «Sin certificado» en gris: la empresa todavía no puede facturar electrónicamente. Es el trabajo del capítulo 3.
Botones de la pantalla
| Botón | Qué hace |
|---|---|
| + Nueva empresa | Abre el alta. Requiere el permiso «Crear empresas». |
| Editar empresa | Abre la ficha de la empresa marcada. |
| Eliminar empresa | Sólo si no tiene historia fiscal. |
| Verificar PdV | Consulta el padrón de ARCA con la credencial de la empresa y lista los puntos de venta realmente habilitados para ese CUIT. Es la forma de saber qué números cargar en los diarios sin adivinar. |
| Medios de cobro… | Abre el catálogo de medios (capítulo 8). Pide la empresa guardada. |
| Diarios → | Atajo a la pantalla de Diarios de esta empresa. |
CAPÍTULO 3El certificado ARCA
Sin certificado no hay factura electrónica. Es un trámite de ida y vuelta con ARCA: AxerOK genera la clave y el pedido, ARCA devuelve el certificado, y AxerOK lo importa.
Todo pasa en Ajustes › Empresas, ficha de la empresa, solapa Facturación electrónica (ARCA).
Los campos
| Campo | Qué va |
|---|---|
| Ambiente ARCA | Homologación para probar, Producción para facturar de verdad. Son dos mundos separados: el certificado de homologación no sirve en producción. |
| Alias | El nombre con el que se identifica el certificado en ARCA. Conviene que diga algo (por ejemplo el nombre del comercio). |
| Unidad (OU) | La unidad organizativa del pedido de certificado. |
| Estado | Resumen en vivo: ✔ o ✗ para la clave privada y para el certificado. |
El trámite, paso a paso
- Generar clave. Crea la clave privada de la empresa y la guarda en la base de datos. Es el primer paso y no requiere internet.
- Descargar pedido (CSR). Genera el archivo de pedido de certificado. Guardalo: es lo que hay que subir a ARCA.
- En el sitio de ARCA, con clave fiscal, entrá al administrador de
certificados digitales, subí el CSR y descargá el certificado que devuelve
(archivo
.crt). - Importar certificado (.crt). De vuelta en AxerOK, cargá el archivo que bajaste de ARCA.
- Delegar el servicio. En ARCA, asociá el certificado al servicio de facturación electrónica (Web Service) para ese CUIT. Sin esta delegación el certificado existe pero ARCA rechaza la emisión.
- Verificar configuración. El botón revisa que esté todo y, si falta algo, dice exactamente qué.
Qué controla «Verificar configuración»
La verificación es local: comprueba lo que AxerOK puede comprobar solo, antes de que ARCA rechace nada. Detecta estos dos errores, que son los que más se dan y los más difíciles de diagnosticar después:
.crt que corresponde a esta clave, o
generá una clave nueva y pedí un certificado para ella.
Si la verificación pasa, el mensaje es explícito sobre su alcance: «Verificación local OK. Falta probar contra ARCA: que el certificado esté dado de alta y el servicio delegado a este CUIT». Ese último tramo sólo se confirma emitiendo.
Verificar PdV: qué puntos de venta existen realmente
El botón Verificar PdV consulta el padrón de ARCA con la credencial de la empresa y devuelve la lista de puntos de venta habilitados para ese CUIT en ese ambiente, con su sistema y si están bloqueados. Es el paso previo natural al capítulo 4: los números que se cargan en los diarios tienen que salir de esta lista.
CAPÍTULO 4Diarios: los puntos de venta
El diario es el libro de emisión. Define con qué sistema se factura y con qué número de punto de venta de ARCA. Es el corazón de la configuración fiscal.
Se entra por Menú › Contabilidad › Diarios.
Qué es exactamente un diario
Un diario tiene tres cosas: un nombre, un sistema de emisión y un número de punto de venta. La caja no factura por sí misma: factura por el diario que tiene asignado. Cambiar el diario de una caja cambia cómo y con qué numeración factura.
Los cuatro sistemas
| Sistema | Cuándo se usa | PdV |
|---|---|---|
| Factura Electrónica · Web Service | El caso normal. La caja pide el CAE a ARCA en el momento de cobrar. | Sí |
| Factura Electrónica CAEA | Contingencia: permite seguir emitiendo sin internet con un código pedido por adelantado (capítulo 14). | Sí |
| Factura Web | El régimen sin emisión desde el POS: la caja da el comprobante interno y la factura legal la hace el comerciante aparte, del talonario o del portal. | No |
| Controlador Fiscal Externo | La factura la emite un controlador fiscal homologado conectado al puesto. | No |
Crear un diario
- Elegí la empresa en el combo de la barra superior.
- Tocá + Nuevo diario. Se abre el diálogo «Nuevo diario».
- Nombre: se escribe en mayúsculas (el campo las fuerza). Si lo dejás como viene, se completa solo según el sistema elegido.
- Sistema: uno de los cuatro de la tabla de arriba.
- Punto de venta: el número dado de alta en ARCA. Debajo del campo está la regla escrita: «Único en la empresa. Tiene que estar dado de alta en ARCA».
- Guardar, o Guardar y crear otro si vas a cargar varios.
Cargar veinte puntos de venta en dos minutos
Ésa es la razón de ser del botón Guardar y crear otro: deja el diálogo abierto y el punto de venta ya incrementado, con el foco puesto y el número seleccionado. Cargar el punto de venta siguiente es tipear el número y Enter. Con veinte cajas se cargan los veinte diarios de una sentada, sin abrir y cerrar el diálogo veinte veces.
Las validaciones, y qué significan
| Mensaje | Qué pasó |
|---|---|
| «Hace falta el número de punto de venta (dado de alta en ARCA). Sin él la caja que tome este diario no va a poder cobrar.» | Se guardó un diario de factura electrónica sin PdV. No es opcional. |
| «El punto de venta va de 1 a 99999 (ARCA usa 5 dígitos).» | El número está fuera de rango. |
| «El punto de venta N ya lo usa otro diario de esta empresa. Dos diarios con el mismo punto de venta entrelazarían la numeración ante ARCA.» | El control más importante: dos libros sobre el mismo PdV se pisan la numeración y los comprobantes salen mal numerados. |
La lista de diarios
| Columna | Qué muestra |
|---|---|
| Nombre | El nombre en mayúsculas. |
| Sistema | Uno de los cuatro. |
| PdV | El número, con cinco dígitos. |
| Usado por | La caja que lo tomó, o vacío si está libre. |
| Estado | Activo, Libre o Archivado. |
La barra tiene filtro por empresa, por sistema, un buscador (por nombre o por PdV) y el tilde Ver archivados. Doble click edita. Con Shift o Cmd se marcan varios para archivarlos o borrarlos juntos.
Editar, archivar y borrar
Qué se puede hacer depende de una sola cosa: si el diario ya emitió comprobantes.
| Situación | Qué se puede |
|---|---|
| Nunca emitió | Se puede cambiar todo (nombre, sistema, punto de venta) y también borrar. |
| Ya emitió | Sólo se puede renombrar. El sistema y el PdV quedan bloqueados, y no se borra: se archiva. |
Al abrir un diario bloqueado, el diálogo lo explica antes de que uno choque: «Este diario ya emitió comprobantes: el sistema y el punto de venta no se cambian. Archivalo y creá otro».
Archivar
Archivar no borra: el diario conserva su punto de venta y su numeración, y se puede reactivar cuando haga falta. Si alguna caja lo estaba usando, el sistema avisa cuántas se quedan sin diario antes de confirmar — y esas cajas van a tener que elegir otro para poder cobrar.
Borrar
Sólo se pueden borrar los diarios que nunca entregaron un número. Si se intenta con uno que ya emitió, el sistema no lo borra y responde: «No se borró: el diario ya entregó números. Archivalo en su lugar».
CAPÍTULO 5Sucursales
La sucursal es el local. Aporta el domicilio del membrete y es el nivel donde se decide qué medios de cobro se usan.
Se configuran en Ajustes › Empresas, con la empresa seleccionada, en el panel de sucursales — la columna de la izquierda, al lado de la lista de cajas.
Crear una sucursal
- Con la empresa guardada y seleccionada, tocá el botón de Nueva sucursal.
- Completá Nombre (obligatorio), Dirección y Localidad.
- Dejá tildado Activa.
- Definí el membrete del ticket (abajo).
- Guardar sucursal.
El membrete del ticket
El membrete es el encabezado impreso en el ticket. Se elige entre dos opciones:
| Opción | Qué imprime |
|---|---|
| Automático desde Empresa + Sucursal | Se arma solo con los datos de la ficha de la empresa y el domicilio de esta sucursal. Es lo recomendado: si cambia un dato fiscal, el membrete se actualiza solo. |
| Texto propio | Hasta 6 líneas escritas a mano, de 42 columnas. Lo que se escriba pisa el membrete automático en todas las cajas de esta sucursal. También se puede cargar un pie de ticket opcional. |
Si se elige «Texto propio» y se deja vacío, al guardar avisa: «Elegiste "Texto propio" pero el membrete está vacío. Escribí el texto, o volvé a "Automático" para que salga de la empresa».
Eliminar una sucursal
Depende de si sus cajas emitieron comprobantes:
- Sin comprobantes: pregunta «¿Eliminar la sucursal y sus cajas?» y borra.
- Con comprobantes: no borra. Avisa cuántos hay y ofrece archivar: «la historia fiscal no se borra». Una sucursal archivada se reactiva desde su propia ficha.
CAPÍTULO 6Cajas
La caja es el puesto de trabajo. Es lo que el cajero elige al iniciar sesión, y de ella salen la numeración interna, el arqueo y — a través de su diario — la empresa que factura.
Se configuran en Ajustes › Empresas, en la lista de la derecha. Tiene buscador y cuatro filtros — Todas, CAE, CAEA y Activas — con un contador «N de M cajas». Doble click en una caja la edita.
Crear una caja
- Elegí primero la sucursal en la solapa Sucursales. Sin sucursal avisa: «Primero creá (o elegí) una sucursal en la pestaña Sucursales».
- Tocá + Nueva caja.
- Completá los datos de identificación (tabla siguiente).
- Guardar caja.
- Volvé a abrirla para asignarle el diario (capítulo 7) y, si corresponde, vincularle terminales de cobro (capítulo 9). Las dos cosas necesitan la caja ya guardada.
Los campos de la ficha
Identificación
| Campo | Qué va |
|---|---|
| Diarios | Los dos combos donde la caja elige su libro de facturas y su contingencia. Es lo primero de la ficha, y lo que define si la caja puede cobrar. Ver capítulo 7. |
| Nombre | Obligatorio y único en la empresa. Es lo único que distingue una caja de otra en el selector del login: ponele un nombre que se entienda (POS001, CAJA MOSTRADOR). |
| Depósito | El almacén contra el que esta caja descuenta stock. |
| Usuarios de esta caja | Quiénes pueden abrirla al iniciar sesión. Se agregan con + Agregar usuario, que trae un buscador. |
| Activa | Destildada, la caja deja de ofrecerse. |
Sección Cobro
| Campo | Qué va |
|---|---|
| ID de caja para QR (opcional) | Identifica esta caja para el cobro por QR (el external_pos_id de MercadoPago). Vacío se genera solo a partir del nombre. Único por empresa, y sólo letras y números: MercadoPago rechaza guiones y espacios. No es el terminal físico. |
| Lector de banda | El tipo de lector de tarjetas: No definido, EMV, External, Generic, Intelligent, Keyboard o NFC/RFID. |
| Terminales de cobro | Los equipos físicos vinculados a esta caja (capítulo 9). |
| QR de PlusPagos | La imagen del QR estático, si se cobra por ese medio. |
| Billetes (denominaciones) | Los importes de los botones rápidos de efectivo al cobrar, separados por comas (1000, 2000, 10000). Vacío usa los de la máquina. |
Las tres validaciones al guardar
AxerOK bloquea el guardado en tres casos, y en los tres dice exactamente qué caja está en conflicto.
POS006 y
pos006 son la misma caja para quien la mira en el selector.
Eliminar una caja
Mismo criterio que con las sucursales: una caja con comprobantes emitidos no se borra, se desactiva. La historia fiscal no se toca.
CAPÍTULO 7Los diarios de la caja
Éste es el paso que conecta las dos mitades: la caja existe, el diario existe, y acá se los une. Hasta que no se haga, la caja no cobra.
Se hace dentro de la ficha de la caja, en la fila Diarios, que es lo primero que aparece arriba de todo. No hay que abrir ninguna otra pantalla: son dos combos, ahí mismo.
| Combo | Qué se elige |
|---|---|
| Diarios | El diario de facturas: define cómo emite esta caja. Arranca en «Sin diario». |
| Contingencia | El diario CAEA para cobrar sin internet, con la opción «Sin contingencia CAEA». Sólo aplica a las cajas de Factura Electrónica. |
Cada opción se lee «NOMBRE · Sistema · PdV 00006» — el sistema antes que el número. Los diarios sin punto de venta cargado aparecen como «SIN punto de venta».
Debajo de los combos hay un enlace, «Ver todos los diarios →», que lleva a la pantalla del capítulo 4. La división es deliberada: en la ficha se elige entre los que están libres; crear, editar o archivar es allá.
Qué se ofrece en el combo
Sólo los diarios libres de la empresa, más el que la caja tenga asignado (marcado «(actual)»). Un diario que otra caja ya tomó no aparece: el diario no se comparte.
La línea de abajo es una alerta, no un resumen
Debajo del combo hay una línea que sólo habla cuando algo está mal. Si el diario elegido está completo, no dice nada. Los dos avisos, en rojo:
| Aviso | Qué significa |
|---|---|
| ⚠ Sin diario, esta caja no va a poder cobrar. | Todavía no se eligió ninguno. La caja se puede guardar igual — «Sin diario» es una elección válida —, pero no va a poder cobrar. |
| ⚠ Este diario no tiene punto de venta: no puede cobrar. | El diario existe pero le falta el número de ARCA. Se le carga desde Ver todos los diarios →. |
Al guardar
Acá está la regla más importante del modelo:
Verificación: la caja quedó lista
Con el diario asignado, el resumen de la ficha muestra el régimen completo y la tarjeta de la caja en la pantalla «Elegí tu caja» muestra su sistema. Si algo falta, aparece «Sin diario fiscal» en rojo, y la lista de cajas lo repite en la columna Modo.
CAPÍTULO 8Medios de cobro
El catálogo de formas de pago. Se define una vez para la empresa y cada sucursal tilda las que usa.
Se abre desde el pie de la solapa Sucursales, con una sucursal seleccionada: botón Medios de cobro. El diálogo tiene la lista de medios a la izquierda y el detalle a la derecha.
La regla de los dos niveles
El catálogo (nombre, canal, orden) es de la empresa y lo comparten todas sus sucursales. La columna ✓ son los medios que usa esa sucursal. Por eso se entra desde la ficha de la sucursal y no desde un menú general. Efectivo y Cuenta corriente no se pueden borrar ni destildar.
El canal: cómo paga el cliente
Cada medio declara su canal, y es el campo que más importa. El canal no dice con qué software se cobra: dice cómo paga el cliente. Es la primera de las tres capas del capítulo 9, y es lo que decide si el medio necesita una terminal de cobro o no.
| Canal | ¿Necesita terminal? | Notas |
|---|---|---|
| Efectivo | No | Lo cobra la caja. |
| Tarjeta presente | Sí, uso «tarjeta» | Débito y crédito con el plástico delante. La marca que toca el cajero (VISA, MASTERCARD…) sale impresa en el ticket. |
| QR / billetera | Sí, uso «QR» | Mercado Pago, billeteras, Transferencias 3.0. |
| Cuenta corriente | No | Alimenta el saldo del cliente. |
| Cheque | No | |
| Transferencia | No | |
| Vale | No | También cubre las cortesías. |
Crear un medio de cobro
- Tocá + Nuevo.
- Nombre (obligatorio) — es lo que ve el cajero y lo que se imprime.
- Orden: un número; define la posición en la pantalla de cobro.
- Canal: cómo paga el cliente, de la tabla de arriba.
- Opcionales: recurso de voucher, recurso de vuelto, campo extra e Imagen (el logo del medio; sin imagen propia se muestra el ícono del canal).
- Abajo, en Cómo se cobra, el Tipo y —si el tipo agrupa varios procesadores— el Subtipo: Mercado Pago (QR o Point), Payway / Prisma, PVS, Plus Pagos, Fiserv o Clover.
- Dejá tildado Activa y tocá Guardar.
«Cómo se cobra»: de qué medio sale por qué equipo
Debajo de la ficha, el bloque Cómo se cobra traduce el canal a hardware concreto. Tiene Tipo y Subtipo —con qué software se cobra— y, para los canales que usan terminal, el detalle caja por caja:
POS001 → TRM-01 · QR1 (cuenta Mercado Pago QR)
POS007 → TRM-03 · t5 (cuenta Mercado Pago QR)
Sin terminal para este uso: POS002, POS003, POS004, POS005, POS006, POS008, POS009
Esa lista es el puente con el capítulo 9: una caja que aparece en «sin terminal» no puede cobrar por ese medio, por más que el medio esté tildado en la sucursal. Se resuelve vinculándole una terminal desde su ficha.
Borrar un medio
AxerOK protege dos cosas. La primera, los medios imprescindibles: si es el único de su tipo, avisa «es el único medio de tipo X. Sin él la caja no podría cobrar. Creá otro del mismo tipo y después borrá este».
La segunda, la historia: si hay cobros hechos con ese medio, propone desactivarlo en vez de borrarlo, porque borrarlo dejaría esos cobros sin detalle en el arqueo.
CAPÍTULO 9Cuentas de procesador y terminales
El cobro electrónico está armado en tres capas. Cada dato se carga una sola vez, en la capa que le corresponde: la confusión más cara de esta pantalla es copiar el mismo token en varios lados.
| Capa | Qué es | Dónde se carga |
|---|---|---|
| 1 · Cuenta de procesador | La cuenta comercial ante el procesador, con sus credenciales (el token). Es de la empresa. | Configuración › Cuentas de procesador |
| 2 · Terminal de cobro | El equipo físico que cobra: un Point, un lector Payway, un equipo PVS. Dice qué equipo es dentro de esa cuenta. | Configuración › Terminales de cobro |
| 3 · Caja | Qué terminal usa cada puesto, y para qué: tarjeta o QR. | Ficha de la caja › Terminales de cobro |
Las solapas Cuentas de procesador y Terminales de cobro están una al lado de la otra, con navegación cruzada: desde una cuenta se va a sus terminales con Agregar terminal, y desde una terminal se vuelve con Ver cuenta.
Crear una cuenta de procesador
En Configuración › Cuentas de procesador, con la empresa elegida arriba:
- Tocá + Nueva cuenta. El sistema le asigna un código correlativo
(
CTA-01,CTA-02…). - Procesador: PlusPagos, Fiserv, Clover, Mercado Pago, Payway / Prisma o PVS / Posnet.
- Integración: normalmente queda en «Única», deshabilitada. Sólo Mercado Pago ofrece dos, Point y QR.
- Ambiente de esta integración: Prueba o Producción.
- Credenciales: los campos cambian según el procesador — tokens de producción y prueba, URL del servicio, Phrase (Plus Pagos) o Merchant ID, RAID, App ID y App Secret (Clover).
- Probar conexión (por ahora sólo Mercado Pago) y Guardar cuenta.
Leer la lista
| Columna | Qué muestra |
|---|---|
| Cuenta | El código CTA-xx. |
| Procesador / integración | El procesador y, si tiene varias, una sub-fila por integración. |
| Ambiente | Producción o Prueba. Si las integraciones de una cuenta mezclan, dice «Producción · Prueba». |
| Credenciales | Completas en verde, o incompletas. |
| Terminales | Cuántas la usan, o «—». |
| Última prueba | Cuándo se probó la conexión por última vez. |
Al pie, el contador resume el estado: «6 cuentas · 7 integraciones · 7 integraciones en producción · 0 incompletas». El tilde Mostrar archivadas trae las que se dieron de baja, y Probar todas corre la prueba en lote (hoy sólo para Mercado Pago).
El aviso ámbar de la barra
Cuando hay dos cuentas del mismo procesador, aparece arriba un aviso con las cajas afectadas. Tener dos cuentas es válido —dos razones de cobro, dos comercios—, pero obliga a decidir por cuál cobra cada caja, y esa decisión se toma vinculándole una terminal:
Hay una variante peor, para los procesadores que todavía cobran por empresa: en ese caso el mensaje dice que el cobro está bloqueado hasta dejar una sola cuenta de esa integración.
Archivar una cuenta: la historia no se borra
El botón se llama Eliminar, pero lo que hace depende de si esa cuenta ya cobró.
| Situación | Qué pasa |
|---|---|
| Sin cobros | Título «Eliminar cuenta»: «¿Eliminar la cuenta …?» más el detalle de a quién afecta. Se borra. |
| Con cobros | Título «Archivar cuenta»: «Esta cuenta tiene N cobros registrados, así que NO se elimina: se ARCHIVA. Deja de ofrecerse y de cobrar, pero esos cobros siguen diciendo a qué cuenta entró la plata.» |
En los dos casos, el diálogo dice antes de confirmar a qué terminales afecta: «Quedan sin cuenta (y sin poder cobrar) hasta reasignarlas: TRM-01, TRM-02.», o «Ninguna terminal la está usando.» Una cuenta archivada se recupera con Reactivar.
Crear una terminal de cobro
En Configuración › Terminales de cobro. La ficha está dividida en cinco bloques:
| Bloque | Qué se carga |
|---|---|
| Identidad | Código (TRM-xx), Alias y Sucursal. |
| Conexión | Procesador y Host / dirección del equipo en la red. |
| Cuenta del procesador | La cuenta de la capa 1 — «se define una vez por empresa». Al lado, Ver cuenta. |
| Identificación del equipo en esa cuenta | Cambia por procesador: Terminal ID y Subnet (Payway), Device ID (Clover), Device ID (Point) o POS ID (QR) (Mercado Pago), Sucursal y Caja (Fiserv), Token del equipo (PVS). |
| Capacidades | Cuatro chips: Tarjeta presente, Contactless, Cuotas, Devoluciones. |
Abajo, Cajas vinculadas muestra qué puestos la usan. Al borrar, el diálogo lo repite antes de confirmar: «Se desvinculará de: …» con las cajas listadas, o «Ninguna caja la está usando.» Y con cobros hechos, igual que las cuentas, se archiva en vez de borrarse: «esos cobros siguen sabiendo por qué equipo salieron».
Vincular una terminal a una caja
En la ficha de la caja, sección Cobro, fila Terminales de cobro:
- Guardá la caja primero («Guardá la caja antes de vincularle terminales»).
- Tocá + Vincular terminal y elegí el equipo.
- Indicá el uso: Tarjeta o QR.
- Si hay más de una para el mismo uso, marcá una con Predeterminada.
La tabla muestra Terminal, Marca, Uso y Predet. Sin ninguna vinculada avisa: «Ninguna terminal vinculada. Sin terminal, esta caja sólo cobra en efectivo». Quitar desvincula sin borrar el equipo: la terminal sigue existiendo y esta caja deja de usarla.
Buscar un Point de Mercado Pago
Para los Point Smart, el campo del terminal se completa con un botón Buscar… que consulta la cuenta y lista los equipos disponibles. Tres cosas a saber:
- Necesita las credenciales cargadas. Si faltan, el mensaje dice «Cargá primero las credenciales de Mercado Pago (app Point o app QR) en Medios de cobro» — pero el lugar correcto hoy es Cuentas de procesador: ese texto quedó del modelo anterior.
- Si no devuelve nada: hay que vincular el Point a la cuenta desde la app de Mercado Pago y verificar que el token sea el de producción.
- El equipo tiene que estar en modo PDV para recibir cobros de la caja. Si está en otro modo, AxerOK ofrece cambiarlo — y después hay que reiniciar el Point para que tome el cambio.
CAPÍTULO 10Impuestos, percepciones y retenciones
Cuatro pantallas del menú Mantenimiento, encadenadas: los impuestos se agrupan en categorías, las categorías se asignan a productos y clientes, y encima juegan las percepciones y las retenciones.
Las pantallas y para qué es cada una
| Pantalla | Para qué |
|---|---|
| Impuestos | Las alícuotas concretas (IVA 21 %, 10,5 %, exento…). Cada impuesto puede tener un impuesto padre, para los casos compuestos. |
| Categorías de impuestos | Los grupos que se asignan a los productos. Un producto no lleva una alícuota: lleva una categoría, y la categoría resuelve la alícuota. |
| Categorías de impuestos por cliente | El eje del cliente. Es lo que permite que el mismo producto tribute distinto según a quién se le venda. |
| Percepciones | Las percepciones que se aplican al cobrar. |
| Agentes de recaudación | Declara que esta empresa es agente de percepción o de retención de un impuesto y una jurisdicción. |
Cargar una percepción
En Contabilidad › Configuración › Percepciones, la ficha tiene: Nombre, Descripción, RG (la resolución general que la respalda), Provincia y Alícuota.
Declararse agente de recaudación
En Contabilidad › Configuración › Agentes de recaudación, cada registro dice qué es la empresa frente a un impuesto:
| Campo | Qué va |
|---|---|
| Empresa | La razón social alcanzada. |
| Organismo | ARCA, ARBA, API, AGIP u Otro. |
| Impuesto | IVA, IIBB o GANANCIAS. |
| Régimen | El régimen de recaudación. |
| Jurisdicción | Sólo para IIBB: la provincia. |
| Vigencia desde / hasta | El período de la designación. |
| Percepción / Retención | Los dos tildes que definen qué puede hacer la empresa. Son independientes. |
| Usar padrón | IIBB por CUIT y período. |
| Activo | Para dar de baja sin borrar. |
Retención de IIBB al pagar a un proveedor
La retención aparece en el diálogo de pago sólo si se cumplen las tres condiciones. Si falta una, no hay retención — y conviene saber cuál falta:
- La empresa es agente de retención de IIBB de esa jurisdicción: el registro de arriba, con Retención tildado.
- El proveedor está marcado como sujeto: en su ficha, solapa Retención, el tilde «Sujeto a retención de IIBB» y la jurisdicción (provincia).
- Hay alícuota configurada para esa jurisdicción.
retencion.iibb.<jurisdicción>.alicuota y
.minimo. La jurisdicción va en minúsculas, sin acentos ni espacios:
«Buenos Aires» se escribe buenos_aires.
Cuando corresponde, el diálogo muestra una barra en verde fiscal con la base (el neto sin IVA, proporcional a lo que se paga), la alícuota y la retención. El total a entregar baja, pero la factura queda cancelada por lo aplicado, no por lo entregado. Al registrar el pago se emite el certificado de retención, numerado por empresa y régimen.
Las retenciones practicadas
Todas las retenciones emitidas quedan listadas en Menú › Compras › Retenciones, con filtros por empresa, estado y un buscador. Desde ahí se ve o se emite el certificado y se puede anular una retención.
CAPÍTULO 11Usuarios, roles y permisos
Tres decisiones por persona: qué puede hacer (el rol), de qué empresas (las empresas permitidas) y en qué puesto (las cajas asignadas).
Crear un rol
En Ajustes › Roles. Un rol es un nombre y una grilla de permisos tildados, agrupada en siete secciones:
| Sección | Qué contiene |
|---|---|
| Ventas y caja | Pantalla de ventas, cerrar y cobrar ticket, editar y borrar líneas, devoluciones, cambiar precios, cambiar opciones de IVA, autorizar percepción al cobrar, movimientos de caja, cerrar caja. |
| Clientes | Menú Clientes y ABM de clientes. |
| Administración | Usuarios, Roles, Recursos, Almacenes, Productos, Diarios, Empresas / ARCA, Crear empresas, CAEA, activar modo CAEA, Compras. |
| Informes | Un permiso por informe. |
| Presentismo | El módulo de fichadas. |
| Sistema | Configuración, Sincronizar con Odoo, Impresora, Cambiar clave. |
| Otros | Lo que no entra en las anteriores. |
Arriba hay un buscador de permisos, que busca tanto en la etiqueta como en la clave técnica: escribir «deshacer» encuentra «Cambios de precio (deshacer)», y escribir el nombre de una pantalla también sirve.
Crear un usuario
En Ajustes › Usuarios. La ficha es corta, pero hay tres campos que definen el alcance real de la persona más allá del rol: Superusuario, Cajas asignadas y Empresas permitidas.
| Campo | Qué hace |
|---|---|
| Nombre y Clave | El nombre de login y la clave de acceso. |
| Tarjeta | Identificación física opcional (tarjeta o iButton) para iniciar sesión. |
| Rol | Los permisos. Obligatorio. |
| Visible | Si aparece en la pantalla de login. Un usuario no visible existe pero no se ofrece. |
| Superusuario | Puede entrar sin tener ninguna caja asignada. Es exactamente eso, y es lo que permite administrar el sistema desde una PC que no es un puesto de venta. |
| Cajas asignadas | Qué cajas puede abrir. Es el otro lado del campo «Usuarios de esta caja» de la ficha de la caja: se carga desde cualquiera de los dos lados. |
| Empresas permitidas | De qué razones sociales puede operar, con + Agregar empresa. Se elige además una Predeterminada, que es con la que abre la sesión. |
Lo que cada usuario se lleva consigo
Algunas preferencias son por usuario, no por máquina, y se recuerdan entre sesiones: el theme y el color de acento (se eligen adentro, en la barra superior, no en el login), la empresa y sucursal del selector «Elegí tu caja», y el alcance de la pantalla de consulta de ventas.
CAPÍTULO 12Catálogo y ficheros
Almacenes, productos, clientes y proveedores. Lo que hay que definir antes de cargar el catálogo, y en qué orden.
Almacenes, primero
En Inventario › Almacenes se cargan los depósitos (nombre y dirección). Van antes que los productos porque cada caja descuenta stock contra un Depósito, y ese combo se llena de acá.
Antes de los productos
Cuatro catálogos auxiliares que conviene tener cargados antes, todos en Inventario › Productos y stock:
- Categorías — el árbol del catálogo.
- Categorías de impuestos — sin esto los productos no tributan bien (capítulo 10).
- Unidades de medida — vienen 12 sembradas con nombres claros («Gramos — se exhibe por kg»). Cada una tiene abreviatura, unidad de exhibición, equivalencia y tipo AFIP.
- Marcas y Familias, si el comercio los usa.
La ficha de producto: lo que define el comportamiento
| Campo | Qué decide |
|---|---|
| Tipo | Define todo el comportamiento del producto: Normal, Precio libre, Producto libre, Balanza (Precio / Por unidad / Peso / Peso-Unidad), Composición, Envase, Cubierto o Servicio. Ya no hay checkboxes sueltos de servicio, balanza o envase. |
| Categoría de impuesto | Cómo tributa. |
| Unidad y Contenido | La yerba de 500 g: unidad «Gramos», contenido 500. Alimenta el precio por unidad de los carteles de góndola. |
| Envase que lleva | Un desplegable con los productos de tipo Envase activos. |
| Activo | Destildado, archiva el producto de verdad: sale del catálogo de ventas y al escanearlo la caja avisa que está archivado. |
| Web | Marca el producto como publicable en el canal web (Odoo). El efecto llega con la sincronización. |
Clientes y proveedores
Clientes en Menú › Ventas › Clientes; proveedores en Menú › Compras › Proveedores. Para la configuración inicial, tres campos importan más que el resto:
- CUIT / Nro documento y la condición IVA del cliente: determinan qué comprobante se le emite.
- La categoría de impuestos por cliente, si el comercio la usa (capítulo 10).
- En el proveedor, la solapa Retención: el tilde «Sujeto a retención de IIBB» y la jurisdicción.
CAPÍTULO 13La terminal: Configuración
Todo lo que se configura por PC. Las solapas fiscales ya se vieron; este capítulo cubre las de máquina.
Se entra por Menú › Ajustes › Configuración. Al pie están Guardar, Restaurar y Salir.
Las solapas
| Solapa | Qué contiene |
|---|---|
| Localización/País | Idioma y región. |
| Terminal | El nombre de esta máquina (el que después se usa como host de la caja) y la empresa por defecto. |
| Empresas / ARCA | Empresas, certificados, sucursales y cajas. Capítulos 2 a 7. |
| Cuentas de procesador | Capítulo 9. |
| Terminales de cobro | Capítulo 9. |
| Periféricos | Impresora, pantalla (visor), balanza y escáner. Abajo en detalle. |
| Ticket | Formato y plantillas de impresión. |
| Opciones del sistema | Comportamiento general de la aplicación. |
| Base de datos | Conexión. No se toca salvo en una instalación o una migración. |
| Banco de pruebas | Datos demo y vaciado del catálogo. Sólo para probar. |
| Apariencia (theme personal) | Editor de colores del theme «AxerOK Personal». Es por usuario. |
Periféricos
| Dispositivo | Qué se configura |
|---|---|
| Impresora | El modelo y el puerto. La gaveta de dinero se abre a través de la impresora de tickets. El estado se muestra como «Impresora lista» o «Impresora desconectada». |
| Pantalla (visor) | El modo y el puerto del visor de cliente. |
| Balanza | El driver y el puerto serie. Ver abajo. |
| Escáner | El lector de código de barras. |
Conectar una balanza
Elegí el driver «generic» y el puerto serie. Sirve para cualquier balanza que emita el peso por el puerto — Kretz, Systel, Gama, Moretti — sin necesidad de un driver por marca. Al vender un producto por peso, la balanza da el peso sola; si tarda, aparece «Leyendo la balanza, aguarde…» y con Escape se carga el peso a mano. Sin balanza, el peso se pide a mano y la venta no se traba.
1234 para 1,234 kg. En esos casos hay que ajustar dos
parámetros en el archivo de configuración: scale.regex=[0-9]+ y
scale.decimals=3 (dónde va la coma). Si queda mal puesto, el peso
sale multiplicado o dividido por diez — el cajero lo ve antes de cerrar la venta.
La licencia de uso
En la solapa Licencia se pega el token que llega al comprar y se usa Verificar: el sistema consulta al servidor y muestra la edición, el vencimiento del mantenimiento y cuántos usuarios cubre.
- La licencia es por usuarios activos. Al superar el cupo hay 15 días de gracia con aviso; se amplía desde la tienda de axerok.com o desactivando usuarios que ya no operan.
- Sin licencia el POS no se apaga: se sigue vendiendo y facturando. Lo que se apaga es lo que depende del servidor: la solapa AxerOK Móvil (conexión de los celulares) queda en sólo lectura y las actualizaciones no se descargan. La barra superior muestra SIN LICENCIA.
- El token es el mismo que usa la sincronización con el servidor: si la barra dice SIN LICENCIA y el token es correcto, verificá la conexión a internet antes de tocar nada.
CAPÍTULO 14CAEA: contingencia sin internet
El CAEA es un código que ARCA entrega por adelantado para poder seguir facturando cuando se cae la conexión. Se pide antes, se usa durante, y se informa después.
Se administra en Menú › Contabilidad › Configuración › CAEA (contingencia).
Qué hace falta antes
- Un diario de sistema «Factura Electrónica CAEA» con su propio punto de venta dado de alta en ARCA (capítulo 4). El punto de venta de contingencia es distinto del de la facturación normal.
- Ese diario asignado como contingencia en la ficha de la caja (capítulo 7).
- El usuario con empresas permitidas (capítulo 11): si el combo de empresa está vacío, es eso.
El ciclo
- Obtener CAEA. Se pide a ARCA el código de la quincena. Con conexión, y antes de necesitarlo. En la ficha de empresa está la opción «Pedir solo el CAEA de la quincena siguiente» — ARCA permite pedirlo hasta cinco días antes.
- Facturar en contingencia. Cuando no hay internet, la caja emite con el CAEA en lugar de pedir un CAE por cada comprobante.
- Informar CAEA. Recuperada la conexión, hay que informar a ARCA los comprobantes emitidos con ese código. Doble click en un CAEA muestra sus comprobantes; el botón Informar CAEA los manda.
El botón Verificar PdV de esta pantalla consulta los puntos de venta habilitados para el CUIT y muestra cuáles están bloqueados — útil para confirmar que el PdV de contingencia está bien dado de alta.
CAPÍTULO 15Sincronización con Odoo
AxerOK puede sincronizar contra un Odoo: productos, clientes y los cobros del día.
Se entra por Menú › Odoo › Sincronizar ahora. Requiere el permiso «Sincronizar con Odoo» (capítulo 11).
Antes de sincronizar
- Los medios de cobro de AxerOK tienen que tener su equivalente en los diarios de cobro de Odoo (capítulo 8).
- Las categorías de impuestos tienen que mapear contra los impuestos de Odoo (capítulo 10). Un impuesto sin correspondencia es la causa más común de que una venta no viaje.
- El tilde Web de la ficha de producto marca qué se publica en el canal web; el efecto llega con la sincronización, no al guardar.
CAPÍTULO 16Herramientas: importación CSV
La forma de cargar un catálogo entero sin tipearlo. Está en Menú › Inventario › Configuración (importadores CSV).
| Herramienta | Qué hace |
|---|---|
| Importar CSV | Alta y actualización masiva de productos. |
| Importar stock | Carga de cantidades. Pensada para el conteo con lector. |
| Clientes · Archivo CSV | Alta masiva de clientes. |
| Vaciar catálogo | Borra el catálogo. Destructivo: sólo en una instalación nueva. |
Los informes de control
Después de importar, la misma sección tiene siete informes que se corren antes de empezar a vender. Es la forma barata de encontrar los problemas de una importación:
- Productos nuevos y Precios actualizados — qué entró realmente.
- Stock actualizado — qué cantidades se cargaron.
- Precios sospechosos — precios en cero o absurdos.
- Categoría inválida — productos que quedaron fuera del árbol.
- Faltan datos y Datos inválidos — el resto.
CAPÍTULO 17Checklist y mensajes frecuentes
Para cerrar una instalación: qué verificar antes de entregarla, y qué significa cada aviso que puede aparecer.
Checklist de puesta en marcha
Fiscal
- La empresa tiene razón social, CUIT, condición IVA e ingresos brutos.
- El chip de la tarjeta de empresa dice «Certificado · …» en verde.
- Verificar configuración pasa sin errores.
- Verificar PdV devuelve los puntos de venta esperados.
- Hay un diario por cada punto de venta, con el sistema correcto.
- Si se usa contingencia: existe el diario CAEA, con su PdV propio.
Operación
- Cada caja tiene diario asignado y ninguna dice «Sin diario fiscal».
- Cada caja tiene usuarios asignados y depósito.
- Los medios de cobro están tildados en la sucursal.
- Las credenciales están en Cuentas de procesador (no en el diálogo de medios, donde no se guardan) y el contador de esa pantalla dice «0 incompletas».
- Ninguna caja aparece en el aviso ámbar de «no pueden elegir».
- Cada usuario tiene rol, empresas permitidas y cajas.
- Queda al menos un superusuario.
- En cada PC: impresora probada, balanza leyendo, visor andando.
La prueba final
Iniciar sesión con un usuario real, elegir su caja, hacer una venta chica y cobrarla. Si sale el comprobante con su CAE y su número legal, la instalación está terminada. Es la única verificación que cubre toda la cadena de una sola vez.
Mensajes frecuentes
| Mensaje | Qué hacer |
|---|---|
| «Sin diario fiscal» | La caja no tiene diario, o el diario no tiene punto de venta. Capítulo 7. |
| «Esta sesión no tiene una caja abierta» | Se llegó a Ventas sin elegir caja al iniciar sesión. El ticket no se pierde: cerrar sesión, volver a entrar y elegir la caja. |
| «Primero seleccioná y guardá la empresa» | Guardar la empresa antes de configurarle sucursales o medios de cobro. |
| «Guardá la caja antes de vincularle terminales» | Guardar la caja y volver a abrirla. |
| «Tu rol no tiene el permiso "Crear empresas"» | Habilitarlo en Ajustes › Roles, sección Administración. |
| «Tu usuario no tiene empresas permitidas» | Asignar la empresa en Ajustes › Usuarios. |
| «El punto de venta N ya lo usa otro diario de esta empresa» | Cada punto de venta va en un solo diario. Revisar los archivados también. |
| «Este diario ya emitió comprobantes» | Sólo se le puede cambiar el nombre. Para cambiar de régimen: archivar y crear otro. |
| «La clave privada y el certificado NO son el mismo par» | Importar el .crt que corresponde a esta clave, o generar clave nueva y pedir certificado. |
| «ARCA no devolvió puntos de venta para este CUIT» | Dar de alta los puntos de venta en el sitio de ARCA, o revisar el ambiente elegido. |
| «Sin usuarios asignados: esta caja no le aparece a nadie» | Agregar usuarios en la ficha de la caja. |
| «Ninguna terminal vinculada. Sin terminal, esta caja sólo cobra en efectivo» | Normal si el puesto no cobra con tarjeta ni QR. Si debía hacerlo: capítulo 9. |
AxerOK es software libre bajo licencia GNU GPL v3.
AxerOK · Pronexo — Manual de configuración. También en PDF.