---
title: Pedir artículos
description: "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…"
url: "https://skyplanner.ai/es/docs/pedir-articulos/"
updated: "2025-10-08"
category: Integraciones
tags:
  - API
  - Integración
---

# Pedir artículos

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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Fig. 1.** Obtención de posiciones de pedido

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

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Fig. 2.** Ordenar índices de filas de artículos

- **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

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Fig 3. Valores 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í:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Fig. 4.**Obtención de elementos de pedido por **phaser_order_id**y **row_index**

Para obtener un elemento de pedido específico con su identificador interno de Skyplanner, puedes hacer una petición como ésta:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Fig. 5.** Obtención de un elemento de pedido con el id 4 de Skyplanner

#### 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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Fig** **6.** Crear una posición de pedido

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Fig. 7.** Elemento de pedido creado

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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Fig. 8.**Actualizar una posición de pedido

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Fig. 9.**Posición de pedido actualizada

#### 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 is_archive a true. Esto significa que puedes restaurar los elementos de pedido borrados actualizando el valor is_archive a false.

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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Fig. 10.**Borrar posiciones de pedido

Puedes eliminar elementos del pedido indicando los ids internos del Skyplanner en la matriz **"ids"** o los ids externos en la matriz **"ids_externos** ".