PF PIS - CPF
PF PIS - CPF
Esta API retorna o número de inscrição no **PIS** (Programa de Integração Social) vinculado a uma pessoa física a partir do seu CPF. A consulta identifica o PIS/PASEP associado ao documento informado, permitindo o enriquecimento cadastral e a conciliação de registros trabalhistas e previdenciários.
<Note>
Indicado para enriquecimento cadastral, validação de vínculos trabalhistas e previdenciários e processos de onboarding que exijam o número do PIS do titular.
</Note>
## TABELA DE CAMPOS DE REQUISIÇÃO
| **Campo** | **Descrição** | **Formato** | **Obrigatório** |
|-----------|---------------|-------------|-----------------|
| **IdConsulta** | Identificador da consulta. Valor fixo: `300`. | string | Sim |
| **CpfCnpj** | CPF da pessoa a ser consultada. | string | Sim |
| **TipoPessoa** | Tipo de pessoa consultada. Valor fixo: `F`. | string | Sim |
## TABELA DE CAMPOS DE RETORNO
<AccordionGroup>
<Accordion title="Cabeçalho da Resposta — CONSULTA">
| **Campo** | **Descrição** | **Formato** |
|:----------|:--------------|:------------|
| **CONSULTA.CODIGORESPOSTA** | Número do protocolo de retorno gerado pelo servidor da API. | string |
| **CONSULTA.DATAHORA** | Data e hora exata em que o processamento foi concluído. | `DD/MM/YYYY HH:MM:SS` |
| **CONSULTA.LOGON** | Código de identificação da credencial de acesso que realizou a chamada. | string |
| **CONSULTA.IDCONSULTA** | Código identificador retornado para conciliação com o enviado na requisição. | string |
</Accordion>
<Accordion title="🪪 PIS — RESPOSTA">
| **Campo** | **Descrição** | **Formato** |
|:----------|:--------------|:------------|
| **RESPOSTA.CODIGO** | Código do resultado da consulta: `1` sucesso · `2` não encontrado · `3` erro. | string |
| **RESPOSTA.PIS** | Número de inscrição no PIS/PASEP vinculado ao CPF consultado. | string |
</Accordion>
</AccordionGroup>
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
Objeto de consulta com o CPF da pessoa a ser pesquisada.
Consulta
Response
Resposta da consulta:
* Código `1`: Sucesso.
* Código `2`: Dado não encontrado na base de dados.
* Código `3`: Erro na consulta.
Errors
400
Bad Request Error
401
Unauthorized Error
