Correos

Listar los correos de un comprobante, del más nuevo al más antiguo

GET/v1/documents/{id}/emails

Parámetros de la ruta

• idtextoobligatorio

Parámetros de consulta

• limitenteroopcional

  Elementos por página: de 1 a 100; 25 si se omite.

  de 1 a 100 · por defecto 25

• cursortextoopcional

  El next_cursor de la página anterior: el id del último elemento visto.

Respuestas

• 200Una página de correos — objeto
• 401Falta la llave de API o no es válida — Problem
• 403Quien llama no tiene permiso para hacer esto — Problem
• 404No existe el recurso — Problem
• 409La petición choca con el estado actual del recurso — Problem
• 422La petición no es válida — Problem
• 429Demasiadas peticiones — Problem

Enviar un comprobante por correo

POST/v1/documents/{id}/emails

Encola un correo con el PDF, el XML firmado y el CDR de SUNAT adjuntos. Sin to va al correo del cliente guardado con el comprobante. La respuesta es el correo en queued; si se envió llega después como email.sent o email.failed. Solo se envía un comprobante que SUNAT aceptó: cualquier otro responde 409.

Parámetros de la ruta

• idtextoobligatorio

Cabeceras

• idempotency-keytextoopcional

  Repetir una petición con la misma llave devuelve el recurso original. Usa una llave por recurso: la misma llave en una petición de otro tipo de comprobante responde 409.

  de 1 a 255 caracteres

Cuerpo application/json

• tolista de textosopcional

  De una a diez direcciones. Omítelo para enviar al correo del cliente guardado con el comprobante.

  de 1 a 10 elementos

• cclista de textosopcional

  Hasta diez direcciones que reciben copia.

  hasta 10 elementos · por defecto []

• subjecttextoopcional

  Omítelo para usar el asunto y el mensaje de la empresa, o los de Emitay. Ambos pueden nombrar valores del comprobante entre llaves dobles: {{tipo}}, {{numero}}, {{empresa}}, {{ruc}}, {{cliente}}, {{fecha}}, {{total}}.

  de 1 a 200 caracteres

• messagetextoopcional

  Texto plano; los saltos de línea se conservan.

  de 1 a 5000 caracteres

Respuestas

• 200El correo que encoló una petición anterior con esta llave, como está ahora — Email
• 201El correo, en cola — Email
• 401Falta la llave de API o no es válida — Problem
• 403Quien llama no tiene permiso para hacer esto — Problem
• 404No existe el recurso — Problem
• 409La petición choca con el estado actual del recurso — Problem
• 422La petición no es válida — Problem
• 429Demasiadas peticiones — Problem