Documentação
API de emitentes
Basehttps://api.apisimples.com/v1
Visão geral
Cadastre e atualize emitentes pela API com a chave geral da conta. Dá para habilitar documentos, enviar o certificado A1 e configurar o download de NF-e/NFC-e de saída com os XMLs semente por série.
/emitentesLista os emitentes da conta./emitentesCadastra um emitente./emitentes/{id}Consulta um emitente./emitentes/{id}Atualiza um emitente./emitentes/{id}/excluirExclui um emitente.Com o download de saída ativo, as notas emitidas (saída) são capturadas e o XML fica disponível nestas rotas — com a chave do emitente:
/saida/notasLista as notas de saída capturadas./saida/notas/{id}Consulta uma nota de saída./saida/notas/{id}/xmlBaixa o XML da nota de saída (base64)./saida/sincronizarDispara a captura das notas mais recentes.A cobertura por estado do download de saída está em /cobertura. Detalhes em Listar notas e Baixar XML.
Testar
Use a chave geral da conta (aps_…), não a chave do emitente.
Autenticação
Cadastro de emitentes: chave geral da conta (aps_…), no painel em Empresa.
Authorization: Bearer aps_sua_chave_da_conta
Content-Type: application/json
Accept: application/jsonNotas e XML de saída (/saida/…): chave do emitente (apse_…), a mesma da emissão.
Authorization: Bearer apse_sua_chave_do_emitente
Accept: application/jsonListar
https://api.apisimples.com/v1/emitentesCriar
https://api.apisimples.com/v1/emitentesHTTP 201 devolve o emitente com a chave apse_… para as demais APIs.
{
"nome": "Loja Centro",
"razao": "Loja Centro LTDA",
"cnpj": "12345678000199",
"crt": "1",
"telefone": "11999990000",
"email": "fiscal@loja.com.br",
"rua": "Rua das Flores",
"numero": "100",
"bairro": "Centro",
"cmun": "3550308",
"municipio": "São Paulo",
"uf": "SP",
"cep": "01001000",
"documentos": {
"nfe": true,
"nfce": true
},
"nfe_ambiente": "2",
"csc": "seu-csc",
"cscid": "1",
"certificado": "base64-do-pfx",
"certificado_senha": "senha-do-pfx",
"download_saida": {
"nfe": true,
"nfce": true
},
"xmls_saida": [
{
"modelo": "55",
"xml": "base64-ou-conteudo-do-xml-nfe"
},
{
"modelo": "65",
"xml": "base64-ou-conteudo-do-xml-nfce"
}
]
}curl -X POST https://api.apisimples.com/v1/emitentes \
-H "Authorization: Bearer aps_sua_chave_da_conta" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"nome": "Loja Centro",
"razao": "Loja Centro LTDA",
"cnpj": "12345678000199",
"crt": "1",
"telefone": "11999990000",
"email": "fiscal@loja.com.br",
"rua": "Rua das Flores",
"numero": "100",
"bairro": "Centro",
"cmun": "3550308",
"municipio": "São Paulo",
"uf": "SP",
"cep": "01001000",
"documentos": {
"nfe": true,
"nfce": true
},
"nfe_ambiente": "2",
"csc": "seu-csc",
"cscid": "1",
"certificado": "base64-do-pfx",
"certificado_senha": "senha-do-pfx",
"download_saida": {
"nfe": true,
"nfce": true
},
"xmls_saida": [
{
"modelo": "55",
"xml": "base64-ou-conteudo-do-xml-nfe"
},
{
"modelo": "65",
"xml": "base64-ou-conteudo-do-xml-nfce"
}
]
}'{
"id": "8f3c2a10-6b4e-4d2a-9c11-2e5a7b9d0f31",
"nome": "Loja Centro",
"razao": "Loja Centro LTDA",
"cnpj": "12345678000199",
"uf": "SP",
"municipio": "São Paulo",
"documentos": [
"nfe",
"nfce"
],
"download_saida": {
"nfe": true,
"nfce": true
},
"chave": "apse_chave_do_emitente",
"certificado": {
"cadastrado": true,
"titular": "LOJA CENTRO LTDA",
"documento": "12345678000199",
"validade": "2027-12-31 23:59:59"
},
"xmls_saida": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"modelo": "55",
"serie": "1",
"chave": "35261012345678000199550010000000151000000015",
"criado_em": "2026-11-17 13:00:00"
}
],
"criado_em": "2026-11-17 13:00:00",
"atualizado_em": "2026-11-17 13:00:00"
}Consultar
https://api.apisimples.com/v1/emitentes/{id}Inclui certificado (metadados), documentos, download de saída e a lista de XMLs semente.
Atualizar
https://api.apisimples.com/v1/emitentes/{id}Atualização parcial: campos omitidos mantêm o valor atual. Se enviar documentos ou download_saida, o objeto substitui o conjunto atual. Novos itens em xmls_saida entram por série; use remover_xmls_saida com os ids para apagar.
Excluir
https://api.apisimples.com/v1/emitentes/{id}/excluirPayload
Campos do payload
Nome fantasia, 2 a 60 caracteres.
Razão social, 2 a 60 caracteres.
Apelido interno, até 60 caracteres.
CNPJ com 14 dígitos. Obrigatório se não houver CPF.
CPF com 11 dígitos.
Regime tributário: 1, 2, 3 ou 4.
Inscrições e CNAE quando aplicável.
Somente dígitos.
E-mail de contato.
Endereço. Complemento opcional.
Flags booleanas: nfe, nfce, nfse, pix, boleto, etc.
1 produção ou 2 homologação, se NF-e/NFC-e estiver ligada.
Obrigatórios se NFC-e estiver ligada.
Sistema e ambiente da NFS-e, se habilitada.
URL de webhook do emitente.
Imagem JPG/PNG em base64, até 1 MB.
true remove a logo na atualização.
PFX/P12 em base64. Exigido para NF-e/NFC-e e download de saída.
Senha do PFX.
true remove o certificado na atualização.
nfe e/ou nfce em true para baixar notas emitidas.
Lista de XMLs semente. Veja a seção abaixo.
Ids dos XMLs a remover na atualização.
Nenhum campo corresponde à busca.
Download de saída
Com download_saida.nfe ou download_saida.nfce em true, o emitente passa a capturar as notas emitidas (saída). Exige certificado A1 e os XMLs semente por série. A disponibilidade por UF está em Cobertura.
As notas capturadas ficam disponíveis nas rotas /saida/notas, autenticadas com a chave do emitente (apse_…).
{
"download_saida": {
"nfe": true,
"nfce": true
}
}XMLs por série
Um XML por série dos últimos 60 dias, usado para cadastrar a série na captura. Aceita o XML em texto ou em base64. Validamos o modelo (55 ou 65) e o CNPJ do emitente no XML.
Na NFC-e, SP, AM e GO não exigem XML semente (sistemas próprios).
Campos do payload
55 para NF-e ou 65 para NFC-e.
Conteúdo do XML ou base64.
Nenhum campo corresponde à busca.
{
"xmls_saida": [
{
"modelo": "55",
"xml": "<?xml version=\"1.0\"?><nfeProc>...</nfeProc>"
},
{
"modelo": "65",
"xml": "conteudo-ou-base64"
}
]
}Listar notas de saída
Com o download de saída habilitado no emitente, as notas capturadas entram nesta lista. Use a chave do emitente (apse_…).
https://api.apisimples.com/v1/saida/notasCampos do payload
55 (NF-e) ou 65 (NFC-e).
Filtro por emissão — AAAA-MM-DD.
Página, padrão 1.
Itens por página, padrão 20, máx. 50.
Nenhum campo corresponde à busca.
curl "https://api.apisimples.com/v1/saida/notas?modelo=55&inicio=2026-11-01&fim=2026-11-30&page=1&limite=20" \
-H "Authorization: Bearer apse_sua_chave_do_emitente" \
-H "Accept: application/json"{
"notas": [
{
"id": "66afda7c-fde3-46fd-b533-2ba6f5f945c2",
"chave": "35261112345678000199550010000000151000000015",
"modelo": "55",
"serie": "1",
"numero": "15",
"data_emissao": "2026-11-10 14:22:01",
"valor_total": 190.5,
"cancelada": false,
"has_xml": true,
"criado_em": "2026-11-17 13:00:00",
"atualizado_em": "2026-11-17 13:00:00"
}
],
"page": 1,
"limite": 20,
"total": 1,
"tem_mais": false
}Consulta de uma nota:
https://api.apisimples.com/v1/saida/notas/{id}Para forçar a captura das notas mais recentes deste emitente:
https://api.apisimples.com/v1/saida/sincronizarcurl -X POST "https://api.apisimples.com/v1/saida/sincronizar" \
-H "Authorization: Bearer apse_sua_chave_do_emitente" \
-H "Accept: application/json"{
"ok": true,
"resultado": {
"emitentes": 1,
"notas": 40,
"xmls": 12,
"erros": 0
}
}Baixar XML de saída
Devolve o XML autorizado da nota de saída em base64. O id é o da lista /saida/notas. Só funciona com has_xml: true.
https://api.apisimples.com/v1/saida/notas/{id}/xmlcurl "https://api.apisimples.com/v1/saida/notas/{id}/xml" \
-H "Authorization: Bearer apse_sua_chave_do_emitente" \
-H "Accept: application/json"{
"id": "66afda7c-fde3-46fd-b533-2ba6f5f945c2",
"chave": "35261112345678000199550010000000151000000015",
"modelo": "55",
"xml": "base64-do-xml-nfeproc"
}HTTP 404 com xml_indisponivel se o XML ainda não tiver sido capturado. Chame POST /saida/sincronizar e tente de novo.
Erros
| HTTP | Código | Quando |
|---|---|---|
| 401 | autenticacao_ausente | O header Authorization não veio. |
| 401 | autenticacao_invalida | Chave inválida (aps_… no cadastro ou apse_… em /saida). |
| 403 | conta_inativa | A conta está inativa. |
| 403 | download_saida_desabilitado | O emitente não tem download de saída ligado. |
| 404 | emitente_nao_encontrado | O id não existe nesta conta. |
| 404 | nota_nao_encontrada | A nota de saída não é deste emitente. |
| 404 | xml_indisponivel | O XML da nota ainda não foi capturado. |
| 422 | validacao | Campos inválidos; veja a lista erros. |