Cadastrar tomador
POST
/tomadoresPF (CPF), PJ (CNPJ) ou estrangeiro (EX, com o NIF em documento ou motivo_sem_nif, e endereco_exterior). O tipo sai do tamanho do documento quando não vier. Para cadastrar muitos de uma vez, importe uma planilha em POST /tomadores/importar (CSV).
Corpo da requisição
documentoobrigatóriostringCPF, CNPJ ou NIF. Tomador EX com motivo_sem_nif pode mandar vazio.
nomeobrigatóriostringNome ou razão social.
emailemailRecebe a nota (vai na DPS e no e-mail ao tomador).
emails_copiaemail[]Cópias do e-mail da nota. Até 5.
enderecoobjectEndereço com código IBGE do município.
endereco_exteriorobjectObrigatório para tomador EX (estrangeiro).
endereco_exterior.bairroobrigatóriostringBairro ou distrito (use o da cidade se não houver).
endereco_exterior.cidadeobrigatóriostring
endereco_exterior.codigo_postalobrigatóriostring
endereco_exterior.complementostring
endereco_exterior.estado_provinciaobrigatóriostring
endereco_exterior.logradouroobrigatóriostring
endereco_exterior.numeroobrigatóriostring
endereco_exterior.paisobrigatóriostringPaís, código ISO de 2 letras.
inscricao_municipalstringInscrição municipal.
motivo_sem_nifstringTomador EX sem NIF: por que não há (o documento é ignorado). dispensado, nao_exigido.
telefonestringTelefone.
tipostringSe não vier, sai do tamanho do documento (11 = PF, 14 = PJ). PF, PJ, EX.
Retorno
201 Created
Autenticação
Bearer sk_test_ / sk_live_
curl -X POST https://api.seelo.com.br/v1/tomadores \
-H "Authorization: Bearer sk_test_••••" \
-H "Content-Type: application/json" \
-d '{
"tipo": "PJ",
"documento": "12345678000199",
"nome": "Cliente Exemplo LTDA",
"email": "financeiro@cliente.com.br",
"endereco": {
"logradouro": "Rua das Trincheiras",
"numero": "100",
"bairro": "Centro",
"codigo_ibge": "2507507",
"uf": "PB",
"cep": "58000000"
}
}'201
{ "id": "5e2a7c41-9d08-4b6f-a3c2-71e4f0b8d913", "objeto": "tomador", "tipo": "PJ", "documento": "12345678000199", "nome": "Cliente Exemplo LTDA", "email": "financeiro@cliente.com.br", "atualizado_em": "2026-11-01T14:00:00-03:00", "criado_em": "2026-11-01T14:00:00-03:00", "emails_copia": [], "endereco": { "logradouro": "Rua das Trincheiras", "numero": "100", "complemento": null, "bairro": "Centro", "codigo_ibge": "2507507", "uf": "PB", "cep": "58000000" }, "endereco_exterior": { "logradouro": "Rua das Trincheiras", "numero": "100", "complemento": null, "bairro": "Centro", "cidade": "New York", "codigo_postal": "10001", "estado_provincia": "NY", "pais": "US" }, "inscricao_municipal": "179827", "motivo_sem_nif": null, "telefone": "83999990000" }