Conectar API para desarrolladores
Si tenés un sistema propio, una tienda en otra plataforma (Fenicio, Magento…) o una herramienta como Make o Zapier, facturás con un solo pedido HTTP: le decís qué se vendió y a quién, y facturalo.uy aplica las mismas reglas que el portal.
Qué necesitás
- Una API Key de facturalo.uy: Configuración → API → Generar (requiere un plan que incluya la API).
Paso a paso
- 1
Mandá el pedido
POST https://facturalo.uy/api/public/v1/facturar con el header Authorization: Bearer <tu API Key> y un JSON con referencia, líneas (descripción, cantidad, precio, iva) y, si querés, cliente (rut o cédula, nombre, email), moneda y forma de pago.
- 2
Recibís el comprobante
La respuesta trae tipo, serie, número, total y el link al PDF. Si mandás la misma referencia de nuevo, devuelve el mismo comprobante (ya_facturado: true).
- 3
Consultá lo que necesites
GET /api/public/v1/comprobantes (lo emitido en un período, con PDF), /comprobantes/buscar?serie=A&numero=47 (uno puntual), /cuentas-a-cobrar (quién debe y cuánto) y /rut/<rut> (datos de DGI). Todas con la misma API Key, solo lectura.
- 4
Si algo falla
El error viene en español y dice qué corregir (por ejemplo, qué campo falta). Reintentar con la misma referencia nunca duplica.
Preguntas frecuentes
›¿Hay un ambiente de pruebas?
Sí, escribinos y te damos acceso: los comprobantes de prueba no tienen valor fiscal.
›¿Cuántos pedidos por minuto?
Hasta 60 por minuto. Si necesitás más, escribinos.
›¿Se puede anular por la API?
No: por seguridad, con la API Key solo se factura y se consulta. Si se filtrara una clave, no serviría para anular. Se anula desde facturalo.uy o con ChatGPT o Claude.
¿Te trabaste en algún paso? Escribinos y lo conectamos juntos.