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 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 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-items)
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).
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.
- Obtener ventas/pedidos de trabajo del ERP
- Crear cliente (obtener id de cliente en la respuesta)
- Crear pedido con id de cliente (obtener id de pedido en respuesta)
- Obtén datos de ventas/pedido de trabajo del ERP
- Crear producto (obtener id de producto en la respuesta)
- Crea un elemento de pedido con el id de pedido y otros datos (obtén el id de elemento de pedido en la respuesta)
- Obtener los datos de las etapas del proceso desde el ERP
- Crear escenario de trabajo (obtener id de escenario de trabajo en la respuesta)
- 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.
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.
