Lista de webservices aprimorados. Para adquirir ou obter mais informações entre em contato com a nossa equipe comercial.

Pré-requisitos

1. Configuração de perfis de webservices

2. Autorização para consumo dos webservices

ABERTURA DE LEAD

Serviço a ser selecionado dentro de seu perfil de webservice.

Open

Onde: 

• token - token de retorno da autenticação (Obrigatório)

• cd_cliente - Código do Cliente (Obtido por WSMKConsultaDoc ou WSMKUserSenhaSAC)

• info - Informação sobre o atendimento
  
  

Exemplo de saída:

Exemplo de uma saída ao chamar o Webservice WSMKNovaLead

Open

CRIAR PLANOS DE ACESSO

Parâmetros:

• token - token de retorno da autenticação (Obrigatório)

• descricao - nome do plano de acesso  (Obrigatório)

• mesesContrato - duração do plano de acesso (Obrigatório)

• inativo - S/N (Obrigatório)

• planosAcessoTipoId - informar o código conforme tabela:

Exemplo de saída:

Exemplo de uma saída ao chamar o de criação de planos de acesso:

Open

CRIAR NOVO CONTRATO

Serviço a ser selecionado dentro de seu perfil de webservice.

Open

Parâmetros:

• token - token de retorno da autenticação (Obrigatório)

• CodigoCliente - código do cadastro do cliente (Obrigatório)

• CodigoTipoPlano - código do tipo do plano de acesso, preencha conforme os códigos abaixo (Obrigatório)

• CodigoPlanoAcesso - código do plano de acesso. Atenção: se CodigoTipoPlano=12 informar códigos de produtos do CRM  (Obrigatório)

• CodigoRegraVencimento - código da regra de vencimento (Obrigatório)

• CodigoSLA - código da tabela de SLA (Obrigatório caso tenha configuração ativa no sistema)

• IgnorarRenovacaoAutomatica - ativar ou desativar renovação automática do contrato (Opcional)

• ValorSugeridoRenovacao - valor sugerido para a renovação (Opcional)

• CodigoRegraBloqueio - código da régua de bloqueio (Obrigatório)

• DescontoInatividade - código do desconto por inatividade (Opcional)

• CodigoFormaPagamento - código da forma de pagamento (Obrigatório)

• CodigoProfilePagamento - código da profile de pagamento (Obrigatório)

• CodigoMetodoFaturamento - código do método de faturamento (Obrigatório)

• CodigoDescontoAplicado -  código da tabela de descontos (Opcional)

• CodigoPlanoContas - código do plano de contas (Obrigatório)

• ConsultorCRM - código do cadastro de vendedores do CRM (Opcional)

• EmailDst - e-mail do cliente (destinatário) para que receba o e-mail de boas vindas (Obrigatório se 'EnviarBV' for = S)

• EnviarBV - S/N para indicar se o e-mail de boas vindas deve ser enviado, será utilizado o modelo de e-mail e conta default do sistema (Opcional)

• AguardaAtivacao - S/N para indicar se o contrato deve ser criado aguardando ativação (Opcional)

• cd_empresa - Código da empresa específica para a criação do contrato, utilizado para quem possui multi empresas (Opcional)

Exemplo de saída:

Exemplo de uma saída ao chamar o Webservice WSMKNovoContrato:

Open

LISTAR FATURAS

Parâmetros:

• token - token de retorno da autenticação (Obrigatório)

• codigo_cliente - código do cadastro do cliente (Obrigatório)

• liquidado - S/N (Opcional)

• codigo_fatura_inicio - código de início da(s) fatura(s) (Opcional)

• codigo_fatura_fim - código de fim da(s) fatura(s) (Opcional)

• tipo_documento - modelo da NF da(s) fatura(s) (Opcional)

• data_emissao - data de geração (Opcional)

• data_vencimento - data de vencimento atual (Opcional)

• data_pagamento - data de liquidação (Opcional)

• codigo_contrato - código do contrato (Opcional)

• data_vencimento_original - data original do vencimento (Opcional)

• codigo_fatura - código da fatura (Opcional)

• quantidade_meses - quantidade de meses após a data de vencimento da fatura, dessa forma serão listadas as faturas dentro do período informado. Caso o parâmetro não seja preenchido o WS considera automaticamente 1 mês (Opcional)

Exemplo de saída:

Open

CRIAR OS

Parâmetros:

• token - token de retorno da autenticação (Obrigatório)

• CodigoCliente - código do cadastro do cliente (Obrigatório)

• CodigoConexao - código da conexão (Opcional)

• CodigoContrato - código do contrato  (Opcional)

• DescricaoProblema - relato do cliente (Obrigatório)

• CodigoTipoOS - código do tipo de OS (Obrigatório)

• CodigoTecnico - código do técnico responsável (Obrigatório)

• CodigoGrupoServico - código da equipe (Obrigatório)

• CodigoAtendimento - código do atendimento do ERP (Opcional)

• condominio - código do condomínio, se preenchido todos os demais dados do endereço serão preenchidos automaticamente (Opcional) Parâmetro disponível a partir da release 64.9

• cidade - código da cidade (Opcional) Parâmetro disponível a partir da release 64.9

• bairro - código do bairro (Obrigatório se for informado código de cidade) Parâmetro disponível a partir da release 64.9

• logradouro - código do logradouro (Obrigatório se for informado código de cidade) Parâmetro disponível a partir da release 64.9

• complemento - texto livre para informação do complemento do endereço (Opcional) Parâmetro disponível a partir da release 64.9

• numero - número da casa (Obrigatório se for informado código de cidade) Parâmetro disponível a partir da release 64.9

• indicacoes - será adicionado o texto de indicações (possível solução) para a OS (Opcional) Parâmetro disponível a partir da release 64.9

• categoria - 1 indica que vai criar uma O.S. do tipo cliente e 2 indica que vai criar uma O.S. do tipo provedor (abaixo explicações de como utilizar quando for do tipo 2) (Obrigatório) Parâmetro disponível a partir da release 74

• UsuarioCriacao - indica qual usuário criou a O.S (Opcional) 🆕 Parâmetro disponível a partir da release 110

Foi inclusa a possibilidade de abrir também ordem de serviço ao provedor. Para isso, pode ser feita a consulta prévia do ponto imobilizado e do local de manutenção:

Parâmetros:

• token - token de retorno da autenticação (Obrigatório)

Exemplo de saída:

Open

Parâmetros:

• token - token de retorno da autenticação (Obrigatório)

• local - 1 = POP, 2 = Armário, 3 - Ponto de acesso, 4 - OLT, 5 - Servidor, 7 - Caixa de emenda, 6 - Nap/Hub e 99 - Outros

Exemplo de saída:

Open

Parâmetros:

• token - token de retorno da autenticação (Obrigatório)

Exemplo de saída:

Open

🆕 Parâmetros disponíveis a partir da release 74:

• categoria - 1 indica que vai criar uma O.S. do tipo cliente e 2 indica que vai criar uma O.S. do tipo provedor (Obrigatório)

• protocolo - código do protocolo de atendimento que será vinculado a essa O.S.  (Opcional)

🚨Ao escolher a categoria 2, os seguintes pontos devem ser observados:

🆕 Se o parâmetro CodigoTipoOS for do tipo "ativação" a api vai seguir normalmente, caso não seja, ela pedirá os seguintes parâmetros:

• Imobilizado - código do ponto imobilizado (Obrigatório caso CodigoTipoOS não for de ativação)

• LocalMan - código do local de manutenção: 1 = POP, 2 = Armário, 3 - Ponto de acesso, 4 - OLT, 5 - Servidor, 7 - Caixa de emenda, 6 - Nap/Hub e 99 - Outros(Obrigatório caso CodigoTipoOS não for de ativação)
  
  

• CodLocalMan - código do ponto de acesso escolhido (Obrigatório caso CodigoTipoOS não for de ativação)

🆕 Se o parâmetro "CodLocalMan" (que se refere ao local da manutenção" estiver preenchido, ele obrigará os parâmetros de endereço referentes ao local.

🆕 Se o parâmetro "TipoItem" for passado, significa que a O.S. receberá itens, então os seguintes campos serão obrigatórios:

• TipoItem - código do tipo de designação do item: 1 - Venda, 2 - Comodato, 3 - Empréstimo, 4 - Demonstração, 5 - Locação, 6 - Serviço, 7 - Imobilizado e 8 - Uso e consumo(Obrigatório caso TipoItem for preenchido)

• SetorItem - código do setor escolhido para movimentação do item(Obrigatório caso TipoItem for preenchido)

• ItemOS - código do produto escolhido(Obrigatório caso TipoItem for preenchido)

• Serial - código do serial do produto (Opcional)

• QtdItem - quantidade de produtos que serão movimentados (Obrigatório caso TipoItem for preenchido)

• vlr_unit - valor do produto que será movimentado (Obrigatório caso TipoItem for preenchido)

  
  
  

  
  
  

  Exemplo de saída:

  Open

  

  
  
  

ALTERAR OS

Parâmetros:

• token - token de retorno da autenticação (Obrigatório)

  • id - código da OS (Obrigatório)

  • defeitoReclamado - nova descrição para o defeito reclamado (Opcional)

  • defeitoConstatado - nova descrição para o defeito constatado (Opcional)

  • operador - login (nome do usuário) do operador (Opcional)

  • tipo - código do tipo de OS (Opcional)

  • items - Caso deseje incluir um item em sua OS, deve preencher os seguintes dados: serial (caso o produto seja obrigatória a inclusão), prodServ ("P" para produto e "S" para serviço), quantidade, valorUnitario ( espera o valor unitário do produto que vem da API WSMKConsultaProdutoEstoque do campo venda_un), setor (pode ser buscado usando a API WSMKConsultaProdutoEstoque), subTotal, tipoItem (abaixo os códigos de cada tipo de item), tipoSaida (abaixo os códigos de cada tipo de saída), categoria (categoria da O.S que pode ser 1- cliente 2 - provedor), cod0Item, item

• 	tipoItem

  	tipoItem
  1	Adicional
  2	Pacote
  3	Extra (manual)
  	tipoSaida

  	tipoSaida
  1	Venda
  2	Comodato
  3	Empréstimo
  4	Demonstração
  5	Locação
  9	Serviço
  101	Imobilizado
  102	Uso e consumo

  • assinatura - espera um base64 de uma imagem seja png ou jpeg entre outros diversos formatos, para testar esse campo é possível fazer o envio de uma imagem qualquer para o site https://base64.guru/converter/encode/image e clicando na opção de gerar o código base64, feito isso pasta copiar o código e colocar no insomnia ou Postmann.

  • codigoAtendimentoAssociar - código de atendimento já criado no sistema para que a OS seja vinculada a ele (Opcional)

  • encerrarOs - preencher com S para encerrar a OS no sistema (Opcional)

  • operadorEncerramento - login (nome do usuário) do operador (Obrigatório se 'encerrarOs' for igual a 'S')

  • servicoPrestado - (Obrigatório se 'encerrarOs' for igual a 'S')

  • classificacaoEncerramento - (Obrigatório se 'encerrarOs' for igual a 'S')

  • fecharAtendimentoAssociado - (Obrigatório se 'encerrarOs' for igual a 'S')

  • classificEncerramentoAtendmento - (Obrigatório se 'fecharAtendimentoAssociado' for igual a 'S')

  • classificacaoEncerramento - (Opcional)

  • classificEncerramentoAtendmento - (Opcional)

  
  
  

  Exemplo de saída:

  Open

  
  Open

  

AUTO-DESBLOQUEIO

Parâmetros: