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 SHINKANSEN en los campos en que está disponible

No 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 schema SHINKANSEN siempre 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

ContextoSchemaDescripción
Institución Financiera (fin_id_schema)SHINKANSENIdentifica a entidades participantes de una transacción o que envían/reciben mensajes en Shinkansen
Campo account_typeSHINKANSEN_ACCOUNT_TYPEValores posibles para un tipo de cuenta
Campo transaction_typeSHINKANSEN_TRANSACTION_TYPEValores posibles para el tipo de transacción
Campo currencySHINKANSEN_CURRENCYValores posibles para monedas
Campo shinkansen_transaction_statusSHINKANSEN_TRANSACTION_STATUSValores posibles para el estado de una transacción
Campo response_statusSHINKANSEN_RESPONSE_STATUSValores posibles para el estado de una respuesta

Chile 🇨🇱

ContextoSchemaDescripción
Institución Financiera (fin_id_schema)CLCMFIdentifica 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)CLIDIdentifica a una persona natural o jurídica utilizando el identificador único tributario chileno (RUT)

Colombia 🇨🇴

ContextoSchemaDescripción
Persona natural (id_schema)COCCCédula de Ciudadanía
Persona natural (id_schema)COTITarjeta de Identidad
Persona natural (id_schema)CONUIPNúmero Único de Identidad Personal
Persona natural (id_schema)COCECédula de Extranjería
Persona natural (id_schema)PASSPasaporte (extranjeros)
Persona jurídica (id_schema)CONITNúmero de Identidad Tributaria (empresas)

México 🇲🇽

ContextoSchemaDescripción
Persona física o moral (id_schema)MXRFCRFC (Registro Federal de Contribuyentes) de la persona u organización
Persona física (id_schema)MXCURPCURP (Clave Única de Registro de Población)

Perú 🇵🇪

ContextoSchemaDescripción
Persona física (id_schema)PEDNIDNI (Documento Nacional de Identidad) de la persona
Persona física o jurídica (id_schema)PERUCRUC (Registro Único de Contribuyentes) identifica a una persona natural o jurídica como contribuyente
Persona físca (id_schema)PECEXCEX (Carnet de Extranjería) identifica a un extranjero residente en Perú