Protocolo de envio e recepção de usuários
Tamanho Tipo Descrição
Envio Pedido Separador
? asc Quantidade de usuários. +
1 asc I para inclusão, E para exclusão, A para alteração e L para limpar a lista[1] [
? asc Índice do usuário[2] [
? asc Nome do usuário[3] [
0 asc Reservado [
? asc Quantidade de referências, fixa em 1 [
? asc Referência do usuário, até 20 dígitos[4]  
Resposta Separador
? asc Quantidade de usuários processados. +
? asc Resultado da operação em cada usuário (separado por "[" )  
 
 
 
Recepção Pedido Separador
? asc Quantidade de usuários. +
1 asc Indice desejado (ver comentário)[5] ]
? asc Índice do usuário que será buscado (somente quando indice desejado for -1)[6]  
Resposta Separador
? asc Quantidade de usuários processados. +
? asc Índice do usuário [
? asc Nome do usuário [
0 asc Reservado [
? asc Quantidade de referências [
? asc Cartões do usuário separados por "}"  
Exemplos
Envia períodos
Pedido <SB><XXXX><II>+EU+00+2+I[1535[Eduardo[[1[1535]E[123456789013[Marcio[[1[123456789013<CS><EB>[7]
Resp. <SB><XXXX><II>+EU+00+2+00]22<CS><EB>[8]
Recebe períodos
Pedido <SB><XXXX><II>+RU+00+1]0<CS><EB>
Resp. <SB><XXXX><II>+RU+00+1+1535[Eduardo[[1[1535<CS><EB>
Legenda  
<SB> Start byte 0x02
<XXXX> Quantidade de dados ?
<II> Índice da mensagem ?
<CS> Checksum ?
<EB> EndByte 0x03
[1]
I ou A

No caso de inclusão ou alteração os parâmetros devem ser obrigatoriamente informados.


E

No caso de exclusão não há necessidade de informar os parâmetros além do índice do usuário.


L

No caso de exclusão da lista completa não há necessidade de informar nenhum parâmetro.
[2]
Identificador genérico do usuário, usar a referência atrelada a ele.
[3]
Nome do usuário não deve passar de 20 caracteres
[4]
Deve ser colocado neste campo todos as referencias do usuário.
Quando for uma inserção todos estes cartões serão inseridos com valor padrão, já em caso de alteração de usuário só haverá modificação nos cartões caso algum novo seja inserido ou um que já existia tenha sido excluído da lista.

Para inserir um usuário com informações de cartão insira ele com todas as referencias aqui e depois envie um comando de cartão, como alteração para cada referencia.
[5]
>= 0:  Íncide base para leitura dos usuários.

-1: Indica que deverá ser executada uma busca por índice específico.

Receber 5 usuários à partir do índice 0
Ex: 5]0

Receber o usuário 15.
Ex: 1]-1]15

Obs: Sempre deve ser informado a quantidade de usuários no primeiro campo.
[6]
Este campo só vai ser adicionado no pedido no caso de um pedido com filtro.
[7]
Enviando 2 usuários:

Operação: I – Inserção
Indice: 123456789012
Nome: Eduardo
Reservado
Qtde. cartões: 2
Cartões: 1535 e 6587


Operação: E - Exclusão
Indice: 123456789013
Nome: Marcio
Reservado
Qtde. cartões: 1
Cartões: 678987

[8]
A resposta será individual para cada usuário:

“00]22”

O integrador deverá conferir cada uma das respostas. As respostas serão retornadas para cada usuário na mesma ordem em que foram recebidos.


Neste exemplo o integrador tentou adicionar o usuário “Eduardo” e excluir o usuário “Marcio”, porém o usuário “Marcio” não existia e o retorno foi 22 – usuário não cadastrado. O usuário “Eduardo” foi corretamente adicionado (resposta = 00)