Etiquetas APIGEE

Servicio de generación y reconstrucción de etiquetas (PDF/ZPL), integración Suite/PubSub y utilidades de caché.

Prefijo HTTP: En Server las rutas se registran con prefix: PREFIX (/etiquetas). Las URLs de los servers ya incluyen /etiquetas; los paths son relativos (p. ej. GET /health → …/etiquetas/health).

Autenticación (aplicación vs Apigee/Istio): En rutas con security: [{ bearerAuth: [] }] el preHandler auth acepta Authorization: Bearer <JWT> y/o header x-custom-id (al menos uno). El header x-custom-id suele inyectarlo Apigee en el tráfico hacia el cluster. Bearer y x-custom-id pueden ir juntos sin problema (con Bearer solo, o Bearer + x-custom-id). En cambio, solo x-custom-id sin Bearer no alcanza: Istio rechaza la petición en el edge y no llega al microservicio. Rutas sin security no ejecutan ese preHandler (p. ej. /receive, /existe, /geo-update).

Flujo común generarEtiqueta con apiResponse: true: La respuesta JSON exitosa es siempre { isError: false, data: { message: "Procesado correctamente", responses: [...] }, timestamp, id }. Cada elemento de responses describe estado por guía (existe, reconstruido, error, etc.); no incluye PDF ni base64 (para PDF/ZPL usar POST /imprimir o GET /imprimir/{guia}). Los campos guiasExistentes / guiasNoExistentes pertenecen a la respuesta interna del cliente Suite, no al cuerpo HTTP del servicio de etiquetas.

Ejemplos múltiples: Donde un mismo código HTTP puede variar, se documenta con el mapa examples.