Incluir/atualizar registro

POST 
/IT0001

Inclui registros; substitui registros existentes encontrados pela chave PERNR + BEGDA. Envie os campos em data[] no corpo application/json. As propriedades dos infotipos são convertidas para minúsculas no binding; os exemplos usam a nomenclatura SAP. Campos opcionais omitidos não são preservados nesta substituiçã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": "0001",
      "PERNR": 900001
    }
  ]
}

completo

Payload completo ilustrativo

{
  "data": [
    {
      "ABKRS": "X",
      "AEDTM": "2026-01-15",
      "ANSVH": "X",
      "BEGDA": "2026-01-15",
      "BTRTL": "X",
      "BUDGET_PD": "X",
      "BUKRS": "X",
      "ENAME": "X",
      "ENDDA": "2026-01-15",
      "FISTL": "X",
      "FKBER": "X",
      "FLAG1": "X",
      "FLAG2": "X",
      "FLAG3": "X",
      "FLAG4": "X",
      "GEBER": "X",
      "GRANT_NBR": "X",
      "GRPVL": "X",
      "GSBER": "X",
      "HISTO": "X",
      "INFTY": "0001",
      "ITBLD": "X",
      "ITXEX": "X",
      "JUPER": "X",
      "KOKRS": "X",
      "KOSTL": "X",
      "MSTBR": "X",
      "OBJPS": "X",
      "ORDEX": "X",
      "ORGEH": 1,
      "OTYPE": "X",
      "PERNR": 900001,
      "PERSG": "X",
      "PERSK": "X",
      "PLANS": 1,
      "PREAS": "X",
      "REFEX": "X",
      "RESE1": "X",
      "RESE2": "X",
      "SACHA": "X",
      "SACHP": "X",
      "SACHZ": "X",
      "SBMOD": "X",
      "SEQNR": 1,
      "SGMNT": "X",
      "SNAME": "X",
      "SPRPS": "X",
      "STELL": 1,
      "SUBTY": "X",
      "UNAME": "X",
      "VDSK1": "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...