Referência da API › Tomadores
Alterar tomador
Altera os dados de um tomador cadastrado.
PATCH
/api/v1/empresas/{id}/tomadores/{tomador_id}Envie só os campos que mudam. Notas já emitidas não mudam, porque os dados do tomador são copiados para a nota no momento da emissão.
Parâmetros
idEmpresa da organização da chave (de outra organização → 404). UUID (RFC 9562); fora do padrão → 400 REQUISICAO_INVALIDA com campo id. · UUID
tomador_idUUID (RFC 9562). Fora do padrão: 400 REQUISICAO_INVALIDA com campo igual ao nome do parâmetro. · UUID
Idempotency-KeyChave de idempotência (até 100 caracteres) aceita em POST, PATCH, PUT e DELETE; vale 24 h por integração e ambiente, exceto emissão, cancelamento, análise e substituição de notas (associação duradoura ao pedido). Mesmo conteúdo devolve a mesma resposta (cabeçalho Idempotent-Replayed true); conteúdo diferente devolve 409 IDEMPOTENCIA_CONFLITO. Obrigatória em emissão, cancelamento e substituição. · até 100 caracteres
Corpo da requisição
Campos opcionais de Tomador; resultado após mesclar com o cadastro deve ser válido.
Respostas
200 Tomador alterado
Campos da resposta
idUUID
id_externoÚnico por empresa · até 100 caracteres
tipoValores:
pj, pf, estrangeironome1 a 150 caracteres
documentoCPF (11 números) ou CNPJ (14 posições, numérico ou alfanumérico) com dígitos verificadores válidos; máscara e minúsculas são normalizadas · até 18 caracteres
nifaté 40 caracteres
motivo_sem_nifValores:
dispensado, nao_exigidoemailtelefoneinscricao_municipalaté 15 caracteres
enderecoNacional exige CEP/logradouro/número/bairro/IBGE. Exterior exige país/cidade/código postal/província/logradouro ou endereço livre/número/bairro. Complemento opcional.
endereco.cepFormato:
^[0-9]{8}$endereco.codigo_municipioFormato:
^[0-9]{7}$endereco.paisFormato:
^[A-Z]{2}$endereco.cidadeendereco.codigo_postalendereco.estado_provincia_regiaoendereco.logradouroendereco.endereco_livreendereco.numeroendereco.bairroendereco.complementocriada_emdata e hora ISO 8601
atualizada_emdata e hora ISO 8601
404 Erro no formato padrão
409 ID_EXTERNO_DUPLICADO por empresa ou IDEMPOTENCIA_CONFLITO
Limites
Valem também os limites gerais da chave. Veja Limites de uso.

