Costa Rica Invoices (Hacienda comprobante electronico v4.4)

Assemble a Costa Rica 50-digit clave numerica from its parts — a PURE LOCAL helper (no network, no credentials, no fiscal effect). Structure: 506 + DD + MM + YY + cedula(12) + consecutivo(20) + situacion(1) + codigoSeguridad(8). Provide either the ready-made 20-digit consecutivo, or its parts (sucursal, terminal, tipoComprobante, numeroConsecutivo). tipoComprobante codes: 01=Factura, 02=Nota Debito, 03=Nota Credito, 04=Tiquete, 08=Factura de Compra, 09=Factura de Exportacion, 10=Recibo de Pago. …

Query the processing status of a previously submitted Costa Rica comprobante by its 50-digit clave — the GET /recepcion/{clave} call. Returns ind_estado: "recibido" (queued) / "procesando" (in process) / "aceptado" (ACCEPTED — fiscally valid, hand respuesta_xml to the buyer) / "rechazado" (REJECTED — read respuesta_xml for the reason, fix and resubmit) / "error". respuesta_xml (base64) is the Hacienda "Mensaje Hacienda" response document. Poll this after submit_invoice until ind_estado is acepta…

Submit an ALREADY-SIGNED Costa Rica electronic invoice (comprobante electronico v4.4) to the Ministerio de Hacienda reception gateway — the /recepcion call. You build the v4.4 XML (FacturaElectronica / TiqueteElectronico / NotaCredito etc.), sign it with YOUR Hacienda certificate (llave criptografica), and pass { clave, fecha, emisor, receptor?, comprobante_xml(base64 signed XML) }. This server does NOT sign and does NOT hold your certificate — it exchanges your ATV API user/password for an OAut…