Saltar al contenido principal

Recepción de Paquetes

Esta página describe cómo recibir y descargar un paquete desde un módulo destino.

1) Consultar novedades​

El módulo destino consulta si hay paquetes disponibles para él:

curl -s --request GET \
  -u $AUTH \
  $API_INTERNA_DESTINO/v1/novedades?modulo=$UID_MOD_DESTINO | jq

Ejemplo de respuesta:

[
  {
    "identificador": "db0433a3-33c7-498b-bc24-08fca1d46872",
    "fecha": "2025-05-29 10:50:11"
  }
]

2) Marcar novedad como recibida​

Antes de descargar, marca la novedad como recibida:

curl -s --request PUT \
  -u $AUTH \
  $API_INTERNA_DESTINO/v1/novedades/$UID_NOVEDAD/recibida

Respuesta: 204 No Content

3) Iniciar descarga del paquete​

Inicia la descarga del paquete usando el UID de la novedad:

curl -s --request PUT \
  -u $AUTH \
  $API_INTERNA_DESTINO/v1/descargas/$UID_NOVEDAD/iniciar | jq

Respuesta con metadata del paquete:

{
  "identificador": "db0433a3-33c7-498b-bc24-08fca1d46872",
  "institucion_origen": "00e09750-b5f0-43a4-b7da-ea0a1ca96a57",
  "modulo_origen": "fed98100-249a-4c1d-b814-5e608134a572",
  "institucion_destino": "00e09750-b5f0-43a4-b7da-ea0a1ca96a57",
  "modulo_destino": "fed98100-249a-4c1d-b814-5e608134a572",
  "indicacion": {
    "servicio": "servicio.ha.json",
    "datos": {
      "pais": "54",
      "nro_documento": "42041728",
      "nro_solicitud": 500,
      "tipo_documento": "0"
    }
  },
  "referencia": null,
  "hash": "5965933b754cbecaa425d37ac4ba73c39c7513aaf971a4a5b4c2148d89cf6e2852ccc42ee1b3a9d57670fa3237b2743400b5bf27b64f14460040a6d2a5f4db8b",
  "tipo": "TEXTO",
  "partes": [
    35
  ]
}

4) Descargar el contenido​

Descarga el contenido usando el ID de parte retornado:

curl -s --request GET \
  -u $AUTH \
  $API_INTERNA_DESTINO/v1/descargas/$UID_NOVEDAD/contenido?parte=$ID_PARTE | jq

Ejemplo de respuesta (texto):

{
  "json": "Este es el contenido del paquete"
}

5) Finalizar la descarga​

Una vez descargado y verificado el contenido (por ejemplo, comparando el hash), finaliza la descarga:

curl -s --request PUT \
  -u $AUTH \
  $API_INTERNA_DESTINO/v1/descargas/$UID_NOVEDAD/finalizar

Respuesta: 204 No Content

Si hay un error en la descarga, usa /descargas/{id}/fallida en lugar de finalizar.