Envío de documentos
Envía documentos por correo, acredita la identidad del remitente y distingue los errores de identidad de los límites de envío.
Usa la operación de envío del tipo de documento que necesites, con su scope de envío y la cabecera de idempotencia declarada. Enviar, marcar como enviado, descargar un PDF y presentar en FACe son operaciones distintas. Una petición aceptada por la API no demuestra que el destinatario haya recibido el correo; consulta el registro de entrega de correos.
curl -X POST "https://api.factuarea.com/v1/invoices/$INVOICE_ID/send" \
-H "Authorization: Bearer $FACTUAREA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: send-fac-2026-00042" \
--data '{
"to": "facturacion@acme.example"
}'Identidad del remitente
Cuando se aplica la comprobación de identidad del remitente, una suscripción activa de Factuarea o una identificación censal aceptada acreditan su identidad. Introducir los datos de una tarjeta no es la condición que consulta el servicio. Una respuesta censal ausente o no disponible no acredita identidad; la suscripción activa sigue siendo una alternativa.
El rechazo usa 422 sender_identity_not_verified. Completa la verificación censal o activa la suscripción y después reintenta el envío previsto. Esta guía describe el comportamiento cuando la comprobación está activa; su aplicación depende de la configuración del servicio.
Empresas gestionadas y modo test
En una empresa gestionada, la identidad del remitente se resuelve contra su gestoría. La gestoría debe corregir la identidad rechazada; no pidas a la empresa gestionada que contrate una suscripción propia. Una empresa de sandbox sigue sujeta a la supresión del modo test: los correos de documentos no se entregan a destinatarios reales.
Gestiona los fallos de envío
La identidad acreditada no elimina las cuotas de correo ni los demás presupuestos de la cuenta. Un 429 requiere la actuación y el tiempo de reintento indicados en la respuesta de límites; los reintentos inmediatos no lo resuelven. Un error de validación requiere corregir su campo. Conserva request_id al investigar una petición aceptada con una entrega inesperada. autosend_enabled de la tienda usa las mismas garantías de envío.