Custom sender address

Invoices sent by e-mail (POST /document/send/mail) are sent by default from the BIAC Log generic address noreply@biaclog-peppol.eu. In this case the message states that it is sent on behalf of the issuing company.

You can have them sent from an address of your own domain instead, e.g. rechnung@your-company.de. The issuing company then appears as the real sender: the "sent on behalf of" mention is removed and the receiver's mail server authenticates the message with your domain.

Whichever sender address is used, the Reply-To of the message stays the seller contact e-mail of the invoice (cac:AccountingSupplierParty/cac:Party/cac:Contact/cbc:ElectronicMail).

Levels

The sender address can be defined at two levels:

LevelApplies toExample
Manager (administrator account)all the companies of the managerthe address of a software publisher, for its whole portfolio
Companyone companythe address of the issuing company itself

The company address prevails over the manager address. Without either, the generic address is used.

The sender address is set by BIAC Log support only, once the domain has been verified (see below). It is returned as invoiceFromAddress by the company endpoints. If you send it in a create or update request, it is ignored.

What you have to do

1. Request

Send a request to support@biaclog-peppol.eu with:

  • the sender address, e.g. rechnung@your-company.de;
  • the level: manager (your administrator username) or company (the companyId, or the list of companyId);
  • a technical contact who can publish DNS records on the domain.

2. Publish the DNS records

Support sends you the records to publish in the DNS zone of your domain. They are generated for your domain: the values below only show their shape.

Domain verification and DKIM signature (mandatory): three CNAME records.

TypeNameValue
CNAME<token1>._domainkey.your-company.de<token1>.dkim.amazonses.com
CNAME<token2>._domainkey.your-company.de<token2>.dkim.amazonses.com
CNAME<token3>._domainkey.your-company.de<token3>.dkim.amazonses.com

SPF authorization (recommended): a dedicated sub-domain (MAIL FROM domain), used as envelope sender. The usual name is mail.your-company.de.

TypeNameValue
MXmail.your-company.de10 feedback-smtp.eu-west-1.amazonses.com
TXTmail.your-company.de"v=spf1 include:amazonses.com ~all"

Your existing SPF record on your-company.de does not change: the SPF check applies to the sub-domain above.

DMARC alignment: if your domain already publishes a DMARC record (_dmarc.your-company.de), you don't need to change anything. The DKIM signature above is aligned with your domain, so the messages pass DMARC, even with a quarantine or reject policy. If your domain has no DMARC record yet, we recommend publishing one, at least in monitoring mode:

TypeNameValue
TXT_dmarc.your-company.de"v=DMARC1; p=none; rua=mailto:dmarc@your-company.de"

WARNING

Do not remove these records once the address is in use: the domain verification is checked continuously, and the sending fails if the records disappear.

3. Validation

Once the records are published, tell support. DNS propagation usually takes a few minutes, and up to 72 hours. Support checks the verification, sends a test message and then sets the sender address on the requested level. You are informed when it is active.

The procedure is done once per domain: any further address of an already verified domain, or any further company using an already validated address, only needs a request to support, without DNS changes.

Behaviour

  • The display name of the sender is the seller name of the invoice, e.g. Lieferant GmbH <rechnung@your-company.de>.
  • If the domain is no longer verified (records removed), the sending fails with SEND_FAILED. Nothing is sent from the generic address instead.
  • Removing the sender address (request to support) switches back to the manager address if any, else to the generic address.

Blind copy

The company mailToRespond address is also used for invoices sent by e-mail: it receives a blind copy (Bcc) of every message sent for the company.

This blind copy is added on top of the recipientEmailCc addresses of the request: it does not count in their limit of 5. It is not added when the address is already the recipient or one of the copy recipients. If the mail server refuses it, the invoice is sent anyway.

TIP

mailToRespond is also the address of the status e-mails of the documents sent on the Peppol network, when statusMailIfSuccess or statusMailIfFailed is enabled. With both disabled, it is only used for the blind copy.

Last Updated: