Tous les systèmes ne peuvent pas livrer des documents via une connexion API. Avec un mailfrom hook, vous permettez la soumission de documents en pièces jointes d'e-mail à la PSB. La PSB génère une adresse e-mail unique avec un jeton (par exemple dj8fwhrqxjhw@econnect.email). Tout document envoyé en pièce jointe à cette adresse est automatiquement traité comme une facture, une commande ou un autre type de document.

Le récepteur e-mail de la PSB est délibérément simple (« bête ») : tous les fichiers de la pièce jointe e-mail sont traités comme un nouveau document sans autre interprétation. Techniquement, la PSB utilise SendGrid Inbound Parse pour cela.

Lorsque vous créez un mailfrom hook, la PSB génère une adresse à jeton unique. Vous configurez via un publishTopic ce qui doit se passer avec les documents entrants, par exemple l'envoi via Peppol (SendInvoice) ou le traitement comme document reçu (ReceiveInvoice).

Le flux est le suivant :

1. Vous enregistrez un mailfrom hook avec un publishTopic
2. La PSB génère une adresse e-mail unique avec un jeton
3. Un utilisateur ou système envoie un e-mail avec une ou plusieurs pièces jointes à cette adresse
4. La PSB traite les pièces jointes comme des documents et les publie sur le topic spécifié
5. Les actions de suivi éventuelles (envoi, transformation) sont exécutées automatiquement

Enregistrez un hook via l'API avec une action mailfrom://. Utilisez $token$ comme espace réservé ; la PSB le remplace par le jeton généré dans la réponse. Voir aussi la documentation PSB : Mail from.

{
  "id": "1",
  "name": "mail from trigger",
  "action": "mailfrom://*&to=$token$@econnect.email",
  "publishTopics": [
    "SendInvoice"
  ],
  "isActive": true
}

Après l'enregistrement, la réponse contient l'adresse à jeton réelle :

mailfrom://*&to=dj8fwhrqxjhw@econnect.email

À partir de ce moment, toutes les pièces jointes envoyées à dj8fwhrqxjhw@econnect.email sont traitées comme des factures et publiées sur le topic SendInvoice.

L'action se compose d'une partie from et d'une partie to :

mailfrom://{from}&to={to}

L'adresse à jeton peut être placée dans la partie from ou to. Au moins l'une des deux doit contenir le jeton, afin que la PSB puisse associer l'e-mail au bon hook.

Le joker * dans la partie from signifie que les e-mails de n'importe quelle adresse d'expéditeur sont acceptés. Si vous souhaitez restreindre quels expéditeurs peuvent soumettre des documents, saisissez une adresse e-mail spécifique.

Remarque : utilisez toujours le bon domaine par environnement. Les e-mails envoyés au domaine de production sont traités comme de vrais documents et ne peuvent pas être annulés.

Vous pouvez optionnellement spécifier un sourceDocumentTypeId et un targetDocumentTypeId comme paramètres de requête. La PSB transforme alors automatiquement la pièce jointe au format cible spécifié, à condition qu'une transformation adaptée soit disponible. Les caractères spéciaux dans le documentTypeId doivent être encodés en URL.

{
  "id": "1",
  "name": "mail from met transformatie",
  "action": "mailfrom://*&to=$token$@econnect.email?sourceDocumentTypeId=urn%3Aoasis%3Anames%3Aspecification%3Aubl%3Aschema%3Axsd%3AInvoice-2%3A%3AInvoice%23%23urn%3Acen.eu%3Aen16931%3A2017%23compliant%23urn%3Afdc%3Anen.nl%3Anlcius%3Av1.0%3A%3A2.1&targetDocumentTypeId=urn%3Aoasis%3Anames%3Aspecification%3Aubl%3Aschema%3Axsd%3AInvoice-2%3A%3AInvoice%23%23urn%3Acen.eu%3Aen16931%3A2017%23compliant%23urn%3Afdc%3Anen.nl%3Anlcius%3Av1.0%3A%3A2.1",
  "publishTopics": [
    "SendInvoice"
  ],
  "isActive": true
}

Un mailfrom hook prend en charge exactement un publishTopic. Ce topic détermine comment la PSB traite les documents entrants.

Conseil : en utilisant RecognizeSalesInvoice comme publish topic, vous pouvez soumettre des factures PDF par e-mail et les faire reconnaître automatiquement par l'IDR. Cela combine le mailfrom avec la reconnaissance intelligente de documents.

Par défaut, la PSB utilise le domaine econnect.email (ou accp.econnect.email pour l'acceptation). Il est également possible d'utiliser un domaine personnalisé, afin que l'adresse e-mail corresponde à votre propre organisation. Contactez eConnect pour configurer cela.

• Les mailfrom hooks ne traitent que les pièces jointes. Le corps du texte de l'e-mail n'est pas traité comme un document.
• Chaque hook prend en charge un maximum d'un publishTopic. Pour différents types de traitement (envoi, réception, reconnaissance), créez des hooks séparés.
• Assurez-vous que les pièces jointes sont dans un format pris en charge (XML, PDF). Les autres types de fichiers ne sont pas traités.

Consultez la spécification complète de l'API sur psb.econnect.eu pour toutes les options de configuration et exemples.