---
title: "Draft Journals"
method: POST
path: "/journal-entries/draft"
tags: ["Journal Entry"]
---

# Draft Journals

`POST /journal-entries/draft`

## Request

- Base URL: `https://openapi.flowaccount.com/v1`
- URL: `https://openapi.flowaccount.com/v1/journal-entries/draft`
- Auth: none declared
- TypeScript: <https://skmtc.dev/flowaccount/apis/flowaccount-open-api/docs/journal-entries/draft/post.ts> (a function with typed inputs; its response is checked against the schema)

Draft of Journals includes with Journal Voucher (JV), Purchase Voucher (UV), Sales Voucher (SV), Payment Voucher (PV) and Receipt Voucher (RV)

## Request body

- JournalEntryRequest
  - `description` string, required: Description of Journals
  - `documentDate` string, required: Posted Date YYYY-MM-DD
  - `documentType` number, required: 51 = Journal Voucher <br> 53 = Purchase Voucher <br> 55 = Sales Voucher <br> 57 = Payment Voucher <br> 59 = Received Voucher
  - `remarks` string: Remarks of Journals
  - `note` string: Internal notes
  - `reference` string: References of Journals
  - `contactId` number: Customer Id
  - `contactName` string, required: Customer name is required in all journals except Joutnal Voucher (JV)
  - `bookOfAccounts` BookOfAccountsRequest[], required
    - `debitCredit` 1 | 3, required: 1 = debit, 3 = credit
    - `chartOfAccountId` number, required: Id of account code
    - `value` number, required: Amount of debit/credit
    - `description` string: Description of debit/credit

## Response `200`

ok

- DocumentList
  - `data` JournalEntryResponse
    - `recordId` number: Document Id
    - `companyId` number: Id of company
    - `documentSerial` string: Serial number of Document
    - `status` number: 1 = draft, 5 = approve
    - `description` string: Description of Journals
    - `documentDate` string: Posted Date YYYY-MM-DD
    - `createdOn` string: Create Date YYYY-MM-DD
    - `postedDate` string: Posted Date YYYY-MM-DD
    - `approvedOn` string: Approved Date YYYY-MM-DD
    - `documentType` number: 51 = Journal Voucher, 53 = Purchase Voucher, 55 = Sales Voucher, 57 = Payment Voucher, 59 = Received Voucher
    - `debit` number: Total amount of debit
    - `credit` number: Total amount od credit
    - `remarks` string: Remarks of Journals
    - `note` string: Internal notes
    - `reference` string: References of Journals
    - `contactId` number: Customer Id
    - `contactName` string: Customer name
    - `bookOfAccounts` BookOfAccountsResponse[]
      - `debitCredit` 1 | 3: 1 = debit, 3 = credit
      - `chartOfAccountId` number: Id of account code
      - `value` number: Amount of debit/credit
      - `rowNumber` number: order of row
      - `description` string: Description of debit/credit
      - `displayName` string: Account code/Account name on list
    - `isSystemDocument` boolean: false for Manual JournalEntry
    - `isLockingPeriod` boolean: false if not in or set Locking Period
    - `referenceDocuments` ReferenceDocumentForJournals[]
      - `DocumentId` number: Id of referenceDocument
      - `DocumentType` number
      - `DocumentSerial` number: Serial number of referenceDocument
  - `status` boolean
  - `message` string
  - `code` number

## Other responses

- `400`: Invalid request
- `401`: Unauthorized

---

[API](https://skmtc.dev/flowaccount/apis/flowaccount-open-api.md) - [All operations](https://skmtc.dev/flowaccount/apis/flowaccount-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowaccount/apis/flowaccount-open-api/revisions/4ba3d3ca5bd5?raw)