• Enviar Factura Email API: automatiza el envío de facturas con su PDF

Enviar Factura Email API: automatiza el envío de facturas con su PDF

Descripción

EnviarFacturaEmailApi añade un endpoint personalizado a la API REST de FacturaScripts para enviar una factura de cliente por email, con su PDF adjunto, desde cualquier sistema externo sin entrar en el panel de administración.

El envío lo realiza el propio FacturaScripts, así que respeta toda tu configuración: el servidor SMTP, la plantilla de correo sendmail-FacturaCliente y el registro en el historial de emails enviados. El resultado es idéntico a un envío manual desde la interfaz.

Uso

• Método: POST
• Endpoint: /api/3/enviarFacturaCliente/{idfactura}

La petición se autentica con el token de una API key que tenga permiso sobre el recurso enviarFacturaCliente.

Parámetros admitidos en el cuerpo de la petición (opcionales):

• email: fuerza el destinatario en lugar de resolverlo automáticamente.
• force: si vale 1, reenvía la factura aunque ya constara como enviada.

Ejemplo:

curl -X POST "https://tu-dominio.com/api/3/enviarFacturaCliente/42" \
  -H "Token: TU_API_KEY"

Respuesta correcta:

{                                                                                             
	"ok": true,
  "email": "cliente@ejemplo.com",                                                              
	"codigo": "FAC2026/0042"
}

Cómo funciona

• Genera el PDF de la factura cortación estándar y lo adjunta alcorreo.
• Resuelve el destinatario siguiendo la jerarquía del envío manual: email de la factura, del contacto de facturación o del cliente. También puede forzarse con el parámetro email.
• Toma el asunto y el cuerpo de la notificación sendmail-FacturaCliente; si no existe, usa los textos de traducción del sistema.
• No reenvía una factura ya enviada salvo que se indique force, evitando correos duplicados ante reintentos.
• Registra la fecha de envío en la factura, igual que el envío manual.

Requisitos

• FacturaScripts 2025 o superior con el email configurado.
• Una API key con permiso sobre el recurso emailFacturaCliente.

Códigos de error

• 405 · method-not-allowed — La petición no usa el método POST.
• 400 · missing-id-parameter — No se ha indicado el identificador de la factura en la URL.
• 404 · record-not-found — No existe ninguna factura con ese identificador.
• 422 · no-recipient-email — No se ha encontrado un email de destinatario válido.
• 500 · email-not-configured — El email no está configurado en FacturaScripts.
• 500 · pdf-generation-error — No se ha podido generar el PDF de la factura.
• 500 · send-mail-error — Se produjo un error al enviar el correo.

Ejemplo de respuesta de error:

{
  "status": "error",
  "message": "no-recipient-email"
}