1. ItemRoutings
Sensio API
  • Introdução
  • People
    • Buscar pessoas cadastradas
      GET
    • Cadastrar uma nova pessoa
      POST
    • Encontrar pessoa pelo Id
      GET
  • Items
    • Cadastrar um novo item
      POST
    • Retorna uma lista de itens
      GET
    • Retorna um item específico
      GET
    • Editar item
      POST
    • Retorna as composições do item e/ou das variações
      GET
    • Remover um item
      DELETE
  • POs
    • Retorna todas as ordens de produção
      GET
    • Retorna uma ordem de produção específica
      GET
    • Retorna uma ordem de produção específica buscando pelo código
      GET
    • Alterar estágio de OP
      PUT
    • Listar estágios do kanban de OPs
      GET
    • Criar uma OP
      POST
    • Listar estágios do kanban de OPs
      GET
    • Remover uma OP
      DELETE
    • Editar OP
      PUT
  • Sales
    • Listar pedidos
      GET
    • Retorna um pedido específico
      GET
    • Retorna um pedido específico, buscando pelo código
      GET
    • Cadastrar um novo pedido
      POST
    • Cancelar um pedido
      PUT
    • Faturar um pedido
      PUT
    • Editar estágio de um pedido
      PUT
    • Listar estágios do kanban de pedidos
      GET
    • Aprovar orçamento
      PUT
    • Editar informações de envio de pedido
      PUT
  • NFes
    • Retorna XML da NFSe
    • Lista as NFes
    • Retorna uma NFe específica
    • Retorna DANFE da NFe
  • NFSes
    • Lista Notas Fiscais de Serviço
    • Retorna uma NFSe por id
    • Retorna XML da NFSe
    • Retorna PDF da NFSe
  • Transactions
    • Quitar lançamento financeiro
    • Retorna quitações paginadas
    • Retorna o PDF de boleto(s)
    • Cadastrar um novo lançamento financeiro
    • Retorna lançamentos paginados
    • Retorna um lançamento específico
  • Item Categories
    • Listar categorias de itens
  • Warehouses
    • Lista os depósitos
  • Custom Fields
    • Listar Campos Personalizados
  • Batches
    • Retorna lotes de um item
    • Listar lotes
  • Webhooks
    • Configurar webhook
  • Attachments
    • Upload de anexos para documentos
  • Services
    • Retorna serviços cadastrados
  • Accounting
    • Retorna contas contábeis
    • Retorna categorias financeiras
    • Retorna categoria financeira
    • Retorna centros de custos
  • CTes
    • Retorna CTes
    • Retorna CTe pelo id
  • Cargos
    • Editar o status de uma carga
    • Criar uma carga
    • Listar cargas
    • Retorna uma carga por id
  • Inventory
    • Movimentar estoque
  • Tags
    • Listar Tags
  • PriceLists
    • Listar tabelas de preços
    • Retorna tabela de preço por id
    • Atualizar preços de itens em uma tabela
  • MoneyAccounts
    • Listar contas bancárias
  • Resources
    • Listar recursos (máquinas)
    • Retorna recurso por id
  • Operations
    • Listar operações
    • Retorna operação por id
  • ItemRoutings
    • Retorna roteiro de um item
    • Retorna roteiro de uma OP
    • Iniciar operação de uma OP
    • Pausar operação de uma OP
    • Finalizar operação de uma OP
  • Raiz
    • DownTimes
      • Listar tipos de parada
      • Registrar parada de recurso
    • WorkOrders
      • Listar ordens de serviço
      • Criar ordem de serviço
      • Listar estágios de ordens de serviço
      • Alterar estágio de ordem de serviço
      • Marcar ordem de serviço como finalizada via API
    • ItemRoutings
      • Executar ações em lote nas operações de OPs
        POST
  • Tasks
    • Listar tarefas
    • Listar tarefas de um documento
    • Criar tarefa
    • Editar tarefa
    • Excluir tarefa
  • Esquemas
    • Schemas
      • Roteiro de uma OP
    • Response
    • Operações de uma OP
    • moneyAccount
    • clientRelation
    • nfse
    • InventoryMoveRequest
    • PriceListItemsUpdateError
    • PublicProductionError
    • batch
    • SuccessResponse
    • PublicProductionDownTimeType
    • accounts
    • ErrorResponse
    • PublicProductionStage
    • cte
    • PublicProductionAssetSummary
    • stage
    • PublicProductionPlanSummary
    • cargo
    • PublicProductionPersonSummary
    • tag
    • PublicProductionStageSummary
    • typeOfCharacteristics
    • PublicProductionStatusHistory
    • symbolCharacteristics
    • PublicProductionStageHistory
    • typePlanReaction
    • PublicProductionPartInput
    • paymentCondition
    • PublicProductionPartRecord
    • activityType
    • PublicProductionWorkOrder
    • frequency
    • PublicProductionCreateWorkOrder
    • typeOfMethodControl
    • PublicProductionStageUpdate
    • evaluationType
    • PublicProductionAlreadyFinish
    • processType
    • PublicProductionDownTimeInput
    • controlPlan
    • PublicProductionDownTime
    • supplierItem
    • PublicProductionBulkItem
    • dimensionControlPlan
    • PublicProductionBulkInput
    • instrumentDimension
    • PublicProductionBulkResult
    • category
    • PublicProductionBulkOperationError
    • costCenter
    • PublicProductionBulkResponse
    • priceList
    • resource
    • operation
    • itemRouting
    • item
    • composition
    • view_composition
    • view_compositionChild
    • compositionChild
    • saleListObject
    • webHookURL
    • createNFeBody
    • salePostObject
    • sale
    • person
    • Person
    • transactionPostObject
    • transaction
    • po
    • service
    • dimensions
    • itemType
    • veic
    • variation
    • image
    • nfe
    • warehouseListObj
    • nfeListObj
    • userInfo
    • inline_response_500
    • register_item_response_200
    • request_register_item
    • request_edit_item
    • response_error
    • inline_response_200
    • inline_response_403
    • inline_response_200_1
    • inline_response_200_2
    • inline_response_200_3
    • inline_response_201
    • inline_response_200_4
    • inline_response_404
    • inline_response_200_5
    • inline_response_401
    • inline_response_201_1
    • inline_response_200_6
    • inline_response_200_7
    • inline_response_200_8
    • inline_response_200_9
    • inline_response_401_1
    • item_tags
    • get_compositions
    • item_warehouses
    • item_config
    • item_ecommerces
    • item_ativo
    • item_customFields
    • item_updates
    • salePostObject_payments
    • salePostObject_sellersInfo
    • salePostObject_tags
    • salePostObject_saleLines
    • salePostObject_acquirer
    • sale_payments
    • sale_events
    • sale_saleLines
    • sale_attachments
    • sale_updates
    • Person_address
    • Person_integrations
    • transactionPostObject_payments
    • transaction_sharingCost_fields
    • transaction_sharingCost
    • transaction_attachments
    • transaction_emailsSends
    • transaction_updates
    • po_tasks
    • po_sales
    • po_items
    • po_itemsDone
    • po_events
    • po_customFields
    • po_updates
    • service_updates
    • nfe_dest_enderDest
    • nfe_dest
    • nfe_prod
    • nfe_impostos_ICMS
    • nfe_impostos_IPI
    • nfe_impostos_PIS
    • nfe_impostos_COFINS
    • nfe_impostos
    • nfe_items
    • nfe_total
    • userInfo_userInfo_companies
    • userInfo_userInfo
    • ErrorServer
    • Forbidden
  1. ItemRoutings

Executar ações em lote nas operações de OPs

Em desenvolvimento
POST
/pos/operations/bulk
Executa start, pause e end em operações de uma ou mais OPs da empresa. Envie de 1 a 500 seleções em items. Cada seleção exige poId, action e itemId ou sectors não vazio. Com sectors, seleciona todas as operações dos setores informados e ignora o filtro itemId/variationId; no-sector inclui operações sem setor. Uma seleção pode expandir para várias operações. Sem sectors, variationId omitido/null seleciona o item sem variação. Datas startTime/endTime e offset ficam no nível principal, e são compartilhados pelas seleções. Recursos/fornecedores e identificadores operacionais são resolvidos pelo servidor conforme roteiro, disponibilidade e configuração da empresa. As regras de PCP continuam sendo aplicadas. Tipos de parada, paradas e operadores informados são verificados na empresa antes do processamento. Em start, downTimeId deve pertencer ao recurso resolvido; em pause, downTimeType pode criar uma parada. A execução é sequencial por OP e não é atômica. Um erro posterior não reverte operações já gravadas. Erros individuais de execução entram em errors, enquanto results contém apenas as operações bem-sucedidas. HTTP 200 e success=true não significam que todas as operações tiveram sucesso: confira errors e warnings. Falhas de validação geral, consulta de OP ou conflito de data por setor podem interromper a requisição com erro HTTP, inclusive após apontamentos anteriores. OPs sem operações selecionáveis podem produzir results vazio. Com PCP desabilitado, a consulta pode não encontrar operações. Somente campos documentados são encaminhados; não é possível escolher resourceId, operationHash, status ou campos de controle internos pelo payload. Não reenvie indiscriminadamente o lote após falha; reconcilie o estado das operações e trate cada resultado.
Autenticação: envie Authorization: Bearer <chave da API pública do Sensio ERP>. Use uma chave atual vinculada a um usuário ativo da empresa; empresa e autoria são determinadas pelo servidor. Não envie company, user, permissões, _id ou histórico para controlar a gravação. IDs documentados são strings hexadecimais de 24 caracteres. Datas devem ser ISO 8601. Textos recebidos são aparados e limitados a 10000 caracteres, salvo indicação específica. A API usa o limite de 25 requisições por minuto por empresa. Chaves revogadas ou substituídas são rejeitadas.

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples
{
    "items": [
        {
            "poId": "507f1f77bcf86cd799439013",
            "itemId": "507f1f77bcf86cd799439014",
            "variationId": null,
            "action": "start"
        }
    ],
    "startTime": "2026-11-07T12:00:00.000Z",
    "offset": 180
}

Códigos de solicitação

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/pos/operations/bulk' \
--header 'Authorization: Bearer SEU_TOKEN_AQUI' \
--header 'Content-Type: application/json' \
--data '{
    "items": [
        {
            "poId": "507f1f77bcf86cd799439013",
            "itemId": "507f1f77bcf86cd799439014",
            "variationId": null,
            "action": "start"
        }
    ],
    "startTime": "2026-11-07T12:00:00.000Z",
    "offset": 180
}'

Respostas

🟢200OK
application/json
Operação concluída.
Bodyapplication/json

Examples
{
    "success": true,
    "results": [
        {
            "poId": "507f1f77bcf86cd799439013",
            "itemId": "507f1f77bcf86cd799439014",
            "operationHash": "507f1f77bcf86cd799439016",
            "action": "start",
            "response": {
                "response": {
                    "_id": "507f1f77bcf86cd799439015",
                    "status": "Produzindo",
                    "operationHash": "507f1f77bcf86cd799439016"
                },
                "warnings": []
            }
        }
    ],
    "errors": [],
    "warnings": []
}
🟠400Pedido Inválido
🟠402
🟠403Proibido
🟠404Registo Não Encontrado
🟠429
🔴500Erro do Servidor
Modificado em 2026-11-08 01:46:30
Página anterior
Marcar ordem de serviço como finalizada via API
Próxima página
Listar tarefas
Built with