Ir al contenido

Enviar el comprobante por correo

Encola el envío del PDF A4, el XML firmado y el CDR a hasta 5 destinatarios. Responde 202 Accepted; el envío ocurre en segundo plano y se reintenta si el servidor de correo falla. El remitente lleva el nombre de tu empresa. Un comprobante de prueba (clave sk_test_) se envía con el asunto [PRUEBA] y un aviso de que no tiene valor tributario.

Método: POST

POST https://faktura-test.cgallardo.me/v1/documents/{id}/email
Campo Tipo Obligatorio Descripción
to lista Sí De 1 a 5 correos de destino.
Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/documents/<id>/email \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{ "to": ["cliente@ejemplo.pe"] }'
{
"id": "01a1d5fc-899b-720e-a6ea-03d37a346f81",
"status": "queued",
"to": ["cliente@ejemplo.pe"]
}
Estado reason Causa
202 — Envío encolado (status: "queued").
401 Unauthenticated Falta la API key, es inválida o venció.
403 ApiKeyScopeInsufficient La clave es de alcance lookup.
404 NotFound El comprobante no existe para tu clave.
409 DocumentNotAccepted SUNAT aún no aceptó el comprobante: un PDF sin aceptación no tiene validez.
422 ValidationFailed, InvalidRecipients to falta, tiene más de 5 destinatarios o contiene un correo inválido.
429 EmailLimitReached, TooManyRequests Tope alcanzado: 10 envíos por comprobante y 100 por emisor por hora (o el límite de 120 peticiones/min de la clave).
503 EmailNotConfigured El envío de correos no está habilitado en el servicio.