Synchronize work orders batch between customer ERP and PlantScanner bases.
POST
/api/v1/WorkOrders/synchronize
additionalQuestions)aparecem para o operador junto com o checklist do SKU, na mesma etapa (
sequence), e
são copiadas para o histórico da ordem quando ela é finalizada.
type: Photo (foto), Registration (matrícula do operador),
Numeric (número), Date (data), Time (hora), DateTime (data e hora),
Text (texto curto), LongText (texto longo) e Dropdown (lista de opções, com options).key identifica a pergunta nos reenvios. Sem key, a descrição é usada.group e a mesma sequence ficam no mesmo bloco.isArray: true transforma o grupo em lista (o operador responde o grupo várias vezes).
Todas as perguntas do grupo precisam ter o mesmo
isArray.required torna o grupo obrigatório.min, max e canExceed só valem para Numeric.options é obrigatório em Dropdown (sem itens vazios ou repetidos) e não vale nos outros tipos.null), o checklist da ordem não muda. Lista vazia remove as perguntas
que ainda não têm resposta. Pergunta já respondida nunca é removida nem muda de tipo.
"workOrdersDetails": [
{
"materialCode": "PSMT-20",
"code": "PS01-2020",
"workOrders": [
{
"status": 1,
"operationCode": "MIX",
"requestedQuantity": 2000,
"additionalQuestions": [
{ "key": "BATELADA", "sequence": 0, "group": "Pesagem", "order": 0,
"description": "Qual o valor da batelada?", "type": "Numeric",
"isArray": true, "required": true, "min": 0, "max": 500, "canExceed": false },
{ "key": "FOTO_BATELADA", "sequence": 0, "group": "Pesagem", "order": 1,
"description": "Foto da balança", "type": "Photo", "isArray": true },
{ "key": "RESPONSAVEL", "sequence": 0, "group": "Liberação", "order": 0,
"description": "Matrícula do responsável", "type": "Registration", "required": true },
{ "key": "DATA_LIBERACAO", "sequence": 0, "group": "Liberação", "order": 1,
"description": "Data da liberação", "type": "Date" },
{ "key": "HORA_INICIO", "sequence": 0, "group": "Liberação", "order": 2,
"description": "Hora de início da mistura", "type": "Time" },
{ "key": "FIM_MISTURA", "sequence": 0, "group": "Liberação", "order": 3,
"description": "Data e hora do fim da mistura", "type": "DateTime" },
{ "key": "LOTE_RESINA", "sequence": 0, "group": "Liberação", "order": 4,
"description": "Lote da resina", "type": "Text" },
{ "key": "RESULTADO", "sequence": 0, "group": "Liberação", "order": 5,
"description": "Resultado da inspeção visual", "type": "Dropdown",
"options": ["Aprovado", "Reprovado", "Retrabalho"] },
{ "key": "OBS", "sequence": 0, "group": "Liberação", "order": 6,
"description": "Observações da produção", "type": "LongText" }
]
}
]
}
]
}
Requisição
Parâmetros Body
application/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.plantscanner.io/api/v1/WorkOrders/synchronize' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"workOrdersDetails": [
{
"materialCode": "string",
"code": "string",
"workOrders": [
{
"status": "ReadyToExecute",
"operationCode": "string",
"note": "string",
"requestedQuantity": 0,
"producedGoodQuantity": 0,
"properties": [
{
"key": "string",
"value": "string",
"name": "string",
"isLocked": true
}
],
"materials": [
{
"code": "string",
"sequence": 0,
"quantity": 0,
"isReadOnly": true,
"hasBatch": true,
"consumedRawMaterials": [
{
"quantity": 0,
"serialNumber": "string"
}
]
}
],
"additionalQuestions": [
{
"key": "BATELADA",
"sequence": 0,
"group": "Pesagem",
"order": 0,
"description": "Qual o valor da batelada?",
"type": "Numeric",
"isArray": true,
"required": true,
"min": 0,
"max": 500,
"canExceed": false,
"options": [
"string"
]
}
]
}
],
"serialNumber": "string",
"customer": "string",
"promiseDate": "2019-08-24T14:15:22.123Z"
}
]
}'Response Response Example
200 - Exemplo 1
{
"affectedMaterials": {
"created": 0,
"updated": 0,
"terminated": 0
},
"affectedProcesses": {
"created": 0,
"updated": 0,
"terminated": 0
},
"affectedWorkOrders": {
"created": 0,
"updated": 0,
"terminated": 0
}
}Modificado em 2026-10-22 19:45:42