Skip to content

createChartAccount

Request

Bodyapplication/jsonrequired
codestring, [ 0 .. 20 ] charactersrequired

Code of the chart account

Default:""
Example:"4300000001"
descriptionstring, [ 0 .. 100 ] charactersrequired

Description of the chart account

Default:""
Example:"Clientes"
activeboolean

Indicates if the account is active

Default:false
Example:true
colorstring, [ 0 .. 7 ] characters

Color code for visual representation

Default:""
Example:"#FF5733"
groupinteger, (int32)

ID of the parent chart account group

Default:""
observationsstring, [ 0 .. 250 ] characters

Observations about the account

Default:""
bankinteger, (int32)

ID of the associated bank

Default:""
bankAccountstring, [ 0 .. 50 ] characters

Bank account number (IBAN)

Default:""
Example:"ES7501234567890123456789"
bankAccountSwiftstring, [ 0 .. 20 ] characters

Bank SWIFT/BIC code

Default:""
Example:"CAIXESBB"
forecastTypeinteger, (int32)

ID of the associated forecast type

Default:""
installmentNumberinteger, (int32)

Number of installments

Default:""
installmentDaysinteger, (int32)

Days between installments

Default:""
installmentFirstDayinteger, (int32)

First installment day of the month

Default:""
installmentSecondDayinteger, (int32)

Second installment day of the month

Default:""
forecastMandatoryboolean

Indicates if forecast is mandatory

Default:false
forecastWithAccountingDateboolean

Indicates if forecast uses accounting date

Default:false
paymentEmailAddressstring, [ 0 .. 250 ] characters

Email address for payments

Default:""
confirmingEmailAddressboolean

Indicates if confirming email address is enabled

Default:false
cadastralReferencestring, [ 0 .. 50 ] characters

Cadastral reference

Default:""
operationKey340string(ApiOperationKey340Enum)

Operation key 340

Default:""
Enum:"USUAL_OPERATION""A""B""C""D""E""F""G""H""I"
lockDatestring, (date)

Lock date for the account

Default:""
accumulateCashboolean

Indicates if cash should be accumulated

Default:false
reccboolean

Indicates if RECC is applied

Default:false
creditBalanceboolean

Indicates if account has credit balance

Default:false
debitBalanceboolean

Indicates if account has debit balance

Default:false
higherBalanceAlertboolean

Indicates if higher balance alert is enabled

Default:false
higherBalanceAlertValuenumber

Higher balance alert threshold value

Default:""
lowerBalanceAlertboolean

Indicates if lower balance alert is enabled

Default:false
lowerBalanceAlertValuenumber

Lower balance alert threshold value

Default:""
cifstring, [ 0 .. 50 ] characters

Tax identification number (CIF/NIF)

Default:""
Example:"B03186681"
taxIdentificationCodestring(ApiTaxIdentificationCodesEnum)

Tax identification code type

Default:""
Enum:"NIF""NIF_VAT""PASSPORT""OFFICIAL_IDENTIFICATION_NUMBER""RESIDENCE_CERTIFICATE""ANOTHER_EVIDENT_DOCUMENT""NOT_CENSUS"
businessNamestring, [ 0 .. 100 ] characters

Business name

Default:""
Example:"Clave Informática"
address1string, [ 0 .. 100 ] characters

Address line 1

Default:""
address2string, [ 0 .. 100 ] characters

Address line 2

Default:""
postalCodestring, [ 0 .. 10 ] characters

Postal code

Default:""
citystring, [ 0 .. 50 ] characters

City

Default:""
statestring, [ 0 .. 50 ] characters

State or province

Default:""
countryinteger, (int32)

ID of the associated country

Default:""
phone1string, [ 0 .. 20 ] characters

Primary phone number

Default:""
phone2string, [ 0 .. 20 ] characters

Secondary phone number

Default:""
fax1string, [ 0 .. 20 ] characters

Primary fax number

Default:""
fax2string, [ 0 .. 20 ] characters

Secondary fax number

Default:""
postalMailstring, [ 0 .. 50 ] characters

Postal mail address

Default:""
emailstring, [ 0 .. 100 ] characters

Email address

Default:""
webstring, [ 0 .. 250 ] characters

Website URL

Default:""
legalRepresentativeCifstring, [ 0 .. 50 ] characters

Legal representative CIF/NIF

Default:""
legalRepresentativeNamestring, [ 0 .. 100 ] characters

Legal representative name

Default:""
POST
/api/v1/accounting-chart-account
curl -i -X POST \
  https://api.prana.software/api/v1/accounting-chart-account \
  -H 'Content-Type: application/json' \
  -d '{
    "code": "4300000001",
    "description": "Clientes",
    "active": true,
    "color": "#FF5733",
    "group": "",
    "observations": "",
    "bank": "",
    "bankAccount": "ES7501234567890123456789",
    "bankAccountSwift": "CAIXESBB",
    "forecastType": "",
    "installmentNumber": "",
    "installmentDays": "",
    "installmentFirstDay": "",
    "installmentSecondDay": "",
    "forecastMandatory": false,
    "forecastWithAccountingDate": false,
    "paymentEmailAddress": "",
    "confirmingEmailAddress": false,
    "cadastralReference": "",
    "operationKey340": "USUAL_OPERATION",
    "lockDate": "",
    "accumulateCash": false,
    "recc": false,
    "creditBalance": false,
    "debitBalance": false,
    "higherBalanceAlert": false,
    "higherBalanceAlertValue": "",
    "lowerBalanceAlert": false,
    "lowerBalanceAlertValue": "",
    "cif": "B03186681",
    "taxIdentificationCode": "NIF",
    "businessName": "Clave Informática",
    "address1": "",
    "address2": "",
    "postalCode": "",
    "city": "",
    "state": "",
    "country": "",
    "phone1": "",
    "phone2": "",
    "fax1": "",
    "fax2": "",
    "postalMail": "",
    "email": "",
    "web": "",
    "legalRepresentativeCif": "",
    "legalRepresentativeName": ""
  }'

Responses

OK

Bodyapplication/json
idinteger, (int32)required

Unique identifier of the object

Default:""
codestring

Code of the chart account

Default:""
Example:"4300000001"
descriptionstring

Description of the chart account

Default:""
Example:"Clientes"
activeboolean

Indicates if the account is active

Default:false
Example:true
colorstring

Color code for visual representation

Default:""
Example:"#FF5733"
parentobject(ApiChartAccountBasicReadDto)

Parent chart account

Default:""
observationsstring

Observations about the account

Default:""
bankobject(ApiBankListReadDto)

Bank account

Default:""
bankAccountstring

Bank account number (IBAN)

Default:""
Example:"ES7501234567890123456789"
bankAccountSwiftstring

Bank SWIFT/BIC code

Default:""
Example:"CAIXESBB"
forecastTypeobject(ApiForecastTypeListReadDto)

Forecast type

Default:""
installmentNumberinteger, (int32)

Number of installments

Default:""
installmentDaysinteger, (int32)

Days between installments

Default:""
installmentFirstDayinteger, (int32)

First installment day of the month

Default:""
installmentSecondDayinteger, (int32)

Second installment day of the month

Default:""
forecastMandatoryboolean

Indicates if forecast is mandatory

Default:false
forecastWithAccountingDateboolean

Indicates if forecast uses accounting date

Default:false
paymentEmailAddressstring

Email address for payments

Default:""
confirmingEmailAddressboolean

Indicates if confirming email address is enabled

Default:false
cadastralReferencestring

Cadastral reference

Default:""
operationKey340string(ApiOperationKey340Enum)

Operation key 340

Default:""
Enum:"USUAL_OPERATION""A""B""C""D""E""F""G""H""I"
lockDatestring, (date)

Lock date for the account

Default:""
accumulateCashboolean

Indicates if cash should be accumulated

Default:false
reccboolean

Indicates if RECC is applied

Default:false
creditBalanceboolean

Indicates if account has credit balance

Default:false
debitBalanceboolean

Indicates if account has debit balance

Default:false
higherBalanceAlertboolean

Indicates if higher balance alert is enabled

Default:false
higherBalanceAlertValuenumber

Higher balance alert threshold value

Default:""
lowerBalanceAlertboolean

Indicates if lower balance alert is enabled

Default:false
lowerBalanceAlertValuenumber

Lower balance alert threshold value

Default:""
cifstring

Tax identification number (CIF/NIF)

Default:""
Example:"B03186681"
taxIdentificationCodestring(ApiTaxIdentificationCodesEnum)

Tax identification code type

Default:""
Enum:"NIF""NIF_VAT""PASSPORT""OFFICIAL_IDENTIFICATION_NUMBER""RESIDENCE_CERTIFICATE""ANOTHER_EVIDENT_DOCUMENT""NOT_CENSUS"
businessNamestring

Business name

Default:""
Example:"Clave Informática"
address1string

Address line 1

Default:""
address2string

Address line 2

Default:""
postalCodestring

Postal code

Default:""
citystring

City

Default:""
statestring

State or province

Default:""
countryobject(ApiCountryListReadDto)

Country

Default:""
phone1string

Primary phone number

Default:""
phone2string

Secondary phone number

Default:""
fax1string

Primary fax number

Default:""
fax2string

Secondary fax number

Default:""
postalMailstring

Postal mail address

Default:""
emailstring

Email address

Default:""
webstring

Website URL

Default:""
legalRepresentativeCifstring

Legal representative CIF/NIF

Default:""
legalRepresentativeNamestring

Legal representative name

Default:""
classificationstring(ApiAccountClassificationEnum)

Account classification

Default:""
Enum:"ASSET""LIABILITY""INCOME""EXPENSE""EXPENSE_IMPUTED_LIABILITY""INCOME_IMPUTED_LIABILITY"
naturestring(ApiAccountNatureEnum)

Account nature

Default:""
Enum:"CREDITOR""DEBTOR"
signstring(ApiAccountSignEnum)

Account sign

Default:""
Enum:"POSITIVE""NEGATIVE"
statementBalanceColorstring(ApiAccountColorEnum)

Statement balance color

Default:""
Enum:"RED""GREEN"
accountingStatementColorstring(ApiAccountColorEnum)

Accounting statement color

Default:""
Enum:"RED""GREEN"
Response
{
  "id": "",
  "code": "4300000001",
  "description": "Clientes",
  "active": true,
  "color": "#FF5733",
  "parent": {
    "id": "",
    "code": "1000",
    "description": "Cash account"
  },
  "observations": "",
  "bank": null,
  "bankAccount": "ES7501234567890123456789",
  "bankAccountSwift": "CAIXESBB",
  "forecastType": {
    "id": "",
    "code": "string",
    "description": "string",
    "mandatoryBank": true,
    "paymentType": "BANK_ACCOUNT"
  },
  "installmentNumber": "",
  "installmentDays": "",
  "installmentFirstDay": "",
  "installmentSecondDay": "",
  "forecastMandatory": false,
  "forecastWithAccountingDate": false,
  "paymentEmailAddress": "",
  "confirmingEmailAddress": false,
  "cadastralReference": "",
  "operationKey340": "USUAL_OPERATION",
  "lockDate": "",
  "accumulateCash": false,
  "recc": false,
  "creditBalance": false,
  "debitBalance": false,
  "higherBalanceAlert": false,
  "higherBalanceAlertValue": "",
  "lowerBalanceAlert": false,
  "lowerBalanceAlertValue": "",
  "cif": "B03186681",
  "taxIdentificationCode": "NIF",
  "businessName": "Clave Informática",
  "address1": "",
  "address2": "",
  "postalCode": "",
  "city": "",
  "state": "",
  "country": null,
  "phone1": "",
  "phone2": "",
  "fax1": "",
  "fax2": "",
  "postalMail": "",
  "email": "",
  "web": "",
  "legalRepresentativeCif": "",
  "legalRepresentativeName": "",
  "classification": "ASSET",
  "nature": "CREDITOR",
  "sign": "POSITIVE",
  "statementBalanceColor": "RED",
  "accountingStatementColor": "RED"
}