Integraciones — importar inscripciones y exportar resultados

Para integradores y sistemas externos: hoy la integración es por archivo y por el portal. Las inscripciones entran al sistema por CSV, los resultados salen en formato WinMSS — el estándar de los programas de apuración IPSC — y, al finalizar el Match, Orbit publica la clasificación en el portal scoring.services (origen Orbit). Ningún paso exige acceso técnico: todo ocurre en la pantalla del Match.

1. Importar inscripciones (CSV)

El sistema de origen (inscripción propia del club, planilla, otro software) exporta un CSV y el staff de la prueba lo importa en Inscripciones → Importar CSV. Antes de guardar nada, el sistema muestra una vista previa con lo que será creado, actualizado o rechazado — solo después de la confirmación las inscripciones entran a la prueba.

Reglas del archivo

• Separador punto y coma (;), codificación UTF-8 (se acepta el BOM de Excel).
• La primera línea es el encabezado, con el nombre de las columnas. El orden de las columnas es libre y el nombre no distingue mayúsculas de minúsculas.
• Columnas obligatorias: ATLETA, CPF y DIVISAO. Todo lo demás es opcional.
• Fechas en formato dd/mm/aaaa (con hora opcional dd/mm/aaaa HH:MM:SS). CPF con 11 dígitos, con o sin máscara.
• Una línea por inscripción: un atleta que tira en dos divisiones aparece en dos líneas, con el mismo CPF y DIVISAO diferente.

Columnas reconocidas

Cualquier otra columna se preserva — identificador externo, matrícula, ciudad, monto pagado, código de barras, lo que el sistema de origen quiera enviar. Esos campos quedan visibles en la inscripción como ítems adicionales y vuelven con el atleta en la consulta. No hace falta quitar columnas del export original.

Encabezado recomendado

ATLETA;CPF;EMAIL;TELEFONES;DATA_NASCIMENTO;CR;VALIDADE_CR;UF_ATLETA;MODALIDADE;DIVISAO;CLASSE;CATEGORIA;STATUS;SQUAD;POSTO;TIPO_ARMA;MODELO_ARMA;MARCA_ARMA;CALIBRE;NUMERO_SERIE;NUMERO_SIGMA

Ejemplo mínimo válido (solo los obligatorios):

ATLETA;CPF;DIVISAO
Fulano de Tal;111.444.777-35;Production
Fulano de Tal;111.444.777-35;Production Optics

El staff con sesión iniciada descarga la plantilla lista (encabezado + línea de ejemplo) en la propia pantalla de importación.

Cómo el sistema trata el archivo

1. Vista previa sin guardar — el archivo se analiza y la pantalla lista, línea por línea, lo que será creado, lo que será actualizado y los errores/avisos (CPF inválido, división nueva, squad nuevo).
2. Confirmación — solo se aplican las líneas válidas.
3. Reimportar no duplica — la clave es prueba + CPF + división. Enviar el mismo archivo de nuevo (o una versión corregida) actualiza las inscripciones existentes. El integrador puede exportar siempre el archivo completo, sin controlar diffs.
4. Los campos de contacto vacíos reciben valores provisorios — y una reimportación con dato real no sobrescribe un dato ya confirmado por el atleta en el sistema.

2. Exportar resultados (WinMSS)

En cualquier momento de la prueba, los oficiales (RM / Stats) descargan en Resultados → Exportar WinMSS un paquete .zip en formato WinMSS. Sirve para verificación, puntuación paralela y envío a sistemas de ranking que ya leen ese formato.

Qué viene en el paquete

• Los seis archivos del formato WinMSS — THEMATCH.XML (datos de la prueba), MEMBER.XML (atletas), ENROLLED.XML (inscripciones: división, categoría, squad, factor, DQ), STAGE.XML (etapas) y SCORE.XML (puntuaciones), además de CLASSIFY.XML.
• Un winmss_export.cab con los mismos archivos — el formato comprimido que WinMSS importa directamente.

Tres formas de descargar

• Prueba completa — todas las divisiones en un solo paquete.
• Todas las divisiones — un zip con una carpeta por división, cada una con sus XML.
• Por división — un zip maestro que contiene un zip completo (XML + cab) de cada división, listo para distribuir por separado.

Reglas de generación

• Entran solo inscripciones activas (las canceladas quedan fuera) y solo Scores aprobados — borradores y registros pendientes de PIN nunca salen en el export.
• Las etapas de crono y de check de equipo no se convierten en stage en el archivo.
• La división se convierte por el nombre oficial IPSC (Production, Open, Production Optics, PCC…). Una división con nombre fuera de la tabla IPSC sale con código genérico — para ranking externo, use los nombres oficiales en las divisiones de la prueba.
• La categoría se reconoce por el nombre (Lady, Junior, Senior, Super Senior, Military/Law Enforcement…), incluso cuando viene de etiquetas de la inscripción.
• Factor (Major/Minor), DQ y squad acompañan cada inscripción. Por puntuación van impactos A/C/D, misses, penalizaciones, procedimientos, tiempo, hit factor y puntos.
• Cada atleta con cuenta en el sistema lleva un número de identificación estable — el mismo en todas las pruebas — repetido en los campos Telephone y Alias del registro WinMSS. Es lo que permite al sistema externo reconocer al mismo atleta en pruebas diferentes. Los invitados sin cuenta reciben un número sintético, único solo dentro de ese paquete.
• Cuando el club usa códigos de matrícula externos, el código del atleta va en el campo RefNo del registro.

3. Publicar en scoring.services (Orbit)

Cuando todos los Scores están lanzados, Finalizar el Match abre un modal con la opción Enviar resultados a scoring.services marcada por defecto. Confirmar publica en el portal scoring.services la clasificación por división y el detalle de cada atleta, con origen Orbit. Solo tiro práctico (IPSC).

• Se pueden actualizar los resultados después, desde la vista general del Match.
• Se puede quitar el Match del portal y enviarlo de nuevo después.
• Si el envío falla, el Match sigue finalizado; inténtelo de nuevo con el botón en la vista general.

4. Resultados públicos (enlace)

Además del archivo, los resultados publicados quedan en un enlace público estable (/r/CODIGO) que el sistema externo puede incrustar o difundir — sin login y sin exponer nada más allá de lo que la prueba publicó.

Checklist del integrador

• CSV con ;, UTF-8, encabezado en la primera línea.
• ATLETA, CPF y DIVISAO presentes en todas las líneas.
• Una línea por división; la reimportación actualiza, no duplica.
• Identificador externo en una columna propia (p. ej. IDENTIFICADOR) — vuelve en los ítems adicionales.
• Divisiones de la prueba con nombre oficial IPSC, si el destino es un ranking externo vía WinMSS.
• Para el portal scoring.services: finalice el Match IPSC con la opción de envío marcada (o use el botón en la vista general después).

← Todas las guías Guía de la entidad →