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
Endpoint
Sección titulada «Endpoint»POST https://faktura-test.cgallardo.me/v1/documents/{id}/emailPOST https://faktura.cgallardo.me/v1/documents/{id}/email| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
to |
lista | Sí | De 1 a 5 correos de destino. |
Ejemplo
Sección titulada «Ejemplo»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"] }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->post('https://faktura-test.cgallardo.me/v1/documents/<id>/email', ['to' => ['cliente@ejemplo.pe']]);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/documents/<id>/email', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', }, body: JSON.stringify({ to: ['cliente@ejemplo.pe'] }),});const data = await response.json();Respuesta 202 Accepted
Sección titulada «Respuesta 202 Accepted»{ "id": "01a1d5fc-899b-720e-a6ea-03d37a346f81", "status": "queued", "to": ["cliente@ejemplo.pe"]}Respuestas y errores
Sección titulada «Respuestas y errores»| 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. |