Facturación Electrónica

Bienvenido a la documentación de integración para el servicio e-CF de Condofácil. Esta API permite gestionar el envío de Comprobantes Fiscales Electrónicos a la DGII de manera automatizada.

Estructura de la URL

La URL de la API sigue un formato semántico que facilita la identificación del ambiente y la seguridad del usuario.

https://certecf.jeshuatech.com/api/{ambiente}/enviar/{token}
ElementoDescripción
https://certecf.jeshuatech.com Dominio Base: Punto de enlace principal.
/api Path Raíz: Acceso a la interfaz programática.
/{ambiente} Selector de Entorno: (testecf, certecf, ecf).
/enviar Recurso: Método para el procesamiento y firma.
/{token} Clave de Acceso: String único de identificación.

Ambientes Disponibles

Utilice el valor correspondiente en el segmento {ambiente} de la URL:

ValorAmbientePropósito
testecfPruebasDesarrollo inicial sin validez legal.
certecfCertificaciónSet de pruebas para autorización DGII.
ecfProducciónEmisión real con validez tributaria.

Enviar un e-CF

Endpoint para la remisión de archivos XML firmados digitalmente mediante form-data.

Parámetros del Body

CampoTipoDescripción
xml FILE Archivo binario .xml del comprobante fiscal.

Interpretación de la Respuesta

La API devuelve un JSON estructurado con el resultado de la operación en la DGII.

Objeto: response

CampoDescripción
trackIdID único de seguimiento generado por la DGII.
estadoEstatus de la recepción (ej: Aceptado).
encfNúmero de Comprobante Fiscal Electrónico.
qrURL oficial para el Timbre Fiscal.
Seguridad: El token de acceso es de uso privado. Si su token se ve comprometido, solicite uno nuevo inmediatamente.
<?php

$ambiente = "certecf";
$token = "517382af5ba8fe096473acb6da5e80c8";
$url = "https://certecf.jeshuatech.com/api/$ambiente/enviar/$token";

$file_path = 'mi_comprobante.xml';

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'xml' => new CURLFile($file_path, 'application/xml')
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

header('Content-Type: application/json');
echo $response;

?>
import requests

# Configuración de URL
ambiente = "certecf"
token = "517382af5ba8fe096473acb6da5e80c8"
url = f"https://certecf.jeshuatech.com/api/{ambiente}/enviar/{token}"

files = {
    'xml': open('mi_comprobante.xml', 'rb')
}

response = requests.post(url, files=files)
print(response.json())
const formData = new FormData();
formData.append("xml", fileInput.files[0]);

const ambiente = "certecf";
const token = "517382af5ba8fe096473acb6da5e80c8";
const url = `https://certecf.jeshuatech.com/api/${ambiente}/enviar/${token}`;

fetch(url, {
  method: "POST",
  body: formData
})
.then(res => res.json())
.then(data => console.log(data));
curl -X POST https://certecf.jeshuatech.com/api/certecf/enviar/517382af5ba8fe096473acb6da5e80c8 \
     -F "xml=@/ruta/al/comprobante.xml"

Ejemplo de Respuesta Exitosa

{
  "result": {
    "success": true,
    "response": {
      "trackId": "7fcb6872-8bfd-4e3f-846a-0434bdd97305",
      "estado": "Aceptado",
      "rnc": "131886388",
      "encf": "E310000000103",
      "secuenciaUtilizada": true,
      "fechaRecepcion": "05/05/2026 10:15:00 AM"
    },
    "qr": "https://ecf.dgii.gov.do/certecf/ConsultaTimbre?..."
  }
}