Reopen a previously closed fiscal year (prior-period adjustment)

curl --request POST \
  --url https://api.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fiscal_year": 2024,
  "reason": "Prior-period adjustment: vendor invoice for FY2024 received in FY2025"
}
'

import requests

url = "https://api.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year"

payload = {
    "fiscal_year": 2024,
    "reason": "Prior-period adjustment: vendor invoice for FY2024 received in FY2025"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    fiscal_year: 2024,
    reason: 'Prior-period adjustment: vendor invoice for FY2024 received in FY2025'
  })
};

fetch('https://api.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year', 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.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year",
  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([
    'fiscal_year' => 2024,
    'reason' => 'Prior-period adjustment: vendor invoice for FY2024 received in FY2025'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year"

	payload := strings.NewReader("{\n  \"fiscal_year\": 2024,\n  \"reason\": \"Prior-period adjustment: vendor invoice for FY2024 received in FY2025\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fiscal_year\": 2024,\n  \"reason\": \"Prior-period adjustment: vendor invoice for FY2024 received in FY2025\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fiscal_year\": 2024,\n  \"reason\": \"Prior-period adjustment: vendor invoice for FY2024 received in FY2025\"\n}"

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

{
  "data": {
    "reversal_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "original_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "fiscal_year": 123,
    "period_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "period_status": "closed",
    "balanced": true,
    "idempotent": true
  }
}

{
  "error": "fiscal_year_not_closed",
  "code": "fiscal_year_not_closed",
  "hint": "<string>"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "no_closing_je_found",
  "code": "no_closing_je_found",
  "hint": "<string>",
  "reversal_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

Accounting

Reopen a previously closed fiscal year (prior-period adjustment)

Required API key scope: accounting:close_period

Reopens a previously closed fiscal year by posting the inverse of the canonical closing journal entry (sign-flip every line) and transitioning the fiscal-year-end monthly period from year_end_closed back to closed. The original closing JE is preserved (per ERP-CORRECTNESS-RULES §A4: reversing entries never edit or delete; a new offsetting JE is posted).

Industry precedent:

NetSuite “Reopen Closed Period” (Setup > Accounting > Manage G/L): posts inverse closing JE and transitions period back to open for amendment.
Acumatica “Financial Periods” reopen: full audit trail (who, when, reason).
QuickBooks Online “Change closing date”: removes the lock; lets accountants post prior-period adjustments.
AICPA / GAAP ASC 250 (prior-period adjustments): permits PPAs to a previously closed fiscal year via reversing entries.

Preconditions:

The fiscal year must currently be in year_end_closed status (HTTP 400 fiscal_year_not_closed otherwise).
A posted closing JE must exist for (entity_id, fiscal_year) (HTTP 409 no_closing_je_found otherwise).
Operator must supply a reason (max 500 chars; SOX-grade audit trail).

Idempotent: re-running for the same (entity_id, fiscal_year) returns the existing reversal JE without posting a duplicate. The partial UNIQUE index on (entity_id, idempotency_key) provides race safety.

Idempotency key: fiscal_year_reopen:<entity_id>:<fiscal_year>

Effect: Retained Earnings (account 3000) decrements by the original net income amount (or increments back by the original net loss). The getBalanceSheet hybrid reader will reflect the reversal automatically on the next call.

Audit: every reopen writes an activity_log row with action='fiscal_year_reopened', the operator’s reason, the original_je_id, and the reversal_je_id. Broadcasts fiscal_year.reopened so downstream caches (balance sheet, AR statement footer, customer portal balance) invalidate.

High-power operation: uses the same accounting:close_period scope as the forward close. Operator-triggered only; never auto-fired.

POST

fiscal-periods

{id}

reopen-fiscal-year

Reopen a previously closed fiscal year (prior-period adjustment)

curl --request POST \
  --url https://api.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fiscal_year": 2024,
  "reason": "Prior-period adjustment: vendor invoice for FY2024 received in FY2025"
}
'

import requests

url = "https://api.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year"

payload = {
    "fiscal_year": 2024,
    "reason": "Prior-period adjustment: vendor invoice for FY2024 received in FY2025"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    fiscal_year: 2024,
    reason: 'Prior-period adjustment: vendor invoice for FY2024 received in FY2025'
  })
};

fetch('https://api.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year', 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.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year",
  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([
    'fiscal_year' => 2024,
    'reason' => 'Prior-period adjustment: vendor invoice for FY2024 received in FY2025'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year"

	payload := strings.NewReader("{\n  \"fiscal_year\": 2024,\n  \"reason\": \"Prior-period adjustment: vendor invoice for FY2024 received in FY2025\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fiscal_year\": 2024,\n  \"reason\": \"Prior-period adjustment: vendor invoice for FY2024 received in FY2025\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.arcuserp.com/v1/fiscal-periods/{id}/reopen-fiscal-year")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fiscal_year\": 2024,\n  \"reason\": \"Prior-period adjustment: vendor invoice for FY2024 received in FY2025\"\n}"

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

{
  "data": {
    "reversal_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "original_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "fiscal_year": 123,
    "period_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "period_status": "closed",
    "balanced": true,
    "idempotent": true
  }
}

{
  "error": "fiscal_year_not_closed",
  "code": "fiscal_year_not_closed",
  "hint": "<string>"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

{
  "error": "no_closing_je_found",
  "code": "no_closing_je_found",
  "hint": "<string>",
  "reversal_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "not_found",
  "code": "not_found",
  "type": "not_found",
  "hint": "The requested order does not exist or does not belong to this entity.",
  "param": "expand[0]",
  "required": "accounts:read",
  "request_id": "req_abc123"
}

Authorizations

Authorization

string

header

required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity via Settings > Developers > API Keys.

Path Parameters

string<uuid>

required

UUID of the year-end accounting period (used for URL consistency with the close-fiscal-year triplet; entity_id and fiscal_year are inferred from auth + request body).

Body

application/json

fiscal_year

integer

required

Fiscal year to reopen (e.g. 2024). Must be currently in year_end_closed status.

Example:

2024

reason

string

required

Operator-supplied justification for the reopen (SOX-grade audit trail; required).

Maximum string length: 500

Example:

"Prior-period adjustment: vendor invoice for FY2024 received in FY2025"

Response

Fiscal year reopened (or idempotent return of existing reversal JE)

data

object

Show child attributes

Close a fiscal year (accounting_periods alias)Reopen a fiscal year (alias)

Overview

All Endpoints

Reopen a previously closed fiscal year (prior-period adjustment)

Authorizations

Path Parameters

Body

Response