Alias:
SERVICE_RFB_PJ_ON_DEMAND · Preço: R$ 0,50 por consultaPOST /v1/services. Você pode combinar este serviço com outros na mesma chamada, enviando cada identificador uma vez.
Campos do request
| Campo | Obrigatório | Descrição |
|---|---|---|
services | sim | Inclua "SERVICE_RFB_PJ_ON_DEMAND" na lista. |
cnpj | sim | CNPJ, com ou sem pontuação. |
Campos em result
| Campo | Descrição | Tipo |
|---|---|---|
OnlineCertificates | array | |
OnlineCertificates[].Origin | Fonte dos Dados Entregues. | string |
OnlineCertificates[].InputParameters | Parâmetros de entrada. | string |
OnlineCertificates[].ProtocolNumber | Número de protocolo da certidão. | string |
OnlineCertificates[].BaseStatus | Situação cadastral pela certidão. | string |
OnlineCertificates[].AdditionalOutputData | Dados adicionais. | object |
OnlineCertificates[].AdditionalOutputData.OfficialName | Razão Social da empresa. | string |
OnlineCertificates[].AdditionalOutputData.BusinessName | Nome fantasia da empresa. | string |
OnlineCertificates[].AdditionalOutputData.FoundingDate | Data de fundação da empresa. | string |
OnlineCertificates[].AdditionalOutputData.FederalEntity | Ente Federativo Responsável. | string |
OnlineCertificates[].AdditionalOutputData.CompanyType | Tipo do Estabelecimento (MATRIZ ou FILIAL). | string |
OnlineCertificates[].AdditionalOutputData.Cnae | Código da atividade principal. | string |
OnlineCertificates[].AdditionalOutputData.MainEconomicActivity | Atividade principal. | string |
OnlineCertificates[].AdditionalOutputData.LegalNatureCode | Código de natureza legal. | string |
OnlineCertificates[].AdditionalOutputData.LegalNature | Natureza legal. | string |
OnlineCertificates[].AdditionalOutputData.StatusDate | Data da situação cadastral. | string |
OnlineCertificates[].AdditionalOutputData.QueryTime | Horário da consulta. | string |
OnlineCertificates[].AdditionalOutputData.SpecialSituation | Situação especial. | string |
OnlineCertificates[].AdditionalOutputData.SpecialSituationDate | Data da situação especial. | string |
OnlineCertificates[].AdditionalOutputData.StatusReason | Motivo da situação cadastral. | string |
OnlineCertificates[].AdditionalOutputData.CompanyType_ReceitaFederal | Tipo da empresa conforme classificação da Receita Federal. | string |
OnlineCertificates[].AdditionalOutputData.SecondaryActivity.{n} | Atividade secundária da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Phone.{n} | Telefone da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Address.Core.{n} | Logradouro da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Address.City.{n} | Cidade da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Address.Complement.{n} | Complemento do endereço da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Address.Neighborhood.{n} | Bairro da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Address.Number.{n} | Número de porta da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Address.State.{n} | Estado da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Address.ZipCode.{n} | CEP da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].AdditionalOutputData.Email.{n} | Email da empresa, com {n} sendo um índice a partir de 0. | string |
OnlineCertificates[].QueryDate | Data de realização da consulta. | string |
result traz também outcome, o resumo da consulta: clear, alert, match, no_match ou not_found.
curl --request POST 'https://api.omni-ward.com/v1/services' \
--header 'Authorization: Bearer $OMNI_WARD_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: $(uuidgen)' \
--data '{
"services": [
"SERVICE_RFB_PJ_ON_DEMAND"
],
"cnpj": "00000000000000"
}'
const res = await fetch('https://api.omni-ward.com/v1/services', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.OMNI_WARD_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"services": [
"SERVICE_RFB_PJ_ON_DEMAND"
],
"cnpj": "00000000000000"
}),
});
const { results } = await res.json();
import os, uuid, requests
res = requests.post(
"https://api.omni-ward.com/v1/services",
headers={"Authorization": f"Bearer {os.environ['OMNI_WARD_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"services": [
"SERVICE_RFB_PJ_ON_DEMAND"
],
"cnpj": "00000000000000"
},
timeout=90,
)
results = res.json()["results"]
$ch = curl_init("https://api.omni-ward.com/v1/services");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("OMNI_WARD_API_KEY"),
"Content-Type: application/json",
"Idempotency-Key: " . bin2hex(random_bytes(16)),
],
CURLOPT_POSTFIELDS => '{"services":["SERVICE_RFB_PJ_ON_DEMAND"],"cnpj":"00000000000000"}',
]);
$results = json_decode(curl_exec($ch), true)["results"];
var body = """
{
"services": [
"SERVICE_RFB_PJ_ON_DEMAND"
],
"cnpj": "00000000000000"
}
""";
var request = HttpRequest.newBuilder(URI.create("https://api.omni-ward.com/v1/services"))
.header("Authorization", "Bearer " + System.getenv("OMNI_WARD_API_KEY"))
.header("Content-Type", "application/json")
.header("Idempotency-Key", UUID.randomUUID().toString())
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
{
"results": [
{
"service": "SERVICE_RFB_PJ_ON_DEMAND",
"status": {
"code": 200,
"message": "Success"
},
"result": {
"OnlineCertificates": [
{
"Origin": "Receita-Federal Status",
"InputParameters": "doc*****************07}",
"ProtocolNumber": "",
"BaseStatus": "ATIVA",
"AdditionalOutputData": {
"OfficialName": "BIG*********************************************.A.",
"BusinessName": "BIG*******ORP",
"FoundingDate": "03/04/2007",
"FederalEntity": "",
"CompanyType": "",
"Cnae": "62.01-5-01",
"MainEconomicActivity": "Desenvolvimento de programas de computador sob encomenda",
"LegalNatureCode": "205-4",
"LegalNature": "Sociedade Anônima Fechada",
"StatusDate": "03/04/2007",
"QueryTime": "17:09:15",
"SpecialSituation": "",
"SpecialSituationDate": "01/01/0001",
"StatusReason": "",
"CompanyType_ReceitaFederal": "DEMAIS",
"SecondaryActivity.0": "62.02-3-00 - Desenvolvimento e licenciamento de programas de computador customizáveis",
"SecondaryActivity.1": "62.03-1-00 - Desenvolvimento e licenciamento de programas de computador não-customizáveis",
"SecondaryActivity.2": "62.04-0-00 - Consultoria em tecnologia da informação",
"SecondaryActivity.3": "62.09-1-00 - Suporte técnico, manutenção e outros serviços em tecnologia da informação",
"SecondaryActivity.4": "63.99-2-00 - Outras atividades de prestação de serviços de informação não especificadas anteriormente",
"Phone.0": "2130304676",
"Address.Core.0": "AV DAS AMERICAS",
"Address.City.0": "RIO DE JANEIRO",
"Address.Complement.0": "BLC 2 SAL 129",
"Address.Neighborhood.0": "BARRA DA TIJUCA",
"Address.Number.0": "00700",
"Address.State.0": "RJ",
"Address.ZipCode.0": "22.****100"
},
"QueryDate": "2025-08-25T00:00:00"
}
],
"outcome": "clear"
},
"simulated": false,
"costMinor": 50
}
],
"totalCostMinor": 50
}
{
"error": {
"code": "validation_failed",
"message": "Alguns serviços não podem ser executados. Nada foi consultado nem cobrado.",
"correlationId": "4f1c9a7e-2b1d-4c55-9a51-0d2f6f1c2a10",
"details": {
"results": [
{
"service": "SERVICE_RFB_PJ_ON_DEMAND",
"status": {
"code": 422,
"message": "Validation failed"
},
"result": null,
"errors": [
{
"field": "cnpj",
"code": "required",
"message": "Informe CNPJ: este serviço exige o campo."
}
]
}
]
}
}
}
