Planes Blog 3 Documentación API
Manténgase al día

Hacienda y facturación electrónica, sin perderse nada

Cambios en los comprobantes v4.4, plazos, resoluciones y guías prácticas, directo a su correo.

Todo lo que necesita para facturar

Facture desde el portal web sin programar, o conecte su sistema con la API. Nosotros nos encargamos del XML 4.4, la firma digital y el envío a Hacienda; usted no mantiene servidores de firma ni parseo de XSD.

7 tipos de comprobante v4.4

Factura, tiquete, notas de crédito y débito, factura de compra, factura de exportación y recibo electrónico de pago. XML firmado y validado contra XSD oficial de Hacienda.

Firma digital XAdES-EPES

Firmado con su certificado .p12 del BCCR. SigPolicyHash, C14N y cadena de confianza conforme al Reglamento de Comprobantes Electrónicos.

API RESTful documentada

Emita, consulte, cancele y descargue comprobantes con Bearer tokens. OpenAPI 3.0 con Scalar UI. CABYS, actividades económicas y ubicaciones integradas.

Sandbox API real

Mismo esquema que producción, apuntando a Hacienda sandbox. Sin valor fiscal y sin contar contra su cuota mensual. Incluido en los planes Empresa, Contadores e Integrador.

Webhooks en tiempo real

Reciba eventos de aceptación, rechazo, confirmación de receptor y vencimiento de certificado. HMAC-SHA256, reintentos automáticos y log completo de entregas.

PDF con plantillas personalizables

Cinco plantillas base. Logo, colores y tipografía personalizables. QR de verificación Hacienda, envío por correo al receptor y descarga vía API.

Para desarrolladores: emita un comprobante con un solo request

Un POST y nosotros nos encargamos del XML v4.4, la firma digital, el envío a Hacienda y el seguimiento del estado. El ejemplo completo, con request y respuesta, está en la documentación.

Ver la documentación API »

Integre en 3 pasos

  1. Registre su contribuyente y suba su certificado

    Cree su cuenta con cédula física o jurídica. Suba su certificado de firma. Se cifra y se usa únicamente para firmar sus comprobantes.

  2. Obtenga su token API

    Genere un Bearer token desde el portal. Úselo en sandbox para probar sin valor fiscal, o en producción cuando esté listo para emitir.

  3. Emita comprobantes desde su sistema

    Llame al endpoint POST /api/v1/public/vouchers con el payload del comprobante. Reciba el XML firmado, la respuesta de Hacienda y el PDF.

¿Por qué Almendro?

Costa Rica primero

Construido desde cero para comprobantes v4.4 de Costa Rica, no es adaptación de plataforma multi-país. Seguimos directamente las resoluciones de la DGT.

API-first, sin sorpresas

El mismo core alimenta su POS, su e-commerce y su ERP. Sin interfaces duplicadas ni precios ocultos por integración.

Sandbox real para pruebas

Pruebe contra Hacienda sandbox con la misma firma digital y estructura que producción. Cambie la URL cuando esté listo, nada más.

Recepción automatizada de facturas

Sus facturas de compra llegan solas: sus proveedores las envían a facturas@almendro.cr y Almendro las recibe, las organiza y las deja listas para su trámite.

Empiece a facturar hoy mismo

3 comprobantes gratis por mes, sin tarjeta.

Facture gratis ahora

Recepción automática de facturas por correo

Almendro automatiza por completo su recepción de facturas: pídale a quien le factura que envíe los comprobantes a facturas@almendro.cr, o reenvíelos usted desde su buzón empresarial. Nosotros los recibimos, los organizamos y los dejamos listos para su trámite.

Llegan por correo

Los XML de cualquier facturador, sueltos o en ZIP, llegan a facturas@almendro.cr. Sin subir nada a mano.

Se cargan solas

El sistema identifica al receptor por la cédula del comprobante y lo deja en su buzón de recibidos en minutos.

Responda ante Hacienda

Acepte o rechace cada comprobante con su firma dentro del plazo de 8 días hábiles, desde el mismo buzón.

IVA bajo control

Cada línea trae su impuesto por tipo y tarifa: usted sabe exactamente qué IVA soporta para sus informes.

La dirección es una sola: facturas@almendro.cr

Incluida en todos los planes. Solo necesita su certificado de Hacienda activo; su plan define cuántos comprobantes recibe al mes.

Planes y precios

Desde quienes empiezan hasta integradores de alto volumen. Todos los planes ya disponibles.

Gratis
3 comprobantes/mes
  • Emisión desde portal web
  • Mensaje del Receptor (MR)
Comenzar gratis
Contadores
$758 /año

El plan anual incluye 1 hora gratis de configuración (onboarding).

Con el pago anual puede registrar hasta 20 clientes y cada uno nace con su plan Pyme por un año. Sume la facturación electrónica a los servicios de su despacho.

10.000 comprobantes/mes
$0.015 excedente
  • Emisión desde portal web
  • Contributors gestionados
  • Clientes nuevos con plan Pyme 1 año (anual)
  • Emisión masiva
  • PDF white-label
Elija este plan
Empresa
$398 /año

El plan anual incluye 1 hora gratis de configuración (onboarding).

2.000 comprobantes/mes
$0.012 excedente
  • Acceso API
  • Sandbox API
  • Webhooks
  • PDF white-label
  • Emisión masiva
Elija este plan
Profesional
$194 /año
500 comprobantes/mes
$0.02 excedente
  • Emisión desde portal web
  • Mensaje del Receptor (MR)
  • PDF white-label
  • Email transaccional al receptor
Elija este plan
Pyme
$96 /año
75 comprobantes/mes
$0.03 excedente
  • Emisión desde portal web
  • Mensaje del Receptor (MR)
  • Email transaccional al receptor
Elija este plan
Emprendedor
$36 /año
20 comprobantes/mes
$0.05 excedente
  • Emisión desde portal web
  • Mensaje del Receptor (MR)
Elija este plan
Distribuidor Autorizado Compre planes Pyme a precio de mayorista y distribúyalos al precio que usted decida. Nosotros ponemos la plataforma, la administración y el soporte. Inscripciones por tiempo limitado. Ver pozos »

¿Necesita un plan a la medida?

Ajustamos los límites, el volumen y las funciones de cualquier plan a su operación, incluso sin tope. Contacte a soporte y lo armamos con usted.

Hablar con soporte
Gratis

$0 · para siempre

Incluye

  • Emisión desde portal web
  • Mensaje del Receptor (MR)

Límites del plan

Comprobantes
3 //mes
Usuarios
1
Clientes
5
Ítems
10
Plantillas PDF
1
Emails
150 /mes
Webhooks
0
Sucursales
1
Terminales por sucursal
1
Contribuyentes gestionados
1
Sandbox
Retención
3 meses
Límite de API
5 req/min
Marca en PDF
Plataforma
Integrador

$79/mes · $758/año

Incluye

  • Acceso API
  • Sandbox API
  • Webhooks
  • PDF white-label
  • Contributors gestionados
  • Emisión masiva
  • SLA + soporte prioritario

Límites del plan

Comprobantes
10.000 //mes
Usuarios
10
Clientes
10.000
Ítems
20.000
Plantillas PDF
21
Emails
22500 /mes
Webhooks
2
Sucursales
50
Terminales por sucursal
20
Contribuyentes gestionados
20
Sandbox
Retención
3 meses
Límite de API
150 req/min
Marca en PDF
White-label
Contadores

$79/mes · $758/año

Incluye

  • Emisión desde portal web
  • Contributors gestionados
  • Clientes nuevos con plan Pyme 1 año (anual)
  • Emisión masiva
  • PDF white-label

Límites del plan

Comprobantes
10.000 //mes
Usuarios
8
Clientes
6.000
Ítems
12.000
Plantillas PDF
8
Emails
20000 /mes
Webhooks
0
Sucursales
25
Terminales por sucursal
10
Contribuyentes gestionados
20
Sandbox
Retención
3 meses
Límite de API
0 req/min
Marca en PDF
Mínima
Empresa

$39/mes · $398/año

Incluye

  • Acceso API
  • Sandbox API
  • Webhooks
  • PDF white-label
  • Emisión masiva

Límites del plan

Comprobantes
2.000 //mes
Usuarios
5
Clientes
5.000
Ítems
10.000
Plantillas PDF
5
Emails
7500 /mes
Webhooks
2
Sucursales
10
Terminales por sucursal
10
Contribuyentes gestionados
1
Sandbox
Retención
3 meses
Límite de API
80 req/min
Marca en PDF
White-label
Profesional

$19/mes · $194/año

Incluye

  • Emisión desde portal web
  • Mensaje del Receptor (MR)
  • PDF white-label
  • Email transaccional al receptor

Límites del plan

Comprobantes
500 //mes
Usuarios
5
Clientes
1.500
Ítems
3.000
Plantillas PDF
3
Emails
2250 /mes
Webhooks
0
Sucursales
5
Terminales por sucursal
5
Contribuyentes gestionados
1
Sandbox
Retención
3 meses
Límite de API
0 req/min
Marca en PDF
Mínima
Pyme

$96/año

Incluye

  • Emisión desde portal web
  • Mensaje del Receptor (MR)
  • Email transaccional al receptor

Límites del plan

Comprobantes
75 //mes
Usuarios
2
Clientes
300
Ítems
750
Plantillas PDF
1
Emails
600 /mes
Webhooks
0
Sucursales
2
Terminales por sucursal
3
Contribuyentes gestionados
1
Sandbox
Retención
3 meses
Límite de API
20 req/min
Marca en PDF
Plataforma
Emprendedor

$36/año

Incluye

  • Emisión desde portal web
  • Mensaje del Receptor (MR)

Límites del plan

Comprobantes
20 //mes
Usuarios
1
Clientes
75
Ítems
150
Plantillas PDF
1
Emails
300 /mes
Webhooks
0
Sucursales
1
Terminales por sucursal
2
Contribuyentes gestionados
1
Sandbox
Retención
3 meses
Límite de API
10 req/min
Marca en PDF
Plataforma
Nuevo

Conviértase en Distribuidor Autorizado de Almendro

Compre un pozo de planes Pyme a precio de mayorista y distribúyalos al precio que usted decida. Nosotros ponemos la plataforma, la administración y el soporte. Usted solo distribuye y crea su propio ingreso.

Inscripciones abiertas por tiempo limitado.

Cómo funciona

  • Cada unidad de su pozo es un plan Pyme completo, con precio de lista de $96 al año.
  • Aplica solo para clientes nuevos en la plataforma: cuentas que usted registra como distribuidor. No aplica para cuentas que ya existen.
  • El año de su cliente corre desde su activación, no desde su compra: aunque active la última unidad el último día de su ventana, ese cliente recibe su año completo de Pyme.
  • Le asignamos un correo de Almendro y su propio panel administrativo de distribuidor: desde ahí activa clientes, gestiona sus contribuyentes y controla sus ventas.
  • Renovar a un cliente suyo consume una unidad de su pozo y el margen vuelve a ser suyo. Si no tiene unidades, su cliente renueva a precio de lista directo con Almendro.
  • Ideal para emprender desde casa y en el horario que quiera: vendedores independientes, contadores, asociaciones y familias con pymes.
Para empezar

Distribuidor 50

$48 por unidad

  • Planes Pyme de 1 año 50
  • Total del pozo $2 400
  • Ventana de venta 12 meses
  • Recupera su inversión venta 25
  • Potencial de lista $4 800
Quiero ser distribuidor
Para crecer

Distribuidor 100

$32 por unidad

  • Planes Pyme de 1 año 100
  • Total del pozo $3 200
  • Ventana de venta 18 meses
  • Recupera su inversión venta 34
  • Potencial de lista $9 600
Quiero ser distribuidor
El más elegido El favorito

Distribuidor 250

$24 por unidad

  • Planes Pyme de 1 año 250
  • Total del pozo $6 000
  • Ventana de venta 3 años
  • Recupera su inversión venta 63
  • Potencial de lista $24 000
Quiero ser distribuidor
Para organizaciones

Distribuidor 500

$20 por unidad

  • Planes Pyme de 1 año 500
  • Total del pozo $10 000
  • Ventana de venta 4 años
  • Recupera su inversión venta 105
  • Potencial de lista $48 000
Quiero ser distribuidor

Cree su cuenta gratis y compre su pozo desde Mi Plan. ¿Ya tiene cuenta? Entre al portal y búsquelo en Mi Plan.

Pagando por transferencia bancaria tiene hasta un 20% de descuento adicional sobre el precio del pozo. Contacte a soporte para realizar el proceso.

Compre seguro: todos nuestros distribuidores tienen insignia oficial con QR verificable y aparecen en el directorio público. Verifique antes de pagar. Ver el directorio de distribuidores »

Preguntas frecuentes

Lo que más nos consultan antes de empezar.

¿Qué necesito para empezar?
Su cédula y el certificado de firma para comprobantes electrónicos (el archivo con su PIN). Si todavía no lo tiene, le guiamos para generarlo. Después empieza gratis, sin tarjeta.
¿Cuánto cuesta Almendro?
Hay un plan gratis con 3 comprobantes al mes y sin tarjeta. Los planes pagos van desde 36 dólares al año (Emprendedor, 20 comprobantes al mes) hasta 758 dólares al año (Integrador, 10.000 comprobantes al mes).
¿Ocupo saber programar para usar Almendro?
No. Factura desde el portal web, sin escribir una línea de código: crea el comprobante, lo firma y lo envía a Hacienda desde el navegador. La API queda ahí para cuando quiera conectar su punto de venta, e-commerce o sistema.
¿Almendro es un facturador autorizado por Hacienda?
En Costa Rica el Ministerio de Hacienda no certifica ni autoriza facturadores. Cualquier sistema puede emitir comprobantes válidos siempre que pasen la validación del ATV. Los comprobantes de Almendro se generan en formato XML 4.4, se firman con XAdES-EPES y son aceptados por Hacienda.
¿Qué tipos de comprobante electrónico soporta?
Los 7 tipos de la versión 4.4: Factura Electrónica, Tiquete Electrónico, Nota de Crédito, Nota de Débito, Factura de Compra, Factura de Exportación y Recibo Electrónico de Pago.
¿Qué pasa si Hacienda rechaza un comprobante?
Le avisamos con el motivo exacto que devuelve Hacienda para que lo corrija y lo reenvíe. Cada comprobante queda registrado con su estado, así siempre sabe cuáles quedaron aceptados y cuáles no.
¿Cómo recibo las facturas que me envían mis proveedores?
De forma automática. Pídale a sus proveedores que envíen los comprobantes a facturas@almendro.cr, o reenvíelos usted desde su correo: Almendro identifica al receptor por la cédula del XML y los deja en su buzón de recibidos, listos para su trámite. Incluida en todos los planes; solo necesita su certificado de Hacienda activo, y su plan define cuántos comprobantes recibe al mes.
¿Puedo aceptar, rechazar o aceptar parcialmente los comprobantes que me llegan?
Sí. En Recibidos ve los comprobantes que otros emisores le envían y responde cada uno: aceptación total, aceptación parcial o rechazo. Almendro genera el Mensaje Receptor en formato 4.4 y lo manda a Hacienda por usted.
¿Y si me paso del límite de mi plan?
Depende del plan. Algunos cobran un pequeño excedente por comprobante extra y otros se detienen al llegar al tope; en los dos casos lo ve antes de pasarse y puede subir de plan cuando quiera.
¿Por cuánto tiempo guarda mis comprobantes y puedo descargarlos?
La obligación de conservar los comprobantes durante 5 años es del contribuyente, no del facturador. Puede descargar sus comprobantes en XML y PDF desde el portal cuando quiera. Almendro los resguarda 3 meses en todos los planes, más de lo que exige la normativa a un facturador; si quiere que los conservemos por usted hasta 5 años, active la retención extendida por 12 dólares al año.
¿Puedo manejar varias sucursales y cajas por contribuyente?
Sí. Configura varias sucursales y varias cajas en cada una, con su consecutivo independiente. El tope va según el plan: desde 1 sucursal en el plan gratis hasta 50 sucursales con 20 cajas cada una en el plan Integrador.
¿Sirve para contadores e integradores que facturan por varios clientes?
Sí. Los planes Contadores e Integrador permiten facturar por hasta 20 contribuyentes gestionados desde una sola interfaz o una sola API, con precios pensados para volumen.
¿Qué es el programa de Distribuidor Autorizado?
Un canal para crear su propio ingreso: usted compra un pozo de planes Pyme a precio de mayorista y los distribuye al precio que decida; Almendro pone la plataforma, la administración y el soporte de sus clientes. Las inscripciones están abiertas por tiempo limitado. Contacte a soporte para más información.
¿Almendro tiene API con sandbox para desarrolladores?
Sí, es parte de nuestro ADN: hecho por desarrolladores para desarrolladores. Ofrecemos una API REST con sandbox real, webhooks en tiempo real, ejemplos de código y documentación completa para conectar su punto de venta, e-commerce, ERP o CRM.

Empiece a facturar hoy mismo

3 comprobantes gratis por mes, sin tarjeta.

Facture gratis ahora
Contacto

¿Hablamos?

Una vía para dudas generales y otra para soporte de clientes.

¿Tiene dudas?

Cuéntenos sobre el portal, la API, los planes o la integración y le respondemos pronto.

  • Correo info@almendro.cr
  • Ubicación San Ramón, Costa Rica
  • Horario Lun a Vie, 8am a 5pm (GMT-6)

Escríbanos por WhatsApp: le responde una persona del equipo, no un bot.