Informações Importantes

Esclarecimentos sobre campos/grupos do XML

Cada metódo possui a sua estrutura que deve ser respeitada, não podendo remover as tags do XML, apenas enviando ela em branco neste formato.

Exemplo: </tagseminformação> ou <tagseminformação></tagseminformação>

A informação da coluna “Obrig” indica se o campo é obrigatório no método ou não.

A coluna “Permite Alteração” indica se o campo permite alteração de dados ou não.

A Coluna Pai indica a estrutura hierárquica de relacionamento entre os grupos.

Exemplo 1:

a) Se o “Pai” é opcional (0-1) e não for informado, mesmo o “filho” sendo obrigatório (1-1) este não será considerado.

b) Se o “Pai” é opcional (0-1) e for informado, sendo o “filho” obrigatório (1-1) este será exigido

Exemplo 2:

a) Se o “Grupo” é opcional (0-1) somente serão exigidos os “campos” obrigatorios (1-1) se o grupo for informado

A informação contida na coluna “Ocor” (Quantidade de Ocorrências), indica se o campo/grupo é obrigatório ou opcional e, se permite ou não múltiplas ocorrências, sendo:

0-1 => Opcional, podendo existir uma única ocorrência ou o campo pode deixar de ser enviado

0-n => Opcional, podendo existir múltiplas ocorrências ou o campo pode deixar de ser enviado

1-1 => Obrigatório, podendo existir somente uma ocorrência

1-n => Obrigatório, podendo existir múltiplas ocorrências

Observações importantes quanto a coluna “Ocor”:

– Quando houver obrigatoriedade em um “grupo” (1-1), observar os campos desse grupo que devem necessariamente serem enviados (1-1 ou 1-n).

– Quando o “grupo” for opcional (0-1), os campos desse grupo identificados como obrigatórios (1-1) somente serão exigidos se o “grupo” for enviado no processo.

Campos obrigatórios para alteração/inclusão (chaves de acesso): iCd_CnpjUnidNeg e sCd_Placa e sTp_Veiculo. Se esses atributos nao forem enviados ou seu conteúdo for nulo, não haverá processamento da requisição.

Observações importantes no fornecimento de informações para integração

1 – Ao enviar o XML ao Webservice, observar que estrutura contida na tabela apresentada em cada método deve ser respeitada, considerando:

a) Todos os grupos e atributos os grupos e atributos do grupo devem ser enviados integralmente

b) Respeitar a ordem em que foram expostos na tabela

c) Observar que o conteúdo do campo deve ser coerentes ao “datatype” vinculado

d) Caso um grupo seja opcional e não queira utiliza-lo, informar todos os atributos com conteúdo igual a “espaço” (string) ou zeros (numéricos)

e) Caso um atributo seja opcional, informar em seu conteúdo zeros ou espaços respeitando o datatype vinculado ao campo

Caso algum grupo e/ou atributo não seja enviado ocasionara erro na requisição e a mesma não será aceita para processamento:

2 – Todo campo “string” enviado com conteúdo em “branco” ou ainda campos numéricos enviados com conteúdo igual a “zero” não serão tratados pelo processo de integração. A integração fará o mesmo tratamento como se o campo não tivesse sido enviado.

3 – Caso queira alterar o conteúdo de um campo “string” para “brancos”, deverá informar no campo uma constante “EMPTY” (letras maiúsculas sem espaços), para que a integração proceda a alteração desse campo para “branco”, respeitando as validações do campo.

4 – Observar as informações de validação contidas no campo de observações na tabela acima pois são importantes para o sucesso da integração.