aguaSSR — carga del padrón por la API
Con esta guía cargas el padrón de la cooperativa (sus clientes, los socios, los servicios y el medidor de cada uno) desde tu sistema, y lo mantienes al día. Cada ficha describe un servicio con todo lo que lo rodea. Para un agente de IA, la misma información está en la ficha aguaSSR, que se lee con redcumbre guia aguassr.
Antes de empezar
Sección titulada «Antes de empezar»- La empresa tiene que tener aguaSSR habilitado.
- Necesitas la llave de la empresa. Trabaja siempre primero con la llave de prueba: lo que cargues ahí no toca el padrón real de la cooperativa.
- El servicio no ofrece un comando del CLI para cargar el padrón: se carga con el
POSTde arriba.
La ficha
Sección titulada «La ficha»{ "codigo": "S-0001", "cliente": { "rut": "12345678-5", "nombre": "Cliente de Prueba Uno", "tipo": "persona", "telefono": "+56 9 0000 0001", "correo": "cliente@example.com" }, "membresia": { "numero": 101, "socioDesde": "2024-03-01" }, "servicio": { "estado": "activo", "direccion": "Camino Vecinal 120", "localidad": "Sector Central", "comuna": "<código de la comuna>", "referencia": "Portón verde", "titularDesde": "2024-03-01", "diametroArranque": "<diámetro del catálogo>", "sector": "Central", "diaLectura": 10, "orden": 1 }, "medidor": { "serie": "MED-0001", "digitos": 5, "anio": 2024, "instaladoDesde": "2024-03-01" }}Sólo codigo, cliente.rut y servicio.direccion son obligatorios. El nombre del cliente es obligatorio sólo si el RUT aún no es cliente de la cooperativa y no tiene un nombre registrado. Del medidor ninguno es obligatorio: lo que no trae queda vacío. Un campo que la ficha no conoce la rechaza nombrándolo. El detalle de cada campo está en la ficha aguaSSR.
Cosas que conviene saber:
- El código del servicio identifica la ficha. Enviar la misma ficha otra vez no duplica nada.
- El cliente no se cambia. Si el RUT ya es cliente, la ficha se suma a él y se ignoran su nombre, tipo, teléfono y correo.
- Lo que la cooperativa cambió a mano no se pisa. Si tu ficha trae otra dirección, referencia, estado, ruta de lectura o medidor, el valor queda en «Cambios del integrador» en la web, y una persona elige cuál usar. La ficha vuelve
en_conflicto. - El número de socio se crea, no se cambia. Si el cliente ya es socio con otro número, la ficha se rechaza.
Un lote de prueba y su respuesta
Sección titulada «Un lote de prueba y su respuesta»Tres fichas: un servicio nuevo, uno con el RUT mal escrito y el servicio de ensayo ENSAYO-DIRECCION.
{ "fichas": [ { "codigo": "S-0001", "cliente": { "rut": "12345678-5", "nombre": "Cliente de Prueba Uno", "tipo": "persona" }, "membresia": { "numero": 101, "socioDesde": "2024-03-01" }, "servicio": { "estado": "activo", "direccion": "Camino Vecinal 120", "sector": "Central", "diaLectura": 10, "orden": 1 }, "medidor": { "serie": "MED-0001", "digitos": 5 } }, { "codigo": "S-0002", "cliente": { "rut": "12345678-9", "nombre": "Cliente de Prueba Dos" }, "servicio": { "direccion": "Camino Vecinal 340" } }, { "codigo": "ENSAYO-DIRECCION", "cliente": { "rut": "11111111-1" }, "servicio": { "direccion": "Dirección que envía la integración" } } ]}La respuesta es 200, con un resultado por ficha:
{ "envioId": 1, "resultados": [ { "indice": 0, "codigo": "S-0001", "resultado": "aplicada", "motivos": [], "conflictos": [], "sinDiaDeLectura": false }, { "indice": 1, "codigo": "S-0002", "resultado": "rechazada", "motivos": [{ "codigo": "AGUA_FICHA_RUT_INVALIDO", "mensaje": "El RUT del cliente no es válido." }], "conflictos": [], "sinDiaDeLectura": false }, { "indice": 2, "codigo": "ENSAYO-DIRECCION", "resultado": "en_conflicto", "motivos": [], "conflictos": [{ "dato": "DIRECCION", "valorVigente": "Dirección corregida en la web", "valorEnviado": "Dirección que envía la integración" }], "sinDiaDeLectura": true } ]}aplicada: la ficha quedó guardada.rechazada: nada de esa ficha se guardó. Corrige lo que dicen susmotivosy reenvía sólo esa ficha. Una ficha rechazada no deshace las demás del lote.en_conflicto: la ficha se aplicó, salvo los datos que listaconflictos. No los reenvíes: esperan la decisión de la cooperativa.sinDiaDeLectura: true: el servicio quedó «Sin ciclo» porque la ficha no traíadiaLectura.
Por qué se rechaza una ficha
Sección titulada «Por qué se rechaza una ficha»Cada motivo trae un codigo y un mensaje que nombra lo que falló sin repetir el dato personal. Los códigos están en la tabla «Qué puede fallar» de la ficha aguaSSR. Además, el lote entero se rechaza con 400 si está vacío, trae más de 250 fichas o fichas no es una lista.
Los servicios de ensayo del modo de prueba
Sección titulada «Los servicios de ensayo del modo de prueba»Para provocar cada caso sin tocar los datos de producción, el modo de prueba trae cuatro servicios:
| Código | Qué tiene | Qué ocurre si envías otro valor |
|---|---|---|
ENSAYO-DIRECCION | La dirección cambiada en la web. | La ficha vuelve en_conflicto en DIRECCION. |
ENSAYO-RUTA | En el ciclo del día 10 y en una ruta, movido en la web. | Vuelve en_conflicto en RUTA. |
ENSAYO-MEDIDOR | Con medidor y su marca corregida en la web. | Vuelve en_conflicto en MEDIDOR. |
ENSAYO-ARCHIVADO | Archivado. | Vuelve rechazada con AGUA_SERVICIO_ARCHIVADO. |
Se siembran solos y no cuentan en el tope diario.
Límites del modo de prueba
Sección titulada «Límites del modo de prueba»El modo de prueba admite hasta 5.000 fichas por día, contando también las rechazadas. Un lote que no cabe en lo que queda del día se rechaza entero con 400 y MODO_PRUEBA_TOPE_DIARIO; el mensaje dice lo que queda y cuándo se renueva (a las 00:00 de Chile). Un lote de 250 fichas tiene que responder dentro de la misma llamada.
Qué ve la cooperativa en su web
Sección titulada «Qué ve la cooperativa en su web»- Configuración › Integración: las llaves de cada modo con su último uso, lo que puede hacer la integración y «Lo recibido y lo entregado»: cada envío (los lotes consecutivos de una misma llave y modo, separados por menos de 10 minutos), con su modo y sus contadores de fichas aplicadas, rechazadas y en conflicto.
- Clientes › Cambios del integrador: los datos en conflicto, con el valor de la web y el de la integración, para que una persona elija usar uno u otro.
Los datos de una persona en el modo de prueba
Sección titulada «Los datos de una persona en el modo de prueba»Los clientes que cargues en el modo de prueba son datos de prueba de la cooperativa, y se suprimen solos a los 30 días.
- Quién pide la supresión. La persona titular de los datos ejerce su derecho ante la cooperativa, no ante tu sistema: la cooperativa es quien pide la supresión.
- Cómo se hace. Con Restaurar el modo de prueba, que suprime en el acto todo el ensayo de la empresa (con la CLI,
redcumbre restaurar --confirmar <slug>). Para registros determinados, la cooperativa envía una instrucción escrita a soporte. - Reenviar la misma ficha vuelve a crear a la persona en el modo de prueba. Si la ficha se sigue enviando, los datos reaparecen.
Pasar a producción
Sección titulada «Pasar a producción»El paso es el mismo de todos los servicios: se hace con una confirmación explícita (--produccion --confirmar <slug>) y con la llave de producción. Lee Modo de prueba y la mecánica Modo de prueba y producción.
- Lo que cargaste en prueba no pasa a producción: el padrón se carga de nuevo con la llave de producción, y los servicios de ensayo no existen ahí.
- En producción, cada servicio que nace suma al cobro del plan.
- No hay tope diario de fichas en producción.