---
title: "CustomerDocuments (Visma.net Financials)"
description: "Customer Documents"
language: es
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/es/datamodels/vismanet/VismaNet.CustomerDocument.CustomerDocuments
original: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.CustomerDocument.CustomerDocuments
updated: 2026-11-19T00:27:19Z
license: https://documentation.invantive.eu/es/
---

# CustomerDocuments: Visma.net Financials Documentos de cliente

`read only` `REST`

- Catálogo: `VismaNet`
- Esquema: `CustomerDocument`
- Etiqueta: Documentos de cliente

Obtiene un rango de documentos de cliente - ScreenId=AR301000. El tamaño de página de la solicitud debe ser menor o igual al tamaño máximo de página permitido, que se devuelve como parte de la información de metadatos. Si el tamaño de página solicitado es mayor que el tamaño máximo de página permitido, la solicitud se limitará al tamaño máximo de página. Registro de cambios: 2020-May: Se añadió paginación forzada. Datos de documento de cliente

Solo puede recuperar datos.

## Resumen

Datos de documento de cliente

## Fuente de la API

- Punto final: `/v1/customerdocument`
- Operación: `get /v1/customerdocument`

## Características de rendimiento

| Characteristic | Value |
|---|---:|
| Latencia media de acceso (ms) | 155 |
| Número de filas escaneadas por minuto | 29,100 |
| Número de filas de queries puntuales por minuto | 387 |

El resultado se puede almacenar en la Caché del cliente.

## Parámetros

| Name | Tipo de Datos | Required | Default | Documentation |
|---|---|:---:|---|---|
| `branch` | `` | [ ] |  | Filtrar por sucursal |
| `closedFinancialPeriod` | `` | [ ] |  | La fecha de cierre del período financiero. |
| `createdDateTime` | `` | [ ] |  | Este valor, generado por el sistema, indica la fecha y hora de creación.Úselo para recuperar todos los registros que se hayan creado desde ese momento hasta la actualidad.Formato aceptado: * ```yyyy-MM-dd``` * ```yyyy-MM-dd HH:mm:ss``` * ```yyyy-MM-dd HH:mm:ss.FFF``` * ```yyyy-MM-ddTHH:mm:ss``` * ```yyyy-MM-ddTHH:mm:ss.FFF``` _Nota:_ __CreatedDateTime__ y __CreatedDateTimeCondition__ son __mutuamente inclusivos__. |
| `createdDateTimeCondition` | `` | [ ] |  | Este valor representa la condición que se aplicará al recuperar registros.Valores aceptados (sin las comillas simples): * '&gt;' para mayor que * '&lt;' para menor que * '&gt;=' para mayor o igual que * '&lt;=' para menor o igual que  _Nota:_ __CreatedDateTime__ y __CreatedDateTimeCondition__ son __mutuamente inclusivos__. |
| `customer` | `` | [ ] |  | Filtrar por cliente |
| `customerRefNumber` | `` | [ ] |  | La parte superior &gt; Referencia externa &gt; La referencia externa utilizada en AutoInvoice. |
| `documentDate` | `` | [ ] |  | Este valor indica la fecha del documento.Utilícelo para recuperar todos los registros que tienen la fecha del documento desde ese momento, hasta el futuro.Formato aceptado: * ```yyyy-MM-dd```` * ````yyyy-MM-dd```` * ````yyyy-MM-dd```` * ````yyyy-MM-dd```` * ````yyyy-MM-dd``` _Nota:_ __DocumentDate__ y __DocumentDateCondition__ son __mutuamente inclusivos__. |
| `documentDateCondition` | `` | [ ] |  | Este valor representa la condición que se aplicará a la fecha del documento al recuperar registros.Valores aceptados (sin las comillas simples): * '&gt;' para mayor que * '&lt;' para menor que * '&gt;=' para mayor o igual que * '&lt;=' para menor o igual que _Nota:_ __DocumentDate__ y __DocumentDateCondition__ son __mutuamente inclusivos__. |
| `documentDueDate` | `` | [ ] |  | La fecha en que vence el pago del documento, de acuerdo con las condiciones de crédito. |
| `documentDueDateCondition` | `` | [ ] |  | Este valor representa la condición que se aplicará a la fecha de vencimiento al recuperar registros.Valores aceptados (sin las comillas simples): * '&gt;' para mayor que * '&lt;' para menor que * '&gt;=' para mayor o igual que * '&lt;=' para menor o igual que |
| `documentType` | `` | [ ] |  | Este campo está obsoleto para los puntos de conexión de documentos de cliente específicos.Solo podrá utilizarse desde el endpoint de documentos de cliente.(Valores: Factura, DebitNote, CreditNote, Pago, VoidPayment, Prepago, Reembolso, FinCharge, SmallBalanceWo, SmallCreditWo, CashSale, CashReturn, Indefinido, NoUpdate) |
| `dunningLetterDateTime` | `` | [ ] |  | La fecha y hora en que el documento liberó por última vez una carta de reclamación. |
| `dunningLetterDateTimeCondition` | `` | [ ] |  | Establezca la fecha/hora como anterior (&lt;), posterior (&gt;), anterior e incluida (=&lt;) o posterior e incluida (=&gt;) para filtrar por intervalo de tiempo. |
| `dunningLevel` | `` | [ ] |  | El nivel de reclamación del documento. |
| `expandApplications` | `` | [ ] |  | Verdadero si desea ver toda la información de reclamaciones relativa a este documento. |
| `expandAttachments` | `` | [ ] |  | Verdadero si desea ver todos los adjuntos relativos a este documento. |
| `expandDunningInformation` | `` | [ ] |  |  |
| `expandInvoiceAddress` | `` | [ ] |  | Verdadero si desea ver toda la información relativa a la dirección de facturación de este documento. |
| `expandTaxDetails` | `` | [ ] |  | Verdadero si desea ver todos los detalles de IVA relativos a este documento. |
| `externalReference` | `` | [ ] |  | La parte superior &gt; Referencia externa &gt; La referencia externa utilizada en AutoInvoice. |
| `financialPeriod` | `` | [ ] |  | El periodo financiero al que se contabilizan las transacciones registradas en el documento.Formato AAAAMM. |
| `greaterThanValue` | `` | [ ] |  | Valor mayor que.El elemento que constituye el objeto de esto varía de una API a otra. |
| `lastModifiedDateTime` | `` | [ ] |  | Este valor, generado por el sistema, indica la última fecha y hora en que se modificó el registro.Úselo para recuperar todos los registros que se hayan modificado desde ese momento hasta la actualidad.Formato aceptado: * ```yyyy-MM-dd``` * ```yyyy-MM-dd HH:mm:ss``` * ```yyyy-MM-dd HH:mm:ss.FFF``` * ```yyyy-MM-ddTHH:mm:ss``` * ```yyyy-MM-ddTHH:mm:ss.FFF``` _Nota:_ __LastModifiedDateTime__ y __LastModifiedDateTimeCondition__ son __mutuamente inclusivos__. |
| `lastModifiedDateTimeCondition` | `` | [ ] |  | Este valor representa la condición que se aplicará al recuperar registros.Valores aceptados (sin las comillas simples): * '&gt;' para mayor que * '&lt;' para menor que * '&gt;=' para mayor o igual que * '&lt;=' para menor o igual que  _Nota:_ __LastModifiedDateTime__ y __LastModifiedDateTimeCondition__ son __mutuamente inclusivos__. |
| `paymentReference` | `` | [ ] |  | La parte superior &gt; Ref. de pago &gt; El número de referencia del documento, generado automáticamente por el sistema de acuerdo con la serie numérica asignada a las ventas en efectivo en la ventana de preferencias del libro mayor de clientes.. |
| `project` | `` | [ ] |  | El proyecto con el que está asociado el documento. |
| `released` | `` | [ ] |  | Parámetro que indica si la factura ha sido liberada o no. |
| `status` | `` | [ ] |  | El estado del documento.Utilice la lista desplegable para seleccionar el estado.(Valores: En espera, Equilibrado, Anulado, Programado, Abierto, Cerrado, PendingPrint, PendingEmail, CreditHold, CcHold, Reservado) |

## Columnas de la Tabla

A continuación se muestran las columnas de la tabla `CustomerDocuments`. Cada columna tiene un tipo de datos SQL. Se debe proporcionar un nuevo valor no nulo para cada columna requerida en todo momento durante la inserción y la actualización.

| Name | Tipo de Datos | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `COMPANY_CODE` | `varchar2(30)` | Código de empresa | [x] | writable | Código de partición que segmenta los datos. |
| `COMPANY_NAME` | `varchar2(240)` | Nombre de la Compañía | [x] | writable | Nombre de la partición. |
| `account_active` | `char` | Cuenta activa | [ ] | filtros en la plataforma, modificables, `account.active` |  |
| `account_description` | `varchar2` | Descripción de la cuenta | [ ] | filtros en la plataforma, modificables, `account.description` | Nombre del artículo/descripción |
| `account_externalCode1` | `varchar2` | Código externo de la cuenta 1 | [ ] | filtros en la plataforma, modificables, `account.externalCode1` | Clase de cuenta &gt; El identificador de la clase de cuenta. |
| `account_externalCode2` | `varchar2` | Código externo de la cuenta 2 | [ ] | filtros en la plataforma, modificables, `account.externalCode2` | Clase de cuenta &gt; El nombre de la clase de cuenta. |
| `account_number` | `varchar2` | Número de Cuenta | [ ] | filtros en la plataforma, modificables, `account.number` | Número de artículo |
| `account_type` | `varchar2` | Tipo de Cuenta | [ ] | filtros en la plataforma, modificables, `account.type` | Cuenta &gt; El número de cuenta. |
| `amount` | `double` | Amount | [ ] | filtros en la plataforma, modificables, `amount` | La parte superior &gt; Importe &gt; El importe pagado por el documento.El valor aparece en los documentos nuevos si la casilla Validar totales del documento al introducir está marcada en la ventana AR101000.Si la casilla de verificación no está marcada, el valor aparece cuando el estado del documento es Abierto. |
| `amountInCurrency` | `double` | Importe en Moneda | [ ] | filtros en la plataforma, modificables, `amountInCurrency` | Cálculo en segundo plano que muestra el importe en su moneda predeterminada.Este campo se aplica si el importe se indica en una moneda distinta de su moneda predeterminada. |
| `balance` | `double` | Balance | [ ] | filtros en la plataforma, modificables, `balance` | La parte superior &gt; Saldo &gt; Para un documento de cuenta de cliente abierto, el saldo después de cualquier descuento por pronto pago aplicado.Para un documento utilizado en el proceso de aplicación, este es el saldo después de aplicar los pagos. |
| `balanceInCurrency` | `double` | Saldo en moneda extranjera | [ ] | filtros en la plataforma, modificables, `balanceInCurrency` | Cálculo en segundo plano que muestra el saldo en su moneda predeterminada.Este campo se aplica si el importe se indica en una moneda distinta de su moneda predeterminada. |
| `branchNumber_name` | `varchar2` | Nombre de la sucursal | [ ] | filtros en la plataforma, modificables, `branchNumber.name` | Haga clic en la lupa. &gt; El nombre. |
| `branchNumber_number` | `varchar2` | Número de sucursal | [ ] | filtros en la plataforma, modificables, `branchNumber.number` | Haga clic en la lupa. &gt; El identificador. |
| `branch_name` | `varchar2` | Nombre de la sucursal | [ ] | filtros en la plataforma, modificables, `branch.name` | Haga clic en la lupa. &gt; El nombre. |
| `branch_number` | `varchar2` | Número de sucursal | [ ] | filtros en la plataforma, modificables, `branch.number` | Haga clic en la lupa. &gt; El identificador. |
| `cashAccount` | `varchar2` | Cuenta de caja | [ ] | filtros en la plataforma, modificables, `cashAccount` | Pestaña Detalles financieros &gt; Sección de información de pago &gt; Cuenta de caja &gt; La cuenta de caja asociada al método de pago. |
| `cashDiscount` | `double` | Descuento por pago al contado | [ ] | filtros en la plataforma, modificables, `cashDiscount` | La parte superior &gt; Descuento por pronto pago &gt; El importe del descuento por pronto pago que se ha aplicado o se aplicará al documento, que el sistema calcula según las condiciones de crédito especificadas. |
| `cashDiscountInCurrency` | `double` | Descuento por pago al contado en moneda extranjera | [ ] | filtros en la plataforma, modificables, `cashDiscountInCurrency` | Cálculo en segundo plano que proporciona el descuento por pronto pago en su moneda predeterminada.Este campo es aplicable si el importe se indica en una moneda distinta de la predeterminada. |
| `closedFinancialPeriod` | `varchar2` | Ejercicio financiero cerrado | [ ] | filtros en la plataforma, modificables, `closedFinancialPeriod` | Formato AAAAMM. |
| `createdDateTime` | `datetime` | Created | [ ] | filtros en la plataforma, modificables, `createdDateTime` | Pestaña Adjuntos &gt; Fecha de creación &gt; La fecha en que se creó el adjunto. |
| `currencyId` | `varchar2` | Código de la moneda | [ ] | filtros en la plataforma, modificables, `currencyId` | La parte superior &gt; Moneda &gt; La moneda del documento.De forma predeterminada, es la moneda predeterminada del cliente, pero puede cambiarse si la casilla Permitir anulación de moneda está marcada en la ventana AR303000. |
| `customerProject` | `varchar2` | Proyecto de un cliente | [ ] | filtros en la plataforma, modificables, `customerProject` | La parte superior &gt; Nº de proyecto del cliente &gt; El número de proyecto del cliente utilizado en AutoInvoice. |
| `customerRefNumber` | `varchar2` | Referencia de referencia personalizada | [ ] | filtros en la plataforma, modificables, `customerRefNumber` | La parte superior &gt; Referencia externa &gt; La referencia externa utilizada en AutoInvoice. |
| `customer_name` | `varchar2` | Nombre del Cliente | [ ] | filtros en la plataforma, modificables, `customer.name` | Haga clic en la lupa. &gt; El nombre. |
| `customer_number` | `varchar2` | Numero de cliente | [ ] | filtros en la plataforma, modificables, `customer.number` |  |
| `documentDate` | `datetime` | Fecha del Documento | [ ] | filtros en la plataforma, modificables, `documentDate` | La parte superior &gt; Fecha* &gt; La fecha en que se creó el documento del libro mayor de clientes.De forma predeterminada, en un documento nuevo, es la fecha de negocio actual, pero puede cambiarla. |
| `documentDueDate` | `datetime` | Fecha límite de entrega del documento | [ ] | filtros en la plataforma, modificables, `documentDueDate` |  |
| `documentType` | `varchar2` | Tipo del Documento | [ ] | filtros en la plataforma, modificables, `documentType` | La parte superior &gt; Tipo &gt; El tipo de documento.Están disponibles los siguientes tipos: factura, nota de débito, nota de crédito, cargo por vencimiento, anulación de crédito por impago. |
| `errorInfo` | `varchar2` | Mensaje de Error | [ ] | filtros en la plataforma, modificables, `errorInfo` |  |
| `financialPeriod` | `varchar2` | Período Financiero | [ ] | filtros en la plataforma, modificables, `financialPeriod` | El período financiero al que deben registrarse las transacciones contenidas en el documento.Formato AAAAMM. |
| `invoiceText` | `varchar2` | Texto de la factura | [ ] | filtros en la plataforma, modificables, `invoiceText` | La parte superior &gt; Texto de factura &gt; Cualquier descripción proporcionada por el usuario del documento de cuenta de cliente. |
| `lastModifiedDateTime` | `datetime` | Última Modificación | [ ] | filtros en la plataforma, modificables, `lastModifiedDateTime` | Campo generado por el sistema para la fecha/hora de la última modificación del documento. |
| `location_countryId` | `varchar2` | Ubicación: Código de país | [ ] | filtros en la plataforma, modificables, `location.countryId` | Location*. |
| `location_id` | `varchar2` | ID de Ubicación | [ ] | filtros en la plataforma, modificables, `location.id` | Haga clic en la lupa &gt; El identificador |
| `location_name` | `varchar2` | Nombre de Ubicación | [ ] | filtros en la plataforma, modificables, `location.name` | Haga clic en la lupa &gt; El nombre mostrado |
| `metadata_maxPageSize` | `int64` | Tamaño máximo de las páginas de metadatos | [ ] | filtros en la plataforma, modificables, `metadata.maxPageSize` |  |
| `metadata_totalCount` | `int64` | Recuento total | [ ] | filtros en la plataforma, modificables, `metadata.totalCount` |  |
| `note` | `varchar2` | Note | [ ] | filtros en la plataforma, modificables, `note` | Icono Notas en la parte superior de la ventana &gt; Ventana emergente para introducir cualquier texto definido por el usuario relacionado con el documento. |
| `origInvoiceDate` | `datetime` | Fecha de la factura original | [ ] | filtros en la plataforma, modificables, `origInvoiceDate` | La parte superior &gt; Fecha de factura original &gt; La fecha en la que se basa el cálculo de la fecha de vencimiento y de la fecha de descuento por pronto pago.Solo se utiliza si el ajuste "Usar fecha de factura original" está activo en las preferencias de AR.De forma predeterminada, en un documento nuevo, es la fecha de negocio actual, pero puede cambiarla. |
| `paymentMethod_description` | `varchar2` | Descripción de la forma de pago | [ ] | filtros en la plataforma, modificables, `paymentMethod.description` | Haga clic en la lupa. &gt; La descripción. |
| `paymentMethod_id` | `varchar2` | ID del método de pago | [ ] | filtros en la plataforma, modificables, `paymentMethod.id` | Haga clic en la lupa. &gt; El identificador. |
| `postPeriod` | `varchar2` | Período de publicación | [ ] | filtros en la plataforma, modificables, `postPeriod` | La parte superior &gt; Período de contabilización &gt; El período en el que debe contabilizarse el documento.Formato AAAAMM. |
| `project_description` | `varchar2` | Descripción del Proyecto | [ ] | filtros en la plataforma, modificables, `project.description` | Haga clic en la lupa. &gt; La descripción. |
| `project_id` | `varchar2` | Identificación del Proyecto | [ ] | filtros en la plataforma, modificables, `project.id` | Haga clic en la lupa. &gt; El identificador. |
| `project_internalId` | `int32` | itgen_vnet_project_internalid | [ ] | filtros en la plataforma, modificables, `project.internalId` | El identificador interno. |
| `referenceNumber` | `varchar2` | Número de Referencia | [ ] | filtros en la plataforma, modificables, `referenceNumber` | La parte superior &gt; Núm. de ref. &gt; El número de referencia del documento del libro mayor de clientes en el sistema. |
| `status` | `varchar2` | Status | [ ] | filtros en la plataforma, modificables, `status` | La parte superior &gt; Estado &gt; El estado del documento, que puede ser uno de los siguientes: En espera, Equilibrado, Anulado, Programado, Abierto, Cerrado, Pendiente de imprimir, Pendiente de correo electrónico. |
| `subaccount_active` | `char` | Subcuenta activa 2 | [ ] | filtros en la plataforma, modificables, `subaccount.active` | Activo &gt; El estado del identificador. |
| `subaccount_description` | `varchar2` | Descripción de la subcuenta | [ ] | filtros en la plataforma, modificables, `subaccount.description` | Descripción &gt; La descripción del identificador. |
| `subaccount_errorInfo` | `varchar2` | Mensaje de error de la subcuenta | [ ] | filtros en la plataforma, modificables, `subaccount.errorInfo` |  |
| `subaccount_lastModifiedDateTime` | `datetime` | Última modificación de la subcuenta | [ ] | filtros en la plataforma, modificables, `subaccount.lastModifiedDateTime` | Información generada por el sistema. |
| `subaccount_metadata_maxPageSize` | `int64` | Tamaño máximo de página de los metadatos de la subcuenta | [ ] | filtros en la plataforma, modificables, `subaccount.metadata.maxPageSize` |  |
| `subaccount_metadata_totalCount` | `int64` | Recuento total de metadatos de subcuentas | [ ] | filtros en la plataforma, modificables, `subaccount.metadata.totalCount` |  |
| `subaccount_subaccountId` | `int32` | ID de subcuenta | [ ] | filtros en la plataforma, modificables, `subaccount.subaccountId` | SubID &gt; El identificador de la subcuenta. |
| `subaccount_subaccountNumber` | `varchar2` | Número de subcuenta | [ ] | filtros en la plataforma, modificables, `subaccount.subaccountNumber` | Campo obligatorio: Subcuenta* &gt; El número de la subcuenta.Formato 9-XX. |
| `subaccount_timeStamp` | `blob` | itgen_vnet_subaccount_timestamp | [ ] | filtros en la plataforma, modificables, `subaccount.timeStamp` | La marca de tiempo de la subcuenta, utilizada para el control de concurrencia. |
| `vatTotal` | `double` | Total con IVA incluido | [ ] | filtros en la plataforma, modificables, `vatTotal` | La parte superior &gt; Total de IVA &gt; El importe del IVA del documento, según se define en la pestaña Detalles de IVA. |
| `vatTotalInCurrency` | `double` | Total del IVA en Moneda | [ ] | filtros en la plataforma, modificables, `vatTotalInCurrency` | Cálculo en segundo plano que proporciona el total del IVA en su moneda predeterminada.Este campo se aplica si el importe se indica en una moneda distinta de su moneda predeterminada. |

## Teclas

| Key | Column | Se refiere a | Kind | Description |
|---|---|---|---|---|
| `CustomerDocuments_account_number_fk` | `account_number` | [Accounts](VismaNet.Account.Accounts)`.accountCD` | Key |  |
| `CustomerDocuments_branchNumber_number_fk` | `branchNumber_number` | [Branches](VismaNet.Branch.Branches)`.number` | Key |  |
| `CustomerDocuments_branch_number_fk` | `branch_number` | [Branches](VismaNet.Branch.Branches)`.number` | Key |  |
| `CustomerDocuments_currencyId_fk` | `currencyId` | [Currencies](VismaNet.Currency.Currencies)`.id` | Key |  |
| `CustomerDocuments_customer_number_fk` | `customer_number` | [Customers](VismaNet.Customer.Customers)`.number` | Key |  |
| `CustomerDocuments_location_countryId_fk` | `location_countryId` | [Countries](VismaNet.Country.Countries)`.id` | Key |  |
| `CustomerDocuments_paymentMethod_id_fk` | `paymentMethod_id` | [PaymentMethods](VismaNet.PaymentMethod.PaymentMethods)`.paymentMethodID` | Key |  |
| `CustomerDocuments_project_id_txt` | `project_id` | [Projects](VismaNet.Project.Projects)`.projectID` | Textual | El proyecto, o el código de ningún proyecto cuando el documento no está asociado a un proyecto; ese código no tiene fila en Projects. |


## Notas de la Versión

Cambios introducidos en cada versión en las tablas, columnas, atributos y capacidades del controlador:

- [Visma.net Financials](/es/release-notes/drivers?driver=visma-net-financials)
