API REST Y WEBHOOKS · COSTA RICA

API de facturación electrónica: integre su ERP en días.

Nuestra api facturación electrónica le permite enviar un JSON simple mientras nosotros nos encargamos del XML 4.4, la firma digital y la conexión con Hacienda en tiempo real.

01 / ENDPOINTS RESTFUL

API para desarrolladores de Costa Rica.

Construimos una arquitectura robusta para que implementarla sea sumamente sencillo en cualquier sistema o ERP del mercado.

Emisión: Facturas, Tiquetes, Notas de Crédito/Débito y Exportación.
Recepción: Aceptación, rechazo parcial o total de proveedores.
Consultas: Estado en Hacienda y descarga de PDF/XML.

Explorar Documentación

# Crea un documento electrónico y lo encola automáticamente a Hacienda.
POST https://posbillingapi.facturele.com/api/v1/company/0009/bills
Authorization: Bearer {token}

{
  "type": 4,
  "client_id": 1,
  "sale_condition": "01",
  "currency": "CRC",
  "branch_id": 1,
  "payment_methods": [
    { "code": "01", "amount": 11300 }
  ],
  "details": [
    {
      "product_code": "0001",
      "cabys_code": "8715500000000",
      "description": "Producto de prueba",
      "unit_measurement": "Unid",
      "quantity": 2,
      "unit_price": 5000,
      "tax_code": "01",
      "tax_rate": 13,
      "tariff_code": "08"
    }
  ]
}

// RESPUESTA 201
{
  "data": {
    "bill_number": 1542,
    "type": 4,
    "client": { "id": 1, "name": "Cliente General" },
    "date": "2026-07-08T15:30:00-06:00",
    "subtotal": 10000,
    "tax": 1300,
    "total": 11300,
    "hacienda_status": "pendiente"
  },
  "meta": { "request_id": "...", "version": "v1" }
}

// Payload del webhook recibido en su servidor
{
  "event": "document.accepted",
  "timestamp": "2026-07-08T15:35:00Z",
  "data": {
    "company_id": 9,
    "document_type": 1,
    "document_type_name": "invoice",
    "document_id": 1542,
    "status": "aceptado",
    "message": "Envio exitoso"
  }
}

02 / ARQUITECTURA

Ventajas de integrar Factúrele

Deje que nuestro motor maneje la firma electrónica y las validaciones de Hacienda mientras su software utiliza nuestra api facturación electrónica de forma fluida.

Webhooks (Event-Driven): Reciba payloads instantáneos en su callback_url cuando Hacienda responde. Sin polling ineficiente.
Firmador XML Integrado: La API convierte su JSON en XML 4.4 oficial y aplica la firma digital por usted. Sin llaves locales.
Recepción Automatizada: Consulte y acepte facturas de proveedores directo desde su módulo de Cuentas por Pagar.
Conector SAP B1: Mapeo directo de documentos de marketing y socios de negocio listo para implementar.

Desarrollo propio

Meses de trabajo

Lidiar con criptografía compleja, validaciones XML, intermitencias del servidor de Hacienda y actualizaciones normativas sorpresa.

→

Con Factúrele API

Días o semanas

Un endpoint estable que absorbe la complejidad fiscal. Su equipo conecta el JSON y vuelve a enfocarse en su producto core.

Cree su cuenta

Regístrese gratis y obtenga acceso inmediato a sus credenciales de Sandbox.

Paso 1

Revise los Endpoints

Explore nuestra documentación estructurada con ejemplos claros de request y response.

Paso 2

Simule Envíos

Conecte su ERP al ambiente de pruebas y fuerce respuestas de aceptación o rechazo.

Paso 3

Pase a Producción

Cambie las llaves, conecte las empresas de sus clientes reales y empiece a operar.

Paso 4

Preguntas técnicas

Preguntas frecuentes sobre nuestra API

¿Tengo que firmar los XML en mi servidor?

No. Facturele funciona como un firmador centralizado. Usted envía un payload en JSON con los datos del negocio y nuestra plataforma genera el XML estructura 4.4, le aplica la firma criptográfica y lo transmite a Hacienda.

¿Tienen ambiente de pruebas?

Sí, proporcionamos un entorno gratuito. Puede simular la emisión de documentos, forzar respuestas de Hacienda (aceptado/rechazado) y probar sus webhooks sin comprometer la información real de su empresa.

¿Cómo manejan el catálogo CABYS?

La API valida automáticamente que los códigos CABYS enviados en el JSON existan y estén vigentes en la última base de datos del Banco Central, reduciendo los rechazos de Hacienda por códigos obsoletos.

¿Se cobra por consumo o por usuario?

El modelo de facturación de la API es exclusivamente por volumen de documentos procesados. Las llamadas a endpoints de consulta y los webhooks no se cobran, ni existen límites de usuarios o sucursales conectadas.

Mes Gratis

Pruebe nuestra API de facturación electrónica costa rica sin costo.

Cree su cuenta de desarrollador, obtenga sus llaves de API y envíe su primer JSON en menos de 10 minutos.

Obtener una prueba gratuita Ver Planes Con API

Soporte técnico directo con nuestros ingenieros