Características del Método ConfirmReceivedDocument

Modificado el Vie, 13 Mar a 7:53 P. M.

El método ConfirmReceivedDocument se utiliza para marcar uno o varios documentos como recibidos, permitiendo al sistema registrar formalmente que el emisor ha descargado o procesado dichos documentos. Este método forma parte del flujo de recepción de documentos electrónicos dentro de la plataforma.

Descripción general:

Este método confirma la recepción de documentos previamente identificados como disponibles para el usuario. Su función principal es establecer un control de trazabilidad, indicando que el documento fue descargado o marcado como recibido en el sistema.

Es fundamental para auditorías, reglas de negocio y cumplimiento regulatorio.

Relación con el método GetReceivedDocument:

El método ConfirmReceivedDocument debe utilizarse en conjunto con el método GetReceivedDocument, ya que:

GetReceivedDocument permite obtener la lista de documentos pendientes por recibir, junto con sus respectivos GlobalDocumentId.
ConfirmReceivedDocument utiliza esos IDs globales para registrar que dichos documentos fueron recibidos correctamente.

Esto garantiza que el proceso se realice de manera ordenada y con los identificadores correctos.

Comportamiento del método según el tipo de petición:

El método devuelve diferentes respuestas dentro del parámetro OtherData, dependiendo del resultado de la operación.

1. Cuando la petición se realiza sobre un documento válido

Si el documento existe y la confirmación es correcta, la respuesta incluirá:

"OK"

Este mensaje indica que el documento ha sido marcado como recibido sin inconvenientes.

2. Cuando se realiza la petición varias veces sobre el mismo documento

Si un documento ya fue marcado como recibido previamente y se intenta confirmar nuevamente, la plataforma responde:

"Document with GlobalDocumentId 025eb8e4-9d79-59c6-a40b-87e1ad6ce320 downloaded."

Este mensaje informa que el documento ya había sido recibido en una operación anterior y evita duplicidad en la trazabilidad.

3. Cuando el GlobalDocumentId enviado no existe

Si se intenta marcar como recibido un documento cuyo identificador no está registrado en el sistema, se obtiene la siguiente respuesta:

"Document with GlobalDocumentId 00000000-0000-0000-0000-000000000001 not found"

Esto indica que el documento no pudo ser localizado y, por lo tanto, no puede ser marcado como recibido.

Resumen final:

Permite marcar uno o múltiples documentos como recibidos.
Requiere obtener previamente los GlobalDocumentId mediante el método GetReceivedDocument.
Devuelve mensajes claros sobre el estado del proceso (confirmación exitosa, documento ya recibido o documento inexistente).
Garantiza trazabilidad y control del flujo de recepción documental.