04.10.2012 Views

Handbuch ESR

Handbuch ESR

Handbuch ESR

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

3.2.1.2 GetInvoiceByID<br />

This method allows to download a single signed invoice or a PDF billdetail by its TransactionID. It replaces<br />

the omitted method GetInvoces, GetInvoicesArchive, GetPDF and GetPDFArchive. For obtaining the<br />

BilerID and TransactionID, the GetInvoiceListWithID method has to be called first.<br />

DownloadFile GetInvoiceByID( string eBillAccountID, string BillerID, string<br />

TransactionID, string FileType );<br />

The eBillAccountID, BillerID, TransactionID and FileType are expected as parameters to be passed.<br />

The downloaded file is returned in a structure of the type DownloadFile.<br />

public class DownloadFile<br />

{<br />

public byte[] Data;<br />

public String Filename;<br />

}<br />

It contains the Filename and the content in the form of a binary stream (Data). Now you can save it into<br />

a file. Any further processing of the invoice is the responsibility of the payer.<br />

3.2.1.3 The GetOpenList / GetArchiveList methods (omitted)<br />

These methods are omitted. It’s recommended to use the GetInvoiceWithIDs method instead.<br />

Both methods return a list of available downloads with the most important details. The interfaces are as<br />

follows:<br />

Report[] GetOpenList( String eBillAccountID );<br />

Report[] GetArchiveList( String eBillAccountID );<br />

They expect the eBillAccountID parameter (unique identifier of payer) to be passed. The result is returned<br />

in the form of an array of type Report with the following structure.<br />

public class Report<br />

{<br />

public DateTime DeliveryDate;<br />

public String FileType;<br />

public int Count;<br />

}<br />

This type of report entry corresponds to a daily report for each file type. The DeliveryDate is the invoice<br />

date supplied by the biller when uploading it. The FileType may be "PDF", "RGXMLSIG" or "EDIFACT".<br />

Count contains the number of downloadable files with the same DeliveryDate. This information may be<br />

used for the download methods.<br />

9/19

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!