Empresas
Tomadores
Cadastro de clientes (tomadores) do seu contribuinte -- alimenta a resolução automática de tomador na Emissão Conjunta de NFS-e: uma vez carregado, o link público já chega com os dados do tomador preenchidos.
Cadastrar / atualizar um tomador POST
Upsert por (contribuinte, documento) -- reenviar o mesmo documento atualiza os dados.
| Campo | Obrigatório | Observação |
|---|---|---|
documento | Sim | CNPJ ou CPF do tomador. |
tipo_documento | Não | CNPJ (padrão) ou CPF. |
razao_social | Sim | |
email, telefone | Não | |
inscricao_estadual, inscricao_municipal | Não | |
endereco | Não | Objeto {logradouro, numero, bairro, municipio_ibge, uf, cep}. |
curl -X POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/tomadores \
-H "Authorization: Bearer cf_live_51JqK..." \
-H "Content-Type: application/json" \
-d '{
"documento": "98765432000110",
"razao_social": "Cliente Exemplo Ltda",
"email": "financeiro@clienteexemplo.com.br",
"endereco": {"logradouro": "Av. Ipiranga", "numero": "1200", "municipio_ibge": 4314902, "uf": "RS", "cep": "90160091"}
}'Resposta
{
"ambiente": "PRODUCTION",
"tomador": {
"tomador_id": "a1b2c3d4-...",
"contribuinte_id": "3d390cff-...",
"tomador_hash": "e3b0c44298fc1c14...",
"tipo_documento": "CNPJ",
"documento": "98765432000110",
"razao_social": "Cliente Exemplo Ltda",
"email": "financeiro@clienteexemplo.com.br",
"telefone": "",
"inscricao_estadual": "",
"inscricao_municipal": "",
"endereco": {"logradouro": "Av. Ipiranga", "numero": "1200", "bairro": "", "municipio_ibge": 4314902, "uf": "RS", "cep": "90160091"},
"criado_em": "2026-08-07T10:00:00-03:00",
"atualizado_em": "2026-08-07T10:00:00-03:00"
}
}tomador_hash é sha256(documento_contribuinte:documento_tomador)
-- calculável no seu próprio sistema, sem precisar guardar o tomador_id.
Ver Consulta pelo hash abaixo.
Carga em lote POST
Mesmo upsert, em lote. Corpo é um array de objetos com o mesmo formato acima -- ou
{"tomadores": [...]}. Pensado pra sincronização inicial de toda a base de
clientes de uma vez.
Listar / consultar
| Endpoint | Retorna |
|---|---|
GET /v1/contribuintes/{id}/tomadores | Todos os tomadores do contribuinte. |
GET /v1/contribuintes/{id}/tomadores/{documento} | Um tomador específico, por CPF/CNPJ. |
GET /v1/tomadores/{tomador_hash} | Lookup direto pelo hash de conveniência -- ainda revalida que o tomador pertence a um contribuinte ativo do seu contrato antes de devolver qualquer dado. |