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}
| Elemento | Descripció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:
| Valor | Ambiente | Propósito |
|---|---|---|
testecf | Pruebas | Desarrollo inicial sin validez legal. |
certecf | Certificación | Set de pruebas para autorización DGII. |
ecf | Producción | Emisió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
| Campo | Tipo | Descripció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
| Campo | Descripción |
|---|---|
trackId | ID único de seguimiento generado por la DGII. |
estado | Estatus de la recepción (ej: Aceptado). |
encf | Número de Comprobante Fiscal Electrónico. |
qr | URL 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?..."
}
}