Pular para o conteúdo
notemnotemDocumentação

Referência da API › Tomadores

Consultar tomador

Devolve os dados de um tomador cadastrado na empresa.

GET/api/v1/empresas/{id}/tomadores/{tomador_id}

Use para conferir o cadastro antes de emitir uma nota para esse tomador. A resposta traz documento, nome, contato e endereço; tomador de outra empresa responde 404.

Parâmetros

idtextono caminhoobrigatório
Empresa 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_idtextono caminhoobrigatório
UUID (RFC 9562). Fora do padrão: 400 REQUISICAO_INVALIDA com campo igual ao nome do parâmetro. · UUID

Respostas

200 Tomador

Campos da resposta
idtexto
UUID
id_externotexto ou null
Único por empresa · até 100 caracteres
tipotexto
Valores: pj, pf, estrangeiro
nometexto
1 a 150 caracteres
documentotexto ou null
CPF (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
niftexto ou null
até 40 caracteres
motivo_sem_niftexto ou null
Valores: dispensado, nao_exigido
emailtexto ou null
telefonetexto ou null
inscricao_municipaltexto ou null
até 15 caracteres
enderecoobjeto ou null
Nacional 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.ceptexto
Formato: ^[0-9]{8}$
endereco.codigo_municipiotexto
Formato: ^[0-9]{7}$
endereco.paistexto
Formato: ^[A-Z]{2}$
endereco.cidadetexto
endereco.codigo_postaltexto
endereco.estado_provincia_regiaotexto
endereco.logradourotexto
endereco.endereco_livretexto
endereco.numerotexto
endereco.bairrotexto
endereco.complementotexto ou null
criada_emtexto
data e hora ISO 8601
atualizada_emtexto
data e hora ISO 8601

404 Erro no formato padrão

Limites

Valem também os limites gerais da chave. Veja Limites de uso.