I am trying to use the ReceiveEinvoiceService rest endpoint to pull in supplier invoices. I have 2 attachments that I would like to associate with the invoice. One attachment is a pdf of the original invoice that we received from the supplier. The other attachment is a csv file for the data we were able to OCR from the pdf.
My end goal is to have IFS receive the invoice details and for it to show up in the External Supplier Invoices section so that an end user can match the invoices to purchase orders and receivers.
On my end, I know the unique identifiers from the Oracle Tables -> Supplier (the Supplier_Id column inside of the Supplier_Info_Tab table) and the Company (the Company column inside of the Company_Tab table).
Based on the documentation, I can use the SupplierIdentity to specify the Supplier and the CustomerIdentity to specify the Company on the request.
For my test scenario, the supplier is associated to multiple companies in IFS, but the invoice itself is only for one of the companies.
I am able to successfully get the Invoice into IFS, but there are a few things that are not as expected.
- The response has InvoiceImageUrl pointing to my csv file and not the pdf file. It looks like the url for my pdf file is in the AttachmentUrls and the InvoiceImageUrl is for the csv file. In my request, I am specifying the attachment for the pdf as FileType=ATS and csv as FileType=ACD as the documentation describes. This seems more like a bug with what IFS is returning, but I am able to overcome this on my side at the moment.
- The invoice does not go into the External Supplier Invoices section even though I specify only one Company. The invoices ends up in Multi-Company External Supplier Invoices instead. I am not sure why. The documentation mentions that I could use the CompanyAssociationNumber, BuyerOrganisationUnitNumber, or CompanyTaxIdentityNumber properties on the request as alternatives. I am capable and have access to the Oracle Database itself to lookup these, but they are null / not set in the database and therefore I am relying on using the CustomerIdentity.
- When I try to view the attachments for the invoice inside of Multi-Company External Supplier Invoices, I see my csv file correctly listed. But, when I click to view it, the ui tries to display it as an image. I specified the mimetype for the file sending my invoice data, so I am not sure why this happens. This is inconvenient since I do not see a button in the ui to alternatively download it. Seems like another bug in IFS.
- The invoice details itself looks correct inside of Multi-Company External Supplier Invoices. So, I wanted to seem what happens if I tried to the ‘Create Invoices’ option. But, an error occurs that states ‘There is no file type defined for the file extension application/pdf’. The ‘View Local File’ option in the ui works and lets me download the pdf file correctly. So I am not sure what needs configured at this point to go further.
Original Request Json:
{"ReceiveEinvoice":{"MessageId":1,"ReceivedTime":"2025-08-07T19:17:47.91Z","TransferredTime":"2025-09-15T13:19:30.628582Z","InvoiceTypeCode":"INV01","InvoiceIdentity":"TEST-48036059-1","InvoiceDate":"2025-06-30T04:00:00Z","PurchaseOrderNumber":"C1116","TotalNetAmount":347.34,"InvoiceTotalTaxAmount":0,"InvoiceGrossAmount":347.34,"InvoiceCurrencyCode":"USD","BankAccountNumber":"3382512","CustomerIdentity":"CRE","SupplierIdentity":"706340","PaymentTermsFreeText":"2P10N30","InvoiceRows":"{"MessageId":1,"MessageLine":1,"InvoiceIdentity":"TEST-48036059-1","RowSubIdentifier":"95fc4e2e-83ae-484f-870e-b1a40e0f0171","SupplierPartNumber":"5415K33","SupplierPartDescription":"HOSE CLAMP WORM DRIVE 1-1/16IN - 1-1/4IN 1/2IN BAND WIDTH STAINLESS STEEL","PurchasePartNumber":"MYCH-12SS","InvoicedQuantity":260.0,"SupplierSalesUnitMeasures":"EA","SupplierSalesUnitPrice":1.18,"PurchaseOrderNumber":"C1116","LineNetAmount":306.8,"GrossCurrencyAmount":306.8},{"MessageId":1,"MessageLine":2,"InvoiceIdentity":"TEST-48036059-1","RowSubIdentifier":"bce1b0bf-93d9-46e6-a455-a2164e8ba71c","SupplierPartNumber":"9588K83","SupplierPartDescription":"COMPRESSION SPRING, 3IN LENGTH, 1-1/2IN OD, .337IN WIRE DIAM, CHROME SILICON STEEL","PurchasePartNumber":"C060-00566","InvoicedQuantity":2.0,"SupplierSalesUnitMeasures":"EA","SupplierSalesUnitPrice":20.27,"PurchaseOrderNumber":"C1116","LineNetAmount":40.54,"GrossCurrencyAmount":40.54}],"Installments":u],"Taxes":"],"Prepays":y],"Attachments":"{"AttachmentId":1,"FileType":"ATS","FileName":"TEST-48036059-1.pdf","Description":"Original PDF Invoice","MimeType":"application/pdf"},{"AttachmentId":2,"FileType":"ACD","FileName":"T1-1232968.csv","Description":"Original CSV Export","MimeType":"text/csv"}]}}