{"dados":[{"codigo":"corpo_invalido","status":400,"quando":"O corpo não é JSON válido.","o_que_fazer":"Corrija o JSON e reenvie."},{"codigo":"empresa_invalida","status":400,"quando":"`empresa_id` não é UUID.","o_que_fazer":"Use o `id` de GET /v1/empresas."},{"codigo":"empresa_obrigatoria","status":400,"quando":"Credencial do workspace sem informar a empresa.","o_que_fazer":"Informe `empresa_id` (corpo/query) ou use `/v1/empresas/{id}/...`."},{"codigo":"id_invalido","status":400,"quando":"Um id no caminho não é UUID.","o_que_fazer":"Use o id como veio da API."},{"codigo":"credencial_invalida","status":401,"quando":"Credencial desconhecida ou revogada.","o_que_fazer":"Gere uma nova no painel e substitua."},{"codigo":"nao_autorizado","status":401,"quando":"Sem `Authorization: Bearer nce_...` ou credencial sem escopo.","o_que_fazer":"Envie a credencial gerada no painel."},{"codigo":"empresa_sem_licenca","status":403,"quando":"A empresa não tem vaga ativa na licença do emissor.","o_que_fazer":"Ative a empresa no painel (ou peça ao gestor da conta)."},{"codigo":"sem_licenca","status":403,"quando":"A empresa não tem a cota do documento (CT-e/MDF-e) ativa.","o_que_fazer":"Ative em Nota Central › Emissor ou contrate a cota."},{"codigo":"condutor_nao_encontrado","status":404,"quando":"Condutor inexistente ou já removido.","o_que_fazer":"Liste em GET /v1/condutores."},{"codigo":"documento_nao_encontrado","status":404,"quando":"MDF-e/CT-e inexistente, de outro documento ou fora do escopo da credencial.","o_que_fazer":"Confira o id devolvido no POST."},{"codigo":"empresa_nao_encontrada","status":404,"quando":"Empresa inexistente, de outro workspace ou fora do escopo da credencial.","o_que_fazer":"Liste em GET /v1/empresas e use um id de lá."},{"codigo":"lancamento_nao_encontrado","status":404,"quando":"Lançamento inexistente ou de outra empresa.","o_que_fazer":"Use o id devolvido em GET …/conta-azul/lancamentos."},{"codigo":"medico_nao_encontrado","status":404,"quando":"Médico inexistente ou de empresa fora do escopo.","o_que_fazer":"Liste em GET /v1/medicos."},{"codigo":"nota_nao_encontrada","status":404,"quando":"Nota inexistente ou de empresa fora do escopo da credencial.","o_que_fazer":"Confira o id devolvido no POST /v1/notas."},{"codigo":"tomador_nao_encontrado","status":404,"quando":"CPF/CNPJ não está no cadastro de tomadores do workspace.","o_que_fazer":"Cadastre com POST /v1/tomadores."},{"codigo":"veiculo_nao_encontrado","status":404,"quando":"Veículo inexistente ou já removido.","o_que_fazer":"Liste em GET /v1/veiculos."},{"codigo":"conta_azul_nao_conectado","status":409,"quando":"A empresa ainda não conectou a conta do Conta Azul.","o_que_fazer":"Gere o link em POST …/conta-azul/conectar e peça ao cliente para autorizar."},{"codigo":"conta_azul_outro_cnpj","status":409,"quando":"A conta autorizada no Conta Azul é de outro CNPJ.","o_que_fazer":"Se for de propósito (grupo, holding), confirme em POST …/conta-azul/aceitar-outro-cnpj; senão, conecte a conta certa."},{"codigo":"conta_azul_reconectar","status":409,"quando":"A autorização no Conta Azul expirou ou foi revogada pelo cliente.","o_que_fazer":"Gere um novo link em POST …/conta-azul/conectar."},{"codigo":"ja_encerrado","status":409,"quando":"O MDF-e já foi encerrado.","o_que_fazer":"Nada a fazer; emita outro manifesto para a próxima viagem."},{"codigo":"lancamento_nao_reenviavel","status":409,"quando":"O lançamento já foi lançado ou está sendo enviado agora.","o_que_fazer":"Nada a fazer; consulte de novo em instantes."},{"codigo":"nao_emitido","status":409,"quando":"O documento ainda não foi autorizado.","o_que_fazer":"Aguarde `situacao: emitida` antes do evento."},{"codigo":"nao_permitido","status":409,"quando":"Evento não cabe no estado do documento (ex.: condutor em MDF-e encerrado).","o_que_fazer":"Confira a situação em GET."},{"codigo":"nota_nao_cancelavel","status":409,"quando":"A nota não está emitida (rascunho, na fila, rejeitada, já cancelada).","o_que_fazer":"Consulte a situação em GET /v1/notas/{id}."},{"codigo":"numero_ja_utilizado","status":409,"quando":"`proximo_numero` é igual ou menor que um número já usado nesta série pelo emissor.","o_que_fazer":"Consulte GET /v1/numeracao e informe um número acima do último usado."},{"codigo":"referencia_ja_usada","status":409,"quando":"A `referencia_externa` pertence a uma nota REJEITADA (número já consumido, registro não apagável).","o_que_fazer":"Reenvie o pedido corrigido com uma referência nova."},{"codigo":"ambiente_invalido","status":422,"quando":"`ambiente` não é homologacao nem producao.","o_que_fazer":"Use homologacao ou producao."},{"codigo":"campos_invalidos","status":422,"quando":"Campos obrigatórios ausentes ou inválidos.","o_que_fazer":"Veja `campos` e corrija cada um."},{"codigo":"cancelamento_nao_suportado","status":422,"quando":"O órgão emissor da nota não cancela por integração.","o_que_fazer":"Cancele no portal da prefeitura."},{"codigo":"cancelamento_recusado","status":422,"quando":"O órgão recusou o cancelamento (fora do prazo, nota já cancelada ou substituída).","o_que_fazer":"Leia `mensagem` e `detalhes.codigo`; fora do prazo, só substituição ou processo na prefeitura."},{"codigo":"competencia_invalida","status":422,"quando":"`competencia` fora de AAAA-MM ou AAAA-MM-DD.","o_que_fazer":"Ex.: \"2026-08\"."},{"codigo":"condutor_invalido","status":422,"quando":"Condutor sem nome ou com CPF fora de 11 dígitos.","o_que_fazer":"Corrija nome e CPF."},{"codigo":"configuracao_invalida","status":422,"quando":"Configuração do lançamento fora do aceito (ex.: vencimento negativo).","o_que_fazer":"Corrija o campo indicado na mensagem."},{"codigo":"conta_financeira_obrigatoria","status":422,"quando":"Ligar a integração ou configurar sem informar a conta financeira.","o_que_fazer":"Liste em GET …/conta-azul/contas-financeiras e envie conta_financeira_id."},{"codigo":"correcoes_obrigatorias","status":422,"quando":"Carta de correção sem itens.","o_que_fazer":"Envie `correcoes` com grupo, campo e valor."},{"codigo":"cota_medica_invalida","status":422,"quando":"`cota_medica` não é uma lista válida ou as linhas não fecham.","o_que_fazer":"Uma linha por médico com `amount` \u003e 0; veja `campos`."},{"codigo":"cpf_invalido","status":422,"quando":"CPF do médico com dígito verificador errado.","o_que_fazer":"Confira o CPF (11 dígitos)."},{"codigo":"crt_invalido","status":422,"quando":"`crt` fora de 1..4.","o_que_fazer":"1 Simples, 2 Simples excesso, 3 regime normal, 4 MEI."},{"codigo":"dados_incompletos","status":422,"quando":"O manifesto ou o CT-e não fecha (campo faltando ou inválido).","o_que_fazer":"Corrija o que `campos` lista e reenvie; nada foi gravado."},{"codigo":"data_invalida","status":422,"quando":"`data` fora do formato AAAA-MM-DD.","o_que_fazer":"Envie a data no formato ISO."},{"codigo":"documento_invalido","status":422,"quando":"`documento` não é nfse, nfe, cte nem mdfe.","o_que_fazer":"Use um dos quatro (padrão: nfse)."},{"codigo":"emissao_recusada","status":422,"quando":"O emissor recusou antes de enviar ao órgão (validação de leiaute ou de cadastro).","o_que_fazer":"Leia `mensagem` e `detalhes.codigo`; corrija e reenvie."},{"codigo":"empresa_sem_regime_tributario","status":422,"quando":"Empresa sem regime tributário no cadastro.","o_que_fazer":"Preencha o regime em Dados fiscais."},{"codigo":"endereco_do_tomador_obrigatorio","status":422,"quando":"O município exige endereço do tomador e o cadastro não tem.","o_que_fazer":"Cadastre o tomador com endereço (POST /v1/tomadores, ou no painel)."},{"codigo":"endereco_invalido","status":422,"quando":"Endereço do tomador com `uf`, `cep` ou `codigo_municipio` fora do formato.","o_que_fazer":"uf com 2 letras, cep com 8 dígitos, codigo_municipio com 7 dígitos (IBGE); veja `campos`."},{"codigo":"motivo_obrigatorio","status":422,"quando":"Cancelamento sem `motivo`.","o_que_fazer":"Informe o motivo — ele vai no evento enviado ao órgão."},{"codigo":"municipio_fora_do_ambiente_nacional","status":422,"quando":"O município da empresa não emite pelo padrão nacional nem tem rota própria.","o_que_fazer":"Fale com o suporte para habilitar o município."},{"codigo":"nbs_obrigatorio","status":422,"quando":"O serviço exige código NBS e ele não foi informado nem está no cadastro.","o_que_fazer":"Informe `codigo_nbs` ou cadastre no serviço."},{"codigo":"nome_obrigatorio","status":422,"quando":"Médico ou tomador sem nome.","o_que_fazer":"Informe `nome`."},{"codigo":"numero_invalido","status":422,"quando":"`proximo_numero` ausente ou menor que 1.","o_que_fazer":"Informe o próximo número da série (inteiro ≥ 1)."},{"codigo":"percentual_invalido","status":422,"quando":"`percentual_padrao` fora de 0–100.","o_que_fazer":"Use um número entre 0 e 100."},{"codigo":"periodo_invalido","status":422,"quando":"`de`/`ate` fora de AAAA-MM, ou fim anterior ao início.","o_que_fazer":"Use competências no formato AAAA-MM (ex.: 2026-09)."},{"codigo":"placa_obrigatoria","status":422,"quando":"Veículo sem placa.","o_que_fazer":"Informe `placa`."},{"codigo":"regime_tributario_nao_suportado","status":422,"quando":"Regime não coberto pelo cálculo de retenção federal.","o_que_fazer":"Fale com o suporte."},{"codigo":"rntrc_invalido","status":422,"quando":"`rntrc` não tem 8 dígitos.","o_que_fazer":"Informe o RNTRC da ANTT com 8 dígitos (ou vazio para limpar)."},{"codigo":"sefaz_recusou","status":422,"quando":"A SEFAZ recusou o evento (cStat na mensagem).","o_que_fazer":"Leia a mensagem: é regra fiscal, não falha técnica."},{"codigo":"sem_certificado","status":422,"quando":"A empresa não tem certificado A1 para assinar o evento.","o_que_fazer":"Cadastre o A1 no Nota Central."},{"codigo":"serie_invalida","status":422,"quando":"`serie_cte`/`serie_mdfe` menor que 1.","o_que_fazer":"Informe a série como inteiro a partir de 1."},{"codigo":"servico_sem_classificacao_fiscal","status":422,"quando":"Serviço sem classificação de retenção federal; bloqueia emissão a tomador PJ.","o_que_fazer":"Classifique o serviço no catálogo (ou marque sem retenção). PF continua funcionando."},{"codigo":"simples_sem_aliquota_efetiva","status":422,"quando":"Simples com ISS retido pelo tomador sem anexo/RBT12 no cadastro.","o_que_fazer":"Cadastre o anexo do serviço e a receita dos 12 meses."},{"codigo":"situacao_invalida","status":422,"quando":"Filtro `situacao` fora dos valores conhecidos.","o_que_fazer":"Use rascunho, na_fila, emitida, rejeitada, cancelada."},{"codigo":"situacao_lancamento_invalida","status":422,"quando":"Filtro `situacao` dos lançamentos fora dos valores conhecidos.","o_que_fazer":"Use pendente, enviando, lancado, falhou, aguardando_reconexao, ignorado."},{"codigo":"suspensao_iss_sem_processo","status":422,"quando":"Exigibilidade suspensa sem número de processo.","o_que_fazer":"Informe o processo no cadastro fiscal ou na nota."},{"codigo":"tipo_invalido","status":422,"quando":"`tipo` do veículo não é tracao nem reboque.","o_que_fazer":"Use tracao ou reboque."},{"codigo":"tomador_invalido","status":422,"quando":"`tomador.cpf_cnpj` (ou `cpf_cnpj` do tomador) não é um CPF (11) ou CNPJ (14 dígitos) válido.","o_que_fazer":"Só dígitos, com dígitos verificadores corretos."},{"codigo":"turbo_falhou","status":422,"quando":"Um recurso extra (ex.: calculadora IBS/CBS) falhou ao enriquecer a nota.","o_que_fazer":"Veja `detalhes.recurso`; tente de novo ou desligue o recurso."},{"codigo":"url_retorno_invalida","status":422,"quando":"url_retorno não é uma URL https completa.","o_que_fazer":"Envie uma URL https (até 500 caracteres) ou omita para voltar ao Nota Central."},{"codigo":"valor_invalido","status":422,"quando":"`valor` ausente ou não positivo.","o_que_fazer":"Informe o valor do serviço maior que zero."},{"codigo":"limite_excedido","status":429,"quando":"Mais de 120 requisições/minuto na credencial (ou 240 por IP).","o_que_fazer":"Aguarde e reenvie com backoff."},{"codigo":"erro_interno","status":500,"quando":"Falha nossa, não da requisição.","o_que_fazer":"Tente de novo; se persistir, fale com o suporte com o horário."},{"codigo":"indisponivel","status":501,"quando":"Recurso ainda não disponível nesta versão.","o_que_fazer":"Aguarde a próxima versão."},{"codigo":"conta_azul_recusou","status":502,"quando":"O Conta Azul recusou a chamada.","o_que_fazer":"Leia a mensagem (vem do Conta Azul) e tente de novo; se persistir, fale com o suporte."},{"codigo":"sefaz_indisponivel","status":502,"quando":"A SEFAZ não respondeu ou falhou.","o_que_fazer":"Tente de novo em alguns minutos."},{"codigo":"conta_azul_indisponivel","status":503,"quando":"A integração com o Conta Azul não está disponível neste ambiente.","o_que_fazer":"Fale com o suporte."}]}