---
title: Crear un pedido
description: "Aquí encontrarás una guía completa sobre cómo crear un pedido en Skyplanner con todos los datos relacionados. Parte de esto ya se ha tratado en el [tutorial de](https://skyplanner.ai/ro/docs/tutorial-de-integrare/) integración, pero aquí repasamos la estructura de datos de Skyplanner y el…"
url: "https://skyplanner.ai/es/docs/crear-un-pedido/"
updated: "2025-10-07"
category: Integraciones
tags:
  - API
  - Integración
---

# Crear un pedido

Aquí encontrarás una guía completa sobre cómo crear un pedido en Skyplanner con todos los datos relacionados. Parte de esto ya se ha tratado en el [tutorial de](https://skyplanner.ai/ro/docs/tutorial-de-integrare/) integración, pero aquí repasamos la estructura de datos de Skyplanner y el proceso de integración con más detalle.

#### Estructura de datos

Primero veremos cómo se estructura un pedido de Skyplanner. Los [puntos finales de la API](https://integration.skyplanner.app/api/swagger) para las entidades de datos mencionadas aquí están resaltados así: /pedidos-phaser

En el nivel superior tenemos el **pedido**(/pedidos-phaser)

Cada **pedido** *debe*tener un **cliente**(/clientes).

Cada **pedido** puede tener varios **elementos de pedido**(/phaser-order-rows)

Cada **artículo-pedido** *puede* tener un **producto**(/productos) adjunto, pero no es obligatorio. Cada **producto** tiene un **stock**(/saldos). Ten en cuenta que la entidad stock se crea automáticamente cuando se crea un producto con la API.

Cada **artículo-pedido** puede tener varios **trabajos**(o pasos del proceso)(/phaser-jobs).

Cada **trabajo** *debe*tener una **etapa de trabajo**(/etapas de trabajo).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Fig. 1** Estructura del pedido y datos relacionados

#### Flujo de trabajo de integración

Aquí tienes un ejemplo paso a paso de cómo podrías estructurar tu integración desde tu sistema ERP a Skyplanner.

1. Obtener ventas/pedidos de trabajo del ERP
2. Crear **cliente**(obtener id de cliente en la respuesta)
3. Crear **pedido** con id de cliente (obtener id de pedido en respuesta)
4. Obtén datos de ventas/pedido de trabajo del ERP
5. Crear **producto** (obtener id de producto en la respuesta)
6. Crea **un elemento de pedido** con el id de pedido y otros datos (obtén el id de elemento de pedido en la respuesta)
7. Obtener los datos de las etapas del proceso desde el ERP
8. Crear **escenario de trabajo** (obtener id de escenario de trabajo en la respuesta)
9. Crea **un trabajo** con el identificador de la fase de trabajo y otros datos

#### Consejos adicionales

##### Al borrar

La eliminación de phaser-orders, phaser-order-items o phaser-jobs a través de la API (y desde la interfaz de usuario) se realiza de forma *suave*. Esto significa que los datos no se borran realmente de la base de datos, sino que se marcan como *archivados*. En efecto, el atributo is_archive de la entidad se establece en true cuando se borra. Todavía se puede acceder a las entidades archivadas/eliminadas con la API utilizando el parámetro include_archived. Cuando include_archived=true, una petición GET recuperará la entidad aunque esté archivada.

**Ten en cuenta que el borrado suave no está disponible en todos los puntos finales de la API. Así que debes tener cuidado, ya que eliminar, por ejemplo, clientes, personas, etc., ¡es permanente!**

##### Utilizar pasos de proceso predeterminados para tu posición de pedido

Si has creado algunos pasos de proceso predeterminados para el producto que está produciendo tu elemento de pedido, puedes indicar al sistema que lleve los predeterminados al elemento de pedido con la API utilizando el atributo **get_default_steps**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Fig. 2.** Crear una nueva posición de pedido con pasos de proceso predeterminados

##### Añadir materiales a la posición de pedido

Si has adjuntado materiales al producto fabricado, se adjuntan automáticamente a la línea del pedido.

Sin embargo, si no quieres utilizar los materiales adjuntos al producto (por ejemplo, si el artículo es un pedido especial y quieres utilizar materiales diferentes, etc.) puedes utilizar el atributo **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Fig. 3.** Crear una posición de pedido sin utilizar los materiales por defecto