> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AddNewDocumentEx

> Agrega un documento desde un archivo de imagen a un lote de FlexiCapture mediante el método AddNewDocumentEx de la API de servicios web.

<div id="what-it-does">
  ## Qué hace
</div>

Agrega un documento nuevo desde un archivo de imagen a un lote. Este método reemplaza el método [AddNewDocument](/es/flexi-capture/api/methods/add-new-document) de la versión anterior de la API de servicios web.

Los documentos agregados solo estarán accesibles después de que se hayan preprocesado sus imágenes. Use el método [ProcessBatch](/es/flexi-capture/api/methods/process-batch) para iniciar el preprocesamiento de imágenes después de agregar los documentos.

<div id="definition">
  ## Definición
</div>

```csharp theme={null}
int AddNewDocumentEx(int sessionId, int batchId, DocumentEx document, File file, bool excludeFromAutomaticAssembling);
```

<div id="parameters">
  ## Parámetros
</div>

| Name                             | Tipo                                                       | Descripción                                                                                                                                                                                                                                                                            |
| -------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sessionId`                      | `int`                                                      | El ID de la conexión con el Servidor de aplicaciones                                                                                                                                                                                                                                   |
| `batchId`                        | `int`                                                      | El ID del lote al que se agregará un documento                                                                                                                                                                                                                                         |
| `document`                       | [DocumentEx](/es/flexi-capture/api/structures/document-ex) | Una descripción del documento que se está creando                                                                                                                                                                                                                                      |
| `file`                           | [File](/es/flexi-capture/api/structures/file)              | El archivo que contiene la imagen del documento. Para crear un documento vacío, deje el parámetro `file` vacío (`file.Name = ""`, `file.Bytes = new bytes [0]`).                                                                                                                       |
| `excludeFromAutomaticAssembling` | `bool`                                                     | Una marca que indica si el documento se excluye del ensamblaje de documentos. Valores posibles: `True` (el documento ya se ha ensamblado y no se incluye en el ensamblaje de documentos), `False` (el documento se ensambla según la configuración especificada para el tipo de lote). |

<div id="add-a-document-image-with-a-post-request">
  ## Agregar una imagen de documento mediante una solicitud POST
</div>

También puede usar una [solicitud POST](/es/flexi-capture/api/files/files) para agregar una imagen de documento. Cree un documento con un archivo vacío mediante este método (`file.Name = "FileName"`, `file.Bytes = new bytes [0]`).

A continuación, ejecute una solicitud POST con los siguientes parámetros:

* `Action = Save`
* `objectType = 0`
* `objectId = documentId`, donde `documentId` es el ID del documento devuelto por el método `AddNewDocumentEx`
* `version = 0`
* `streamName = "FileName"`, donde `FileName` es el nombre del archivo especificado al llamar al método `AddNewDocumentEx`

<div id="returned-value">
  ## Valor devuelto
</div>

| Tipo  | Descripción                |
| ----- | -------------------------- |
| `int` | El ID del documento creado |