#Introdução

O Web Service GW SSL GSurf é um serviço, disponibilizado pela GSurf através de um servidor web seguro, que permite gerenciar os clientes de comunicação segura. Nele é possível criar novas contas, consultar situação das contas,adicionar e remover serviços, bloquear, desbloquear, cancelar, ativar contas e obter a chave de instalação do certificado.

#Web Service

O Web Service GSurf utiliza a especificação REST, sob o protocolo HTTP. Os métodos do Web Service retornam os dados em formato JSON e recebem os parâmetros no corpo da requisição (application/x-www-form-urlencoded).

Segue abaixo a URL utilizada para testes:

https://rest.homolog.gsurfnet.com/

URL utilizada em produção:

https://rest.gsurfnet.com/

Necessário enviar no Header das requesições o User-agent onde se define uma nomeclatura para o mesmo.

Exemplo:

#Autenticação

A autenticação é feita através de quatro parâmetros que devem ser enviados a cada requisição: chave do web service, usuário do web service, usuário da Central de Parceiros GSurf e um token dinâmico.
Estes dados são fornecidos pelo departamento comercial da GSurf.

#Token

O token é uma string de 40 caracteres que é renovada a cada requisição. Em cada resposta das requisições haverá um campo, chamado "token", que deve ser armazenado no sistema cliente para utilizar na próxima requisição.

Em alguns casos o campo "token" não aparecerá na resposta. Nestes casos o token que foi utilizado na requisição deve ser utilizado na próxima também.

Ou seja, só se deve sobrescrever o token caso o campo "token" esteja presente na resposta.
A primeira requisição do cliente ao web service não requer token. Porém, caso a resposta contenha o campo "token", as próximas requisições devem informar o token. Uma vez que o web service enviar o token não será mais possível realizar requisições sem ele.

#Parâmetros de autenticação

Os parâmetros de autenticação devem estar presentes em todas as requisições.

Parâmetros	Tipo	Descrição	Obrigatório
ws_key	Alfanumérico	Chave de acesso ao WebService fornecida pelo comercial da GSurf.	Sim
ws_user	Alfanumérico	Usuário de acesso ao WebService fornecido pelo comercial da GSurf.	Sim
username	Alfanumérico	Usuário de acesso à Central de Parceiros GSurf.	Sim
token	Alfanumérico	Token de acesso ao WebService.	Sim

#Métodos

#Políticas

#GET /policies

Retorna a lista de políticas comerciais que poderão ser atribuídas aos terminais cadastradas pelo parceiro.

Parâmetros	Tipo	Descrição
cnpj_retailer	Alfanumérico	Identificação (CNPJ) da revenda da qual se quer obter a lista de politicas. Omitir este campo caso obter queira obter a lista de serviços do próprio cadastro.

OBS : Não é obrigado a passar CNPJ podem consultar direto.

Retorno:

{
    "result": true,
    "policies": [
        {
            "id": 25,
            "description": "Politica 1"
        },
        {
            "id": 43,
            "description": "Politica 2"
        }
    ],
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#Serviços

#GET /services

Retorna a lista de serviços que poderão ser a tribuídos às contas cadastradas pelo parceiro.

Não é necessário passar parametros, basta rodar o endpoint passando os dados de acesso.

Parâmetros	Tipo	Descrição
cnpj_retailer	Alfanumérico	Identificação (CNPJ) da revenda da qual se quer obter a lista de politicas. Omitir este campo caso obter queira obter a lista de serviços do próprio cadastro.

Retorno:

{
    "result": true,
    "services": [
        {
            "id": 36,
            "description": "Servico1"
        },
        {
            "id": 97,
            "description": "Servico2"
        }
    ],
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#Clientes

#POST /customer-cpf

Cadastrar cliente com CPF. Apenas para parceiros cuja cobrança é ao parceiro.

Parâmetros	Tipo	Descrição	Obrigatório
cpf	Alfanumérico	CPF do cliente pessoa física.	Sim
name	Alfanumérico	Nome do cliente.	Sim
contact	Alfanumérico	Nome para contato.	Sim
ddd	Numérico	Ddd de contato.	Sim
phone	Alfanumérico	Telefone de contato.	Sim
email	Alfanumérico	Email de contato.	Sim
uf	Alfanumérico	UF de localização do cliente (contendo duas letras).	Sim
city	Alfanumérico	Cidade de localização do cliente.	Sim
cnpj_retailer	Numérico	Cnpj da revenda a qual o cliente pertence.	Não

Retorno:

{
    "result":true,
    "customer_id":"25",
    "error_message":"(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#POST /customer-cnpj

Cadastrar clientes com CNPJ.

Parâmetros	Tipo	Descrição	Obrigatório
CNPJ	Alfanumérico	Cnpj do cliente pessoa jurídica.	Sim
company_name	Alfanumérico	Razão social da empresa.	Sim
fantasy_name	Alfanumérico	Nome fantasia da empresa.	Sim
street	Alfanumérico	Rua de localização da empresa.	Sim
number	Numérico	Número de localização da empresa.	Sim
district	Alfanumérico	Bairro de localização da empresa.	Sim
complement	Alfanumérico	Complemento de localização da empresa.	Sim
cep	Alfanumérico	CEP de localização da empresa.	Sim
responsible	Alfanumérico	Responsável pela empresa.	Sim
responsible_cpf	Alfanumérico	CPF do responsável pela empresa.	Sim
contact	Alfanumérico	Nome para contato.	Sim
ddd	Numérico	Ddd de contato.	Sim
phone	Alfanumérico	Telefone de contato.	Sim
email	Alfanumérico	Email de contato.	Sim
uf	Alfanumérico	UF delocalização da empresa (contendo 2 letras).	Sim
city	Alfanumérico	Cidade de localização da empresa.	Sim
state_registration	Alfanumérico	Inscrição Estadual da empresa. Para ISENTO, não enviar.	Não
street_cob	Alfanumérico	Rua para os dados de cobrança. Caso não presente, é considerado o campo street.	Não
number_cob	Numérico	Número para os dados de cobrança. Caso não presente, é considerado o campo number.	Não
cep_cob	Alfanumérico	CEP para os dados de cobrança. Caso não presente, é considerado o campo cep.	Não
district_cob	Alfanumérico	Bairro para os dados decobrança. Caso não presente, é considerado o campo district.	Não
complement_cob	Alfanumérico	Complemento para os dados de cobrança. Caso não presente, é considerado o campo complement.	Não
city_cob	Alfanumérico	Cidade para os dados de cobrança. Caso nãopresente, é considerado o campo city.	Não
uf_cob	Alfanumérico	UF para os dados de cobrança (contendo 2 letras). Caso não presente, é considerado ocampo uf.	Não
cnpj_retailer	Numérico	Cnpj darevendaa qual o cliente pertence.	Não

Retorno:

{
    "result": true,
    "customer_id": "26",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#PUT /customer

Editar clientes.

Parâmetros	Tipo	Descrição	Obrigatório
CNPJ	Alfanumérico	Cnpj do cliente pessoa jurídica.	Sim
company_name	Alfanumérico	Razão social da empresa.	Não
fantasy_name	Alfanumérico	Nome fantasia da empresa.	Não
street	Alfanumérico	Rua de localização da empresa.	Não
number	Inteiro	Número de localização da empresa.	Não
district	Alfanumérico	Bairro de localização da empresa.	Não
complement	Alfanumérico	Complemento de localização da empresa.	Não
cep	Alfanumérico	CEP de localização da empresa.	Não
responsible	Alfanumérico	Responsável pela empresa.	Não
responsible_cpf	Alfanumérico	CPF do responsável pela empresa.	Não
contact	Alfanumérico	Nome para contato.	Não
ddd	Inteiro	Ddd de contato.	Não
phone	Alfanumérico	Telefone de contato.	Não
email	Alfanumérico	Email de contato.	Não
uf	Alfanumérico	UF de localização da empresa (contendo 2 letras).	Não
city	Alfanumérico	Cidade de localização da empresa.	Não
state_registration	Alfanumérico	Inscrição Estadual da empresa. Para ISENTO, não enviar.	Não
street_cob	Alfanumérico	Rua para os dados de cobrança. Caso não presente, é considerado o campo street.	Não
number_cob	Alfanumérico	Número para os dados de cobrança. Caso não presente, é considerado o campo number.	Não
cep_cob	Alfanumérico	CEP para os dados de cobrança. Caso não presente, é considerado o campo cep.	Não
district_cob	Alfanumérico	Bairro para os dados de cobrança. Caso não presente, é considerado o campo district.	Não
complement_cob	Alfanumérico	Complemento para os dados de cobrança. Caso não presente, é considerado o campo complement.	Não
city_cob	Alfanumérico	Cidade para os dados de cobrança. Caso não presente, é considerado o campo city.	Não
uf_cob	Alfanumérico	UF para os dados de cobrança (contendo 2 letras). Caso não presente, é considerado o campo uf.	Não
cnpj_retailer	Inteiro	Cnpj da revenda a qual o cliente pertence.	Não

Retorno:

{
    "result": true,
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#GET /customer

Busca clientes. Os parâmetros são usados como filtros para a busca.

Parâmetros	Tipo	Descrição	Obrigatório
CNPJ	Alfanumérico	Cnpj do cliente pessoa jurídica.	Não
company_name	Alfanumérico	Razão social da empresa.	Não
fantasy_name	Alfanumérico	Nome fantasia da empresa.	Não
street	Alfanumérico	Rua de localização da empresa.	Não
number	Inteiro	Número de localização da empresa.	Não
district	Alfanumérico	Bairro de localização da empresa.	Não
complement	Alfanumérico	Complemento de localização da empresa.	Não
cep	Alfanumérico	CEP de localização da empresa.	Não
responsible	Alfanumérico	Responsável pela empresa.	Não
responsible_cpf	Alfanumérico	CPF do responsável pela empresa.	Não
contact	Alfanumérico	Nome para contato.	Não
ddd	Inteiro	Ddd de contato.	Não
phone	Alfanumérico	Telefone de contato.	Não
email	Alfanumérico	Email de contato.	Não
uf	Alfanumérico	UF de localização da empresa (contendo 2 letras).	Não
city	Alfanumérico	Cidade de localização da empresa.	Não
state_registration	Alfanumérico	Inscrição Estadual da empresa. Para ISENTO, não enviar.	Não
street_cob	Alfanumérico	Rua para os dados de cobrança. Caso não presente, é considerado o campo street.	Não
number_cob	Inteiro	Número para os dados de cobrança. Caso não presente, é considerado o campo number.	Não
cep_cob	Alfanumérico	CEP paraos dados de cobrança. Caso não presente, é considerado o campo cep.	Não
district_cob	Alfanumérico	Bairro para os dados de cobrança. Caso não presente, é considerado o campo district.	Não
complement_cob	Alfanumérico	Complemento para os dados de cobrança.Caso não presente, é considerado o campo complement.	Não
city_cob	Alfanumérico	Cidade para os dados de cobrança. Caso não presente, é considerado o campo city.	Não
uf_cob	Alfanumérico	UF para os dados de cobrança (contendo 2 letras). Caso não presente,é considerado o campo uf.	Não
cnpj_retailer	Inteiro	Cnpj da revenda a qual o cliente pertence.	Não

Retorno:

{
    "result": true,
    "total": 2,
    "customers": [
        {
            "customer_id": "485",
            "cnpj_partner": "12345678912345",
            "cnpj": "12345678912345",
            "company_name": "CNPJ cadastro",
            "fantasy_name": "CNPJ cadastro",
            "contact": "John Doe",
            "city": "Garopaba",
            "uf": "SC",
            "ddd": "55",
            "phone": "111111111",
            "email": "johndoe@teste.com",
            "street": "Rua teste",
            "number": "0",
            "district": "Bairro",
            "complement": "Apt",
            "cep": "12345678",
            "responsible": "John Doe",
            "responsible_cpf": "12345678912",
            "street_cob": "Rua teste",
            "number_cob": null,
            "district_cob": "Bairro",
            "complement_cob": "Apt",
            "cep_cob": "12345678",
            "city_cob": "Garopaba",
            "uf_cob": "SC"
        },
        {
            "customer_id": "488",
            "cnpj_partner": "12345678912345",
            "cpf": "12345678912",
            "name": "Cliente CPF",
            "contact": "Fulano",
            "city": "Garopaba",
            "uf": "SC",
            "ddd": "48",
            "phone": "111111111",
            "email": "fulano@teste.com"
        }
    ],
    "error_message": ""
}

#GET /customer-retailer

Busca revendas. Os parâmetros são usados como filtros para a busca.

Parâmetros	Tipo	Descrição	Obrigatório
cnpj	Alfanumérico	Para filtrar as revendas pelo cnpj.	Não
company_name	Alfanumérico	Para filtrar as revendas pela razão social	Não
fantasy_name	Alfanumérico	Para filtrar as revendas pelo nomefantasia.	Não
is_active	Inteiro	Filtrar pelo status da revenda.	Não

Retorno:

{
    "result": true,
    "total": 2,
    "retailers": [
        {
            "is_active": "1",
            "company_name": "Alisson 1 Revenda 2",
            "fantasy_name": "Alisson 1 Revenda 2",
            "cnpj": "44160227000170",
            "responsible": "john doe",
            "responsible_cpf": "10558201911",
            "ddd": "11",
            "phone": "12345678",
            "email": "teste@teste.com"
        },
        {
            "is_active": "1",
            "company_name": "Alisson 1 Revenda 1",
            "fantasy_name": "Alisson 1 Revenda 1",
            "cnpj": "09959907000157",
            "responsible": "Alisson",
            "responsible_cpf": "10558201911",
            "ddd": "00",
            "phone": "00000000",
            "email": "alisson.pereira@gsurfnet.com"
        }
    ]
}

#Terminais

#GET /terminals

Retorna a lista de terminais de um determinado cliente.

Parâmetros	Tipo	Descrição	Obrigatório
client_id	Alfanumérico	Identificação (CNPJ) do cliente do qual se quer obter a lista de serviços. Omitir este campo caso obter queira obter a lista de serviços do próprio cadastro.	Não
cnpj_retailer	Alfanumérico	Cnpj da revenda a qual o cliente pertence.	Não
offset	Inteiro	Posição inicial da lista dentro do resultado dabusca.	Não
limit	Inteiro	Tamanho máximo da lista que será retornada.	Não
filter_description	Alfanumérico	Campo para filtrar pela descrição personalizada. Utilizar % como coringa.	Não
filter_status	Inteiro	Campo para filtrar por status.	Não

Retorno:

{
    "result": true,
    "total": 10,
    "terminals": [
        {
            "terminal_id": "abcd12345678901234a",
            "status": 1,
            "description": "Descricao personalizada",
            "services": [
                {
                    "id": "1",
                    "descricao": "Teste serviço",
                    "porta": "22084"
                }
            ],
            "installation_key": "12345678"
        },
        {
            "terminal_id": "abcd12345678901234b",
            "status": 8,
            "description": "Descricao personalizada",
            "services": [
                {
                    "id": "1",
                    "descricao": "Teste serviço",
                    "porta": "22084"
                }
            ],
            "installation_key": "87654321"
        }
    ],
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": ""
}

#POST /terminal-description

Altera a descrição de um terminal.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal	Sim
description	Alfanumérico	Descrição a ser atribuída ao terminal	Sim

Retorno:

{
    "result": true,
    "total": 10,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#GET /all-terminals

Listar terminais vinculados a um cliente.

Parâmetros	Tipo	Descrição	Obrigatório
cnpj_retailer	Alfanumérico	Cnpj da revenda a qual ocliente pertence.	Não

Retorno:

{
    "12345678901234": {
        "result": true,
        "total": 29,
        "terminals": [
            {
                "terminal_id": "sxgs12345678901234a",
                "status": 8,
                "description": null,
                "services": [
                    {
                        "id": "1",
                        "descricao": "Teste serviço",
                        "porta": "22084"
                    }
                ],
                "installation_key": "1234567890"
            }
        ]
    },
    "12345678901234_2": {
        "result": true,
        "total": 34,
        "terminals": [
            {
                "terminal_id": "sxgs12345678905678a",
                "status": 8,
                "description": null,
                "services": [],
                "installation_key": "109486831"
            }
        ]
    }
}

#GET /terminal-status

Retorna o código de situação do terminal.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim

Retorno:

{
    "result": true,
    "status": 1,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message":"(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#PUT /add-terminal

Adiciona novo terminal para um determinado cliente.

Parâmetros	Tipo	Descrição	Obrigatório
client_id	Alfanumérico	Identificação do terminal.	Sim
cnpj_retailer	Alfanumérico	Cnpj da revenda a qual ocliente pertence.	Não
model	Alfanumérico	Modelo do terminal.	Sim
policy_id	Inteiro	ID da política comerciala ser atribuída ao terminal, obtido no método GET/policies	Não
service_ids	Alfanumérico	Ids dos serviços a serem atribuídos ao terminal, separadospor vírgula.	Não
description	Alfanumérico	Descrição fornecida pelo parceiro.	Não

Retorno:

{
    "result": true,
    "terminals_id": "abcd12345678901234a",
    "installation_key": "12345678",
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message":"(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#POST /lock-terminal

Altera a situação de um terminal para bloqueado. Após bloqueado o terminal não poderá mais conectar ao servidor.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim

Retorno:

{
    "result": true,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#POST /unlock-terminal

Altera a situação de um terminal para ativo. Após desbloqueado o terminal poderá se conectar ao servidornormalmente.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim

Retorno:

{
    "result": true,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#POST /activate-terminal

Altera a situação de um terminal.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim

{
    "result": true,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#POST /cancel-terminal

Altera a situação de um terminal para cancelado.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim

Retorno:

{
    "result": true,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#POST /terminal-description

Altera a descrição de um terminal.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim
description	Alfanumérico	Descrição a ser atribuída ao terminal.	Sim

Retorno:

{
    "result": true,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#GET /terminal

Retorna os dados de um terminal.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim

Retorno:

{
    "result": true,
    "terminal": {
        "terminal_id": "abc12345678901234b",
        "status": 8,
        "description": "Descricao personalizada",
        "services": [
            {
                "id": "1",
                "descricao": "Teste 1",
                "porta": "4096"
            }
        ],
        "installation_key": "8765432190"
    },
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "Mensagem descrevendo o motivo do erro em caso o result seja false"
}

#GET /installation-key

Retorna a chave de instalação do certificado.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim

Retorno:

{
    "result": true,
    "installation_key": "8765432190",
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#PUT /add-services

Adiciona serviços ao terminal.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim
service_ids	Alfanumérico	Ids dos serviços a serem atribuídos ao terminal, separados por vírgula.	Sim

Retorno:

{
    "result": true,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#DELETE /remove-services

Remove serviços do terminal.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim
service_ids	Alfanumérico	Ids dos serviços a serem atribuídos ao terminal, separados por vírgula.	Sim

Retorno:

{
    "result": true,
    "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "error_message": "(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#PUT/reinstall-certificate

Habilita a reinstalaçãodo terminal.

ATENÇÃO: Utilizar essa opção inutiliza o terminal até sua próxima reinstalação. Método não habilitado para terminais do tipo mobile, por causa da forma que os mesmos são instalados.

Parâmetros	Tipo	Descrição	Obrigatório
terminal_id	Alfanumérico	Identificação do terminal.	Sim

Retorno:

{
    "result": true,
    "installation_key": "1234567897",
    "error_message":"(Mensagem descrevendo o motivo do erro em caso o result seja false)"
}

#Tabelas

#POLÍTICAS

Código	Tipo	Descrição
id	Inteiro	ID da política
description	Alfanumérico	Descrição da política.

#SERVIÇOS

Nome	Tipo	Descrição
id	Inteiro	ID do serviço
description	Alfanumérico	Descrição do serviço.

#CÓDIGO DE MODELO

Código	Descrição
1	Cliente desktop (Windows ou Linux) com servidor hospedado.
2	Cliente desktop (Windows o Linux) com servidor local.
3	Servidor local (Windows). GSServer GSurf.
4	Cliente mobile (Android, IOS, Ingenico, Verifone, Pax, etc) com servidor hospedado.
5	Cliente mobile (PAX monitor) com servidor hospedado.
6	Cliente mobile (Android, IOS, Ingenico e Verifone) com servidor local.
7	Cliente mobile (PAX) com servidor local.

#CÓDIGOS DE SITUAÇÃO

Código	Descrição
1	Ativo.
2	Aguardando o bloqueio.
3	Bloqueado.
4	Aguardando o desbloqueio.
5	Aguardando o cancelamento.
6	Cancelado.
7	Aguardando a criação da conta.
8	Pronto para instalação.

#CÓDIGO DE SITUAÇÃO DE REVENDA

Código	Descrição
1	Ativo .
0	Inativa .

#Histórico de versões

MODIFICAÇÕES	GERENTE AUTORIZADOR	VERSÃO
Versão apreciação	Mateus Fornari Thiago Silveira	1.0
Adicionados novos parâmetros ao método terminals para permitir filtrar por descrição e status, além de opção de limite e offset. Alterado o objeto Terminal, retornado pelo método terminals, para retornar a descrição e chave de instalação também. Adicionado o parâmetro para descrição no método add-terminal. Adicionado o método terminal-description, que permite alterar a descrição de um terminal. Adicionado o método -terminal, que retorna os dados de um terminal específico.	Mateus Fornari	1.1
Implementada a autenticação por token.	Mateus Fornari	1.2
Documento reestrutuardo. Adicionados os novos módulos: - POST /customer-cpf; - POST/customer-cnpj; - PUT/customer; - GET /customer.	Marcel Almeida Jacob Darrossi	1.3
Pequenas correções e ajustes no documento.	Mateus Fornari	1.4
Adicionado campo cnpj_retailer no cadastro de cliente (CNPJ ou CPF).	Jacob Darrossi	1.5
Pequenos correções no documento. Adicionado campo cnpj_retailer nos métodos: - PUT /customer; - GET /terminals; - PUT /add-terminal.	Alisson P. Estevão	1.6
Ajustes de legibilidade. Atualizado o método GET/customer para exibir o parceiro do cliente. Adicionado o campo cnpj_retailer nos métodos: - GET /services; - GET /policies.	Alisson P. Estevão	1.7
Formatação do documento	Ivan Appel	1.8
Adicionado o metódo PUT /reinstall-certificate. Ajustado o retorno dos métodos de consulta de terminais, para retornar os serviços e seus respectivos IDs. Adicionado o método GET /all-retailers. Ajustado o retorno de adição de serviços, para exibir qual serviço retorna erro em sua adição.	Alisson P. Estevão	1.9
Adicionado a necessidade de enviar o User-Agent no header das requesições. Ajustado Endpoint put /add-terminal	Paulo Ricardo	2.0