VI DLT Platform Error Codes List

The DLT (Distributed Ledger Technology) error codes for the Vodafone Idea (Vi) platform (VILPOWER) are the standardized set of universal DLT codes used across all Indian mobile network operators. These codes are primarily in the 6XX series and denote failures during the mandatory DLT scrubbing process.
Vi's documentation often explicitly mentions the meaning of these standard codes, sometimes adding a specific internal marker like {VI:I} to denote an inactive status on their platform.


Vodafone Idea (Vi) DLT Scrubbing Error Codes (6XX Series)

These codes indicate precisely where the compliance failure occurred (Entity, Telemarketer, Header, or Template).


1. Entity (Principal Entity - PE) Related Errors (600-609)

Error Code Status Name Description / Meaning
600ENTITY_NOT_FOUNDNo record found with the Entity ID (EID).
601ENTITY_NOT_REGISTEREDNo entry of the Entity on the platform.
602ENTITY_INACTIVEEntity is inactive on the platform (e.g., {VI:I}).
603ENTITY_BLACKLISTEDEntity is blacklisted on all platforms.
604INVALID_ENTITY_IDReceived a wrong Entity ID format or no tag.
605ENTITY_ID_NOT_ALLOWED_FOR_TMThe Principal Entity is not allowed for the associated Telemarketer.
606 – 609ENTITY_RESERVEDReserved for future use.

2. Header (Sender ID) Errors (620-629)

Error Code Status Name Description / Meaning
620HEADER_NOT_FOUNDNo record found with the Header (case sensitive).
621HEADER_INACTIVEHeader is inactive on the platform (e.g., {VI:I}).
622HEADER_BLACKLISTEDHeader is blacklisted on all platforms.
623PEID_NOT_MATCHED_WITH_HEADERThe Principal Entity ID does not match the Header ID (linkage failure).
624HEADER_SUSPENDED_DUE_TO_VALIDITYHeader is suspended after its validity period expired.
625HEADER_SUSPENDED_DUE_TO_USAGEHeader is suspended due to non-usage.

3. Template & Content Errors (630-649)

Error Code Status Name Description / Meaning
630TEMPLATE_NOT_FOUNDNo record found with the Template ID.
631TEMPLATE_INACTIVETemplate is inactive on the platform (e.g., {VI:I}).
633TEMPLATE_NOT_MATCHEDThe submitted message content does not exactly match the registered DLT template.
634HEADER_NOT_REGISTERED_FOR_TEMPLATEThe Header is not registered (linked) for use with the specific Template ID.
635TEMPLATE_VARIABLE_EXCEEDED_MAX_LENGTHThe value in a variable exceeded the max configured length (usually 30 characters).
637INVALID_TEMPLATE_IDReceived wrong Template ID format or no tag.
642CTA_NOT_WHITELISTEDTemplate scrubbing failed due to a non-whitelisted Call-to-Action (CTA).

4. Preference (DND) and General Errors (650-670)

Error Code Status Name Description / Meaning
650PREFERENCE_NOT_MATCHEDMessage blocked due to recipient DND/preference settings.
651INVALID_PROMO_TIMEPromotional message blocked during restricted hours (9 PM to 10 AM).
652SE_CATEGORY_BLOCKService Explicit category blocked on fully DND, if explicit consent is unavailable.
660CONSENT_FAILEDGeneral error code for Consent issue.
670SCRUBBING_FAILEDGeneral error code for any exceptions during the scrubbing process.

Vi-Specific DLT Linkage & Mapping Codes

Error Code Status Name Description / Meaning
5101BLOCKED_BY_DLTGeneral message block due to DLT scrubbing (Similar to 650).
5201If Header not activeThe Sender ID is inactive (Similar to 621).
5307Content not matchedThe message content failed the template match (Similar to 633).
5401COMM/HEADER MismatchTransactional/Service message submitted with an Inactive/Blacklisted Header.
5501Consent Not in DBExplicit consent record for the message is missing.

If you are troubleshooting a failed message, focusing on codes 602, 623, 633, 634, and 650 will resolve the vast majority of DLT failures.