Skip to content
API References
/
/
Get VendorRefund record

DualEntry Public API (1.0.0)

Download OpenAPI description
resources.json
resources.yaml
Languages
Servers
Production environment
https://api.dualentry.io/
Development environment (for testing)
https://api-dev.dualentry.io/

Health

Monitor API availability and service status. Use these endpoints to verify connectivity and check if the API is operational.

Operations

Accounts

Manage your chart of accounts. Create and maintain the accounts used to categorize financial transactions, including assets, liabilities, equity, revenue, and expenses.

Operations

Items

Manage products and services. Define items that appear on invoices and bills, including pricing, descriptions, and associated accounts for revenue or expense tracking.

Operations

Classifications

Manage custom classification dimensions. Create and maintain classification categories (e.g., departments, locations, projects) used to tag and analyze transactions across multiple dimensions.

Operations

Classifications Lines

Manage classification values. Define the specific values within each classification category that can be assigned to transaction line items for detailed reporting and analysis.

Operations

Companies

Access and manage company information. Retrieve details about your organization including legal name, tax identifiers, addresses, and accounting preferences.

Operations

Journal Entries

Create and manage manual journal entries. Record direct debits and credits to accounts for adjustments, accruals, reclassifications, and other accounting transactions.

Operations

Recurring Journal Entries

Automate recurring journal entries. Create templates for journal entries that occur regularly (e.g., monthly depreciation, amortization) to ensure consistent accounting treatment.

Operations

Invoices

Manage sales invoices. Create and track invoices sent to customers for goods or services rendered, including line items, taxes, discounts, and payment status.

Operations

Sales Orders

Create and manage sales orders. Track customer orders for goods or services before invoicing, including line items, quantities, fulfillment status, and invoicing progress.

Operations

Recurring Invoices

Automate recurring billing. Set up and manage templates for invoices that are automatically generated on a regular schedule (e.g., monthly subscriptions).

Operations

Customers

Manage customer records. Create, update, and track customers who purchase goods or services from your organization, including contact information, billing addresses, and payment terms.

Operations

Customer Payments

Record and manage customer payments. Track payments received from customers and apply them to outstanding invoices, including partial payments and overpayments.

Operations

Customer Prepayments

Track advance payments from customers. Access prepayments received before goods or services are delivered, which can be applied to future invoices.

Operations

Customer Prepayment Applications

Apply customer prepayments and credits to invoices. Record applications of prepayments or credit memos to reduce invoice balances.

Operations

Customer Deposits

Manage customer deposit transactions. Record and track deposits received from customers as security or partial payment, held in liability accounts until earned or refunded.

Operations

Customer Refunds

Process and track customer refunds. Record refunds issued to customers for overpayments, returns, or cancelled transactions.

Operations

Customer Credits

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.

Operations

Cash Sales

Record immediate cash sales transactions. Track sales where payment is received at the time of sale, including point-of-sale transactions and cash receipts.

Operations

Bills

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.

Operations

Recurring Bills

Automate recurring expenses. Configure templates for bills that repeat on a regular basis (e.g., monthly rent, subscriptions) to streamline expense tracking.

Operations

Purchase Orders

Create and track purchase orders. Manage formal requests to vendors for goods or services, including approval workflows, receiving tracking, and bill matching.

Operations

Vendors

Manage vendor and supplier records. Track businesses and individuals from whom you purchase goods or services, including contact details, payment terms, and tax information.

Operations

Vendor Payments

Record and manage vendor payments. Track payments made to vendors and apply them to outstanding bills and credits, including partial payments and overpayments.

Operations

Vendor Credits

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.

Operations

Vendor Refunds

Process and track vendor refunds. Record refunds received from vendors for overpayments, returns, or cancelled transactions.

Operations

Create VendorRefund record

Request

Create a new VendorRefund record with the provided data. Validates all required fields and business rules.

Bodyapplication/jsonrequired
custom_fieldsArray of objects or null(Custom Fields)
datestring(date)(Date)required
transaction_datestring or null(date)(Transaction Date)
company_idinteger(Company Id)required
vendor_idinteger(Vendor Id)required
check_numberstring(Check Number)
Default ""
account_numberinteger(Account Number)required
currency_iso_4217_codestring(SystemCurrencies)required
Enum"AED""AFN""ALL""AMD""ANG""AOA""ARS""AUD""AWG""AZN"
exchange_rateExchange Rate (number) or Exchange Rate (string)(Exchange Rate)required
Any of:
number(Exchange Rate)
memostring(Memo)
Default ""
itemsArray of objects(Items)
Default []
attachmentsArray of objects(Attachments)
Default []
bank_or_credit_card_amountBank Or Credit Card Amount (number) or Bank Or Credit Card Amount (string)(Bank Or Credit Card Amount)

Bank or credit card amount

Default "0.00"
Any of:

Bank or credit card amount

>= 0
number(Bank Or Credit Card Amount)>= 0
Default "0.00"
record_statusstring(RecordStatus)
Default "posted"
Enum"draft""posted""archived"
curl -i -X POST \
  https://api.dualentry.io/public/v1/vendor-refunds/ \
  -H 'Content-Type: application/json' \
  -d '{
    "custom_fields": [
      {}
    ],
    "date": "2019-08-24",
    "transaction_date": "2019-08-24",
    "company_id": 0,
    "vendor_id": 0,
    "check_number": "",
    "account_number": 0,
    "currency_iso_4217_code": "AED",
    "exchange_rate": 0,
    "memo": "",
    "items": [],
    "attachments": [],
    "bank_or_credit_card_amount": "0.00",
    "record_status": "posted"
  }'

Responses

OK

Bodyapplication/json
classificationsArray of objects(Classifications)
Default []
transaction_idsArray of integers(Transaction Ids)required
created_byobject or null(AuditActorSchemaOut)

Schema for audit actor information.

updated_byobject or null(AuditActorSchemaOut)

Schema for audit actor information.

internal_idinteger(Internal Id)required
numberinteger(Number)required
account_numberinteger or null(Account Number)required
itemsArray of objects(Items)required
items[].​vendor_credit_numberinteger or null(Vendor Credit Number)
items[].​vendor_prepayment_numberinteger or null(Vendor Prepayment Number)
items[].​amountAmount (number) or Amount (string)(Amount)required
Any of:
number(Amount)
items[].​positioninteger(Position)required
items[].​bank_or_credit_card_amountBank Or Credit Card Amount (number) or Bank Or Credit Card Amount (string)(Bank Or Credit Card Amount)required
Any of:
number(Bank Or Credit Card Amount)
company_idinteger(Company Id)required
company_namestring(Company Name)required
company_currencystring(Company Currency)required
vendor_idinteger(Vendor Id)required
vendor_namestring(Vendor Name)required
memostring(Memo)required
check_numberstring(Check Number)required
datestring(date)(Date)required

Posting date (GL date) - the date when the transaction is recorded in the general ledger

transaction_datestring(date)(Transaction Date)required

Transaction date (inception date) - the date when the transaction actually occurred

currency_iso_4217_codestring(SystemCurrencies)required
Enum"AED""AFN""ALL""AMD""ANG""AOA""ARS""AUD""AWG""AZN"
exchange_rateExchange Rate (number) or Exchange Rate (string)(Exchange Rate)required
Any of:
number(Exchange Rate)
bank_or_credit_card_amountBank Or Credit Card Amount (number) or Bank Or Credit Card Amount (string)(Bank Or Credit Card Amount)required
Any of:
number(Bank Or Credit Card Amount)
amountAmount (number) or Amount (string)(Amount)required

Total transaction amount

Any of:

Total transaction amount

number(Amount)
record_statusstring(core__models__base__RecordStatus)required
Enum"draft""posted""archived"
paper_check_statusstring or null(core__models__paper_check__PaperCheck__RecordStatus)required
Enum"printed""not_printed""archived"
Response
application/json
{
  "classifications": [],
  "transaction_ids": [
    0
  ],
  "created_by": {
    "actor_type": "string",
    "email": "string",
    "first_name": "string",
    "last_name": "string",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "updated_by": {
    "actor_type": "string",
    "email": "string",
    "first_name": "string",
    "last_name": "string",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "internal_id": 0,
  "number": 0,
  "account_number": 0,
  "items": [
    { … }
  ],
  "company_id": 0,
  "company_name": "string",
  "company_currency": "string",
  "vendor_id": 0,
  "vendor_name": "string",
  "memo": "string",
  "check_number": "string",
  "date": "2019-08-24",
  "transaction_date": "2019-08-24",
  "currency_iso_4217_code": "AED",
  "exchange_rate": 0,
  "bank_or_credit_card_amount": 0,
  "amount": 0,
  "record_status": "draft",
  "paper_check_status": "printed"
}

Get VendorRefund record

Request

Retrieve a specific VendorRefund record by number with all related data.

Path
record_numberinteger(Record Number)required
Query
searchstring or null(Search)
company_idArray of integers or null(Company Id)
numberArray of integers or null(Number)
vendor_idArray of integers or null(Vendor Id)
start_datestring or null(date)(Start Date)
end_datestring or null(date)(End Date)
transaction_currencystring or null(SystemCurrencies)
Enum"AED""AFN""ALL""AMD""ANG""AOA""ARS""AUD""AWG""AZN"
record_statusstring or null(RecordStatus)
Enum"draft""posted""archived"
curl -i -X GET \
  'https://api.dualentry.io/public/v1/vendor-refunds/{record_number}/?search=string&company_id=0&number=0&vendor_id=0&start_date=2019-08-24&end_date=2019-08-24&transaction_currency=AED&record_status=draft'

Responses

OK

Bodyapplication/json
classificationsArray of objects(Classifications)
Default []
transaction_idsArray of integers(Transaction Ids)required
created_byobject or null(AuditActorSchemaOut)

Schema for audit actor information.

updated_byobject or null(AuditActorSchemaOut)

Schema for audit actor information.

internal_idinteger(Internal Id)required
numberinteger(Number)required
account_numberinteger or null(Account Number)required
itemsArray of objects(Items)required
items[].​vendor_credit_numberinteger or null(Vendor Credit Number)
items[].​vendor_prepayment_numberinteger or null(Vendor Prepayment Number)
items[].​amountAmount (number) or Amount (string)(Amount)required
Any of:
number(Amount)
items[].​positioninteger(Position)required
items[].​bank_or_credit_card_amountBank Or Credit Card Amount (number) or Bank Or Credit Card Amount (string)(Bank Or Credit Card Amount)required
Any of:
number(Bank Or Credit Card Amount)
company_idinteger(Company Id)required
company_namestring(Company Name)required
company_currencystring(Company Currency)required
vendor_idinteger(Vendor Id)required
vendor_namestring(Vendor Name)required
memostring(Memo)required
check_numberstring(Check Number)required
datestring(date)(Date)required

Posting date (GL date) - the date when the transaction is recorded in the general ledger

transaction_datestring(date)(Transaction Date)required

Transaction date (inception date) - the date when the transaction actually occurred

currency_iso_4217_codestring(SystemCurrencies)required
Enum"AED""AFN""ALL""AMD""ANG""AOA""ARS""AUD""AWG""AZN"
exchange_rateExchange Rate (number) or Exchange Rate (string)(Exchange Rate)required
Any of:
number(Exchange Rate)
bank_or_credit_card_amountBank Or Credit Card Amount (number) or Bank Or Credit Card Amount (string)(Bank Or Credit Card Amount)required
Any of:
number(Bank Or Credit Card Amount)
amountAmount (number) or Amount (string)(Amount)required

Total transaction amount

Any of:

Total transaction amount

number(Amount)
record_statusstring(core__models__base__RecordStatus)required
Enum"draft""posted""archived"
paper_check_statusstring or null(core__models__paper_check__PaperCheck__RecordStatus)required
Enum"printed""not_printed""archived"
Response
application/json
{
  "classifications": [],
  "transaction_ids": [
    0
  ],
  "created_by": {
    "actor_type": "string",
    "email": "string",
    "first_name": "string",
    "last_name": "string",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "updated_by": {
    "actor_type": "string",
    "email": "string",
    "first_name": "string",
    "last_name": "string",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "internal_id": 0,
  "number": 0,
  "account_number": 0,
  "items": [
    { … }
  ],
  "company_id": 0,
  "company_name": "string",
  "company_currency": "string",
  "vendor_id": 0,
  "vendor_name": "string",
  "memo": "string",
  "check_number": "string",
  "date": "2019-08-24",
  "transaction_date": "2019-08-24",
  "currency_iso_4217_code": "AED",
  "exchange_rate": 0,
  "bank_or_credit_card_amount": 0,
  "amount": 0,
  "record_status": "draft",
  "paper_check_status": "printed"
}

Update VendorRefund record

Request

Update an existing VendorRefund record with the provided data. Validates all required fields and business rules.

Path
record_numberinteger(Record Number)required
Bodyapplication/jsonrequired
custom_fieldsArray of objects or null(Custom Fields)
datestring(date)(Date)required
transaction_datestring or null(date)(Transaction Date)
company_idinteger(Company Id)required
vendor_idinteger(Vendor Id)required
check_numberstring(Check Number)
Default ""
account_numberinteger(Account Number)required
currency_iso_4217_codestring(SystemCurrencies)required
Enum"AED""AFN""ALL""AMD""ANG""AOA""ARS""AUD""AWG""AZN"
exchange_rateExchange Rate (number) or Exchange Rate (string)(Exchange Rate)required
Any of:
number(Exchange Rate)
memostring(Memo)
Default ""
itemsArray of objects(Items)
Default []
attachmentsArray of objects(Attachments)
Default []
bank_or_credit_card_amountBank Or Credit Card Amount (number) or Bank Or Credit Card Amount (string)(Bank Or Credit Card Amount)

Bank or credit card amount

Default "0.00"
Any of:

Bank or credit card amount

>= 0
number(Bank Or Credit Card Amount)>= 0
Default "0.00"
record_statusstring(RecordStatus)
Default "posted"
Enum"draft""posted""archived"
curl -i -X PUT \
  'https://api.dualentry.io/public/v1/vendor-refunds/{record_number}/' \
  -H 'Content-Type: application/json' \
  -d '{
    "custom_fields": [
      {}
    ],
    "date": "2019-08-24",
    "transaction_date": "2019-08-24",
    "company_id": 0,
    "vendor_id": 0,
    "check_number": "",
    "account_number": 0,
    "currency_iso_4217_code": "AED",
    "exchange_rate": 0,
    "memo": "",
    "items": [],
    "attachments": [],
    "bank_or_credit_card_amount": "0.00",
    "record_status": "posted"
  }'

Responses

OK

Bodyapplication/json
classificationsArray of objects(Classifications)
Default []
transaction_idsArray of integers(Transaction Ids)required
created_byobject or null(AuditActorSchemaOut)

Schema for audit actor information.

updated_byobject or null(AuditActorSchemaOut)

Schema for audit actor information.

internal_idinteger(Internal Id)required
numberinteger(Number)required
account_numberinteger or null(Account Number)required
itemsArray of objects(Items)required
items[].​vendor_credit_numberinteger or null(Vendor Credit Number)
items[].​vendor_prepayment_numberinteger or null(Vendor Prepayment Number)
items[].​amountAmount (number) or Amount (string)(Amount)required
Any of:
number(Amount)
items[].​positioninteger(Position)required
items[].​bank_or_credit_card_amountBank Or Credit Card Amount (number) or Bank Or Credit Card Amount (string)(Bank Or Credit Card Amount)required
Any of:
number(Bank Or Credit Card Amount)
company_idinteger(Company Id)required
company_namestring(Company Name)required
company_currencystring(Company Currency)required
vendor_idinteger(Vendor Id)required
vendor_namestring(Vendor Name)required
memostring(Memo)required
check_numberstring(Check Number)required
datestring(date)(Date)required

Posting date (GL date) - the date when the transaction is recorded in the general ledger

transaction_datestring(date)(Transaction Date)required

Transaction date (inception date) - the date when the transaction actually occurred

currency_iso_4217_codestring(SystemCurrencies)required
Enum"AED""AFN""ALL""AMD""ANG""AOA""ARS""AUD""AWG""AZN"
exchange_rateExchange Rate (number) or Exchange Rate (string)(Exchange Rate)required
Any of:
number(Exchange Rate)
bank_or_credit_card_amountBank Or Credit Card Amount (number) or Bank Or Credit Card Amount (string)(Bank Or Credit Card Amount)required
Any of:
number(Bank Or Credit Card Amount)
amountAmount (number) or Amount (string)(Amount)required

Total transaction amount

Any of:

Total transaction amount

number(Amount)
record_statusstring(core__models__base__RecordStatus)required
Enum"draft""posted""archived"
paper_check_statusstring or null(core__models__paper_check__PaperCheck__RecordStatus)required
Enum"printed""not_printed""archived"
Response
application/json
{
  "classifications": [],
  "transaction_ids": [
    0
  ],
  "created_by": {
    "actor_type": "string",
    "email": "string",
    "first_name": "string",
    "last_name": "string",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "updated_by": {
    "actor_type": "string",
    "email": "string",
    "first_name": "string",
    "last_name": "string",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "internal_id": 0,
  "number": 0,
  "account_number": 0,
  "items": [
    { … }
  ],
  "company_id": 0,
  "company_name": "string",
  "company_currency": "string",
  "vendor_id": 0,
  "vendor_name": "string",
  "memo": "string",
  "check_number": "string",
  "date": "2019-08-24",
  "transaction_date": "2019-08-24",
  "currency_iso_4217_code": "AED",
  "exchange_rate": 0,
  "bank_or_credit_card_amount": 0,
  "amount": 0,
  "record_status": "draft",
  "paper_check_status": "printed"
}

Paper Checks

Manage paper check printing. Create, queue, and batch print paper checks for vendor payments, direct expenses, vendor prepayments, and customer refunds.

Operations