Conflaro

Mostra os dados da empresa dona da chave de API configurada (razão social, CNPJ, IE/IM, regime tributário, endereço).

Takes no parameters.

Lista os documentos fiscais (NF-e/NFC-e/NFS-e) da empresa, com paginação e filtros por status e tipo.

Detalha um documento fiscal pelo id (status, número, chave de acesso, itens, etc.).

Cria um documento fiscal (rascunho). Use emit=true para já enfileirar a emissão. Impostos são resolvidos pela regra tributária quando não informados.

Dispara a emissão (assíncrona) de um documento fiscal já criado. Acompanhe o status com get_fiscal_document.

Cancela um documento fiscal AUTORIZADO, com justificativa.

Emite uma Carta de Correção (CC-e) para um documento fiscal autorizado.

Baixa o XML autorizado de um documento fiscal (retorna o XML como texto).

GNRE da nota (guia de recolhimento do DIFAL, FCP e ICMS-ST devidos a OUTRA UF): o que a NF-e autorizada exige (`assessment`, pelo XML), as guias geradas (status, valor, vencimento, `digitableLine` para pagar) e a cota do mês. `noGuideReason` explica quando NÃO há guia devida. Valores em string decimal.

Gera (ou regera) as guias GNRE da nota no Portal GNRE — fala com o fisco, consome a cota do plano e cria obrigação de pagamento: confirme com o usuário antes. Idempotente (guia emitida não é refeita). O resultado sai em ≥ 30 s: depois consulte get_fiscal_document_gnre (ou refresh_fiscal_document_gnre). `blocked` = falta dado que só a pessoa resolve; o motivo fica na guia. Exige o módulo GNRE (403 `feature_not_enabled`).

Consulta AGORA no Portal GNRE o resultado das guias enviadas da nota (emitidas ganham linha digitável; rejeitadas, o motivo). `processing: true` = o portal ainda processa; tente de novo em alguns segundos.

Lista as guias GNRE da empresa (mais recentes primeiro), com filtro por status, UF favorecida e ambiente (padrão PRODUCTION). Sem o módulo GNRE a resposta é 403 `feature_not_enabled` — não conclua que não há guias.

Lista as regras tributárias da empresa (use o id em taxRuleId ao criar documentos).

Takes no parameters.

Lista os produtos da empresa, com a tributação própria de cada um. Use o id em items[].productId ao criar documentos.

Detalha um produto pelo id (configuração de NF-e com a tributação própria, e de NFS-e).

Cadastra um produto, opcionalmente com a tributação própria em nfeConfig. Campo de imposto preenchido no produto vale em toda venda dele; em branco, vale a regra fiscal.

Atualiza um produto. Só os campos enviados mudam (null limpa); na tributação, o enviado é mesclado com o gravado — mandar só pisCst não apaga o CSOSN.

Contas a receber VENCIDAS, da mais antiga para a mais nova (ordem de cobrança). `total` soma todas as vencidas mesmo quando a lista vem truncada.

Quem mais deve, agrupado por cliente, com o maior atraso de cada um. Use para priorizar cobrança.

Projeção de caixa por vencimento. NÃO inclui saldo bancário, e o que já venceu vem separado — nunca some `vencidoNaoRecebido` ao `resultadoPrevisto`: isso assumiria que o inadimplente vai pagar.

Lista as PARCELAS de contas a receber ou a pagar. A parcela é a unidade que vence e que recebe baixa. Use `derivedStatus` (não `status`) para saber se atrasou.

Totais em aberto e aging (faixas de atraso) de um lado. As faixas somam `totalAberto − aConfirmar`, não o total.

Ficha completa de um título: parcelas e histórico de baixas, incluindo as ESTORNADAS (`reversedAt` preenchido, e fora de toda soma).

Lança uma conta a receber ou a pagar. Conta à vista é 1 parcela. Use `schedule` quando já souber os vencimentos — ele vence `installments`/`totalAmount`.

Registra uma baixa na PARCELA (não no título). `amount` é o PRINCIPAL, o que abate a conta — juros e multa vão nos campos próprios e não abatem saldo. Valor menor que o saldo é baixa parcial, caminho normal.

Lista as notas RECEBIDAS (emitidas contra o CNPJ pelos fornecedores), NSU mais novo primeiro. `pending=true` = só as NF-e que ainda precisam de manifestação. `schemaType` RES_NFE é só o resumo: manifeste CIENCIA para liberar o XML completo.

Detalha uma nota recebida: emitente, valor, situação, manifestação e se a DANFE já pode ser gerada (`pdf.available`, com o motivo quando não).

Baixa o XML da nota recebida (o resumo enquanto não houver Ciência; a nota completa depois).

Manifesta a nota recebida perante a SEFAZ, EM NOME DA EMPRESA — é ato jurídico e NÃO TEM DESFAZER. Confirme com o usuário antes de DESCONHECIDA ou NAO_REALIZADA (recusam a nota e cancelam a conta a pagar dela). CIENCIA libera o XML completo. NAO_REALIZADA exige `justification` com 15+ caracteres. Só NF-e.

Busca agora, na SEFAZ, as notas recebidas novas (a busca já roda sozinha a cada hora). Assíncrono. Depois de uma consulta sem novidades a SEFAZ exige 1h de espera: a resposta 429 `sefaz_wait` traz quando tentar de novo — não repita antes.

Estado da busca de notas recebidas: último NSU, último retorno da SEFAZ, se há certificado e quando a próxima sincronização manual é permitida (`nextSyncAllowedAt`).

Download em LOTE: todas as notas recebidas de um MÊS num ZIP (XMLs em notas/ e eventos/). Devolve um LINK (`url`) — entregue-o ao usuário como link clicável para ele baixar no navegador; NÃO tente abrir nem ler o ZIP. O link vale 15 minutos. Sem `companyId`: a empresa da chave. MODO CONTADOR (chave do escritório): `companyId` = uma empresa da carteira; `portfolio: true` (ou `companyIds`) = várias empresas num ZIP só, uma pasta por empresa. `pendingSummaries` > 0 = NF-e que só têm o resumo: manifeste CIENCIA para a nota completa entrar no pacote. Mês sem nada volta 404 `no_documents`.

MODO CONTADOR (chave do escritório `ok_`): o escritório, quantas empresas estão na carteira e os escopos da chave.

Takes no parameters.

Estimativa do DAS do Simples Nacional na competência (AAAA-MM; padrão o mês corrente), pelas notas autorizadas em produção. É ESTIMATIVA: com `status: incomplete` o `das` vem null e `pendencies` diz o que falta (receita de meses anteriores ao sistema, anexo dos serviços, folha) — nunca invente o valor. `two_scenarios` = fator R sem folha: o DAS fica entre o Anexo III e o V. Escopo `simples:read`.

MODO CONTADOR: o DAS estimado de cada empresa da carteira na competência (AAAA-MM; padrão o mês corrente). `status: incomplete` = faltam dados naquela empresa (detalhe com get_simples_estimate + companyId); `error` = a conta falhou só nela.

Simula, para empresa do Simples Nacional, recolher o IBS/CBS DENTRO do DAS × FORA dele (regime regular, opção semestral a partir de 2027: em setembro para jan–jun e em março para jul–dez). Devolve o imposto da empresa nos dois casos (`inside.das` × `outside.total`), o crédito que os clientes com CNPJ recuperam (`clientsCredit`), a `reading` e as `premises`. É ESTIMATIVA para conversar com o contador, nunca recomendação fiscal. `cbs_not_published` = a CBS do ano não saiu: só mande `cbs` se a PESSOA informar a alíquota a simular — nunca chute, e diga que o resultado usa a premissa dela. Cobre 2027 e 2028. Escopo `simples:read`.

Previsão do DAS do MÊS CORRENTE se o mês seguir no ritmo dos dias já decorridos, e a RBT12 e a faixa do mês seguinte (`nextMonth.warnings`: muda_de_faixa | sublimite | teto — avise ANTES de acontecer). `fewDays: true` = poucos dias, projeção instável: diga isso. Escopo `simples:read`.

Quanto do preço de um produto é imposto (empresa do Simples): alíquota efetiva do DAS do anexo do produto, imposto no preço, margem e o PREÇO MÍNIMO para a margem desejada. Valores em string decimal ("40.00"). `minimumPrice: null` = imposto + despesas + margem passam de 100%. Nada é gravado. Escopo `simples:read`.

NF-e recebidas (últimos 60 dias, ainda sem decisão) de fornecedor que NUNCA emitiu para a empresa e com valor ou mercadoria fora do padrão — pode ser nota fria contra o CNPJ. Apresente como algo a CONFERIR, nunca como acusação. Se a pessoa disser que a compra não aconteceu, a saída é manifestar Desconhecimento da operação (manifest_received_document, `210220`) — só com a confirmação dela. Escopo `received-documents:read`.

MODO CONTADOR: as empresas-cliente com vínculo ATIVO com o escritório. O `id` de cada uma é o `companyId` das outras ferramentas.

MODO CONTADOR: empresas da carteira com nota de PRODUÇÃO autorizada ou cancelada no mês (BRT) — as que o fechamento vai processar. Mês é 1–12.

MODO CONTADOR: pede o fechamento fiscal do mês — um ZIP por empresa com XML e/ou DANFE. Assíncrono: acompanhe com list_fiscal_closings. Sem `companyIds` vale para a carteira inteira (até 200). Empresa sem nota no mês, com fechamento em andamento ou fora da carteira volta em `skipped`, com o motivo.

MODO CONTADOR: os fechamentos fiscais da carteira e a situação de cada um (PENDING, PROCESSING, COMPLETED, FAILED).

MODO CONTADOR: link para baixar o ZIP de um fechamento COMPLETED (válido por 1 hora). Antes de terminar, a resposta diz a situação atual.

Lista os endpoints de webhook da empresa.

Takes no parameters.

Cria um endpoint de webhook que recebe eventos assinados (document.authorized/rejected/cancelled/inutilized). O segredo de assinatura é retornado apenas uma vez.