lago_id
string
required

The credit note unique identifier, created by Lago.

sequential_id
integer
required

The sequential identifier of the credit note, specifically scoped on the associated invoice. It provides a unique numerical identifier for the credit note within the context of the invoice.

number
string
required

The credit note unique number.

lago_invoice_id
string
required

Unique identifier assigned to the invoice that the credit note belongs to

invoice_number
string
required

The invoice unique number, related to the credit note.

issuing_date
string
required

The date of creation of the credit note. It follows the ISO 8601 date format and provides the specific date when the credit note was created.

reason
enum<string>
required

The reason of the credit note creation. Possible values are duplicated_charge, product_unsatisfactory, order_change, order_cancellation, fraudulent_charge or other.

Available options:
duplicated_charge,
product_unsatisfactory,
order_change,
order_cancellation,
fraudulent_charge,
other
currency
enum<string>
required

The currency of the credit note.

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLF,
CLP,
CNY,
COP,
CRC,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
ISK,
JMD,
JPY,
KES,
KGS,
KHR,
KMF,
KRW,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRO,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
STD,
SZL,
THB,
TJS,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VND,
VUV,
WST,
XAF,
XCD,
XOF,
XPF,
YER,
ZAR,
ZMW
total_amount_cents
integer
required

The total amount of the credit note, expressed in cents.

taxes_amount_cents
integer
required

The tax amount of the credit note, expressed in cents.

taxes_rate
number
required

The tax rate associated with this specific credit note.

sub_total_excluding_taxes_amount_cents
integer
required

The subtotal of the credit note excluding any applicable taxes, expressed in cents.

balance_amount_cents
integer
required

The remaining credit note amount, expressed in cents.

credit_amount_cents
integer
required

The credited amount of the credit note, expressed in cents.

refund_amount_cents
integer
required

The refunded amount of the credit note, expressed in cents.

coupons_adjustment_amount_cents
integer
required

The pro-rated amount of the coupons applied to the source invoice.

created_at
string
required

The date when the credit note was created. It is expressed in Coordinated Universal Time (UTC).

updated_at
string
required

The date when the credit note was last updated. It is expressed in Coordinated Universal Time (UTC).

credit_status
enum<string> | null

The status of the credit portion of the credit note. It indicates the current state or condition of the credit amount associated with the credit note. The possible values for this field are:

  • available: this status indicates that an amount remains available for future usage. The credit can be applied towards future transactions or invoices.
  • consumed: this status indicates that the credit amount has been fully consumed. The remaining amount is 0, indicating that the credit has been utilized in its entirety.
  • voided: this status indicates that the remaining amount of the credit cannot be used any further. The credit has been voided and is no longer available for application or redemption.
Available options:
available,
consumed,
voided
refund_status
enum<string> | null

The status of the refund portion of the credit note. It indicates the current state or condition of the refund associated with the credit note. The possible values for this field are:

  • pending: this status indicates that the refund is pending execution. The refund request has been initiated but has not been processed or completed yet.
  • succeeded: this status indicates that the refund has been successfully executed. The refund amount has been processed and returned to the customer or the designated recipient.
  • failed: this status indicates that the refund failed to execute. The refund request encountered an error or unsuccessful processing, and the refund amount could not be returned.
Available options:
pending,
succeeded,
failed
description
string | null

The description of the credit note.

file_url
string | null

The PDF file of the credit note.

items
object[]

Array of credit note's items.

applied_taxes
object[]