05 · Empezar
Cómo se da de alta
Lo que carga el local, una sola vez
Dentro de OrigenOS, en Configuración → Facturación electrónica, el dueño elige Pymo como proveedor y carga los datos de su cuenta: el usuario y la contraseña del Gateway, el RUT de la empresa emisora y el número de sucursal que le asignó la DGI. Las credenciales se guardan cifradas.
Con eso queda configurado. Si el negocio tiene varios locales, la configuración fiscal puede ser propia de cada sucursal o general para todo el café.
Alta programática, para volumen
Para dar de alta muchas cuentas sin que nadie complete un formulario de a una, OrigenOS expone una API de provisioning documentada. Se autentica con una clave tipo Bearer; la clave define el ambiente, y no se pueden cruzar: una clave de prueba solo opera cuentas de prueba.
- Es idempotente. Cada cuenta se identifica con una referencia estable, así que reintentar la misma alta devuelve la misma cuenta en vez de duplicarla.
- No deja cuentas a medio crear. El alta inicializa el plan de cuentas uruguayo y verifica que resuelva todas las cuentas que el motor contable necesita. Recién si esa verificación pasa, la cuenta queda activa; si falla, no queda activa y un reintento la completa.
- Las claves se revocan. OrigenOS guarda solo un hash de la clave, nunca el texto plano, y una clave revocada deja de funcionar en el pedido siguiente.
La documentación técnica completa —cuerpo del pedido, respuestas, códigos de error y buenas prácticas— está escrita y se entrega a pedido. Las claves y las URLs de cada ambiente van por un canal aparte: no viajan en la documentación.
Lo que va antes de todo esto
Configurar OrigenOS es el último paso, no el primero. Antes el local tiene que estar habilitado a emitir comprobantes electrónicos: ese trámite va por afuera del sistema. Cuando está resuelto y tenés las credenciales, cargarlas y dejar el local emitiendo lleva unos minutos.