---
title: Encomenda artigos
description: "Aqui, abordamos em pormenor a procura, a criação, a atualização e a eliminação de itens de encomenda. Os itens de encomenda podem ser acedidos a partir do ponto de extremidade /phaser-order-rows. #### Obtenção de itens de ordem Obtém os itens…"
url: "https://skyplanner.ai/pt-br/docs/encomenda-artigos/"
updated: "2025-10-08"
category: Integrações
tags:
  - API
  - Integração
---

# Encomenda artigos

Aqui, abordamos em pormenor a procura, a criação, a atualização e a eliminação de itens de encomenda.

Os itens de encomenda podem ser acedidos a partir do ponto de extremidade /phaser-order-rows.

#### Obtenção de itens de ordem

Obtém os itens da encomenda enviando um pedido GET para o ponto de extremidade /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Fig. 1.** Obtenção de itens de ordem

Podes procurar itens de encomenda por uma variedade de parâmetros diferentes:

- **phaser_order_id**
  - id interno **da encomenda**Skyplanner, que pode ser encontrado no /phaser-orders-endpoint
- **external_id**
  - Identificador externo do item da ordem
  - Por exemplo, o identificador único do teu sistema externo (ERP, etc.)
- **production_planning_product_id**
  - ID interna do produto Skyplanner
  - Pode ser encontrado no /products-endpoint
- **id_pai**
  - Se um item de encomenda tiver subitens (por exemplo, subprodutos), os subitens têm o ID do item de encomenda principal no campo parent_id
- **índice_de_linha**
  - Número de índice do item de ordem

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Fig. 2.** Ordena os índices de linha do item

- **número de trabalho**
  - O valor do número de trabalho do item de ordem
- **estatuto**
  - Status do item da ordem
  - Valores permitidos: **novo**, **iniciado** ou **concluído**
- **posição**
  - O valor da posição do item da ordem

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Figura 3. Valores de posição do item de ordem

- **data_de_entrega**
  - A data de entrega do item da ordem
  - Formato: **2025-06-05T22:00:00+00:00**
- **condição_data_de_entrega**
  - Condição facultativa de pesquisa da data de entrega
  - Opções: >, =, <=, =, !=
  - Se não for indicado nenhum valor, será utilizada a condição **>=**
- **is_prospect**
  - Devolve apenas os artigos de encomenda que são prospectos
- **inclui_arquivado**
  - Inclui itens de ordem arquivados (apagados suavemente) na busca
  - Denotado pelo valor **is_archive**
- **modificado**
  - Devolve os itens da ordem que foram modificados após uma determinada data
  - Formato: **2025-06-05T22:00:00+00:00**
- **modifiedCondition**
  - Condição opcional da pesquisa de valores modificados
  - Opções: >, =, <=, =, !=
  - Se não for indicado nenhum valor, será utilizada a condição **>=**

Também podes misturar e combinar os parâmetros de pesquisa desta forma:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Figura 4.**Obtenção de itens de encomenda por **phaser_order_id**e **row_index**

Para ir buscar um item de encomenda específico com o seu ID Skyplanner interno, podes fazer um pedido como este:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Fig. 5.** Obtenção de um item de encomenda com a identificação Skyplanner 4

#### Criar itens de ordem

Nota que tens de criar uma **ordem** antes de criar o item de ordem!

Para criar um item de encomenda, envia um pedido POST para o ponto de extremidade /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Fig.** **6.** Cria um item de ordem

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Fig. 7.** Criou um item de ordem

Segue-se uma síntese dos campos que podes utilizar ao criar um item de ordem:

- **phaser_order_id**
  - ID interna da Skyplanner para a **encomenda** à qual o item da encomenda está associado
  - **Campo obrigatório**
- **production_planning_order_row_id**
  - Depois de a ordem ser exportada para o módulo de planeamento da produção da Skyplanner, é criada uma entidade separada, designada por **linha de ordem de planeamento da produção**, e a sua identificação é definida neste campo
  - **Não se recomenda a utilização**(deixa como nulo ou não envia este campo de todo no campo do pedido)
- **production_planning_product_id**
  - ID do produto Skyplanner para o produto que o item da encomenda está a produzir
  - Necessário se quiseres trazer etapas de processo predefinidas de um produto
- **external_id**
  - Identificador único do item da ordem
  - Utiliza esta opção para ligar o item de encomenda Skyplanner ao teu item de encomenda de um sistema externo (ERP, etc.)
  - **Deve ser único**
- **id_pai**
  - Se o item de ordem for um subitem de outro item de ordem, fornece aqui o valor de id do pai
- **índice_de_linha**
  - Em que ponto da lista de itens da ordem este item está situado
- **número de trabalho**
  - Utilizado apenas como um valor informativo do número de trabalho para o item da ordem
  - Não visível na IU do Skyplanner
- **estatuto**
  - Estado do item da ordem
  - Valores permitidos: **novo, iniciado, pronto, faseado**
- **is_archive**
  - O item da ordem está arquivado (soft deleted)?
- **posição**
  - Valor do identificador do item da ordem (ver Fig. 3.)
- **quantidade**
  - Quantidade total fabricada do produto
- **valor_ordenado**
  - Quantidade encomendada do produto
- **preço**
  - Preço unitário do produto
- **utiliza_materiais_personalizados**
  - Se não quiseres utilizar a configuração de material predefinida a partir dos dados do produto, define este valor como verdadeiro
  - Predefinição: **false**
- **usa_materiais_personalizados_calculados**
  - As quantidades de material personalizado são calculadas com base na quantidade fabricada de produtos
  - Se for definido como falso, as quantidades de material são fixas
  - Predefinição: **false**
- **get_default_steps**
  - Cria etapas de processo para encomendar um item com base nas etapas de processo predefinidas do produto
  - Predefinição: **false**
- **usa_calculated_job_durations**
  - Calcula as durações das etapas do processo com base em dados anteriores do registo de tempo
  - Se não existirem dados suficientes para calcular, são utilizadas as durações por defeito
  - Predefinição: **false**
- **sub_itens**
  - Cria também os subitens do produto, se disponíveis
  - Predefinição: **false**
- **data_de_entrega**
  - Formata: 2022-01-01 10:30:11
- **data_de_início_da_elegibilidade**
  - Formata: 2022-01-01 10:30:11
- **identificador_do_desenho**
  - Identificador de desenho/impressão azul/instruções
- **descrição**
  - Descrição do item de encomenda
- **descrição_adicional**
  - Descrição adicional para o item de ordem
- **is_prospect**
  - O item da ordem é um prospeto
  - Predefinição: **false**

#### Atualização de itens da ordem

Para atualizar os dados dos itens da encomenda, podes enviar um pedido PUT para o ponto de extremidade /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Fig. 8.**Atualização de um item de ordem

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Fig. 9.**Item de ordem atualizado

#### Eliminar itens de ordem

A eliminação de itens de ordem é efectuada através de um método "soft delete". Com efeito, a eliminação de um item de encomenda altera o seu valor **is_archive** para true. Isto significa que podes restaurar os itens de encomenda eliminados actualizando o valor is_archive para false.

Ao eliminar um item de ordem, o sistema também elimina as etapas de processo associadas.

Elimina os itens da encomenda enviando um pedido DELETE para o ponto de extremidade /phaser-order-rows:

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

Podes eliminar itens de encomenda fornecendo os ids internos da Skyplanner na matriz **"ids"** ou os external_ids na matriz **"external_ids"**.