Invoices and attachments – Semine

Semine – Invoice Sources and Attachments

Semine receive invoices and attachments from 3 sources: EHF, email and upload with a separate, corresponding process for attachments.

Source: EHF/UBL Invoice

Without Attachment

Semine always saves a copy of the incoming XML UBL file as well as a standard PDF rendering of the UBL-file.

Note: Maximum file upload size is 50 mb.

Standard rendering

All text content of EHF XML invoices are displayed through a standard template in the invoice details view.

UBL Embedded Attachment

Semine saves additional attachments in the following formats..png, .bmp, .tif, .jpeg, .jpg, .htm, .tiff, .msg, .doc, .docx, .xls, .xlsx, .xml and .pdf

The attachments are to be found under the "Attachments" tab.

See: cac:EmbeddedDocumentBinaryObject

UBL Linked Attachment

Attachment not embedded in the UBL XML is not supported as of now.

See: cac:ExternalReference

Source: Uploaded invoice

Semine will process PDF files as invoices via invoice upload. Only PDF format is supported for invoice upload.

Source: Emailed invoice and attachments

PDF

Semine considers all PDFs to be invoices. The email must contain at least 1, non-encrypted, readable PDF. Semine will attempt to process any PDF files as individual invoices. If no readable PDFs are found or other criteria are not met, an email stating the current requirements for filetypes, file size etc will be returned to the sender and no further processing will take place.

XML

Semine considers all XMLs to be UBL invoices which are subsequently processed as described above.

Note: The attached XML has to be a valid UBL invoice or it will be rejected.

Other files

How other files are handled depends on the number of PDFs in the email:

Email contains exactly one PDF: All other files of permitted formats and sizes are attached to that invoice and will be available in the attachments list.
Email contains more than one PDF: Other files are not attached to any invoice. Because Semine cannot determine which PDF a given file belongs to, these files are available in Docflow only and will not appear in the invoice attachments list.

Supported attachment formats: .png, .bmp, .tif, .jpeg, .jpg, .htm, .tiff, .msg, .doc, .docx, .xls, .xlsx

API Reference

GET .../attachments

GET /api/v1.0/organizations/{organizationId}/clients/{clientId}/invoices/{invoiceId}/attachments Lists all attachments. In case of UBL source, the attachment list will always include a copy of the UBL xml and rendered UBL pdf.

GET .../attachments/ID

GET /api/v1.0/organizations/{organizationId}/clients/{clientId}/invoices/{invoiceId}/attachments/{attachmentId} Downloads the specified attachment.

GET .../ubl

GET /api/v1.0/organizations/{organizationId}/clients/{clientId}/invoices/{invoiceId}/ubl Will generate an UBL from the Semine invoice model regardless of source.

GET .../pdf

GET /api/v1.0/organizations/{organizationId}/clients/{clientId}/invoices/{invoiceId}/pdf This endpoint will provide a PDF of the invoice depending on the source:

Upload: The original PDF invoice
Email: The original PDF invoice
UBL: Standard PDF rendered from UBL