Estados y enums

Los estados que puede devolver el API. Jaremar normalmente solo necesita interpretar el estado del manifiesto (en estado de manifiesto) y el de las devoluciones, pero se documentan todos para referencia.

Estado del manifiesto

Es el estado que devuelve GET /manifiestos/{numero}/estado.

Estado	Significado
pending	Creado, pendiente de procesamiento inicial.
processing	En procesamiento.
imported	Facturas importadas. Estado normal de un manifiesto recién insertado por API.
closed	Cerrado. No acepta nuevas facturas ni modificaciones.

Precaución

Un manifiesto en estado closed rechazará cualquier intento de agregarle facturas con el motivo MANIFIESTO_CERRADO.

Estado de la factura

Ciclo de vida interno de una factura dentro de Hosana. No se expone directamente por API, pero ayuda a entender los conteos del resumen de inserción.

Estado	Significado
imported	Importada y con bodega asignada. Estado típico tras la inserción.
pending_warehouse	Importada pero sin bodega resuelta (código de Almacen no mapeado en el momento).
partial_return	Tuvo una devolución parcial.
returned	Devuelta (en su totalidad).
rejected	Rechazada.
deposited	Su cobro fue depositado.
closed	Cerrada (su manifiesto fue cerrado).

Nota

Al insertar, una factura entra como imported si su Almacen corresponde a una bodega registrada. Si el código no se reconoce en ese momento, el manifiesto completo se rechaza por ALMACENES_DESCONOCIDOS antes de llegar a crear la factura.

Estado de la devolución

GET /devoluciones/listar solo devuelve devoluciones en estado approved. Los demás estados existen internamente pero no se exponen.

Estado	Significado	¿Se expone por API?
approved	Aprobada. En Hosana las devoluciones se auto-aprueban al registrarse.	Sí
pending	Pendiente de aprobación.	No
rejected	Rechazada.	No
cancelled	Cancelada (corrección administrativa de un error de captura).	No

Consejo

Como las devoluciones son absolutas y se auto-aprueban al registrarse, en la práctica casi todas las que existen para una fecha aparecerán en el listado. Una devolución que un administrador de Hosana cancele por error de captura desaparecerá del listado en la siguiente consulta (la caché se invalida automáticamente).