Triagem de notas fiscais

Leia uma nota fiscal ou boleto — PDF, Excel, Word ou uma foto — e decida se paga, manda para revisão ou recusa, e se vence em breve, com o template Triagem de notas fiscais.

Objetivo: o contas a pagar recebe notas fiscais por e-mail, formulários e upload. A Dcision lê cada documento e decide o que acontece: notas regulares são pagas, as incomuns são revisadas, as duplicadas são recusadas — e as urgentes chegam a uma pessoa hoje.

Crie a decisão

Templates → Triagem de notas fiscais (documento) → Criar decisão:

ParteConteúdo
Estadoinvoice (arquivo, obrigatório), message (string)
ContextoAs suas regras de pagamento — edite os fornecedores, os limites e as checagens
document_typechoice — invoice, receipt, contract, other
decisionchoice — pay, review, reject, other; confiança mínima 0.7
due_soonprobability — vence em até 3 dias, ou está vencida
Políticasdecision = reject → block; decision = review → escalate; document_type ≠ invoice → escalate; document_type = invoice e due_soon ≥ 0.8 → escalate; ação de fallback escalate

invoice é um campo de arquivo. PDFs com texto, Word, Excel, CSV e documentos parecidos são lidos pela Dcision sem custo; PDFs escaneados e fotos de notas em papel são lidos pela OpenAI, com a sua chave da OpenAI.

Chame-a

Envie o arquivo em base64, ou uma URL que a Dcision baixa:

curl -X POST https://api.dcision.io/v1/decisions/invoice-triage \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": {
      "invoice": {"url":"https://example.com/invoice-1042.pdf","filename":"invoice-1042.pdf"},
      "message": "Monthly hosting, as usual."
    }
  }'
200 OK (resumida)
{
  "schema": "invoice-triage",
  "result": { "document_type": "invoice", "decision": "pay", "due_soon": 0.12 },
  "action": "continue",
  "action_reason": { "type": "default" },
  "metrics": { "engine": "jev", "input_files": 1, "input_cost_usd": 0 }
}

A partir de uma caixa de e-mail ou de um formulário, o gatilho de webhook recebe o arquivo como multipart/form-data — sem código:

curl -X POST https://api.dcision.io/v1/hooks/whk_… \
  -F "invoice=@invoice-1042.pdf" -F "message=Monthly hosting, as usual."

Aja sobre o resultado

const decision = await dcisionDecide("invoice-triage", { invoice: fileFromBytes(pdf, "invoice-1042.pdf") });
if (decision.action === "continue") return schedulePayment(decision);
if (decision.action === "block") return archiveAsRejected(decision);
return assignToAccountsPayable(decision); // review, unusual document or due soon

Ajuste

  • Escreva as suas regras em context: fornecedores conhecidos, o valor que exige aprovação, o que torna uma nota incomum.
  • Adicione uma pergunta para o que você confere à mão hoje — "Os dados bancários diferem dos habituais do fornecedor?".
  • Leia o texto que a Dcision extraiu no log de execuções (invoice.text) quando uma decisão surpreender você.

Nesta página