diff --git a/..travis.yml.swp b/..travis.yml.swp new file mode 100644 index 0000000..1d51e19 Binary files /dev/null and b/..travis.yml.swp differ diff --git a/README.md b/README.md index c9a2f0c..62477a5 100644 --- a/README.md +++ b/README.md @@ -209,7 +209,8 @@ $bc->facematch($documentURL, $selfieURL); ``` ### Pessoa Física -#### Busca por anúncios online vinculados ao número do CPF enviado [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsAds) +#### PF - Anúncios online [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsAds) +Busca por anúncios online vinculados ao número do CPF enviado ``` ads($document); ``` -#### Dados básicos de um usuário como nome, filiação e outros documentos conhecidos, data de nascimento, signo e regularização na Receita Federal.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsBasic) + +#### PF - Dados Cadastrais Básicos [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsBasic) +Dados básicos de um usuário como nome, filiação e outros documentos conhecidos, data de nascimento, signo e regularização na Receita Federal. ``` basic($document); ``` -#### Dados de profissionais conhecidos em conselhos de classe.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsMemberships) +#### PF - Dados Profissionais - Conselhos de Classe [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsMemberships) +Dados de profissionais conhecidos em conselhos de classe. ``` memberships($document); ``` -#### Dados de profissionais conhecidos de funcionários públicos.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsPublicProfessions) +#### PF - Dados Profissionais - Servidores Públicos [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsPublicProfessions) +Dados de profissionais conhecidos de funcionários públicos. ``` publicProfessions($document); ``` -#### Dados de profissionais conhecidos.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsProfessions) +#### PF - Dados Profissionais [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsProfessions) +Dados de profissionais conhecidos. ``` professions($document); ``` -#### Dados de estudantes universitários.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsUniversity) +#### PF - Dados de Estudantes Universitários [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsUniversity) +Dados de estudantes universitários. ``` universityStudents($document); ``` -#### Domínios de internet conhecidos para um CPF.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsDomains) +#### PF - Dados de Sites [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsDomains) +Domínios de internet conhecidos para um CPF. ``` domains($document); ``` -#### Endereços eletrônicos conhecidos para um CPF.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsEmails) +#### PF - E-mails [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsEmails) +Endereços eletrônicos conhecidos para um CPF. ``` email($document); ``` -#### Endereços físicos conhecidos para um CPF com classificação para endereços de trabalho e casa.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsAddresses) +#### PF - Endereços físicos [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsAddresses) +Endereços físicos conhecidos para um CPF com classificação para endereços de trabalho e casa. ``` addresses($document); ``` -#### Exposição e perfil definidos em diversas mídias.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsMediaExposure) +#### PF - Exposição e Perfil na Mídia [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsMediaExposure) +Exposição e perfil definidos em diversas mídias. ``` mediaExposure($document); ``` -#### Indicadores e características de atividades financeiras pela WEB.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsFlagsAndFeatures) +#### PF - Indicadores e Características [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsFlagsAndFeatures) +Indicadores e características de atividades financeiras pela WEB. ``` flagsAndFeatures($document); ``` -#### Informações financeiras de IR.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsFinancial) +#### PF - Informações Financeiras [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsFinancial) +Informações financeiras de IR. ``` financial($document); ``` -#### Dados de Interpol e Ofac para homônimos e similaridades.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsKyc) + +#### PF - Interesses e Comportamentos [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsDemographic) +A consulta retorna informações relacionadas com comportamentos ou com o interesse em determinadas categorias de produtos e serviços. ``` kyc($document); +$pf->interests($document); ``` -#### A consulta retorna informações relacionadas com comportamentos ou com o interesse em determinadas categorias de produtos e serviços.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsDemographic) +#### PF - Informações de KYC [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsKyc) +Dados de Interpol e Ofac para homônimos e similaridades. ``` interests($document); +$pf->kyc($document); ``` -#### Dados de passagens reconhecidas pela WEB como passagens suspeitas. [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsWebPassages) - +#### PF - Passagens pela Web [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsWebPassages) +Dados de passagens reconhecidas pela WEB como passagens suspeitas. ``` webPassages($document); ``` -#### Informações de presença online que definem a utilização da internet.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsOnlinePresence) +#### PF - Presença Online [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsOnlinePresence) +Informações de presença online que definem a utilização da internet. ``` onlinePresence($document); ``` -#### Dados de presença em cobranças por empresas, definindo os níveis de encontrabilidade por endereços, e-mails e telefones, por exemplo.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsRecurrencyToCharging) +#### PF - Presença em Cobrança [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsRecurrencyToCharging) +Dados de presença em cobranças por empresas, definindo os níveis de encontrabilidade por endereços, e-mails e telefones, por exemplo. ``` recurrencyToCharging($document); ``` -#### Dados de processos conhecidos através do CPF oriundos dos tribunais regionais. [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsProcesses) +#### PF - Processos [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsProcesses) +Dados de processos conhecidos através do CPF oriundos dos tribunais regionais. ``` processes($document); ``` -#### Informações de participação em programas de benefícios como o bolsa-família.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsSocialAssistences) +#### PF - Programas de Benefícios e Assistência Social [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsSocialAssistences) +Informações de participação em programas de benefícios como o bolsa-família. ``` socialAssistences($document); ``` -#### Informações sobre relacionamentos econômicos.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsBusiness) +#### PF - Relacionamentos Econômicos [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsBusiness) +Informações sobre relacionamentos econômicos. ``` businessRelationships($document); ``` - - -#### Relacionamentos em torno do CPF como familiares, vizinhos e colegas de trabalho.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsNearbyRelationships) +#### PF - Relacionamentos Pessoais [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsNearbyRelationships) +Relacionamentos em torno do CPF como familiares, vizinhos e colegas de trabalho. ``` nearbyRelationships($document); ``` - -#### Dados de telefones associados ao CPF consultado.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsPhones) +#### PF - Telefones [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsPhones) +Dados de telefones associados ao CPF consultado. ``` phones($document); ``` -#### Dados de veículos registrados para o CPF informado.[#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsVehicles) +#### PF - Veículos [#](https://api.fincore.co/doc/#api-PF-outsourcingPersonsVehicles) + Dados de veículos registrados para o CPF informado. ``` vehicles($document); ``` - - - -### Pessoa Jurídica - -#### Consulta com informações relacionadas dos anuncios postados pela empresa consultado nos principais marketplaces e portais de anúncios da internet. [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesAds) +### Pessoa Jurídica +#### PJ - Anúncios Online [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesAds) +Consulta com informações relacionadas dos anuncios postados pela empresa consultado nos principais marketplaces e portais de anúncios da internet. ``` ads($document); ``` -#### Consulta contém o conjunto mais simples de informações dentre todos os datasets, com informações cadastrais recuperadas de fontes oficiais .[#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesBasic) +#### PJ - Dados Cadastrais Básicos [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesBasic) +Consulta contém o conjunto mais simples de informações dentre todos os datasets, com informações cadastrais recuperadas de fontes oficiais . ``` basic($document) ``` -#### Domínios de internet conhecidos para um CNPJ.[#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesDomains) +#### PJ - Dados de Sites [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesDomains) +Consulta retorna informações dos sites e domínios que estão associados com a entidade consultada, seja através do registro de domínios ou através de informações contidas dentro do próprio conteúdo do site. ``` domains($document) ``` -#### Endereços eletrônicos conhecidos para um CNPJ.[#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesEmails) +#### PJ - E-mails [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesEmails) +Consulta retorna não só os e-mails relacionados com a entidade consultada, como também uma série de qualificadores desse relacionamento, tais como quantas vezes o e-mail foi visto para aquela entidade, e quantas vezes foi visto associado com outras entidades. ``` emails($document) ``` +#### PJ - Endereços [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesAddresses) +A consulta retorna não só os endereços relacionados com a entidade consultada, como também uma série de qualificadores desse relacionamento, tais como quantas vezes o endereço foi visto para aquela entidade, e quantas vezes foi visto associado com outras entidades. +``` + Addresses($document) +``` +#### PJ - Exposição e Perfil na Mídia [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesMediaExposure) +Exposição e perfil definidos em diversas mídias. ``` mediaExposure($document); ``` - -#### Os dados retornam informações agrupadas e agregadas do grupo econômico relacionado com a empresa principal sendo consultada, em todas as direções.[#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesEconomicGroups) +#### PJ - Grupos Econômicos [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesEconomicGroups) +Os dados retornam informações agrupadas e agregadas do grupo econômico relacionado com a empresa principal sendo consultada, em todas as direções. ``` EconomicGroups($document); ``` - - -#### Indicadores e características de atividades financeiras pela WEB.[#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesactivity_indicators) +#### PJ - Indicadores de Atividade [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesactivity_indicators) +Indicadores e características de atividades financeiras pela WEB. ``` activityIndicators($document); ``` - -#### Os Processos Judiciais e Administrativos retorna informações, tanto atuais quanto históricas, do envolvimento da entidade consultada em ações judiciais de todos os tipos (civil, trabalhista, criminal, etc).[#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesProcesses) +#### PJ - Processos [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesProcesses) +Os Processos Judiciais e Administrativos retorna informações, tanto atuais quanto históricas, do envolvimento da entidade consultada em ações judiciais de todos os tipos (civil, trabalhista, criminal, etc). ``` Processes($document); ``` - - -#### Informações sobre relacionamentos econômicos.[#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesRelationships) +#### PJ - Relacionamentos [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesRelationships) +Consulta retorna informações sobre outras entidades, sejam elas pessoas ou empresas, que estão relacionadas com a empresa consultada. ``` relationships($document); ``` -#### Dados de telefones associados ao CNPJ consultado.[#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesPhones) +#### PJ - Telefones [#](https://api.fincore.co/doc/#api-PJ-outsourcingCompaniesPhones) +Dados de telefones associados ao CNPJ consultado. ``` phones($document); ``` - ### Utilitários #### JSON para XLS [#](https://api.fincore.co/doc/#api-Utilidades-jsonToXls) A conversão de um objeto JSON para um arquivo XLS é importante para exportar dados já normalizados, transformando a sua leitura em uma planilha Excel. Esta rota é um download de arquivo XLS. @@ -500,5 +528,4 @@ require 'vendor/autoload.php'; $json = new \Fincore\Utilities; $json->JsonToXls($json); - ``` diff --git a/src/PJ.php b/src/PJ.php index ac8c273..d902e92 100644 --- a/src/PJ.php +++ b/src/PJ.php @@ -56,6 +56,17 @@ public function emails(string $document): object return $this->get($this->buildQuery($request)); } + public function Addresses(string $document): object + { + $request = [ + 'path' => '/_/outsourcing/companies/addresses', + 'queryString' => [ + 'document' => $document, + ], + ]; + return $this->get($this->buildQuery($request)); + } + public function mediaExposure(string $document): object { $request = [ diff --git a/tests/PFTest.php b/tests/PFTest.php index e4e0b74..92dd1a4 100644 --- a/tests/PFTest.php +++ b/tests/PFTest.php @@ -688,13 +688,11 @@ public function testNearbyRelationships(): void public function testPhones(): void { $request = $this->pf->phones($this->cpf); + $this->assertEquals(200, $request->http_status); if (!empty($request->response)) { - foreach ($request->response as $application) { - $Phones = (array) $application; - $this->assertArrayHasKey('Number', $Phones); $this->assertArrayHasKey('AreaCode', $Phones); $this->assertArrayHasKey('CountryCode', $Phones); @@ -718,30 +716,28 @@ public function testPhones(): void $this->assertArrayHasKey('CreationDate', $Phones); $this->assertArrayHasKey('LastUpdateDate', $Phones); - $this->assertNotEmpty($Phones['Number']); - $this->assertNotEmpty($Phones['AreaCode']); - $this->assertNotEmpty($Phones['CountryCode']); - $this->assertNotEmpty($Phones['Type']); - $this->assertNotEmpty($Phones['Priority']); - - $this->assertInternalType('int', $Phones['PhoneTotalPassages']); - $this->assertInternalType('int', $Phones['PhoneCrawlingPassages']); - $this->assertInternalType('int', $Phones['PhoneBadPassages']); - $this->assertInternalType('int', $Phones['PhoneQueryPassages']); - $this->assertInternalType('int', $Phones['PhoneValidationPassages']); - - $this->assertInternalType('bool', $Phones['IsMain']); - $this->assertInternalType('bool', $Phones['IsRecent']); - $this->assertInternalType('bool', $Phones['IsActive']); - $this->assertInternalType('bool', $Phones['IsInDoNotCallList']); - - $this->assertNotEmpty($Phones['FirstPassageDate']); - $this->assertNotEmpty($Phones['LastPassageDate']); - $this->assertNotEmpty($Phones['CreationDate']); - $this->assertNotEmpty($Phones['LastUpdateDate']); + $this->assertNotEmpty($request->response->Number); + $this->assertNotEmpty($request->response->AreaCode); + $this->assertNotEmpty($request->response->CountryCode); + $this->assertNotEmpty($request->response->Type); + $this->assertNotEmpty($request->response->Priority); + + $this->assertInternalType('int', $request->response->PhoneTotalPassages); + $this->assertInternalType('int', $request->response->PhoneCrawlingPassages); + $this->assertInternalType('int', $request->response->PhoneBadPassages); + $this->assertInternalType('int', $request->response->PhoneQueryPassages); + $this->assertInternalType('int', $request->response->PhoneValidationPassages); + + $this->assertInternalType('bool', $request->response->IsMain); + $this->assertInternalType('bool', $request->response->IsRecent); + $this->assertInternalType('bool', $request->response->IsActive); + $this->assertInternalType('bool', $request->response->IsInDoNotCallList); + + $this->assertNotEmpty($request->response->FirstPassageDate); + $this->assertNotEmpty($request->response->LastPassageDate); + $this->assertNotEmpty($request->response->CreationDate); + $this->assertNotEmpty($request->response->LastUpdateDate); } - - $this->assertEquals(200, $request->http_status); } } diff --git a/tests/PJTest.php b/tests/PJTest.php index 232c72f..214712a 100644 --- a/tests/PJTest.php +++ b/tests/PJTest.php @@ -12,7 +12,7 @@ protected function setup(): void $this->Cnpj = preg_replace("/[^0-9]/", "", getenv('CNPJ')); } - /* public function testads(): void + public function testads(): void { $request = $this->PJ->ads($this->Cnpj); $this->assertEquals(200, $request->http_status); @@ -219,14 +219,14 @@ public function testactivityIndicators(): void $this->assertNotEmpty($request->http_status); } -*/ + public function testProcesses(): void { $request = $this->PJ->Processes($this->Cnpj); die(print_r($request)); } - /* public function testrelationships(): void + public function testrelationships(): void { $request = $this->PJ->relationships($this->Cnpj); @@ -287,5 +287,5 @@ public function testphones(): void } } $this->assertEquals(200, $request->http_status); - }*/ + } }