BankAccountNumber

[Florian Haase]

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

[Yıldırım]

Visma.net Financials API updates for version 8.43.0 (April 2021)

[Yıldırım · Accepted solution]

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)


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)


-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

[Florian Haase]

Great!

[Yıldırım]

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)

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

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

UI Settings

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

2) Customer/Supplier is configured with the specified Payment Method

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

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.

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

[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)

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

Florian

[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]

OK, thank you!