> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lendflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bluCognition

## bluCognition

bluCognition extracts employee payroll amounts from payroll-report PDFs already attached to an application. It does not perform identity-document verification. The Workflow Builder block and service ID are `blu_cognition`; the block supports business and individual entities.

<Warning>
  bluCognition is a bring-your-own-credentials service. Your organization must connect active bluCognition credentials before the service can run.
</Warning>

## Requirements

| Application field | Requirement | Notes |
| - | - | - |
| Payroll report files | Required | Every application file categorized as a Payroll Report must be a PDF. |

## Run bluCognition

Call [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application):

```json theme={"system"}
{
  "provider": "blu_cognition"
}
```

The request queues the service. Poll [Get Commercial Data](/api-reference/workflow-management/get-commercial-data) with `services[]=blu_cognition`.

| Result | API path |
| - | - |
| Extracted payroll response | `commercial_data.blu_cognition` |
| Latest lifecycle status | `statuses.blu_cognition` |
| Stored provider request | `request_data.blu_cognition` |

## Data Orchestration availability

`blu_cognition` is not exposed as a current Data Orchestration condition attribute or prerequisite service. Run it through the registered Workflow Builder block or the application-enrichment API.

## What the service returns

| Response area | Meaning |
| - | - |
| `request_summary` | bluCognition's identifier and file summary for the extraction request. |
| `salary_information` | Employee-level payroll amounts extracted from the submitted PDFs. |

## Representative response

```json theme={"system"}
{
  "request_summary": {
    "case_unique_id": "SS23BLU-27636",
    "file_name": "payroll"
  },
  "salary_information": [
    {
      "employee_id": "27",
      "employee_name": "Example, Employee",
      "statement_period": "Quarter 2, 2020",
      "amount": 13400.0
    },
    {
      "employee_id": "49",
      "employee_name": "Sample, Worker",
      "statement_period": "Quarter 2, 2020",
      "amount": 22400.0
    }
  ]
}
```

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `request_summary` | Object | Provider summary of the extraction request. | Provider object. | On a successful response. |
| `request_summary.case_unique_id` | String | bluCognition's case identifier. | Provider-generated text. | When supplied. |
| `request_summary.file_name` | String | Provider file summary. | Provider text. | When supplied. |
| `salary_information` | Array | Extracted employee payroll entries. | Zero or more objects. | On a successful response. |
| `salary_information[].employee_id` | String | Employee identifier extracted by bluCognition. | Text. | For each extracted entry. |
| `salary_information[].employee_name` | String | Extracted employee name. | Text. | For each extracted entry. |
| `salary_information[].statement_period` | String | Payroll period represented by the amount. | Provider-formatted period text. | For each extracted entry. |
| `salary_information[].amount` | Number | Extracted payroll amount. | Numeric currency amount; the response does not provide a currency field. | For each extracted entry. |

## Errors and statuses

* `All payroll report files must be in PDF format.` means at least one application Payroll Report is not a PDF. Lendflow does not send any files in this case.
* `Unable to retrieve bearer token.` means provider authentication failed.
* `Bearer token missing from response.` means bluCognition's authentication response did not contain the required token.
* Provider HTTP errors fail the enrichment request and appear in the service lifecycle status.

## FAQ

<AccordionGroup>
  <Accordion title="Does bluCognition verify identity documents?">
    No. This block extracts salary information from payroll-report PDFs.
  </Accordion>

  <Accordion title="Can I submit PNG or JPG payroll reports?">
    No. Every application file categorized as a Payroll Report must be a PDF.
  </Accordion>

  <Accordion title="Can bluCognition run in Data Orchestration?">
    It is not currently exposed as a Data Orchestration condition attribute or prerequisite service.
  </Accordion>
</AccordionGroup>