Integración · OrigenOS + Pymo · Uruguay

Cobrás en el mostrador. El comprobante sale solo.

En Uruguay, OrigenOS emite los comprobantes fiscales electrónicos a través de Pymo, que es el proveedor de servicios electrónicos. El café factura desde el mismo lugar donde cobra: la venta se carga una sola vez, y el comprobante sale de esa misma venta.

Dónde aplica

Uruguay · CFE ante la DGI

Qué emite

Los cuatro CFE: e-Ticket, e-Factura y las notas de crédito de ambos

Doble carga

No existe: el comprobante sale de la venta que ya cobraste

Dónde se configura

Configuración → Facturación electrónica, dentro de OrigenOS

Esto es de Uruguay.

OrigenOS se usa en Uruguay, Argentina, Chile y México, y la operación del local —el POS, la cocina, el stock, la fidelidad— es la misma en los cuatro. La facturación electrónica con Pymo, no: es uruguaya. Emite CFE contra la DGI, con las reglas y los códigos de Uruguay.

En los otros países el régimen fiscal es otro y el proveedor es otro. Nada de lo que dice esta página aplica fuera de Uruguay.

01 · En criollo

Qué es esta integración

Un café que factura electrónicamente suele terminar con dos sistemas: uno donde cobra y otro donde factura. La venta se carga en el primero, y después alguien la vuelve a cargar en el segundo. Ese "después" es donde aparecen los números que no cuadran, los comprobantes que faltan y las noches de cierre largas.

Acá hay un solo lugar. El cajero cobra en OrigenOS y el comprobante sale de esa venta, con esas líneas, ese IVA y ese descuento. No se carga nada dos veces.

Lo pone OrigenOS

Donde pasa la venta

El sistema que ya usa el local todos los días para operar el mostrador.

  • Toma el pedido y lo cobra.
  • Arma el comprobante con las líneas reales de esa venta, el IVA por tasa y el descuento prorrateado sobre las líneas.
  • Decide qué tipo de comprobante corresponde según el receptor.
  • Imprime el ticket con el QR de consulta.
  • Emite la nota de crédito cuando hay que corregir.
Lo pone Pymo

El proveedor de servicios electrónicos

La pieza que convierte esa venta en un documento con valor fiscal ante la DGI.

  • Recibe el comprobante que arma OrigenOS y lo procesa ante la DGI.
  • Devuelve serie, número, CAE y la dirección del QR.
  • Mantiene los dos ambientes separados: uno de prueba y uno de producción.

Por qué esto importa en el cierre

Cuando el comprobante sale de la misma venta que se cobró, el cierre de caja y lo declarado ante la DGI hablan del mismo número por construcción. No hay una planilla en el medio que alguien tenga que conciliar el lunes.

02 · Qué emite

Los cuatro comprobantes

No es "factura electrónica" a secas. Un café necesita los cuatro tipos, y los cuatro están implementados: el de consumo final, el de empresa, y las notas de crédito de cada uno. Entre paréntesis, el código de la DGI.

e-Ticket

DGI 101

El comprobante de consumo final: el cliente no da RUT. Es el que sale en casi todas las ventas del mostrador.

e-Factura

DGI 111

El comprobante para un receptor identificado: la empresa que compra y pide factura con su RUT.

Nota de crédito de e-Ticket

DGI 102

Acredita total o parcialmente un e-Ticket ya emitido. Se usa cuando hay que devolver o corregir una venta de consumo final.

Nota de crédito de e-Factura

DGI 112

Lo mismo para una e-Factura. La nota de crédito hereda el tipo del comprobante original: no se elige a mano.

Sobre las notas de crédito

La nota de crédito no es un comprobante suelto: para la DGI tiene que apuntar al original. OrigenOS arma esa referencia —tipo, serie, número y fecha del comprobante que se acredita— a partir de la venta. Al cajero se le pide el motivo, no el número de serie.

03 · El mostrador, paso a paso

Cómo se ve un día normal

La parte fiscal está pensada para que el cajero no tenga que aprenderla. Esto es todo lo que pasa entre que el cliente dice "cobrame" y se va con el ticket en la mano.

  1. Paso 1

    El cajero cobra

    No cambia nada del mostrador. Se toma el pedido, se cobra con el medio de pago que sea —efectivo, débito, crédito, pago dividido— y listo. La facturación electrónica no es una pantalla aparte ni un paso más: es el mismo cobro.

  2. Paso 2

    El sistema elige el comprobante por el receptor

    Sin RUT del cliente sale e-Ticket. Con RUT sale e-Factura. Lo decide el servidor a partir del receptor, no el medio de pago ni lo que tilde el cajero apurado.

    Es una regla chica que evita un problema caro: la empresa que compra en el mostrador y se lleva un comprobante de consumidor final no tiene un "faltó una función", tiene el documento equivocado — y cada caso se arregla después con una nota de crédito que alguien tiene que hacer a mano.

  3. Paso 3

    Si es e-Factura, se piden los datos que la DGI exige

    RUT de 12 dígitos, razón social, dirección, ciudad y departamento. Si falta uno, el sistema avisa antes de emitir, con el cliente todavía en el mostrador. Ese es el único momento barato para pedir el dato que falta.

  4. Paso 4

    Se emite y vuelve el comprobante

    OrigenOS arma el comprobante con las líneas de la venta, el IVA por tasa y el descuento ya prorrateado, y lo manda a Pymo. Vuelve con serie, número, CAE y la dirección de consulta de la DGI.

  5. Paso 5

    El ticket sale con el QR

    El QR se imprime en el mismo ticket que se le entrega al cliente. Lo escanea y consulta su comprobante. No hay que mandar nada por otro lado ni entrar a otro sistema a buscarlo.

  6. Paso 6

    Si hubo un error, nota de crédito desde la misma venta

    Se emite desde la venta original, referenciándola: tipo, serie, número y fecha del comprobante que se está acreditando. El cajero elige el motivo; el código DGI y la referencia los arma el sistema.

El comprobante nunca sale por más de lo que pagó el cliente

Cuando hay promoción, cupón, canje de puntos o un vale, el descuento se prorratea sobre las líneas del comprobante, y antes de mandar nada el sistema verifica que la suma de las líneas dé exactamente el total cobrado. Si no cuadra, no emite. Es preferible frenar y avisar que emitir un documento fiscal por un importe que el cliente no pagó.

04 · Antes de emitir en serio

Prueba y producción, separados

La integración trabaja contra dos ambientes distintos: uno de prueba y uno de producción. Sirve para capacitar al equipo, probar el flujo completo y ver el ticket impreso sin generar un solo documento fiscal real.

Y hay un detalle que conviene decir de frente: el ambiente de prueba devuelve serie, número y CAE con la misma pinta que uno real. Por eso OrigenOS no se fía de la respuesta — sabe en qué ambiente está, marca esas ventas como simuladas e imprime el ticket con el aviso de documento simulado. Nadie se lleva un comprobante de prueba creyendo que vale.

Cómo se pasa a producción

Es un cambio de configuración del local, no una migración: se apaga el modo prueba en la configuración fiscal y las ventas siguientes ya emiten contra el ambiente productivo. Lo que hay que tener resuelto antes es la habilitación del local como emisor electrónico: ese trámite va por afuera del sistema y lo vemos juntos en la demo.

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.

06 · Cómo se contrata

El plan Pymo

El plan Pymo incluye la facturación electrónica: el local no contrata la integración por separado ni paga un módulo extra para emitir sus CFE.

Los números los vemos juntos en la demo, mirando el local real: qué factura hoy, cuántas cajas tiene y si necesita e-Factura seguido o casi nunca. Es una conversación de veinte minutos y sale mejor que un cuadro comparativo.

07 · Para no vender humo

Lo que esta página no afirma

Todo lo de arriba describe cómo funciona la integración en OrigenOS y se puede verificar mirando el sistema. Estas otras cosas son de Pymo o dependen de la DGI, y no las vamos a inventar para que la página quede más linda.

No hablamos por Pymo

Cantidad de clientes, años en el mercado, certificaciones, disponibilidad del servicio: son datos de ellos y los cuenta ellos. Si querés esa información, te la pasamos de la fuente, no de memoria.

La aceptación de la DGI es asíncrona

Cuando se emite, el Gateway confirma que recibió el comprobante; la aceptación definitiva de la DGI llega después. OrigenOS no bloquea el cobro esperando esa confirmación: con gente en la fila, frenar la caja para esperar a un tercero es peor remedio que la enfermedad.

Monedas: pesos y dólares

El comprobante se puede emitir en UYU o en USD. En dólares lleva la cotización aplicada a esa venta — la comercial real, no una cotización genérica del día bajada de cualquier lado.

Uruguay

Te lo mostramos con tu carta cargada.

Treinta minutos por videollamada: cobramos una venta de mentira, emitimos el comprobante contra el ambiente de prueba e imprimimos el ticket con el QR. Vos mirás si eso es lo que necesita tu local.

Facturación electrónica · Uruguay · CFE ante la DGI