Skip to main content

Nuances of RecieveEInvoiceService API

  • December 20, 2023
  • 4 replies
  • 216 views
A
Do Gooder (Customer)
Forum|alt.badge.img

I’m in the process of integrating an OCR/IDP tool and IFS Clouds. At the moment, Supplier invoices are the document the tool will be used with.

I’m excited that IFS cloud is going to take a modern, API first, approach. I’ve been exploring the ReceiveEinvoiceService API. However, the documentation (at least the docs linked in the API explorer) leaves something to be desired. It’s got some broken English and isn’t particularly clear. I was a bit surprised by this. It seems like an incredibly useful API, so I would have expected some better docs.

Here is part of the documentation describing how to use it:

Projection Documentation
Service to receive an E-Invoice (Supplier Invoice) in the system.
The structure ReceiveEinvoiceStructure describes the message different parts that can be used when creating the E-Invoice.
If Invoice Image/Attachments are added (which is optional) to the message, ReceiveEinvoiceStructure, then the message needs to be
processed in several steps in the follwing way:
1. Call the Action ReceiveEinvoice with a parameter [I believe they mean body?] of type ReceiveEinvoiceStructure. A response is returned with an Identifier of
the message (MessageId) and URLs (placeholders) to be able to upload Invoice Image and Invoice Attachments.
2. Upload (stream) the Invoice Image and other Attachments using the URLs returned by the respons from Action ReceiveEinvoice in step 1.
3. Call the Action ProcessEinvoice to process the Message, once upload of Invoice Image and Attachments are completed.

 

Based on this post, it looks like there is potentially a fourth step that isn’t mentioned in the documentation regarding getting an etag.

I’m going to use this thread to share what I learn as I explore using the API, and would appreciate insights from anyone else as well.
 

    4 replies

    NABALIN
    Do Gooder (Customer)
    Forum|alt.badge.img+1
    • NABALIN
    • Do Gooder (Customer)
    • November 22, 2024

    What was your conclusion?
    We are looking into using this API and have an issue. Creating an external invoice works fine but when adding the attachment the API response is ok with a URL for uploading the doc. In the later case no lines show up in External invoices. Shouldn’t the line be seen before the actual attachment is uploaded? Will it show up once the document is uploaded?

      J
      Sidekick (Customer)
      Forum|alt.badge.img+5
      • jiri.svoboda
      • Sidekick (Customer)
      • February 26, 2026

      What was your conclusion?
      We are looking into using this API and have an issue. Creating an external invoice works fine but when adding the attachment the API response is ok with a URL for uploading the doc. In the later case no lines show up in External invoices. Shouldn’t the line be seen before the actual attachment is uploaded? Will it show up once the document is uploaded?

      Hi Nabalin, any findings for your issue with missing attachement in External Supplier Invoice record? I am facing the same issue. Thank you.

      NABALIN
      Do Gooder (Customer)
      Forum|alt.badge.img+1
      • NABALIN
      • Do Gooder (Customer)
      • March 5, 2026

       

      What was your conclusion?
      We are looking into using this API and have an issue. Creating an external invoice works fine but when adding the attachment the API response is ok with a URL for uploading the doc. In the later case no lines show up in External invoices. Shouldn’t the line be seen before the actual attachment is uploaded? Will it show up once the document is uploaded?

      Hi Nabalin, any findings for your issue with missing attachement in External Supplier Invoice record? I am facing the same issue. Thank you.

      You need to execute step three before it’s visible.
      3. Call the Action ProcessEinvoice to process the Message, once upload of Invoice Image and Attachments are completed.

      J
      Sidekick (Customer)
      Forum|alt.badge.img+5
      • jiri.svoboda
      • Sidekick (Customer)
      • March 5, 2026

       

      What was your conclusion?
      We are looking into using this API and have an issue. Creating an external invoice works fine but when adding the attachment the API response is ok with a URL for uploading the doc. In the later case no lines show up in External invoices. Shouldn’t the line be seen before the actual attachment is uploaded? Will it show up once the document is uploaded?

      Hi Nabalin, any findings for your issue with missing attachement in External Supplier Invoice record? I am facing the same issue. Thank you.

      You need to execute step three before it’s visible.
      3. Call the Action ProcessEinvoice to process the Message, once upload of Invoice Image and Attachments are completed.

      Thank you Nabalin for your response. I was processing all 4 steps - Invoice createtion, Getting Etag, Sending attachemnt, Processing Invoice. The result is that the attachamnet is visible under button Attachments in External Supplier Invoices page, but not in the attachments/Documents for entire record. The files from the Attachemnts under the button Attachemnts are moved to Document (and in the fact to the DocMan) once the Invoice is created via button Create Invoice. That’s it.

      Terms & ConditionsCookie settingsAccessibility statement