API para entrada de notas fiscais em sistemas externos

O HubNotas recebe imagens, fotos, PDFs e XMLs de notas fiscais, extrai os dados principais com a chave Gemini ou OpenAI do proprio usuario, organiza tudo por conta e devolve um JSON pronto para integracoes externas.

Notas fiscais sendo processadas por uma API financeira

Para que serve

Entrada centralizada

Receba notas de diferentes sistemas usando um contrato HTTP unico, com tokens Bearer gerenciados pelo usuario.

Dados separados

Cada usuario acessa apenas seus sistemas clientes e suas proprias notas fiscais.

Extracao automatica

Com Gemini ou OpenAI configurado, o retorno ja traz fornecedor, numero, data, valor, categoria e pagamento.

Fluxo de uso

1

Crie sua conta, escolha Gemini ou OpenAI e salve sua chave no painel.

2

Gere um token Bearer e cadastre o sistema cliente que vai enviar notas.

3

Envie a nota com system_id, external_id e arquivo.

4

Receba o JSON extraido e use os dados no seu sistema.

Endpoint principal

POST /api/v1/invoices Authorization: Bearer SEU_TOKEN Accept: application/json multipart/form-data system_id=1 external_id=NF-001 file=@nota.pdf

Use um external_id unico por nota. Se repetir o mesmo ID no mesmo sistema, o HubNotas retorna o registro ja salvo para evitar duplicidade.