emitir_nota
Preparar emissão de NFS-e (prévia)
Prepara uma NFS-e e devolve a PRÉVIA + confirmacao_token. NÃO emite nada. Mostre a prévia ao usuário e chame confirmar_emissao só depois do OK explícito dele. Tomador: informe tomador_id (salvo) OU tomador_doc + tomador_razao.
輸入參數valor必填tomador_idcompetenciatomador_docconfiguracaotomador_paistomador_tipodiscriminacao必填tomador_razaoconfiguracao_id
listar_configuracoes
Listar configurações fiscais recentes
Últimas combinações realmente usadas de serviço, CNAE, NBS e tributação. Use configuracao_id em emitir_nota. Se houver ambiguidade, pergunte ao usuário — não escolha nem invente código fiscal.
輸入參數limite
confirmar_emissao
Confirmar e emitir a NFS-e
Emite DE VERDADE a nota da prévia. Chame apenas depois que o usuário aprovou a prévia nesta conversa. Idempotente: o mesmo token nunca emite duas vezes. Autorizada, devolve danfse_url (PDF) e xml_url — links para o usuário abrir, que você não consegue baixar.
輸入參數confirmacao_token必填
consultar_nota
Consultar uma nota
Situação de uma nota desta conta (status, número, chave de acesso, erro).
輸入參數nota_id必填
Histórico de notas da conta, com filtros opcionais.
輸入參數limitestatuscompetencia
cancelar_nota
Cancelar uma nota
Cancela uma NFS-e autorizada na SEFIN. Exige confirmar=true — peça confirmação explícita ao usuário antes. O crédito da emissão NÃO volta (a nota existiu); o cancelamento é grátis.
輸入參數motivo必填nota_id必填confirmar必填codigo_motivo
listar_tomadores
Listar tomadores salvos
Tomadores salvos desta conta (use o id em emitir_nota). Passe `busca` com o NOME que o usuário falou para achar o tomador sem precisar do CNPJ — ignora acento, caixa e pontuação. Se voltar mais de um, pergunte qual antes de emitir.
輸入參數busca
salvar_tomador
Salvar tomador
Salva/atualiza um tomador frequente (ex.: "salva a Shopee como tomador").
輸入參數docpaistiporazao必填
saldo
Créditos de notas e limites
Quantidade de notas disponíveis, preço por nota, ambiente e teto diário. O nome técnico saldo é mantido por compatibilidade.
無需輸入參數。
comprar_creditos
Adicionar créditos de notas
Gera um link de pagamento (Pix/cartão) para adicionar créditos de notas. Entregue o link ao usuário — o pagamento acontece no navegador dele e as notas entram após a confirmação.
輸入參數valor_centavos必填