No todos los sistemas pueden entregar documentos a través de una conexión API. Con un mailfrom hook haces posible enviar documentos como adjuntos de correo electrónico al PSB. El PSB genera una dirección de correo electrónico única con un token (por ejemplo, [email protected]). Cualquier documento enviado como adjunto a esta dirección se procesa automáticamente como factura, orden u otro tipo de documento.

Cuando creas un mailfrom hook, el PSB genera una dirección con token única. Configuras mediante un publishTopic qué debe suceder con los documentos entrantes, por ejemplo, enviar vía Peppol (SendInvoice) o procesar como documento recibido (ReceiveInvoice).

El flujo es el siguiente:

1. Registras un mailfrom hook con un publishTopic
2. El PSB genera una dirección de correo electrónico única con un token
3. Un usuario o sistema envía un correo electrónico con adjunto(s) de documento a esta dirección
4. El PSB procesa los adjuntos como documentos y los publica en el topic especificado
5. Las acciones de seguimiento (envío, transformación) se ejecutan automáticamente

Registra un hook a través de la API con una acción mailfrom://. Usa $token$ como marcador de posición; el PSB lo reemplaza con el token generado en la respuesta.

{
  "id": "1",
  "name": "mail from trigger",
  "action": "mailfrom://*&[email protected]",
  "publishTopics": [
    "SendInvoice"
  ],
  "isActive": true
}

Después del registro, la respuesta contiene la dirección real con el token:

mailfrom://*&[email protected]

Desde ese momento, todos los adjuntos enviados a [email protected] se procesan como facturas y se publican en el topic SendInvoice.

La acción se compone de una parte from y una parte to:

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

La dirección con token puede colocarse en la parte from o en la parte to. Al menos una de las dos debe contener el token, para que el PSB pueda vincular el correo electrónico al hook correcto.

El comodín * en la parte from significa que se aceptan correos electrónicos de cualquier dirección de remitente. Si deseas restringir qué remitentes pueden enviar documentos, introduce una dirección de correo electrónico específica.

Nota: utiliza siempre el dominio correcto por entorno. Los correos enviados al dominio de producción se procesan como documentos reales y no se pueden deshacer.

Opcionalmente puedes especificar un sourceDocumentTypeId y un targetDocumentTypeId como parámetros de consulta. El PSB entonces transforma automáticamente el adjunto al formato de destino especificado, siempre que exista una transformación adecuada. Los caracteres especiales en el documentTypeId deben estar URL-encoded.

{
  "id": "1",
  "name": "mail from met transformatie",
  "action": "mailfrom://*&[email protected]?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 admite exactamente un publishTopic. Este topic determina cómo el PSB procesa los documentos entrantes.

Consejo: al usar RecognizeSalesInvoice como publish topic, puedes enviar facturas PDF por correo electrónico y que sean reconocidas automáticamente por el IDR. Esto combina mailfrom con reconocimiento inteligente de documentos.

Por defecto, el PSB utiliza el dominio econnect.email (o accp.econnect.email para aceptación). También es posible utilizar un dominio personalizado, para que la dirección de correo electrónico coincida con tu propia organización. Contacta con eConnect para configurar esto.

• Los mailfrom hooks solo procesan adjuntos. El texto del cuerpo del correo electrónico no se procesa como documento.
• Cada hook admite un máximo de un publishTopic. Para diferentes tipos de procesamiento (envío, recepción, reconocimiento) crea hooks separados.
• Asegúrate de que los adjuntos estén en un formato compatible (XML, PDF). Otros tipos de archivo no se procesan.

Consulta la especificación completa de la API en psb.econnect.eu para todas las opciones de configuración y ejemplos.