mollemoll / tax-ids Goto Github PK

Expose a public syntax validation that can be used without creating/verifying any TaxIds.

Need a validator and verifier to enable verification of CH VATs

CH VAT Syntax

CH VATs can take different formatting variations. They start with CHE, followed by 9 digits and an optional suffix describing the regional part of Switzerland (MWST, IVA or TVA).

Format examples:

CHE123456789
CHE123456789 MWST
CHE-123.456.789
CHE-123.456.789 MWST

Stripe
Alavara

BFS Lookup:

Does not accept CHE123456789MWST (without a whitespace before MWST)
Errors
According to Google Translate and the [Spécifications Webservice Interface 5.0 PDF](Spécifications Webservice
Interface 5.0) the ValidateVatNumber operation can only return two errors:

• Data_validation_failed
• Request_limit_exceeded

Sources

Lookup:
BFS UIDs
BFS SOAP API

Checksum details (weight and mod):
Details on checksum
PDF with checksum weights

Both VIES and HMRC accept incoming requests that include requester info, ie who's performing the lookup.

Look into whether it could be worth adding caching

Add checksum control for tax ids that support it to avoid unnecessary calls to already strained APIs.

Need a validator and verifier to lookup the legitimacy of NO VATs

Need a verifier for HMRC to enable verification of GBVats

Some stuff should be configurable.

The VIES service can reply with several fault codes. Right now they all lead to VerificationStatus Unavailable. However, it would be nice to forward the VIES fault within the Unavailable status in case the user can act upon it.

Here are the codes.

#[derive(Debug)]
pub enum VIESFault {
    ServiceUnavailable,
    MemberStateUnavailable,
    InvalidRequester,
    Timeout,
    BlockedError,
    RateLimitError,
}

lazy_static! {
    pub static ref VIES_FAULT: HashMap<&'static str, VIESFault> = {
        let mut m = HashMap::new();
        m.insert("SERVICE_UNAVAILABLE", VIESFault::ServiceUnavailable);
        m.insert("MS_UNAVAILABLE", VIESFault::MemberStateUnavailable);
        m.insert("INVALID_REQUESTER_INFO", VIESFault::InvalidRequester);
        m.insert("TIMEOUT", VIESFault::Timeout);
        m.insert("VAT_BLOCKED", VIESFault::BlockedError);
        m.insert("IP_BLOCKED", VIESFault::BlockedError);
        m.insert("GLOBAL_MAX_CONCURRENT_REQ", VIESFault::RateLimitError);
        m.insert("GLOBAL_MAX_CONCURRENT_REQ_TIME", VIESFault::RateLimitError);
        m.insert("MS_MAX_CONCURRENT_REQ", VIESFault::RateLimitError);
        m.insert("MS_MAX_CONCURRENT_REQ_TIME", VIESFault::RateLimitError);
        m
    };
}