uscc-utils

Utils about unified social credit code(统一社会信用代码工具方法).

Install

npm i uscc-utils

yarn add uscc-utils

pnpm add uscc-utils

Usage

import { parseUSCC, validateUSCC } from 'uscc-utils'

const code = '91110108551385082Q' // 小米科技有限责任公司

validateUSCC(code) // true

parseUSCC(code) // { isValid: true, category: '工商', type: '企业' }

API

validateUSCC

Check if the given code match the uscc pattern.

Type definition:

interface ValidateOptions {
  normalize?: boolean
}

function validateUSCC(code: string, options?: ValidateOptions): boolean

explainUSCC

Return detailed validation result.

Type definition:

type USCCValidationErrorCode =
  | 'INVALID_LENGTH'
  | 'INVALID_PATTERN'
  | 'INVALID_CHECKSUM'

interface ValidateUSCCResult {
  normalizedCode: string
  isValid: boolean
  errorCode?: USCCValidationErrorCode
}

function explainUSCC(
  code: string,
  options?: ValidateOptions,
): ValidateUSCCResult

splitUSCC

Split valid uscc to structural parts.

Type definition:

interface USCCParts {
  registrationAuthorityCode: string
  entityTypeCode: string
  regionCode: string
  organizationCode: string
  checkChar: string
}

function splitUSCC(code: string, options?: ValidateOptions): USCCParts | null

parseUSCC

Parse the given uscc.

Type definition:

interface ParseOptions {
  unknownCategory?: string
  unknownType?: string
  normalize?: boolean
}

interface ParseResult {
  isValid: boolean
  category: string
  type: string
}

function parseUSCC(code: string, options?: ParseOptions): ParseResult

Credits

• GB 32100-2015 法人和其他组织统一社会信用代码编码规则 - 维基文库
• 国务院关于批转发展改革委等部门法人和其他组织统一社会信用代码制度建设总体方案的通知 - 国发〔2015〕33 号

License

MIT License © 2022-PRESENT ntnyq