Incluir/atualizar registro

POST 
/IT2001

Inclui/atualiza registros pela chave PERNR + BEGDA, em data[] no corpo application/json. Se encontra exatamente um registro, aplica binding sobre ele; se encontra mais de um, exclui todos e inclui o recebido. SUBTY não restringe a busca do POST (mas integra a chave do DELETE). Não trate esta chamada como atualização parcial: o binding recebe uma entidade montada com o payload.

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": "2001",
      "PERNR": 900001,
      "SEQNR": 1
    }
  ]
}

completo

Payload completo ilustrativo

{
  "data": [
    {
      "ABRST": 1,
      "ABRTG": 1,
      "ABWTG": 1,
      "AEDTM": "2026-01-15",
      "AINFT": "X",
      "ALLDF": "X",
      "ANRTG": 1,
      "AUFKZ": "X",
      "AWART": "X",
      "AWORG": "X",
      "AWREF": "X",
      "AWTYP": "X",
      "BEGDA": "2026-01-15",
      "BEGUZ": "X",
      "BEGVA": 1,
      "BONDT": "2026-01-15",
      "BWGRL": 1,
      "DOCNR": 1,
      "DOCSY": "X",
      "ENDDA": "2026-01-15",
      "ENDUZ": "X",
      "FAPRS": "X",
      "FLAG1": "X",
      "FLAG2": "X",
      "FLAG3": "X",
      "FLAG4": "X",
      "GENER": "X",
      "GRPVL": "X",
      "HISTO": "X",
      "HRSIF": "X",
      "INFTY": "2001",
      "ITBLD": "X",
      "ITXEX": "X",
      "KALTG": 1,
      "KBBEG": "2026-01-15",
      "KENN1": 1,
      "KENN2": 1,
      "KRGED": "2026-01-15",
      "LFZED": "2026-01-15",
      "LOGSYS": "X",
      "MANDT": "X",
      "MLDDA": "2026-01-15",
      "MLDUZ": "X",
      "NXDFL": "X",
      "OBJPS": "X",
      "OCRSN": "X",
      "ORDEX": "X",
      "OTYPE": "X",
      "PAYID": "X",
      "PAYTY": "X",
      "PERNR": 900001,
      "PLANS": 1,
      "PRAKN": "X",
      "PRAKZ": 1,
      "PREAS": "X",
      "PSARB": 1,
      "REFEX": "X",
      "REFNR": "X",
      "RESE1": "X",
      "RESE2": "X",
      "RMDDA": "2026-01-15",
      "RMDUZ": "X",
      "SEQNR": 1,
      "SPPE1": "2026-01-15",
      "SPPE2": "2026-01-15",
      "SPPE3": "2026-01-15",
      "SPPIN": "X",
      "SPRPS": "X",
      "STDAZ": 1,
      "STKRV": "X",
      "STUND": "X",
      "SUBTY": "X",
      "TDLANGU": "X",
      "TDSUBLA": "X",
      "TDTYPE": "X",
      "TRFGR": "X",
      "TRFST": "X",
      "UMSCH": "X",
      "UMSKD": "X",
      "UNAME": "X",
      "UNFAL": "X",
      "URMAN": "X",
      "VORGS": "X",
      "VTKEN": "X",
      "WAERS": "X",
      "ZKMKT": "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...