Skip to content
Novisolutions Docs

Documentos fuente

Documentos fuente

Section titled “Documentos fuente”

La documentacion publicada del modulo Claro consolida dos tipos de insumo:

  1. el contrato oficial MOVILPOS v7.0 entregado por Claro
  2. el contrato interno de implementacion de ms-recargas dentro de NoviSuite

Documento base oficial

Section titled “Documento base oficial”
DocumentoVersionAutorAreaUso
Protocolo de Recargas V 7.0 - CONTRATO GENERICO SERVICIO WEB RECARGAS VIRTUALES v.77.0TIC Roque MaciasSistemas / Proyectos, CONECEL S.A.Base para recarga, consulta de recarga y consulta de inventario

Alcance extraido del documento oficial

Section titled “Alcance extraido del documento oficial”

El PDF define tres contratos XML sobre el protocolo MOVILPOS:

  1. Recarga sincronica - funcion sre_movilposd_76186.
  2. Consulta de recarga - funcion sre_consulta_recarga.
  3. Consulta de inventario - funcion sre_consulta_inventario.

De ese contrato se extrajeron:

  • parametros obligatorios y opcionales
  • ejemplos XML de request y response
  • mensajes de error del SPR
  • valores de pruebas como PRUEBACOMPANI, PRUEBAREC y 5566

Fuente interna de implementacion

Section titled “Fuente interna de implementacion”

Ademas del PDF oficial, esta documentacion incorpora decisiones de implementacion propias de NoviSuite para ms-recargas:

  • flujo automatico MBA3 -> correo -> n8n -> webhook -> Claro
  • flujo manual con OTP de accion y limites diarios
  • bitacora local recharge_transactions
  • estados failed, unavailable, rejected e ignored
  • notificaciones por BullMQ hacia ms-worker
  • soporte de CLARO_MOCK_MODE y tunel SSH para desarrollo

Validacion realizada

Section titled “Validacion realizada”
  • Los parametros XML se mantuvieron alineados al contrato MOVILPOS.
  • Los endpoints HTTP y estados operativos se alinearon al comportamiento esperado de ms-recargas.
  • Los ejemplos de errores distinguen fallos HTTP, de negocio y de transporte.
  • El diagrama tecnico publicado resume la arquitectura actual del modulo.

Artefactos en el repositorio

Section titled “Artefactos en el repositorio”
RecursoUbicacion
Diagrama tecnico SVGsrc/assets/images/ms-claro/DIAGRAMA-TECNICO.svg
Otros artefactos Clarosrc/assets/images/ms-claro/

Notas editoriales

Section titled “Notas editoriales”
  • Los codigos product_code de MBA3 y los offer_id de Claro pertenecen a capas distintas.
  • Algunos valores y mappings siguen marcados como provisionales hasta confirmacion final con Claro.
  • Los registros legacy con status=error deben interpretarse con cuidado frente a la taxonomia nueva.