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:
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
- 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
- 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:
Para ir buscar um item de encomenda específico com o seu ID Skyplanner interno, podes fazer um pedido como este:
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:
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:
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:
Podes eliminar itens de encomenda fornecendo os ids internos da Skyplanner na matriz “ids” ou os external_ids na matriz “external_ids”.