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.
customInfo.sau.creditReason is required.
customInfo.sau.paymentMeans.code 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;
      creditReason: string;
      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	No	State/County/Province/Region
`recipient.address.country`	string	Yes	Three-letter country code (ISO 3166-1 alpha-3 ).
`recipient.address.postalCode`	string	No	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	No	Document note
`customInfo.sau.creditReason`	string	Yes	Textual reason for crediting the invoice.

Example CSV file

Credit note - Saudi Arabia.csv