Facturas por cobrar
Una factura por cobrar a un cliente, registrada como partida abierta en la cuenta por cobrar.
- Nombre API:
financesinvoices - Dominio: Finanzas
- Módulos: Análisis de ventas, Análisis financiero, Ventas, Tiendas, Finanzas
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Nombre | label | Texto | ||
| Folio | uid | Texto | Folio interno de esta factura. | |
| Fecha de la factura | date | Fecha | Sí | Fecha calendario de este valor. |
| Devolución | salesorderreturnId | Referencia | ||
| Devolución | storereturnId | Referencia | ||
| Venta | storepossaleId | Referencia | ||
| Proyecto | projectId | Referencia | ||
| Cliente | customerId | Referencia | Sí | |
| Sucursal | customerbranchId | Referencia | ||
| Contacto | customercontactId | Referencia | ||
| Usuario | userId | Usuario | ||
| Empresa relacionada | companyIdPartner | Referencia | ||
| Factura por cobrar origen | financesinvoiceIdSource | Referencia | ||
| Referencia del cliente | customerReference | Texto | La referencia propia del cliente para este documento, como su número de orden de compra. | |
| Tipo de documento | class | Constante | Sí | La factura aumenta la cuenta por cobrar. La nota de crédito reduce la factura de origen. |
| Moneda de cotización | currency | Constante | Sí | Moneda de esta factura. El tipo de cambio convierte los importes a la moneda contable. |
| Fecha de vencimiento | dateDue | Fecha | Sí | Fecha de calendario sin hora. |
| Importe aplicado | amountApplied | Moneda | Sí | Parte de la nota de crédito aplicada al saldo de la factura origen al emitir. No es una aplicación de pago. |
| Importe de recargo | amountRecharge | Moneda | Importe monetario en la moneda que corresponde a este registro. | |
| Fecha del tipo de cambio | dateFxrateSource | Fecha | Fecha del tipo de cambio usado para la conversión. | |
| Condición de pago | financespaymenttermId | Referencia | ||
| Tipo de cambio | fxrate | Decimal | Sí | Unidades de moneda contable por 1 unidad de la otra moneda. Use 1 cuando las dos monedas son la misma. |
| Impuestos en el precio | priceBasis | Constante | Sí | Si el precio unitario incluye el impuesto (bruto) o lo excluye (neto). |
| Saldo pendiente | balance | Moneda | Sí | Importe pendiente en la moneda del documento. |
| Descuento | discount | Moneda | Sí | Importe en la moneda del documento o de la partida. |
| Total a pagar | totalPayable | Moneda | Sí | Importe monetario en la moneda que corresponde a este registro. |
| Redondeo | rounding | Moneda | Sí | Importe monetario en la moneda que corresponde a este registro. |
| Subtotal | subtotal | Moneda | Sí | Suma de importes de partida antes de impuestos y retenciones en este documento. |
| Impuesto | tax | Moneda | Sí | Importe de impuesto para este ámbito, en moneda del documento, según el motor fiscal configurado. |
| Retención | withholding | Moneda | Sí | Importe de la retención, no una tasa. |
| Total | total | Moneda | Sí | Suma de partidas a 6 decimales. Cobro y PDF usan el total pagadero en unidades menores de la moneda; la diferencia aparece como partida de redondeo. |
| Motivo del crédito | creditReason | Constante | Opción fija del conjunto permitido para este campo. | |
| Motivo de cancelación | cancelReason | Campo de Texto | Explicación obligatoria al cancelar este registro. | |
| Tags | tagIds | Tags | ||
| Descripción | description | Campo de Texto | ||
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Enviado por | sentBy | Usuario | ||
| Enviado el | sentAt | Fecha y Hora | ||
| Cancelado por | canceledBy | Usuario | ||
| Cancelado el | canceledAt | Fecha y Hora | ||
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
| Campo | Apunta a | Tipo |
|---|---|---|
Devolución salesorderreturnId | Devoluciones de venta | referencia |
Devolución storereturnId | Devoluciones de tienda | referencia |
Venta storepossaleId | Ventas de PDV | referencia |
Proyecto projectId | Proyectos | referencia |
Cliente customerId | Clientes | referencia |
Sucursal customerbranchId | Sucursales de cliente | referencia |
Contacto customercontactId | Contactos de cliente | referencia |
Usuario userId | Usuarios | referencia |
Empresa relacionada companyIdPartner | Empresas | referencia |
Factura por cobrar origen financesinvoiceIdSource | Facturas por cobrar | referencia |
Condición de pago financespaymenttermId | Condiciones de pago | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook financesinvoices.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea una factura. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios de la factura. | App · API · MCP · CLI |
| Emitir | send | Emitir esta factura. El saldo pendiente y la póliza usan esta acción. | App · API · MCP · CLI |
| Cancelar | cancel | Revierte el efecto registrado de la acción. | App · API · MCP · CLI |
| Revocar enlaces externos | revoke | Revocar los enlaces externos activos de la factura por cobrar. | App · API · MCP · CLI |
| Compartir externamente | share | Publicar y enviar un enlace externo a este documento. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar la factura. Sigue visible y puede seguir en documentos existentes. Desbloquéala para volver a cambiarla. | App · API · MCP · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar la factura. | App · API · MCP · CLI |
| Archivar | archive | Retira la factura del uso diario. Sale de las listas y los selectores activos, y la mayoría de las acciones se detienen. Desarchívala para restaurarla. | App · API · MCP · CLI |
| Restaurar | unarchive | Devuelve la factura a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina la factura y los datos que le pertenecen. No se puede deshacer. | App · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.
Eventos
Momentos a los que el registro llega por sí solo. Suscríbete a ellos con un webhook.
| Nombre | Evento de webhook | Descripción |
|---|---|---|
| Vencida | financesinvoices.overdue | La factura pasó su fecha de vencimiento con saldo pendiente. |
| Seguida | financesinvoices.followed | Las personas que siguen esta factura reciben aviso. |