Non tutti i sistemi possono consegnare documenti tramite una connessione API. Con un mailfrom hook rendi possibile l'invio di documenti come allegati e-mail al PSB. Il PSB genera un indirizzo e-mail univoco con un token (ad esempio dj8fwhrqxjhw@econnect.email). Qualsiasi documento inviato come allegato a questo indirizzo viene elaborato automaticamente come fattura, ordine o altro tipo di documento.

Il ricevitore e-mail della PSB è deliberatamente semplice ("muto"): tutti i file dall'allegato e-mail vengono elaborati come nuovo documento senza ulteriore interpretazione. Tecnicamente, la PSB utilizza SendGrid Inbound Parse per questo.

Quando crei un mailfrom hook, il PSB genera un indirizzo con token univoco. Configuri tramite un publishTopic cosa deve succedere con i documenti in arrivo, ad esempio l'invio via Peppol (SendInvoice) o l'elaborazione come documento ricevuto (ReceiveInvoice).

Il flusso è il seguente:

1. Registri un mailfrom hook con un publishTopic
2. Il PSB genera un indirizzo e-mail univoco con un token
3. Un utente o sistema invia un'e-mail con allegato/i documento a questo indirizzo
4. Il PSB elabora gli allegati come documenti e li pubblica sul topic specificato
5. Le azioni successive (invio, trasformazione) vengono eseguite automaticamente

Registra un hook tramite l'API con un'azione mailfrom://. Usa $token$ come segnaposto; il PSB lo sostituisce con il token generato nella risposta. Vedi anche la documentazione PSB: Mail from.

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

Dopo la registrazione, la risposta contiene l'indirizzo reale con il token:

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

Da quel momento, tutti gli allegati inviati a dj8fwhrqxjhw@econnect.email vengono elaborati come fatture e pubblicati sul topic SendInvoice.

L'azione è composta da una parte from e una parte to:

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

L'indirizzo con token può essere inserito nella parte from o nella parte to. Almeno una delle due deve contenere il token, affinché il PSB possa collegare l'e-mail all'hook corretto.

Il carattere jolly * nella parte from significa che vengono accettate e-mail da qualsiasi indirizzo mittente. Se desideri limitare quali mittenti possono inviare documenti, inserisci un indirizzo e-mail specifico.

Nota: utilizza sempre il dominio corretto per ogni ambiente. Le e-mail inviate al dominio di produzione vengono elaborate come documenti reali e non possono essere annullate.

Opzionalmente puoi specificare un sourceDocumentTypeId e un targetDocumentTypeId come parametri di query. Il PSB trasforma quindi automaticamente l'allegato nel formato di destinazione specificato, a condizione che sia disponibile una trasformazione adeguata. I caratteri speciali nel documentTypeId devono essere URL-encoded.

{
  "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 supporta esattamente un publishTopic. Questo topic determina come il PSB elabora i documenti in arrivo.

Suggerimento: utilizzando RecognizeSalesInvoice come publish topic, puoi inviare fatture PDF via e-mail e farle riconoscere automaticamente dall'IDR. Questo combina mailfrom con il riconoscimento intelligente dei documenti.

Per impostazione predefinita, il PSB utilizza il dominio econnect.email (o accp.econnect.email per l'accettazione). È anche possibile utilizzare un dominio personalizzato, in modo che l'indirizzo e-mail corrisponda alla tua organizzazione. Contatta eConnect per configurarlo.

• I mailfrom hook elaborano solo gli allegati. Il testo del corpo dell'e-mail non viene elaborato come documento.
• Ogni hook supporta un massimo di un publishTopic. Per diversi tipi di elaborazione (invio, ricezione, riconoscimento) crea hook separati.
• Assicurati che gli allegati siano in un formato supportato (XML, PDF). Altri tipi di file non vengono elaborati.

Consulta la specifica completa dell'API su psb.econnect.eu per tutte le opzioni di configurazione ed esempi.