Skip to main content

6.8. Flujo visualización de sellos

Este documento migra el servicio legacy:

MainVisualizaSellosRS/consulta?tipo=CI&origen=DELICIAS&tractor=1600914&fecha=02/09/2025

cuyo response es:

{
  "control_interno": "1600914",
  "control_interno2": " ",
  "ruta": "471",
  "ruta2": " ",
  "tractor": "1515",
  "pipa": "1012",
  "pipa2": " ",
  "proveedor_transporte": "FLOTA_ALPURA",
  "sello_domo": " ",
  "justificacion_sello_domo": " ",
  "sede_sello_domo": " ",
  "sello_valvula": " ",
  "justificacion_sello_valvula": " ",
  "sede_sello_valvula": " ",
  "sello_domo2": " ",
  "justificacion_sello_domo2": " ",
  "sede_sello_domo2": " ",
  "sello_valvula2": " ",
  "justificacion_sello_valvula2": " ",
  "sede_sello_valvula2": " ",
  "fecha_recoleccion": "03-SEP-25",
  "origen": "DELICIAS",
  "id_transferencia": " ",
  "fecha_salida_prog": " "
}

1) Nuevo servicio equivalente​

Servicio: Quality Assurance Service (v1)
Endpoint: POST /seals/_search
Descripción: Consulta bitácora/estado de sellos filtrando por origen, tractor y fecha.
Devuelve campos que coinciden con la salida legacy: control_interno, control_interno2, ruta, ruta2, tractor, pipa, pipa2, proveedor_transporte, sello_domo*, sello_valvula*, fecha_recoleccion, origen, id_transferencia, fecha_salida_prog.

Evidencia (OpenAPI): la respuesta ejemplo incluye exactamente estos campos en searchSealHistoryResponse【quality-assurance-v1.yaml L51-L64】.

1.1 Request (nuevo — equivalente a los query params legacy)​

POST /quality/v1/seals/_search
Content-Type: application/json

{
  "origen": "DELICIAS",
  "tractor": "1600914",
  "fecha": "2025-09-02"
}

tipo=CI se interpreta como consulta por Control Interno; se deriva desde tractor/controlInterno según tu implementación actual de búsqueda.
Formato de fecha: YYYY-MM-DD.

1.2 Response (nuevo — equivalente al legacy)​

{
  "control_interno": "1600914",
  "control_interno2": " ",
  "ruta": "471",
  "ruta2": " ",
  "tractor": "1515",
  "pipa": "1012",
  "pipa2": " ",
  "proveedor_transporte": "FLOTA_ALPURA",
  "sello_domo": " ",
  "justificacion_sello_domo": " ",
  "sede_sello_domo": " ",
  "sello_valvula": " ",
  "justificacion_sello_valvula": " ",
  "sede_sello_valvula": " ",
  "sello_domo2": " ",
  "justificacion_sello_domo2": " ",
  "sede_sello_domo2": " ",
  "sello_valvula2": " ",
  "justificacion_sello_valvula2": " ",
  "sede_sello_valvula2": " ",
  "fecha_recoleccion": "2025-09-03",
  "origen": "DELICIAS",
  "id_transferencia": " ",
  "fecha_salida_prog": " "
}

La especificación del servicio nuevo muestra estos mismos campos en el ejemplo de respuesta【quality-assurance-v1.yaml L51-L64】【quality-assurance-v1.yaml L1-L4】.

2) Mapeo a Base de Datos​

Los sellos y datos de unidad/transferencia residen en ALP_RECOLECCION_VIAJES y, cuando aplica, en ALP_RECOLECCION_TRANSFERENCIAS.

Campo (API)Tabla.ColumnaComentario
control_internoALP_RECOLECCION_VIAJES.CONTROL_INTERNOClave de viaje
control_interno2ALP_RECOLECCION_VIAJES.CONTROL_INTERNO2 o ALP_RECOLECCION_TRANSFERENCIAS.CONTROL_INTERNO2Si hay transferencia
ruta / ruta2ALP_RECOLECCION_VIAJES.RUTA / ALP_RECOLECCION_VIAJES.RUTA2Secundaria si aplica
tractorALP_RECOLECCION_VIAJES.TRACTOR
pipa / pipa2ALP_RECOLECCION_VIAJES.PIPA / ALP_RECOLECCION_VIAJES.PIPA2
proveedor_transporteALP_RECOLECCION_VIAJES.PROVEEDOR_TRANSPORTE
sello_domo / justificacion_sello_domo / sede_sello_domoALP_RECOLECCION_VIAJES.SELLO_DOMO / JUSTIFICACION_SELLO_DOMO / SEDE_SELLO_DOMO
sello_valvula / justificacion_sello_valvula / sede_sello_valvulaALP_RECOLECCION_VIAJES.SELLO_VALVULA / JUSTIFICACION_SELLO_VALVULA / SEDE_SELLO_VALVULA
sello_domo2 / justificacion_sello_domo2 / sede_sello_domo2ALP_RECOLECCION_VIAJES.SELLO_DOMO2 / JUSTIFICACION_SELLO_DOMO2 / SEDE_SELLO_DOMO2
sello_valvula2 / justificacion_sello_valvula2 / sede_sello_valvula2ALP_RECOLECCION_VIAJES.SELLO_VALVULA2 / JUSTIFICACION_SELLO_VALVULA2 / SEDE_SELLO_VALVULA2
fecha_recoleccionALP_RECOLECCION_VIAJES.FECHA_RECOLECCION
origenALP_RECOLECCION_VIAJES.ORIGEN
id_transferenciaALP_RECOLECCION_VIAJES.ID_TRANSFERENCIA
fecha_salida_prog(según modelo) ALP_RECOLECCION_VIAJES.FECHA_SALIDA_PLANTA_PROG o campo programado aplicable

Evidencia (Diccionario de Datos): sellos, proveedor, pipa/tractor, rutas y campos *_2 están en ALP_RECOLECCION_VIAJES【5.hld.md L64-L70】【5.hld.md L30-L37】【5.hld.md L46-L60】; transferencias en ALP_RECOLECCION_TRANSFERENCIAS【5.hld.md L31-L37】.

3) SQL de referencia​

SELECT
  v.CONTROL_INTERNO               AS control_interno,
  v.CONTROL_INTERNO2              AS control_interno2,
  v.RUTA                          AS ruta,
  v.RUTA2                         AS ruta2,
  v.TRACTOR                       AS tractor,
  v.PIPA                          AS pipa,
  v.PIPA2                         AS pipa2,
  v.PROVEEDOR_TRANSPORTE          AS proveedor_transporte,
  v.SELLO_DOMO                    AS sello_domo,
  v.JUSTIFICACION_SELLO_DOMO      AS justificacion_sello_domo,
  v.SEDE_SELLO_DOMO               AS sede_sello_domo,
  v.SELLO_VALVULA                 AS sello_valvula,
  v.JUSTIFICACION_SELLO_VALVULA   AS justificacion_sello_valvula,
  v.SEDE_SELLO_VALVULA            AS sede_sello_valvula,
  v.SELLO_DOMO2                   AS sello_domo2,
  v.JUSTIFICACION_SELLO_DOMO2     AS justificacion_sello_domo2,
  v.SEDE_SELLO_DOMO2              AS sede_sello_domo2,
  v.SELLO_VALVULA2                AS sello_valvula2,
  v.JUSTIFICACION_SELLO_VALVULA2  AS justificacion_sello_valvula2,
  v.SEDE_SELLO_VALVULA2           AS sede_sello_valvula2,
  v.FECHA_RECOLECCION             AS fecha_recoleccion,
  v.ORIGEN                        AS origen,
  v.ID_TRANSFERENCIA              AS id_transferencia,
  v.FECHA_SALIDA_PLANTA_PROG      AS fecha_salida_prog
FROM ALP_RECOLECCION_VIAJES v
WHERE
  (:origen  IS NULL OR v.ORIGEN = :origen)
  AND (:fecha   IS NULL OR TRUNC(v.FECHA_RECOLECCION) = TO_DATE(:fecha, 'YYYY-MM-DD'))
  AND (
    /* Legacy traía ?tipo=CI&tractor=1600914, que en realidad es el CONTROL_INTERNO */
    :tipo = 'CI' AND v.CONTROL_INTERNO = TO_NUMBER(:tractor)
  );

Si realmente necesitas filtrar por tractor (económico), reemplaza la condición final por v.TRACTOR = :tractor.

4) Diagrama de secuencia​

6) Puntos clave de migración​

  • Cambia de query params en URL a JSON body (origen, tractor/controlInterno, fecha).
  • Usa formato de fecha ISO (YYYY-MM-DD).
  • Revisa si tractor=1600914 en legacy en realidad era el control_interno (ajusta el filtro).
  • Campos de sellos y sus justificaciones están materializados en maestro (ALP_RECOLECCION_VIAJES).

Referencias​

  • Quality Assurance Service — /seals/_search: respuesta con control_interno, ruta, pipa, sello_*, etc.【quality-assurance-v1.yaml L51-L64】【quality-assurance-v1.yaml L27-L31】
  • Diccionario de Datos — sellos, proveedor, rutas, pipa/tractor y *_2 en ALP_RECOLECCION_VIAJES【5.hld.md L64-L70】【5.hld.md L30-L37】; transferencias【5.hld.md L31-L37】.