Create CustomerPrepaymentApplicationV2 record

curl --request POST \
  --url https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "date": "2023-12-25",
  "company_id": 123,
  "exchange_rate": 123,
  "custom_fields": [
    {}
  ],
  "transaction_date": "2023-12-25",
  "customer_prepayment_number": 123,
  "customer_credit_number": 123,
  "memo": "",
  "items": [],
  "attachments": [],
  "record_status": "posted"
}
'

import requests

url = "https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/"

payload = {
    "date": "2023-12-25",
    "company_id": 123,
    "exchange_rate": 123,
    "custom_fields": [{}],
    "transaction_date": "2023-12-25",
    "customer_prepayment_number": 123,
    "customer_credit_number": 123,
    "memo": "",
    "items": [],
    "attachments": [],
    "record_status": "posted"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    date: '2023-12-25',
    company_id: 123,
    exchange_rate: 123,
    custom_fields: [{}],
    transaction_date: '2023-12-25',
    customer_prepayment_number: 123,
    customer_credit_number: 123,
    memo: '',
    items: [],
    attachments: [],
    record_status: 'posted'
  })
};

fetch('https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'date' => '2023-12-25',
    'company_id' => 123,
    'exchange_rate' => 123,
    'custom_fields' => [
        [
                
        ]
    ],
    'transaction_date' => '2023-12-25',
    'customer_prepayment_number' => 123,
    'customer_credit_number' => 123,
    'memo' => '',
    'items' => [
        
    ],
    'attachments' => [
        
    ],
    'record_status' => 'posted'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/"

	payload := strings.NewReader("{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"exchange_rate\": 123,\n  \"custom_fields\": [\n    {}\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"customer_prepayment_number\": 123,\n  \"customer_credit_number\": 123,\n  \"memo\": \"\",\n  \"items\": [],\n  \"attachments\": [],\n  \"record_status\": \"posted\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"exchange_rate\": 123,\n  \"custom_fields\": [\n    {}\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"customer_prepayment_number\": 123,\n  \"customer_credit_number\": 123,\n  \"memo\": \"\",\n  \"items\": [],\n  \"attachments\": [],\n  \"record_status\": \"posted\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"exchange_rate\": 123,\n  \"custom_fields\": [\n    {}\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"customer_prepayment_number\": 123,\n  \"customer_credit_number\": 123,\n  \"memo\": \"\",\n  \"items\": [],\n  \"attachments\": [],\n  \"record_status\": \"posted\"\n}"

response = http.request(request)
puts response.read_body

{
  "transaction_ids": [
    123
  ],
  "internal_id": 123,
  "number": 123,
  "company_id": 123,
  "company_name": "<string>",
  "company_currency": "<string>",
  "customer_id": 123,
  "customer_name": "<string>",
  "customer_prepayment_number": 123,
  "customer_credit_number": 123,
  "currency_iso_4217_code": "AED",
  "exchange_rate": "<string>",
  "memo": "<string>",
  "date": "2023-12-25",
  "transaction_date": "2023-12-25",
  "amount": "<string>",
  "record_status": "draft",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "attachments": [],
  "classifications": [],
  "created_by": {
    "actor_type": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "via": "<string>",
    "agent_id": 123,
    "agent_name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "updated_by": {
    "actor_type": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "via": "<string>",
    "agent_id": 123,
    "agent_name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "code": "<string>",
  "items": [],
  "has_more_lines": false,
  "lines_count": 0
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

Customer Prepayment Applications

Create CustomerPrepaymentApplicationV2 record

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

Side effects

If an approval workflow matches this request, DualEntry can set record_status back to draft.
If the customer or vendor is intercompany, DualEntry also writes a transaction in the elimination company.
DualEntry recomputes the billable-line status of the invoices linked to this prepayment application.

Additional validations

Fails with 422 when the items amounts total more than the remaining balance of the customer prepayment or customer credit.
Fails with 422 and the error code posting_date_after_limit if date is after the latest posting date that your organization allows.
Fails with 422 if you set an inactive, archived, or draft customer or vendor, or an inactive company.
A reference that the record or its linked source record already holds passes these checks.

POST

public

v3-alpha

customer-prepayment-applications

Create CustomerPrepaymentApplicationV2 record

curl --request POST \
  --url https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "date": "2023-12-25",
  "company_id": 123,
  "exchange_rate": 123,
  "custom_fields": [
    {}
  ],
  "transaction_date": "2023-12-25",
  "customer_prepayment_number": 123,
  "customer_credit_number": 123,
  "memo": "",
  "items": [],
  "attachments": [],
  "record_status": "posted"
}
'

import requests

url = "https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/"

payload = {
    "date": "2023-12-25",
    "company_id": 123,
    "exchange_rate": 123,
    "custom_fields": [{}],
    "transaction_date": "2023-12-25",
    "customer_prepayment_number": 123,
    "customer_credit_number": 123,
    "memo": "",
    "items": [],
    "attachments": [],
    "record_status": "posted"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    date: '2023-12-25',
    company_id: 123,
    exchange_rate: 123,
    custom_fields: [{}],
    transaction_date: '2023-12-25',
    customer_prepayment_number: 123,
    customer_credit_number: 123,
    memo: '',
    items: [],
    attachments: [],
    record_status: 'posted'
  })
};

fetch('https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'date' => '2023-12-25',
    'company_id' => 123,
    'exchange_rate' => 123,
    'custom_fields' => [
        [
                
        ]
    ],
    'transaction_date' => '2023-12-25',
    'customer_prepayment_number' => 123,
    'customer_credit_number' => 123,
    'memo' => '',
    'items' => [
        
    ],
    'attachments' => [
        
    ],
    'record_status' => 'posted'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/"

	payload := strings.NewReader("{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"exchange_rate\": 123,\n  \"custom_fields\": [\n    {}\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"customer_prepayment_number\": 123,\n  \"customer_credit_number\": 123,\n  \"memo\": \"\",\n  \"items\": [],\n  \"attachments\": [],\n  \"record_status\": \"posted\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"exchange_rate\": 123,\n  \"custom_fields\": [\n    {}\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"customer_prepayment_number\": 123,\n  \"customer_credit_number\": 123,\n  \"memo\": \"\",\n  \"items\": [],\n  \"attachments\": [],\n  \"record_status\": \"posted\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dualentry.com/public/v3-alpha/customer-prepayment-applications/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"date\": \"2023-12-25\",\n  \"company_id\": 123,\n  \"exchange_rate\": 123,\n  \"custom_fields\": [\n    {}\n  ],\n  \"transaction_date\": \"2023-12-25\",\n  \"customer_prepayment_number\": 123,\n  \"customer_credit_number\": 123,\n  \"memo\": \"\",\n  \"items\": [],\n  \"attachments\": [],\n  \"record_status\": \"posted\"\n}"

response = http.request(request)
puts response.read_body

{
  "transaction_ids": [
    123
  ],
  "internal_id": 123,
  "number": 123,
  "company_id": 123,
  "company_name": "<string>",
  "company_currency": "<string>",
  "customer_id": 123,
  "customer_name": "<string>",
  "customer_prepayment_number": 123,
  "customer_credit_number": 123,
  "currency_iso_4217_code": "AED",
  "exchange_rate": "<string>",
  "memo": "<string>",
  "date": "2023-12-25",
  "transaction_date": "2023-12-25",
  "amount": "<string>",
  "record_status": "draft",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "attachments": [],
  "classifications": [],
  "created_by": {
    "actor_type": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "via": "<string>",
    "agent_id": 123,
    "agent_name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "updated_by": {
    "actor_type": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "via": "<string>",
    "agent_id": 123,
    "agent_name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "code": "<string>",
  "items": [],
  "has_more_lines": false,
  "lines_count": 0
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

{
  "errors": {},
  "success": false,
  "error_code": "<string>",
  "error_reason": "<string>"
}

Authorizations

X-API-KEY

string

header

required

Headers

Idempotency-Key

string

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Maximum string length: 255

Query Parameters

apply_default_classifications

boolean

default:true

When false, store submitted line classifications, including an empty list. When omitted, organization defaults apply to new lines with omitted or empty classifications only when the organization setting is enabled.

Body

application/json

date

string<date>

required

company_id

integer

required

currency_iso_4217_code

enum<string>

required

Available options:

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

exchange_rate

required

custom_fields

Custom Fields · object[] | null

transaction_date

string<date> | null

customer_prepayment_number

integer | null

customer_credit_number

integer | null

memo

string

default:""

items

PublicCustomerPrepaymentApplicationItemIn · object[]

Show child attributes

attachments

AttachmentSchemaOut · object[]

Show child attributes

record_status

enum<string>

default:posted

Available options:

draft,

posted,

archived

Response

transaction_ids

integer[]

required

internal_id

integer

required

number

integer

required

company_id

integer

required

company_name

string

required

company_currency

string

required

customer_id

integer

required

customer_name

string

required

customer_prepayment_number

integer | null

required

customer_credit_number

integer | null

required

currency_iso_4217_code

enum<string>

required

Available options:

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

exchange_rate

string

required

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,16}0*$

memo

string

required

date

string<date>

required

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

transaction_date

string<date>

required

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

amount

string

required

Total transaction amount

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

record_status

enum<string>

required

Available options:

draft,

posted,

archived

created_at

string<date-time>

required

Date and time the record was created

updated_at

string<date-time>

required

Date and time the record was last updated

attachments

PublicAttachmentSchemaOut · object[]

Show child attributes

classifications

PublicRecordClassificationsSchemaOut · object[]

Show child attributes

created_by

AuditActorSchemaOut · object | null

Schema for audit actor information.

Show child attributes

updated_by

AuditActorSchemaOut · object | null

Schema for audit actor information.

Show child attributes

code

string | null

items

PublicCustomerPrepaymentApplicationItemOut · object[]

Show child attributes

has_more_lines

boolean

default:false

lines_count

integer

default:0

Overview

Organization

Accounting Setup

Transactions

Money In

Money Out

Financial & Banking

Assets

Tax

Financial Planning

Reporting

Governance

Developers

Monitoring

OAuth

Create CustomerPrepaymentApplicationV2 record

Authorizations

Headers

Query Parameters

Body

Response