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

# SENIAT: cadastro de contribuintes (RIF)

> Consulte um contribuinte venezuelano pelo RIF no cadastro do SENIAT: nome, atividade econômica, condição perante o IVA e alíquota de retenção.

Consulta um contribuinte no Registro de Información Fiscal (RIF) do SENIAT, a
administração tributária da Venezuela: pessoas, empresas e órgãos públicos, com a
alíquota de retenção de IVA que um agente de retenção deve aplicar a eles.

`POST /ve/seniat/rif/v1` [Live](https://docs.usecroma.com/pt/live-lookups.md)

| Campo | Tipo | Notas |
| - | - | - |
| `rif` | string | **Obrigatório.** A letra do tipo (`V` pessoa, `E` estrangeiro, `J` empresa, `P` passaporte, `G` governo, `C` comunal) e nove dígitos, o último o verificador. `J-00124134-5` e `J001241345` são o mesmo. |

```bash theme={"dark"}
curl https://api.croma.run/ve/seniat/rif/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rif": "J001241345" }'
```

| Campo | Notas |
| - | - |
| `found` | `false` quando o registro não tem um contribuinte com esse RIF. Um dígito verificador errado é lido como um número desconhecido. |
| `rif` | O RIF consultado, em maiúsculas e sem separadores. |
| `name` | O nome registrado do contribuinte. |
| `trade_name` | O nome comercial impresso entre parênteses após o nome, ou `null`. |
| `economic_activity` | A atividade econômica registrada, ou `null` quando o registro não tem nenhuma. |
| `vat_condition` | A condição perante o IVA, p. ex. "Contribuyente Ordinario del IVA y Agente de Retención del IVA". `null` quando não aparece. |
| `vat_withholding_rate` | A parcela do IVA que um agente de retenção retém deste contribuinte: `75` ou `100`. |
| `vat_withholding_note` | A frase de retenção do registro, literal. |
| `personal_firms[]` | As firmas personales registradas em nome do contribuinte. Vazio quando não há. |
| `message` | A resposta completa do registro em texto simples. |

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> Esquemas, todos os campos de resposta e um playground interativo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.