> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/core-api/transaction-details/validation-rules.md). # Validation rules The validations of a transaction are characterised by a set of rules that are used to define the query status/result. Each rule has an identifier, a status and a description. For example, if the rule indicates an irregularity, it will contain the status INVALID and a corresponding description. If the rule is successfully validated, its status will be VALID and have a description accordingly. {% hint style="info" %} **Note:** There are scenarios where not all rules are processed, so a transaction may not contain all available validations. {% endhint %} ### Available rules | Identifier | Title | Description | | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | active\_cnpj\_number | Active CNPJ on Federal Revenue | Checks if the CNPJ (National Legal Entity Register) is active with the Federal Revenue. | | attorney | Attorney Flow | Validates if the query was generated from the Attorney flow. | | authentic\_cnpj\_number | Authentic CNPJ number | Checks if the CNPJ (National Legal Entity Register) number is authentic. | | authentic\_document | Authenticity of the identity | Checks if the document's authenticity. | | big\_data\_source\_underage | Age of majority | Checks if the source indicates the holder is under 18 years old. | | cnh\_has\_valid\_date | Expired Expired (CNH) | Checks if driver's license has not expired. | | company\_qsa\_data\_compatibility | Compatibility between Person and Company data | Checks if the individual data matches the company's membership data. | | cpf\_equal\_name | Equivalent names | Checks if the name found in the run (parameter/OCR) is the same as the official database. | | cpf\_error\_code | Regular CPF | Checks if the CPF (Individuals Register) is in order. | | cpf\_has\_not\_dead | Death | Checks if the CPF (Individuals Register) consulted is deceased. | | cpf\_null | Basic data invalid return | Checks if the basic data source is returning values. | | cpf\_query | CPF Inquiry | Checks if it was possible to consult the CPF (Individuals Register) at the Federal Revenue. | | credit\_score\_available | Available credit score | Checks if the document consulted has an available credit score. | | credit\_score\_below | Score below\... | Checks if the credit score is below the defined value. | | credit\_score\_between | Score between... | Checks if the credit score is between the defined values. | | credit\_score\_over | Score above... | Checks if the credit score is above the defined value. | | data\_and\_document\_are\_equal | Diverging parameters | Checks for discrepancies between information collected and entered manually. | | disabled\_on\_bacen | It is not included in the general list of disabled persons with BACEN. | Checks if the CPF (Individuals Register) consulted is not authorized by the Central Bank. | | document\_is\_known | Type of document different from others | Checks if the document is not of type other. | | document\_issue\_less\_than\_10 | Verification of a document under 10 years old | Checks if the document was issued less than 10 years ago. | | documentscopy\_approved | Documentoscopy approved | Checks if the document has passed the documentary examination. | | documentscopy\_available | Documentoscopy available | Checks if documentscopy is available. | | does\_not\_exist\_on\_receita\_federal\_database | Invalidate if CPF is not found in the Internal Revenue Service. | Checks if you can find the document at Federal Revenue. | | driver\_has\_pending\_traffic\_violations | Invalidate if pending traffic violations are found for the driver | Checks if there are any outstanding infractions for the document consulted. | | driver\_has\_traffic\_violations | Invalidate if violations are found for the driver | Checks for infringements for the document consulted. | | face\_and\_birthdate\_compare | CPF vs Selfie | Checks selfie upload. | | facematch\_has\_selfie\_photo | Selfie present | Checks whether the submission has a selfie or not. What triggers the rule is not having a selfie. | | facematch\_is\_equal | Facematch | Checks similarity between document and selfie. | | first\_and\_last\_name\_similarity | Similarity between the union of the first and last names | Checks the similarity between the union of the first and last name sent in the parameters compared to the union of the first name and each surname of the source. | | government\_document\_approved | Similar biometrics | Checks whether it has been possible to validate the person's face on the basis of official information. | | government\_document\_available | Do facial biometrics exist | Checks if the person's face can be found in official databases. | | has\_active\_social\_assistence | Active social assistance | Checks if have active social assistance benefits. | | has\_arrest\_warrant | There are no warrants before the National Justice Council (CNJ) | Checks for arrest warrants with the CNJ (National Council of Justice). | | has\_at\_least\_one\_cnae | Verification of CNAEs in the company's activities | Checks if the company has at least one CNAE (National Classification of Economic Activities) corresponding to those defined in the validation. | | has\_at\_least\_one\_legal\_nature | Verification of the legal nature of the company | Checks if the company has a legal nature code corresponding to those defined in the validation. | | has\_author\_type\_null\_in\_criminal\_processes | Empty AuthorType in criminal processes | Checks if there is an empty ‘authorType’ field in any criminal case. | | has\_cnh\_for\_more\_than\_three\_years | Has had a CNH for at least 3 years | Checks if the driver has had a license (temporary or permanent) for at least 3 years. | | has\_cpf | Present CPF | Checks if the document was found in the document or entered manually. | | has\_debts\_on\_pgfn | List of PGFN debtors | Checks if has debts with the PGFN (Attorney General's Office). | | has\_definitive\_cnh | Has a definitive CNH | Checks if driver has a permanent license. | | has\_no\_class\_organizations | Verification of relationship with class boards | Checks whether the document is linked to professional associations. | | has\_no\_criminal\_background | Advance criminal police (Civil + Federal) | Checks if the document has criminal records/background. | | has\_no\_criminal\_background\_federal | Federal Police criminal background check | Checks if the document has any criminal records/background with the federal police. | | has\_no\_criminal\_processes | Criminal Proceedings | Checks if the document is linked to criminal proceedings. | | has\_no\_defendant\_processes | Defendant in lawsuits | Checks if the document is linked to proceedings as a defendant. | | has\_no\_ibope\_income | Ibope Income Verification | Checks the Ibope income of a document. | | has\_no\_inconsistent\_data | There is no inconsistency in the data for consultation with the Federal Police. | Checks for inconsistencies in the data sent for consultation. | | has\_no\_labor\_debts | Has a negative labor debt certificate | Checks if there are any labor debts. | | has\_no\_media\_exposure | Media exposure | Checks if the document holder has media exposure. | | has\_no\_participant\_antt | ANTT Enabled Transporter | Checks the ANTT (National Land Transport Agency) website to see if the vehicle and person/company consulted are authorized to carry out the activity. | | has\_no\_participant\_cvm | Checks if the consulted CPF/CNPJ is registered with the CVM | Checks if the participant is registered with the CMV (Securities Commission). | | has\_no\_pep | Political exposure | Checks whether the bearer of the document has political exposure. | | has\_no\_pep\_department | Checking Departments in the PEP history | Checks whether politically exposed persons fall within the defined departments. | | has\_no\_pep\_or\_sanctions\_compliance\_owners | Verification of PEPs or sanctions on the partners of a company | Checks for PEPs or sanctions on a company's partners. | | has\_no\_personal\_relationships\_trust\_rl | Related people + Trust Monitor's restrictive lists | Checks if people related to the CPF (Individuals Register) are present in Trust Monitor's restrictive lists. | | has\_no\_processes | Processes | Checks if the document is linked to processes. | | has\_no\_processes\_active\_party | Processes - active party | Checks if the document is linked to processes as an active party. | | has\_no\_processes\_other\_party | Processes - other parties | Checks if the document is linked to legal processes as other parties. | | has\_no\_processes\_passive\_party | Processes - passive party | Checks if the document is linked to legal processes as a passive party. | | has\_no\_sanctions | Presence on sanction lists | Checks that no sanctions have been found in restrictive lists. | | has\_no\_sintegra\_record | Company Stegra Data | Checks if a company is registered. | | has\_no\_total\_share | Does not have a participation percentage | Checks if the participation percentage has a valid value. | | has\_penalties\_on\_cvm | Invalidate if you have temporary penalties with the CVM. | Checks whether the participant is temporarily barred from acting before the CVM (Securities Commission). | | has\_process\_on\_cade | Check if you have procedural protocols with CADE. | Checks if you have any procedural protocols with CADE (Administrative Council for Economic Defense). | | has\_processes\_keywords | Processes with keywords | Checks for keywords in processes. | | has\_salary\_information | Invalidate if estimated income information is not found | Checks if information on estimated income has been found. | | invalid\_range\_ages | Age ranges not accepted. | Checks if the document holder is of an age within the configured ranges. | | invalid\_zip\_code | The ZIP code entered is valid. | Checks if the provided CEP (ZIP code) is valid. | | is\_between\_two\_and\_four\_salaries | Invalidate if estimated income is between two and four minimum wages | Checks if the estimated income is between two (02) and four (04) minimum wages. | | is\_cnh | CNH | Checks that the document sent is a CNH (Brazilian driver's license). | | is\_company\_lifetime\_greater\_than\_six\_months | A company from SC with less than 6 months since its opening | Checks if the lifespan of an SC company is longer than 6 months. | | is\_cpf\_regular | Regular CPF | Checks the regularity of the document. | | is\_document\_liveness\_colored\_copy\_doc | Invalidate if the document is identified as a colored photocopy. | Checks if the document is a color photocopy. | | is\_document\_liveness\_grayscale\_copy\_doc | Invalidate if the document is identified as a black and white photocopy. | Checks if the document is a black and white photocopy. | | is\_document\_liveness\_screen\_photo\_doc | Invalidate if the document is identified as a screen photo. | Checks if the document is a screenshot. | | is\_less\_than\_two\_salaries | Invalidate if estimated income is less than two minimum wages | Checks if the estimated income is less than two (02) minimum wages. | | is\_literate | Invalidate if the document belongs to an illiterate person | Checks if the person is literate. | | is\_more\_than\_four\_salaries | Invalidate if estimated income is above four minimum wages | Checks if the estimated income is above four (04) minimum wages. | | is\_not\_alive | Invalidate if the registration status is deceased. | Checks if the document belongs to a deceased holder. | | is\_not\_cancelled | Invalidate if registration status is canceled. | Checks if the document is canceled with the Federal Revenue. | | is\_not\_ctps | Document should not be a work card | Checks if the document is not a work card. | | is\_not\_deepfake | The selfie sent does not present characteristics indicative of deepfake. | Checks if the selfie sent is not a deepfake. | | is\_not\_expired\_passport | Check passport validity. | Checks if the passport presented is valid. | | is\_not\_me\_company | Not a Micro Company (ME) | Checks if the company size is not ME (Individual Microentrepreneur) according to the Federal Revenue. | | is\_not\_null | Invalidate if registration status is null. | Checks if the document is listed as null and void with the Federal Revenue. | | is\_not\_passport | Document is not a passport | Checks if the document sent is not a passport. | | is\_not\_pendant\_of\_regularization | Invalidate if the registration status is pending adjustment. | Checks if the document is pending regularization. | | is\_not\_suspended | Invalidate if registration status is suspended. | Checks if the document is listed as suspended with the Federal Revenue. | | is\_on\_ofac\_sanctions\_list | Invalidate if sanctions are found with OFAC | Checks if there are records in OFAC (Office of Foreign Assets Control) for the given name. | | is\_passport | passport | Checks if the document sent is a passport. | | is\_prevented\_from\_betting | Checks whether the person is legally prohibited from placing bets, that is, if they have ties to the sports sector, betting houses, or the Ministry of Finance. | Checks if the person is barred from betting. | | is\_readable | Legible document | Checks if the images uploaded are legible. | | is\_sport\_related\_person | Verifies if the individual is related to sports | Checks if the individual is related to sports. | | issued\_over\_16\_years | Under the age of 16 as of the date of issue | Checks if the difference between the date of birth and the issue of the identification document is greater than or equal to 16 years. | | its\_on\_deny\_list | Private list of restrictions | Checks presence on the private restrictions list. | | liveness\_approved | Liveness approved | Checks if the liveness has been approved. | | liveness\_double\_check | Double check Liveness | Send the selfie for a manual anti-spoofing check. | | liveness\_manual\_revision | Liveness manual review | Send the selfie for a manual anti-spoofing check. | | minimum\_company\_lifetime | Minimum company lifespan | Checks if the company's lifetime is longer than the minimum required. | | ocr\_equals\_parameters | Comparison of all data entered in the parameters vs OCR | Checks if the data entered in the parameters is the same as that read by the OCR. | | ocr\_equals\_parameters\_data | Comparison of data entered in the parameters vs OCR (Name, CPF and Date of Birth - Selectable data) | Checks if the data entered in the parameters is the same as that read by the OCR. | | ocr\_equals\_receita | Comparison of data returned by the Federal Revenue Service vs OCR | Checks if the data from the Federal Revenue is the same as that read by the OCR. | | over\_14 | Greater than 14 | Checks if the document holder is over 14 years old. | | over\_16 | Greater than 16 | Checks if the document holder is over 14 years old. | | over\_18 | Age of majority | Checks if the document holder is of legal age (18). | | over\_21 | Greater than 21 | Checks if the document holder is over 21 years old. | | parameters\_and\_document\_are\_equal | Diverging data (CPF parameter vs CPF OCR) | Checks for discrepancies between document and manually entered data. | | parameters\_and\_document\_undefined\_or\_equal | Divergent or non-existent data (Parameter CPF vs OCR CPF) | Checks for non-existence or divergence between document data and manually entered data. | | parameters\_equals\_receita | Comparison of data returned by the Federal Revenue Service vs. data provided in the parameters | Checks if the data from Federal Revenue is the same as that entered in the parameters. | | private\_faceset\_not\_contains\_face | Private bank | Checks if the selfie sent corresponds to one of the selfies registered in the Private Face Bank. | | public\_service\_history | Public service history. | Checks if the document consulted has a civil service history. | | qsa\_consistent | Complete and compatible QSA | Checks if the QSA entered in attributes is the same as that obtained from the Federal Revenue query. | | qsa\_pj\_data\_not\_empty | The company has registered partners. | Checks if the corporate structure is disclosed by the Federal Revenue. | | qsa\_with\_company\_partner | The company has a Legal Person in its corporate structure. | Checks if the company has a legal entity on its board of directors. | | rg\_has\_cpf | RG has a CPF | Checks if the RG (Brazilian identity card) has a CPF (Individuals Register). | | rg\_issue\_less\_than\_25 | Verification of RGs under 25 | Checks if the RG (Brazilian identity card) was issued less than 25 years ago. | | selfie\_is\_not\_similar | The selfie sent is not similar to any of the images from previous transactions. | Checks the similarity of the selfie with the private base of previously transacted selfies. | | shared\_faceset\_not\_contains\_face | Shared Face Bank | Checks if the selfie sent matches one of the selfies registered in the Shared Face Bank. | | valid\_cnh\_registration\_number | Valid CNH registration number | Checks if the CNH (Brazilian driver's license) registration number is valid. | | valid\_cpf\_number | Valid CPF number | Checks if the CPF (Individuals Register) number is valid. | | valid\_issue\_date | Valid Issue Date | Checks if the document's issue date is valid. | | valid\_issue\_state | Valid state of the issuing authority | Checks if the UF (Federative Unit) of the issuing body is valid. | | valid\_rg\_issue\_authority | Valid ID issuer | Checks that the issuing body of the RG (Brazilian identity card) is valid. | | valid\_rg\_number | Valid ID number | Checks if the Document number on the RG/CIN (Brazilian identity card) is valid. | | vehicle\_has\_pending\_traffic\_violations | Invalidate if pending traffic violations are found for the vehicle | Checks if the vehicle has any outstanding infractions. | | vehicle\_has\_traffic\_violations | Invalidate if violations are found for the vehicle | Checks if the vehicle has any infractions with Denatran(National Transit Departament) in the last 365 days. | | verifai\_smart\_ocr\_address\_completeness | Address Completeness | Checks whether the document address is complete (street, number, postal code, neighborhood and city). Part of the [Verif AI Smart OCR](/caf-api/core-api/transaction-details/services/verif-ai-smart-ocr.md) service. | | verifai\_smart\_ocr\_document\_holder | Document Holder | Checks whether the document belongs to the expected holder by comparing the extracted name and/or CPF with `attributes.holderName` / `attributes.holderCpf`. Part of the [Verif AI Smart OCR](/caf-api/core-api/transaction-details/services/verif-ai-smart-ocr.md) service. | | verifai\_smart\_ocr\_document\_validity | Document Validity | Checks whether the document was issued within the configured maximum validity window, using `attributes.analysisDate` as reference date. Part of the [Verif AI Smart OCR](/caf-api/core-api/transaction-details/services/verif-ai-smart-ocr.md) service. | | verifai\_smart\_ocr\_required\_fields | Required Fields | Checks that all fields listed in `requiredTerms` (configured per document class in the template) are present in the extraction. Part of the [Verif AI Smart OCR](/caf-api/core-api/transaction-details/services/verif-ai-smart-ocr.md) service. | {% hint style="info" %} The four `verifai_smart_ocr_*` rules are produced exclusively by the **Verif AI Smart OCR** service. For full behavior details, accepted status values, and configuration options, see the dedicated service page: {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-api/core-api/transaction-details/validation-rules.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.