Invoices and attachments – Semine

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.

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, TIF files as invoices.Other file formats can be uploaded as attachments to individual invoices.Supported attachment formats: .png, .bmp, .tif, .jpeg, .jpg, .htm, .tiff, .msg, .doc, .docx, .xls, .xlsx, .xml and .pdf

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 a described above.

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

Other files

If the email contains one or more PDF files, all files of other permitted formats and sizes are considered to be attachments to all PDFs included in the same email and will be available in the attachments list. Deleting one item in the attachments list will only delete the file reference, not the actual file.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}/attachmentsLists 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}/ublWill generate an UBL from the Semine invoice model regardless of source.

GET .../pdf

GET /api/v1.0/organizations/{organizationId}/clients/{clientId}/invoices/{invoiceId}/pdfThis 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