My Products
Help
Florian Haase
PARTNER

BankAccountNumber

by Florian Haase (Updated ‎30-03-2021 10:42 by Yıldırım VISMA )

Hi

 

i'm looking for the possibility to get out the Bankaccount-Number of the Branch (CS101500) - Bank Settings / BBAN since we produce outgoing electroinc invoices by our portal.

 

In the new Peppol-BIS 3.0 description is documentated to use the Payment Methods instead and place the bankaccount there (Screen CA204000) - Field PaymentMethod / BBAN. It seems that autoinvoice is able to read this field in any way, but I can't find it in the API either. 

 

Any ideas here? Or do we have to register this as an idea?

 

Regards,

 

Florian

7 REPLIES 7
Yıldırım
VISMA

by Yıldırım
Accepted solution
Yıldırım
VISMA

by Yıldırım (Updated ‎26-03-2021 16:33 by Yıldırım VISMA )

Hello Florian, 

Improvement has been planned to be implemented in version 8.43.0 (06-04-2021), Release Plan & Date may vary. Please subscribe to the "News" section of the community for the following updates. 

After implementation, 

- PUT Branch / Banksettings  &  GET / PUT Organization Endpoints have been added where you can update Bank information (Branch/Organization > Payment Settings)
Branch_Endpoint_PUT.png

Planned DTO:

 

 

{
  "bankName": {
    "value": "string"
  },
  "bankAddress1": {
    "value": "string"
  },
  "bankAddress2": {
    "value": "string"
  },
  "bankAddress3": {
    "value": "string"
  },
  "bankCountry": {
    "value": "string"
  },
  "iban": {
    "value": "string"
  },
  "bban": {
    "value": "string"
  },
  "bbaN2": {
    "value": "string"
  },
  "bbaN3": {
    "value": "string"
  },
  "bic": {
    "value": "string"
  },
  "creditorId": {
    "value": "string"
  }
}

 

 


Organization Endpoint: (Contain Branches)
Organization_Endpoint_GET.png


-Branch Endpoint has been modified and a boolean parameter "expandBanksettings" implemented, Bank information will be included in the GET Branch response body when "expandBankSettings = true"

GET: ....api/v1/branch?expandBankSettings=true
Branch_Endpoint_GET.png
PUT_Branch_Org.png
Branch_Endpoint_GET_param.png

Florian Haase
PARTNER

by Florian Haase

Great!

Yıldırım
VISMA

by Yıldırım (Updated ‎09-09-2020 11:26 by Yıldırım VISMA )

Hello Florian, 

Currently, Payment Settings tab is  not available in the Branch Endpoint ,therefore, this information can not be fetched via the API at this moment. (Exposing Payment Settings Tab is registered in the backlog)

 

organisations.jpg

 

------------------------

When it comes to "Payment Methods" - ScreenID:CA204000

UI Settings

1)Assuming that Financials ERP configured with the desired payment methods. (Bank Account)
PaymentMethod.png

 

2) Customer/Supplier is configured with the specified Payment Method
Customer-PaymentMethods.png

 
3) Customer > Customer Payment Method ScreenID:AR303010 where you can enter the values based on your payment method settings (IBAN,Bank Account etc)

Customer_paymentmethodedit.png

 

 

 

API

1) This information can be fetched through, first, looking up to the PaymentDto, {GET:CustomerPayment} in order to get relevant Customer reference/s,

 

"customer": {
    "number": "string",
    "name": "string"
  },
to get relevant Payment Method reference,
"paymentMethod": {
    "id": "string",
    "description": "string"
  },


and making another GET request to the 

/controller/api/v1/customerpaymentmethod/{customerNumber}/{customerPaymentMethodId}

(If you already have the Customer and CustomerPaymentMethod references, first calls can be skipped)

In this way, you can get the details of the registered Customer Payment Method based on the references these have been used in the Customer Payment Document.

2020-09-09 11_22_42-Window.png

 


Endpoint documentation: https://integration.visma.net/API-index/

Florian Haase
PARTNER

by Florian Haase

Hi

 

I checked this with our consultant team and we think that this is not a good approach. In this way we have to register our own bank-account-number (that means our company bankaccount which usually is saved on the branch) on each customer in the customer/paymentmethod connection? Or do we misunderstand something here?

 

But I just wondered: The Autoinvoice-Team gets out the right information directly from the Payment-Method (screenshot is from the mapping - documentation of the Peppol-Bis3.0 format)

 
 

paymentMethod.PNG

Do they get the information directly from the database? Don't they use the API?

 

Florian

Yıldırım
VISMA

by Yıldırım

Hello, 

 

as far as i know, 

Auto-Invoice is receiving data from embedded methods working in Visma.Net ERP. The data (XML) is populated by Financials and sent to Auto-Invoice SOAP. Visma.Net Financials Branch / Company is linked to Auto-Invoice via ScreenId=CS10250 (AutoInvoice settings). So it does not read the data via the Visma.Net ERP API but receiving the file what ERP constructs based on peppol bis 3.0


Consequently, to be able to receive IBAN / Bank Account etc from Organization Module via API the following idea should be implemented in Visma.net ERP API Expose Organisations "Payment Settings" Tab via Branch Endpoint

 

Florian Haase
PARTNER

by Florian Haase

OK, thank you!