GuíaEjemplosReferencia API
apisunat.netIngresar

Primeros pasos

  • API SUNAT
  • Inicio rápido
  • Integra con IA
  • Autenticación
  • Planes y límites

Configurar el RUC

  • Emisores
  • Establecimientos y series

Emitir

  • Documentos
  • Idempotencia
  • Estados
  • Correos
  • Catálogos

Integración

  • Errores
  • Webhooks
  • Cambios

Correos

Envía el PDF y el XML del comprobante al cliente.

bash
curl https://api.apisunat.net/api/v1/issuer/documents/3f8c1d2e-6b1a-4c55-9d0e-2a7b3c4d5e6f/emails \
  -H "X-API-Key: $APISUNAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "recipient": "[email protected]", "format": "a4" }'

Si el comprobante es de prueba (emitido con asu_test_), el asunto empieza con [PRUEBA] y el correo avisa que no tiene validez tributaria; el PDF también lo indica.

Responde 202 con el envío:

json
{
  "id": "5b0e2c1a-1d2f-4a3b-8c9d-0e1f2a3b4c5d",
  "recipient": "[email protected]",
  "status": "pending",
  "attempts": 0,
  "errorMessage": null,
  "sentAt": null,
  "createdAt": "2026-10-27T15:10:00.000Z"
}
CampoDescripción
recipientOpcional. Si se omite, se usa customer.email del documento.
formatFormato del PDF adjunto: a4 (por defecto), a5, ticket80, ticket58 o ticket50.

El correo adjunta el PDF y el XML firmado y se envía desde una cola con reintentos.

Estados del envío

pending → sending → sent, o failed si no se pudo entregar.

  • GET /documents/{id}/emails lista los envíos del documento.
  • POST /documents/{id}/emails/{deliveryId}/retry reintenta un envío fallido.

Errores

CódigoCuándo
INVALID_EMAILNo hay destinatario o no es un correo válido.
EMAIL_IN_PROGRESSYa hay un envío en curso para ese documento.
FILES_NOT_AVAILABLEEl XML todavía no existe.

Guías

En POST /guides puedes pedir el envío al emitir con actions:

json
"actions": { "sendEmail": true, "recipient": "[email protected]", "pdfFormat": "a4" }
Estados< PreviousCatálogosNext >

Powered by heyo

On this page

Estados del envíoErroresGuías