<< <%SKIN-STRTRANS-SYNTOC%> >> Navegação:  Manual de INTEGRAÇÃO > Recurso WebServices > Geração de Log para os WebServices > WebService General > Operação addCustomer e UpdateCustomer

Operação addCustomer e UpdateCustomer

Essa operação permite adicionar ou atualizar um Cliente na base do Qualitor.

Permissão necessária: Acesso ao menu “Administração / Clientes / Clientes”, nas permissões de usuário e grupo, do Qualitor.

Verificar parâmetro: “Somente administradores podem editar ou adicionar clientes e contatos” em “Administração / Requisições / Parâmetros”. Caso este parâmetro esteja ativo, o usuário do WebService deve ser administrador para executar esta operação.

 

 

Caso não seja passado o cdcliente no XML de entrada, é gerado o cdcliente auto-increment.

 

 

•XML de entrada:

 (Informações em vermelho são obrigatórios)

 <?xml version=”1.0” encoding=”ISO-8859-1”?>

 <wsqualitor>

<contents>

 <data>

         <nmcliente>Customer Name...</nmcliente>

                 <cdcliente>COD002</cdcliente>

                 <nrcpfcnpj>00000000000</nrcpfcnpj>

                 <nrie>00000000000</nrie>

                 <dsendereco>Address...</dsendereco>

                 <nrcep>00000000</nrcep>

                 <dscomplemento>...</dscomplemento>        

 <dsemail >email@cliente.com</dsemail>        

                 <nmbairro></nmbairro>                        

                 <cdmodeloemail></cdmodeloemail>                        

                 <nrpaistelefone></nrpaistelefone>

                 <nrareatelefone></nrareatelefone>

                 <nrtelefone></nrtelefone>

                 <nrpaiscelular></nrpaiscelular>

                 <nrareacelular></nrareacelular>

                 <nrcelular></nrcelular>

                 <nrpaisfax></nrpaisfax>

                 <nrareafax></nrareafax>

                 <nrfax></nrfax>

                 <cdcidade></cdcidade>

<nrpadraokm></nrpadraokm>

<idfaturadespesa></idfaturadespesa>

<idativo></idativo>

<dsobservacao></dsobservacao>

         </data>

         <responsibles>

                 <technicians>

                 <cdusuario></cdusuario> Código dos usuários responsáveis

<cdusuario></cdusuario>                …

</technicians>

         </responsibles>

 <attributes>

<cdatributo1></cdatributo1>                        valor do atribuído

                 <cdatributo2></cdatributo2>                        idem

<cdatributo3></cdatributo3>                        idem

                 <cdatributo4></cdatributo4>                        idem

                 <cdatributo5></cdatributo5>                        idem

                 <cdatributo6></cdatributo6>                        idem

                 <cdatributo7></cdatributo7>                        idem

         </attributes>

 </contents>

</wsqualitor>

 

•XML de retorno:

<?xml version=”1.0” encoding=”ISO-8859-1”?>

<wsqualitor>

 <responsestatus>

         <status>1</status>                           Retorna 1 para OK ou 0 para ERRO

         <error_code></error_code>                Se ocorrer erro na operação, o código do erro será retornado                

            <msg></msg>                Mensagem de retorno da operação

 </responsestatus>

 <responsedata>

         <dataitem>

<cdcliente>COD002</cdcliente>                        Código do cliente criado

<dtoperacao>1900-01-13 11:42</dtoperacao>                Data de criação do cliente

         </dataitem>

 </responsedata>

        <wsqualitor>

 

Observações:

✓ O sistema pode retornar um erro, nesta operação, indicando que o código de cliente informado já existe.

✓ Ao cadastrar um cliente, por padrão, o sistema irá cadastrá-lo como ATIVO, caso não seja informada tag IDATIVO no XML.

✓ Pode ocorrer erro em caso de falha de permissões

✓ Pode ocorrer erro em caso de informar um código de um registro de vínculo (exemplo: cidade) que não exista.