A customer wants to get reference payments to his/hers own ERP System and target them at sales invoices in ERP System. Reference payments are available via Procuntor API as JSON format only. Standard reference payment formats (KTL, XML) are unavailable.
GET / referencepayments endpoint fetches reference payments of a selected bank account. The bank account number is needed. The bank accounts of Procountor environment can be fetched via GET /bankaccounts endpoint.
Targeting can be done by using bankReference information. Allocation in Procountor can be viewed if the value of field ‘Allocated’ is ‘true’. The targeted invoice is stated as invoiceId. The mapping of invoice Id to Invoice number can be done via GET /invoice(id) endpoint. Invoice number and originalInvoiceNumber are also available for mapping. Original invoice number is the number given by other system. It is not mandatory.
Reference payments can be filtered by value dates.
User rights should be sufficient to get reference payments. A testing of payment related endpoints is not possible in the API testing server. Payments without the reference number can be fetched via GET /bankstatements endpoint.