Órdenes de compra
Autorización para comprar a un proveedor productos de inventario o bienes de ingeniería.
- Nombre API:
purchaseorders - Dominio: Compras
- Módulos: Análisis de compras, Compras
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 | El folio es un identificador único y legible para el registro. | |
| Día | date | Fecha | Sí | |
| Cotización (origen) | purchasequoteId | Referencia | ||
| Requisición | purchaserequisitionId | Referencia | ||
| Negocio | purchasedealId | Referencia | ||
| Proyecto | projectId | Referencia | ||
| Proveedor | supplierId | Referencia | Sí | |
| Contacto | suppliercontactId | Referencia | ||
| Responsable | userId | Usuario | ||
| Referencia del proveedor | supplierReference | Texto | Número de cotización o de orden del proveedor. | |
| Permitir sobrerecepción | allowOverReceipt | Binario | Sí | Si está activo, la regla o el comportamiento relacionado aplica a este registro. |
| Moneda de cotización | currency | Constante | Sí | |
| Nota de cierre parcial | shortCloseNote | Campo de Texto | ||
| Fecha del tipo de cambio | dateFxrateSource | Fecha | Fecha del tipo de cambio aplicado a este documento. | |
| Fecha de entrega | dateDelivery | Fecha | Fecha en que se espera que el proveedor entregue. | |
| Entrega | delivery | Constante | Dirección, método y calendario de entrega para el surtido. | |
| Incoterm | incoterm | Constante | ||
| Condición de pago | financespaymenttermId | Referencia | ||
| Tipo de cambio | fxrate | Decimal | Sí | Unidades de moneda contable por 1 unidad de la moneda del documento. Use 1 cuando las dos monedas son la misma. |
| Base del precio | priceBasis | Constante | Sí | Si el precio unitario incluye el impuesto (bruto) o lo excluye (neto). |
| Subtotal | subtotal | Precio unitario | Sí | Suma de importes de partida antes de impuestos y retenciones en este documento. |
| Cumplimiento fiscal | tax | Precio unitario | Sí | Importe de impuesto para este ámbito, en moneda del documento, según el motor fiscal configurado. |
| Retención | withholding | Precio unitario | Sí | Importe de retención fiscal retenido en este ámbito, en moneda del documento. |
| Total | total | Precio unitario | Sí | Total del documento tras descuentos, impuestos y retenciones en moneda del documento. |
| Motivo de cierre parcial | shortCloseReason | Constante | ||
| Motivo de cancelación | cancelReason | Campo de Texto | Explicación obligatoria al cancelar este registro. | |
| Tags | tagIds | Tags | ||
| Comentarios | comments | Campo de Texto | ||
| Datos | data | Datos | ||
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Finalizado por | endedBy | Usuario | ||
| Finalizado el | endedAt | Fecha y Hora | ||
| Aprobado por | approvedBy | Usuario | ||
| Aprobado el | approvedAt | Fecha y Hora | ||
| Cerrado por | closedBy | Usuario | ||
| Cerrado el | closedAt | 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 |
|---|---|---|
Cotización (origen) purchasequoteId | Cotizaciones de compra | referencia |
Requisición purchaserequisitionId | Requisiciones de compra | referencia |
Negocio purchasedealId | Negocios de compra | referencia |
Proyecto projectId | Proyectos | referencia |
Proveedor supplierId | Proveedores | referencia |
Contacto suppliercontactId | Contactos de proveedor | referencia |
Responsable userId | Usuarios | 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 purchaseorders.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea una orden. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios de la orden. | App · API · MCP · CLI |
| Aprobar | approve | Aprueba el documento para que el siguiente paso pueda continuar. | App · API · MCP · CLI |
| Cierre parcial | end | Cierra la cantidad no recibida y deja abierta la mercancía recibida sin facturar. | App · API · MCP · CLI |
| Cerrar | close | Impide nuevas referencias a la orden. Permanece, y los documentos existentes permanecen. Reabre para permitir referencias nuevas. | App · API · MCP · CLI |
| Reabrir | unclose | Permite de nuevo referencias nuevas a el cierre. | App · API · MCP · CLI |
| Cancelar | cancel | Revierte el efecto registrado de la acción. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar la orden. 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 orden. | App · API · MCP · CLI |
| Archivar | archive | Retira la orden 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 orden a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina la orden 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.