Saudi Arabia

Credit Note

Changes to generic fields

  • lines[].itemCode is required
  • recipient.address.line1 is required.
  • recipient.address.city is required.
  • recipient.address.state is required.
  • recipient.address.country is required.
  • recipient.address.postalCode is required.
type CreditNote {
  // ...all generic credit note fields
  invoiceRefs: string[],
  lines: [
    { 
      // ..other line item fields
      itemCode: string;
      vat: {
          code: TaxCode;
          exemptReason?: string;
          exemptReasonCode?: RomaniaExemptionReasonCodes;
      }
    }
  ];
  recipient: {
    // ...everything from invoice.recipient,
  },
  customInfo?: {
    sau?: {
      translate?: boolean;
      paymentMeans:{
        code: PaymentMeansCode;
        note: string;
      }
    }
  }
};

Field information

Name

Type

Required

Description

invoiceRefs

string

Yes

An array of existing invoices

lines[].itemCode

string

Yes

Unique line item code

lines[].vat.code

string

Yes

A value from an enumerated list of types:
"S": Standard rate
"Z": Zero rated
"E": Exempt
"O": Outside of scope

lines[].vat.exemptReason

string

Conditional

If the line VAT amount is 0, an exemption reason is required.

lines[].vat.exemptReasonCode

string

Conditional

A value from an enumerated list outlined in the Saudi Arabia exempt reason codes

recipient.address.line1

string

Yes

Address line 1 (Street address/PO Box/Company name).

recipient.address.city

string

Yes

City/District/Suburb/Town/Village

recipient.address.state

string

Yes

State/County/Province/Region

recipient.address.country

string

Yes

Three-letter country code (ISO 3166-1 alpha-3 ).

recipient.address.postalCode

string

Yes

ZIP or postal code

customInfo.sau.translate

boolean

No

Translates invoice to Arabic

customInfo.sau.paymentMeans.code

string

Yes

A value from an enumerated list as outlined on Payment Means.

customInfo.sau.paymentMeans.note

string

Yes

Document note


Example CSV file

Credit note - Saudi Arabia.csv