Pular para o conteúdo principal

Pegar dados de arquivos

POST /get_ocr_data_by_file​

Descrição​

Extrai dados financeiros de boletos e cupons fiscais através da análise de QR Codes e códigos de barras presentes no arquivo enviado.

Requisição​

Headers​

  • Content-Type: multipart/form-data

Body da Requisição​

ParâmetroTipoDescriçãoExemploPadrão
access_tokenstringToken de acesso do usuário (obrigatório)4b194dff-eb83-4af7-ac6f-951fe7931e43-
unit_tokenstringToken de identificação da unidade (obrigatório)5bd5bc16-780f-438c-8665-c8cb7cccbe45-

Anexos de Arquivos:

  • file: Arquivo principal (PDF ou imagem), apenas um permitido

Respostas​

Abaixo estão algumas respostas que podem ser retornadas dependendo dos parâmetros:

200 Sucesso(exemplo de saida de boleto)​

{
  "success": true,
  "message": "OCR data retrieved successfully",
  "data": [
    {
      "data": "82650000001907700970910730452087432916773183",
      "orientation": "UP",
      "parser": {
        "barcode": "82650000001907700970910730452087432916773183",
        "date": "",
        "digitable_line": "82650000001-1 90770097091-2 07304520874-8 32916773183-8",
        "value": 190.77
      },
      "quality": 4,
      "type": "I25"
    }
  ]
}

400 Requisição Inválida​

{
  "success": false,
  "message": "Missing parameters",
  "data": null
}

403 Acesso Negado​

{
  "success": false,
  "message": "Invalid data",
  "data": null
}

500 Erro no Servidor​

{
  "success": false,
  "error": "Internal server error",
  "data": null
}

Exemplo de Requisição​

curl -s -X POST 'https://portal.fipli.pro/api/v1/get_ocr_data_by_file' \
    -F 'metadata={
      "access_token": "4b194dff-eb83-4af7-ac6f-951fe7931e44",
      "unit_token": "5bd5bc16-780f-438c-8665-c8cb7cccbe4b"
    };type=application/json' \
    -F 'file=@./arquivo.pdf' \
    | jq

Observações Importantes

  • Tipos de arquivo suportados: PDF, imagens (JPG, PNG)

  • Permitido apenas um entre boleto(barcode) ou nota fiscal(access_key)

  • O conteúdo JSON deve ser enviado como parte do formulário (multipart/form-data), dentro de um campo específico chamado 'metadata', e não no corpo bruto da requisição.