---
title: Produtos e materiais
description: "Aqui vamos ver como podes criar produtos e materiais e como os podes anexar às tuas encomendas com a Skyplanner-API. Também te mostraremos como criar etapas de processo predefinidas para os teus produtos e como criar itens de encomenda utilizando…"
url: "https://skyplanner.ai/pt-pt/docs/produtos-e-materiais/"
updated: "2025-10-07"
category: Integrações
tags:
  - API
  - Integração
---

# Produtos e materiais

Aqui vamos ver como podes criar produtos e materiais e como os podes anexar às tuas encomendas com a Skyplanner-API. Também te mostraremos como criar etapas de processo predefinidas para os teus produtos e como criar itens de encomenda utilizando essas predefinições.

#### Criar um produto/material

A criação e atualização de produtos e materiais é feita através do mesmo ponto de extremidade da API: /products. O tipo de produto é definido pelo **atributo de tipo**: 'product' ou 'material'

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**Fig. 1.** Criar um produto

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**Fig. 2.** Criar um material

Ao criar produtos e materiais, certifica-te de que defines o valor **is_active** como true se quiseres que o produto/material seja mostrado como ativo na listagem de produtos. Tem também em atenção que podes definir a quantidade de stock disponível com o atributo **free_amount**.

#### Criar etapas de processo padrão para um produto

Antes de adicionar etapas de processo padrão para um produto, precisas de ter as workstages apropriadas. As estações de trabalho podem ser criadas através da interface do utilizador do Skyplanner ou do ponto final /workstages.

A adição de etapas de processo padrão é feita a partir do ponto final /products/jobs/{productId}.

Por exemplo, se quiseres adicionar um passo por defeito ao produto com o ID 22220, deves fazer um pedido POST como este:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**Fig. 3.** Adicionando uma etapa de processo padrão

Alguns campos notáveis:

- número_de_ordem
  - Este é um número de índice que indica à Skyplanner a ordem pela qual as etapas do processo devem ser concluídas
  - Por exemplo: o primeiro passo recebe o valor 1, o segundo passo recebe o valor 3, o terceiro passo recebe o valor 3 e assim por diante...
- estações de trabalho
  - Esta é uma lista de estações de trabalho para as quais esta etapa do processo pode ser agendada
  - Apresenta os IDs das estações de trabalho como uma lista separada por vírgulas, assim: "61,62,63"
- variação_temporal
  - Valores possíveis: time_per_pcs, pcs_per_time, fixed_time
- duração, tempo de fixação, tempo de fixação
  - Apresenta estes valores em *segundos*

#### Atualização de uma etapa de processo predefinida

Ao atualizar uma etapa de processo predefinida, tens de utilizar o atributo **order_number** para especificar qual a etapa a atualizar.

Por exemplo, o primeiro passo do processo**(número_de_ordem 1**) neste produto é feito com um pedido PUT como este:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**Fig. 4.** Atualização de uma etapa de processo predefinida

#### Eliminar etapas de processo predefinidas

A eliminação de etapas de processo predefinidas também é feita utilizando os valores **order_number**.

Os Order_numbers são fornecidos numa matriz como esta:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**Fig. 5.** Eliminar etapas de processo predefinidas

##### Adiciona um material/subproduto a um produto

Para anexar um material ou subproduto, tens de utilizar o ponto final /subprodutos.

O processo é bastante simples: colocamos o id do material ou subproduto no atributo **production_planning_product_id** e o id do produto ao qual queremos que o material/subproduto esteja ligado no atributo **production_planning_product_parent_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**Fig. 6.** Colocar um material num produto

##### Adiciona um material ao item de ordem

Também podes anexar materiais diretamente a um item de encomenda, utilizando o ponto de extremidade /row-materials. Desta forma, é possível anexar materiais adicionais ou utilizar uma lista de materiais completamente diferente dos materiais predefinidos definidos para os produtos num item de encomenda. Tem em atenção que só podes ter uma entidade row-material para um item de encomenda para cada material. Assim, não podes criar duas entidades com o mesmo **production_planning_product_id**para o mesmo **phaser_order_row_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**Fig. 7.** Acrescentar um material a um item de ordem

#### Atualizar o nível de existências

Podes atualizar o nível de existências do produto ou do material enviando um pedido PUT com o atributo **free_amount**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**Fig. 8.** Atualizar o nível de existências