Atualizar um serviço existente
Atualiza as informações de um serviço específico. Apenas os campos enviados são atualizados; um objeto aninhado (serviceItem, nbsItem, ibscbs) enviado precisa vir completo. status ativa (1) ou inativa (0) o serviço. Campos fora do contrato são descartados sem erro. Um serviceItem.code diferente do atual não pode repetir o de outro serviço não excluído da empresa (400 SERVICE.UPDATE.CODE_IN_USE, mesma regra e mensagem da criação). Reenviar o próprio código do serviço não é tratado como repetição. O serviço deve pertencer ao licenciado e à empresa selecionada no token; caso contrário, retorna 404, inclusive para serviço de outra empresa do mesmo licenciado. Se a empresa da sessão tiver sido excluída ou deixado de pertencer ao licenciado, a gravação retorna 401 SERVICE.UPDATE.NOT_AUTHORIZED. Requer perfil de Administrador.
services:writeParâmetros
- serviceIdpath
ID do serviço a ser atualizado (24 caracteres; um ID inexistente responde 404).
Respostas
Serviço atualizado com sucesso; retorna o serviço como gravado.
Erro de validação, empresa não selecionada no token ou item da Lista de Serviços já usado por outro serviço não excluído da empresa (SERVICE.UPDATE.CODE_IN_USE).
Token ausente, inválido ou expirado, ou empresa da sessão excluída ou fora do licenciado no momento da gravação (SERVICE.UPDATE.NOT_AUTHORIZED).
Acesso comercial do licenciado bloqueado ou usuário sem perfil de Administrador.
Serviço não encontrado, excluído, de outra empresa ou de outro licenciado.
Limite de requisições excedido (RATE_LIMIT.EXCEEDED). Por chave: 120 requisições por minuto (janela fixa de 60 s); o 429 da chave traz X-RateLimit-* da chave. Por IP, para tráfego com chave: 600 requisições em 10 minutos; esse 429 traz só Retry-After, sem X-RateLimit-* (os cabeçalhos descrevem apenas o limite da chave). Aguarde Retry-After segundos antes de tentar de novo.
Credencial não pôde ser verificada por falha temporária do servidor (AUTH.SESSION_UNAVAILABLE). Não invalida a chave nem a sessão: repita com backoff.