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 type: ‘Product’ ou ‘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:
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:
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:
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.
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.
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.
