Nie każdy system jest w stanie dostarczać dokumenty przez połączenie API. Za pomocą mailfrom hook umożliwiasz przesyłanie dokumentów jako załączników e-mailowych do PSB. PSB generuje unikalny adres e-mail z tokenem (na przykład dj8fwhrqxjhw@econnect.email). Każdy dokument wysłany jako załącznik na ten adres jest automatycznie przetwarzany jako faktura, zamówienie lub inny typ dokumentu.

Odbiornik e-mail PSB jest celowo prosty ("głupi"): wszystkie pliki z załącznika e-mail są przetwarzane jako nowy dokument bez dalszej interpretacji. Technicznie PSB wykorzystuje do tego SendGrid Inbound Parse.

Podczas tworzenia mailfrom hook PSB generuje unikalny adres tokenowy. Za pomocą publishTopic konfigurujesz, co powinno się stać z przychodzącymi dokumentami, na przykład wysłanie przez Peppol (SendInvoice) lub przetworzenie jako otrzymany dokument (ReceiveInvoice).

Przebieg jest następujący:

1. Rejestrujesz mailfrom hook z publishTopic
2. PSB generuje unikalny adres e-mail z tokenem
3. Użytkownik lub system wysyła e-mail z załącznikiem dokumentu na ten adres
4. PSB przetwarza załączniki jako dokumenty i publikuje je na określonym temacie
5. Wszelkie dalsze akcje (wysyłanie, transformacja) są wykonywane automatycznie

Zarejestruj hook za pomocą API z akcją mailfrom://. Użyj $token$ jako placeholdera; PSB zamieni go na wygenerowany token w odpowiedzi. Zobacz też dokumentację PSB: Mail from.

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

Po rejestracji odpowiedź zawiera rzeczywisty adres tokenowy:

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

Od tego momentu wszystkie załączniki wysłane na adres dj8fwhrqxjhw@econnect.email są przetwarzane jako faktury i publikowane na temacie SendInvoice.

Akcja składa się z części from i to:

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

Adres tokenowy może być umieszczony zarówno w części from, jak i to. Co najmniej jedna z nich musi zawierać token, aby PSB mógł powiązać e-mail z właściwym hookiem.

Symbol wieloznaczny * w części from oznacza, że akceptowane są e-maile od dowolnego adresu nadawcy. Jeśli chcesz ograniczyć, którzy nadawcy mogą przesyłać dokumenty, wpisz konkretny adres e-mail.

Uwaga: zawsze używaj właściwej domeny dla danego środowiska. E-maile wysłane na domenę produkcyjną są przetwarzane jako prawdziwe dokumenty i nie można tego cofnąć.

Opcjonalnie możesz podać sourceDocumentTypeId i targetDocumentTypeId jako parametry query. PSB automatycznie transformuje załącznik do określonego formatu docelowego, pod warunkiem że dostępna jest odpowiednia transformacja. Znaki specjalne w documentTypeId muszą być zakodowane 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
}

Mailfrom hook obsługuje dokładnie jeden publishTopic. Ten temat określa, jak PSB przetwarza przychodzące dokumenty.

Wskazówka: używając RecognizeSalesInvoice jako publish topic, możesz przesyłać faktury PDF e-mailem i mieć je automatycznie rozpoznawane przez IDR. To łączy mailfrom z inteligentnym rozpoznawaniem dokumentów.

Domyślnie PSB używa domeny econnect.email (lub accp.econnect.email dla środowiska akceptacyjnego). Możliwe jest również użycie własnej domeny, aby adres e-mail odpowiadał Twojej organizacji. Skontaktuj się z eConnect, aby to skonfigurować.

• Mailfrom hooks przetwarzają wyłącznie załączniki. Treść e-maila nie jest przetwarzana jako dokument.
• Każdy hook obsługuje maksymalnie jeden publishTopic. Dla różnych typów przetwarzania (wysyłanie, odbieranie, rozpoznawanie) tworzysz osobne hooki.
• Upewnij się, że załączniki są w obsługiwanym formacie (XML, PDF). Inne typy plików nie są przetwarzane.

Pełna specyfikacja API jest dostępna na psb.econnect.eu ze wszystkimi opcjami konfiguracji i przykładami.