Estado de manifiesto

GET /api/v1/manifiestos/{numero}/estado

Consulta el estado actual y un resumen de un manifiesto previamente insertado. Útil para que Jaremar confirme que un manifiesto entró correctamente y en qué estado se encuentra.

Solicitud

Atributo	Valor
Método	GET
Ruta	/api/v1/manifiestos/{numero}/estado
Autenticación	Requerida (ApiKey)
Rate limit	General (60/min por IP)

Parámetro de ruta

Parámetro	Tipo	Reglas	Ejemplo
numero	string	Solo dígitos ([0-9]+). Es el NumeroManifiesto.	800002

Precaución

El parámetro {numero} solo acepta dígitos. Si el número de manifiesto contiene letras o símbolos, la ruta no coincidirá y obtendrás un 404 de routing.

Postman

• Método GET
• URL: https://<dominio-hosana>/api/v1/manifiestos/800002/estado (cambia 800002 por el número que consultas)
• Pestaña Headers: ApiKey con tu clave

cURL

curl -X GET "https://<dominio-hosana>/api/v1/manifiestos/800002/estado" \
  -H "ApiKey: TU_CLAVE_AQUI"

PHP

$response = $client->get('manifiestos/800002/estado', [
    'headers' => ['ApiKey' => 'TU_CLAVE_AQUI'],
]);
$data = json_decode($response->getBody(), true);
echo $data['estado']; // "imported"

Node.js

const res = await fetch("https://<dominio-hosana>/api/v1/manifiestos/800002/estado", {
  headers: { "ApiKey": "TU_CLAVE_AQUI" },
});
const data = await res.json();
console.log(data.estado); // "imported"

C# / .NET

var data = await http.GetFromJsonAsync<JsonElement>("manifiestos/800002/estado");
Console.WriteLine(data.GetProperty("estado").GetString()); // "imported"

Respuesta exitosa

HTTP 200

{
  "success": true,
  "manifiesto": "800002",
  "estado": "imported",
  "resumen": {
    "total_facturas": 124,
    "total_importe": 185430.50,
    "fecha_ingreso": "2026-06-06 07:15:32"
  }
}

Campo	Tipo	Descripción
manifiesto	string	Número consultado.
estado	string	Estado actual del manifiesto. Ver estados.
resumen.total_facturas	integer	Cantidad de facturas asociadas al manifiesto.
resumen.total_importe	number	Suma de los importes de las facturas.
resumen.fecha_ingreso	string	Fecha y hora en que el manifiesto se creó en Hosana.

Manifiesto inexistente

HTTP 404

{
  "success": false,
  "message": "El manifiesto #800002 no existe en el sistema."
}