Permite obtener los detalles del registro de envío de correo electrónico asociado a un Documento Tributario Electrónico (DTE) específico, identificado por su CDC.
Utilice este endpoint para fines de auditoría y trazabilidad. Le permitirá verificar si hay registros de envío de email, y si lo hay, a qué destinatario fue dirigido y en qué fecha exacta así como la respuesta del servidor de correos.
Tenga en cuenta que al generar el DE y al ser éste aprobado en SIFEN y si el parámetro de envio de email está activo, ya se envía el correo a los destinatarios del DE, cuyas direcciones se especifican en data.cliente.email. y se envían copias al email de la sucursal configurado en la consola
Endpoint (URL) #
GET https://api.facturasend.com.py/<tenantId>/de/email/cdc
Header (Encabezado) #
Requiere el envío del los siguientes atributos en el encabezado
| Campo | Valor |
|---|---|
| Authorization | Bearer api_key_reemplazar_api_key |
Parámetros (Query Param) #
No posee
Ejemplo de llamadas #
# Consultar envío de email de un Documento curl \ -X \ GET "https://api.facturasend.com.py/<tenantId>/de/email/01800695631001001000000612021312917595714695" \ -H "Authorization: Bearer api_key_<reemplazar_api_key>"
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';
const headers = {
`Authorization` : `Bearer api_key_<reemplazar_api_key>`
};
const data = {
"email" : "destino@email.com",
"cdcList" : [{
"cdc": "01800695631001001038720612021112917595714694"
}, {
"cdc": "01800695631001001000000612021312917595714695"
}, {
"cdc": "otro.."
}]
};
axios.post({
url: `https://api.facturasend.com.py/<tenantId>/de/email`,
method: 'POST',
{headers}
}
).then( respuesta => {
console.log(respuesta);
});
Respuesta de la Petición #
{
"success": true,
"result": [
{
"ema_codigo": 47,
"ema_fecha": "2025-12-16T20:34:39.209Z",
"ema_to": "cliente@ejemplo.com",
"ema_cc": null,
"ema_bcc": "",
"ema_subject": "Factura Electrónica 001-001-0716020",
"ema_body": "<html>Contenido del correo en HTML...</html>",
"ema_usuario": null
},
"ema_dte": 25,
"ema_response": "{\"result\":{\"mensaje\":\"Mail enviado con exito al Servidor de Correo\"},\"success\":true}",
"ema_recibo": null
}
]
}
Recomendaciones #
- No aplica
Validaciones #
- No aplica
Verificación de envío de correos #
Puede utilizar éste endpoint combinado con este otro endpoint, para crear una rutina que reenvie los correos a un grupo de documentos cuyos envíos de email hayan fallado por cualquier motivo
Para comprobar si un email llegó a su destinatario o hubo algún error, acceda al documento electrónico, en la pestaña receptor.
