Journal Transactions

Retrieve journal transaction from Basecone by its unique identifier.

GET transactions/:id

Example response

{
    "type": "journal",
    "transactionId": "1edda966-38d7-4ba5-8015-0d29653c18c5",
    "documentId": "5eef1f43-460a-4005-9989-4f88bd80fb01",
    "targetCompany": {
        "code": "9901"
    },
    "destinationCompany": {
        "code": "9901"
    },
    "transactionNumber": null,
    "transactionDate": "2014-08-06T00:00:00",
    "generalLedger": {
        "code": "1000"
    },
    "period": "2014/8",
    "currency": {
        "code": "EUR"
    },
    "additionalField1": "Additional information",
    "additionalField2": "Some more additional information",
    "additionalField3": "AAAHlw==5EEF1F43460A400599894F88BD80FB01",
    "transactionLines": [
        {
            "isCredit": true,
            "transactionLineId": "e148e4cd-5fca-49f1-acdb-75e3112e8852",
            "lineNumber": 1,
            "description": "Some description",
            "destinationCompany": {
                "code": "9901"
            },
            "generalLedger": {
                "code": "0110"
            },
            "costCenter": {
                "code": "00014"
            },
            "costUnit": {
                "code": "D0001"
            },
            "project": {
                "code": "P0002"
            },
            "amount": 600,
            "vatCode": {
                "code": "4573"
            },
            "vatAmount": 120
        }
    ],
    "bookYear": 2014
}

Journal transaction properties

Properties specific to journal transactions are printed bold, other properties are shared between all types of transactions.

Property Type Description Optional
TransactionId Guid Unique identifier of the transaction. No
Type String Indicates the type of transaction, possible value are cash,sales,purchase,journal. No
DocumentId Guid Unique identifier of related document. No
TargetCompany Company object This is the company that is targeted to receive the posting line details. This differs from the destination company. No
DestinationCompany Company object The destination company is the company to which the header of a transaction in generally booked. No
TransactionNumber Long (nullable) Transaction number is the unique number per booking, that is a reference for the transaction from Basecone or any other application (3rd party). No
TransactionDate DateTime (nullable) This is the date of the transaction, in most cases the invoice date. The invoice date is generally mentioned on each invoice and differs from the transaction date. No
GeneralLedger GeneralLedger object This is the code of the ledger that is selected to book a transaction. This represents the category of booking. No
Period String The period of a transaction relates to the transaction date and represents the specific period in the accounts of a company. No
Currency Currency object Currency used in transaction. No
AdditionalField1 String Additional text field I No
AdditionalField2 String Additional text field II No
AdditionalField3 String Additional text field III No
IsFinalBooking Bool Indicates if this transaction is booked as a final booking. No
TransactionLines Array Collection of transactionlines. Type of transactionline depends on the type of transaction. Yes
BookYear Int The booking year of a transaction relates to the year in the period property. No

Journal transaction line properties

Property Type Description Optional
IsCredit Bool This indicates if the line is a credit or a debit. This implies the booking to be posted as a credit against another posting line. The sum of all postings needs to balance. No
TransactionLineId Guid Unique identifier of the transaction line. No
LineNumber Int Line number No
Description String Description No
DestinationCompany Company object The destination company is the company to which the header of a transaction in generally booked. No
GeneralLedger GeneralLedger object This is the code of the ledger that is selected to book a transaction. This represents the category of booking. No
CostCenter CostCenter object Cost center No
CostUnit CostUnit object Cost unit.

Note: currently, supported only on Unit4 companies.

No
Project Project object Project No
Amount Decimal (nullable) Amount No
VatCode VatCode object Vat code No
VatAmount Decimal (nullable) Vat amount No

Possible error responses

Status code Error code Details
404 transaction_not_found Transaction with specified unique id could not be found