Saltar al contenido principal

Envío de Paquetes

Esta página describe el flujo mínimo para crear y enviar un paquete desde un módulo origen.

1) Crear el paquete (metadata)​

El módulo crea el paquete indicando:

  • Institución destino
  • Módulo destino
  • Módulo origen
  • Metadata (servicio, datos, referencia, etc.)
curl -s --header "Content-Type: application/json" \
  --request POST \
  --data '{
    "institucion_destino": "00e09750-b5f0-43a4-b7da-ea0a1ca96a57",
    "modulo_destino": "fed98100-249a-4c1d-b814-5e608134a572",
    "modulo_origen": "61217f54-fa7f-4baf-8301-0ce61ac40bc3",
    "indicacion": {
      "servicio": "servicio.ha.json",
      "datos": {
        "pais": "54",
        "nro_documento": "42041728",
        "nro_solicitud": 500,
        "tipo_documento": "0"
      }
    }
  }' \
  -u $AUTH \
  $API_INTERNA_ORIGEN/v1/paquetes | jq

La respuesta incluye el identificador del paquete (UUID):

UID_PKG=$(curl -s -u $AUTH $API_INTERNA_ORIGEN/v1/paquetes | jq -r '.identificador')

2) Cargar contenido (texto)​

Para cargar contenido de texto, use el endpoint:

  • POST /v1/paquetes/{id}/cargar-texto

El cuerpo debe ser texto JSON válido (por ejemplo, una cadena entre comillas):

curl -s --header "Content-Type: application/json" \
  --request POST \
  --data '"Este es el contenido del paquete"' \
  -u $AUTH \
  $API_INTERNA_ORIGEN/v1/paquetes/$UID_PKG/cargar-texto

Nota: se calcula un hash del contenido para garantizar integridad.

3) Finalizar el paquete​

Una vez que el contenido está cargado (o incluso sin contenido), marque el paquete como listo:

curl -s --request PUT \
  -u $AUTH \
  $API_INTERNA_ORIGEN/v1/paquetes/$UID_PKG/finalizar

Respuesta: 204 No Content

4) Consultar el estado del paquete​

Puedes ver los movimientos registrados para el paquete:

curl -s --request GET \
  -u $AUTH \
  $API_INTERNA_ORIGEN/v1/paquetes/$UID_PKG/movimientos | jq

Ejemplo de respuesta:

[
  {
    "fecha": "2025-05-28 14:32:55",
    "estado": "OM_CARGA_CONTENIDO",
    "estado_descripcion": "Origen - Carga de contenido",
    "motivo": null,
    "rol": "origen"
  },
  {
    "fecha": "2025-05-29 10:48:36",
    "estado": "OM_FINALIZADO",
    "estado_descripcion": "Origen - Finalizado",
    "motivo": null,
    "rol": "origen"
  },
  {
    "fecha": "2025-05-29 10:50:11",
    "estado": "OG_ENVIANDO",
    "estado_descripcion": "Gateway Origen - Enviando",
    "motivo": null,
    "rol": "origen"
  },
  {
    "fecha": "2025-05-29 10:50:11",
    "estado": "OG_ENVIADO",
    "estado_descripcion": "Gateway Origen - Enviado",
    "motivo": "OK",
    "rol": "origen"
  }
]