K KyrFact · API
Hacienda v4.4 · Costa Rica

Electronic invoicing,
finally an API.

Issue, sign, submit, and notify every Costa Rican Hacienda document type with one HTTP call. FE, TE, NC, ND, FEC, FEE — one consistent payload.

terminal
# issue an invoice
$ curl -X POST $KYRFACT_API_BASE/v1/invoices \
    -H "Authorization: Bearer kf_live_…" \
    -H "Idempotency-Key: order-12345" \
    -d '{ "type": "FE", "totalComprobante": 113, … }'

{
  "id": "6500…",
  "status": "enviada",
  "clave": "50601012600031012345…",
  "consecutivo": "00100001010000000042"
}
Built for production

The boring parts of invoicing — handled.

Costa Rica Hacienda integration distilled into a clean API surface. No P12 management, no XAdES toolchain, no signing libraries to maintain.

01

One endpoint, every doc type

The same request shape for FE, TE, NC, ND, FEC, FEE. Pick a type, send the payload, get the clave back synchronously.

02

Signing handled for you

XAdES-BES signing, OAuth, and Hacienda submission all happen behind the scenes. No P12 management on your end.

03

Math validated up front

Totals are recomputed from your line items before any consecutivo is allocated. Bad math returns a structured 400 with per-field diffs.

04

Idempotent by design

Retry-safe via Idempotency-Key. Network drops never produce duplicate invoices or burn consecutivos.

05

PDF, XML & email

We render the PDF, archive both XMLs, and email the receptor with all three attached. Configurable per call.

06

Multi-tenant from day one

Every list and lookup is scoped to your tenant by the API key. Cross-tenant access is impossible by construction.

Document types

Every Hacienda document type, one API.

All six covered with the same request shape. Pick the one that matches your use case.

FE Factura Electrónica Standard sale to a known buyer.
TE Tiquete Electrónico POS receipt for an unidentified consumer.
NC Nota de Crédito Cancel or reduce a prior FE/TE.
ND Nota de Débito Add a charge on top of a prior FE/TE.
FEC Factura Electrónica de Compra Record a purchase from a paper-only supplier.
FEE Factura Electrónica de Exportación Export sale to a foreign buyer.
Compare them all
By the numbers

Production-grade.

From the same invoicing engine that ships invoices for Costa Rican businesses today.

470k+
invoices issued
~90s
median time to completa
v4.4
Hacienda spec supported
2
environments (live + test)

Ready to integrate?

Get an API key, follow the 90-second quick start, and ship before lunch.