Bank accounts

Create new company bank account.

Endpoint for creating new company bank account. Returns created bank information.

post/bankaccounts

Request

  • Base URL: https://pts-api.procountor.com/api
  • URL: https://pts-api.procountor.com/api/bankaccounts
  • Auth: HTTP bearer

Request body

idinteger

Unique identifier of the bank account.

accountNumberstring

Unique bank account number in BBAN format. Generated from IBAN.

ibanstring required

IBAN number for the bank account. Cannot be changed once created.

bicstring

BIC code for the bank account. Not mandatory while creation, can be generated from IBAN.

bankNamestring

The name of the bank.

currency'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'ATS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BEF' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BOV' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CHW' | 'CLF' | 'CLP' | 'CNH' | 'CNT' | 'CNY' | 'COP' | 'COU' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CYP' | 'CZK' | 'DEM' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EEK' | 'EGP' | 'ERN' | 'ESP' | 'ETB' | 'EUR' | 'FIM' | 'FJD' | 'FKP' | 'FRF' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GRD' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'IEP' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'ITL' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KID' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LTL' | 'LUF' | 'LVL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRO' | 'MTL' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NIS' | 'NLG' | 'NOK' | 'NPR' | 'NTD' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PRB' | 'PTE' | 'PYG' | 'QAR' | 'RMB' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SIT' | 'SKK' | 'SLL' | 'SLS' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TVD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'USN' | 'UYI' | 'UYU' | 'UYW' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAG' | 'XAU' | 'XBA' | 'XBB' | 'XBC' | 'XBD' | 'XCD' | 'XDR' | 'XOF' | 'XPD' | 'XPF' | 'XPT' | 'XSU' | 'XTS' | 'XUA' | 'XXX' | 'YER' | 'ZAR' | 'ZMW' | 'ZWB' | 'ZWL' required

The currency of the bank account. Cannot be changed once created.

defaultForInvoiceboolean required

Information if the bank account is used as default bank account for invoice in the given environment.

defaultForPaymentboolean required

Information if the bank account is used as default bank account for payment in the given environment.

status'ACTIVE' | 'INACTIVE' required

Information if the bank account is active or not. If set to INACTIVE then all properties will be set to false

orderNointeger

Order number. Can be used for display ordering instead of ID.

versionstring date-time

Company bank account version timestamp. Automatically generated by Procountor and updated every time the partner is modified. When using PUT /bankaccounts, it is required to include the latest version timestamp of the partner to the request. This prevents conflicts if the partner is being modified from several sources.

bankAddressstring

The address of the bank.

ledgerAccountstring required

The ledger account number.

bankingCodestring

Banking code. In Sweden - Organisation number. Required if payments allowed.

serviceNumbersstring[]

Generated automatically according to the BIC but it can be also found from the contract made with the bank.

showAccountOnInvoiceboolean required

Information if the bank account is used as template on invoice.

allowPaymentsboolean required

Information if account have contract on bank transfers.

allowForeignPaymentsboolean required

Information if account have contract on foreign payments.

allowSalaryPaymentsboolean

Information if account have contract on salary payments. Not supported in the Norwegian environment.

allowExpressPaymentsboolean

Information if account have contract on express payments. Not supported in the Norwegian and Danish environment.

withholdingTaxboolean

Information if withholding tax allowed. This property is used only in Norwegian environment.

createdstring date-time

Date of creation.

Example request

{
  "currency": "EUR",
  "ledgerAccount": "1910"
}

Response

The bank account was successfully created.

idinteger

Unique identifier of the bank account.

accountNumberstring

Unique bank account number in BBAN format. Generated from IBAN.

ibanstring required

IBAN number for the bank account. Cannot be changed once created.

bicstring

BIC code for the bank account. Not mandatory while creation, can be generated from IBAN.

bankNamestring

The name of the bank.

currency'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'ATS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BEF' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BOV' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CHW' | 'CLF' | 'CLP' | 'CNH' | 'CNT' | 'CNY' | 'COP' | 'COU' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CYP' | 'CZK' | 'DEM' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EEK' | 'EGP' | 'ERN' | 'ESP' | 'ETB' | 'EUR' | 'FIM' | 'FJD' | 'FKP' | 'FRF' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GRD' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'IEP' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'ITL' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KID' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LTL' | 'LUF' | 'LVL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRO' | 'MTL' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NIS' | 'NLG' | 'NOK' | 'NPR' | 'NTD' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PRB' | 'PTE' | 'PYG' | 'QAR' | 'RMB' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SIT' | 'SKK' | 'SLL' | 'SLS' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TVD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'USN' | 'UYI' | 'UYU' | 'UYW' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAG' | 'XAU' | 'XBA' | 'XBB' | 'XBC' | 'XBD' | 'XCD' | 'XDR' | 'XOF' | 'XPD' | 'XPF' | 'XPT' | 'XSU' | 'XTS' | 'XUA' | 'XXX' | 'YER' | 'ZAR' | 'ZMW' | 'ZWB' | 'ZWL' required

The currency of the bank account. Cannot be changed once created.

defaultForInvoiceboolean required

Information if the bank account is used as default bank account for invoice in the given environment.

defaultForPaymentboolean required

Information if the bank account is used as default bank account for payment in the given environment.

status'ACTIVE' | 'INACTIVE' required

Information if the bank account is active or not. If set to INACTIVE then all properties will be set to false

orderNointeger

Order number. Can be used for display ordering instead of ID.

versionstring date-time

Company bank account version timestamp. Automatically generated by Procountor and updated every time the partner is modified. When using PUT /bankaccounts, it is required to include the latest version timestamp of the partner to the request. This prevents conflicts if the partner is being modified from several sources.

bankAddressstring

The address of the bank.

ledgerAccountstring required

The ledger account number.

bankingCodestring

Banking code. In Sweden - Organisation number. Required if payments allowed.

serviceNumbersstring[]

Generated automatically according to the BIC but it can be also found from the contract made with the bank.

showAccountOnInvoiceboolean required

Information if the bank account is used as template on invoice.

allowPaymentsboolean required

Information if account have contract on bank transfers.

allowForeignPaymentsboolean required

Information if account have contract on foreign payments.

allowSalaryPaymentsboolean

Information if account have contract on salary payments. Not supported in the Norwegian environment.

allowExpressPaymentsboolean

Information if account have contract on express payments. Not supported in the Norwegian and Danish environment.

withholdingTaxboolean

Information if withholding tax allowed. This property is used only in Norwegian environment.

createdstring date-time

Date of creation.

Example response

{
  "currency": "EUR",
  "ledgerAccount": "1910"
}

Changes

No recorded changes to this operation across all 1 revision of this API.