Incluir/atualizar registro

POST 
/IT1008

Recebe registros organizacionais no body application/json em data[]. A busca de registros existentes usa MANDT + PLVAR + OTYPE + OBJID + INFTY + BEGDA + ISTAT. Os campos SUBTY também restringem a busca quando preenchidos; omiti-los amplia a seleção. Na versão revisada, o serviço consulta IT1000 antes de inserir IT1008; a substituição de registros IT1008 precisa ser confirmada/corrigida na implementação antes de ser assumida pela integração.

Request

application/json

Body

Body

required

Corpo JSON; os campos não são parâmetros de URL.

data

object[]

required

Lista de registros. Envie ao menos um registro para executar a operação.

Array [

]

minimo

Payload mínimo ilustrativo

{
  "data": [
    {
      "BEGDA": "2026-01-15",
      "ENDDA": "2026-01-15",
      "INFTY": "1008",
      "ISTAT": "X",
      "MANDT": 1,
      "OBJID": 1,
      "OTYPE": "X",
      "PLVAR": "X",
      "SEQNR": 1
    }
  ]
}

completo

Payload completo ilustrativo

{
  "data": [
    {
      "AEDTM": "2026-01-15",
      "BEGDA": "2026-01-15",
      "BTRTL": "X",
      "BUKRS": "X",
      "ENDDA": "2026-01-15",
      "GSBER": "X",
      "HISTO": "X",
      "INFTY": "1008",
      "ISTAT": "X",
      "ITXNR": 1,
      "KOKRS": "X",
      "MANDT": 1,
      "OBJID": 1,
      "OTYPE": "X",
      "PERSA": "X",
      "PLVAR": "X",
      "PRIOX": "X",
      "REASN": "X",
      "SEQNR": 1,
      "SUBTY": "X",
      "UNAME": "X",
      "VARYF": "X",
      "WERKS": "X"
    }
  ]
}

Responses

200

Sucesso

application/json

Schema

Schema

success booleanrequired
message stringnullable
data object[]nullable

Example (from schema)

{
  "success": true,
  "message": "string",
  "total": 0,
  "data": [
    {}
  ]
}

sucesso

Sucesso ilustrativo

{
  "success": true,
  "message": null,
  "total": 1,
  "data": null
}

400

O serviço retornou success false. PUT sem IDs existentes, dependentes sem sucesso, ou falha tratada na consulta de ocorrências. Não representa todas as falhas de validação.

application/json

Schema

Schema

success booleanrequired
message stringnullable
data object[]nullable

Example (from schema)

{
  "success": true,
  "message": "string",
  "total": 0,
  "data": [
    {}
  ]
}

semProcessamento

Resultado negativo do serviço, ilustrativo

{
  "success": false,
  "message": null,
  "total": 0,
  "data": null
}

401

Nao autorizado

application/json

Schema

Schema

property name* any

Example (from schema)

{}

ilustrativo

Exemplo legado, dependente do serviço de autenticação

{
  "success": false,
  "message": "Authorization expirado ou inexistente."
}

500

Exceção no binding, validação ou processamento. Pode ocorrer ao faltar campo obrigatório. Mensagem/cause dependem da exceção.

application/json

Schema

Schema

message stringnullablerequired

Example (from schema)

{
  "success": false,
  "message": "string"
}

excecao

Exceção ilustrativa; mensagem depende do erro

{
  "success": false,
  "message": "Falha ao processar a requisição."
}

validacao

Formato da mensagem gerada pelo binding/validação

{
  "success": false,
  "message": "[xfield: begda, rejectedValue: null, message: Mensagem de validação do framework]"
}

Loading...