Conectá Kalkulus
con el resto de tu negocio.
Conectá tu ERP, tu tienda en línea o tu propio sistema para que cada venta se facture sola. Cada conexión usa una clave que solo puede hacer lo que vos le permitas.
Integrá sin perder
el control de tus datos.
Claves con alcances
Cada clave solo puede hacer lo que marcás. Todo lo demás devuelve error, aunque el endpoint exista.
Una clave por integración
Dale a cada sistema su propia clave con una descripción, como «Integración con la tienda en línea».
Vencimiento y estado
Poné fecha de vencimiento si querés y activá o desactivá la clave cuando lo necesités.
De tu sistema a Hacienda,
sin pasos de más.
Generá tu clave
Desde Kalkulus creás una clave nueva, le ponés una descripción y elegís qué puede hacer.
Tu sistema envía la venta
Tu ERP, tu tienda o tu sistema propio usa la clave para enviar los datos a Kalkulus.
Facturá y consultá
El documento se emite, se envía a Hacienda y podés consultar su estado, el PDF y el XML.
Documentación abierta,
lista para consultar.
Una referencia interactiva con todos los endpoints, generada desde una especificación OpenAPI, y un entorno sandbox para probar tu integración con calma.
- Autenticación con tu clave — se envía en el encabezado X-API-KEY
- Emisión de documentos — generar, procesar y consultar por clave numérica
- Catálogos fiscales — tipos de documento, medios de pago, monedas, impuestos y unidades de medida
- Localizaciones de Costa Rica — de provincias a barrios
- Pedidos, productos, clientes, bodegas, sucursales y terminales
Instalá el conector
de tu tienda.
Si vendés con WooCommerce, descargá el plugin oficial, instalalo en tu tienda y pegá una clave con los alcances que pida. Sin programar nada.
- Facturas y tiquetes automáticos — se emiten en Kalkulus cuando una orden de WooCommerce es pagada
- Se descarga desde el sistema — el archivo se arma en el momento, así siempre bajás la última versión publicada
- Se conecta con una clave de acceso — con los alcances que el plugin necesita
- Requisitos — WooCommerce, WordPress 6.3 o superior y PHP 8.1 o superior
- Incluye guía de instalación
Tu sistema se entera
en cuanto pasa algo.
Registrá una dirección de destino y Kalkulus te avisa automáticamente cuando Hacienda responde, cambia tu inventario o se mueve un pedido. Sin consultar una y otra vez.
- Documento aceptado o rechazado — cuando Hacienda responde a un comprobante
- Inventario actualizado — cambió la existencia de un producto en una bodega
- Pedido recibido, actualizado o facturado — con su estado, guía y vínculo al comprobante
- Producto actualizado — precio, tarifa, CABYS, unidad o descripción
- Cada aviso va firmado — con HMAC-SHA256 y un id de entrega para descartar repetidos
- Solo HTTPS, accesible desde internet — no se aceptan direcciones de red interna
- Los eventos de inventario, pedidos y productos requieren suscribirse explícitamente
Vos decidís
los alcances.
Marcá solo lo que la integración necesita: desde emitir documentos hasta recibir pedidos o administrar webhooks.
Emitir y consultar documentos
Calculá y enviá documentos a Hacienda (consume documentos del plan), y consultá los emitidos con su PDF y XML.
Clientes
Listá y consultá clientes, o dalos de alta y modificalos desde tu sistema.
Productos y variantes
Consultá, creá y editá productos y variantes. No mueve inventario.
Inventario y bodegas
Consultá bodegas y existencias por producto, o administrá las bodegas.
Pedidos
Consultá pedidos y sus estados, y recibí pedidos externos de forma idempotente.
Webhooks
Registrá y quitá avisos automáticos hacia tu sistema. Plataformas como Make o Zapier pueden suscribirse solas.
Sucursales y terminales
Consultá y administrá las sucursales y terminales de tu empresa.
Catálogos
CABYS, monedas, unidades de medida y ubicaciones disponibles para tu integración.
Antes de
conectar tu sistema.
Conversemos sobre qué necesita tu integración.
Hablá con el equipo¿Qué puede hacer una clave?
Solo lo que marcás al crearla. Cualquier otra acción devuelve error, aunque el endpoint exista.
¿Emitir documentos por API consume mi plan?
Sí. Emitir documentos consume documentos del plan, igual que hacerlo desde el sistema.
¿Qué avisos (webhooks) puedo recibir?
Documento aceptado o rechazado por Hacienda, inventario actualizado, pedido recibido, actualizado o facturado, y producto actualizado. Tu dirección de destino debe ser HTTPS y accesible desde internet.
¿Funciona con Make o Zapier?
Con el alcance de webhooks, plataformas como Make o Zapier pueden registrar sus avisos automáticos por su cuenta.
¿Tienen un conector para WooCommerce?
Sí. Hay un plugin oficial que emite facturas y tiquetes electrónicos cuando una orden de WooCommerce es pagada. Lo descargás desde el sistema e incluye su guía de instalación.
¿Puedo conectar mi ERP o mi propio sistema?
Sí. Podés integrar tu ERP, sistema contable o cualquier plataforma que pueda comunicarse por API, usando una clave con los alcances que necesite.
¿Dónde está la documentación técnica?
En la referencia pública de la API, con todos los endpoints, la autenticación y cómo verificar la firma de los webhooks. Si algo no queda claro, escribinos por WhatsApp o al correo de soporte.
Conectemos
tu sistema.
Contanos qué usás hoy y vemos la mejor forma de integrarlo con Kalkulus.