E-Banking API
| BankStatementImport | Import bank statement file. |
BankStatementImport
Import bank statement file.
Parameters
| IBAN | Bank account number (used when importing bank statements of type "CbaXml", "AboGpc", "SwiftMulticashSta", "eurofakturaSpreadsheet"). It can contain IBAN or CZ national bankAccount number format (XXXXXXXXX/YYYY). |
| payPalAccount | PayPal email (used when importing bank statements of type "PayPalCsv") |
| type | Type of bank statement ("CbaXml", "PayPalCsv" , "AboGpc" , "SwiftMulticashSta" , "eurofakturaSpreadsheet") |
| dateFormat | This parameter is mandatory in case of using type "eurofakturaSpreadsheet", to select right date format used in imported file ("DD.MM.YYYY", "DD.MM.YYYY.", "DD/MM/YYYY", "MM/DD/YYYY", "YYYY-MM-DD", "YYYY.MM.DD", "YYYY.MM.DD.") |
| statementData | Bank statement coded with base64 coder |
| pdfStatementData | Bank statement pdf coded with base64 coder (optional) |
| pdfStatementFileName | File name of bank statement pdf (optional) |
Example request and response
POST /WebServicesCZ/API HTTP/1.1
Host: eurofaktura.cz
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="petr" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="BankStatementImport">
<parameter name="IBAN" value="CZ8306000000000222793165" />
<parameter name="type" value="eurofakturaSpreadsheet" />
<parameter name="dateFormat" value="DD.MM.YYYY" />
<parameter name="statementData" value="D94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyIgPz4NCjxEb2N1bWV..."/>
<parameter name="pdfStatementData" value="JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+Cn..."/>
<parameter name="pdfStatementFileName" value="test.pdf"/>
</method>
</request>
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="petr" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="BankStatementImport">
<parameter name="payPalAccount" value="payPalAccount@payPal.com" />
<parameter name="type" value="PayPalCsv" />
<parametername="statementData" value="D94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyIgPz4NCjxEb2N1bWV..."/>
<parameter name="pdfStatementData" value="JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+Cn..."/>
<parameter name="pdfStatementFileName" value="test.pdf"/>
</method>
</request>
HTTP/1.1 200 OK
Server: e-racuni.com web server
Date: Tue, 1 March 2010 11:00:05 GMT
Content-Type: text/xml
Content-Length: 328
Bank statement with attachement.
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
<statementNumber>Bank statement number 31 was imported</statementNumber>
<pdfStatementFileName>PDF attachment added</pdfStatementFileName>
</response>
Bank statement without attachement.
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
<statementNumber>Bank statement number 31 was imported</statementNumber>
<pdfStatementFileName>No PDF attachment added</pdfStatementFileName>
</response>
Response on error if one of required parameters is missing
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description="Parameter named <IBAN> is required."><error/>
</response>
Response on error if iban is not one of your
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description="Parameter named <IBAN> is not one of your bank accounts"><error/>
</response>
Response on error if xml data is missing or it is not correct
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description="Error importing data!"><error/>
</response>
Response on error if pdf attachement file is corrupted.
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description="PDF file is corrupted!"><error/>
</response>
