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 "IsoSepaXml", "ZbsXml") |
| payPalAccount | PayPal account name (used when importing bank statements of type "PayPalCsv") |
| importTransactionFeeAsOutflow | Can be used only with type "PayPalCsv". This parameter is optional, default this parameter is true. |
| stripeAccount | Stripe account name (used when importing bank statements of type "StripeCsv") |
| glsAccount | GLS account name (used when importing bank statements of type "GLSSpreadsheet") |
| statementNumber | Bank statement number (optional, because it can be in the statement) |
| type | Type of bank statement ("IsoSepaXml", "ZbsXml", "PayPalCsv", "StripeCsv", "GLSSpreadsheet", "PostaSlovenijeXml", "eracuniSpreadsheet") |
| account | This parameter is mandatory in case of using type "eracuniSpreadsheet", to select for which account statement is beeing imported. It can contain IBAN or payment account name. |
| statementData | Bank statement coded with base64 coder |
| pdfStatementData | Bank statement pdf coded with base64 coder (optional) |
| pdfStatementFileName | File name of bank statement pdf (optional) |
| dateFormat | Can be used only for types "PayPalCsv" and "eracuniSpreadsheet". This parameter is optional, default format in case of "PayPalCsv" is "MM/DD/YYYY", all possible formats are: "MM/DD/YYYY" and "DD/MM/YYYY". Default format in case of "eracuniSpreadsheet" is "DD.MM.YYYY", all possible formats are: "DD.MM.YYYY", "DD.MM.YYYY.", "DD/MM/YYYY", "MM/DD/YYYY", "YYYY-MM-DD", "YYYY.MM.DD" and "YYYY.MM.DD.". |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="BankStatementImport">
<parameter name="IBAN" value="SI56 0443 0000 0256 970" />
<parameter name="type" value="IsoSepaXml" />
<parametername="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="micka" 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>
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="BankStatementImport">
<parameter name="glsAccount" value="GLS Slovenija" />
<parameter name="type" value="GLSSpreadsheet" />
<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>
