> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dualentry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Queue checks for later printing (v1)

> Create paper checks for transactions that will be printed later in a batch.



## OpenAPI

````yaml /developers/openapi/resources-v1.json post /public/v1/paper-checks/print-later/
openapi: 3.1.0
info:
  title: DualEntry Public API
  version: 1.0.0
  description: ''
servers:
  - url: https://api.dualentry.com
    description: Production environment
  - url: https://api-dev.dualentry.com
    description: Development environment (for testing)
security: []
tags:
  - name: Health
    description: >-
      Monitor API availability and service status. Use these endpoints to verify
      connectivity and check if the API is operational.
  - name: Webhooks
    description: >-
      Register webhook endpoints to receive real-time event notifications when
      records change in your organization. Manage subscriptions, view available
      topics, and inspect delivery history.
  - name: Accounts
    description: >-
      Manage your chart of accounts. Create and maintain the accounts used to
      categorize financial transactions, including assets, liabilities, equity,
      revenue, and expenses.
  - name: Budgets
    description: >-
      Manage financial budgets. Create and track income statement and balance
      sheet budgets with monthly cell values, actuals comparison, and
      classification filtering.
  - name: Companies
    description: >-
      Access and manage company information. Retrieve details about your
      organization including legal name, tax identifiers, addresses, and
      accounting preferences.
  - name: Customers
    description: >-
      Manage customer records. Create, update, and track customers who purchase
      goods or services from your organization, including contact information,
      billing addresses, and payment terms.
  - name: Contracts
    description: >-
      Manage revenue recognition contracts. Create and retrieve contracts with
      performance obligations, and manage obligation usage for usage-based
      obligations.
  - name: Items
    description: >-
      Manage products and services. Define items that appear on invoices and
      bills, including pricing, descriptions, and associated accounts for
      revenue or expense tracking.
  - name: Vendors
    description: >-
      Manage vendor and supplier records. Track businesses and individuals from
      whom you purchase goods or services, including contact details, payment
      terms, and tax information.
  - name: Journal Entries
    description: >-
      Create and manage manual journal entries. Record direct debits and credits
      to accounts for adjustments, accruals, reclassifications, and other
      accounting transactions.
  - name: Invoices
    description: >-
      Manage sales invoices. Create and track invoices sent to customers for
      goods or services rendered, including line items, taxes, discounts, and
      payment status.
  - name: Sales Orders
    description: >-
      Create and manage sales orders. Track customer orders for goods or
      services before invoicing, including line items, quantities, fulfillment
      status, and invoicing progress.
  - name: Bills
    description: >-
      Manage vendor bills and payables. Record and track bills received from
      vendors for goods or services purchased, including line items, due dates,
      and payment tracking.
  - name: Customer Prepayments
    description: >-
      Track advance payments from customers. Access prepayments received before
      goods or services are delivered, which can be applied to future invoices.
  - name: Customer Prepayment Applications
    description: >-
      Apply customer prepayments and credits to invoices. Record applications of
      prepayments or credit memos to reduce invoice balances.
  - name: Customer Deposits
    description: >-
      Manage customer deposit transactions. Record and track deposits received
      from customers as security or partial payment, held in liability accounts
      until earned or refunded.
  - name: Customer Refunds
    description: >-
      Process and track customer refunds. Record refunds issued to customers for
      overpayments, returns, or cancelled transactions.
  - name: Customer Credits
    description: >-
      Manage credit memos for customers. Issue credits for returned goods,
      billing adjustments, or discounts that reduce customer balances or can be
      applied to future invoices.
  - name: Cash Sales
    description: >-
      Record immediate cash sales transactions. Track sales where payment is
      received at the time of sale, including point-of-sale transactions and
      cash receipts.
  - name: Customer Payments
    description: >-
      Record and manage customer payments. Track payments received from
      customers and apply them to outstanding invoices, including partial
      payments and overpayments.
  - name: Recurring Invoices
    description: >-
      Automate recurring billing. Set up and manage templates for invoices that
      are automatically generated on a regular schedule (e.g., monthly
      subscriptions).
  - name: Recurring Bills
    description: >-
      Automate recurring expenses. Configure templates for bills that repeat on
      a regular basis (e.g., monthly rent, subscriptions) to streamline expense
      tracking.
  - name: Recurring Journal Entries
    description: >-
      Automate recurring journal entries. Create templates for journal entries
      that occur regularly (e.g., monthly depreciation, amortization) to ensure
      consistent accounting treatment.
  - name: Classifications
    description: >-
      Manage custom classification dimensions. Create and maintain
      classification categories (e.g., departments, locations, projects) used to
      tag and analyze transactions across multiple dimensions.
  - name: Classifications Lines
    description: >-
      Manage classification values. Define the specific values within each
      classification category that can be assigned to transaction line items for
      detailed reporting and analysis.
  - name: Custom Fields
    description: >-
      Manage custom field definitions. Extend records with organization-specific
      attributes — name, type (text, number, boolean, date, single_select,
      multi_select, currency, link, paragraph), default value, options, and
      which record types (invoice, bill, customer, vendor, etc.) and companies
      the field applies to. Values are set via the `custom_fields` attribute on
      each record's create/update endpoint.
  - name: Purchase Orders
    description: >-
      Create and track purchase orders. Manage formal requests to vendors for
      goods or services, including approval workflows, receiving tracking, and
      bill matching.
  - name: Vendor Payments
    description: >-
      Record and manage vendor payments. Track payments made to vendors and
      apply them to outstanding bills and credits, including partial payments
      and overpayments.
  - name: Vendor Prepayments
    description: >-
      Track advance payments to vendors. Record prepayments made before goods or
      services are received, which can be applied to future bills.
  - name: Vendor Prepayment Applications
    description: >-
      Apply vendor prepayments to bills. Record applications of prepayments to
      reduce bill balances and track amounts owed.
  - name: Vendor Credits
    description: >-
      Manage vendor credit memos. Record credits from vendors for returned
      goods, billing adjustments, or discounts that reduce amounts owed or can
      be applied to future bills.
  - name: Vendor Refunds
    description: >-
      Process and track vendor refunds. Record refunds received from vendors for
      overpayments, returns, or cancelled transactions.
  - name: Paper Checks
    description: >-
      Manage paper check printing. Create, queue, and batch print paper checks
      for vendor payments, direct expenses, vendor prepayments, and customer
      refunds.
  - name: Direct Expenses
    description: >-
      Record direct expense transactions. Track payments made directly from a
      bank or credit card account for expenses, without going through the
      accounts payable process.
  - name: Bank Transfers
    description: >-
      Manage bank-to-bank transfers. Record and track transfers between bank and
      credit card accounts, including multi-currency transfers with exchange
      rate handling.
  - name: Bank Match
    description: >-
      Reconcile bank-feed rows against accounting transactions. List bank rows,
      trigger the matching pipeline, read AI suggestions, and confirm or undo
      matches. V2 API only.
  - name: Fixed Assets
    description: >-
      Manage fixed assets and capital equipment. Create, update, and track
      long-lived tangible assets including depreciation schedules, account
      assignments, and asset lifecycle management.
  - name: Intercompany Journal Entries
    description: >-
      Create and manage intercompany journal entries. Record GL activity that
      spans two or more companies within the same organization, with per-line
      company assignment and automatic intercompany elimination.
  - name: Depreciation Books
    description: >-
      Discover available depreciation books for multi-book depreciation. Each
      organization has a posting book (BOOK) and may have additional tax books
      (FEDERAL, AMT, STATE_*). V2 API only.
  - name: VAT Rates
    description: >-
      Look up available VAT (Value Added Tax) rates for your organization. Use
      these IDs as `vat_rate_id` on transaction line items. Rates are scoped by
      country and include standard, reduced, zero-rated, exempt, and reverse
      charge types. V2 API only.
  - name: GST Tax Rates
    description: >-
      Look up available GST (Goods and Services Tax) rates for your
      organization. Use these IDs as `gst_tax_rate_id` on transaction line
      items. Covers AU, NZ, SG, IN, CA GST regimes and MY SST, with
      per-component breakdowns (e.g. CGST+SGST for India). V2 API only.
  - name: Product Tax Codes
    description: >-
      Manage organization product tax codes and discover global product tax
      codes. Use these IDs as `product_tax_code_id` on item payloads. V2 API
      only.
  - name: Approval Policies
    description: >-
      Manage approval workflows and policies. Define approval rules, steps,
      conditions, and approvers for different record types. Monitor workflow
      execution states and view approval history.
  - name: Inbox
    description: >-
      View pending approvals and approval status. Access transactions and
      records awaiting approval across the organization, including full approval
      workflow details, approvers, and action history.
paths:
  /public/v1/paper-checks/print-later/:
    post:
      tags:
        - Paper Checks
      summary: Queue checks for later printing
      description: >

        Create paper checks for transactions that will be printed later in a
        batch.


        This endpoint creates paper check records with status NOT_PRINTED. These
        checks

        can then be printed together using the `PUT /print-batch/` endpoint.


        **When to use:**

        - When you want to accumulate checks before printing

        - For batch check printing workflows

        - When check numbers need to be assigned in sequence


        **Alternative:** Use `POST /print-now/` to print a single check
        immediately.


        **Workflow:**

        1. Queue checks: `POST /print-later/` with transaction IDs

        2. Review queued checks: `GET /paper-checks/?record_status=not_printed`

        3. Print batch: `PUT /print-batch/` with paper check IDs


        **Returns:** List of created paper checks with status 'not_printed'.
      operationId: core_api_public_paper_checks_print_later
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicPrintLaterPayload'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/PublicPaperCheckSchemaOut'
                title: Response
                type: array
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchema'
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchema'
components:
  schemas:
    PublicPrintLaterPayload:
      description: |-
        Request body for queuing checks for later batch printing.

        Use this endpoint when you want to queue multiple checks to be printed
        together in a batch. The checks will be created with status NOT_PRINTED.
      properties:
        transaction_ids:
          description: >-
            List of transaction IDs to create paper checks for. Each transaction
            must be a printable type and must not already have an active paper
            check.
          example:
            - 12345
            - 12346
            - 12347
          items:
            type: integer
          title: Transaction Ids
          type: array
      required:
        - transaction_ids
      title: PublicPrintLaterPayload
      type: object
    PublicPaperCheckSchemaOut:
      description: >-
        Schema for paper check output in the public API.


        A paper check represents a physical check that can be printed for
        payments.

        Paper checks are associated with transactions such as vendor payments,

        direct expenses, vendor prepayments, or customer refunds.
      properties:
        id:
          description: Unique identifier for the paper check
          example: 12345
          title: Id
          type: integer
        created_at:
          description: Date when the paper check was created (returned as date only)
          example: '2024-01-15'
          format: date-time
          title: Created At
          type: string
        transaction_date:
          description: Date of the underlying transaction
          example: '2024-01-15'
          format: date
          title: Transaction Date
          type: string
        source_record_type:
          $ref: '#/components/schemas/PaperCheckSourceRecordType'
          description: >-
            Type of the source record (e.g., 'direct_expense', 'vendor_payment',
            'customer_refund')
          example: vendor_payment
        source_record_id:
          description: ID of the source record (e.g., the VendorPayment ID)
          example: 789
          title: Source Record Id
          type: integer
        source_record_number:
          description: Number of the source record (e.g., vendor payment number)
          example: 1001
          title: Source Record Number
          type: integer
        check_number:
          description: The check number printed on the physical check
          example: '10542'
          title: Check Number
          type: string
        company_id:
          description: ID of the company issuing the check
          example: 456
          title: Company Id
          type: integer
        company_name:
          description: Name of the company issuing the check
          example: Acme Corporation
          title: Company Name
          type: string
        memo:
          description: Memo or description for the check
          example: 'Payment for Invoice #1234'
          title: Memo
          type: string
        amount:
          description: Amount of the check
          example: '1500.00'
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$
          title: Amount
          type: string
        currency_iso_4217_code:
          $ref: '#/components/schemas/SystemCurrencies'
          description: ISO 4217 currency code for the check amount
          example: USD
        account_number:
          description: Number of the bank account the check is drawn from
          example: 321
          title: Account Number
          type: integer
        account_name:
          description: Name of the bank account the check is drawn from
          example: Operating Account
          title: Account Name
          type: string
        payee_name:
          description: Name of the payee (vendor or customer receiving the check)
          example: ABC Suppliers Inc.
          title: Payee Name
          type:
            - string
            - 'null'
        customer_id:
          description: ID of the customer if this is a customer refund check
          example: 567
          title: Customer Id
          type:
            - integer
            - 'null'
        customer_name:
          description: Name of the customer if this is a customer refund check
          example: John Smith
          title: Customer Name
          type:
            - string
            - 'null'
        vendor_id:
          description: ID of the vendor if this is a vendor payment check
          example: 890
          title: Vendor Id
          type:
            - integer
            - 'null'
        vendor_name:
          description: Name of the vendor if this is a vendor payment check
          example: ABC Suppliers Inc.
          title: Vendor Name
          type:
            - string
            - 'null'
        record_status:
          description: >-
            Status of the paper check: 'not_printed' (queued), 'printed', or
            'archived'
          enum:
            - printed
            - not_printed
            - archived
          example: printed
          title: Record Status
          type: string
      required:
        - id
        - created_at
        - transaction_date
        - source_record_type
        - source_record_id
        - source_record_number
        - check_number
        - company_id
        - company_name
        - memo
        - amount
        - currency_iso_4217_code
        - account_number
        - account_name
        - record_status
      title: PublicPaperCheckSchemaOut
      type: object
    ErrorSchema:
      properties:
        success:
          const: false
          default: false
          title: Success
          type: boolean
        errors:
          additionalProperties:
            items:
              type: string
            type: array
          title: Errors
          type: object
      required:
        - errors
      title: ErrorSchema
      type: object
    PaperCheckSourceRecordType:
      description: Allowed source record types for paper checks.
      enum:
        - direct_expense
        - vendor_payment
        - vendor_prepayment
        - customer_refund
      title: PaperCheckSourceRecordType
      type: string
    SystemCurrencies:
      enum:
        - AED
        - AFN
        - ALL
        - AMD
        - ANG
        - AOA
        - ARS
        - AUD
        - AWG
        - AZN
        - BAM
        - BBD
        - BDT
        - BGN
        - BHD
        - BIF
        - BMD
        - BND
        - BOB
        - BRL
        - BSD
        - BTN
        - BWP
        - BYN
        - BZD
        - CAD
        - CDF
        - CHF
        - CLF
        - CLP
        - CNY
        - COP
        - CRC
        - CUP
        - CVE
        - CZK
        - DJF
        - DKK
        - DOP
        - DZD
        - EGP
        - ERN
        - ETB
        - EUR
        - FJD
        - FKP
        - GBP
        - GEL
        - GHS
        - GIP
        - GMD
        - GNF
        - GTQ
        - GYD
        - HKD
        - HNL
        - HTG
        - HUF
        - IDR
        - ILS
        - INR
        - IQD
        - IRR
        - ISK
        - JMD
        - JOD
        - JPY
        - KES
        - KGS
        - KHR
        - KMF
        - KPW
        - KRW
        - KWD
        - KYD
        - KZT
        - LAK
        - LBP
        - LKR
        - LRD
        - LSL
        - LYD
        - MAD
        - MDL
        - MGA
        - MKD
        - MMK
        - MNT
        - MOP
        - MRU
        - MUR
        - MVR
        - MWK
        - MXN
        - MYR
        - MZN
        - NAD
        - NGN
        - NIO
        - NOK
        - NPR
        - NZD
        - OMR
        - PAB
        - PEN
        - PGK
        - PHP
        - PKR
        - PLN
        - PYG
        - QAR
        - RON
        - RSD
        - RUB
        - RWF
        - SAR
        - SBD
        - SCR
        - SDG
        - SEK
        - SGD
        - SHP
        - SLL
        - SOS
        - SRD
        - STN
        - SVC
        - SYP
        - SZL
        - THB
        - TJS
        - TMT
        - TND
        - TOP
        - TRY
        - TTD
        - TWD
        - TZS
        - UAH
        - UGX
        - USD
        - UYU
        - UZS
        - VES
        - VND
        - VUV
        - WST
        - XAF
        - XAG
        - XAU
        - XCD
        - XDR
        - XOF
        - XPD
        - XPF
        - XPT
        - YER
        - ZAR
        - ZMW
        - ZWL
      title: SystemCurrencies
      type: string

````