Taiwan

Additional considerations for Taiwan

Invoice cancellation

Taiwan does not support Credit notes in the traditional sense, and the calls will act more like invoice cancellations (C0503) for full credit or allowance (D0403) for partial credit. Therefore, a cancellation reason needs to be sent along with the generic credit note fields.


Changes to generic fields

  • invoiceRefs is required
  • customInfo.twn.isAllowance is required
  • customInfo.twn.reason is required.
type CreditNote {
  // ...all generic credit note fields
  recipient: {
    // ...everything from invoice.recipient
    contact: {
      email?: string;
      }
  }
  lines: [
    { 
      // ..other line item fields
      vat: {
          code: string;
      }
    }
  ];

  customInfo: {
    twn: {
      reason: string;
      isAllowance: boolean;

    }
  }
}

Field information

NameTypeRequiredDescription
lines[].vat.codestringConditionalA value from an enumerated list as specified on Taiwan VAT code list
customInfo.twn.reasonstringYesReason for cancellation.
customInfo.twn.isAllowancebooleanYesIndicate whether credit note is an allowance or cancelation.
recipient.contact.emailstringConditionalEmail of the recipient. Required for cross-border transactions

Example CSV file

Example of a cross border credit note allowance.

Credit note - Taiwan.csv