Incluir/atualizar registro

POST 
/IT1001

Recebe registros organizacionais no body application/json em data[]. A busca de registros existentes usa MANDT + PLVAR + OTYPE + OBJID + INFTY + RSIGN + RELAT + BEGDA + ISTAT. Registros encontrados são excluídos antes da inclusão; campos opcionais omitidos não são preservados.

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": "1001",
      "ISTAT": "X",
      "MANDT": 1,
      "OBJID": 1,
      "OTYPE": "X",
      "PLVAR": "X",
      "RELAT": "X",
      "RSIGN": "X"
    }
  ]
}

completo

Payload completo ilustrativo

{
  "data": [
    {
      "ADATA": "X",
      "AEDTM": "2026-01-15",
      "BEGDA": "2026-01-15",
      "ENDDA": "2026-01-15",
      "HISTO": "X",
      "INFTY": "1001",
      "ISTAT": "X",
      "ITXNR": 1,
      "MANDT": 1,
      "OBJID": 1,
      "OTYPE": "X",
      "PLVAR": "X",
      "PRIOX": "X",
      "PROZT": 1,
      "REASN": "X",
      "RELAT": "X",
      "RSIGN": "X",
      "SCLAS": "X",
      "SEQNR": 1,
      "SOBID": "X",
      "UNAME": "X",
      "VARYF": "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...