Aquí entraremos en detalle sobre la obtención, creación, actualización y eliminación de elementos de pedido.
Se puede acceder a los elementos del pedido desde el punto final /phaser-order-rows.
Obtención de posiciones de pedido #
Obtienes los elementos del pedido enviando una solicitud GET al punto final /phaser-order-rows:
Puedes buscar los artículos del pedido según distintos parámetros:
- phaser_orden_id
- id de pedido interno de Skyplanner, se puede encontrar desde el punto final /phaser-orders-endpoint
- external_id
- Identificador externo de la posición de pedido
- Por ejemplo, el identificador único de tu sistema externo (ERP, etc.)
- production_planning_product_id
- ID interno del producto Skyplanner
- Se puede encontrar desde el punto final /productos
- parent_id
- Si un artículo de pedido tiene subartículos (por ejemplo, subproductos), los subartículos tienen el identificador de su artículo de pedido padre en el campo parent_id
- índice_filas
- Número de índice de la posición de pedido
- número de trabajo
- El valor del número de trabajo de la posición de pedido
- estado
- Estado de la posición del pedido
- Valores permitidos: nuevo, iniciado o completado
- posición
- El valor de posición de la posición de pedido
- fecha_entrega
- La fecha de entrega del artículo del pedido
- Formato: 2025-06-05T22:00:00+00:00
- condición_fecha_entrega
- Condición opcional de búsqueda de fecha de entrega
- Opciones: >, =, <=, =, !=
- Si no se da ningún valor, se utilizará >= condición
- es_prospecto
- Devuelve sólo los artículos del pedido que sean prospectos
- incluir_archivados
- Incluir pedidos archivados (borrados suavemente) en la búsqueda
- Denotado por el valor is_archive
- modificado
- Devuelve los artículos del pedido que se hayan modificado después de una fecha determinada
- Formato: 2025-06-05T22:00:00+00:00
- condición modificada
- Condición opcional de búsqueda de valores modificados
- Opciones: >, =, <=, =, !=
- Si no se da ningún valor, se utilizará >= condición
También puedes mezclar y combinar los parámetros de búsqueda así:
Para obtener un elemento de pedido específico con su identificador interno de Skyplanner, puedes hacer una petición como ésta:
Crear posiciones de pedido #
¡Ten en cuenta que debes crear un pedido antes de crear la posición de pedido!
Para crear un elemento de pedido, envía una solicitud POST al punto final /phaser-order-rows:
Aquí tienes un resumen de los campos que puedes utilizar al crear una posición de pedido:
- phaser_orden_id
- Id. interno de Skyplanner de la Orden a la que se adjunta el elemento de la orden
- Campo obligatorio
- production_planning_order_row_id
- Después de exportar la orden al módulo de planificación de la producción de Skyplanner, se crea una entidad independiente llamada fila de orden de planificación de la producción y su id se establece en este campo
- No se recomienda utilizarlo (déjalo como nulo o no envíes este campo en el campo de solicitud)
- production_planning_product_id
- Id de producto de Skyplanner para el producto que produce la posición de pedido
- Necesario si quieres traer pasos de proceso por defecto de un producto
- external_id
- Identificador único de la posición de pedido
- Utilízalo para vincular la posición de pedido de Skyplanner a tu posición de pedido de un sistema externo (ERP, etc.)
- Debe ser único
- parent_id
- Si el artículo del pedido es un subartículo de otro artículo del pedido, indica aquí el valor del identificador del padre
- índice_filas
- En qué lugar de la lista de elementos del pedido se encuentra este elemento
- número de trabajo
- Sólo se utiliza como valor informativo del número de trabajo para la posición de pedido
- No visible en la interfaz de usuario de Skyplanner
- estado
- Estado de la posición del pedido
- Valores permitidos: nuevo, iniciado, listo, por fases
- es_archivo
- ¿Está archivada la posición de pedido (borrado suave)?
- posición
- Valor identificador de la posición de pedido (ver Fig 3.)
- importe
- Cantidad total fabricada de producto
- importe_pedido
- Cantidad pedida de producto
- precio
- Precio unitario del producto
- usar_materiales_personalizados
- Si no quieres utilizar la configuración por defecto del material a partir de los datos del producto, establece este valor como verdadero
- Por defecto: false
- usar_materiales_personalizados_calculados
- Las cantidades de material a medida se calculan en función de la cantidad de productos fabricados
- Si se establece en false, las cantidades de material son fijas
- Por defecto: false
- obtener_pasos_por_defecto
- Crea pasos de proceso para pedir un artículo basándote en los pasos de proceso predeterminados del producto
- Por defecto: false
- usar_duraciones_calculadas_del_trabajo
- Calcula la duración de los pasos del proceso basándote en los datos del registro de tiempo anterior
- Si no hay suficientes datos disponibles para calcular, se utilizan las duraciones por defecto
- Por defecto: false
- sub_elementos
- Crea también subartículos del producto si están disponibles
- Por defecto: false
- fecha_entrega
- Formato: 2022-01-01 10:30:11
- fecha_de_elegibilidad_inicial
- Formato: 2022-01-01 10:30:11
- identificador_dibujo
- Identificador de dibujos/impresos/instrucciones
- descripción
- Descripción del pedido
- descripción_adicional
- Descripción adicional de la posición de pedido
- es_prospecto
- ¿El artículo del pedido es un prospecto
- Por defecto: false
Actualizar posiciones de pedido #
Para actualizar los datos de los artículos del pedido puedes enviar una solicitud PUT al punto final /phaser-order-rows:
Borrar posiciones de pedido #
El borrado de elementos de pedido se realiza mediante un método de “borrado suave”. En efecto, borrar un elemento de pedido cambia su valor
Al borrar una posición de pedido, el sistema también borrará los pasos del proceso asociados.
Puedes eliminar elementos de pedido enviando una solicitud DELETE al punto final /phaser-order-rows:
Puedes eliminar elementos del pedido indicando los ids internos del Skyplanner en la matriz “ids” o los ids externos en la matriz “ids_externos “.