Simular
POST
/nfse/simularValida a nota sem emitir: o motor monta a DPS (ou o RPS da prefeitura), confere no esquema oficial, valida CPF/CNPJ e CEP e assina com o certificado, mas não envia. Não gasta número, não grava nada e não conta na franquia. Mesmo corpo de POST /v1/nfse.
Corpo da requisição
empresa_idobrigatóriouuidEmpresa emissora.
data_competenciadateQuando o serviço foi prestado. Padrão: hoje (Brasília).
emails_adicionaisemail[]Recebem a nota além dos e-mails do tomador (com enviar_email_tomador). Até 10.
enviar_email_tomadorbooleanQuando autorizada, envia o PDF e o XML ao e-mail do tomador. Padrão: false.
id_externostringId do pedido no seu sistema. Repetir o mesmo id_externo na mesma empresa devolve a nota já criada.
metadataobjectAté 20 pares chave/valor seus.
retencoesobjectTributos federais retidos pelo tomador, em reais. Vão na DPS (grupo tribFed) e no RPS da prefeitura (ValorIr, ValorPis, ValorCofins, ValorCsll, ValorInss).
retencoes.cofinsdecimalCOFINS retido, em reais. Padrão: 0.
retencoes.cslldecimalCSLL retida, em reais. Padrão: 0.
retencoes.inssdecimalContribuição previdenciária retida (vRetCP). Padrão: 0.
retencoes.irdecimalIR retido, em reais. Padrão: 0.
retencoes.pisdecimalPIS retido, em reais. Padrão: 0.
servicoobjectO serviço da nota. Com servico_id, os códigos, a alíquota, o ISS retido, a descrição e o valor vêm do catálogo; o que vier aqui tem prioridade.
servico.aliquota_issdecimalPercentual (2.5 = 2,5%). Vazio no Emissor Nacional: a SEFIN usa a alíquota do município.
servico.c_nbsstringCódigo NBS (9 dígitos).
servico.c_trib_munstringCódigo de tributação municipal (3 dígitos), onde a prefeitura exige.
servico.c_trib_nacstringLC 116 + desdobramento (6 dígitos).
servico.cnaestringCNAE (7 dígitos).
servico.codigo_municipio_prestacaostringCódigo IBGE; padrão: o município da empresa.
servico.deducaoobjectDedução/redução da base de cálculo do ISSQN.
servico.desconto_condicionadodecimalNão altera o ISS; reduz o líquido.
servico.desconto_incondicionadodecimalReduz a base de cálculo do ISS.
servico.discriminacaostringDescrição que aparece na nota.
servico.exportacaoobjectExportação de serviço para tomador estrangeiro (EX).
servico.ibs_cbsobjectIBS/CBS (Reforma Tributária). Opcional em 2026; padrão: o do serviço do catálogo.
servico.informacoes_complementaresstringVai na nota (infoCompl) e no DANFSe.
servico.iss_retidobooleanSe o ISS é retido pelo tomador.
servico.servico_iduuidServiço do catálogo (POST /v1/servicos).
servico.valordecimalValor do serviço, em reais.
servico_iduuidAtalho para servico.servico_id.
tomadorobjectQuem recebe a nota. PF = CPF, PJ = CNPJ, EX = estrangeiro (NIF ou passaporte).
tomador.documentoobrigatóriostringCPF, CNPJ ou NIF. Tomador EX com motivo_sem_nif pode mandar vazio.
tomador.emailemailRecebe a nota (vai na DPS e no e-mail ao tomador).
tomador.emails_copiaemail[]Cópias do e-mail da nota. Até 5.
tomador.enderecoobjectEndereço com código IBGE do município.
tomador.endereco_exteriorobjectObrigatório para tomador EX (estrangeiro).
tomador.inscricao_municipalstringInscrição municipal.
tomador.motivo_sem_nifstringTomador EX sem NIF: por que não há (o documento é ignorado). dispensado, nao_exigido.
tomador.nomeobrigatóriostringNome ou razão social.
tomador.telefonestringTelefone.
tomador.tipostringSe não vier, sai do tamanho do documento (11 = PF, 14 = PJ). PF, PJ, EX.
tomador_iduuidTomador do catálogo (POST /v1/tomadores), no lugar de tomador.
Retorno
200 OK
Autenticação
Bearer sk_test_ / sk_live_
curl -X POST https://api.seelo.com.br/v1/nfse/simular \
-H "Authorization: Bearer sk_test_••••" \
-H "Content-Type: application/json" \
-d '{
"empresa_id": "8b0d6f0e-2c1a-4f4e-9a57-3f1e2d9c4a10",
"id_externo": "pedido-98765",
"data_competencia": "2026-11-01",
"tomador": {
"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"
}
},
"servico": {
"discriminacao": "Mensalidade do sistema - novembro/2026",
"valor": 1500,
"iss_retido": false,
"c_trib_nac": "010101"
},
"retencoes": {
"ir": 0,
"pis": 0,
"cofins": 0,
"csll": 0,
"inss": 0
},
"enviar_email_tomador": true,
"emails_adicionais": [
"contabil@cliente.com.br"
]
}'200
{ "objeto": "simulacao_nfse", "ambiente": "producao", "caminho": "nacional", "pendencias": [ { "descricao": "…", "complemento": null, "codigo": "…", "dica": null } ], "tentar_novamente": false, "valida": false, "xml_dps": null }