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:
| Level | Applies to | Example |
|---|---|---|
| Manager (administrator account) | all the companies of the manager | the address of a software publisher, for its whole portfolio |
| Company | one company | the 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 ofcompanyId); - 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.
| Type | Name | Value |
|---|---|---|
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.
| Type | Name | Value |
|---|---|---|
MX | mail.your-company.de | 10 feedback-smtp.eu-west-1.amazonses.com |
TXT | mail.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:
| Type | Name | Value |
|---|---|---|
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.