User Guide

TIN Validation System - CRS-CIAT

This guide is intended for authorized users only.

Previous Guides: Access Guide

Quick Navigation

• Getting Started
• Validation Process
• FAQ

Getting Started

How does Tin Validator Work

• Cloud based system managed by Ciat
• Countries can enroll to use the system by following the defined process.
• The countries can validate batches of Tins using an API endpoint or a Web interface.

How Does Security Work

• API security is based on Oauth2 with Self Signed Certificates
• Web security is based on login and secure password.

Who can access the System

• Country Administration user, for managing users, upload public certificate, defining url API endpoints.
• API users (based on token access), for validating batchs of Tins.
• Web users, for validating individual Tins, batch of Tins, and view validation results.
• Ciat Administrator, for system administration and configuration tasks, also for viewing statistics.

Validation Process

Step-by-Step Guide

TIN Batch Processing Flow:

1. Batch Submission

   • User sends a batch file containing TINs for validation
   • Available submission methods:
     • Web portal
     • System API

2. Initial File Validation

   • System verifies:
     • ✅ File structure
     • ✅ Basic format rules
     • ✅ Registered destination countries
   • Possible outcomes:
     • ❌ If fails: Batch rejected with specific errors
     • ✅ If passes: Batch accepted and stored for processing

3. Processing Decision

   • Based on batch size (threshold defined by CIAT):
     • Immediate Processing: Small batches
     • Deferred Processing: Large batches

4. Validation Processing

   • Each TIN record is validated individually
   • Rules applied based on relationship between:
     • Requesting country (origin)
     • TIN country (destination)
   • Each validation result is stored in the database

5. Response Generation

   • For deferred processing:
     • Response constructed and stored
     • Available for later retrieval
   • For online processing:
     • Response sent immediately in the original request

Frequently Asked Questions

What File Formats are supported?

The system supports XML, JSON and csv

How long does validation take?

Typical validation time is 0.2-0.3 seconds per TIN. Batch processing of 1000 TINs usually completes within 3-4 minutes. As Level 2 and 3 validation depends on provider countries, the response time may vary.

For more detailed guides, please login and access role-specific documentation.