APIs gerais
Índice
Gerenciador de Webservice
ACESSO: Módulo Integradores → Menu Gerenciador de Webservices
No Gerenciador de webservice teremos três painéis
- Configuração de perfis de webservices
- Atividades de webservice dos últimos 90 dias
- Atividades de webservice com erro dos últimos 90 dias
- Operadores com autorização específica dos serviços de autenticação de usuários.
- Atividade de validações de usuários. (90 dias)
Configuração de perfis de webservices
Estes perfis irão compor regras para a utilização dos webservices do Sistema MK
No painel de configurações haverão ferramentas para o cadastro e edição de perfis de webservice.
Para criar um novo perfil clique no botão 'Inserir Novo Perfil'
No primeiro passo do assistente temos os seguintes dados:
- Código - Código auto numerável atribuído pelo banco de dados (bloqueado para edição)
- Ativo(SIM/NÃO) - Define se a regra está ativa
- Data/Hora - Data e hora da criação do perfil (bloqueado para edição)
- Operador - Operador que criou o perfil (bloqueado para edição)
- Tempo de Expiração - Tempo em minutos de expiração do token de autenticação.
- Invalidar(SIM/NÃO) -
- Marcando Sim neste campo, o token será invalidado a partir da sua utilização ou
- Caso contrário vai respeitar o tempo em minutos informado para ser considerado inválido.
- Contra-senha -
- Contra-senha requisitada para a autenticação gerar o token de callback.
- O sistema irá sugerir uma contra-senha
- A contra senha deve ter no mínimo 8 dígitos entre números e caracteres.
- Descrição identificativa do perfil - Informe a descrição que irá identificar o perfil cadastrado em seu sistema.
Atenção
A liberação deste perfil é de sua inteira responsabilidade, assim como o consumo dos serviços a ele atrelados
Clique no botão 'Próximo' para seguir para o passo seguinte
Neste segundo passo, o operador poderá restringir a utilização dos webservices para determinados endereços de IPs.
Clique no botão 'Adicionar IP à relação'
Para cada IP Address o operador deverá informar:
- IP Address - Número de IP autorizado.
- Descrição/Observação - Descrições e observações identificativas que autorizaram este IP
Marque a opção "Tem certeza que deseja gravar este registro?" para confirmar e em seguida clique no botão 'Finalizar' para efetivar o cadastro do IP ao perfil.
Marque a opção 'Limitar consumo de serviços a lista de IPs' para obrigar a inserção de IPs ao perfil e para seja feita a restrição de acesso ao webservices.
Clique no botão 'Próximo' para seguir para o passo seguinte
Nesse terceiro passo o operador poderá restringir a utilização dos Webservices por usuário do sistema.
Passe para o quadro direito os usuário que terão permissão.
Atenção
A verificação do usuário na autenticação será feita sobre o token do seu cadastro
Clique no botão 'Próximo' para seguir para passo seguinte
Por fim, no último passo serão definidos os webservices autorizados para o perfil.
Passe para o quadro direito os webservices que farão parte do perfil;
Marque a opção "Tem certeza que deseja gravar este registro?" para confirmar a operação e clique no botão 'Finalizar' para efetivar o cadastro do perfil.
Pronto! O perfil de Webservice foi cadastro.
Atividades de webservice dos últimos 90 dias
Neste painel serão listadas as consultas de webservices realizadas com sucesso
Selecione o Consumo do Webservice no painel e clique no botão 'Detalhes da atividade' para obter maiores informações
Observe que no painel há outras opções de visualização de colunas. Veja na imagem abaixo
Atividades de webservice com erro dos últimos 90 dias
Neste painel serão listadas as consultas de webservices realizadas e que ocorreram erro
Selecione o Consumo do Webservice no painel e clique no botão 'Detalhes da atividade' para obter maiores informações
Observe que no painel há outras opções de visualização de colunas. Veja na imagem abaixo
Operadores com autorização específica dos serviços de autenticação de usuários.
Neste painel teremos uma nova opção de cadastro. O cadastro irá funcionar de forma semelhante ao cadastro do perfil descrito anteriormente
No entanto, na primeira etapa do cadastro, será necessário informar apenas
- Data Inicial - Data inicial da validade da regra
- Data Final- Data final da validade da regra
- Descrição identificativa do perfil - Informe a descrição que irá identificar o perfil cadastrado em seu sistema
Os próximos passos são iguais ao cadastro de perfil dos serviços gerais
Atenção
A liberação deste perfil é de sua inteira responsabilidade, assim como o consumo dos serviços a ele atrelados
Atenção
Para campos que terão informações separadas por 'espaço' utilize aspas simples
É fundamental somente autorizar perfis de webservices em ambiente https por questões de segurança dos seus dados
Atividade de validações de usuários. (90 dias)
Neste painel teremos a listagem de todas as autentificações feitas pela URL WSAutenticacaoOperador (que utiliza o perfil de serviços especifico)
AUTENTICAÇÃO
Para autorizações especificas
Este é o autenticador para serviços específicos dos webservices abertos do MK
URL DE AUTENTICAÇÃO
Parâmetros:
- username - usuário de login do sistema (obrigatório)
- password - senha do login do sistema (obrigatório)
Saída
Observação
Apenas os usuário definidos no perfil de webservices para serviços específicos que vão consegui realizar esta autenticação
Para autorizações em geral
Este é o autenticador para serviços gerais dos webservices abertos do MK
URL DE AUTENTICAÇÃO
Parâmetros:
- token - token do cadastro de usuário
- password - senha do perfil do Webservice
- cd_servico - Código do Serviço de acordo com a tabela abaixo
Código Serviço | Serviço |
---|---|
1 | Segunda via de boleto |
4 | Validar user/senha SAC |
6 | Consultar documento |
7 | Consulta de faturas pendentes |
8 | Contratos por cliente |
9 | Conexões por cliente |
10 | Classificações de atendimento |
11 | Processos de atendimentos |
16 | Estrutura de endereços |
17 | Consultar pessoa pelo nome |
20 | Consulta de fatura por código de barras |
21 | Linha digitável por fatura via SMS |
Exemplo:
http://IP:PORTA/mk/WSAutenticacao.rule?sys=MK0&token=tokenDoUsuário&password=senhaPerfil&cd_servico=9999
Acima são dois exemplos, onde o cd_servico = 1 quer dizer que somente está pedindo autorização para o serviço 1 (Segunda via de boleto)
Já o serviço com cd_servico = 9999 quer dizer que há autorização para todos os serviços do perfil de autenticação
Saída
Exemplo de uma saída ao chamar o Webservice WSAutenticacao
Atenção
Através da Autenticação será retornado o tokenRetornoAutenticacao, será este token que os demais webservices utilizarão como parâmetro de entrada
Exemplo 01:
Observe que é exibido o tempo de expiração do token de autenticação e o limite de uso. No imagem acima informa que não há limite de uso até a data 23/09/219 e hora 18:23:57 e está autorizado apenas para o serviço 1 (cd_servico=1)
Exemplo 02:
Observe que é exibido o tempo de expiração do token de autenticação e o limite de uso. No imagem acima informa que não há limite de uso até a data 24/09/219 e hora 20:52:08 e está autorizado para todos os serviços do perfil (cd_servico = 9999)
OBTER INFO DO CLIENTE A PARTIR DO DOCUMENTO (CPF/CNPJ)
URL PARA OBTER INFO DO CLIENTE A PARTIR DO DOCUMENTO
IP:PORTA/mk/WSMKConsultaDoc.rule?sys=MK0&token=tokenRetornoAutenticacao&doc=cpf/cnpj
Serviço: Consulta documento
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- doc - CPF ou CNPJ do cliente
Saída
Exemplo de uma saída ao chamar o Webservice WSMKConsultaDoc
OBTER FATURAS PENDENTES DO CLIENTE
URL PARA OBTER FATURAS PENDENTES
IP:PORTA/mk/WSMKFaturasPendentes.rule?sys=MK0&token=tokenRetornoAutenticacao&cd_cliente=codigoCliente
Serviço: Consulta de faturas pendentes
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- cd_cliente - Código do Cliente (Obtido por WSMKConsultaDoc ou WSMKUserSenhaSAC)
Saída
Exemplo de uma saída ao chamar o Webservice WSMKFaturasPendentes
VALIDAR ACESSO SAC
URL PARA VALIDAR ACESSO AO SAC
IP:PORTA/mk/WSMKUserSenhaSAC.rule?sys=MK0&token=tokenRetornoAutenticacao&user_sac=usuarioSAC&pass_sac=senhaSAC
Serviço: Validar user/senha SAC
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- user_sac - Usuário do SAC
- pass_sac - Senha do SAC
Saída
Exemplo de uma saída ao chamar o Webservice WSMKUserSenhaSAC
SEGUNDA VIA DE COBRANÇA
URL PARA OBTER SEGUNDA VIA DE COBRANÇA
IP:PORTA/mk/WSMKSegundaViaCobranca.rule?sys=MK0&token=tokenRetornoAutenticacao&cd_fatura=codigoFatura
Serviço: Segunda via de boleto
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- cd_fatura - Código da fatura (Obtido por WSMKFaturasPendentes)
Saída
Exemplo de uma saída ao chamar o Webservice WSMKSegundaViaCobranca
OBTER CONEXOES DO CLIENTE
URL PARA OBTER CONEXÕES PENDENTES
IP:PORTA/mk/WSMKConexoesPorCliente.rule?sys=MK0&token=tokenRetornoAutenticacao&cd_cliente=codigoCliente
Serviço: Conexões por cliente
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- cd_cliente - Código do Cliente (Obtido por WSMKConsultaDoc ou WSMKUserSenhaSAC)
Saída
Exemplo de uma saída ao chamar o Webservice WSMKConexoesPorCliente
OBTER CONTRATOS DO CLIENTE
URL PARA OBTER CONTRATOS PENDENTES
IP:PORTA/mk/WSMKContratosPorCliente.rule?sys=MK0&token=tokenRetornoAutenticacao&cd_cliente=codigoCliente
Serviço: Contratos por cliente
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- cd_cliente - Código do Cliente (Obtido por WSMKConsultaDoc ou WSMKUserSenhaSAC)
Saída
Exemplo de uma saída ao chamar o Webservice WSMKContratosPorCliente
OBTER CLASSIFICACOES DE ATENDIMENTOS
URL PARA OBTER CLASSIFICAÇÕES DE ATENDIMENTO
IP:PORTA/mk/WSMKListaClassificacoesAte.rule?sys=MK0&token=tokenRetornoAutenticacao
Serviço: Classificações de atendimentos
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
Saída
Exemplo de uma saída ao chamar o Webservice WSMKListaClassificacoesAte
OBTER LISTA DE PROCESSOS
URL PARA OBTER LISTA DE PROCESSO
IP:PORTA/mk/WSMKListaProcessos.rule?sys=MK0&token=tokenRetornoAutenticacao
Serviço: Processos de atendimentos
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
Saída
Exemplo de uma saída ao chamar o Webservice WSMKListaProcessos
ESTRUTURA DE ENDERECOS
URL OBTER A ESTRUTURA DE ENDEREÇOS
IP:PORTA/mk/WSMKListaEstruturaEnderecos.rule?sys=MK0&token=tokenRetornoAutenticacao
Serviço: Estrutura de endereços
Parâmetros:
- token= token de retorno da autenticação (Obrigatório)
Saída
Exemplo de uma saída ao chamar o Webservice WSMKListaEstruturaEnderecos
CONSULTAR PESSOA PELO NOME
CONSULTAR PESSOA PELO NOME
IP:PORTA/mk/WSMKConsultaNome.rule?sys=MK0&token=tokenRetornoAutenticacao&nome=nomeCliente
Serviço: Consulta pessoa pelo nome
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- nome - Nome do cliente (Obrigatório)
Saída
CONSULTAR DE FATURA POR CÓDIGO DE BARRA
CONSULTAR PESSOA PELO NOME
IP:PORTA/mk/WSMKConsultaBarras.rule?sys=MK0&token=tokenRetornoAutenticacao&barras=codigoBarra
Serviço: Consulta de fatura por código de barras
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- codigoBarra - Código de barras da fatura (Obrigatório)
Saída
LINHA DIGITÁVEL POR FATURA VIA SMS
CONSULTAR PESSOA PELO NOME
IP:PORTA/mk/WSMKLDViaSMS.rule?sys=MK0&token=tokenRetornoAutenticacao&cd_fatura=codigoDaFatura
Serviço: Linha digitável por fatura via SMS
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- codigoDaFatura - Código da fatura (Obrigatório)
Saída
LISTAR CLIENTES
URL PARA CONSULTA DE CLIENTES
Serviço: Consultar Cliente
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
doc - documento do cliente (Opcional)
codigo_bairro - código do bairro do cliente (Opcional)
nome_cliente - nome do cliente (Opcional)
data_alteracao_inicio - data inicial de cadastro do(s) cliente(s) (Opcional)
cd_cliente_inicio - código inicial do(s) cadastro(s) do(s) cliente(s) (Opcional)
cd_cliente - código do cliente (Opcional)
data_alteracao_fim - data final de cadastro do(s) cliente(s) (Opcional)
Pelo menos um dos parâmetros opcionais deve ser informado.
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKConsultaClientes:
LISTAR CLIENTES POR CÓDIGO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTA DE CLIENTES POR CÓDIGO
GET /core-api/pessoas/id
Serviço: Pessoas - buscar por id
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
id - código do cadastro do cliente (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
LISTAR PLANOS DE ACESSO POR TIPO DE PLANO
URL PARA CONSULTA DE PLANOS DE ACESSO
IP:PORTA/mk/WSMKListaPlanoAcesso.rule?sys=MK0&token=token&TipoPlano=tipodoplano
Também é possível utilizar a consulta com o padrão Node:
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
GET /planos-acessos/id
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
- TipoPlano - informar o código conforme tabela:
Código | Tipo do plano |
---|---|
1 | Internet |
2 | Telefonia |
3 | Hospedagem |
4 | Outros |
7 | Antívirus |
8 | IPTV |
9 | On-Demand |
10 | Transporte |
11 | TV/OTT |
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKListaPlanoAcesso:
LISTAR PLANOS DE ACESSO POR DESCRIÇÃO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTA DE PLANOS PELA DESCRIÇÃO
GET /planos-acessos/descricao
Serviço: Planos acesso - buscar por descricao
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- nomedoplano - descrição do nome do plano de acesso
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
LISTAR PLANOS DE ACESSO POR EMPRESA
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTA DE PLANOS POR EMPRESA
GET /planos-acessos/list/empresa
Serviço: Planos acesso - listar por empresa
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- empresa - código da multiempresa
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
LISTAR PLANOS DE ACESSO
URL PARA CONSULTA DE PLANOS DE ACESSO
IP:PORTA/mk/WSMKConsultaPlanos.rule?sys=MK0&token=token&data_alteracao=&codigo_plano=&codigo_plano_inicio=&codigo_plano_fim=&ativo=&nome_plano=
Serviço: Listar Planos de Acesso
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- data_alteracao - data de criação do plano (Obrigatório)
- codigo_plano - código do plano (Opcional)
- codigo_plano_inicio - código inicial do plano (Opcional)
- codigo_plano_fim - código final do plano (Opcional)
- ativo - buscar somente planos ativos True/False (Opcional)
- nome_plano - descrição do nome do plano (Opcional)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKConsultaPlanos:
LISTAR PLANOS DE ACESSO POR PRODUTO DO CRM
URL PARA CONSULTA DE PLANOS DE ACESSO
IP:PORTA/mk/WSMKConsultaPlanos.rule?sys=MK0&token=token&data_alteracao=&codigo_produto=&codigo_produto_inicio=&codigo_produto_fim=&ativo=&nome_produto=
Serviço: Listar Planos de Acesso
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- data_alteracao - data de criação do produto (Opcional)
- codigo_produto - código do produto (Opcional)
- codigo_produto_inicio - código inicial do produto (Opcional)
- codigo_produto_fim - código final do produto (Opcional)
- ativo - buscar somente produtos ativos S/N (Opcional)
- nome_produto - descrição do nome do produto (Opcional)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKConsultaPlanos:
LISTAR REGRAS DE VENCIMENTO
URL PARA CONSULTA DE REGRAS DE VENCIMENTO
IP:PORTA/mk/WSMKListaRegraVencimento.rule?sys=MK0&token=token
Serviço: Listar Regras de Vencimento
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKListaRegraVencimento:
LISTAR TABELAS DE SLA
URL PARA CONSULTA DA TABELA DE SLA
IP:PORTA/mk/WSMKListaTabelaSLA.rule?sys=MK0&token=token
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKListaTabelaSLA:
LISTAR REGRAS DE BLOQUEIO
URL PARA CONSULTA DAS REGRAS DE BLOQUEIO
IP:PORTA/mk/WSMKListaRegraBloqueio.rule?sys=MK0&token=token
Serviço: Listar Regras de Bloqueio
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKListaRegraBloqueio:
LISTAR PROFILES DE PAGAMENTO
URLA PARA CONSULTAR PROFILES DE PAGAMENTO
IP:PORTA/mk/WSMKListaProfilePagamento.rule?sys=MK0&token=token&CodigoFormaPagamento=codigoformapgto
Serviço: Listar Profiles de Pagamento
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKListaProfilePagamento:
LISTAR DESCONTOS
URL PARA CONSULTAR TABELA DE DESCONTO
IP:PORTA/mk/WSMKListaDesconto.rule?sys=MK0&token=token
Serviço: Listar Descontos
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKListaDesconto:
LISTAR PLANO DE CONTAS
URL PARA CONSULTA DE PLANO DE CONTAS
IP:PORTA/mk/WSMKPlanoContas.rule?sys=MK0&token=token
Serviço: Listar Planos de Contas
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice WSMKPlanoContas:
LISTAR EQUIPES DE OS
URL PARA CONSULTAR EQUIPES DE OS
IP:PORTA/mk/WSMKOSListaGruposServico.rule?sys=MK0&token=token
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
LISTAR TÉCNICOS RESPONSÁVEIS PARA AS OS
URL PARA LISTAR TÉCNICOS
IP:PORTA/mk/WSMKOSListaTecnicoResponsavel.rule?sys=MK0&token=
Serviço: OS - Listar Técnico Responsável
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
LISTAR TIPOS DE OS
URL PARA CONSULTA DE TIPOS DE OS
IP:PORTA/mk/WSMKOSListaTiposOS.rule?sys=MK0&token=token
Serviço: OS - listar por tipo Os
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
LISTAR OS POR CÓDIGO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTAR OS POR CÓDIGO
GET /os/id
Serviço: OS - buscar por id
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
- id - código da OS (Obrigatório)
Exemplo de saída:
LISTAR OS POR CLIENTE
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTAR OS POR CÓDIGO
GET /os/pessoa
Serviço: OS - listar por cliente
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
- pessoa - código do cliente (Obrigatório)
Exemplo de saída:
LISTAR CONTRATOS POR STATUS
URL PARA CONSULTA DE CONTRATOS POR STATUS
IP:PORTA/mk/WSMKContratosPorClienteV2.rule?sys=MK0&token=token&cd_cliente=&status=
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
- cd_cliente - código do cadastro do cliente (Obrigatório)
Exemplo de saída:
LISTAR CONEXÕES POR MOTIVO DE BLOQUEIO
URL PARA CONSULTA DE CONEXÕES
IP:PORTA/mk/WSMKConexoesPorClienteV2.rule?sys=MK0&token=token&cd_cliente=&motivo_bloqueio=&bloqueada=
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
- cd_cliente - código do cliente (Obrigatório)
- bloqueada - S/N (Opcional)
- motivo_bloqueio - código do motivo de bloqueio (Opcional)
Exemplo de saída:
CONSULTAR CLIENTES POR CÓDIGO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTA DE CLIENTES POR CÓDIGO
GET IP:PORTA/pessoas/id
Serviço: Pessoas - buscar por id
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- id - código do cadastro do cliente
Exemplo de saída:
CONSULTAR CLIENTES POR NOME
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTA DE CLIENTES POR NOME
GET IP:PORTA/pessoas/nome
Serviço: Pessoas - listar por nome
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- nome - nome do cliente (Obrigatório)
Exemplo de saída:
CONSULTAR CLIENTES POR EMPRESA
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTA DE CLIENTES POR EMPRESA
GET IP:PORTA/pessoas/empresa
Serviço: Pessoas - listar por empresa
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- empresa - código da multiempresa (Obrigatório)
Exemplo de saída:
CONSULTAR CLIENTES POR TELEFONE
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTA DE CLIENTES PELO NÚMERO DO CELULAR
GET IP:PORTA/pessoas/telefone
Serviço: Pessoas - listar por telefone
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- ddd - DDD do número do cliente (Obrigatório)
- fone - número do celular (Obrigatório)
Exemplo de saída:
Exemplo de saída:
LISTAR SERVIDORES
EXEMPLO DE URL PARA LISTAR SERVIDORES/CONCENTRADORES
GET IP:PORTA/mk/WSMKConexaoServidorConcentrador.rule?sys=MK0&token=&dataConnection=
Serviço: Conexão - Listar Concentrador
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- dataConnection - nome da multiempresa (Opcional)
Exemplo de saída:
LISTAR PLANOS DE ACESSO POR SERVIDOR
EXEMPLO DE URL PARA LISTAR PLANOS DE ACESSO
GET IP:PORTA/mk/WSMKConexaoPlanoAcesso.rule?sys=MK0&token=&CodigoServidor=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- CodigoServidor - código do servidor (Obrigatório)
Exemplo de saída:
LISTAR PONTOS DE ACESSO
EXEMPLO DE URL PARA LISTAR PONTOS DE ACESSO
GET IP:PORTA/mk/WSMKConexaoPontoAcesso.rule?sys=MK0&token=&dataConnection=
Serviço: Conexão - Pontos de Acesso
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- dataConnection - nome da multiempresa (Opcional)
Exemplo de saída:
LISTAR IPS DISPONÍVEIS
EXEMPLO DE URL PARA LISTAR IPS
GET IP:PORTA/mk/WSMKConexaoListaIP.rule?sys=MK0&token=&CodigoPontoAcesso=&CodigoServidor=
Serviço: Conexão - Listar IPs
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- CodigoPontoAcesso - código do ponto de acesso (Obrigatório)
- CodigoServidor - código do servidor (Obrigatório)
Exemplo de saída:
CRIAR LOGRADOURO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CRIAÇÃO DE LOGRADOUROS
POST /logradouros
Serviço: Logradouros - incluir
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
- nome - nome do logradouro (Obrigatório)
- cep - CEP (Obrigatório)
- bairroId - código do bairro (Obrigatório)
- cidadeId - código da cidade (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
ALTERAR LOGRADOURO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA ALTERAÇÃO DE LOGRADOUROS
PUT/logradouros
Serviço: Logradouros - editar
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
- nome - novo nome para o logradouro (Opcional)
- cep - novo CEP para o logradouro (Opcional)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
CRIAR BAIRRO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CRIAÇÃO DE BAIRRO
POST /core-api/bairros
Serviço: Bairros - incluir
Parâmetros:
token - token de retorno da autenticação (Obrigatório)
- nome - nome do novo bairro (Obrigatório)
- cidadeId - código da cidade (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
ALTERAR BAIRRO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
EXEMPLO DE URL DE ALTERAÇÃO DE BAIRRO
PUT /bairros
Serviço: Bairros - editar
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- id - código do bairro (Obrigatório)
- nome - novo nome do bairro (Obrigatório)
CRIAR CIDADE
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
EXEMPLO DE URL PARA CRIAÇÃO DE CIDADE
POST /cidades
Serviço: Cidades - incluir
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- nome - nome da cidade (Obrigatório)
- IBGE - código do IBGE da cidade (Obrigatório)
- estado - código do estado (Obrigatório)
Exemplo de saída:
ALTERAR CIDADE
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
EXEMPLO DE URL PARA ALTERAÇÃO DE CIDADE
PUT /cidades
Serviço: Cidades - editar
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- id - código da cidade (Obrigatório)
- nome - nome da cidade (Opcional)
- IBGE - código do IBGE da cidade (Opcional)
LISTAR CIDADE POR UF
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
EXEMPLO DE URL PARA LISTAR CIDADE POR ESTADO
IP:PORTA:core-api/cidades/uf?uf=&token=
Serviço: Cidades - buscar por uf
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- uf - sigla do estado (Obrigatório)
LISTAR ATENDIMENTOS POR PERÍODO (COM RETORNO INFORMANDO O CÓDIGO DO ATENDENTE)
EXEMPLO
IP:PORTA/mk/WSMKAtendimentos.rule?sys=MK0&token=&data_inicio=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- data_inicio= período inicial dos atendimentos no formato ano-mês-dia (Opcional)
- data_termino= período final dos atendimentos no formato ano-mês-dia (Opcional)
LISTAR ATENDENTES
IP:PORTA/mk/WSMKAtendentes.rule?sys=MK0&token=&Codigo_atendente=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- codigo_atendente - obtido em WSMKAtendimentos (Obrigatório)
LISTAR CLIENTES POR CÓDIGO
ATENÇÃO
Pré-Requisitos para utilizar esta API:
- Servidor com Ubuntu na versão 16.04 ou superior
- Instalação do Node.js no servidor (em caso de dúvida converse com a equipe de atendimento)
- Recomendamos a utilização do programa Insomnia, veja mais detalhes na nossa documentação Utilizando o Insomnia para consumir as APIs
URL PARA CONSULTA DE CLIENTES POR CÓDIGO
GET /core-api/pessoas/id
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
cod - código do cadastro do cliente (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
LISTAR CONTRATOS POR PLANO DE ACESSO OU PRODUTO DO CRM
IP:PORTA/mk/WSMKPlanosAcesso.rule?sys=MK0&token=&codigo_plano=&cancelado=&suspenso=&data_adesao_inicial::date=&data_adesao_final::date=&aguarda_ativacao=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- codigo_plano - código do plano de acesso ou produto do CRM (Obrigatório)
- cancelado - se informado N considerar somente os contratos ativos, se S todos os contratos com o plano de acesso (Obrigatório)
- suspenso - se informado N considerar somente os contratos ativos, se S todos os contratos com o plano de acesso (Obrigatório)
- data_adesao_inicial - data inicial para filtrar somente contratos criados após o período (Opcional)
- data_adesao_final - data final para filtrar somente contratos criados antes do período (Opcional)
- aguarda_ativacao - se informado N considerar somente os contratos ativos, se S todos os contratos incluindo os que aguardam a ativação com o plano de acesso (Obrigatório)
Paramêtros adicionados na release nº 57:
- data_cancelamento_inicial - data inicial para filtrar somente contratos cancelados no período (Opcional)
- data_cancelamento_final data final para filtrar somente contratos cancelados no período (Opcional)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice caso nenhum contrato for localizado de acordo com os parâmetros preenchidos será retornado somente informações sobre o plano de acesso:
Exemplo de uma saída ao chamar o Webservice quando forem localizados contratos:
ALTERAR SENHA DE ACESSO AO SAC EM MASSA E ENVIAR NOVA SENHA POR SMS AOS CLIENTES
IP:PORTA/mk/WSMKAlterarSenhaSac.rule?sys=MK0&token=&tag=&contrato_ativos=&cd_clientes=&conexao_ativa=
Onde:
- token - token de retorno da autenticação (Obrigatório)
- tag - TAG informada no cadastro do cliente (Opcional)
- cd_clientes - código do(s) cliente(s) separados por pipes - barras verticais | - (Opcional)
- conexao_ativa - S para alterar e enviar a nova senha somente para clientes com conexão desbloqueada, N para enviar para todos os clientes independente do status da conexão (Opcional)
- contrato_ativos - S para alterar e enviar a nova senha somente para clientes com contrato ativo, N para enviar para todos os clientes independente do status do contrato (Obrigatório)
A nova senha gerada leva em conta os requisitos de segurança, com 8 caracteres no mínimo e com letras e números e letras maiúsculas e minúsculas. O envio do SMS será feito pela operadora de SMS que deve estar cadastrada na configuração do mk erp.
Exemplo de saída:
LISTAR CONDOMÍNIOS
IP:PORTA/mk/WSMKListaCondominios.rule?sys=MK0&token=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
LISTAGEM DE ESTADOS
š API disponível a partir da release 72
IP:PORTA/mk/WSMKListaEstados.rule?sys=MK0&token=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
LISTAGEM DE BAIRROS POR CIDADE
š API disponível a partir da release 72
IP:PORTA/mk/WSMKListaBairros.rule?sys=MK0&token=&cd_cidade=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- cd_cidade - código da cidade no cadastro de endereços (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
CONSULTA DE ACEITE CONTRATUAL PENDENTE
š API disponível a partir da release 72
IP:PORTA/mk/WSMKAceiteContratualPendente.rule?sys=MK0&token=&data_adesao=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- data_adesao - data de adesão informada no contrato no formato DD/MM/AAAA (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
CONSULTA DE FATURAS EM ABERTO
š API disponível a partir da release 72
IP:PORTA/mk/WSMKFaturasAbertas.rule?sys=MK0&token=&dt_venc_inicio=&dt_venc_fim=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- dt_venc_inicio - data de vencimento inicial das faturas no formato AAAA/MM/DD (Obrigatório)
- dt_venc_fim - data de vencimento final das faturas no formato AAAA/MM/DD (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
CONSULTA DE TÉCNICOS
š API disponível a partir da release 72
IP:PORTA/mk/WSMKConsultaTecnicos.rule?sys=MK0&token=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
CONSULTA DE EQUIPES
š API disponível a partir da release 72
IP:PORTA/mk/WSMKConsultaEquipes.rule?sys=MK0&token=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
CONEXÃO AUTENTICADA
š API disponível a partir da release 72
IP:PORTA/mk/WSMKConsultaConexaoAutenticada.rule?sys=MK0&token=&codconexao=
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- codconexao - código da conexão disponível no menu Técnico (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice:
CONSULTA DE AGENDAMENTO DE ORDEM DE SERVIÇO
š API disponível a partir da release 72
IP:PORTA/mk/WSMKConsultaOrdemAgendamento.rule?sys=MK0&token=&tecnico=&cliente=&DataAbertura
Parâmetros:
- token - token de retorno da autenticação (Obrigatório)
- tecnico - código do técnico cadastrado no ERP (Opcional)
- cliente - código do cliente no Cadastro de pessoas (Opcional)
- DataAbertura - data de abertura da ordem de serviço (Obrigatório)
Exemplo de saída:
Exemplo de uma saída ao chamar o Webservice: