Skip to main content

Email a non-fiscal document to the buyer

POST 
/api/v1/documents/:document_id/email

Send the document to up to five addresses from GoRoute's verified sender, with its PDF attached. The twin of POST /transactions/{id}/email, for documents that have no transaction.

One file is attached, not two. The invoice mail carries the PDF and the XML, "which is the legal electronic invoice"; there is no XML here, because neither a pro forma invoice nor a delivery note is an electronic invoice. The body says so rather than leaving the reader to notice a missing attachment.

A pro forma email states plainly, above the summary, that the document is not a tax invoice and that no VAT is due on it — the same sentence the PDF carries, in the same language.

sender_name is a display name only; reply_to is where answers go. message (plain text, up to 2000 characters) is the seller's own note, shown set apart. The subject is Pro forma invoice <number> from <sender_name or organisation name> (Delivery note … for a delivery note). Each send is recorded on the document under emails.

Errors: 404 when the document is not the caller's; 429 after three sends of the same document in 24 hours; 503 when mail is not enabled on this environment.

Request​

Responses​

Successful Response