Integrar una tienda online o ecommerce a la facturación electrónica uruguaya con Factumel API
Una integración de ecommerce suele convertir pedidos confirmados en documentos fiscales. Debe respetar el tipo de venta, la empresa emisora y la prevención de duplicados, sin asumir que todas las tiendas tienen el mismo flujo.
Cuándo usar esta guía y qué preparar
Una integración de ecommerce suele convertir pedidos confirmados en documentos fiscales. Debe respetar el tipo de venta, la empresa emisora y la prevención de duplicados, sin asumir que todas las tiendas tienen el mismo flujo.
Antes de modificar datos fiscales, identificá la empresa emisora, el ambiente de trabajo y el rol con el que ingresaste. Los procesos de DGI pueden requerir autorizaciones externas a Factumel.
Procedimiento paso a paso
Seguí este recorrido en el panel y verificá cada resultado antes de avanzar.
- Definí qué evento comercial dispara la emisión fiscal y cuál empresa emite.
- Prepará una API key de TEST limitada a la empresa y los permisos requeridos.
- Mapeá receptor, ítems, descuentos, impuestos, moneda y referencias del pedido.
- Utilizá identificadores externos y controles de idempotencia adecuados.
- Consultá el estado final del documento y procesá los webhooks de forma segura.
- Probá devoluciones y ajustes mediante el circuito de notas que corresponda.
Errores frecuentes y controles importantes
Usá esta lista de verificación para reducir errores operativos y evitar diferencias entre lo registrado en Factumel y la situación fiscal efectiva.
- No emitas una nueva factura cada vez que el comprador recargue la página.
- No expongas la API key en JavaScript público ni aplicaciones cliente.
- El pago aprobado y el documento aceptado son eventos diferentes.
Preguntas habituales
¿Puedo automatizar ventas? La API permite integraciones, condicionadas a permisos y preparación fiscal.
¿La integración sustituye el control contable? No. Se deben revisar estados, conciliaciones y ajustes.