Cobraste con Stripe u Onvo, ¿y la factura electrónica?

Cobrar y facturar son dos trabajos distintos, y los hacen dos servicios distintos. La pasarela de pago (Stripe, Onvo o la que ya uses) mueve el dinero. Timbre emite el comprobante electrónico de esa venta ante Hacienda. Tu producto es lo que une a los dos.

Dos trabajos distintos

La pasarela cobra la tarjeta, confirma que el pago entró y te lo deposita. Emitir el comprobante de esa venta ante Hacienda es otro trabajo, y es el que hace Timbre.

Timbre no cobra ni toca el dinero. Recibe los datos de una venta que ya se pagó y la convierte en un comprobante electrónico válido: calcula el impuesto, lo numera, lo firma con la llave de tu negocio, lo presenta ante Hacienda y te avisa qué respondió (Emitir).

Cómo se ve el flujo

1. 01Tu cliente paga
   ↓→
2. 02La pasarela confirma el pago
   ↓→
3. 03Tu sistema le pide el comprobante a Timbre
   ↓→
4. 04Timbre lo firma y lo presenta ante Hacienda
   ↓→
5. 05Tu sistema se lo entrega a tu cliente

El paso que conecta todo es el tercero. Cuando la pasarela le avisa a tu sistema que el pago se confirmó, tu sistema manda esa venta a Timbre. Cuando Hacienda la acepta, Timbre le avisa a tu sistema con un mensaje firmado (Webhooks), y desde ahí tenés el XML firmado y la versión en PDF para mandarle a tu cliente (Artefactos).

Los casos que siempre aparecen

El aviso de pago llega dos veces. Las pasarelas reintentan sus avisos, y tu sistema también puede reintentar si se cortó la red. Para que eso nunca termine en dos facturas, tu sistema le asigna a cada venta una llave de idempotencia (un identificador único que se genera una vez y se guarda con la orden) y la manda cada vez que pide ese comprobante. Timbre reconoce la llave y devuelve el comprobante que ya existe (Emitir).

El cliente pide un reembolso. Una factura emitida no se borra ni se edita. Se corrige con una nota de crédito que hace referencia a la factura original, y Timbre la emite igual que cualquier otro comprobante (Emitir).

La comisión de la pasarela. Lo que la pasarela te cobra por procesar el pago es una compra de tu negocio, no una venta a tu cliente, así que no forma parte del comprobante que tu producto emite por esa venta.

Lo que sí te toca

Para que Timbre pueda firmar en nombre de tu negocio, necesitás tus credenciales de Hacienda y tu llave criptográfica (el archivo .p12 con su PIN). Se sacan una vez desde el portal de Hacienda, y Credenciales de Hacienda muestra cada pantalla.