A chamada insert

A chamada insert é usada para criar um novo registro (entidade) de um tipo específico com os valores especificados.

A solicitação insert - além dos argumentos normais de ID de logon e senha, a chamada insert também requer os seguintes argumentos:      

Durante uma inserção, não é necessário especificar todos os campos desse tipo de entidade. A maioria dos campos é opcional, exceto aqueles marcados como obrigatórios na resposta de descrição, indicados pelo atributo 'anulável' com o valor booleano '0'. Os campos não especificados são definidos como em branco ou com valores padrão. Os campos muito longos são truncados.

Quando você enviar valores de campo não reconhecidos na solicitação insert, a API do serviço web rejeitará a chamada. Como resultado, o código de status 300 é transmitido, conforme indicado pela seguinte mensagem:

Rejecting the value that is supplied for input data element "{ 0} "; due to a correlation failure because the data transformation process could not resolve the supplied input data element into native format.

A API aplica uma definição estrita dos valores de campo não reconhecidos, de modo que todos os campos da chamada precisem ser válidos para o usuário da operação.

Por exemplo:

• A API rejeita chamadas que especificam um valor para um campo personalizado que tenha sido excluído ou removido do acesso de um usuário.
• A API rejeita chamadas que especificam campos somente leitura.

Para alguns tipos de entidades, se você inserir um registro que já existia, a API não insere novos registros.

A resposta de insert

A resposta padrão do serviço para todas as chamadas de API conterá o identificador de registro (ID de linha) de um registro que está sendo inserido no formato de saída solicitado para uma chamada insert.