Schemas
Schemas definidos
Códigos de Schemas
Shinkansen usa distintos esquemas para identificar entidades (ej: personas naturales, instituciones financieras) o para determinar los valores posibles de una enumeración (ej: monedas, países, estado de una transacción).
Cuándo se debe explicitar un esquema.
Para entidades que pueden ser identificadas por múltiples esquemas, el esquema debe ser explícito. Por ej, el Banco BICE en Chile puede ser identificado por:
{
"fin_id_schema": "SHINKANSEN",
"fin_id": "BANCO_BICE_CL"
}
O también podría ser identificado por:
{
"fin_id_schema": "CLCMF",
"fin_id": "028"
}
Siempre usa el schema
SHINKANSENen los campos en que está disponibleNo todos los actores de la red soportan todos los esquemas. Pero todos los actores deben soportar el schema
SHINKANSEN. Por ende para mayor compatibilidad debes usar el schemaSHINKANSENsiempre que esté disponible (por ejemplo para identificar bancos e instituciones financieras).(Como usamos firmas digitales, no podemos traducir de un esquema a otro al re-enviar tus mensajes a otros actores de la red).
Esquemas implícitos
Por otro lado, hay campos que tienen un único posible esquema (o uno que se asume por defecto). Esto es típico cuando hay un estándar globalmente aceptado, como por ej:
"currency": "CLP"
O también cuando la lista de posibles valores es definida por Shinkansen:
"shinkansen_transaction_status": "error"
La siguiente lista incluye todos los esquemas usados por Shinkansen y el contexto en que se usa (sea un campo específico o un tipo de entidad)
Schemas
Globales
| Contexto | Schema | Descripción |
|---|---|---|
Institución Financiera (fin_id_schema) | SHINKANSEN | Identifica a entidades participantes de una transacción o que envían/reciben mensajes en Shinkansen |
Campo account_type | SHINKANSEN_ACCOUNT_TYPE | Valores posibles para un tipo de cuenta |
Campo transaction_type | SHINKANSEN_TRANSACTION_TYPE | Valores posibles para el tipo de transacción |
Campo currency | SHINKANSEN_CURRENCY | Valores posibles para monedas |
Campo shinkansen_transaction_status | SHINKANSEN_TRANSACTION_STATUS | Valores posibles para el estado de una transacción |
Campo response_status | SHINKANSEN_RESPONSE_STATUS | Valores posibles para el estado de una respuesta |
Chile 🇨🇱
| Contexto | Schema | Descripción |
|---|---|---|
Institución Financiera (fin_id_schema) | CLCMF | Identifica a una entidad financiera en base a su código en la CMF (también conocido como 'código SBIF') |
Persona natural o jurídica (id_schema) | CLID | Identifica a una persona natural o jurídica utilizando el identificador único tributario chileno (RUT) |
Colombia 🇨🇴
| Contexto | Schema | Descripción |
|---|---|---|
Persona natural (id_schema) | COCC | Cédula de Ciudadanía |
Persona natural (id_schema) | COTI | Tarjeta de Identidad |
Persona natural (id_schema) | CONUIP | Número Único de Identidad Personal |
Persona natural (id_schema) | COCE | Cédula de Extranjería |
Persona natural (id_schema) | PASS | Pasaporte (extranjeros) |
Persona jurídica (id_schema) | CONIT | Número de Identidad Tributaria (empresas) |
México 🇲🇽
| Contexto | Schema | Descripción |
|---|---|---|
Persona física o moral (id_schema) | MXRFC | RFC (Registro Federal de Contribuyentes) de la persona u organización |
Persona física (id_schema) | MXCURP | CURP (Clave Única de Registro de Población) |
Perú 🇵🇪
| Contexto | Schema | Descripción |
|---|---|---|
Persona física (id_schema) | PEDNI | DNI (Documento Nacional de Identidad) de la persona |
Persona física o jurídica (id_schema) | PERUC | RUC (Registro Único de Contribuyentes) identifica a una persona natural o jurídica como contribuyente |
Persona físca (id_schema) | PECEX | CEX (Carnet de Extranjería) identifica a un extranjero residente en Perú |
Updated 11 months ago