Português
English
A resposta curta: os anexos vão no campo attachments do próprio pedido, em base64, cada um com o nome do ficheiro e o conteúdo. O total vai até 5 MB por e-mail e os executáveis são recusados. Para ficheiros grandes, mande uma ligação em vez do anexo.
Como vai um anexo
| Campo de cada anexo | O que leva |
| filename | O nome que o cliente vê, como factura-FT2026-214.pdf |
| content | O conteúdo do ficheiro em base64 |
| content_type | O tipo, como application/pdf |
"attachments": [{"filename": "factura.pdf",
"content": "JVBERi0xLjQK...",
"content_type": "application/pdf"}]
Em PHP, por exemplo, o conteúdo sai de base64_encode(file_get_contents($caminho)). Lembre-se de que o base64 aumenta o tamanho: um PDF pesa mais dentro do pedido do que no disco.
Quando o anexo é recusado
| Motivo | O que quer dizer | O que fazer |
| invalid_attachment | Falta o nome ou o conteúdo não é base64 válido | Confirme o filename e a codificação |
| attachment_blocked | Este tipo de ficheiro não pode ir em anexo (executáveis) | Mande outro formato, como PDF |
| attachments_too_large | Os anexos passam do limite de tamanho | Comprima ou mande uma ligação |
| too_many_attachments | Demasiados anexos num e-mail | Junte-os num só ficheiro ou divida o envio |
Estes motivos vêm em details.reason, numa resposta 422. Os outros estão em erros da API do Email Center.
Anexo ou ligação
| Use anexo | Use ligação |
| Uma factura, um recibo ou um bilhete em PDF, leves | Catálogos, vídeos, pastas de documentos |
| Um documento que o cliente tem de guardar | Algo que muda depois de enviado |
| Quando o cliente pode não ter acesso à sua área de cliente | Ficheiros perto do limite, ou para muitos destinatários |
| Cada destinatário recebe o anexo inteiro. Um anexo pesado para 50 destinatários é muito correio. E alguns servidores recusam mensagens grandes: veja anexo demasiado grande. |
| Diga no texto o que vai em anexo, com o nome e o valor: «Em anexo, a factura FT 2026/214, de 1.250,00». Um anexo sem explicação parece-se com os e-mails de phishing. |
|
Quer enviar as suas facturas em PDF pela API? Veja a página da API. Ver a página da API |
