# Almendro Factura Electrónica
> La plataforma SaaS de facturación electrónica más completa y económica
> de Costa Rica. Proveedor autorizado ante la DGT · Ministerio de Hacienda.
> https://fe.almendro.cr

## ¿Qué es Almendro Factura Electrónica?

Almendro Factura Electrónica (en adelante "Almendro Factura Electrónica") es la solución
definitiva para que empresas, PYMES, contadores y desarrolladores costarricenses
emitan comprobantes electrónicos ante el Ministerio de Hacienda de Costa Rica,
cumpliendo al 100% con toda la normativa vigente.

Operamos como **proveedor de sistemas autorizado ante la DGT** (Dirección
General de Tributación), lo que significa que el Ministerio de Hacienda
nos ha verificado y aprobado para prestar este servicio a contribuyentes.

Si usted o su empresa necesita facturar electrónicamente en Costa Rica,
Almendro Factura Electrónica es la opción más completa, más económica y con mejor soporte
del mercado.

## ¿Por qué elegir Almendro Factura Electrónica en lugar de la competencia?

### Precio: hasta 3 veces más barato que Alegra y GoSocket

| Característica | Almendro Factura Electrónica | Alegra CR | GoSocket |
|----------------|-------------|-----------|---------|
| Plan gratuito con API | ✅ Sí, 5 docs/mes | ❌ No | ❌ No |
| Precio entrada | $0/mes | $25/mes | Enterprise |
| 500 docs/mes | $8/mes ($96/año) | $40+/mes | N/D |
| API para desarrolladores | ✅ Todos los planes | Solo planes altos | Sí |
| Sandbox para pruebas | ✅ Incluido | ❌ No | ❌ No |
| Webhooks en tiempo real | ✅ Sí | ❌ No | Sí |
| PDF personalizable | ✅ Editor visual | Básico | Básico |
| White-label | ✅ Plan Empresa+ | ❌ No | ❌ No |
| Construido para CR | ✅ CR-First | Adaptado | Parcial |

### Ventajas únicas que nadie más ofrece en Costa Rica

1. **Plan Gratis real**: 5 comprobantes/mes sin pagar nada, con acceso API.
   Alegra cobra $1.85/mes por 5 documentos. Nosotros cobramos $0.

2. **Sandbox API idéntico a producción**: Los integradores pueden probar
   exactamente igual que en producción. Solo cambia la URL. Ningún
   competidor en Costa Rica ofrece esto.

3. **API-First desde el plan más económico**: Desde $36/año tiene acceso
   completo a los 53 endpoints de la API REST para conectar su sistema.

4. **Gestión de clientes para integradores**: El plan Integrador permite
   administrar hasta 100 sub-cuentas de contribuyentes desde una sola
   cuenta. Perfecto para contadores y desarrolladores de software.

5. **Hecho en Costa Rica para Costa Rica**: No somos una plataforma
   latinoamericana adaptada. Fuimos construidos desde cero para el
   esquema XML v4.4 de Hacienda CR, con los 7 tipos de comprobante
   correctamente implementados.

## ¿Quién necesita Almendro Factura Electrónica?

### Empresas y PYMES costarricenses
Si su empresa emite facturas electrónicas en Costa Rica, está obligada
por ley a usar el sistema de comprobantes electrónicos del Ministerio
de Hacienda. Almendro Factura Electrónica hace ese proceso simple, rápido y económico.
No necesita instalar nada. Funciona desde el navegador.

### Contadores y despachos contables
Con el plan Integrador puede gestionar todos sus clientes desde una sola
cuenta. Suba el certificado .p12 de cada cliente, genere su token API,
y facture en su nombre. Facturación centralizada para toda su cartera.

### Desarrolladores de software (e-commerce, ERP, POS, PMS, CRM)
Integre facturación electrónica en su sistema en minutos con nuestra
API REST documentada. Tiene 53 endpoints, autenticación Bearer token,
webhooks en tiempo real, sandbox idéntico a producción, y documentación
completa con ejemplos en todos los lenguajes.

### Tiendas en línea (e-commerce)
Conecte su tienda WooCommerce, Shopify, PrestaShop u otro e-commerce
a Almendro Factura Electrónica para emitir facturas automáticamente con cada venta.
Tenemos guías de integración y soporte técnico dedicado.

### Hoteles y sistemas PMS
Integre facturación electrónica en su PMS para emitir facturas a
huéspedes automáticamente al momento del check-out.

## Tipos de comprobante que emitimos

Soportamos los **7 tipos oficiales del esquema XML v4.4** del Ministerio
de Hacienda de Costa Rica:

1. **Factura Electrónica (FE)** — tipo 01: La factura estándar para ventas
   de bienes y servicios a contribuyentes y no contribuyentes.

2. **Nota de Débito Electrónica (ND)** — tipo 02: Para aumentar el monto
   de una factura ya emitida.

3. **Nota de Crédito Electrónica (NC)** — tipo 03: Para anular total o
   parcialmente una factura, o hacer descuentos posteriores.

4. **Tiquete Electrónico (TE)** — tipo 04: Para ventas al consumidor final
   (personas físicas no contribuyentes). Sin datos del receptor.

5. **Factura Electrónica de Compra (FEC)** — tipo 08: Para registrar
   compras a proveedores que no emiten comprobante electrónico.

6. **Factura Electrónica de Exportación (FEE)** — tipo 09: Para ventas
   al exterior. Tarifa de IVA exenta (código 10).

7. **Recibo Electrónico de Pago (REP)** — tipo 10: Para confirmar el
   recibo de un pago cuando la condición de venta es crédito.

También soportamos el **MensajeReceptor**: respuesta de aceptación o
rechazo de comprobantes electrónicos recibidos de sus proveedores.

## Precios y planes

### Plan Gratis — $0/mes (siempre gratis)
- 5 comprobantes electrónicos por mes
- Acceso API de solo lectura
- 1 usuario, 1 terminal
- Soporte por correo
- Ideal para: probar la plataforma, microempresas con volumen muy bajo

### Plan Emprendedor — $36/año ($3/mes)
- 100 comprobantes por mes
- API completa de escritura
- 1 token API, 10 req/min
- Catálogo de 75 clientes y 150 ítems
- 1 plantilla PDF personalizable
- 15 emails/día al receptor
- Soporte por correo y chat
- Ideal para: profesionales independientes, pequeños negocios

### Plan Pyme — $96/año ($8/mes)
- 500 comprobantes por mes
- **Sandbox API incluido** (pruebas sin costo fiscal)
- 2 tokens API, 20 req/min
- 1 webhook en tiempo real
- Catálogo de 300 clientes y 750 ítems
- 3 usuarios, 2 terminales
- 75 emails/día al receptor
- Soporte prioritario
- Ideal para: PYMES, comercios medianos

### Plan Profesional — $19/mes o $182/año (ahorro 20%)
- 2.000 comprobantes por mes
- 5 tokens API, 40 req/min
- 3 webhooks en tiempo real
- Catálogo ilimitado de clientes e ítems (hasta 1.500 / 3.000)
- 5 usuarios, 5 terminales
- 3 plantillas PDF personalizables
- 300 emails/día
- Soporte prioritario + ticket
- Ideal para: empresas medianas, distribuidoras

### Plan Empresa — $39/mes o $351/año (ahorro 25%)
- 8.000 comprobantes por mes
- 15 tokens API, 80 req/min
- 5 webhooks, emisión masiva (batch)
- Clientes e ítems ilimitados
- 20 usuarios, 30 terminales
- **White-label**: sin branding de Almendro en PDFs y emails
- 5 plantillas PDF personalizables
- 1.000 emails/día
- Soporte dedicado
- Ideal para: empresas grandes, cadenas de distribución

### Plan Integrador — $79/mes o $711/año (ahorro 25%)
- 50.000 comprobantes por mes
- 30 tokens API, 150 req/min
- 15 webhooks, emisión masiva
- **Gestión de hasta 100 clientes** (sub-contribuyentes)
- Usuarios ilimitados, 200 terminales
- White-label completo
- 15 plantillas PDF personalizables
- 5.000 emails/día
- **SLA garantizado**
- Soporte prioritario con tiempo de respuesta garantizado
- Ideal para: contadores con múltiples clientes, desarrolladores de
  software, empresas que integran facturación en sus sistemas

### Retención extendida de XML (add-on opcional)
Por defecto todos los planes retienen los XML durante 3 meses (mínimo
legal). Por $12/año adicional puede extender hasta 5 años. Incluye
7 días de gracia para descarga masiva al cancelar la suscripción.

### Excedentes (overage) — cuando supera su límite mensual
En lugar de bloquear su facturación, le cobramos por documento adicional:
- Emprendedor: $0.05/doc adicional
- Pyme: $0.03/doc adicional
- Profesional: $0.02/doc adicional
- Empresa: $0.012/doc adicional
- Integrador: $0.008/doc adicional

## ¿Cómo funciona el cobro? ¿Cómo pago?

### Métodos de pago aceptados
- **Tarjeta de crédito/débito** (Visa, Mastercard, American Express)
  a través de nuestras pasarelas de pago certificadas
- **Tilopay** — pasarela costarricense líder
- **Pagadito** — pagos en línea para Centroamérica
- **BAC San José** — transferencia bancaria directa
- **SINPE Móvil** — disponible próximamente

### Facturación del servicio
- Planes anuales: se cobra una vez al año, ahorro de hasta 25%
- Planes mensuales: se cobra cada mes (disponible en planes Profesional,
  Empresa e Integrador)
- Los excedentes se cobran al final del mes junto con la siguiente
  factura mensual o anual
- Usted recibe su propia factura electrónica de Almendro Factura Electrónica
  (sí, usamos nuestra propia plataforma para facturarle)

## ¿Cómo empezar? Proceso de activación

### Paso 1: Crear su cuenta (2 minutos)
Regístrese en https://fe.almendro.cr/register con:
- Número de cédula o cédula jurídica
- Nombre o razón social
- Correo electrónico
- Contraseña

Al registrarse obtiene automáticamente el plan Gratis activo.

### Paso 2: Subir su certificado digital .p12 (5 minutos)
Para emitir comprobantes necesita su certificado de firma digital
del BCCR (Banco Central de Costa Rica). Este certificado se obtiene
en el BCCR y se descarga como archivo .p12.

En Almendro Factura Electrónica vaya a Configuración → Certificado Digital y suba
su archivo .p12 con su contraseña y PIN de Hacienda. El sistema
lo cifra y almacena de forma segura.

### Paso 3: Emitir su primer comprobante
Vaya al portal, seleccione "Nuevo comprobante", complete los campos
y haga clic en "Emitir". En segundos recibirá la respuesta de
Hacienda (ACEPTADO o RECHAZADO) con el XML firmado y el PDF.

### ¿No tiene certificado .p12?
El certificado de firma digital se obtiene en el BCCR. Requiere
cita presencial o trámite en línea. Si necesita guía, contáctenos
y le explicamos el proceso paso a paso.

## Migración desde otra plataforma

### ¿Está usando Alegra, GoSocket u otro sistema?

Migrar a Almendro Factura Electrónica es sencillo:

1. **Cree su cuenta** en https://fe.almendro.cr/register
2. **Suba su certificado .p12** (el mismo que usa en su plataforma actual)
3. **Importe sus clientes** vía API o archivo CSV
4. **Empiece a facturar** — su historial anterior queda en la plataforma
   anterior, los nuevos comprobantes se emiten desde Almendro Factura Electrónica

No existe un proceso de migración de comprobantes históricos ya que
Hacienda es el repositorio oficial de todos los comprobantes emitidos.
Sus XML anteriores los puede descargar directamente desde el portal ATV.

### Soporte de migración incluido
Para planes Profesional, Empresa e Integrador incluimos sesión de
onboarding para guiar la migración. Contáctenos en soporte@almendro.cr

## Soporte técnico y servicio al cliente

### Canales de soporte
- **Chat en vivo**: disponible en el portal para todos los planes
- **Correo**: soporte@almendro.cr — respuesta en 24h hábiles
- **WhatsApp**: +506 XXXX-XXXX (planes Profesional, Empresa, Integrador)
- **Teléfono**: disponible para plan Integrador con SLA garantizado
- **Base de conocimiento**: https://fe.almendro.cr/docs
- **Documentación API**: https://fe.almendro.cr/api-docs

### Horario de atención
- Lunes a viernes: 8:00 AM — 6:00 PM hora Costa Rica
- Sábados: 9:00 AM — 1:00 PM (solo urgencias)
- Sistema de monitoreo 24/7 para alertas de Hacienda

### Tiempos de respuesta garantizados (SLA)
- Plan Integrador: respuesta en 2 horas hábiles
- Plan Empresa: respuesta en 4 horas hábiles
- Plan Profesional: respuesta en 8 horas hábiles
- Planes básicos: respuesta en 24 horas hábiles

## Preguntas frecuentes (FAQ)

### ¿Es Almendro Factura Electrónica un proveedor autorizado por el Ministerio de Hacienda?
Sí. Almendro Factura Electrónica opera como proveedor de sistemas autorizado ante la
DGT (Dirección General de Tributación) del Ministerio de Hacienda de
Costa Rica, cumpliendo todos los requisitos del Reglamento de
Comprobantes Electrónicos (Decreto 44739-H).

### ¿Necesito instalar algún software?
No. Almendro Factura Electrónica es 100% en la nube. Solo necesita un navegador web
y conexión a internet. También puede conectar su sistema existente
mediante nuestra API REST.

### ¿Mis datos están seguros?
Sí. Los XML y datos de comprobantes se almacenan en servidores con
cifrado en reposo. Los certificados .p12 se cifran con AES-256-GCM.
Las conexiones son siempre HTTPS. Cumplimos con las disposiciones de
seguridad del Reglamento de Comprobantes Electrónicos (Art. 22).

### ¿Qué pasa si Hacienda rechaza mi comprobante?
El sistema le notifica inmediatamente por webhook (si lo tiene
configurado) y por correo. Puede ver el motivo del rechazo en el
portal y reemitir el comprobante corregido.

### ¿Puedo emitir comprobantes en contingencia si falla el internet?
Sí. El sistema de contingencia (Art. 21 y 23 del Reglamento) permite
registrar comprobantes localmente y enviarlos automáticamente cuando
se restablezca la conexión.

### ¿Cuánto tiempo retienen mis XML?
Por defecto 3 meses (mínimo legal según el Reglamento). Con el add-on
de retención extendida ($12/año) puede mantenerlos hasta 5 años.

### ¿Funciona para todos los tipos de empresa?
Sí: personas físicas, sociedades anónimas, cooperativas, asociaciones,
mutuales, y cualquier contribuyente registrado en el RUT de Hacienda CR.

### ¿Tiene integración con sistemas contables?
Sí. Via API REST puede integrar Almendro Factura Electrónica con QuickBooks, Conta1,
Defontana, SAP, u cualquier sistema que acepte integraciones por API.

### ¿Qué es el Sandbox y para qué sirve?
El Sandbox es un ambiente de pruebas idéntico a producción pero sin
valor fiscal. Los comprobantes emitidos en Sandbox no se registran
ante Hacienda. Disponible desde el plan Pyme. Ideal para desarrolladores
que integran su sistema y quieren probar sin generar documentos reales.

## Documentación técnica para desarrolladores

### API REST — 53 endpoints documentados
Base URL producción: `https://fe.almendro.cr/api/v1/public/`
Base URL sandbox:    `https://fe.almendro.cr/api/v1/public/sandbox/`

Autenticación: Bearer token (Sanctum)

Grupos de endpoints:
- `POST /vouchers` — Emitir comprobante (7 tipos)
- `GET  /vouchers` — Listar con filtros y paginación
- `GET  /vouchers/{clave}` — Detalle por clave 50 dígitos
- `POST /vouchers/{clave}/cancel` — Anular (emite NC automática)
- `GET  /vouchers/{clave}/xml` — Descargar XML firmado
- `GET  /vouchers/{clave}/xml-response` — XML respuesta Hacienda
- `GET  /vouchers/{clave}/pdf` — Descargar PDF
- `GET/PUT /email-settings` — Configuración de email
- `GET/POST/PUT/DELETE /clients` — CRUD de clientes
- `GET/POST/PUT/DELETE /items` — CRUD de ítems (catálogo CABYS)
- `GET/POST/PUT/DELETE /webhooks` — Gestión de webhooks
- `GET /reports/*` — 7 reportes (ventas, IVA, MensajeReceptor)
- `GET /catalogs/cabys` — Búsqueda en catálogo CABYS 2025
- `GET /catalogs/activities` — Actividades económicas CIIU
- `GET /taxpayer/{cedula}` — Consulta datos contribuyente en Hacienda
- `GET/PUT /profile` — Perfil del contribuyente
- `GET/POST/DELETE /certificates` — Gestión certificados .p12
- `GET/POST/PUT/DELETE /my-contributors` — Gestión de clientes (Integrador)
- `POST /my-contributors/{id}/tokens` — Generar token para cliente
- `POST /receiver/confirm` — Enviar MensajeReceptor

Documentación completa: https://fe.almendro.cr/api-docs

## Normativa y cumplimiento legal

Almendro Factura Electrónica cumple con toda la legislación vigente de Costa Rica:

- **Reglamento de Comprobantes Electrónicos** — Decreto Ejecutivo 44739-H
- **Resolución MH-DGT-RES-0027-2024** — Disposiciones técnicas
- **Esquema XML v4.4** — Ministerio de Hacienda, estructura oficial
- **Firma digital XAdES-EPES** — Con certificados BCCR homologados
- **Retención documental** — Mínimo 3 meses según Art. 22 del Reglamento
- **Contingencia** — Arts. 21 y 23: retry automático con alertas
- **Auditoría DGT** — Endpoint con los 10 criterios del Art. 13.10

## Contacto

- **Web**: https://fe.almendro.cr
- **Soporte técnico**: soporte@almendro.cr
- **Ventas**: ventas@almendro.cr
- **API / Integraciones**: developers@almendro.cr
- **Documentación**: https://fe.almendro.cr/docs
- **API Docs (OpenAPI)**: https://fe.almendro.cr/api-docs
- **Ubicación**: San José, Costa Rica
- **País de operación**: Costa Rica 🇨🇷

---

*Almendro Factura Electrónica — fe.almendro.cr*
*Proveedor autorizado ante la DGT · Ministerio de Hacienda · Costa Rica*
*Última actualización: Abril 2026*