South Korea

Invoice

Changes to generic fields

ref has a 24-character limit.
recipient.taxId must be 9999999999999 for foreigner (non-domestic) transactions.
recipient.customInfo.kor.representativeName is required.

type Invoice {
  // ...all generic invoice fields
  notes?: string;
  lines: [
    {
      // ...other line item fields
      customInfo?: {
        kor?: {
          purchaseDT?: string;
          spec?: string;
          note?: string;
        };
      };
    }
  ];
  recipient: {
    // ...other recipient fields
    customInfo?: {
      kor?: {
        type?: string;
        taxRegID?: string;
        representativeName: string;
      };
    };
  };
  customInfo?: {
    kor?: {
      emailSubject?: string;
      taxType?: string;
      purposeType?: string;
      serialNum?: string;
      foreignRemark?; string;
    };
  };
}

South Korea-specific fields

Name	Type	Required	Description
`notes`	string	No	Any applicable or additional notes
`customInfo.kor.emailSubject`	string	No	Title of the notification mail sent to the customer
`customInfo.kor.taxType`	string	No	Tax type classification. Valid values: S \| Standard Z \| Zero rated E \| Exempt
`customInfo.kor.purposeType`	string	No	Payment status. Valid values: Receipt (Payment received) Charge (Payment not received) None Note: If not provided it will default to None
`customInfo.kor.serialNum`	string	No	Serial number for document management
`customInfo.kor.foreignRemark`	string	Conditional	Foreign entity identification data such as a foreign registration number or passport number. Note: Required for foreign (non-domestic) transactions.
`lines[].customInfo.kor.purchaseDT`	string	No	Date of preparation or purchase. Format: `yyyyMMdd`
`lines[].customInfo.kor.spec`	string	No	Specification of the line item
`lines[].customInfo.kor.note`	string	No	Remark for the line item
`recipient.customInfo.kor.type`	string	No	Buyer type. Valid values: Company \| 1 Individual \| 2 Foreigner \| 3
`recipient.customInfo.kor.taxRegID`	string	No	Identification number for minor place of business (4 digits).
`recipient.customInfo.kor.representativeName`	string	Yes	Name of the representative (CEO Name)