One sales invoice or customer credit note

GET

/receivables/invoices/{id}

const url = 'https://example.com/v1/receivables/invoices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/v1/receivables/invoices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

With its lines, allocations, outstanding balance and workflow state. Requires receivables.invoice.read.

Authorizations

bearerAuth
apiKeyAuth

Parameters

Path Parameters

required

string format: uuid

Responses

200

The document

application/json

object

buyer

required

Frozen when issued; null on a draft.

object

address

required

object

city

string

line1

string

line2

string

postcode

string

state

string

country_code

required

string

nullable

email

required

string

nullable

name

required

string

phone

required

string

nullable

registration_no

required

string

nullable

registration_type

required

string

nullable

sst_no

required

string

nullable

tin

required

string

nullable

created_at

required

string format: date-time

currency

required

string

custom_fields

The organization’s user-defined field values by key (GET /org/custom-fields); {} when none.

object

key

additional properties

string

customer_id

required

string format: uuid

customer_reference

required

string

due_on

required

string format: date

fx_rate

required

A decimal rate or percentage as a string, up to 10 places. Never a JSON number.

string

gross_amount

required

A decimal amount as a string. Never a JSON number.

string

gross_base

required

A decimal amount as a string. Never a JSON number.

string

required

string format: uuid

invoice_date

required

string format: date

is_group_transaction

required

True when the party is currently mapped to a company of the organization’s group, so a consolidation run eliminates the dealing. Derived from the party map at read time, never stored on the transaction.

boolean

is_opening

Brought in by a data migration (import M5)

boolean

issued_at

required

string format: date-time

nullable

kind

required

string

Allowed values: sales_invoice customer_credit_note customer_debit_note

legacy_reference

The previous system’s number

string

nullable

lines

required

Array<object>

object

account_id

required

string format: uuid

classification_code

required

string

description

required

string

discount_amount

required

A decimal amount as a string. Never a JSON number.

string

required

string format: uuid

line_no

required

integer

net_amount

required

A decimal amount as a string. Never a JSON number.

string

net_base

required

A decimal amount as a string. Never a JSON number.

string

quantity

required

A decimal rate or percentage as a string, up to 10 places. Never a JSON number.

string

shares

required

Array<object>

object

analytic_account_id

required

string format: uuid

percentage

required

A decimal rate or percentage as a string, up to 10 places. Never a JSON number.

string

tax_amount

required

A decimal amount as a string. Never a JSON number.

string

tax_base

required

A decimal amount as a string. Never a JSON number.

string

tax_code

required

The tax code as it read when the line was priced.

string

tax_code_id

required

string format: uuid

tax_exemption_reason

required

string

nullable

tax_pack_kind

required

string

tax_rate

required

A decimal rate or percentage as a string, up to 10 places. Never a JSON number.

string

trade_line_id

required

A delivery line (an invoice) or sales return line (a credit note) of this customer; quantity is then in base units (O3.2).

string format: uuid

nullable

unit_code

required

string

nullable

unit_price

required

A decimal amount as a string. Never a JSON number.

string

multiple_projects

required

True when the lines charge two or more distinct projects.

boolean

net_total

required

A decimal amount as a string. Never a JSON number.

string

original_invoice_id

required

string format: uuid

nullable

original_total

An opening document’s original total, for reference; gross_amount is what was outstanding at the cut-over.

string

outstanding

required

Gross less allocations (a credit note - what it has left).

string

payment_terms_days

required

integer

prepared_by

required

string format: uuid

project

required

The project every project-charged line shares; null when none or when several (see multiple_projects).

object

code

required

string

required

string format: uuid

name

required

string

reason

required

string

nullable

reference

required

Null on a draft; numbered when issued (R2).

string

nullable

revision

required

integer

seller

required

Frozen when issued; null on a draft.

object

address

required

string

nullable

msic

required

string

nullable

name

required

string

registration_no

required

string

nullable

sst_no

required

string

nullable

tin

required

string

nullable

semantic

required

string

Allowed values: draft pending accrual payout acknowledged dispute rejected cancelled custom committed effect

state

required

string

tax_total

required

A decimal amount as a string. Never a JSON number.

string

allocations

required

Array<object>

object

amount

required

A decimal amount as a string. Never a JSON number.

string

base_amount

required

A decimal amount as a string. Never a JSON number.

string

created_at

required

string format: date-time

created_by

required

string format: uuid

credit_note_id

required

string format: uuid

nullable

currency

required

string

effective_on

required

string format: date

required

string format: uuid

invoice_id

required

string format: uuid

receipt_id

required

string format: uuid

nullable

reversed_by_id

required

string format: uuid

nullable

reverses_id

required

string format: uuid

nullable

source_kind

required

string

Allowed values: receipt credit_note

attachment_ids

required

Documents attached to the record, oldest first; readers are whoever may read the record.

Array<string>

available_transitions

required

Array<object>

object

action_key

required

string

allowed

required

boolean

gate

required

string

Allowed values: reporter target source advance

labels

required

Locale to text. “en” is required; keys are supported UI locales.

object

key

additional properties

string

<= 200 characters

refusal

object

code

required

Not_reporter, no_band_covers_amount, not_in_band, self_approval, dispute_raiser or already_signed (a sign-off step, when the actor has already signed everything they may).

string

detail

required

string

gaps

Array<object>

Reason is one of member_inactive, position_retired, vacant, no_primary_position, no_unit_head, above_root, only_the_claimant, no_band_covers_amount, unallocated (part of the amount carries no account on the step’s axis) or no_account_approver (the account, and every ancestor, has no approver).

object

analytic_account_id

string format: uuid

axis_id

string format: uuid

grant_id

required

string format: uuid

member_id

string format: uuid

position_id

string format: uuid

reason

required

string

requires_reason

required

boolean

signs

The shares this edge lets the actor sign, on a sign-off step.

Array<object>

object

account_code

required

string

account_name

required

string

amount

required

A decimal amount as a string. Never a JSON number.

string

analytic_account_id

required

string format: uuid

axis_id

required

string format: uuid

sole_owner_exception

Allowed only as the sole-owner exception (Ruling O-3a): the organization’s one active member deciding their own sales document. requires_reason is then true, and the decision is recorded with authority_via sole_owner_exception. The reason is English or Bahasa Malaysia, at most 500 characters (422 field=reason otherwise); a blank one is refused with 422 sole_owner_reason_required.

boolean

required

string

outstanding

required

Gross less allocations (a credit note - what it has left).

string

outstanding_base

required

A decimal amount as a string. Never a JSON number.

string

timeline

required

Array<object>

object

action_key

required

string

actor_member_id

required

string format: uuid

decided_at

required

string format: date-time

from

required

string

reason

required

string

required

string

Example

{
  "fx_rate": "4.2000000000",
  "gross_amount": "1234.5600",
  "gross_base": "1234.5600",
  "kind": "sales_invoice",
  "lines": [
    {
      "discount_amount": "1234.5600",
      "net_amount": "1234.5600",
      "net_base": "1234.5600",
      "quantity": "4.2000000000",
      "shares": [
        {
          "percentage": "4.2000000000"
        }
      ],
      "tax_amount": "1234.5600",
      "tax_base": "1234.5600",
      "tax_rate": "4.2000000000",
      "unit_price": "1234.5600"
    }
  ],
  "net_total": "1234.5600",
  "original_total": "1234.5600",
  "outstanding": "1234.5600",
  "semantic": "draft",
  "tax_total": "1234.5600",
  "allocations": [
    {
      "amount": "1234.5600",
      "base_amount": "1234.5600",
      "source_kind": "receipt"
    }
  ],
  "available_transitions": [
    {
      "gate": "reporter",
      "signs": [
        {
          "amount": "1234.5600"
        }
      ]
    }
  ],
  "outstanding_base": "1234.5600"
}

Headers

ETag

string

The record’s revision, quoted.

401

Not authenticated, or the session is no longer valid.

application/problem+json

object

code

A stable refusal code the client branches on, where the status alone is not enough: owner_role_manage_required and self_lockout on the role editor’s 409s; revision_mismatch (a stale If-Match) and document_bound_elsewhere (the document backs another record) on an expense claim’s 409s.

string

detail

string

instance

string

status

required

integer

title

required

string

type

required

string

Example ^generated

{
  "code": "example",
  "detail": "example",
  "instance": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

The caller does not hold the permission this operation requires.

application/problem+json

object

code

string

detail

string

instance

string

status

required

integer

title

required

string

type

required

string

Example ^generated

{
  "code": "example",
  "detail": "example",
  "instance": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

404

No such record in this organization.

application/problem+json

object

code

string

detail

string

instance

string

status

required

integer

title

required

string

type

required

string

Example ^generated

{
  "code": "example",
  "detail": "example",
  "instance": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

429

A rate limit was reached: per API key, per organization across its keys, or per source address for repeated failed key authentication. Retry after the number of seconds in Retry-After. Every answer on a key carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.

application/problem+json

object

code

string

detail

string

instance

string

status

required

integer

title

required

string

type

required

string

Example ^generated

{
  "code": "example",
  "detail": "example",
  "instance": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

Headers

Retry-After

integer

Seconds until a retry may succeed.

One sales invoice or customer credit note

Authorizations

Parameters

Path Parameters

Responses

200

Example

Headers

401

Example generated

403

Example generated

404

Example generated

429

Example generated

Headers

Example ^generated

Example ^generated

Example ^generated

Example ^generated